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

package/dist/languages/shared/doc-binding.js

@@ -0,0 +1,50 @@
+import { COMMENT_TYPE, DECORATOR_TYPE } from "./node-kinds.js";
+import { rangeOf, unionRange } from "./node-utils.js";
+/** Climbs from a (possibly deeply nested) scope-defining node to its statement-level anchor. */
+export function resolveDocAnchor(node) {
+    let anchor = node;
+    const parent = node.parent;
+    if (parent !== null) {
+        if (parent.type === "variable_declarator") {
+            const declarationList = parent.parent;
+            if (declarationList !== null &&
+                (declarationList.type === "lexical_declaration" ||
+                    declarationList.type === "variable_declaration")) {
+                anchor = declarationList;
+            }
+        }
+        else if (parent.type === "assignment_expression" &&
+            parent.parent?.type === "expression_statement") {
+            anchor = parent.parent;
+        }
+    }
+    if (anchor.parent !== null && anchor.parent.type === "export_statement") {
+        anchor = anchor.parent;
+    }
+    return anchor;
+}
+const MAX_BLANK_LINES_BETWEEN_DOC_AND_SYMBOL = 1;
+/** Resolves the bound doc-comment range for a scope-defining node, if any (spec.md §8.3 step 2). */
+export function resolveDocRange(node, ctx) {
+    const anchor = resolveDocAnchor(node);
+    let cursor = anchor.previousSibling;
+    let boundary = anchor;
+    // Skip immediately-preceding decorators (they travel with the symbol's own range, not the doc range,
+    // but a comment further back must still be considered "immediately preceding" through them).
+    while (cursor !== null && cursor.type === DECORATOR_TYPE) {
+        boundary = cursor;
+        cursor = cursor.previousSibling;
+    }
+    let docRange;
+    while (cursor !== null && cursor.type === COMMENT_TYPE) {
+        const gap = boundary.startPosition.row - cursor.endPosition.row;
+        if (gap > MAX_BLANK_LINES_BETWEEN_DOC_AND_SYMBOL)
+            break;
+        const commentRange = rangeOf(cursor, ctx);
+        docRange = docRange === undefined ? commentRange : unionRange(commentRange, docRange);
+        boundary = cursor;
+        cursor = cursor.previousSibling;
+    }
+    return docRange;
+}
+//# sourceMappingURL=doc-binding.js.map

