@untangle-code/parser-registry 0.0.0-stage → 0.1.0

package/dist/languages/shared/chunks.js

@@ -0,0 +1,181 @@
+import { UntangleError } from "@untangle-code/domain";
+import { rangeOf, unionRange } from "./node-utils.js";
+function chunkKindOf(kind) {
+    switch (kind) {
+        case "function":
+            return "function";
+        case "method":
+            return "method";
+        case "constructor":
+            return "constructor";
+        case "class":
+            return "class_overview";
+        case "interface":
+            return "interface";
+        case "type":
+            return "type";
+        case "enum":
+            return "enum";
+        case "namespace":
+        case "file":
+            return "module";
+        case "property":
+            // Individual properties never reach here directly — see groupProperties.
+            return "property_group";
+    }
+}
+/**
+ * The full source span a symbol's chunk should carry: the scope node itself,
+ * widened to the wrapping `export` statement (`export function f ...` —
+ * the scope node is only the declaration, but the `export` keyword bytes
+ * belong to the symbol's chunk, not to an interstitial module gap) and to
+ * the bound doc/decorator range (spec.md §8.3 step 2).
+ */
+function ownRange(scope, ctx, profile) {
+    let range = scope.range;
+    const parent = scope.node.parent;
+    if (parent !== null && profile.exportWrapperKinds.has(parent.type)) {
+        range = unionRange(rangeOf(parent, ctx), range);
+    }
+    return scope.docRange !== undefined ? unionRange(scope.docRange, range) : range;
+}
+/**
+ * Regionen fuer Inhalt, der KEINEN Scope oeffnet, aber Bytes traegt (JS/TS:
+ * `static { ... }` im Klassenrumpf). Welche Knoten das sind, weiss das
+ * Sprachprofil, nicht diese Datei — sonst stuende hier je Sprache eine weitere
+ * verdrahtete Knotenart. Ohne diese Regionen fielen ihre Bytes durch den
+ * Mitgliederlauf; spec.md §8.4 verbietet genau das (kein stiller Datenverlust).
+ */
+function extraMemberRegions(scopeNode, parentScopeId, ctx, profile) {
+    return profile.memberRegions(scopeNode, parentScopeId, ctx).map((member) => ({
+        chunkKind: "property_group",
+        range: member.range,
+        scopeId: member.scopeId,
+        headerText: member.headerText,
+        splittable: false,
+    }));
+}
+function toRegion(scope, groupOrdinal, ctx, profile) {
+    let children = buildChildRegions(scope.children, scope.scopeId, groupOrdinal, ctx, profile);
+    if (scope.kind === "class") {
+        const extras = extraMemberRegions(scope.node, scope.scopeId, ctx, profile);
+        if (extras.length > 0) {
+            children = [...children, ...extras].sort((a, b) => a.range.startByte - b.range.startByte);
+        }
+    }
+    const headerText = scope.signature ?? scope.normalizedSignature;
+    return {
+        chunkKind: chunkKindOf(scope.kind),
+        range: ownRange(scope, ctx, profile),
+        scopeId: scope.scopeId,
+        ...(scope.qualifiedName.length > 0 ? { symbolFqn: scope.qualifiedName } : {}),
+        ...(headerText !== undefined && headerText.length > 0 ? { headerText } : {}),
+        splittable: children.length > 0,
+        ...(children.length > 0 ? { children } : {}),
+    };
+}
+/**
+ * Exported (in addition to being called from {@link buildChildRegions})
+ * so `chunks.test.ts` can exercise the WP-73 empty-list guard directly:
+ * `buildChildRegions`'s own `flushProperties` never calls this with an
+ * empty `properties` array, so that path cannot be reached end-to-end
+ * through `buildFileRegion` alone.
+ */
+export function propertyGroupRegion(properties, parentScopeId, ordinal, ctx, profile) {
+    const [firstProperty, ...restProperties] = properties;
+    if (firstProperty === undefined) {
+        // WP-73: `properties` must never be empty — the only caller
+        // (`flushProperties`) already guards on `pendingProperties.length === 0`
+        // and never reaches this function otherwise. An empty list here means
+        // that invariant was violated by a future caller; there is no
+        // meaningful `SourceRange` for zero properties, so this is an honest
+        // internal-defect report (E4) rather than a defined empty-range value
+        // that would silently mask the bug, and rather than the bare
+        // `Array.prototype.reduce` `TypeError: Reduce of empty array with no
+        // initial value` a caller would otherwise see.
+        throw new UntangleError("ANALYSIS_INCOMPLETE", "propertyGroupRegion called with an empty properties list — a property_group region requires at least one property (spec.md §8.3)", {
+            retryable: false,
+            operation: "chunk",
+            context: { parentScopeId, ordinal },
+        });
+    }
+    const range = restProperties.reduce((acc, property) => unionRange(acc, ownRange(property, ctx, profile)), ownRange(firstProperty, ctx, profile));
+    return {
+        chunkKind: "property_group",
+        range,
+        scopeId: `${parentScopeId}#properties#${ordinal}`,
+        splittable: false,
+    };
+}
+/** Builds child regions for one scope, merging consecutive `property` children into `property_group`s. */
+function buildChildRegions(children, parentScopeId, groupOrdinal, ctx, profile) {
+    const regions = [];
+    let pendingProperties = [];
+    const flushProperties = () => {
+        if (pendingProperties.length === 0)
+            return;
+        regions.push(propertyGroupRegion(pendingProperties, parentScopeId, groupOrdinal.next, ctx, profile));
+        groupOrdinal.next += 1;
+        pendingProperties = [];
+    };
+    for (const child of children) {
+        if (child.kind === "property") {
+            pendingProperties.push(child);
+            continue;
+        }
+        flushProperties();
+        regions.push(toRegion(child, groupOrdinal, ctx, profile));
+    }
+    flushProperties();
+    return regions;
+}
+/** Leading file content (shebang/header comments/imports) before the first top-level region, if non-trivial. */
+/** Builds the single root ("module") `AstRegion` for a whole file. */
+export function buildFileRegion(fileScope, ctx, profile) {
+    const groupOrdinal = { next: 0 };
+    const topLevelRegions = buildChildRegions(fileScope.children, fileScope.scopeId, groupOrdinal, ctx, profile);
+    const firstRegion = topLevelRegions[0];
+    const preamble = firstRegion !== undefined ? buildFilePreambleRegion(fileScope, firstRegion, ctx) : null;
+    const allChildren = preamble !== null ? [preamble, ...topLevelRegions] : topLevelRegions;
+    return {
+        chunkKind: "module",
+        range: fileScope.range,
+        scopeId: fileScope.scopeId,
+        splittable: allChildren.length > 0,
+        ...(allChildren.length > 0 ? { children: allChildren } : {}),
+    };
+}
+function buildFilePreambleRegion(fileScope, firstChild, ctx) {
+    if (firstChild.range.startByte <= fileScope.range.startByte)
+        return null;
+    const rawPreamble = ctx.sourceText.slice(0, indexForByteOffsetApprox(ctx, firstChild.range.startByte));
+    if (rawPreamble.trim().length === 0)
+        return null;
+    return {
+        chunkKind: "file_preamble",
+        range: {
+            startLine: fileScope.range.startLine,
+            endLine: firstChild.range.startLine,
+            startByte: fileScope.range.startByte,
+            endByte: firstChild.range.startByte,
+        },
+        scopeId: fileScope.scopeId,
+        splittable: false,
+    };
+}
+// Approximates a UTF-16 slice index for a byte offset by scanning the
+// (small, preamble-sized) prefix — the preamble is always near the top of
+// the file, so this is O(preamble length), not O(file length).
+function indexForByteOffsetApprox(ctx, byteOffset) {
+    let low = 0;
+    let high = ctx.sourceText.length;
+    while (low < high) {
+        const mid = Math.floor((low + high) / 2);
+        if (ctx.byteTable.toByteOffset(mid) < byteOffset)
+            low = mid + 1;
+        else
+            high = mid;
+    }
+    return low;
+}
+//# sourceMappingURL=chunks.js.map

