@cspell/cspell-types 5.13.4 → 5.14.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -32,22 +32,22 @@
32
32
  "DictionaryDefinitionAlternate": {
33
33
  "additionalProperties": false,
34
34
  "deprecated": true,
35
- "deprecationMessage": "Use `DictionaryDefinitionPreferred`",
36
- "description": "Only for legacy dictionary definitions",
35
+ "deprecationMessage": "Use `DictionaryDefinitionPreferred` instead.",
36
+ "description": "Only for legacy dictionary definitions.",
37
37
  "properties": {
38
38
  "description": {
39
- "description": "Optional description",
39
+ "description": "Optional description.",
40
40
  "type": "string"
41
41
  },
42
42
  "file": {
43
43
  "$ref": "#/definitions/DictionaryPath",
44
44
  "deprecated": true,
45
45
  "deprecationMessage": "Use `path` instead.",
46
- "description": "Path to the file, only for legacy dictionary definitions"
46
+ "description": "Path to the file, only for legacy dictionary definitions."
47
47
  },
48
48
  "name": {
49
49
  "$ref": "#/definitions/DictionaryId",
50
- "description": "This is the name of a dictionary.\n\nName Format:\n- Must contain at least 1 number or letter.\n- spaces are allowed.\n- Leading and trailing space will be removed.\n- Names ARE case-sensitive\n- Must not contain `*`, `!`, `;`, `,`, `{`, `}`, `[`, `]`, `~`"
50
+ "description": "This is the name of a dictionary.\n\nName Format:\n- Must contain at least 1 number or letter.\n- Spaces are allowed.\n- Leading and trailing space will be removed.\n- Names ARE case-sensitive.\n- Must not contain `*`, `!`, `;`, `,`, `{`, `}`, `[`, `]`, `~`."
51
51
  },
52
52
  "noSuggest": {
53
53
  "description": "Indicate that suggestions should not come from this dictionary. Words in this dictionary are considered correct, but will not be used when making spell correction suggestions.\n\nNote: if a word is suggested by another dictionary, but found in this dictionary, it will be removed from the set of possible suggestions.",
@@ -55,15 +55,15 @@
55
55
  },
56
56
  "repMap": {
57
57
  "$ref": "#/definitions/ReplaceMap",
58
- "description": "Replacement pairs"
58
+ "description": "Replacement pairs."
59
59
  },
60
60
  "type": {
61
61
  "$ref": "#/definitions/DictionaryFileTypes",
62
62
  "default": "S",
63
- "description": "Type of file: S - single word per line, W - each line can contain one or more words separated by space, C - each line is treated like code (Camel Case is allowed) Default is S C is the slowest to load due to the need to split each line based upon code splitting rules."
63
+ "description": "Type of file: S - single word per line, W - each line can contain one or more words separated by space, C - each line is treated like code (Camel Case is allowed). Default is S. C is the slowest to load due to the need to split each line based upon code splitting rules."
64
64
  },
65
65
  "useCompounds": {
66
- "description": "Use Compounds",
66
+ "description": "Use Compounds.",
67
67
  "type": "boolean"
68
68
  }
69
69
  },
@@ -82,12 +82,12 @@
82
82
  "type": "boolean"
83
83
  },
84
84
  "description": {
85
- "description": "Optional description",
85
+ "description": "Optional description.",
86
86
  "type": "string"
87
87
  },
88
88
  "name": {
89
89
  "$ref": "#/definitions/DictionaryId",
90
- "description": "This is the name of a dictionary.\n\nName Format:\n- Must contain at least 1 number or letter.\n- spaces are allowed.\n- Leading and trailing space will be removed.\n- Names ARE case-sensitive\n- Must not contain `*`, `!`, `;`, `,`, `{`, `}`, `[`, `]`, `~`"
90
+ "description": "This is the name of a dictionary.\n\nName Format:\n- Must contain at least 1 number or letter.\n- Spaces are allowed.\n- Leading and trailing space will be removed.\n- Names ARE case-sensitive.\n- Must not contain `*`, `!`, `;`, `,`, `{`, `}`, `[`, `]`, `~`."
91
91
  },
92
92
  "noSuggest": {
93
93
  "description": "Indicate that suggestions should not come from this dictionary. Words in this dictionary are considered correct, but will not be used when making spell correction suggestions.\n\nNote: if a word is suggested by another dictionary, but found in this dictionary, it will be removed from the set of possible suggestions.",
@@ -99,7 +99,7 @@
99
99
  },
100
100
  "repMap": {
101
101
  "$ref": "#/definitions/ReplaceMap",
102
- "description": "Replacement pairs"
102
+ "description": "Replacement pairs."
103
103
  },
104
104
  "scope": {
105
105
  "anyOf": [
@@ -113,15 +113,15 @@
113
113
  "type": "array"
114
114
  }
115
115
  ],
116
- "description": "Defines the scope for when words will be added to the dictionary. Scope values: `user`, `workspace`, `folder`"
116
+ "description": "Defines the scope for when words will be added to the dictionary. Scope values: `user`, `workspace`, `folder`."
117
117
  },
118
118
  "type": {
119
119
  "$ref": "#/definitions/DictionaryFileTypes",
120
120
  "default": "S",
121
- "description": "Type of file: S - single word per line, W - each line can contain one or more words separated by space, C - each line is treated like code (Camel Case is allowed) Default is S C is the slowest to load due to the need to split each line based upon code splitting rules."
121
+ "description": "Type of file: S - single word per line, W - each line can contain one or more words separated by space, C - each line is treated like code (Camel Case is allowed). Default is S. C is the slowest to load due to the need to split each line based upon code splitting rules."
122
122
  },
123
123
  "useCompounds": {
124
- "description": "Use Compounds",
124
+ "description": "Use Compounds.",
125
125
  "type": "boolean"
126
126
  }
127
127
  },
@@ -136,12 +136,12 @@
136
136
  "additionalProperties": false,
