@cspell/cspell-types 6.1.2 → 6.1.3

package/dist/CSpellSettingsDef.d.ts

@@ -1,5 +1,6 @@
 import type { DictionaryInformation } from './DictionaryInformation';
 import type { Features } from './features';
+import { Parser, ParserName } from './Parser';
 export declare type ReplaceEntry = [string, string];
 export declare type ReplaceMap = ReplaceEntry[];
 /**
@@ -24,7 +25,7 @@ export interface CSpellSettingsWithSourceTrace extends CSpellSettings {
     __importRef?: ImportFileRef;
     __imports?: Map<string, ImportFileRef>;
 }
-export interface FileSettings extends ExtendableSettings, CommandLineSettings {
+export interface FileSettings extends ExtendableSettings, CommandLineSettings, ExperimentalFileSettings {
     /**
      * Configuration format version of the settings file.
      *
@@ -347,7 +348,7 @@ export interface OverrideFilterFields {
     /** Glob pattern or patterns to match against. */
     filename: Glob | Glob[];
 }
-export interface BaseSetting {
+export interface BaseSetting extends ExperimentalBaseSettings {
     /** Optional identifier. */
     id?: string;
     /** Optional name of configuration. */
@@ -802,5 +803,43 @@ interface BaseSource {
  * Reporter name or reporter name + reporter config.
  */
 export declare type ReporterSettings = string | [string] | [string, unknown];
+/**
+ * Experimental Configuration / Options
+ *
+ * This Configuration is subject to change without warning.
+ * @experimental
+ * @hidden
+ */
+export interface ExperimentalFileSettings {
+    /**
+     * Future Plugin support
+     * @experimental
+     * @version 6.2.0
+     */
+    plugins?: Plugin[] | undefined;
+}
+/**
+ * Experimental Configuration / Options
+ *
+ * This Configuration is subject to change without warning.
+ * @experimental
+ * @hidden
+ */
+export interface ExperimentalBaseSettings {
+    /**
+     * Parser to use for the file content
+     * @experimental
+     * @version 6.2.0
+     */
+    parser?: ParserName | Parser | undefined;
+}
+/**
+ * Plugin API
+ * @experimental
+ * @version 6.2.0
+ */
+export interface Plugin {
+    parsers?: Parser[] | undefined;
+}
 export {};
 //# sourceMappingURL=CSpellSettingsDef.d.ts.map

package/dist/Parser.d.ts

@@ -0,0 +1,126 @@
+export declare type ParserOptions = Record<string, unknown>;
+export declare type ParserName = string;
+export interface Parser {
+    /** Name of parser */
+    readonly name: ParserName;
+    /**
+     * Parse Method
+     * @param content - full content of the file
+     * @param filename - filename
+     */
+    parse(content: string, filename: string): ParseResult;
+}
+export interface ParseResult {
+    readonly content: string;
+    readonly filename: string;
+    readonly parsedTexts: Iterable<ParsedText>;
+}
+export interface ParsedText {
+    /**
+     * The text extracted and possibly transformed
+     */
+    readonly text: string;
+    /**
+     * The raw text before it has been transformed
+     */
+    readonly rawText?: string | undefined;
+    /**
+     * start and end offsets of the text
+     */
+    readonly range: Range;
+    /**
+     * The Scope annotation for a segment of text.
+     * Used by the spell checker to apply spell checking options
+     * based upon the value of the scope.
+     */
+    readonly scope?: Scope | undefined;
+    /**
+     * The source map is used to support text transformations.
+     *
+     * See: {@link SourceMap}
+     */
+    readonly map?: SourceMap | undefined;
+    /**
+     * Used to delegate parsing the contents of `text` to another parser.
+     *
+     */
+    readonly delegate?: DelegateInfo | undefined;
+}
+/**
+ * A SourceMap is used to map transform a piece of text back to its original text.
+ * This is necessary in order to report the correct location of a spelling issue.
+ * An empty source map indicates that it was a 1:1 transformation.
+ *
+ * The values in a source map are number pairs (even, odd) relative to the beginning of each
+ * string segment.
+ * - even - offset in the source text
+ * - odd - offset in the transformed text
+ *
+ * Offsets start a 0
+ *
+ * Example:
+ *
+ * - Original text: `Grand Caf\u00e9 Bj\u00f8rvika`
+ * - Transformed text: `Grand Café Bjørvika`
+ * - Map: [9, 9, 15, 10, 18, 13, 24, 14]
+ *
+ * | offset | original    | offset | transformed |
+ * | ------ | ----------- | ------ | ----------- |
+ * | 0-9    | `Grand Caf` | 0-9    | `Grand Caf` |
+ * | 9-15   | `\u00e9`    | 9-10   | `é`         |
+ * | 15-18  | ` Bj`       | 10-13  | ` Bj`       |
+ * | 18-24  | `\u00f8`    | 13-14  | `ø`         |
+ * | 24-29  | `rvika`     | 14-19  | `rvika`     |
+ *
+ * <!--- cspell:ignore Bjørvika rvika --->
+ */
+export declare type SourceMap = number[];
+export declare type Range = readonly [start: number, end: number];
+/**
+ * DelegateInfo is used by a parser to delegate parsing a subsection of a document to
+ * another parser. The following information is used by the spell checker to match
+ * the parser.
+ */
+export interface DelegateInfo {
+    /**
+     * Proposed virtual file name including the extension.
+     * Format: `./${source_filename}/${block_number}.${ext}
+     * Example: `./README.md/1.js`
+     */
+    readonly filename: string;
+    /**
+     * The filename of the origin of the virtual file block.
+     * Example: `./README.md`
+     */
+    readonly originFilename: string;
+    /**
+     * Proposed file extension
+     * Example: `.js`
+     */
+    readonly extension: string;
+    /**
+     * Filetype to use
+     * Example: `javascript`
+     */
+    readonly fileType?: string;
+}
+/**
+ * Scope - chain of scope going from local to global
+ *
+ * Example:
+ * ```
+ * `comment.block.documentation.ts` -> `meta.interface.ts` -> `source.ts`
+ * ```
+ */
+export interface ScopeChain {
+    readonly value: string;
+    readonly parent?: ScopeChain | undefined;
+}
+/**
+ * A string representing a scope chain separated by spaces
+ *
+ * Example: `comment.block.documentation.ts meta.interface.ts source.ts`
+ */
+export declare type ScopeString = string;
+export declare type Scope = ScopeChain | ScopeString;
+//# sourceMappingURL=Parser.d.ts.map

package/dist/Parser.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Parser.js.map

package/dist/TextMap.d.ts

@@ -0,0 +1,36 @@
+export declare type MappedText = Readonly<TransformedText>;
+export declare type Range = readonly [start: number, end: number];
+export interface Mapped {
+    /**
+     * `(i, j)` number pairs where
+     * - `i` is the offset in the source
+     * - `j` is the offset in the destination
+     *
+     * Example:
+     * - source text = `"caf\xe9"`
+     * - mapped text = `"café"`
+     * - map = `[3, 3, 7, 4]`, which is equivalent to `[0, 0, 3, 3, 7, 4]`
+     *   where the `[0, 0]` is unnecessary.
+     *
+     */
+    map: number[];
+}
+interface TransformedText extends PartialOrUndefined<Mapped> {
+    /**
+     * Transformed text with an optional map.
+     */
+    text: string;
+    /**
+     * The original text
+     */
+    rawText?: string | undefined;
+    /**
+     * The start and end offset of the text in the document.
+     */
+    range: Range;
+}
+declare type PartialOrUndefined<T> = {
+    [P in keyof T]?: T[P] | undefined;
+};
+export {};
+//# sourceMappingURL=TextMap.d.ts.map

package/dist/TextMap.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=TextMap.js.map

package/dist/TextOffset.d.ts

@@ -20,25 +20,4 @@ export interface TextDocumentOffset extends TextOffset {
     col: number;
     line: TextOffset;
 }
-export interface Mapped {
-    /**
-     * `(i, j)` number pairs where
-     * - `i` is the offset in the source
-     * - `j` is the offset in the destination
-     *
-     * Example:
-     * - source text = `"caf\xe9"`
-     * - mapped text = `"café"`
-     * - map = `[3, 3, 7, 4]`, which is equivalent to `[0, 0, 3, 3, 7, 4]`
-     *   where the `[0, 0]` is unnecessary.
-     *
-     */
-    map: number[];
-}
-export interface TransformedText extends Partial<Mapped> {
-    /**
-     * Transformed text with an optional map.
-     */
-    text: string;
-}
 //# sourceMappingURL=TextOffset.d.ts.map

package/dist/configFields.js

@@ -47,6 +47,9 @@ exports.ConfigFields = {
     usePnP: 'usePnP',
     userWords: 'userWords',
     words: 'words',
+    // Experimental
+    parser: 'parser',
+    plugins: 'plugins',
 };
 // export const ConfigKeysNames = Object.values(ConfigKeysByField);
 //# sourceMappingURL=configFields.js.map

package/dist/index.d.ts

@@ -4,6 +4,8 @@ export * from './CSpellReporter';
 export * from './CSpellSettingsDef';
 export type { CharacterSet, CharacterSetCosts, DictionaryInformation, EditCosts } from './DictionaryInformation';
 export type { Feature, Features } from './features';
+export type { ParsedText, Parser, ParseResult, ParserName, ParserOptions } from './Parser';
 export type { SuggestionCostMapDef, SuggestionCostsDefs } from './suggestionCostsDef';
+export type { MappedText } from './TextMap';
 export type { TextDocumentOffset, TextOffset } from './TextOffset';
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -3,12 +3,28 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "6.1.2",
+  "version": "6.1.3",
   "description": "Types for cspell and cspell-lib",
+  "type": "commonjs",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "*": [
+        "dist/*"
+      ],
+      "dist/index.d.ts": [
+        "dist/index.d.ts"
+      ],
+      "index.d.ts": [
+        "dist/index.d.ts"
+      ]
+    }
+  },
   "exports": {
     ".": "./dist/index.js",
+    "./Parser": "./dist/Parser.js",
+    "./Parser.js": "./dist/Parser.js",
     "./cspell.schema.json": "./cspell.schema.json",
     "./ajv.config": "./ajv.config.js",
     "./ajv.config.js": "./ajv.config.js"
@@ -51,7 +67,7 @@
     "jest": "^28.1.1",
     "rimraf": "^3.0.2",
     "ts-json-schema-generator": "^1.0.0",
-    "typescript": "^4.7.3"
+    "typescript": "^4.7.4"
   },
-  "gitHead": "5ef579108a81bf7206cf53e301374467a3bbde06"
+  "gitHead": "e96b313542f2ec0a38ac04d1422d97e724ded3a6"
 }