package/dist/languages/shared/chunks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunks.js","sourceRoot":"","sources":["../../../src/languages/shared/chunks.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAKtD,SAAS,WAAW,CAAC,IAAuB;IAC1C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,aAAa;YAChB,OAAO,aAAa,CAAC;QACvB,KAAK,OAAO;YACV,OAAO,gBAAgB,CAAC;QAC1B,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,WAAW,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC;QAClB,KAAK,UAAU;YACb,yEAAyE;YACzE,OAAO,gBAAgB,CAAC;IAC5B,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,QAAQ,CAAC,KAAgB,EAAE,GAAoB,EAAE,OAAwB;IAChF,IAAI,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACxB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;IACjC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACnE,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAClF,CAAC;AAED;;;;;;GAMG;AACH,SAAS,kBAAkB,CACzB,SAAqB,EACrB,aAAqB,EACrB,GAAoB,EACpB,OAAwB;IAExB,OAAO,OAAO,CAAC,aAAa,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3E,SAAS,EAAE,gBAAyB;QACpC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,QAAQ,CACf,KAAgB,EAChB,YAA8B,EAC9B,GAAoB,EACpB,OAAwB;IAExB,IAAI,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5F,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC3E,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,QAAQ,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,mBAAmB,CAAC;IAChE,OAAO;QACL,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;QAClC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC;QACpC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,UAAU,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC;QAC/B,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAuB,EACvB,aAAqB,EACrB,OAAe,EACf,GAAoB,EACpB,OAAwB;IAExB,MAAM,CAAC,aAAa,EAAE,GAAG,cAAc,CAAC,GAAG,UAAU,CAAC;IACtD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,4DAA4D;QAC5D,yEAAyE;QACzE,sEAAsE;QACtE,8DAA8D;QAC9D,qEAAqE;QACrE,sEAAsE;QACtE,6DAA6D;QAC7D,qEAAqE;QACrE,+CAA+C;QAC/C,MAAM,IAAI,aAAa,CACrB,qBAAqB,EACrB,kIAAkI,EAClI;YACE,SAAS,EAAE,KAAK;YAChB,SAAS,EAAE,OAAO;YAClB,OAAO,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE;SACpC,CACF,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CACjC,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,EACpE,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE,OAAO,CAAC,CACtC,CAAC;IACF,OAAO;QACL,SAAS,EAAE,gBAAgB;QAC3B,KAAK;QACL,OAAO,EAAE,GAAG,aAAa,eAAe,OAAO,EAAE;QACjD,UAAU,EAAE,KAAK;KAClB,CAAC;AACJ,CAAC;AAED,0GAA0G;AAC1G,SAAS,iBAAiB,CACxB,QAAqB,EACrB,aAAqB,EACrB,YAA8B,EAC9B,GAAoB,EACpB,OAAwB;IAExB,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,IAAI,iBAAiB,GAAgB,EAAE,CAAC;IAExC,MAAM,eAAe,GAAG,GAAS,EAAE;QACjC,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC3C,OAAO,CAAC,IAAI,CACV,mBAAmB,CAAC,iBAAiB,EAAE,aAAa,EAAE,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CACvF,CAAC;QACF,YAAY,CAAC,IAAI,IAAI,CAAC,CAAC;QACvB,iBAAiB,GAAG,EAAE,CAAC;IACzB,CAAC,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC9B,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9B,SAAS;QACX,CAAC;QACD,eAAe,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,eAAe,EAAE,CAAC;IAClB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gHAAgH;AAChH,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAC7B,SAAoB,EACpB,GAAoB,EACpB,OAAwB;IAExB,MAAM,YAAY,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACjC,MAAM,eAAe,GAAG,iBAAiB,CACvC,SAAS,CAAC,QAAQ,EAClB,SAAS,CAAC,OAAO,EACjB,YAAY,EACZ,GAAG,EACH,OAAO,CACR,CAAC;IAEF,MAAM,WAAW,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,QAAQ,GACZ,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1F,MAAM,WAAW,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;IAEzF,OAAO;QACL,SAAS,EAAE,QAAQ;QACnB,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,UAAU,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC;QAClC,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,SAAoB,EACpB,UAAqB,EACrB,GAAoB;IAEpB,IAAI,UAAU,CAAC,KAAK,CAAC,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IACzE,MAAM,WAAW,GAAG,GAAG,CAAC,UAAU,CAAC,KAAK,CACtC,CAAC,EACD,wBAAwB,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAC1D,CAAC;IACF,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO;QACL,SAAS,EAAE,eAAe;QAC1B,KAAK,EAAE;YACL,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,SAAS;YACpC,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,SAAS;YACnC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,SAAS;YACpC,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,SAAS;SACpC;QACD,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,UAAU,EAAE,KAAK;KAClB,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,0EAA0E;AAC1E,+DAA+D;AAC/D,SAAS,wBAAwB,CAAC,GAAoB,EAAE,UAAkB;IACxE,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;IACjC,OAAO,GAAG,GAAG,IAAI,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,IAAI,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,UAAU;YAAE,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;;YAC3D,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/languages/shared/create-adapter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Wires one `Dialect` config into a full `LanguageAdapter` (domain
+ * `analysis.ts`), backed by the shared tree-sitter engine.
+ *
+ * See `engine.ts`'s doc comment for why every extraction method is a
+ * projection over one memoized `AnalysisResult`.
+ */
+import type { LanguageAdapter } from "@untangle-code/domain";
+import type { Dialect } from "./dialect.js";
+export declare function createTreeSitterAdapter(dialect: Dialect): LanguageAdapter;
+//# sourceMappingURL=create-adapter.d.ts.map

