@lzehrung/codegraph 2.3.30 → 2.4.0

package/dist/util/dynamic-import-tables.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Per-language dynamic-import adapters for the runner in `./specifiers.js`.
+ *
+ * The runner and the shared constant-path fold stay in `./specifiers.js`; this module owns
+ * only the per-language call shapes and the path-fold profiles they name. The runner builds
+ * the table once and injects its fold implementations (`DynamicImportFoldHelpers`), so the
+ * two modules never import each other at runtime and no cycle forms.
+ */
+/** Root a folded constant path is resolved against: the file's directory, the file itself,
+ * or the project root. */
+export type DynamicBase = "fileDir" | "filePath" | "project";
+/** A folded constant path: one rooted base plus its literal segments. */
+export type FoldedPath = {
+    base: DynamicBase;
+    segments: string[];
+};
+/** Resolves a folded path against the root its base names. */
+export type FoldedPathResolver = (folded: FoldedPath, fromFile: string, projectRoot: string) => string | null;
+/**
+ * Per-language inputs to the shared constant-path fold: the base tokens that root a computed
+ * path and the join-style helper calls that combine a base with literal segments. Tokens are
+ * compared after whitespace removal, so `dirname(__FILE__)` and `process.cwd()` fold like
+ * identifiers. Languages without a concatenation operator only fold join-helper arguments.
+ */
+export type PathFoldProfile = {
+    bases: Readonly<Record<string, DynamicBase>>;
+    joinHelpers: readonly string[];
+    /** Top-level concatenation operator between constant parts (PHP `.`). */
+    concat?: string;
+};
+export type DynamicImportPreparation = {
+    /** Python importlib alias tables collected once per file. */
+    pythonImportlibAliases?: Set<string>;
+    pythonImportModuleAliases?: Set<string>;
+};
+export type DynamicImportShapeContext = {
+    /** The text the shape's pattern ran over (comment-blanked for the JS family). */
+    text: string;
+    match: RegExpMatchArray;
+    fromFile: string;
+    projectRoot: string;
+    preparation: DynamicImportPreparation;
+};
+export type DynamicImportCallShape = {
+    /** Pattern over the entry's matching text; capture 1 holds the foldable argument, or the
+     * fold reads the argument from the match end (Python's escape-aware literal reader). */
+    pattern: RegExp;
+    fold: (context: DynamicImportShapeContext) => string | null;
+};
+export type DynamicImportEntry = {
+    /** Matching text, blanking comments through the shared trivia lexer where needed; string
+     * literals stay intact so folds can read their contents. */
+    text: (source: string) => string;
+    /** Non-code guard over the matching text; matches starting inside trivia are skipped. */
+    guard: (text: string) => Uint8Array | undefined;
+    /** Per-file preparation, evaluated once per extraction. */
+    prepare?: (source: string) => DynamicImportPreparation;
+    shapes: readonly DynamicImportCallShape[];
+};
+/**
+ * The shared fold implementation `./specifiers.js` injects. Keeping these as parameters rather
+ * than importing them is what keeps the entries here independent of the runner module.
+ */
+export type DynamicImportFoldHelpers = {
+    /** Builds a shape fold that reads capture 1 as a constant path and resolves the fold. */
+    foldCapturedPath: (profile: PathFoldProfile, resolve: FoldedPathResolver) => (context: DynamicImportShapeContext) => string | null;
+    /** Folds a `new URL("...", import.meta.url)` argument list. */
+    foldNewUrlArgument: (argText: string, profile: PathFoldProfile) => FoldedPath | null;
+    resolveFoldedPathAgainstBase: FoldedPathResolver;
+    /** Resolves against the containing file's directory regardless of the named base. */
+    resolveFoldedPathAgainstFileDir: (folded: FoldedPath, fromFile: string) => string | null;
+    /** Resolves by concatenation onto the containing file's directory. */
+    resolveFoldedPathByConcatenation: (folded: FoldedPath, fromFile: string) => string | null;
+    /** Folds a Python dynamic-import call into a static module string. */
+    foldPythonDynamicModuleArgument: (source: string, match: RegExpMatchArray, preparation: DynamicImportPreparation) => string | null;
+    /** Collects the importlib alias tables a Python file's dynamic-import calls may use. */
+    collectPythonDynamicImportAliases: (source: string) => {
+        importlibAliases: Set<string>;
+        importModuleAliases: Set<string>;
+    };
+};
+/**
+ * Builds the dynamic-import adapter table keyed by registered language id. Callers supply the
+ * shared fold implementation; the per-file preparation and matching rules stay here with the
+ * language that needs them.
+ */
+export declare function createDynamicImportEntries(folds: DynamicImportFoldHelpers): Readonly<Partial<Record<string, DynamicImportEntry>>>;
+//# sourceMappingURL=dynamic-import-tables.d.ts.map

