@descent-vtt/spec-guard 0.25.0 → 0.27.0

package/dist/polyglot.d.ts

@@ -61,11 +61,12 @@ export declare const SYNTAX_NAMES: Record<ModuleLanguage, string>;
 /** Strips the delimiters off a literal as the lexer captured it. */
 export declare function literalValue(raw: string): string;
 /**
- * Whitespace-skipping cursor over masked code.
+ * Whitespace-skipping cursor over masked code, which a Go import and a Python
+ * dynamic import are read with.
  *
  * Exported so its edges can be pinned directly. Reaching "what does peek() do
- * at the end of the file" through a C# source string is possible but says
- * nothing about C#.
+ * at the end of the file" through a Go source string is possible but says
+ * nothing about Go.
  */
 export declare class Reader {
     readonly text: string;
@@ -73,36 +74,7 @@ export declare class Reader {
     constructor(text: string);
     skipSpace(): void;
     peek(): string;
-    eat(token: string): boolean;
-    /**
-     * Eats a word only when it really is the whole word.
-     *
-     * `eat('static')` also matches the first six characters of a namespace called
-     * `staticfiles`, and would then read the dependency as `files`.
-     */
-    keyword(word: string): boolean;
     identifier(): string;
-    /**
-     * Reads `a.b.c`, leaving out a C# alias qualifier.
-     *
-     * `global::A.B` and `Legacy::A.B` both name the namespace `A.B`: what comes
-     * before `::` says where to look it up - the global namespace, or the
-     * assembly an extern alias names - and is not part of the name. Until 0.10.2
-     * this read `global.A.B`, and no pattern written for `A.B` matched it.
-     */
-    dotted(): string;
-    /**
-     * Skips a generic argument list, so an alias target's `<...>` does not end
-     * the read.
-     *
-     * No bracket counting. A `using` directive ends at the first `;` or newline
-     * whatever is nested inside its angle brackets, and the caller's only
-     * question is whether the next non-space character is that `;` - so `A<B>`
-     * and `A<B<C>>` are both passed over by the same rule. The depth counter
-     * that used to be here could not change an answer for any input C# accepts,
-     * which is another way of saying no test could hold it in place.
-     */
-    skipGenerics(): void;
 }
 /** Offset of the matching close, given the depth-tracking characters. */
 export declare function matchingClose(text: string, open: number, opener: string, closer: string): number;
@@ -115,20 +87,32 @@ export declare function matchingClose(text: string, open: number, opener: string
  *
  * A line ends where Python ends one: at LF, at CRLF and at a lone CR. Only
  * LF ended one here, so every line of a file with CRLF endings kept its
- * carriage return. The pattern that reads a `from` statement cannot reach
+ * carriage return. The pattern that read a `from` statement could not reach
  * the end of such a line, and read none in the file, and a backslash before
  * the carriage return continued nothing (ADR-0008, amended 2026-10-12).
+ *
+ * `starts` is where each physical line begins, in the text and in the
+ * source. A statement after a `;` stands on a line of its own where the
+ * statement before it ran over several, and is reported there (ADR-0008,
+ * amended 2026-10-14).
  */
 export declare function logicalLines(code: string): Array<{
     text: string;
     offset: number;
+    starts: Array<[at: number, offset: number]>;
 }>;
 /**
- * Expands one `use` path into the module paths it actually names.
+ * Expands one use tree, with its `;` or without, into the module paths it
+ * names.
  *
- * `a::{b, c::{d, e}}` is three dependencies written as one statement, and a
- * rule about `a::c` has to see them. Returns null when the expansion would
- * exceed MAX_EXPANSION, which the caller reports rather than truncating.
+ * `a::{b, c::{d, e}}` is three dependencies written as one declaration, and a
+ * rule about `a::c` has to see them. A tree is read as rustc reads it: white
+ * space and comments between its tokens, a raw identifier without its `r#`, a
+ * name in its NFC form, and `self` at the end of a path naming what is before
+ * it. Text that is no use tree, which rustc refuses, names nothing (ADR-0008,
+ * amended 2026-10-18). Returns null when the tree would name more than
+ * MAX_EXPANSION paths, or nest its groups deeper than that, which the caller
+ * reports rather than truncating.
  */
 export declare function expandUsePath(input: string): string[] | null;
 /**

package/dist/polyglot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"polyglot.d.ts","sourceRoot":"","sources":["../src/polyglot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAMH,OAAO,KAAK,EAAgB,WAAW,EAAkC,MAAM,cAAc,CAAC;AAE9F,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjE,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAOlE,CAAC;AAEH,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAEnE;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,KAAK,CAAC;AAehC;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAKvD,CAAC;AAyCF,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWhD;AAMD;;;;;;GAMG;AACH,qBAAa,MAAM;IAGL,QAAQ,CAAC,IAAI,EAAE,MAAM;IAFjC,KAAK,SAAK;IAEV,YAAqB,IAAI,EAAE,MAAM,EAAI;IAErC,SAAS,IAAI,IAAI,CAShB;IAED,IAAI,IAAI,MAAM,CAEb;IAED,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAI1B;IAED;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK7B;IAED,UAAU,IAAI,MAAM,CAMnB;IAED;;;;;;;OAOG;IACH,MAAM,IAAI,MAAM,CAUf;IAED;;;;;;;;;;OAUG;IACH,YAAY,IAAI,IAAI,CAOnB;CACF;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAWhG;AA2BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BlF;AAiGD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CA2C5D;AAsID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAc1G;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,EAAE,CAOtF;AAWD,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,WAAW,CAenG"}
+{"version":3,"file":"polyglot.d.ts","sourceRoot":"","sources":["../src/polyglot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAMH,OAAO,KAAK,EAAgB,WAAW,EAAkC,MAAM,cAAc,CAAC;AAE9F,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjE,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAOlE,CAAC;AAEH,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAEnE;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,KAAK,CAAC;AAehC;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAKvD,CAAC;AAyCF,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWhD;AAMD;;;;;;;GAOG;AACH,qBAAa,MAAM;IAGL,QAAQ,CAAC,IAAI,EAAE,MAAM;IAFjC,KAAK,SAAK;IAEV,YAAqB,IAAI,EAAE,MAAM,EAAI;IAErC,SAAS,IAAI,IAAI,CAShB;IAED,IAAI,IAAI,MAAM,CAEb;IAED,UAAU,IAAI,MAAM,CAMnB;CACF;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAWhG;AA2BD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC,CAkC/H;AA4SD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAM5D;AA4SD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAc1G;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,EAAE,CAOtF;AAWD,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,WAAW,CAenG"}