package/dist/languages/shared/create-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-adapter.d.ts","sourceRoot":"","sources":["../../../src/languages/shared/create-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAIV,eAAe,EAMhB,MAAM,uBAAuB,CAAC;AAK/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA6C5C,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAoEzE"}

package/dist/languages/shared/create-adapter.js

@@ -0,0 +1,90 @@
+import { buildByteOffsetTable } from "../../text/byte-offset-table.js";
+import { buildFileRegion } from "./chunks.js";
+import { analyzeTree } from "./engine.js";
+import { extractedSymbolsOf } from "./extract-symbols.js";
+import { loadGrammar, loadParserCtor } from "./grammar-loader.js";
+import { createJsFamilyProfile } from "./js-family-profile.js";
+import { collectParseDiagnostics } from "./parse-diagnostics.js";
+import { parseWithBuffer } from "./parse-limits.js";
+const analysisCache = new WeakMap();
+/**
+ * `ComplexityFacts.parseDiagnostics` ist der EINZIGE Kanal, ueber den
+ * nachgelagerte Rechnungen (`computeSyntactic`, Berichte, Skip-Ledger) davon
+ * erfahren, dass der Syntaxbaum einer Datei beschaedigt ist. `analyzeTree`
+ * sieht die Diagnosen nicht — sie entstehen in `parse()` und haengen am
+ * `ParsedAst`. Wurde das Feld hier nicht befuellt, blieb es AUSNAHMSLOS leer:
+ * `parse_error_node_count` und `missing_node_count` meldeten dann fuer jede
+ * Datei 0, auch fuer eine mit `parseQuality: "partial"` und 25 Fehlerknoten.
+ * Genau dieses stille Verschlucken verbietet E4.
+ */
+function getAnalysis(ast) {
+    const cached = analysisCache.get(ast);
+    if (cached !== undefined)
+        return cached;
+    const root = ast.root;
+    const analyzed = analyzeTree(root.tree.rootNode, root.ctx, root.fileId, root.profile);
+    const result = {
+        ...analyzed,
+        facts: { ...analyzed.facts, parseDiagnostics: ast.diagnostics },
+    };
+    analysisCache.set(ast, result);
+    return result;
+}
+export function createTreeSitterAdapter(dialect) {
+    // EIN Profil je Adapter, einmal gebaut: die Mengen darin sind unveraenderlich,
+    // und der Walk liest sie je Knoten (`engine.ts`).
+    const profile = createJsFamilyProfile(dialect);
+    return {
+        languageId: dialect.languageId,
+        extensions: dialect.extensions,
+        supportLevel: dialect.supportLevel,
+        parse(source) {
+            const ParserCtor = loadParserCtor();
+            const language = loadGrammar(dialect.grammar);
+            const parser = new ParserCtor();
+            parser.setLanguage(language);
+            // NIE `parser.parse(source.content)` — ohne `bufferSize` wirft die native
+            // Bindung fuer jede Datei ueber 32 KiB `Invalid argument` (WP-215).
+            // `parseWithBuffer` prueft die Groessengrenze, setzt den Puffer und
+            // benennt jede Ausnahme (WP-216).
+            const tree = parseWithBuffer(parser, source.content);
+            const byteTable = buildByteOffsetTable(source.content);
+            const ctx = { sourceText: source.content, byteTable };
+            const { parseQuality, diagnostics, errorNodeCount, missingNodeCount } = collectParseDiagnostics(tree.rootNode, ctx);
+            if (parseQuality === "failed") {
+                return { parseQuality, ast: null, diagnostics, errorNodeCount, missingNodeCount };
+            }
+            const root = { tree, ctx, fileId: source.fileId, profile };
+            return {
+                parseQuality,
+                ast: { languageId: dialect.languageId, parseQuality, root, diagnostics },
+                diagnostics,
+                errorNodeCount,
+                missingNodeCount,
+            };
+        },
+        extractChunks(ast) {
+            const { scopeTree } = getAnalysis(ast);
+            const root = ast.root;
+            return [buildFileRegion(scopeTree, root.ctx, root.profile)];
+        },
+        extractSymbols(ast) {
+            const { scopeTree } = getAnalysis(ast);
+            return extractedSymbolsOf(scopeTree);
+        },
+        extractImports(ast) {
+            return getAnalysis(ast).imports;
+        },
+        extractCalls(ast) {
+            return getAnalysis(ast).calls;
+        },
+        computeComplexity(ast) {
+            return getAnalysis(ast).facts;
+        },
+        tokenizeForHalstead(ast) {
+            const { facts } = getAnalysis(ast);
+            return { operators: facts.operators, operands: facts.operands };
+        },
+    };
+}
+//# sourceMappingURL=create-adapter.js.map