package/dist/languages/shared/doc-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-binding.js","sourceRoot":"","sources":["../../../src/languages/shared/doc-binding.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE/D,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGtD,gGAAgG;AAChG,MAAM,UAAU,gBAAgB,CAAC,IAAgB;IAC/C,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,IAAI,MAAM,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;YAC1C,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;YACtC,IACE,eAAe,KAAK,IAAI;gBACxB,CAAC,eAAe,CAAC,IAAI,KAAK,qBAAqB;oBAC7C,eAAe,CAAC,IAAI,KAAK,sBAAsB,CAAC,EAClD,CAAC;gBACD,MAAM,GAAG,eAAe,CAAC;YAC3B,CAAC;QACH,CAAC;aAAM,IACL,MAAM,CAAC,IAAI,KAAK,uBAAuB;YACvC,MAAM,CAAC,MAAM,EAAE,IAAI,KAAK,sBAAsB,EAC9C,CAAC;YACD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QACzB,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACxE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,sCAAsC,GAAG,CAAC,CAAC;AAEjD,oGAAoG;AACpG,MAAM,UAAU,eAAe,CAAC,IAAgB,EAAE,GAAoB;IACpE,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAEtC,IAAI,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC;IACpC,IAAI,QAAQ,GAAG,MAAM,CAAC;IACtB,qGAAqG;IACrG,6FAA6F;IAC7F,OAAO,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACzD,QAAQ,GAAG,MAAM,CAAC;QAClB,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC;IAClC,CAAC;IAED,IAAI,QAAiC,CAAC;IACtC,OAAO,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACvD,MAAM,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC;QAChE,IAAI,GAAG,GAAG,sCAAsC;YAAE,MAAM;QACxD,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1C,QAAQ,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QACtF,QAAQ,GAAG,MAAM,CAAC;QAClB,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC;IAClC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,49 @@
+/**
+ * The single unified AST walk. Every `LanguageAdapter` extraction method
+ * (`extractSymbols`, `extractImports`, `extractCalls`, `computeComplexity`,
+ * `tokenizeForHalstead`, `extractChunks`) is a thin projection over the ONE
+ * `AnalysisResult` this module computes — see `create-adapter.ts`, which
+ * memoizes it per `ParsedAst` (via `WeakMap`) so calling multiple extract
+ * methods on the same parse re-walks the tree only once.
+ *
+ * Building everything in one pass is not just a performance optimization:
+ * it is what GUARANTEES that a `symbolScopeId` produced for a
+ * `SymbolScopeFact` (from `computeComplexity`) is the exact same string as
+ * the `callerScopeId` on a `RawCall` (from `extractCalls`) for a call
+ * written inside that scope — both come from the same live scope-stack
+ * frame during the same walk, not from two independently-reimplemented
+ * scope-id algorithms that could drift apart.
+ *
+ * TRAVERSIERUNG (WP-95): der Walk laeuft ueber die CURSOR-API
+ * (`tree.walk()` / `gotoFirstChild` / `gotoNextSibling` / `gotoParent`),
+ * NICHT ueber `node.children`. Gemessen an diesem Repository (716 Dateien,
+ * 128.219 Zeilen) kostete der `.children`-Weg 25,6 s fuer den Walk gegen
+ * 3,6 s fuers Parsen: jeder `.children`-Zugriff baut ein JS-Array aus
+ * Knotenwrappern und ueberquert die Grenze zur nativen Bibliothek einmal je
+ * Knoten. Der Cursor haelt die Position nativ.
+ *
+ * WAS DER CURSOR NICHT HAT, und wie es hier ersetzt wird:
+ *   - `node.parent`  -> `parentTypeAt[depth]`, waehrend des Abstiegs gefuehrt.
+ *   - `node.childCount === 0` -> ein probeweises `gotoFirstChild()`; schlaegt
+ *     es fehl, ist der Knoten ein Blatt (sonst bringt `gotoParent()` zurueck).
+ *   - `parent.childForFieldName(...)` fuer die Rolle eines Bezeichners ->
+ *     `cursor.currentFieldName`, das denselben Feldnamen ohne Wrapper liefert.
+ *
+ * Ein `SyntaxNode`-Wrapper entsteht nur noch dort, wo ein Detektor ihn
+ * wirklich braucht (siehe `visitInnerNode`) — wer diese Vorsiebe aufweicht,
+ * baut die Grenzueberquerung je Knoten wieder ein.
+ */
+import type { ComplexityFacts, RawCall, RawImport } from "@untangle-code/domain";
+import type { FileTextContext } from "./node-utils.js";
+import type { LanguageProfile } from "./profile.js";
+import type { ScopeNode } from "./scope-model.js";
+import type { SyntaxNode } from "./syntax.js";
+export interface AnalysisResult {
+    scopeTree: ScopeNode;
+    facts: ComplexityFacts;
+    imports: RawImport[];
+    calls: RawCall[];
+}
+/** Runs the single unified walk over a file's root node. */
+export declare function analyzeTree(root: SyntaxNode, ctx: FileTextContext, fileId: string, profile: LanguageProfile): AnalysisResult;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/languages/shared/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,OAAO,KAAK,EACV,eAAe,EAIf,OAAO,EACP,SAAS,EAIV,MAAM,uBAAuB,CAAC;AAI/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,cAAc,CAAC;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAyUD,4DAA4D;AAC5D,wBAAgB,WAAW,CACzB,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,GACvB,cAAc,CAgEhB"}

package/dist/languages/shared/engine.js