package/dist/util/dynamic-import-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-import-tables.d.ts","sourceRoot":"","sources":["../../src/util/dynamic-import-tables.ts"],"names":[],"mappings":"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"}

package/dist/util/dynamic-import-tables.js

@@ -0,0 +1,100 @@
+import { buildJsLikeLiteralMask, stripJsLikeComments } from "./comments.js";
+import { PYTHON_IDENTIFIER_SOURCE } from "./identifiers.js";
+import { buildTriviaMask } from "./trivia.js";
+const JS_PATH_FOLD_PROFILE = {
+    bases: {
+        __dirname: "fileDir",
+        __filename: "filePath",
+        "import.meta.url": "filePath",
+        "process.cwd()": "project",
+    },
+    joinHelpers: ["path.join", "path.resolve"],
+};
+const RUBY_PATH_FOLD_PROFILE = {
+    bases: { __dir__: "fileDir" },
+    joinHelpers: ["File.join"],
+};
+const PHP_PATH_FOLD_PROFILE = {
+    bases: { __DIR__: "fileDir", "dirname(__FILE__)": "fileDir" },
+    joinHelpers: [],
+    concat: ".",
+};
+const JS_DYNAMIC_PATH_CALL_PATTERN = /(?<!["'`])\b(?:require|import)\s*\(\s*(path\.(?:join|resolve)\s*\((?:[^()]|\([^()]*\))*\))\s*\)/g;
+const JS_DYNAMIC_URL_CALL_PATTERN = /(?<!["'`])\b(?:require|import)\s*\(\s*(new\s+URL\s*\([^)]*\))\s*\)/g;
+const RUBY_REQUIRE_FILE_JOIN_PATTERN = /(?<![\p{XID_Continue}])require\s*\(?\s*(File\.join\s*\((?:[^()]|\([^()]*\))*\))/gu;
+const PHP_COMPUTED_INCLUDE_PATTERN = /(?<![\p{XID_Continue}$])(?:include_once|include|require_once|require)\b\s*\(?\s*([^;\r\n]*?)\s*\)?\s*;/gu;
+const PYTHON_DYNAMIC_CALL_PREFIX_PATTERN = new RegExp(String.raw `(?<![._\p{XID_Continue}])(${PYTHON_IDENTIFIER_SOURCE})(?:\s*\.\s*(${PYTHON_IDENTIFIER_SOURCE}))?\s*\(\s*(?:name\s*=\s*)?`, "gmu");
+/**
+ * Builds the dynamic-import adapter table keyed by registered language id. Callers supply the
+ * shared fold implementation; the per-file preparation and matching rules stay here with the
+ * language that needs them.
+ */
+export function createDynamicImportEntries(folds) {
+    const JS_TS_DYNAMIC_IMPORT_ENTRY = {
+        // Comments are blanked before matching so a `require(...)` inside a comment cannot match;
+        // string literals stay intact because the fold reads their contents.
+        text: stripJsLikeComments,
+        guard: buildJsLikeLiteralMask,
+        shapes: [
+            {
+                pattern: JS_DYNAMIC_PATH_CALL_PATTERN,
+                fold: folds.foldCapturedPath(JS_PATH_FOLD_PROFILE, folds.resolveFoldedPathAgainstBase),
+            },
+            {
+                pattern: JS_DYNAMIC_URL_CALL_PATTERN,
+                fold: ({ match, fromFile }) => {
+                    const folded = folds.foldNewUrlArgument(match[1] ?? "", JS_PATH_FOLD_PROFILE);
+                    return folded ? folds.resolveFoldedPathAgainstFileDir(folded, fromFile) : null;
+                },
+            },
+        ],
+    };
+    const RUBY_DYNAMIC_IMPORT_ENTRY = {
+        text: (source) => source,
+        guard: (text) => buildTriviaMask(text, "ruby"),
+        shapes: [
+            {
+                // Only the computed `require File.join(__dir__, ...)` form is folded here; bare-string
+                // requires flow through the static pipeline and `$LOAD_PATH` lookups stay external.
+                pattern: RUBY_REQUIRE_FILE_JOIN_PATTERN,
+                fold: folds.foldCapturedPath(RUBY_PATH_FOLD_PROFILE, folds.resolveFoldedPathByConcatenation),
+            },
+        ],
+    };
+    const PHP_DYNAMIC_IMPORT_ENTRY = {
+        text: (source) => source,
+        guard: (text) => buildTriviaMask(text, "php"),
+        shapes: [
+            {
+                // Computed `include`/`require` whose path is a constant chain rooted at `__DIR__` (or
+                // the legacy `dirname(__FILE__)`); plain string operands stay with the static pipeline
+                // and the include-path search stays external.
+                pattern: PHP_COMPUTED_INCLUDE_PATTERN,
+                fold: folds.foldCapturedPath(PHP_PATH_FOLD_PROFILE, folds.resolveFoldedPathByConcatenation),
+            },
+        ],
+    };
+    const PYTHON_DYNAMIC_IMPORT_ENTRY = {
+        text: (source) => source,
+        guard: (text) => buildTriviaMask(text, "python"),
+        prepare: (source) => {
+            const { importlibAliases, importModuleAliases } = folds.collectPythonDynamicImportAliases(source);
+            return { pythonImportlibAliases: importlibAliases, pythonImportModuleAliases: importModuleAliases };
+        },
+        shapes: [
+            {
+                pattern: PYTHON_DYNAMIC_CALL_PREFIX_PATTERN,
+                fold: ({ text, match, preparation }) => folds.foldPythonDynamicModuleArgument(text, match, preparation),
+            },
+        ],
+    };
+    const entries = {
+        js: JS_TS_DYNAMIC_IMPORT_ENTRY,
+        ts: JS_TS_DYNAMIC_IMPORT_ENTRY,
+        python: PYTHON_DYNAMIC_IMPORT_ENTRY,
+        ruby: RUBY_DYNAMIC_IMPORT_ENTRY,
+        php: PHP_DYNAMIC_IMPORT_ENTRY,
+    };
+    return entries;
+}
+//# sourceMappingURL=dynamic-import-tables.js.map

package/dist/util/dynamic-import-tables.js.map

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

package/dist/util/graph-edges.d.ts

@@ -1,5 +1,23 @@
 import type { Edge } from "../types.js";
-export declare function edgeKey(edge: Edge): string;
+/**
+ * Specifier fields that identify a file-dependency edge.
+ * `from` is the specifier text stored as `raw` when `raw` is omitted.
+ */
+export type EdgeImportSource = {
+    from: string;
+    raw?: string;
+    typeOnly?: boolean;
+    includeForm?: Edge["includeForm"];
+};
+/**
+ * Rebuilds a file-dependency edge from an {@link EdgeImportSource}.
+ * Import bindings and deleted-file snapshots both use this so `raw`, type-only,
+ * and C/C++ `includeForm` stay on the edge. Angle and quoted includes of one
+ * header must not collapse.
+ */
+export declare function edgeFromImportBinding(from: string, to: Edge["to"], source: EdgeImportSource): Edge;
+/** Shared identity for collection, project assembly, delta, and drift comparison. */
+export declare function edgeKey(edge: Edge, rawIsIdentity?: boolean, filePath?: (file: string) => string): string;
 export declare function compareEdges(left: Edge, right: Edge): number;
 export declare function toRelativeEdge(projectRoot: string, edge: Edge): Edge;
 //# sourceMappingURL=graph-edges.d.ts.map

package/dist/util/graph-edges.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-edges.d.ts","sourceRoot":"","sources":["../../src/util/graph-edges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAI1C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,CAe5D;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAepE"}
+{"version":3,"file":"graph-edges.d.ts","sourceRoot":"","sources":["../../src/util/graph-edges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;CACnC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CASlG;AAMD,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,UAAO,EAAE,QAAQ,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAuB,GAAG,MAAM,CAMrH;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,CAiB5D;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAgBpE"}

package/dist/util/graph-edges.js

@@ -1,8 +1,30 @@
 import { toProjectDisplayPath } from "./paths.js";
-export function edgeKey(edge) {
-    const toKey = edge.to.type === "file" ? `file:${edge.to.path}` : `external:${edge.to.name}`;
+/**
+ * Rebuilds a file-dependency edge from an {@link EdgeImportSource}.
+ * Import bindings and deleted-file snapshots both use this so `raw`, type-only,
+ * and C/C++ `includeForm` stay on the edge. Angle and quoted includes of one
+ * header must not collapse.
+ */
+export function edgeFromImportBinding(from, to, source) {
+    const { includeForm } = source;
+    return {
+        from,
+        to,
+        raw: source.raw ?? source.from,
+        ...(source.typeOnly ? { typeOnly: source.typeOnly } : {}),
+        ...(includeForm ? { includeForm } : {}),
+    };
+}
+function storedFilePath(file) {
+    return file;
+}
+/** Shared identity for collection, project assembly, delta, and drift comparison. */
+export function edgeKey(edge, rawIsIdentity = true, filePath = storedFilePath) {
+    const from = filePath(edge.from);
+    const target = edge.to.type === "file" ? filePath(edge.to.path) : edge.to.name;
+    const raw = rawIsIdentity ? edge.raw : "";
     const typeOnly = edge.typeOnly ? "1" : "0";
-    return `${edge.from}|${toKey}|${edge.raw}|${typeOnly}`;
+    return `${from}\0${edge.to.type}\0${target}\0${raw}\0${typeOnly}\0${edge.includeForm ?? ""}`;
 }
 export function compareEdges(left, right) {
     const fromCompare = left.from.localeCompare(right.from);
@@ -21,7 +43,10 @@ export function compareEdges(left, right) {
         return rawCompare;
     const leftTypeOnly = left.typeOnly ? 1 : 0;
     const rightTypeOnly = right.typeOnly ? 1 : 0;
-    return leftTypeOnly - rightTypeOnly;
+    const typeCompare = leftTypeOnly - rightTypeOnly;
+    if (typeCompare)
+        return typeCompare;
+    return (left.includeForm ?? "").localeCompare(right.includeForm ?? "");
 }
 export function toRelativeEdge(projectRoot, edge) {
     const from = toProjectDisplayPath(projectRoot, edge.from);
@@ -37,6 +62,7 @@ export function toRelativeEdge(projectRoot, edge) {
         to,
         raw: edge.raw,
         ...(edge.typeOnly ? { typeOnly: edge.typeOnly } : {}),
+        ...(edge.includeForm ? { includeForm: edge.includeForm } : {}),
     };
 }
 //# sourceMappingURL=graph-edges.js.map

package/dist/util/graph-edges.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph-edges.js","sourceRoot":"","sources":["../../src/util/graph-edges.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,UAAU,OAAO,CAAC,IAAU;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IAC5F,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3C,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG,IAAI,QAAQ,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAU,EAAE,KAAW;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;IACrE,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC;IACzE,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,YAAY,GAAG,aAAa,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,WAAmB,EAAE,IAAU;IAC5D,MAAM,IAAI,GAAG,oBAAoB,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACjB,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,EAAE,GAAG;YACH,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,oBAAoB,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;SACtD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI;QACJ,EAAE;QACF,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"graph-edges.js","sourceRoot":"","sources":["../../src/util/graph-edges.ts"],"names":[],"mappings":"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"}

package/dist/util/identifiers.d.ts

@@ -35,6 +35,13 @@ export declare const PHP_IDENTIFIER_SOURCE: string;
 export declare const JAVA_IDENTIFIER_IGNORABLE_SOURCE: string;
 /** C# formatting characters permitted in identifier-part-character. */
 export declare const CSHARP_IDENTIFIER_FORMAT_SOURCE: string;
+/**
+ * C# identifier equality: a verbatim `@` prefix and formatting characters (Cf) do not change
+ * the identifier, so `@P` and `P` name the same namespace, type, or member.
+ */
+export declare function normalizeCsharpIdentifier(name: string): string;
+/** Normalizes each dotted segment of a C# namespace or type path; a `global::` prefix is kept. */
+export declare function normalizeCsharpQualifiedName(text: string): string;
 /**
  * Java identifiers (`Character.isJavaIdentifierStart`/`isJavaIdentifierPart`) permit a
  * Unicode letter (Lu/Ll/Lt/Lm/Lo), a letter-number (Nl, e.g. Roman numerals), a currency
@@ -66,4 +73,12 @@ export declare const GO_IDENTIFIER_SOURCE: string;
  * (No), and combining marks are not part of the Kotlin grammar.
  */
 export declare const KOTLIN_IDENTIFIER_SOURCE: string;
+/**
+ * ASCII-only case fold for a PHP identifier. PHP resolves class, interface, trait, and
+ * function names case-insensitively but only across the ASCII range; non-ASCII bytes in a
+ * PHP identifier are passed through unchanged. Shared by PHP name comparison and by the
+ * bloom filter, which stores both a PHP file's raw identifier spellings and their folded
+ * form so a case-variant reference can still be probed with a single folded lookup.
+ */
+export declare function foldPhpIdentifierCase(value: string): string;
 //# sourceMappingURL=identifiers.d.ts.map

package/dist/util/identifiers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identifiers.d.ts","sourceRoot":"","sources":["../../src/util/identifiers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,iBAAiB,UAAQ,GAAG,OAAO,CAMtF;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,QAAqE,CAAC;AAE/G;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,QAAiG,CAAC;AAE7I,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,QAAmD,CAAC;AAEtF,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB,QAAwB,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAuE,CAAC;AAE1G;;;GAGG;AACH,eAAO,MAAM,gCAAgC,QAA4D,CAAC;AAE1G,uEAAuE;AACvE,eAAO,MAAM,+BAA+B,QAAqB,CAAC;AAElE;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,QAAuH,CAAC;AAE3J;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,QAAwG,CAAC;AAE9I;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,QAAsC,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,QAAsC,CAAC"}
+{"version":3,"file":"identifiers.d.ts","sourceRoot":"","sources":["../../src/util/identifiers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,iBAAiB,UAAQ,GAAG,OAAO,CAMtF;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,QAAqE,CAAC;AAE/G;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,QAAiG,CAAC;AAE7I,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,QAAmD,CAAC;AAEtF,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB,QAAwB,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAuE,CAAC;AAE1G;;;GAGG;AACH,eAAO,MAAM,gCAAgC,QAA4D,CAAC;AAE1G,uEAAuE;AACvE,eAAO,MAAM,+BAA+B,QAAqB,CAAC;AAIlE;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED,kGAAkG;AAClG,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,QAAuH,CAAC;AAE3J;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,QAAwG,CAAC;AAE9I;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,QAAsC,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,QAAsC,CAAC;AAE5E;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO3D"}

package/dist/util/identifiers.js

@@ -42,6 +42,26 @@ export const PHP_IDENTIFIER_SOURCE = String.raw `[A-Za-z_\u{80}-\u{10FFFF}][A-Za
 export const JAVA_IDENTIFIER_IGNORABLE_SOURCE = String.raw `\p{Cf}\u0000-\u0008\u000E-\u001B\u007F-\u009F`;
 /** C# formatting characters permitted in identifier-part-character. */
 export const CSHARP_IDENTIFIER_FORMAT_SOURCE = String.raw `\p{Cf}`;
+const CSHARP_IDENTIFIER_FORMAT_PATTERN = new RegExp(`[${CSHARP_IDENTIFIER_FORMAT_SOURCE}]`, "gu");
+/**
+ * C# identifier equality: a verbatim `@` prefix and formatting characters (Cf) do not change
+ * the identifier, so `@P` and `P` name the same namespace, type, or member.
+ */
+export function normalizeCsharpIdentifier(name) {
+    const withoutVerbatimPrefix = name.startsWith("@") ? name.slice(1) : name;
+    return hasNonAsciiCodePoint(withoutVerbatimPrefix)
+        ? withoutVerbatimPrefix.replace(CSHARP_IDENTIFIER_FORMAT_PATTERN, "")
+        : withoutVerbatimPrefix;
+}
+/** Normalizes each dotted segment of a C# namespace or type path; a `global::` prefix is kept. */
+export function normalizeCsharpQualifiedName(text) {
+    const compact = text.replace(/\s+/gu, "");
+    const globalPrefix = compact.startsWith("global::") ? "global::" : "";
+    const body = compact.slice(globalPrefix.length);
+    if (!body)
+        return globalPrefix;
+    return globalPrefix + body.split(".").map(normalizeCsharpIdentifier).join(".");
+}
 /**
  * Java identifiers (`Character.isJavaIdentifierStart`/`isJavaIdentifierPart`) permit a
  * Unicode letter (Lu/Ll/Lt/Lm/Lo), a letter-number (Nl, e.g. Roman numerals), a currency
@@ -73,4 +93,19 @@ export const GO_IDENTIFIER_SOURCE = String.raw `[\p{L}_][\p{L}\p{Nd}_]*`;
  * (No), and combining marks are not part of the Kotlin grammar.
  */
 export const KOTLIN_IDENTIFIER_SOURCE = String.raw `[\p{L}_][\p{L}\p{Nd}_]*`;
+/**
+ * ASCII-only case fold for a PHP identifier. PHP resolves class, interface, trait, and
+ * function names case-insensitively but only across the ASCII range; non-ASCII bytes in a
+ * PHP identifier are passed through unchanged. Shared by PHP name comparison and by the
+ * bloom filter, which stores both a PHP file's raw identifier spellings and their folded
+ * form so a case-variant reference can still be probed with a single folded lookup.
+ */
+export function foldPhpIdentifierCase(value) {
+    let folded = "";
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        folded += code >= 65 && code <= 90 ? String.fromCharCode(code + 32) : value[index];
+    }
+    return folded;
+}
 //# sourceMappingURL=identifiers.js.map

package/dist/util/identifiers.js.map

@@ -1 +1 @@
-{"version":3,"file":"identifiers.js","sourceRoot":"","sources":["../../src/util/identifiers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,iBAAiB,GAAG,KAAK;IAC3E,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC;QAC5C,IAAI,SAAS,GAAG,IAAI,IAAI,CAAC,iBAAiB,IAAI,SAAS,IAAI,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IAChF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC,GAAG,CAAA,wDAAwD,CAAC;AAE/G;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC,GAAG,CAAA,oFAAoF,CAAC;AAE7I,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,GAAG,CAAA,sCAAsC,CAAC;AAEtF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,GAAG,CAAA,0DAA0D,CAAC;AAE1G;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,MAAM,CAAC,GAAG,CAAA,+CAA+C,CAAC;AAE1G,uEAAuE;AACvE,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC,GAAG,CAAA,QAAQ,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CAAA,sEAAsE,gCAAgC,IAAI,CAAC;AAE3J;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,GAAG,CAAA,wDAAwD,+BAA+B,IAAI,CAAC;AAE9I;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAA,yBAAyB,CAAC;AAExE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,GAAG,CAAA,yBAAyB,CAAC"}
+{"version":3,"file":"identifiers.js","sourceRoot":"","sources":["../../src/util/identifiers.ts"],"names":[],"mappings":"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"}

package/dist/util/member-access-tables.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Per-language member-access, receiver, and ancestry tables for `./member-access.ts`, keyword
+ * navigation, and the detailed graph passes. Rows are keyed by language id, following the
+ * trivia-table precedent in `./trivia-tables.ts`: walkers keep the algorithms; this table keeps
+ * the per-language node types, extraction shapes, receiver keywords, and ancestry forms.
+ *
+ * Every registered language has a row. A document, style, or data format row carries only
+ * `omittedReason`; a source-language row declares each capability it has and names a one-line
+ * reason for each capability it omits, so an omission cannot flip silently.
+ * `tests/member-access-tables.test.ts` asserts both halves and re-derives every declared node
+ * type from that language's pinned grammar.
+ */
+/** Receiver spellings that denote the type declaring the calling member, per language. */
+export type ReceiverKeywords = {
+    /** Keywords naming the type that declares the calling member. */
+    own: readonly string[];
+    /** Own-type keywords that name an instance rather than the type itself. */
+    instanceOwn: readonly string[];
+    /** Keywords naming a supertype of the declaring type. */
+    supertype: readonly string[];
+};
+/**
+ * How one child of a member-access node is extracted: by field name with a positional fallback,
+ * by plain child index, or by named-child index with a plain-child fallback.
+ */
+export type MemberAccessChild = {
+    field: string;
+    fallbackIndex: number;
+} | {
+    index: number;
+} | {
+    namedIndex: number;
+};
+export type MemberAccessShape = {
+    /**
+     * Member-access node types the shape applies to. A shape without `nodeTypes` is the language's
+     * fallback for every other member-access node and must be the last shape in its row.
+     */
+    nodeTypes?: readonly string[];
+    object: MemberAccessChild;
+    /** `{ navigation: true }` defers to `getNavigationExpressionProperty`'s navigation-suffix walk. */
+    property: MemberAccessChild | {
+        navigation: true;
+    };
+};
+export type ReceiverAncestryRelation = "extends" | "implements" | "trait" | "mixin";
+export type ReceiverAncestorClause = {
+    /** Syntax node that contains one or more declared ancestors. */
+    nodeType: string;
+    /** Detailed-graph edge label, or superclass-first classification for mixed base lists. */
+    relation: ReceiverAncestryRelation | "superclass-first";
+    /** Descend into this field before collecting ancestors. */
+    field?: string;
+    /** Treat every matching clause separately. */
+    each?: boolean;
+    /**
+     * Which ancestors a `super`/`parent`/`base` receiver may address. Own-type receivers use every
+     * declaration in the clause.
+     */
+    supertype?: "all" | "first-child" | "first-match";
+};
+export type ReceiverAncestorEmbed = {
+    body: string;
+    memberList?: string;
+    member: string;
+    typeField?: string;
+    nameless?: boolean;
+};
+export type ReceiverAncestry = {
+    clauses: readonly ReceiverAncestorClause[];
+    embeds?: readonly ReceiverAncestorEmbed[];
+    /** Call names that add mixins to the declaring type, such as Ruby `include` and `prepend`. */
+    mixinCalls?: readonly string[];
+};
+export type MemberAccessRow = {
+    /** Why the language has no member-access capability at all; only document, style, and data formats set it. */
+    omittedReason?: string;
+    /** Member-expression node type for a support whose `nodeTypes.memberExpression` capability is absent. */
+    memberExpressionType?: string;
+    /** Node types added to the shared traversal base set in `memberAccessTraversalTypes`. */
+    extraTraversalTypes?: readonly string[];
+    /** Node types added to the shared generic member-access list in `isMemberAccessNode`. */
+    extraMemberAccessTypes?: readonly string[];
+    /** Extraction shapes for `getMemberAccessParts`, tried in order before the shared generic default. */
+    memberAccessShapes?: readonly MemberAccessShape[];
+    /** Why the language declares no shapes of its own: the shared generic default is its extraction. */
+    memberAccessOmittedReason?: string;
+    /** Kotlin fallback: a degraded `navigation_suffix` leaves the property as the expression's last named child. */
+    navigationFallbackLastChild?: true;
+    /** Identifiers that name the type declaring the calling member. */
+    receiverKeywords?: ReceiverKeywords;
+    /**
+     * A receiver keyword may also be spelled as a zero-argument call to that keyword identifier
+     * (Python's `super()`, which has no bare-name form unlike `self`/`cls`). Absent for every
+     * language whose receiver keywords are always bare names.
+     */
+    receiverKeywordCallShape?: true;
+    /** Why the language declares no receiver keywords. */
+    receiverKeywordsOmittedReason?: string;
+    /** Language syntax that declares ancestors visible to own-type and supertype receivers. */
+    receiverAncestry?: ReceiverAncestry;
+    /**
+     * Member syntax can name a free function (`!isMember`): Kotlin extensions
+     * (`fun Widget.describe()`) and Go methods, which are indexed as free functions.
+     * Swift extensions, Rust methods, and C# extension methods are `isMember`, so they
+     * stay on the member path and do not set this flag.
+     */
+    memberCallNamesFreeFunction?: true;
+    /** Why a member call cannot name a free function in this language. */
+    memberCallNamesFreeFunctionOmittedReason?: string;
+};
+export declare const MEMBER_ACCESS_ROWS: Record<string, MemberAccessRow>;
+/** Every language that declares receiver keywords, guarded by the registry-consistency test. */
+export declare const receiverKeywordLanguageIds: readonly string[];
+/** Languages that emit proven receiver `calls` edges from the shared keyword table. */
+export declare function supportsReceiverCallEdges(languageId: string): boolean;
+/** Languages where goto and references require proven receivers and do not fall back to a bare name. */
+export declare function supportsReceiverMemberNavigation(languageId: string): boolean;
+export declare function keywordReceiverKind(languageId: string, receiverName: string): "own" | "supertype" | null;
+/**
+ * Instance-own keywords (`this`, `$this`) require instance members.
+ * Other own keywords name the declaring type and may still bind instance members
+ * (PHP `self::` / `static::` late static binding), so they do not force a static-only filter.
+ */
+export declare function ownReceiverMemberScope(languageId: string, receiverName: string): "instance" | "any" | null;
+export declare function isKeywordReceiver(languageId: string, receiverName: string): boolean;
+/** Whether `receiver.name()` can refer to a free function rather than only a member. */
+export declare function memberSyntaxNamesFreeFunction(languageId: string): boolean;
+//# sourceMappingURL=member-access-tables.d.ts.map

package/dist/util/member-access-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-access-tables.d.ts","sourceRoot":"","sources":["../../src/util/member-access-tables.ts"],"names":[],"mappings":"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"}