package/dist/languages/shared/create-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-adapter.js","sourceRoot":"","sources":["../../../src/languages/shared/create-adapter.ts"],"names":[],"mappings":"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"}

package/dist/languages/shared/decisions.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Decision-point and nesting-event detection (spec.md §16.2-§16.4).
+ *
+ * Called once per non-leaf node during the main walk (`engine.ts`); returns
+ * the zero-or-one `DecisionFact`/`NestingFact` pair this specific node
+ * contributes (attribution to a `symbolScopeId` happens in the caller,
+ * which knows the current scope).
+ */
+import type { DecisionKind } from "@untangle-code/domain";
+import type { SyntaxNode } from "./syntax.js";
+export interface DetectedDecision {
+    kind: DecisionKind;
+    countsForClassic: boolean;
+    countsForExtended: boolean;
+    logicalGroupId?: string;
+    /**
+     * Wie oft dieser EINE Knoten die Entscheidung beitraegt (Vorgabe: 1).
+     *
+     * WOFUER: eine Grammatik kann eine n-stellige Alternative FLACH ablegen.
+     * Rusts `or_pattern` ist linksrekursiv — `A | B | C` sind zwei
+     * verschachtelte Knoten, also zwei Entscheidungen ohne weiteres Zutun.
+     * Pythons `union_pattern` ist FLACH: `case 1 | 2 | 3` ist EIN Knoten mit
+     * drei Zweigen. Ohne diese Zahl kostete `1 | 2 | 3` genauso viel wie
+     * `1 | 2`, und die Metrik behauptete eine Gleichheit, die es nicht gibt.
+     *
+     * Die zusaetzlichen Entscheidungen teilen sich den Bereich des Knotens:
+     * die Alternativen liegen darin, und ein erfundener engerer Bereich waere
+     * eine Angabe, die der Baum nicht hergibt.
+     */
+    repeat?: number;
+}
+export interface DetectedNesting {
+    construct: string;
+    continuation: boolean;
+}
+export interface DecisionDetectionResult {
+    decision?: DetectedDecision;
+    nesting?: DetectedNesting;
+}
+/** Kann ein Knoten dieses Typs eine Entscheidung oder ein Nesting-Ereignis tragen? */
+export declare function mayCarryDecisionOrNesting(nodeType: string): boolean;
+export declare function detectDecisionAndNesting(node: SyntaxNode): DecisionDetectionResult;
+/** Nesting construct for a lambda/local-function boundary (spec.md §16.4). */
+export declare function lambdaNesting(): DetectedNesting;
+//# sourceMappingURL=decisions.d.ts.map