137
137
  "properties": {
138
138
  "description": {
139
- "description": "Optional description",
139
+ "description": "Optional description.",
140
140
  "type": "string"
141
141
  },
142
142
  "name": {
143
143
  "$ref": "#/definitions/DictionaryId",
144
- "description": "This is the name of a dictionary.\n\nName Format:\n- Must contain at least 1 number or letter.\n- spaces are allowed.\n- Leading and trailing space will be removed.\n- Names ARE case-sensitive\n- Must not contain `*`, `!`, `;`, `,`, `{`, `}`, `[`, `]`, `~`"
144
+ "description": "This is the name of a dictionary.\n\nName Format:\n- Must contain at least 1 number or letter.\n- Spaces are allowed.\n- Leading and trailing space will be removed.\n- Names ARE case-sensitive.\n- Must not contain `*`, `!`, `;`, `,`, `{`, `}`, `[`, `]`, `~`."
145
145
  },
146
146
  "noSuggest": {
147
147
  "description": "Indicate that suggestions should not come from this dictionary. Words in this dictionary are considered correct, but will not be used when making spell correction suggestions.\n\nNote: if a word is suggested by another dictionary, but found in this dictionary, it will be removed from the set of possible suggestions.",
@@ -149,19 +149,19 @@
149
149
  },
150
150
  "path": {
151
151
  "$ref": "#/definitions/DictionaryPath",
152
- "description": "Path to the file"
152
+ "description": "Path to the file."
153
153
  },
154
154
  "repMap": {
155
155
  "$ref": "#/definitions/ReplaceMap",
156
- "description": "Replacement pairs"
156
+ "description": "Replacement pairs."
157
157
  },
158
158
  "type": {
159
159
  "$ref": "#/definitions/DictionaryFileTypes",
160
160
  "default": "S",
161
- "description": "Type of file: S - single word per line, W - each line can contain one or more words separated by space, C - each line is treated like code (Camel Case is allowed) Default is S C is the slowest to load due to the need to split each line based upon code splitting rules."
161
+ "description": "Type of file: S - single word per line, W - each line can contain one or more words separated by space, C - each line is treated like code (Camel Case is allowed). Default is S. C is the slowest to load due to the need to split each line based upon code splitting rules."
162
162
  },
163
163
  "useCompounds": {
164
- "description": "Use Compounds",
164
+ "description": "Use Compounds.",
165
165
  "type": "boolean"
166
166
  }
167
167
  },
@@ -181,12 +181,12 @@
181
181
  "type": "string"
182
182
  },
183
183
  "DictionaryId": {
184
- "description": "This is the name of a dictionary.\n\nName Format:\n- Must contain at least 1 number or letter.\n- spaces are allowed.\n- Leading and trailing space will be removed.\n- Names ARE case-sensitive\n- Must not contain `*`, `!`, `;`, `,`, `{`, `}`, `[`, `]`, `~`",
184
+ "description": "This is the name of a dictionary.\n\nName Format:\n- Must contain at least 1 number or letter.\n- Spaces are allowed.\n- Leading and trailing space will be removed.\n- Names ARE case-sensitive.\n- Must not contain `*`, `!`, `;`, `,`, `{`, `}`, `[`, `]`, `~`.",
185
185
  "pattern": "^(?=[^!*,;{}[\\]~\\n]+$)(?=(.*\\w)).+$",
186
186
  "type": "string"
187
187
  },
188
188
  "DictionaryNegRef": {
189
- "description": "This a negative reference to a named dictionary.\n\nIt is used to exclude or include a dictionary by name.\n\nThe reference starts with 1 or more `!`.\n- `!<dictionary_name>` - Used to exclude the dictionary matching `<dictionary_name>`\n- `!!<dictionary_name>` - Used to re-include a dictionary matching `<dictionary_name>` Overrides `!<dictionary_name>`.\n- `!!!<dictionary_name>` - Used to exclude a dictionary matching `<dictionary_name>` Overrides `!!<dictionary_name>`.",
189
+ "description": "This a negative reference to a named dictionary.\n\nIt is used to exclude or include a dictionary by name.\n\nThe reference starts with 1 or more `!`.\n- `!<dictionary_name>` - Used to exclude the dictionary matching `<dictionary_name>`.\n- `!!<dictionary_name>` - Used to re-include a dictionary matching `<dictionary_name>`. Overrides `!<dictionary_name>`.\n- `!!!<dictionary_name>` - Used to exclude a dictionary matching `<dictionary_name>`. Overrides `!!<dictionary_name>`.",
190
190
  "pattern": "^(?=!+[^!*,;{}[\\]~\\n]+$)(?=(.*\\w)).+$",
191
191
  "type": "string"
192
192
  },
@@ -211,12 +211,12 @@
211
211
  "description": "Reference to a dictionary by name. One of:\n- {@link DictionaryRef } \n- {@link DictionaryNegRef }"
212
212
  },
213
213
  "FsPath": {
214
- "description": "A File System Path",
214
+ "description": "A File System Path.",
215
215
  "type": "string"
216
216
  },
217
217
  "Glob": {
218
218
  "$ref": "#/definitions/SimpleGlob",
219
- "description": "These are glob expressions"
219
+ "description": "These are glob expressions."
220
220
  },
221
221
  "LanguageId": {
222
222
  "anyOf": [
@@ -260,7 +260,7 @@
260
260
  "type": "boolean"
261
261
  },
262
262
  "description": {
263
- "description": "Optional description of configuration",
263
+ "description": "Optional description of configuration.",
264
264
  "type": "string"
265
265
  },
266
266
  "dictionaries": {
@@ -271,7 +271,7 @@
271
271
  "type": "array"
272
272
  },
273
273
  "dictionaryDefinitions": {
274
- "description": "Define additional available dictionaries",
274
+ "description": "Define additional available dictionaries.",
275
275
  "items": {
276
276
  "$ref": "#/definitions/DictionaryDefinition"
277
277
  },
@@ -279,23 +279,23 @@
279
279
  },
280
280
  "enabled": {
281
281
  "default": true,
282
- "description": "Is the spell checker enabled",
282
+ "description": "Is the spell checker enabled.",
283
283
  "type": "boolean"
284
284
  },
285
285
  "flagWords": {
286
- "description": "list of words to always be considered incorrect.",
286
+ "description": "List of words to always be considered incorrect.",
287
287
  "items": {
288
288
  "type": "string"
289
289
  },
290
290
  "type": "array"
291
291
  },
292
292
  "id": {
293
- "description": "Optional identifier",
293
+ "description": "Optional identifier.",
294
294
  "type": "string"
295
295
  },
296
296
  "ignoreRegExpList": {
297
297
  "$ref": "#/definitions/RegExpPatternList",
298
- "description": "List of RegExp patterns or Pattern names to exclude from spell checking.\n\nExample: [\"href\"] - to exclude html href"
298
+ "description": "List of RegExp patterns or Pattern names to exclude from spell checking.\n\nExample: [\"href\"] - to exclude html href."
299
299
  },
300
300
  "ignoreWords": {
301
301
  "description": "List of words to be ignored. An Ignored word will not show up as an error even if it is also in the `flagWords`.",
@@ -320,7 +320,7 @@
320
320
  "type": "array"
321
321
  }
322
322
  ],