@@ -0,0 +1,317 @@
+import { lambdaNesting } from "./decisions.js";
+import { computeAstHash, computeTokenFingerprint } from "./fingerprint.js";
+import { commentRangeOfCursor, rangeOf, rangeOfCursor } from "./node-utils.js";
+import { isExecutableScopeKind } from "./profile.js";
+/** Separates scope-id components (U+001F, unit separator) — avoids the classic "ab"+"c" == "a"+"bc" join ambiguity. */
+const SCOPE_ID_SEPARATOR = "";
+function toSymbolScopeFact(frame, parentScopeId) {
+    const { scopeNode } = frame;
+    return {
+        symbolScopeId: scopeNode.scopeId,
+        name: scopeNode.name,
+        qualifiedName: scopeNode.qualifiedName,
+        kind: scopeNode.kind,
+        range: scopeNode.range,
+        ...(parentScopeId !== undefined ? { parentScopeId } : {}),
+        executable: scopeNode.executable,
+    };
+}
+function openScope(cursor, node, parent, profile, ctx, fileId, out) {
+    if (profile.suppressesScope(node))
+        return null;
+    const kind = profile.scopeKindOf(node);
+    if (kind === null)
+        return null;
+    const name = profile.scopeName(node);
+    // WP-237: Sprachen, die den Traeger als FELD statt als Elternknoten fuehren
+    // (Gos Methodenempfaenger), liefern ihn hier nach. Der SYMBOLNAME bleibt
+    // unveraendert `Run` — nur der qualifizierte Name wird `A.Run`, damit zwei
+    // gleichnamige Methoden auf verschiedenen Typen unterscheidbar bleiben.
+    const qualifier = profile.scopeQualifier?.(node);
+    const localName = qualifier === undefined ? name : `${qualifier}.${name}`;
+    const qualifiedName = parent.qualifiedName.length > 0 ? `${parent.qualifiedName}.${localName}` : localName;
+    const counterKey = `${kind}:${qualifiedName}`;
+    const ordinal = parent.childOrdinalCounters.get(counterKey) ?? 0;
+    parent.childOrdinalCounters.set(counterKey, ordinal + 1);
+    const scopeId = [fileId, "scope", qualifiedName, kind, String(ordinal)].join(SCOPE_ID_SEPARATOR);
+    const signature = profile.scopeSignature(node, kind, name);
+    const docRange = profile.docRange(node, ctx);
+    const executable = isExecutableScopeKind(kind);
+    const visibility = profile.visibility(node, name);
+    const parentQualifiedName = parent.qualifiedName.length > 0 ? parent.qualifiedName : undefined;
+    const scopeNode = {
+        scopeId,
+        kind,
+        name,
+        qualifiedName,
+        ...(parentQualifiedName !== undefined ? { parentQualifiedName } : {}),
+        range: rangeOf(node, ctx),
+        ...(docRange !== undefined ? { docRange } : {}),
+        ...(signature.raw !== undefined ? { signature: signature.raw } : {}),
+        normalizedSignature: signature.normalized,
+        exportedNames: profile.exportedNames(node, name),
+        ...(visibility !== undefined ? { visibility } : {}),
+        executable,
+        astHash: computeAstHash(cursor, profile),
+        tokenFingerprint: computeTokenFingerprint(cursor, profile),
+        node,
+        children: [],
+    };
+    const frame = {
+        scopeId,
+        qualifiedName,
+        executable,
+        scopeNode,
+        childOrdinalCounters: new Map(),
+    };
+    out.symbolScopes.push(toSymbolScopeFact(frame, parent.scopeId));
+    parent.scopeNode.children.push(scopeNode);
+    return frame;
+}
+/**
+ * Ein Blattknoten (kein Kind) wird eingeordnet. Der Cursor steht auf ihm; ein
+ * `SyntaxNode`-Wrapper wird NICHT gebaut — `nodeText`, `nodeType` und
+ * `currentFieldName` liefern alles Noetige, `parentType` kommt aus dem Abstieg.
+ *
+ * Die frueher hier stehende `predefined_type`-Pruefung ist ENTFALLEN, nicht
+ * vergessen: der einzige Aufrufer (`walkWithCursor`) siebt diesen Fall bereits
+ * vor dem Blatt-Zweig aus (ueber `profile.typeKeywordParentKinds`), die
+ * Pruefung war an dieser Stelle unerreichbar.
+ */
+function classifyAndRecordLeaf(cursor, nodeType, parentType, range, frame, profile, out) {
+    const scopeId = frame.scopeId;
+    if (profile.identifierLeafKinds.has(nodeType)) {
+        const text = cursor.nodeText;
+        out.identifiers.push({
+            name: text,
+            range,
+            symbolScopeId: scopeId,
+            role: profile.identifierRole(cursor.currentFieldName, parentType),
+        });
+        out.operands.push({ text, range, symbolScopeId: scopeId });
+        return;
+    }
+    if (profile.simpleLiteralLeafKinds.has(nodeType)) {
+        const text = cursor.nodeText;
+        out.literals.push({
+            raw: text,
+            literalKind: profile.simpleLiteralKind(nodeType),
+            range,
+            symbolScopeId: scopeId,
+        });
+        out.operands.push({ text, range, symbolScopeId: scopeId });
+        return;
+    }
+    if (profile.templateTextLeafKinds.has(nodeType)) {
+        const text = cursor.nodeText;
+        out.literals.push({ raw: text, literalKind: "template", range, symbolScopeId: scopeId });
+        out.operands.push({ text, range, symbolScopeId: scopeId });
+        return;
+    }
+    if (profile.ignoredPunctuationKinds.has(nodeType))
+        return;
+    out.operators.push({ text: cursor.nodeText, range, symbolScopeId: scopeId });
+}
+/**
+ * Alles, was ein innerer Knoten (mindestens ein Kind) beitraegt: Entscheidung,
+ * Nesting, Import, Aufruf, eigener Scope. Gibt den neu geoeffneten Scope-Rahmen
+ * zurueck, sonst `null`.
+ *
+ * HIER und nur hier entsteht ein `SyntaxNode`-Wrapper, und nur wenn das Profil
+ * fuer diese Knotenart ueberhaupt einen Detektor auf den Plan ruft
+ * (`profile.needsNode`). Fuer die grosse Mehrheit der inneren Knoten faellt die
+ * Grenzueberquerung damit ganz weg — beim tree-sitter-Backend spart das den
+ * Wrapper, beim ast-grep-Backend den weit teureren `children()`-Aufbau.
+ */
+function visitInnerNode(cursor, nodeType, range, frame, profile, ctx, fileId, out) {
+    // Kein Detektor zustaendig: kein Wrapper, kein Scope. Das Lambda-Nesting
+    // unten kann hier nicht verloren gehen — ein funktionsartiger Knoten oeffnet
+    // immer auch einen Scope, also ist `needsNode` dort wahr (in
+    // `js-family-profile.ts` wie in `table-profile.ts` durch Konstruktion).
+    if (!profile.needsNode(nodeType))
+        return null;
+    const node = cursor.currentNode;
+    // Decision / nesting facts.
+    const detected = profile.detectDecisionAndNesting(node);
+    if (detected.decision !== undefined) {
+        const fact = {
+            kind: detected.decision.kind,
+            range,
+            symbolScopeId: frame.scopeId,
+            countsForClassic: detected.decision.countsForClassic,
+            countsForExtended: detected.decision.countsForExtended,
+            ...(detected.decision.logicalGroupId !== undefined
+                ? { logicalGroupId: detected.decision.logicalGroupId }
+                : {}),
+        };
+        // `repeat` (Vorgabe 1) ist die flache n-stellige Alternative — siehe
+        // `DetectedDecision.repeat`. Jede Wiederholung ist eine EIGENE Tatsache
+        // mit demselben Bereich, kein Zaehler auf einer.
+        for (let index = 0; index < (detected.decision.repeat ?? 1); index += 1) {
+            out.decisions.push({ ...fact });
+        }
+    }
+    if (detected.nesting !== undefined) {
+        out.nestingEvents.push({
+            construct: detected.nesting.construct,
+            range,
+            symbolScopeId: frame.scopeId,
+            continuation: detected.nesting.continuation,
+        });
+    }
+    // Importe und Aufrufe (Aufrufe dem AKTUELLEN Scope zugerechnet, also dem Rufer).
+    const sink = { imports: out.imports, calls: out.calls };
+    profile.collectModuleFacts(node, nodeType, frame.scopeId, ctx, sink);
+    const openedScope = openScope(cursor, node, frame, profile, ctx, fileId, out);
+    // A directly-nested function-like node (lambda/local function) inside an
+    // already-executable scope gets an extra lambda nesting event (spec.md
+    // §16.4: "lokale Funktionen/Lambdas verwenden einen dokumentierten
+    // Nesting-Kontext") in addition to becoming its own scope below. A node kind
+    // can be function-like only in a particular syntactic context, so a rejected
+    // scope must not leave behind a phantom lambda event.
+    if (openedScope !== null && frame.executable && profile.functionLikeKinds.has(nodeType)) {
+        const lambda = lambdaNesting();
+        out.nestingEvents.push({
+            construct: lambda.construct,
+            range,
+            symbolScopeId: frame.scopeId,
+            continuation: lambda.continuation,
+        });
+    }
+    return openedScope;
+}
+/**
+ * Der vereinheitlichte Walk, iterativ ueber einen Baumcursor.
+ *
+ * Der Cursor beginnt auf der Wurzel und endet wieder dort. Besuchsreihenfolge,
+ * `depth`-Zaehlung und die Reihenfolge JEDER Faktenliste sind identisch mit
+ * der frueheren Rekursion ueber `node.children` — die Gegenprobe
+ * (`diff-walk.mjs`, siehe README) faehrt beide Wege ueber dieses Repository
+ * und vergleicht Symbole, Regionen, Chunk-IDs und Metriken Datei fuer Datei.
+ *
+ * `frameAt`/`parentTypeAt` sind nach Tiefe indiziert und ersetzen zusammen den
+ * Aufrufstapel der Rekursion samt `node.parent`. Eintraege unterhalb der
+ * aktuellen Tiefe sind veraltet, werden aber vor jedem Lesen ueberschrieben.
+ */
+function walkWithCursor(cursor, rootType, rootFrame, profile, ctx, fileId, out) {
+    if (!cursor.gotoFirstChild())
+        return;
+    const frameAt = [rootFrame, rootFrame];
+    const parentTypeAt = [rootType, rootType];
+    let depth = 1;
+    for (;;) {
+        const frame = frameAt[depth];
+        const parentType = parentTypeAt[depth];
+        const nodeType = cursor.nodeType;
+        const range = rangeOfCursor(cursor, ctx);
+        out.nodeKinds.push({ kind: nodeType, depth, symbolScopeId: frame.scopeId });
+        let descended = false;
+        if (profile.commentKinds.has(nodeType)) {
+            out.comments.push(commentRangeOfCursor(cursor, ctx));
+        }
+        else if (profile.typeKeywordParentKinds.has(parentType)) {
+            // Ein Typschluessselwort-Blatt (z. B. das `string`/`number`/`void`-Kind
+            // von `predefined_type`): dieselben Namen wie Literale, aber Typsyntax,
+            // kein Wert. Weiter in `nodeKinds` gezaehlt (oben), nie als
+            // Operator/Operand/Literal/Bezeichner. Muss VOR dem Literalcontainer
+            // unten stehen: das Kind fuer das Typschluesselwort `string` hat den
+            // Knotentyp "string" — genau denselben wie ein echtes Zeichenkettenliteral.
+        }
+        else if (profile.literalContainerKinds.has(nodeType)) {
+            const text = cursor.nodeText;
+            out.operands.push({ text, range, symbolScopeId: frame.scopeId });
+            out.literals.push({
+                raw: text,
+                literalKind: profile.containerLiteralKind(nodeType),
+                range,
+                symbolScopeId: frame.scopeId,
+            });
+        }
+        else if (!cursor.gotoFirstChild()) {
+            // Der Cursor kennt kein `childCount`: der fehlgeschlagene Abstieg IST
+            // die Blattpruefung, und er hat die Position nicht veraendert.
+            classifyAndRecordLeaf(cursor, nodeType, parentType, range, frame, profile, out);
+        }
+        else {
+            cursor.gotoParent(); // zurueck auf den inneren Knoten selbst
+            const childFrame = visitInnerNode(cursor, nodeType, range, frame, profile, ctx, fileId, out);
+            cursor.gotoFirstChild();
+            depth += 1;
+            frameAt[depth] = childFrame ?? frame;
+            parentTypeAt[depth] = nodeType;
+            descended = true;
+        }
+        if (descended)
+            continue;
+        // Aufsteigen, bis ein Geschwisterknoten da ist. Tiefe 1 ohne Geschwister
+        // heisst: die Kinder der Wurzel sind abgearbeitet.
+        while (!cursor.gotoNextSibling()) {
+            if (depth === 1)
+                return;
+            cursor.gotoParent();
+            depth -= 1;
+        }
+    }
+}
+/** Runs the single unified walk over a file's root node. */
+export function analyzeTree(root, ctx, fileId, profile) {
+    const out = {
+        symbolScopes: [],
+        decisions: [],
+        nestingEvents: [],
+        operators: [],
+        operands: [],
+        nodeKinds: [],
+        comments: [],
+        identifiers: [],
+        literals: [],
+        imports: [],
+        calls: [],
+    };
+    // EIN Cursor fuer alles: er beginnt auf der Wurzel, und nur ein von der
+    // Wurzel her abgestiegener Cursor meldet Knotentypen verlaesslich (siehe
+    // `fingerprint.ts`, Punkt 2). Jede Hilfsfunktion, die ihn bewegt, gibt ihn
+    // an der Ausgangsposition zurueck.
+    const cursor = root.walk();
+    const fileScopeNode = {
+        scopeId: fileId,
+        kind: "file",
+        name: "",
+        qualifiedName: "",
+        range: rangeOf(root, ctx),
+        normalizedSignature: "",
+        exportedNames: [],
+        executable: true,
+        astHash: computeAstHash(cursor, profile),
+        tokenFingerprint: computeTokenFingerprint(cursor, profile),
+        node: root,
+        children: [],
+    };
+    const rootFrame = {
+        scopeId: fileId,
+        qualifiedName: "",
+        executable: true,
+        scopeNode: fileScopeNode,
+        childOrdinalCounters: new Map(),
+    };
+    out.symbolScopes.push(toSymbolScopeFact(rootFrame, undefined));
+    walkWithCursor(cursor, root.type, rootFrame, profile, ctx, fileId, out);
+    const facts = {
+        symbolScopes: out.symbolScopes,
+        decisions: out.decisions,
+        nestingEvents: out.nestingEvents,
+        operators: out.operators,
+        operands: out.operands,
+        nodeKinds: out.nodeKinds,
+        comments: out.comments,
+        identifiers: out.identifiers,
+        literals: out.literals,
+        // Leer AN DIESER STELLE mit Absicht: die Parse-Diagnosen entstehen in
+        // `parse()` und werden in `create-adapter.ts#getAnalysis` eingesetzt,
+        // bevor die Facts den Adapter verlassen. Wer diese Zeile als "sowieso
+        // immer leer" liest, hat den falschen Ausschnitt vor sich.
+        parseDiagnostics: [],
+    };
+    return { scopeTree: fileScopeNode, facts, imports: out.imports, calls: out.calls };
+}
+//# sourceMappingURL=engine.js.map

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

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