package/dist/languages/shared/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../../src/languages/shared/decisions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAY1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AA8DD,sFAAsF;AACtF,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG,uBAAuB,CA+ElF;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,IAAI,eAAe,CAE/C"}

package/dist/languages/shared/decisions.js

@@ -0,0 +1,141 @@
+import { BINARY_EXPRESSION, CATCH_CLAUSE, IF_STATEMENT, JUMP_STATEMENT_TYPES, LOOP_TYPES, SWITCH_CASE, SWITCH_STATEMENT, TERNARY_EXPRESSION, } from "./node-kinds.js";
+function isElseIf(node) {
+    return node.parent !== null && node.parent.type === "else_clause";
+}
+/** A guard clause: `if (cond) return/throw/break/continue;` with no `else`. */
+function isGuardClause(node) {
+    if (node.childForFieldName("alternative") !== null)
+        return false;
+    const consequence = node.childForFieldName("consequence");
+    if (consequence === null)
+        return false;
+    const soleStatement = consequence.type === "statement_block"
+        ? consequence.namedChildCount === 1
+            ? consequence.namedChild(0)
+            : null
+        : consequence;
+    return soleStatement !== null && JUMP_STATEMENT_TYPES.has(soleStatement.type);
+}
+/**
+ * Finds the topmost node in a maximal chain of the same binary operator (for
+ * grouping §16.3/§16.4) and derives a stable id for it from its position in
+ * the source (`startIndex`, the group top node's byte offset) rather than
+ * tree-sitter's runtime `node.id`. `node.id` is a native-binding identifier
+ * (effectively a heap address) that is NOT stable across processes or even
+ * across repeated parses of the identical source within the same process —
+ * two parse runs of the same file can and do produce different `node.id`
+ * values. `startIndex` is deterministic: the same source byte range always
+ * yields the same id, which is what vision.md §8.5's determinism principle
+ * requires once `ComplexityFacts` are persisted or compared across runs.
+ */
+function logicalGroupIdFor(node, operatorText) {
+    let top = node;
+    while (top.parent !== null && top.parent.type === BINARY_EXPRESSION) {
+        const parentOperator = top.parent.childForFieldName("operator")?.text;
+        if (parentOperator !== operatorText)
+            break;
+        top = top.parent;
+    }
+    return `logical-${top.startIndex}`;
+}
+/**
+ * Die Knotentypen, fuer die {@link detectDecisionAndNesting} ueberhaupt etwas
+ * anderes als `{}` liefern kann — abgeleitet aus den Verzweigungen unten und
+ * durch `decisions.test.ts` an sie gebunden.
+ *
+ * WOZU: der Cursor-Walk (`engine.ts`, WP-95) materialisiert einen
+ * `SyntaxNode`-Wrapper nur dann, wenn ein Detektor ihn wirklich braucht. Ohne
+ * dieses Vorsieb muesste er fuer JEDEN inneren Knoten einen Wrapper bauen —
+ * also genau die Grenzueberquerung wieder einfuehren, die der Cursor spart.
+ */
+const DECISION_CANDIDATE_TYPES = new Set([
+    IF_STATEMENT,
+    ...LOOP_TYPES,
+    CATCH_CLAUSE,
+    TERNARY_EXPRESSION,
+    SWITCH_STATEMENT,
+    SWITCH_CASE,
+    BINARY_EXPRESSION,
+]);
+/** Kann ein Knoten dieses Typs eine Entscheidung oder ein Nesting-Ereignis tragen? */
+export function mayCarryDecisionOrNesting(nodeType) {
+    return DECISION_CANDIDATE_TYPES.has(nodeType);
+}
+export function detectDecisionAndNesting(node) {
+    if (node.type === IF_STATEMENT) {
+        if (isElseIf(node)) {
+            return {
+                decision: { kind: "else_if", countsForClassic: true, countsForExtended: true },
+                nesting: { construct: "if", continuation: true },
+            };
+        }
+        const kind = isGuardClause(node) ? "guard" : "if";
+        return {
+            decision: { kind, countsForClassic: true, countsForExtended: true },
+            nesting: { construct: "if", continuation: false },
+        };
+    }
+    if (LOOP_TYPES.has(node.type)) {
+        return {
+            decision: { kind: "loop", countsForClassic: true, countsForExtended: true },
+            nesting: { construct: "loop", continuation: false },
+        };
+    }
+    if (node.type === CATCH_CLAUSE) {
+        return {
+            decision: { kind: "catch", countsForClassic: true, countsForExtended: true },
+            nesting: { construct: "catch", continuation: false },
+        };
+    }
+    if (node.type === TERNARY_EXPRESSION) {
+        return {
+            decision: { kind: "ternary", countsForClassic: true, countsForExtended: true },
+            nesting: { construct: "ternary", continuation: false },
+        };
+    }
+    if (node.type === SWITCH_STATEMENT) {
+        return { nesting: { construct: "switch", continuation: false } };
+    }
+    if (node.type === SWITCH_CASE) {
+        return { decision: { kind: "case", countsForClassic: true, countsForExtended: true } };
+    }
+    if (node.type === BINARY_EXPRESSION) {
+        const operator = node.childForFieldName("operator")?.text;
+        if (operator === "&&") {
+            return {
+                decision: {
+                    kind: "logical_and",
+                    countsForClassic: false,
+                    countsForExtended: true,
+                    logicalGroupId: logicalGroupIdFor(node, "&&"),
+                },
+            };
+        }
+        if (operator === "||") {
+            return {
+                decision: {
+                    kind: "logical_or",
+                    countsForClassic: false,
+                    countsForExtended: true,
+                    logicalGroupId: logicalGroupIdFor(node, "||"),
+                },
+            };
+        }
+        if (operator === "??") {
+            return {
+                decision: {
+                    kind: "short_circuit",
+                    countsForClassic: false,
+                    countsForExtended: true,
+                    logicalGroupId: logicalGroupIdFor(node, "??"),
+                },
+            };
+        }
+    }
+    return {};
+}
+/** Nesting construct for a lambda/local-function boundary (spec.md §16.4). */
+export function lambdaNesting() {
+    return { construct: "lambda", continuation: false };
+}
+//# sourceMappingURL=decisions.js.map