323
- "description": "The language id. Ex: \"typescript\", \"html\", or \"php\". \"*\" -- will match all languages"
323
+ "description": "The language id. Ex: \"typescript\", \"html\", or \"php\". \"*\" -- will match all languages."
324
324
  },
325
325
  "local": {
326
326
  "anyOf": [
@@ -335,7 +335,7 @@
335
335
  }
336
336
  ],
337
337
  "deprecated": true,
338
- "deprecationMessage": "Use `locale` instead",
338
+ "deprecationMessage": "Use `locale` instead.",
339
339
  "description": "Deprecated - The locale filter, matches against the language. This can be a comma separated list. \"*\" will match all locales."
340
340
  },
341
341
  "locale": {
@@ -353,7 +353,7 @@
353
353
  "description": "The locale filter, matches against the language. This can be a comma separated list. \"*\" will match all locales."
354
354
  },
355
355
  "name": {
356
- "description": "Optional name of configuration",
356
+ "description": "Optional name of configuration.",
357
357
  "type": "string"
358
358
  },
359
359
  "noSuggestDictionaries": {
@@ -364,14 +364,14 @@
364
364
  "type": "array"
365
365
  },
366
366
  "patterns": {
367
- "description": "Defines a list of patterns that can be used in ignoreRegExpList and includeRegExpList",
367
+ "description": "Defines a list of patterns that can be used in ignoreRegExpList and includeRegExpList.",
368
368
  "items": {
369
369
  "$ref": "#/definitions/RegExpPatternDefinition"
370
370
  },
371
371
  "type": "array"
372
372
  },
373
373
  "words": {
374
- "description": "list of words to be always considered correct",
374
+ "description": "List of words to be always considered correct.",
375
375
  "items": {
376
376
  "type": "string"
377
377
  },
@@ -401,7 +401,7 @@
401
401
  "type": "boolean"
402
402
  },
403
403
  "description": {
404
- "description": "Optional description of configuration",
404
+ "description": "Optional description of configuration.",
405
405
  "type": "string"
406
406
  },
407
407
  "dictionaries": {
@@ -412,7 +412,7 @@
412
412
  "type": "array"
413
413
  },
414
414
  "dictionaryDefinitions": {
415
- "description": "Define additional available dictionaries",
415
+ "description": "Define additional available dictionaries.",
416
416
  "items": {
417
417
  "$ref": "#/definitions/DictionaryDefinition"
418
418
  },
@@ -430,7 +430,7 @@
430
430
  },
431
431
  "enabled": {
432
432
  "default": true,
433
- "description": "Is the spell checker enabled",
433
+ "description": "Is the spell checker enabled.",
434
434
  "type": "boolean"
435
435
  },
436
436
  "enabledLanguageIds": {
@@ -452,22 +452,22 @@
452
452
  "type": "array"
453
453
  }
454
454
  ],
455
- "description": "Glob pattern or patterns to match against"
455
+ "description": "Glob pattern or patterns to match against."
456
456
  },
457
457
  "flagWords": {
458
- "description": "list of words to always be considered incorrect.",
458
+ "description": "List of words to always be considered incorrect.",
459
459
  "items": {
460
460
  "type": "string"
461
461
  },
462
462
  "type": "array"
463
463
  },
464
464
  "id": {
465
- "description": "Optional identifier",
465
+ "description": "Optional identifier.",
466
466
  "type": "string"
467
467
  },
468
468
  "ignoreRegExpList": {
469
469
  "$ref": "#/definitions/RegExpPatternList",
470
- "description": "List of RegExp patterns or Pattern names to exclude from spell checking.\n\nExample: [\"href\"] - to exclude html href"
470
+ "description": "List of RegExp patterns or Pattern names to exclude from spell checking.\n\nExample: [\"href\"] - to exclude html href."
471
471
  },
472
472
  "ignoreWords": {
473
473
  "description": "List of words to be ignored. An Ignored word will not show up as an error even if it is also in the `flagWords`.",
@@ -482,11 +482,11 @@
482
482
  },
483
483
  "language": {
484
484
  "$ref": "#/definitions/LocaleId",
485
- "description": "Sets the locale"
485
+ "description": "Sets the locale."
486
486
  },
487
487
  "languageId": {
488
488
  "$ref": "#/definitions/LanguageId",
489
- "description": "Sets the programming language id"
489
+ "description": "Sets the programming language id."
490
490
  },
491
491
  "languageSettings": {
492
492
  "description": "Additional settings for individual languages.",
@@ -511,7 +511,7 @@
511
511
  "type": "number"
512
512
  },
513
513
  "name": {
514
- "description": "Optional name of configuration",
514
+ "description": "Optional name of configuration.",
515
515
  "type": "string"
516
516
  },
517
517
  "noSuggestDictionaries": {
@@ -523,11 +523,11 @@
523
523
  },
524
524
  "numSuggestions": {
525
525
  "default": 10,
526
- "description": "Number of suggestions to make",
526
+ "description": "Number of suggestions to make.",
527
527
  "type": "number"
528
528
  },
529
529
  "patterns": {
530
- "description": "Defines a list of patterns that can be used in ignoreRegExpList and includeRegExpList",
530
+ "description": "Defines a list of patterns that can be used in ignoreRegExpList and includeRegExpList.",
531
531
  "items": {
532
532
  "$ref": "#/definitions/RegExpPatternDefinition"
533
533
  },
@@ -560,7 +560,7 @@
560
560
  "type": "boolean"
561
561
  },