package/dist/languages/shared/extract-symbols.d.ts

@@ -0,0 +1,5 @@
+import type { ExtractedSymbol } from "@untangle-code/domain";
+import type { ScopeNode } from "./scope-model.js";
+/** Flattens the scope tree (excluding the synthetic file-level root) into `ExtractedSymbol[]`, document order. */
+export declare function extractedSymbolsOf(fileScope: ScopeNode): ExtractedSymbol[];
+//# sourceMappingURL=extract-symbols.d.ts.map

package/dist/languages/shared/extract-symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-symbols.d.ts","sourceRoot":"","sources":["../../../src/languages/shared/extract-symbols.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAqBlD,kHAAkH;AAClH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,eAAe,EAAE,CAU1E"}

package/dist/languages/shared/extract-symbols.js

@@ -0,0 +1,31 @@
+function toExtractedSymbol(scope) {
+    return {
+        name: scope.name,
+        qualifiedName: scope.qualifiedName,
+        kind: scope.kind,
+        ...(scope.signature !== undefined ? { signature: scope.signature } : {}),
+        normalizedSignature: scope.normalizedSignature,
+        range: scope.range,
+        ...(scope.docRange !== undefined ? { docRange: scope.docRange } : {}),
+        ...(scope.parentQualifiedName !== undefined
+            ? { parentQualifiedName: scope.parentQualifiedName }
+            : {}),
+        exportedNames: scope.exportedNames,
+        ...(scope.visibility !== undefined ? { visibility: scope.visibility } : {}),
+        astHash: scope.astHash,
+        tokenFingerprint: scope.tokenFingerprint,
+    };
+}
+/** Flattens the scope tree (excluding the synthetic file-level root) into `ExtractedSymbol[]`, document order. */
+export function extractedSymbolsOf(fileScope) {
+    const symbols = [];
+    const visit = (scope) => {
+        for (const child of scope.children) {
+            symbols.push(toExtractedSymbol(child));
+            visit(child);
+        }
+    };
+    visit(fileScope);
+    return symbols;
+}
+//# sourceMappingURL=extract-symbols.js.map