package/dist/languages/shared/decisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.js","sourceRoot":"","sources":["../../../src/languages/shared/decisions.ts"],"names":[],"mappings":"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"}

package/dist/languages/shared/dialect.d.ts

@@ -0,0 +1,18 @@
+import type { SupportLevel } from "@untangle-code/domain";
+import type { GrammarSource } from "./grammar-loader.js";
+/** Static, per-language configuration for the tree-sitter adapter factory. */
+export interface Dialect {
+    languageId: string;
+    extensions: string[];
+    supportLevel: SupportLevel;
+    grammar: GrammarSource;
+    /** Whether the grammar has TypeScript type syntax (interfaces, type aliases, enums, type annotations, generics). */
+    hasTypes: boolean;
+    /** Class field/property-signature node type name, which differs between the JS and TS grammars. */
+    fieldDefinitionKind: "field_definition" | "public_field_definition";
+}
+export declare const TYPESCRIPT_DIALECT: Dialect;
+export declare const TSX_DIALECT: Dialect;
+export declare const JAVASCRIPT_DIALECT: Dialect;
+export declare const JSX_DIALECT: Dialect;
+//# sourceMappingURL=dialect.d.ts.map

package/dist/languages/shared/dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.d.ts","sourceRoot":"","sources":["../../../src/languages/shared/dialect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,8EAA8E;AAC9E,MAAM,WAAW,OAAO;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,oHAAoH;IACpH,QAAQ,EAAE,OAAO,CAAC;IAClB,mGAAmG;IACnG,mBAAmB,EAAE,kBAAkB,GAAG,yBAAyB,CAAC;CACrE;AAED,eAAO,MAAM,kBAAkB,EAAE,OAOhC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,OAOzB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OAOhC,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,OAWzB,CAAC"}