562
562
  "words": {
563
- "description": "list of words to be always considered correct",
563
+ "description": "List of words to be always considered correct.",
564
564
  "items": {
565
565
  "type": "string"
566
566
  },
@@ -576,7 +576,7 @@
576
576
  "type": "string"
577
577
  },
578
578
  "PatternId": {
579
- "description": "This matches the name in a pattern definition",
579
+ "description": "This matches the name in a pattern definition.",
580
580
  "type": "string"
581
581
  },
582
582
  "PatternRef": {
@@ -645,7 +645,7 @@
645
645
  "type": "array"
646
646
  }
647
647
  ],
648
- "description": "RegExp pattern or array of RegExp patterns"
648
+ "description": "RegExp pattern or array of RegExp patterns."
649
649
  }
650
650
  },
651
651
  "required": [
@@ -655,7 +655,7 @@
655
655
  "type": "object"
656
656
  },
657
657
  "RegExpPatternList": {
658
- "description": "A list of pattern names or regular expressions",
658
+ "description": "A list of pattern names or regular expressions.",
659
659
  "items": {
660
660
  "$ref": "#/definitions/PatternRef"
661
661
  },
@@ -700,10 +700,10 @@
700
700
  "type": "array"
701
701
  }
702
702
  ],
703
- "description": "reporter name or reporter name + reporter config"
703
+ "description": "Reporter name or reporter name + reporter config."
704
704
  },
705
705
  "SimpleGlob": {
706
- "description": "Simple Glob string, the root will be globRoot",
706
+ "description": "Simple Glob string, the root will be globRoot.",
707
707
  "type": "string"
708
708
  },
709
709
  "Version": {
@@ -718,14 +718,14 @@
718
718
  },
719
719
  "VersionLatest": {
720
720
  "const": "0.2",
721
- "description": "Configuration File Version",
721
+ "description": "Configuration File Version.",
722
722
  "type": "string"
723
723
  },
724
724
  "VersionLegacy": {
725
725
  "const": "0.1",
726
726
  "deprecated": true,
727
- "deprecationMessage": "Use `0.2`",
728
- "description": "Legacy Configuration File Versions",
727
+ "deprecationMessage": "Use `0.2` instead.",
728
+ "description": "Legacy Configuration File Versions.",
729
729
  "type": "string"
730
730
  }
731
731
  },
@@ -744,7 +744,7 @@
744
744
  "type": "boolean"
745
745
  },
746
746
  "description": {
747
- "description": "Optional description of configuration",
747
+ "description": "Optional description of configuration.",
748
748
  "type": "string"
749
749
  },
750
750
  "dictionaries": {
@@ -755,7 +755,7 @@
755
755
  "type": "array"
756
756
  },
757
757
  "dictionaryDefinitions": {
758
- "description": "Define additional available dictionaries",
758
+ "description": "Define additional available dictionaries.",
759
759
  "items": {
760
760
  "$ref": "#/definitions/DictionaryDefinition"
761
761
  },
@@ -778,7 +778,7 @@
778
778
  },
779
779
  "enabled": {
780
780
  "default": true,
781
- "description": "Is the spell checker enabled",
781
+ "description": "Is the spell checker enabled.",
782
782
  "type": "boolean"
783
783
  },
784
784
  "enabledLanguageIds": {
@@ -796,7 +796,7 @@
796
796
  "type": "array"
797
797
  },
798
798
  "flagWords": {
799
- "description": "list of words to always be considered incorrect.",
799
+ "description": "List of words to always be considered incorrect.",
800
800
  "items": {
801
801
  "type": "string"
802
802
  },
@@ -818,14 +818,14 @@
818
818
  },
819
819
  "globRoot": {
820
820
  "$ref": "#/definitions/FsPath",
821
- "description": "The root to use for glop patterns found in this configuration. Default: location of the configuration file. For compatibility reasons, config files with version 0.1, the glob root will default to be `${cwd}`.\n\nUse `globRoot` to define a different location. `globRoot` can be relative to the location of this configuration file. Defining globRoot, does not impact imported configurations.\n\nSpecial Values:\n- `${cwd}` - will be replaced with the current working directory.\n- `.` - will be the location of the containing configuration file."
821
+ "description": "The root to use for glob patterns found in this configuration. Default: location of the configuration file. For compatibility reasons, config files with version 0.1, the glob root will default to be `${cwd}`.\n\nUse `globRoot` to define a different location. `globRoot` can be relative to the location of this configuration file. Defining globRoot, does not impact imported configurations.\n\nSpecial Values:\n- `${cwd}` - will be replaced with the current working directory.\n- `.` - will be the location of the containing configuration file."
822
822
  },
823
823
  "id": {
824
- "description": "Optional identifier",
824
+ "description": "Optional identifier.",
825
825
  "type": "string"
826
826
  },
827
827
  "ignorePaths": {
828
- "description": "Glob patterns of files to be ignored Glob patterns are relative to the `globRoot` of the configuration file that defines them.",
828
+ "description": "Glob patterns of files to be ignored. Glob patterns are relative to the `globRoot` of the configuration file that defines them.",
829
829
  "items": {
830
830
  "$ref": "#/definitions/Glob"
831
831
  },
@@ -833,7 +833,7 @@
833
833
  },
834
834
  "ignoreRegExpList": {
835
835
  "$ref": "#/definitions/RegExpPatternList",
836
- "description": "List of RegExp patterns or Pattern names to exclude from spell checking.\n\nExample: [\"href\"] - to exclude html href"
836
+ "description": "List of RegExp patterns or Pattern names to exclude from spell checking.\n\nExample: [\"href\"] - to exclude html href."
837
837
  },
838
838
  "ignoreWords": {
839
839
  "description": "List of words to be ignored. An Ignored word will not show up as an error even if it is also in the `flagWords`.",
@@ -854,7 +854,7 @@
854
854
  "type": "array"
855
855
  }
856
856
  ],
857
- "description": "Other settings files to be included"
857
+ "description": "Other settings files to be included."
858
858
  },