package/dist/languages/shared/extract-symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-symbols.js","sourceRoot":"","sources":["../../../src/languages/shared/extract-symbols.ts"],"names":[],"mappings":"AAIA,SAAS,iBAAiB,CAAC,KAAgB;IACzC,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;QAC9C,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,KAAK,CAAC,mBAAmB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,EAAE;YACpD,CAAC,CAAC,EAAE,CAAC;QACP,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;KACzC,CAAC;AACJ,CAAC;AAED,kHAAkH;AAClH,MAAM,UAAU,kBAAkB,CAAC,SAAoB;IACrD,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,KAAgB,EAAQ,EAAE;QACvC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;YACvC,KAAK,CAAC,KAAK,CAAC,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,SAAS,CAAC,CAAC;IACjB,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { LanguageProfile } from "./profile.js";
+import type { SyntaxCursor } from "./syntax.js";
+/** Cursor MUSS auf dem Knoten stehen; er steht danach wieder dort. */
+export declare function computeAstHash(cursor: SyntaxCursor, profile: LanguageProfile): string;
+/** Cursor MUSS auf dem Knoten stehen; er steht danach wieder dort. */
+export declare function computeTokenFingerprint(cursor: SyntaxCursor, profile: LanguageProfile): string;
+//# sourceMappingURL=fingerprint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../../src/languages/shared/fingerprint.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA4BhD,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAErF;AAoBD,sEAAsE;AACtE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAI9F"}

