forked from BetterThanTomorrow/calva
-
Notifications
You must be signed in to change notification settings - Fork 0
/
package.json
3403 lines (3403 loc) · 130 KB
/
package.json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
{
"name": "calva",
"displayName": "Calva: Clojure & ClojureScript Interactive Programming",
"description": "Integrated REPL, formatter, Paredit, and more. Powered by cider-nrepl and clojure-lsp.",
"icon": "assets/calva.png",
"version": "2.0.473",
"publisher": "betterthantomorrow",
"author": {
"name": "Better Than Tomorrow",
"email": "[email protected]"
},
"repository": {
"type": "git",
"url": "https://github.com/BetterThanTomorrow/calva.git"
},
"license": "MIT",
"bugs": {
"url": "https://github.com/BetterThanTomorrow/calva/issues"
},
"engines": {
"node": ">=16",
"vscode": "^1.75.0"
},
"sponsor": {
"url": "https://calva.io/sponsors/"
},
"categories": [
"Programming Languages",
"Testing",
"Formatters",
"Linters",
"Debuggers",
"Other"
],
"keywords": [
"Clojure",
"ClojureScript",
"EDN",
"REPL",
"Interactive Programming",
"Structural Editing",
"CIDER"
],
"galleryBanner": {
"color": "#EFEFEF",
"theme": "light"
},
"badges": [
{
"url": "https://img.shields.io/badge/clojurians-calva--dev-blue.svg?logo=slack",
"href": "https://clojurians.slack.com/messages/calva/",
"description": "Let's talk in the #calva channel at the Clojurians Slack"
}
],
"activationEvents": [
"workspaceContains:**/project.clj",
"workspaceContains:**/shadow-cljs.edn",
"workspaceContains:**/deps.edn",
"onDebugResolve:type"
],
"main": "./out/extension",
"capabilities": {
"untrustedWorkspaces": {
"supported": false,
"description": "With Calva you might evaluate any code in the project."
}
},
"extensionPack": [
"betterthantomorrow.calva-spritz"
],
"contributes": {
"debuggers": [
{
"type": "clojure",
"label": "Calva Debug",
"program": "./out/debugAdapter.js",
"runtime": "node"
}
],
"languages": [
{
"id": "clojure",
"aliases": [
"Clojure",
"clojure"
],
"extensions": [
".clj",
".cljs",
".cljc",
".cljd",
".cljr",
".cljx",
".clojure",
".edn",
".joke",
".boot",
".bb",
".ly",
".lpy",
".calva-repl",
".fiddle"
],
"configuration": "./language-configuration.json"
}
],
"grammars": [
{
"language": "clojure",
"scopeName": "source.clojure",
"path": "./clojure.tmLanguage.json"
}
],
"snippets": [
{
"language": "clojure",
"path": "./snippets.jsonc"
}
],
"configurationDefaults": {
"[clojure]": {
"editor.wordSeparators": "\t ()\"':,;~@#$%^&{}[]`",
"editor.autoClosingBrackets": "always",
"editor.autoClosingOvertype": "always",
"editor.autoClosingQuotes": "always",
"editor.formatOnType": true,
"editor.autoIndent": "full",
"editor.formatOnPaste": true,
"editor.matchBrackets": "never",
"editor.guides.indentation": false,
"editor.parameterHints.enabled": false,
"editor.unicodeHighlight.allowedCharacters": {
" ": true,
"꞉": true
},
"editor.foldingStrategy": "indentation"
}
},
"semanticTokenScopes": [
{
"language": "clojure",
"scopes": {
"macro": [
"storage.control.clojure",
"keyword.control.clojure"
]
}
}
],
"configuration": [
{
"type": "object",
"title": "Calva",
"properties": {
"calva.useLegacyReplWindowPath": {
"type": "boolean",
"default": true,
"markdownDescription": "For legacy reasons, the REPL window used to be located in `${projectRootPath}/.calva/output-window/output.calva-repl`. The default directory will change to `${projectRootPath}/.calva/repl.calva-repl`. Disable this setting to start using the new path. And then add `**/.calva/repl.calva-repl` to your `.gitignore`."
},
"calva.legacyPrintBareReplWindowOutput": {
"type": "boolean",
"default": false,
"markdownDescription": "Non-result output risks breaking the structure of the Clojure document. Therefore `stdout` from the REPL process is prepended with `;` to make the output into line comments, which is non-structural. Enable this setting to print bare output, without the line comment protection. **NB: The REPL window may stop working, or work very strangely or slowly.** Also note that the REPL Window is being deprecated as a destination for output, so you may anyway instead want to use the `calva.outputDestinations` settings to direct `stdout` and `stderr` to the _Calva Output_ `terminal` destination instead."
},
"calva.outputDestinations": {
"type": "object",
"markdownDescription": [
"Where different types of Calva output should be printed.\nCalva categorizes output into three types:\n- **evaluation results**: Clojure data returned from an evaluation.\n- **evaluation output**: stdout/stderr from an evaluation\n- **other output**: Other messages, logs, etc\n\nYou can select where each category of output should go to: the REPL Window, the _Calva Says_ Output Channel, or the _Calva output_ (pseudo) terminal."
],
"properties": {
"evalResults": {
"type": "string",
"enum": [
"repl-window",
"output-channel",
"terminal"
],
"default": "repl-window",
"markdownDescription": "Destination for evaluation results. (Clojure data returned from an evaluation)."
},
"evalOutput": {
"type": "string",
"enum": [
"repl-window",
"output-channel",
"terminal"
],
"default": "repl-window",
"markdownDescription": "Destination for evaluation output (stdout/stderr from an evaluation)."
},
"otherOutput": {
"type": "string",
"enum": [
"repl-window",
"output-channel",
"terminal"
],
"default": "repl-window",
"markdownDescription": "Destination for other output (Calva messages, out-of-band stdout/stderr, etcetera)."
}
},
"default": {
"evalResults": "repl-window",
"evalOutput": "repl-window",
"otherOutput": "repl-window"
}
},
"calva.fiddleFilePaths": {
"type": "array",
"markdownDescription": "An array of `source` and `fiddle` root paths, relative to the project root. This is used by the commands **Calva: Open Fiddle File for Current File**, and **Calva: Evaluate Fiddle File for Current File**. Example:\n\n```json\n\"calva.fiddleFilePaths\": [\n {\n \"source\": [\"src\"],\n \"fiddle\": [\"env\", \"dev\", \"fiddles\"]\n }\n]\n```\n\nThe default is `null`, which will make Calva associate files with a `.fiddle` file extension as the fiddle file for a Clojure file. E.g. a file `src/foo/bar/baz_main.cljc`, will have an associated fiddle file named `src/foo/bar/baz_main.fiddle`. See [calva.io/fiddle](https://calva.io/fiddle-files/) for more info.",
"items": {
"type": "object",
"properties": {
"source": {
"markDownDescription": "The source files root path. An array of strings, used as path segments. E.g. `[\"src\"]`",
"type": "array",
"items": {
"type": "string"
}
},
"fiddle": {
"markDownDescription": "The fiddle files root path. An array of strings, used as path segments. E.g. `[\"env\", \"dev\", \"fiddles\"]`",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"source",
"fiddle"
]
},
"default": null
},
"calva.useLiveShare": {
"type": "boolean",
"markdownDescription": "Enable support for LiveShare. Currently defaults to false, because of [ive-share/issues/4551](https://github.com/MicrosoftDocs/live-share/issues/4551). This issue makes Calva fail to connect to a REPL for some users.",
"default": false
},
"calva.useTestExplorer": {
"type": "boolean",
"description": "Enable experimental support for the VSCode Test Explorer",
"default": false
},
"calva.enableClojureLspOnStart": {
"markdownDescription": "Determines if clojure-lsp should start automatically, and what triggers it. See [calva.io/clojure-lsp](https://calva.io/clojure-lsp/) for info about how using clojure-lsp with Calva.",
"type": "string",
"enum": [
"when-workspace-opened-use-workspace-root",
"when-file-opened-use-furthest-project",
"always-use-first-workspace-root",
"never"
],
"enumDescriptions": [
"Start clojure-lsp automatically when a workspace containing a Clojure project is opened. The server will be started with its project root set to the workspace root. Best option for many single-Clojure-project workspaces and Polylith-like projects. It is recommended to configure your project so that you can use this option and have only one clojure-lsp server running.",
"Start clojure-lsp automatically when a Clojure file is opened. The server will be started with its project root set to the project found furthest from the opened file. Use this option if your monorepo has several Clojure projects, but lacks a governing project file at the workspace root.",
"Start clojure-lsp automatically in the first workspace root. Use this option to avoid starting multiple lsp servers when multiple independent clojure projects are added as workspace folders",
"Don't start clojure-lsp automatically. You can always start clojure-lsp at will via the command palette or from the statusbar. Good option in multi-project workspaces where you want to start a clojure-lsp for a particular project. Also useful if you are running on a machine with limited resources, like a Raspberry Pi."
],
"default": "always-use-first-workspace-root"
},
"calva.prettyPrintingOptions": {
"type": "object",
"description": "Settings for Calva's pretty printing",
"properties": {
"enabled": {
"type": "boolean",
"description": "Should evaluations be pretty printed?"
},
"printEngine": {
"type": "string",
"description": "The print engine to use. 'calva' means that the nREPL server will first plain print it and then Calva will prettify. The other options will make the server use the chosen printer-function to print the result, and Calva will not reformat it. To use some other function (on the server), configure `printFn` instead. To use the `nREPL` default (the equivalent of `clojure.core/pr`), set neither this nore `printFn`.",
"enum": [
"calva",
"pprint",
"fipp",
"puget",
"zprint"
]
},
"printFn": {
"type": "object",
"markdownDescription": "A custom `nREPL` compatible `print-fn`. See https://nrepl.org/nrepl/usage/misc.html#pretty-printing",
"properties": {
"name": {
"type": "string",
"markdownDescription": "A symbol referencing a Clojure function to use for printing result values. E.g. `pr`. Or `foo.bar/baz`."
},
"maxWidthArgument": {
"type": "string",
"markdownDescription": "Argument that the function uses for setting the max-width of the lines printed. E.g. `width`."
},
"seqLimitArgument": {
"type": "string",
"markdownDescription": "Argument that the function uses for truncating the number of elements to print for sequences. E.g. `length`."
},
"maxDepthArgument": {
"type": "string",
"markdownDescription": "Argument that the function uses for limiting the depth that collections are traversed. E.g. `levels`."
}
},
"required": [
"name"
]
},
"width": {
"type": "number",
"description": "The width of the printing. Or line length... Hmmm, you get it, I hope."
},
"maxLength": {
"type": [
"number",
"null"
],
"description": "The maximum number of forms to print of each collection. For no limit, do not include this in your setting. See https://clojuredocs.org/clojure.core/*print-length*"
},
"maxDepth": {
"type": [
"number",
"null"
],
"description": "The maximum number of levels deep the printing will go in nested objects. For no limit, do not include this in your setting. Does not exist for `puget`. See also https://clojuredocs.org/clojure.core/*print-level*"
}
},
"required": [
"enabled"
],
"default": {
"printEngine": "pprint",
"enabled": true,
"width": 120,
"maxLength": 50
}
},
"clojure.trace.server": {
"type": "string",
"default": "off",
"enum": [
"off",
"messages",
"verbose"
],
"description": "Trace communication between Calva and the Clojure language server, clojure-lsp. Trace messages are displayed in the Clojure Language Client output channel."
},
"calva.referencesCodeLens.enabled": {
"type": "boolean",
"default": false,
"description": "Enable/disable references CodeLens in Clojure(Script) files. "
},
"clojure.format.enable": {
"type": "boolean",
"default": true,
"description": "Enable/disable calva-fmt as Clojure formatter"
},
"calva.evalOnSave": {
"type": "boolean",
"default": false,
"description": "Run load-file when opening a new file and on file save"
},
"calva.evaluationSendCodeToOutputWindow": {
"type": "boolean",
"default": false,
"description": "Also send evaluated code to the REPL Window"
},
"calva.testOnSave": {
"type": "boolean",
"default": false,
"description": "Run namespace tests on file save"
},
"calva.showDocstringInParameterHelp": {
"type": "boolean",
"default": false,
"description": "Show the docstring in the parameter hints"
},
"calva.statusColor": {
"type": "object",
"description": "Configuration for custom coloring of the statusbar.",
"properties": {
"light": {
"type": "object",
"description": "Light theme colors",
"properties": {
"disconnectedColor": {
"type": "string",
"pattern": "#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})",
"description": "Foreground color for the disconnected status"
},
"launchingColor": {
"type": "string",
"pattern": "#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})",
"description": "Foreground color for the launching status"
},
"connectedStatusColor": {
"type": "string",
"pattern": "#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})",
"description": "Foreground color for the connected status"
},
"typeStatusColor": {
"type": "string",
"pattern": "#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})",
"description": "Foreground color for the type status"
}
}
},
"dark": {
"type": "object",
"description": "Dark theme colors",
"properties": {
"disconnectedColor": {
"type": "string",
"pattern": "#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})",
"description": "Foreground color for the disconnected status"
},
"launchingColor": {
"type": "string",
"pattern": "#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})",
"description": "Foreground color for the launching status"
},
"connectedStatusColor": {
"type": "string",
"pattern": "#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})",
"description": "Foreground color for the connected status"
},
"typeStatusColor": {
"type": "string",
"pattern": "#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})",
"description": "Foreground color for the type status"
}
}
}
},
"default": {
"light": {
"disconnectedColor": "#777777",
"launchingColor": "#000000",
"connectedStatusColor": "#DB9550",
"typeStatusColor": "#91dc47"
},
"dark": {
"disconnectedColor": "#aaaaaa",
"launchingColor": "#ffffff",
"connectedStatusColor": "#DB9550",
"typeStatusColor": "#91dc47"
}
}
},
"calva.jackInEnv": {
"type": "object",
"default": {},
"description": "Specifies any environment variables your project needs. (Probably mostly for your Workspace Settings.)"
},
"calva.autoSelectNReplPortFromPortFile": {
"type": "boolean",
"default": true,
"markdownDescription": "If true, Calva will auto-select a REPL connection from the nRepl port file, suppressing the `host:port` prompt if the file exists."
},
"calva.autoConnectRepl": {
"type": "boolean",
"default": false,
"markdownDescription": "If true, Calva will auto-connect the REPL when a project is opened and there exists an nRepl port file."
},
"calva.autoStartRepl": {
"type": "boolean",
"default": false,
"markdownDescription": "If true, Calva will auto-start and connect the REPL (a.k.a. Jack-in) when a Clojure project is opened. **NB:** To fully automate the jack-in process, you need to configure `calva.replConnectSequences` such that one sequence is marked with `autoSelectForJackIn`, has `projectRootPath` set, and has `menuSelections` configured."
},
"calva.jackInDependencyVersions": {
"type": "object",
"description": "Versions of the dependencies injected by Calva Jack-in",
"properties": {
"nrepl": {
"type": "string",
"description": "nREPL is the wonderful piece of software that gives Calva a structured and extensible connection to the REPL in your Clojure and ClojureScript projects."
},
"cider-nrepl": {
"type": "string",
"description": "cider-nrepl is middleware that extends the nREPL connection with all sorts of nice stuff that Calva uses to give you a delightful IDE experience."
},
"cider/piggieback": {
"type": "string",
"description": "Piggieback is used to create nREPL sessions in ClojureScript projects (not with shadow-cljs though, which provides its own middleware for this."
}
},
"default": {
"nrepl": "1.1.1",
"cider-nrepl": "0.47.1",
"cider/piggieback": "0.5.3"
}
},
"calva.clojureLspVersion": {
"type": "string",
"default": "latest",
"markdownDescription": "The version of `clojure-lsp` to download and use. This should be a release tag-name, or `latest` (default), or `nightly`. Will take effect after a restart of clojure-lsp. See [calva.io/clojure-lsp](https://calva.io/clojure-lsp) for information about how to manage the clojure-lsp process. NB: _This setting will be ignored if `calva.clojureLspPath` is set to something non-blank._",
"pattern": "^(latest|nightly|\\d{4}\\.\\d{2}\\.\\d{2}-\\d{2}\\.\\d{2}\\.\\d{2})$"
},
"calva.clojureLspPath": {
"type": "string",
"default": "",
"markdownDescription": "The absolute path to the `clojure-lsp` native binary you want Calva to use. When non-blank the `calva.clojureLspVersion` setting will be ignored, and the binary at the path set will be used instead. Will take effect after a restart of clojure-lsp. See [calva.io/clojure-lsp](https://calva.io/clojure-lsp) for information about how to manage the clojure-lsp process."
},
"calva.openBrowserWhenFigwheelStarted": {
"type": "boolean",
"default": true,
"description": "(lein-figwheel only) Should Calva open the Figwheel app for you when Figwheel has been started?"
},
"calva.customREPLCommandSnippets": {
"type": "array",
"default": [],
"markdownDescription": "Configuration for the command **Run Custom REPL Command**",
"$schema": "http://json-schema.org/draft-06/schema#",
"items": {
"title": "replCommand",
"type": "object",
"properties": {
"name": {
"type": "string",
"markDownDescription": "The name of the command will show in the **Run Custom REPL Command** quick-pick menu."
},
"key": {
"type": "string",
"markdownDescription": "The key can be used to reference the snippet from **Run Custom REPL Command** keyboard shortcut arguments. This key will also be used in the quick-pick menu."
},
"snippet": {
"type": [
"string",
"array"
],
"markDownDescription": "Command to send to the REPL"
},
"ns": {
"type": "string",
"markDownDescription": "(optional) Namespace to evaluate the command in. If omitted the command will be executed in the namespace of the current file."
},
"repl": {
"type": "string",
"markDownDescription": "Choose which REPL should the code should be evaluated in. If omitted, the same REPL as for the current file will be used.",
"enum": [
"clj",
"cljs"
]
},
"evaluationSendCodeToOutputWindow": {
"type": "boolean",
"markDownDescription": "Should the code snippet evaluated be echoed to the REPL Window?"
}
},
"required": [
"name",
"snippet"
],
"default": {
"name": "",
"snippet": "",
"evaluationSendCodeToOutputWindow": true
}
}
},
"calva.customREPLHoverSnippets": {
"type": "array",
"default": [],
"description": "Configuration for snippets that get called on hover",
"$schema": "http://json-schema.org/draft-06/schema#",
"items": {
"title": "replHover",
"type": "object",
"properties": {
"name": {
"type": "string",
"markDownDescription": "The name of the snippet will show inside the hover text."
},
"snippet": {
"type": [
"string",
"array"
],
"description": "Snippet to send to the REPL"
},
"ns": {
"type": "string",
"description": "(optional) Namespace to evaluate the snippet in. If omitted the snippet will be executed in the namespace of the current file."
},
"repl": {
"type": "string",
"description": "Choose which REPL should the code should be evaluated in. If omitted, the same REPL as for the current file will be used.",
"enum": [
"clj",
"cljs"
]
}
},
"required": [
"name",
"snippet"
]
}
},
"calva.myLeinProfiles": {
"type": "array",
"description": "At Jack in, any profiles listed here will be added to the profiles found in the `project.clj` file.",
"items": {
"type": "string"
}
},
"calva.myCljAliases": {
"type": "array",
"description": "At Jack in, any aliases listed here will be added to the aliases found in the project's `deps.edn` file.",
"items": {
"type": "string"
}
},
"calva.replConnectSequences": {
"type": "array",
"description": "For when your project needs a custom REPL connect sequence.",
"items": {
"type": "object",
"required": [
"name",
"projectType"
],
"properties": {
"name": {
"type": "string",
"markdownDescription": "This will show up in the Jack-in quick-pick menu when you start Jack-in if you have more than one sequence configured."
},
"projectType": {
"type": "string",
"markdownDescription": "Select one of the project types supported by Calva.",
"enum": [
"Leiningen",
"deps.edn",
"shadow-cljs",
"lein-shadow",
"generic",
"custom"
]
},
"autoSelectForJackIn": {
"type": "boolean",
"markdownDescription": "If true, this sequence will be automatically selected at **Jack-in**, suppressing the Project Type. Use together with `projectRootPath` to also suppress the Project Root menu. Add usage of `menuSelections` to go for a prompt-less REPL Jack-in. If you have more than one sequence with `autoSelectForJackIn` set to true, the first one will be used."
},
"autoSelectForConnect": {
"type": "boolean",
"markdownDescription": "If true, this sequence will be automatically selected at **Connect**, suppressing the Project Type menu. Use together with `projectRootPath` to also suppress the Project Root menu. If you have more than one sequence with `autoSelectForConnect` set to true, the first one will be used."
},
"projectRootPath": {
"type": "array",
"markdownDescription": "An array of path segments leading to the root of the project to which this connect sequence corresponds. Use together with `autoSelectForJackIn`/`autoSelectForConnect` to suppress the Project Root menu. The path can be absolute or relative to the workspace root. If there are several Workspace Folders, the workspace root is the path of the first folder, so relative paths will only work for this first folder. If you can't be bothered splitting up the path in segments, put the whole path in the first segment, though please note that if you use Windows path separators, these will not work for users with Linux or macOS.",
"items": {
"type": "string"
}
},
"nReplPortFile": {
"type": "array",
"description": "An array of path segments for the relative path from the project root to the nREPL port file for this connect sequence. E.g. For shadow-cljs this would be [\".shadow-cljs\", \"nrepl.port\"]",
"items": {
"type": "string"
}
},
"customJackInCommandLine": {
"type": "string",
"markdownDescription": "A custom command line, completely up to you.",
"items": {
"type": "string"
}
},
"afterCLJReplJackInCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
],
"markdownDescription": "Code to evaluate in the CLJ REPL once it has been created. You can use either a string or an array of strings. If you use an array, the strings will be joined with a newline character to form the resulting code.",
"required": false
},
"menuSelections": {
"type": "object",
"description": "Pre-selected menu options. If a selection is made here. Calva won't prompt for it.",
"properties": {
"leinProfiles": {
"type": "array",
"description": "At Jack-in to a Leiningen project, use these profiles to launch the repl.",
"items": {
"type": "string"
}
},
"leinAlias": {
"description": "At Jack-in to a Leiningen project, launch with this alias. Set to null to launch with Calva's default task (a headless repl).",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"cljAliases": {
"type": "array",
"description": "At Jack-in to a deps.edn project, use these aliases to launch the repl.",
"items": {
"type": "string"
}
},
"cljsLaunchBuilds": {
"type": "array",
"description": "The cljs builds to start/watch at Jack-in/connect.",
"items": {
"type": "string"
}
},
"cljsDefaultBuild": {
"type": "string",
"description": "Which cljs build to attach to at the initial connect."
}
}
},
"cljsType": {
"description": "Either a built in type, or an object configuring a custom type. If omitted Calva will show a menu with the built-in types.",
"anyOf": [
{
"type": "string",
"enum": [
"Figwheel Main",
"lein-figwheel",
"shadow-cljs",
"ClojureScript built-in for browser",
"ClojureScript built-in for node",
"none"
]
},
{
"type": "object",
"required": [
"connectCode",
"dependsOn"
],
"properties": {
"dependsOn": {
"type": "string",
"enum": [
"Figwheel Main",
"lein-figwheel",
"shadow-cljs",
"ClojureScript built-in for browser",
"ClojureScript built-in for node",
"User provided"
],
"description": "The ClojureScript REPL dependencies this customization needs. NB: If it is `User provided`, then you need to provide the dependencies in the project, or launch with an alias (deps.edn), profile (Leiningen), or build (shadow-cljs) that provides the dependencies needed."
},
"buildsRequired": {
"type": "boolean",
"description": "If the repl type requires that builds are started in order to connect to them, set this to true."
},
"isStarted": {
"type": "boolean",
"description": "For cljs repls that Calva does not need to start, set this to true. (If you base your custom cljs repl on shadow-cljs workflow, for instance.)"
},
"startCode": {
"type": "string",
"description": "Clojure code to be evaluated to create and/or start your custom CLJS REPL."
},
"isReadyToStartRegExp": {
"type": "string",
"description": "A regular expression which, when matched in the stdout from the startCode evaluation, will make Calva continue with connecting the REPL, and to prompt the user to start the application. If omitted and there is startCode Calva will continue when that code is evaluated."
},
"openUrlRegExp": {
"type": "string",
"description": "A regular expression, matched against the stdout of cljsType evaluations, for extracting the URL with which the app can be started. The expression should have a capturing group named 'url'. E.g. \\”Open URL: (?<url>\\S+)\\”",
"default": "Open(ing)? URL (?<url>\\S+)"
},
"shouldOpenUrl": {
"type": "boolean",
"description": "Choose if Calva should automatically open the URL for you or not."
},
"connectCode": {
"type": "string",
"description": "Clojure code to be evaluated to convert the REPL to a CLJS REPL that Calva can use to connect to the application."
},
"isConnectedRegExp": {
"type": "string",
"description": "A regular expression which, when matched in the stdout of the connectCode evaluation, will tell Calva that the application is connected.",
"default": "To quit, type: :cljs/quit"
},
"printThisLineRegExp": {
"type": "string",
"description": "A regular expression which, when matched in the stdout from any code evaluations in the cljsType, will make the matched text be printed to wherever Calva prints output."
}
}
}
]
},
"jackInEnv": {
"type": "object",
"default": {},
"markdownDescription": "Environment variables that will be merged with any global `calva.jackInEnv` and then applied to the Jack-in process. The merge is very similar to how Clojure's `merge` works. So for any common keys between the global setting and this one, the ones from this setting will win."
}
}
}
},
"calva.projectRootsSearchExclude": {
"type": "array",
"markdownDescription": "Exclude these directories when searching for projects in the workspace during Jack-in/Connect. Each entry is a partial *glob* and will be part of a resulting *glob* of the form `**/{glob1,glob2,...,globN}`. This means that all directories in the workspace matching an entry will be excluded.",
"items": {
"type": "string"
},
"default": [
"bower_components",
".bzr",
".cache",
".ccls-cache",
".clangd",
".classpath",
"*.code-search",
".cpcache",
"_darcs",
".DS_Store",
".ensime_cache",
".eunit",
"flow-typed",
"_FOSSIL_",
".fslckout",
".git",
".hg",
".idea",
".joyride",
"node_modules",
".pijul",
".project",
".shadow-cljs",
".stack-work",
".svn",
"target",
".tox",
".vscode"
]
},
"calva.enableJSCompletions": {
"type": "boolean",
"description": "Should Calva use suitible and bring you JavaScript completions? This is an experimental cider-nrepl feature. Disable if completions start to throw errors.",
"default": true
},
"calva.autoOpenREPLWindow": {
"type": "boolean",
"markdownDescription": "Automatically open the REPL window on Jack-in or Connect.",
"default": false
},
"calva.autoOpenJackInTerminal": {
"type": "boolean",
"markdownDescription": "Automatically open the the Jack-in Terminal on Jack-in.",
"default": false
},
"calva.autoOpenResultOutputDestination": {
"type": "boolean",
"markdownDescription": "Automatically open the the Jack-in Terminal on Jack-in or Connect.",
"default": true
},
"calva.autoOpenInspector": {
"type": "boolean",
"markdownDescription": "Automatically open/reveal the Calva Inspector on Jack-in or Connect.",
"default": true
},
"calva.enableInspectorRainbow": {
"type": "boolean",
"markdownDescription": "Should the Calva Inspector items use rainbow colors? When enabled, the collection items will be colored with the same colors as VS Code uses for bracket pairs. See https://calva.io/inspector for info.",
"default": false
},
"calva.keybindingsEnabled": {
"type": "boolean",
"description": "Activate keybindings.",
"default": true,
"scope": "window"
},
"calva.showCalvaSaysOnStart": {
"type": "boolean",
"markdownDescription": "Show the Calva Says output panel on start?",
"default": false
},
"calva.definitionProviderPriority": {
"markdownDescription": "Calva can provide definitions using both the REPL connection and via clojure-lsp. Which provider should Calva prioritize when both are available?",
"enum": [
[
"repl",
"lsp"
],
[
"lsp",
"repl"
]
],
"markdownEnumDescriptions": [
"Use dynamic (REPL) definitions when available.",
"Use static (clojure-lsp) definitions when available."
],
"default": [
"repl",
"lsp"
]
},
"calva.depsEdnJackInExecutable": {
"markdownDescription": "Which executable should Calva Jack-in use for starting a deps.edn project? The default is to let Calva choose. It will choose `clojure` if that is installed and working. Otherwise `deps.clj`, which is bundled with Calva, will be used. (This settings has no effect on Windows, where `deps.clj` will always be used.)",
"enum": [
"clojure",
"deps.clj",
"clojure or deps.clj"
],
"markdownEnumDescriptions": [
"Always use `clojure`",
"Always use `deps.clj`",
"Prefer `clojure`, but use `deps.clj` if `clojure` doesn't seem to work"
],
"default": "clojure or deps.clj",
"type": "string"
},
"calva.html2HiccupOptions": {
"type": "object",
"markdownDescription": "Options for the `html2hiccup` command. See [calva.io/hiccup](https://calva.io/hiccup/)",
"properties": {
"mapify-style?": {
"type": "boolean",
"markdownDescription": "Should the `style` attribute be converted to a map?",
"default": false
},
"kebab-attrs?": {
"type": "boolean",
"markdownDescription": "Should the attribute names be converted to a kebab-case?",
"default": false
},
"add-classes-to-tag-keyword?": {
"type": "boolean",
"markdownDescription": "Should all class names be added as CSS-like shortcuts to tag keyword?",
"default": true
}
},
"default": {
"mapify-style?": false,
"kebab-attrs?": false,
"add-classes-to-tag-keyword?": true
}
},
"calva.autoEvaluateCode": {
"type": "object",
"markdownDescription": "Code to automatically evaluate when a REPL has been connected, or a file/namespace has been loaded/evaluated. See https://calva.io/customizing-jack-in-and-connect/ for details.",
"properties": {
"onConnect": {
"type": "object",
"markdownDescription": "When a REPL has been connected.",
"properties": {
"clj": {
"type": "string",
"markdownDescription": "Code to evaluate when the **Clojure** REPL has been connected. The default is code that refer in the `repl-requires`/REPL utilities (like `source`, `doc`, etcetera). (Note that there is also a command to do this on demand.). The code will be evaluated *before* the `afterCLJReplJackInCode` in any [connect sequence](https://calva.io/connect-sequences/) used. Set to `null` to disable this feature."
},
"cljs": {
"type": "string",
"markdownDescription": "Code to evaluate when the **ClojureScript** REPL has been connected. The default is code that refer in the `repl-requires`/REPL utilities (like `source`, `doc`, etcetera). (Note that there is also a command to do this on demand.). Set to `null` to disable this feature."
}
}
},
"onFileLoaded": {
"type": "object",
"markdownDescription": "When a file/namespace has been loaded/evaluated.",
"properties": {
"clj": {
"type": "string",
"markdownDescription": "Code to evaluate when the current file/namespace has been loaded/evaluated (via the command for this), in the **Clojure** REPL. The same substitution variables as with [custom commands](https://calva.io/custom-commands/) can be used here."
},
"cljs": {
"type": "string",
"markdownDescription": "Code to evaluate when the current file/namespace has been loaded/evaluated (via the command for this), in the **ClojureScript** REPL. The same substitution variables as with [custom commands](https://calva.io/custom-commands/) can be used here."
}
}
}
},
"default": {
"onConnect": {
"clj": "(when-let [requires (resolve 'clojure.main/repl-requires)] (clojure.core/apply clojure.core/require @requires))",
"cljs": "(require '[cljs.repl :refer [apropos dir doc find-doc print-doc pst source]])"
},
"onFileLoaded": {
"clj": null,
"cljs": null
}
}
},
"calva.redirectServerOutputToRepl": {
"type": "boolean",
"markdownDescription": "Redirect the output from the REPL server process to the Output Destination. With this disabled, output from child threads of evaluations will not be shown in the output destination, but instead in the terminal where the REPL is started (the jack-in terminal if Calva started the REPL).",
"default": true
},
"calva.basilispPath": {
"type": "string",
"default": "basilisp",
"markdownDescription": "The path to the `basilisp` executable. If Basilisp is installed in a virtual environment, update this to the full path of the `basilisp` executable within that virtual environment."
}