859
859
  "includeRegExpList": {
860
860
  "$ref": "#/definitions/RegExpPatternList",
@@ -863,7 +863,7 @@
863
863
  "language": {
864
864
  "$ref": "#/definitions/LocaleId",
865
865
  "default": "en",
866
- "description": "Current active spelling language.\n\nExample: \"en-GB\" for British English\n\nExample: \"en,nl\" to enable both English and Dutch"
866
+ "description": "Current active spelling language.\n\nExample: \"en-GB\" for British English.\n\nExample: \"en,nl\" to enable both English and Dutch."
867
867
  },
868
868
  "languageId": {
869
869
  "$ref": "#/definitions/LanguageId",
@@ -892,7 +892,7 @@
892
892
  "type": "number"
893
893
  },
894
894
  "name": {
895
- "description": "Optional name of configuration",
895
+ "description": "Optional name of configuration.",
896
896
  "type": "string"
897
897
  },
898
898
  "noConfigSearch": {
@@ -909,7 +909,7 @@
909
909
  },
910
910
  "numSuggestions": {
911
911
  "default": 10,
912
- "description": "Number of suggestions to make",
912
+ "description": "Number of suggestions to make.",
913
913
  "type": "number"
914
914
  },
915
915
  "overrides": {
@@ -920,7 +920,7 @@
920
920
  "type": "array"
921
921
  },
922
922
  "patterns": {
923
- "description": "Defines a list of patterns that can be used in ignoreRegExpList and includeRegExpList",
923
+ "description": "Defines a list of patterns that can be used in ignoreRegExpList and includeRegExpList.",
924
924
  "items": {
925
925
  "$ref": "#/definitions/RegExpPatternDefinition"
926
926
  },
@@ -943,7 +943,7 @@
943
943
  "type": "boolean"
944
944
  },
945
945
  "reporters": {
946
- "description": "Custom reporters configuration",
946
+ "description": "Custom reporters configuration.",
947
947
  "items": {
948
948
  "$ref": "#/definitions/ReporterSettings"
949
949
  },
@@ -951,7 +951,7 @@
951
951
  },
952
952
  "showStatus": {
953
953
  "deprecated": true,
954
- "description": "Show status",
954
+ "description": "Show status.",
955
955
  "type": "boolean"
956
956
  },
957
957
  "spellCheckDelayMs": {
@@ -992,7 +992,7 @@
992
992
  "description": "Configuration format version of the settings file."
993
993
  },
994
994
  "words": {
995
- "description": "list of words to be always considered correct",
995
+ "description": "List of words to be always considered correct.",
996
996
  "items": {
997
997
  "type": "string"
998
998
  },
@@ -26,10 +26,10 @@ export interface FileSettings extends ExtendableSettings {
26
26
  version?: Version;
27
27
  /** Words to add to global dictionary -- should only be in the user config file. */
28
28
  userWords?: string[];
29
- /** Other settings files to be included */
29
+ /** Other settings files to be included. */
30
30
  import?: FsPath | FsPath[];
31
31
  /**
32
- * The root to use for glop patterns found in this configuration.
32
+ * The root to use for glob patterns found in this configuration.
33
33
  * Default: location of the configuration file.
34
34
  * For compatibility reasons, config files with version 0.1, the glob root will
35
35
  * default to be `${cwd}`.
@@ -57,7 +57,7 @@ export interface FileSettings extends ExtendableSettings {
57
57
  */
58
58
  enableGlobDot?: boolean;
59
59
  /**
60
- * Glob patterns of files to be ignored
60
+ * Glob patterns of files to be ignored.
61
61
  * Glob patterns are relative to the `globRoot` of the configuration file that defines them.
62
62
  */
63
63
  ignorePaths?: Glob[];
@@ -74,7 +74,7 @@ export interface FileSettings extends ExtendableSettings {
74
74
  */
75
75
  readonly?: boolean;
76
76
  /**
77
- * Custom reporters configuration
77
+ * Custom reporters configuration.
78
78
  */
79
79
  reporters?: ReporterSettings[];
80
80
  /**
@@ -95,9 +95,9 @@ export interface Settings extends ReportingConfiguration, BaseSetting, PnPSettin
95
95
  /**
96
96
  * Current active spelling language.
97
97
  *
98
- * Example: "en-GB" for British English
98
+ * Example: "en-GB" for British English.
99
99
  *
100
- * Example: "en,nl" to enable both English and Dutch
100
+ * Example: "en,nl" to enable both English and Dutch.
101
101
  * @default "en"
102
102
  */
103
103
  language?: LocaleId;
@@ -144,7 +144,7 @@ export interface ReportingConfiguration extends SuggestionsConfiguration {
144
144
  }
145
145
  export interface SuggestionsConfiguration {
146
146
  /**
147
- * Number of suggestions to make
147
+ * Number of suggestions to make.
148
148
  * @default 10
149
149
  */
150
150
  numSuggestions?: number;
@@ -195,27 +195,27 @@ export interface PnPSettings {
195
195
  */
196
196
  export interface WorkspaceTrustSettings {
197
197
  /**
198
- * Glob patterns of locations that contain ALWAYS trusted files
198
+ * Glob patterns of locations that contain ALWAYS trusted files.
199
199
  */
200
200
  trustedFiles?: Glob[];
201
201
  /**
202
- * Glob patterns of locations that contain NEVER trusted files
202
+ * Glob patterns of locations that contain NEVER trusted files.
203
203
  */
204
204
  untrustedFiles?: Glob[];
205
205
  /**
206
- * Sets the default trust level
206
+ * Sets the default trust level.
207
207
  * @default "trusted"
208
208
  */
209
209
  trustLevel?: TrustLevel;
210
210
  }
211
211
  /**
212
- * VS Code Spell Checker Settings
213
- * To be Removed
212
+ * VS Code Spell Checker Settings.
213
+ * To be Removed.
214
214
  * @deprecated true
215
215
  */
216
216
  export interface LegacySettings {
217
217
  /**
218
- * Show status
218
+ * Show status.
219
219
  * @deprecated true
220
220
  */
221
221
  showStatus?: boolean;
@@ -226,30 +226,30 @@ export interface LegacySettings {
226
226
  spellCheckDelayMs?: number;
227
227
  }
228
228
  export interface OverrideSettings extends Settings, OverrideFilterFields {
229
- /** Sets the programming language id */
229
+ /** Sets the programming language id. */
230
230
  languageId?: LanguageId;
231
- /** Sets the locale */
231
+ /** Sets the locale. */
232
232
  language?: LocaleId;
233
233
  }
234
234
  export interface OverrideFilterFields {
235
- /** Glob pattern or patterns to match against */
235
+ /** Glob pattern or patterns to match against. */
236
236
  filename: Glob | Glob[];
237
237
  }
238
238
  export interface BaseSetting {
239
- /** Optional identifier */
239
+ /** Optional identifier. */
240
240
  id?: string;
241
- /** Optional name of configuration */
241
+ /** Optional name of configuration. */
242
242
  name?: string;
243
- /** Optional description of configuration */
243
+ /** Optional description of configuration. */
244
244
  description?: string;
245
245
  /**
246
- * Is the spell checker enabled
246
+ * Is the spell checker enabled.
247
247
  * @default true
248
248
  */
249
249
  enabled?: boolean;
250
- /** list of words to be always considered correct */
250
+ /** List of words to be always considered correct. */
251
251
  words?: string[];
252
- /** list of words to always be considered incorrect. */
252
+ /** List of words to always be considered incorrect. */
253
253
  flagWords?: string[];
254
254
  /** List of words to be ignored. An Ignored word will not show up as an error even if it is also in the `flagWords`. */
255
255
  ignoreWords?: string[];
@@ -268,7 +268,7 @@ export interface BaseSetting {
268
268
  * @default false
269
269
  */
270
270
  caseSensitive?: boolean;
271
- /** Define additional available dictionaries */
271
+ /** Define additional available dictionaries. */
272
272
  dictionaryDefinitions?: DictionaryDefinition[];
273
273
  /**
274
274
  * Optional list of dictionaries to use.
@@ -290,7 +290,7 @@ export interface BaseSetting {
290
290
  /**
291
291
  * List of RegExp patterns or Pattern names to exclude from spell checking.
292
292
  *
293
- * Example: ["href"] - to exclude html href
293
+ * Example: ["href"] - to exclude html href.
294
294
  */
295
295
  ignoreRegExpList?: RegExpPatternList;
296
296
  /**
@@ -298,7 +298,7 @@ export interface BaseSetting {
298
298
  * If includeRegExpList is defined, ONLY, text matching the included patterns will be checked.
299
299
  */
300
300
  includeRegExpList?: RegExpPatternList;
301
- /** Defines a list of patterns that can be used in ignoreRegExpList and includeRegExpList */
301
+ /** Defines a list of patterns that can be used in ignoreRegExpList and includeRegExpList. */
302
302
  patterns?: RegExpPatternDefinition[];
303
303
  }
304
304
  export declare type DictionaryFileTypes = 'S' | 'W' | 'C' | 'T';
@@ -309,17 +309,17 @@ export interface DictionaryDefinitionBase {
309
309
  *
310
310
  * Name Format:
311
311
  * - Must contain at least 1 number or letter.
312
- * - spaces are allowed.
312
+ * - Spaces are allowed.
313
313
  * - Leading and trailing space will be removed.
314
- * - Names ARE case-sensitive
315
- * - Must not contain `*`, `!`, `;`, `,`, `{`, `}`, `[`, `]`, `~`
314
+ * - Names ARE case-sensitive.
315
+ * - Must not contain `*`, `!`, `;`, `,`, `{`, `}`, `[`, `]`, `~`.
316
316
  */
317
317
  name: DictionaryId;
318
- /** Optional description */
318
+ /** Optional description. */
319
319
  description?: string;
320
- /** Replacement pairs */
320
+ /** Replacement pairs. */
321
321
  repMap?: ReplaceMap;
322
- /** Use Compounds */
322
+ /** Use Compounds. */
323
323
  useCompounds?: boolean;
324
324
  /**
325
325
  * Indicate that suggestions should not come from this dictionary.
@@ -335,18 +335,18 @@ export interface DictionaryDefinitionBase {
335
335
  * Type of file:
336
336
  * S - single word per line,
337
337
  * W - each line can contain one or more words separated by space,
338
- * C - each line is treated like code (Camel Case is allowed)
339
- * Default is S
338
+ * C - each line is treated like code (Camel Case is allowed).
339
+ * Default is S.
340
340
  * C is the slowest to load due to the need to split each line based upon code splitting rules.
341
341
  * @default "S"
342
342
  */
343
343
  type?: DictionaryFileTypes;
344
344
  }
345
345
  export interface DictionaryDefinitionPreferred extends DictionaryDefinitionBase {
346
- /** Path to the file */
346
+ /** Path to the file. */
347
347
  path: DictionaryPath;
348
348
  /**
349
- * Only for legacy dictionary definitions
349
+ * Only for legacy dictionary definitions.
350
350
  * @deprecated true
351
351
  * @deprecationMessage Use `path` instead.
352
352
  * @hidden
@@ -354,15 +354,15 @@ export interface DictionaryDefinitionPreferred extends DictionaryDefinitionBase
354
354
  file?: undefined;
355
355
  }
356
356
  /**
357
- * Only for legacy dictionary definitions
357
+ * Only for legacy dictionary definitions.
358
358
  * @deprecated true
359
- * @deprecationMessage Use `DictionaryDefinitionPreferred`
359
+ * @deprecationMessage Use `DictionaryDefinitionPreferred` instead.
360
360
  */
361
361
  export interface DictionaryDefinitionAlternate extends DictionaryDefinitionBase {
362
362
  /** @hidden */
363
363
  path?: undefined;
364
364
  /**
365
- * Path to the file, only for legacy dictionary definitions
365
+ * Path to the file, only for legacy dictionary definitions.
366
366
  * @deprecated true
367
367
  * @deprecationMessage Use `path` instead.
368
368
  */
@@ -373,20 +373,20 @@ export interface DictionaryDefinitionAlternate extends DictionaryDefinitionBase
373
373
  * @hidden
374
374
  */
375
375
  export interface DictionaryDefinitionLegacy extends DictionaryDefinitionBase {
376
- /** Path to the file, if undefined the path to the extension dictionaries is assumed */
376
+ /** Path to the file, if undefined the path to the extension dictionaries is assumed. */
377
377
  path?: FsPath;
378
378
  /**
379
- * File name
379
+ * File name.
380
380
  * @deprecated true
381
- * @deprecationMessage Use path instead.
381
+ * @deprecationMessage Use `path` instead.
382
382
  */
383
383
  file: FsPath;
384
384
  /**
385
385
  * Type of file:
386
386
  * S - single word per line,
387
387
  * W - each line can contain one or more words separated by space,
388
- * C - each line is treated like code (Camel Case is allowed)
389
- * Default is S
388
+ * C - each line is treated like code (Camel Case is allowed).
389
+ * Default is S.
390
390
  * C is the slowest to load due to the need to split each line based upon code splitting rules.
391
391
  * @default "S"
392
392
  */
@@ -408,7 +408,7 @@ export interface DictionaryDefinitionCustom extends DictionaryDefinitionPreferre
408
408
  path: CustomDictionaryPath;
409
409
  /**
410
410
  * Defines the scope for when words will be added to the dictionary.
411
- * Scope values: `user`, `workspace`, `folder`
411
+ * Scope values: `user`, `workspace`, `folder`.
412
412
  */
413
413
  scope?: CustomDictionaryScope | CustomDictionaryScope[];
414
414
  /**
@@ -421,18 +421,18 @@ export interface LanguageSetting extends LanguageSettingFilterFields, BaseSettin
421
421
  export interface LanguageSettingFilterFields extends LanguageSettingFilterFieldsPreferred, LanguageSettingFilterFieldsDeprecated {
422
422
  }
423
423
  export interface LanguageSettingFilterFieldsPreferred {
424
- /** The language id. Ex: "typescript", "html", or "php". "*" -- will match all languages */
424
+ /** The language id. Ex: "typescript", "html", or "php". "*" -- will match all languages. */
425
425
  languageId: LanguageId | LanguageIdSingle[];
426
426
  /** The locale filter, matches against the language. This can be a comma separated list. "*" will match all locales. */
427
427
  locale?: LocaleId | LocaleId[];
428
428
  }
429
429
  export interface LanguageSettingFilterFieldsDeprecated {
430
- /** The language id. Ex: "typescript", "html", or "php". "*" -- will match all languages */
430
+ /** The language id. Ex: "typescript", "html", or "php". "*" -- will match all languages. */
431
431
  languageId: LanguageId | LanguageIdSingle[];
432
432
  /**
433
433
  * Deprecated - The locale filter, matches against the language. This can be a comma separated list. "*" will match all locales.
434
434
  * @deprecated true
435
- * @deprecationMessage Use `locale` instead
435
+ * @deprecationMessage Use `locale` instead.
436
436
  */
437
437
  local?: LocaleId | LocaleId[];
438
438
  }
@@ -440,21 +440,21 @@ export interface LanguageSettingFilterFieldsDeprecated {
440
440
  declare type InternalRegExp = RegExp;
441
441
  export declare type Pattern = string | InternalRegExp;
442
442
  export declare type PredefinedPatterns = 'Base64' | 'CStyleComment' | 'CStyleHexValue' | 'CSSHexValue' | 'CommitHash' | 'CommitHashLink' | 'Email' | 'EscapeCharacters' | 'HexValues' | 'href' | 'PhpHereDoc' | 'PublicKey' | 'RsaCert' | 'SHA' | 'SpellCheckerDisable' | 'SpellCheckerDisableBlock' | 'SpellCheckerDisableLine' | 'SpellCheckerDisableNext' | 'SpellCheckerIgnoreInDocSetting' | 'string' | 'UnicodeRef' | 'Urls' | 'UUID' | 'Everything';
443
- /** This matches the name in a pattern definition */
443
+ /** This matches the name in a pattern definition. */
444
444
  export declare type PatternId = string;
445
445
  /** A PatternRef is a Pattern or PatternId. */
446
446
  export declare type PatternRef = Pattern | PatternId | PredefinedPatterns;
447
- /** A list of pattern names or regular expressions */
447
+ /** A list of pattern names or regular expressions. */
448
448
  export declare type RegExpPatternList = PatternRef[];
449
449
  /**
450
450
  * This is the name of a dictionary.
451
451
  *
452
452
  * Name Format:
453
453
  * - Must contain at least 1 number or letter.
454
- * - spaces are allowed.
454
+ * - Spaces are allowed.
455
455
  * - Leading and trailing space will be removed.
456
- * - Names ARE case-sensitive
457
- * - Must not contain `*`, `!`, `;`, `,`, `{`, `}`, `[`, `]`, `~`
456
+ * - Names ARE case-sensitive.
457
+ * - Must not contain `*`, `!`, `;`, `,`, `{`, `}`, `[`, `]`, `~`.
458
458
  *
459
459
  * @pattern ^(?=[^!*,;{}[\]~\n]+$)(?=(.*\w)).+$
460
460
  */
@@ -470,10 +470,10 @@ export declare type DictionaryRef = DictionaryId;
470
470
  * It is used to exclude or include a dictionary by name.
471
471
  *
472
472
  * The reference starts with 1 or more `!`.
473
- * - `!<dictionary_name>` - Used to exclude the dictionary matching `<dictionary_name>`
474
- * - `!!<dictionary_name>` - Used to re-include a dictionary matching `<dictionary_name>`
473
+ * - `!<dictionary_name>` - Used to exclude the dictionary matching `<dictionary_name>`.
474
+ * - `!!<dictionary_name>` - Used to re-include a dictionary matching `<dictionary_name>`.
475
475
  * Overrides `!<dictionary_name>`.
476
- * - `!!!<dictionary_name>` - Used to exclude a dictionary matching `<dictionary_name>`
476
+ * - `!!!<dictionary_name>` - Used to exclude a dictionary matching `<dictionary_name>`.
477
477
  * Overrides `!!<dictionary_name>`.
478
478
  *
479
479
  * @pattern ^(?=!+[^!*,;{}[\]~\n]+$)(?=(.*\w)).+$
@@ -489,24 +489,24 @@ export declare type DictionaryReference = DictionaryRef | DictionaryNegRef;
489
489
  /** This is a written language locale like: 'en', 'en-GB', 'fr', 'es', 'de', etc. */
490
490
  export declare type LocaleId = string;
491
491
  /**
492
- * Configuration File Version
492
+ * Configuration File Version.
493
493
  */
494
494
  export declare type VersionLatest = '0.2';
495
495
  /**
496
- * Legacy Configuration File Versions
496
+ * Legacy Configuration File Versions.
497
497
  * @deprecated true
498
- * @deprecationMessage Use `0.2`
498
+ * @deprecationMessage Use `0.2` instead.
499
499
  */
500
500
  export declare type VersionLegacy = '0.1';
501
501
  export declare type Version = VersionLatest | VersionLegacy;
502
502
  /**
503
503
  * @deprecated true
504
- * @deprecationMessage Use LocaleId instead
504
+ * @deprecationMessage Use `LocaleId` instead.
505
505
  */
506
506
  export declare type LocalId = LocaleId;
507
- /** These are glob expressions */
507
+ /** These are glob expressions. */
508
508
  export declare type Glob = SimpleGlob | GlobDef;
509
- /** Simple Glob string, the root will be globRoot */
509
+ /** Simple Glob string, the root will be globRoot. */
510
510
  export declare type SimpleGlob = string;
511
511
  /**
512
512
  * Used to define fully qualified glob patterns.
@@ -515,7 +515,7 @@ export declare type SimpleGlob = string;
515
515
  * @hidden
516
516
  */
517
517
  export interface GlobDef {
518
- /** Glob pattern to match */
518
+ /** Glob pattern to match. */
519
519
  glob: string;
520
520
  /** Optional root to use when matching the glob. Defaults to current working dir. */
521
521
  root?: string;
@@ -541,9 +541,9 @@ export declare type LanguageIdMultiple = string;
541
541
  */
542
542
  export declare type LanguageIdMultipleNeg = string;
543
543
  export declare type LanguageId = LanguageIdSingle | LanguageIdMultiple | LanguageIdMultipleNeg;
544
- /** A File System Path */
544
+ /** A File System Path. */
545
545
  export declare type FsPath = string;
546
- /** Trust Security Level */
546
+ /** Trust Security Level. */
547
547
  export declare type TrustLevel = 'trusted' | 'untrusted';
548
548
  /**
549
549
  * A File System Path to a dictionary file.
@@ -562,7 +562,7 @@ export interface RegExpPatternDefinition {
562
562
  */
563
563
  name: PatternId;
564
564
  /**
565
- * RegExp pattern or array of RegExp patterns
565
+ * RegExp pattern or array of RegExp patterns.
566
566
  */
567
567
  pattern: Pattern | Pattern[];
568
568
  /**
@@ -573,47 +573,47 @@ export interface RegExpPatternDefinition {
573
573
  export declare type CSpellUserSettingsWithComments = CSpellUserSettings;
574
574
  export declare type Source = FileSource | MergeSource | InMemorySource | BaseSource;
575
575
  export interface FileSource extends BaseSource {
576
- /** name of source */
576
+ /** Name of source. */
577
577
  name: string;
578
- /** filename if this came from a file. */
578
+ /** Filename if this came from a file. */
579
579
  filename: string;
580
- /** The two settings that were merged to */
580
+ /** The two settings that were merged to. */
581
581
  sources?: undefined;
582
582
  /** The configuration read. */
583
583
  fileSource: CSpellSettings;
584
584
  }
585
585
  export interface MergeSource extends BaseSource {
586
- /** name of source */
586
+ /** Name of source. */
587
587
  name: string;
588
- /** filename if this came from a file. */
588
+ /** Filename if this came from a file. */
589
589
  filename?: undefined;
590
- /** The two settings that were merged to */
590
+ /** The two settings that were merged to. */
591
591
  sources: [CSpellSettings] | [CSpellSettings, CSpellSettings];
592
592
  /** The configuration read. */
593
593
  fileSource?: undefined;
594
594
  }
595
595
  export interface InMemorySource extends BaseSource {
596
- /** name of source */
596
+ /** Name of source. */
597
597
  name: string;
598
- /** filename if this came from a file. */
598
+ /** Filename if this came from a file. */
599
599
  filename?: undefined;
600
- /** The two settings that were merged to */
600
+ /** The two settings that were merged to. */
601
601
  sources?: undefined;
602
602
  /** The configuration read. */
603
603
  fileSource?: undefined;
604
604
  }
605
605
  interface BaseSource {
606
- /** name of source */
606
+ /** Name of source. */
607
607
  name: string;
608
- /** filename if this came from a file. */
608
+ /** Filename if this came from a file. */
609
609
  filename?: string | undefined;
610
- /** The two settings that were merged to */
610
+ /** The two settings that were merged to. */
611
611
  sources?: [CSpellSettings] | [CSpellSettings, CSpellSettings] | undefined;
612
612
  /** The configuration read. */
613
613
  fileSource?: CSpellSettings | undefined;
614
614
  }
615
615
  /**
616
- * reporter name or reporter name + reporter config
616
+ * Reporter name or reporter name + reporter config.
617
617
  */
618
618
  export declare type ReporterSettings = string | [string] | [string, unknown];
619
619
  export {};
package/package.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "publishConfig": {
4
4
  "access": "public"
5
5
  },
6
- "version": "5.13.4",
6
+ "version": "5.14.0-alpha.0",
7
7
  "description": "Types for cspell and cspell-lib",
8
8
  "main": "dist/index.js",
9
9
  "typings": "dist/index.d.ts",
@@ -56,5 +56,5 @@
56
56
  "typedoc-plugin-markdown": "^3.11.8",
57
57
  "typescript": "^4.5.4"
58
58
  },
59
- "gitHead": "cf6ef9e6137af46d1a7ebd83600c05a4892c4814"
59
+ "gitHead": "bb136daa99b18e826a5e720ad1dfba94caa1e16e"
60
60
  }