package/dist/languages/shared/dialect.js

@@ -0,0 +1,37 @@
+export const TYPESCRIPT_DIALECT = {
+    languageId: "typescript",
+    extensions: [".ts", ".mts", ".cts"],
+    supportLevel: "deep",
+    grammar: { moduleName: "tree-sitter-typescript", exportName: "typescript" },
+    hasTypes: true,
+    fieldDefinitionKind: "public_field_definition",
+};
+export const TSX_DIALECT = {
+    languageId: "tsx",
+    extensions: [".tsx"],
+    supportLevel: "deep",
+    grammar: { moduleName: "tree-sitter-typescript", exportName: "tsx" },
+    hasTypes: true,
+    fieldDefinitionKind: "public_field_definition",
+};
+export const JAVASCRIPT_DIALECT = {
+    languageId: "javascript",
+    extensions: [".js", ".mjs", ".cjs"],
+    supportLevel: "deep",
+    grammar: { moduleName: "tree-sitter-javascript" },
+    hasTypes: false,
+    fieldDefinitionKind: "field_definition",
+};
+export const JSX_DIALECT = {
+    languageId: "jsx",
+    extensions: [".jsx"],
+    supportLevel: "deep",
+    // tree-sitter-javascript's single grammar already parses JSX syntax
+    // (verified empirically — see README "Grammatik-Wahl"); JSX gets its own
+    // languageId/extension per spec.md §7.2's MVP table row ("TSX/JSX"), not
+    // its own grammar.
+    grammar: { moduleName: "tree-sitter-javascript" },
+    hasTypes: false,
+    fieldDefinitionKind: "field_definition",
+};
+//# sourceMappingURL=dialect.js.map