package/dist/languages/shared/fingerprint.js

@@ -0,0 +1,95 @@
+/**
+ * Symbol fingerprints for change matching (spec.md §17.3).
+ *
+ * `astHash` — a structural fingerprint: the SHA-256 of a parenthesized
+ * `kind(child,child,...)` shape string built from node TYPES only (never
+ * identifier/literal text, never whitespace/positions). Two symbols with the
+ * same shape but renamed identifiers or reformatted whitespace hash
+ * identically — this is `spec.md §17.3` step 3 ("identischer
+ * AST-Fingerprint").
+ *
+ * `tokenFingerprint` — a lexical fingerprint: the SHA-256 of every leaf
+ * token's literal TEXT, in source order, joined by U+001F. Unlike
+ * `astHash`, a rename DOES change this fingerprint, but formatting
+ * (whitespace-only changes) does not, matching `spec.md §17.3` step 4's
+ * "Token-/MinHash-Ähnlichkeit" input.
+ *
+ * Both exclude comments (a doc-comment edit must not look like a structural
+ * or lexical change to the symbol it documents).
+ *
+ * TRAVERSIERUNG (WP-95): beide Funktionen bekommen den CURSOR des laufenden
+ * Walks und laufen den Teilbaum ab der aktuellen Position ab; sie geben ihn
+ * an genau dieser Position zurueck. Zwei Gruende, keiner davon Geschmack:
+ *
+ *  1) Tempo. Sie laufen nicht einmal je Datei, sondern einmal je Scope UND
+ *     einmal je Wurzel — der Teilbaum eines verschachtelten Symbols wird also
+ *     so oft durchlaufen, wie er Scopes ueber sich hat. Ueber `.children`
+ *     hiesse das ein Wrapper-Array je Knoten und Durchlauf.
+ *
+ *  2) RICHTIGKEIT, und das wiegt schwerer. `tree-sitter@0.21.1` meldet den
+ *     Typ eines Knotens NUR dann verlaesslich, wenn der Cursor von der Wurzel
+ *     her abgestiegen ist. Weder `node.children` noch ein auf einen Teilbaum
+ *     zurueckgesetzter Cursor (`node.walk()`) haben den Alias-Zusammenhang
+ *     des Elternknotens; in diesem Repository meldeten beide 1.411
+ *     Kommentarknoten in 207 Dateien als `interface_body`. Genau diese
+ *     Knoten hat der frueher hier stehende `.children`-Lauf NICHT als
+ *     Kommentar erkannt und ihren Text in beide Fingerabdruecke geschrieben —
+ *     entgegen der Zusage zwei Absaetze weiter oben. Wer diese Funktionen
+ *     wieder auf `node.walk()` umstellt, baut den Defekt neu ein.
+ */
+import { sha256Hex } from "@untangle-code/domain";
+/**
+ * Baut die Formzeichenkette fuer den Knoten, auf dem der Cursor steht, und
+ * laesst den Cursor GENAU DORT zurueck: jede `gotoFirstChild`-Bewegung wird
+ * von einem `gotoParent` aufgewogen. Wer das verletzt, verschiebt die
+ * Traversierung des Aufrufers.
+ */
+function structuralShapeAt(cursor, profile) {
+    const type = cursor.nodeType;
+    if (profile.commentKinds.has(type))
+        return "";
+    if (profile.literalContainerKinds.has(type))
+        return type;
+    if (!cursor.gotoFirstChild())
+        return type; // entspricht node.childCount === 0
+    const childShapes = [];
+    do {
+        // Kommentarkinder werden AUSGELASSEN, nicht als "" aufgenommen — genau
+        // das tat das frueher vorgeschaltete
+        // `.filter((child) => child.type !== "comment")`.
+        if (!profile.commentKinds.has(cursor.nodeType)) {
+            childShapes.push(structuralShapeAt(cursor, profile));
+        }
+    } while (cursor.gotoNextSibling());
+    cursor.gotoParent();
+    return `${type}(${childShapes.join(",")})`;
+}
+/** Cursor MUSS auf dem Knoten stehen; er steht danach wieder dort. */
+export function computeAstHash(cursor, profile) {
+    return sha256Hex(structuralShapeAt(cursor, profile));
+}
+/** Sammelt die Blatttexte; laesst den Cursor auf dem Ausgangsknoten zurueck. */
+function collectLeafTextsAt(cursor, profile, out) {
+    const type = cursor.nodeType;
+    if (profile.commentKinds.has(type))
+        return;
+    if (profile.literalContainerKinds.has(type)) {
+        out.push(cursor.nodeText);
+        return;
+    }
+    if (!cursor.gotoFirstChild()) {
+        out.push(cursor.nodeText); // entspricht node.childCount === 0
+        return;
+    }
+    do {
+        collectLeafTextsAt(cursor, profile, out);
+    } while (cursor.gotoNextSibling());
+    cursor.gotoParent();
+}
+/** Cursor MUSS auf dem Knoten stehen; er steht danach wieder dort. */
+export function computeTokenFingerprint(cursor, profile) {
+    const tokens = [];
+    collectLeafTextsAt(cursor, profile, tokens);
+    return sha256Hex(tokens.join("\u001f"));
+}
+//# sourceMappingURL=fingerprint.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../../src/languages/shared/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAKlD;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,MAAoB,EAAE,OAAwB;IACvE,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7B,IAAI,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9C,IAAI,OAAO,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE;QAAE,OAAO,IAAI,CAAC,CAAC,mCAAmC;IAE9E,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,GAAG,CAAC;QACF,uEAAuE;QACvE,qCAAqC;QACrC,kDAAkD;QAClD,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,QAAQ,MAAM,CAAC,eAAe,EAAE,EAAE;IACnC,MAAM,CAAC,UAAU,EAAE,CAAC;IAEpB,OAAO,GAAG,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,MAAoB,EAAE,OAAwB;IAC3E,OAAO,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,gFAAgF;AAChF,SAAS,kBAAkB,CAAC,MAAoB,EAAE,OAAwB,EAAE,GAAa;IACvF,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7B,IAAI,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO;IAC3C,IAAI,OAAO,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;QAC7B,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,mCAAmC;QAC9D,OAAO;IACT,CAAC;IACD,GAAG,CAAC;QACF,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC,QAAQ,MAAM,CAAC,eAAe,EAAE,EAAE;IACnC,MAAM,CAAC,UAAU,EAAE,CAAC;AACtB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,uBAAuB,CAAC,MAAoB,EAAE,OAAwB;IACpF,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/languages/shared/grammar-loader.d.ts