package/dist/languages/shared/dialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.js","sourceRoot":"","sources":["../../../src/languages/shared/dialect.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,kBAAkB,GAAY;IACzC,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IACnC,YAAY,EAAE,MAAM;IACpB,OAAO,EAAE,EAAE,UAAU,EAAE,wBAAwB,EAAE,UAAU,EAAE,YAAY,EAAE;IAC3E,QAAQ,EAAE,IAAI;IACd,mBAAmB,EAAE,yBAAyB;CAC/C,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAY;IAClC,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM;IACpB,OAAO,EAAE,EAAE,UAAU,EAAE,wBAAwB,EAAE,UAAU,EAAE,KAAK,EAAE;IACpE,QAAQ,EAAE,IAAI;IACd,mBAAmB,EAAE,yBAAyB;CAC/C,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAY;IACzC,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IACnC,YAAY,EAAE,MAAM;IACpB,OAAO,EAAE,EAAE,UAAU,EAAE,wBAAwB,EAAE;IACjD,QAAQ,EAAE,KAAK;IACf,mBAAmB,EAAE,kBAAkB;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAY;IAClC,UAAU,EAAE,KAAK;IACjB,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM;IACpB,oEAAoE;IACpE,yEAAyE;IACzE,yEAAyE;IACzE,mBAAmB;IACnB,OAAO,EAAE,EAAE,UAAU,EAAE,wBAAwB,EAAE;IACjD,QAAQ,EAAE,KAAK;IACf,mBAAmB,EAAE,kBAAkB;CACxC,CAAC"}

package/dist/languages/shared/doc-binding.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Doc-comment binding (spec.md §8.3 step 2: "Doccomment, Annotationen und
+ * Dekoratoren an das folgende Symbol binden").
+ *
+ * Decorators are represented by the grammar as PRECEDING SIBLINGS of the
+ * member they decorate inside `class_body` (verified empirically — not as a
+ * nested field on the member node, despite `node-types.json` listing
+ * `decorator` as an optional field; that field shape applies to parameter
+ * decorators, e.g. `constructor(@Inject() dep: Dep)`, which nest inside
+ * `required_parameter` instead). A leading doc comment is, in turn, a
+ * preceding sibling of the (possibly decorator-preceded) member.
+ *
+ * For a symbol whose defining node is buried inside an expression (an arrow
+ * function assigned to a `const`, a function expression as an object
+ * property value, ...), the anchor for "preceding sibling" purposes is not
+ * the function node itself but its enclosing statement — see
+ * `resolveDocAnchor`.
+ */
+import type { SourceRange } from "@untangle-code/domain";
+import type { FileTextContext } from "./node-utils.js";
+import type { SyntaxNode } from "./syntax.js";
+/** Climbs from a (possibly deeply nested) scope-defining node to its statement-level anchor. */
+export declare function resolveDocAnchor(node: SyntaxNode): SyntaxNode;
+/** Resolves the bound doc-comment range for a scope-defining node, if any (spec.md §8.3 step 2). */
+export declare function resolveDocRange(node: SyntaxNode, ctx: FileTextContext): SourceRange | undefined;
+//# sourceMappingURL=doc-binding.d.ts.map

package/dist/languages/shared/doc-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-binding.d.ts","sourceRoot":"","sources":["../../../src/languages/shared/doc-binding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAwB7D;AAID,oGAAoG;AACpG,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,eAAe,GAAG,WAAW,GAAG,SAAS,CAsB/F"}