@@ -0,0 +1,15 @@
+import type { TsLanguage, TsParserCtor } from "./tree-sitter-types.js";
+/** Lazily requires the native `tree-sitter` Parser constructor (once per process). */
+export declare function loadParserCtor(): TsParserCtor;
+/** Which grammar module a dialect is loaded from, and how to reach the language export. */
+export interface GrammarSource {
+    /** npm module to `require` lazily. */
+    moduleName: "tree-sitter-typescript" | "tree-sitter-javascript";
+    /** Property on the required module holding the `Language`, or `undefined` for the module's default export itself. */
+    exportName?: "typescript" | "tsx";
+}
+/** Lazily requires and caches a single grammar `Language` handle. */
+export declare function loadGrammar(source: GrammarSource): TsLanguage;
+/** Test-only: clears caches so grammar-loading behavior can be re-exercised. */
+export declare function resetGrammarCachesForTests(): void;
+//# sourceMappingURL=grammar-loader.d.ts.map

package/dist/languages/shared/grammar-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar-loader.d.ts","sourceRoot":"","sources":["../../../src/languages/shared/grammar-loader.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMvE,sFAAsF;AACtF,wBAAgB,cAAc,IAAI,YAAY,CAK7C;AAED,2FAA2F;AAC3F,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,UAAU,EAAE,wBAAwB,GAAG,wBAAwB,CAAC;IAChE,qHAAqH;IACrH,UAAU,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC;CACnC;AAQD,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAa7D;AAED,gFAAgF;AAChF,wBAAgB,0BAA0B,IAAI,IAAI,CAGjD"}