@yalehwang/archguard 0.1.31 → 0.1.32

package/dist/plugins/shared/native-parser-backend.js

@@ -0,0 +1,84 @@
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { ParserInitializationError } from './parser-backend.js';
+const require = createRequire(import.meta.url);
+const RUNTIME_MODULE = 'tree-sitter';
+const GRAMMAR_MODULES = {
+    go: 'tree-sitter-go',
+    java: 'tree-sitter-java',
+    python: 'tree-sitter-python',
+    cpp: 'tree-sitter-cpp',
+    kotlin: '@tree-sitter-grammars/tree-sitter-kotlin',
+};
+export function nativeGrammarModule(language) {
+    return GRAMMAR_MODULES[language];
+}
+export function readNativeModuleRootEnv(env = process.env) {
+    const root = env.ARCHGUARD_NATIVE_MODULE_ROOT;
+    return root && root !== '' ? root : undefined;
+}
+function moduleDefault(module) {
+    return module.default ?? module;
+}
+export function defaultNativeLoaders(moduleRoot) {
+    const scopedRequire = moduleRoot
+        ? createRequire(path.join(path.resolve(moduleRoot), 'package.json'))
+        : require;
+    return {
+        loadRuntime: () => moduleDefault(scopedRequire(RUNTIME_MODULE)),
+        loadGrammar: (language) => moduleDefault(scopedRequire(GRAMMAR_MODULES[language])),
+    };
+}
+export class NativeParserBackend {
+    runtime = 'native';
+    loaders;
+    constructor(options = {}) {
+        this.loaders = options.loaders ?? defaultNativeLoaders(readNativeModuleRootEnv());
+    }
+    async createSession(language) {
+        let parser;
+        try {
+            const Parser = this.loaders.loadRuntime();
+            parser = new Parser();
+            parser.setLanguage(this.loaders.loadGrammar(language));
+            return new NativeParserSession(language, parser);
+        }
+        catch (error) {
+            parser?.delete?.();
+            throw new ParserInitializationError(language, this.runtime, error);
+        }
+    }
+}
+class NativeParserSession {
+    language;
+    parser;
+    runtime = 'native';
+    disposed = false;
+    constructor(language, parser) {
+        this.language = language;
+        this.parser = parser;
+    }
+    parse(code) {
+        if (this.disposed)
+            throw new Error(`${this.language} parser session has been disposed`);
+        const tree = this.parser.parse(code);
+        let disposed = false;
+        return {
+            rootNode: tree.rootNode,
+            dispose() {
+                if (disposed)
+                    return;
+                disposed = true;
+                tree.delete?.();
+            },
+        };
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.parser.delete?.();
+    }
+}
+export const nativeParserBackend = new NativeParserBackend();
+//# sourceMappingURL=native-parser-backend.js.map

package/dist/plugins/shared/native-parser-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-parser-backend.js","sourceRoot":"","sources":["../../../src/plugins/shared/native-parser-backend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,cAAc,GAAG,aAAa,CAAC;AAErC,MAAM,eAAe,GAAmC;IACtD,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,kBAAkB;IACxB,MAAM,EAAE,oBAAoB;IAC5B,GAAG,EAAE,iBAAiB;IACtB,MAAM,EAAE,0CAA0C;CACnD,CAAC;AAGF,MAAM,UAAU,mBAAmB,CAAC,QAAwB;IAC1D,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AA2BD,MAAM,UAAU,uBAAuB,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC1E,MAAM,IAAI,GAAG,GAAG,CAAC,4BAA4B,CAAC;IAC9C,OAAO,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED,SAAS,aAAa,CAAI,MAA2B;IACnD,OAAQ,MAA0B,CAAC,OAAO,IAAK,MAAY,CAAC;AAC9D,CAAC;AASD,MAAM,UAAU,oBAAoB,CAAC,UAAmB;IACtD,MAAM,aAAa,GAAG,UAAU;QAC9B,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC,CAAC;QACpE,CAAC,CAAC,OAAO,CAAC;IACZ,OAAO;QACL,WAAW,EAAE,GAAG,EAAE,CAChB,aAAa,CACX,aAAa,CAAC,cAAc,CAA0B,CACxB;QAClC,WAAW,EAAE,CAAC,QAAwB,EAAE,EAAE,CACxC,aAAa,CAAC,aAAa,CAAC,eAAe,CAAC,QAAQ,CAAC,CAA0B,CAAC;KACnF,CAAC;AACJ,CAAC;AAyBD,MAAM,OAAO,mBAAmB;IACrB,OAAO,GAAG,QAAiB,CAAC;IAEpB,OAAO,CAAsB;IAE9C,YAAY,UAAsC,EAAE;QAClD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,oBAAoB,CAAC,uBAAuB,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAwB;QAC1C,IAAI,MAAgC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAkC,CAAC;YAC1E,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACtB,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;YACvD,OAAO,IAAI,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;YACnB,MAAM,IAAI,yBAAyB,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF;AAED,MAAM,mBAAmB;IAKZ;IACQ;IALV,OAAO,GAAG,QAAiB,CAAC;IAC7B,QAAQ,GAAG,KAAK,CAAC;IAEzB,YACW,QAAwB,EAChB,MAAoB;QAD5B,aAAQ,GAAR,QAAQ,CAAgB;QAChB,WAAM,GAAN,MAAM,CAAc;IACpC,CAAC;IAEJ,KAAK,CAAC,IAAY;QAChB,IAAI,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,mCAAmC,CAAC,CAAC;QACxF,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO;gBACL,IAAI,QAAQ;oBAAE,OAAO;gBACrB,QAAQ,GAAG,IAAI,CAAC;gBAChB,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YAClB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;IACzB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAC"}

package/dist/plugins/shared/parser-backend.d.ts

@@ -0,0 +1,13 @@
+import type { ParserRuntimeKind, ParserSession } from './syntax-tree.js';
+export type ParserLanguage = 'go' | 'java' | 'python' | 'cpp' | 'kotlin';
+export interface ParserBackend {
+    readonly runtime: ParserRuntimeKind;
+    createSession(language: ParserLanguage): Promise<ParserSession>;
+}
+export declare class ParserInitializationError extends Error {
+    readonly language: ParserLanguage;
+    readonly backend: string;
+    constructor(language: ParserLanguage, backend: string, cause: unknown);
+}
+export declare function resolveParserBackend(kind?: ParserRuntimeKind): Promise<ParserBackend>;
+//# sourceMappingURL=parser-backend.d.ts.map

package/dist/plugins/shared/parser-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-backend.d.ts","sourceRoot":"","sources":["../../../src/plugins/shared/parser-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEzE,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACjE;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAEhD,QAAQ,CAAC,QAAQ,EAAE,cAAc;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM;gBADf,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,MAAM,EACxB,KAAK,EAAE,OAAO;CAUjB;AAkBD,wBAAsB,oBAAoB,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CAQ3F"}

package/dist/plugins/shared/parser-backend.js

@@ -0,0 +1,38 @@
+export class ParserInitializationError extends Error {
+    language;
+    backend;
+    constructor(language, backend, cause) {
+        super(`Failed to initialize ${language} parser with ${backend} backend: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+        this.language = language;
+        this.backend = backend;
+        this.name = 'ParserInitializationError';
+    }
+}
+export async function resolveParserBackend(kind) {
+    const selected = kind ?? readRuntimeEnvOverride() ?? readBackendEnvOverride() ?? 'native';
+    if (selected === 'wasm') {
+        const { wasmParserBackend } = await import('./wasm-parser-backend.js');
+        return wasmParserBackend;
+    }
+    const { nativeParserBackend } = await import('./native-parser-backend.js');
+    return nativeParserBackend;
+}
+function readRuntimeEnvOverride() {
+    const raw = process.env.ARCHGUARD_PARSER_RUNTIME;
+    if (raw === undefined || raw === '')
+        return undefined;
+    if (raw === 'native' || raw === 'wasm')
+        return raw;
+    if (raw === 'auto')
+        return undefined;
+    throw new Error(`Invalid ARCHGUARD_PARSER_RUNTIME value "${raw}" (expected "auto", "native", or "wasm")`);
+}
+function readBackendEnvOverride() {
+    const raw = process.env.ARCHGUARD_PARSER_BACKEND;
+    if (raw === undefined || raw === '')
+        return undefined;
+    if (raw === 'native' || raw === 'wasm')
+        return raw;
+    throw new Error(`Invalid ARCHGUARD_PARSER_BACKEND value "${raw}" (expected "native" or "wasm")`);
+}
+//# sourceMappingURL=parser-backend.js.map

package/dist/plugins/shared/parser-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-backend.js","sourceRoot":"","sources":["../../../src/plugins/shared/parser-backend.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAEvC;IACA;IAFX,YACW,QAAwB,EACxB,OAAe,EACxB,KAAc;QAEd,KAAK,CACH,wBAAwB,QAAQ,gBAAgB,OAAO,aACrD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,EACF,EAAE,KAAK,EAAE,CACV,CAAC;QATO,aAAQ,GAAR,QAAQ,CAAgB;QACxB,YAAO,GAAP,OAAO,CAAQ;QASxB,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAkBD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAwB;IACjE,MAAM,QAAQ,GAAG,IAAI,IAAI,sBAAsB,EAAE,IAAI,sBAAsB,EAAE,IAAI,QAAQ,CAAC;IAC1F,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QACvE,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;IAC3E,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,SAAS,sBAAsB;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IACjD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACtD,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,GAAG,CAAC;IACnD,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,IAAI,KAAK,CACb,2CAA2C,GAAG,0CAA0C,CACzF,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IACjD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACtD,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,GAAG,CAAC;IACnD,MAAM,IAAI,KAAK,CAAC,2CAA2C,GAAG,iCAAiC,CAAC,CAAC;AACnG,CAAC"}

package/dist/plugins/shared/parser-runtime.d.ts

@@ -0,0 +1,32 @@
+import type { ParserBackend, ParserLanguage } from './parser-backend.js';
+import { type NativeModuleLoaders } from './native-parser-backend.js';
+import type { ParserRuntimeKind } from './syntax-tree.js';
+import { type ParserRuntimePolicy } from '../../types/parser-runtime.js';
+export { defaultNativeLoaders, readNativeModuleRootEnv, type NativeModuleLoaders, } from './native-parser-backend.js';
+export declare function probeNativeBinding(language: ParserLanguage, loaders?: NativeModuleLoaders): void;
+export declare function readParserRuntimePolicy(env?: NodeJS.ProcessEnv): ParserRuntimePolicy;
+export declare function hasParserRuntimeEnvOverride(env?: NodeJS.ProcessEnv): boolean;
+export type ParserRuntimeChoiceSource = 'default' | 'env' | 'config' | 'explicit';
+export interface ParserBackendSelection {
+    readonly language: ParserLanguage;
+    readonly policy: ParserRuntimePolicy;
+    readonly source: ParserRuntimeChoiceSource;
+    readonly runtime: ParserRuntimeKind;
+    readonly backend: ParserBackend;
+    readonly fallbackReason?: string;
+    readonly diagnostic: string;
+}
+export interface SelectParserBackendOptions {
+    policy?: ParserRuntimePolicy;
+    policySource?: 'config' | 'explicit';
+    nativeLoaders?: NativeModuleLoaders;
+    nativeModuleRoot?: string;
+    onDiagnostic?: (line: string, selection: ParserBackendSelection) => void;
+}
+export declare function getParserRuntimeDiagnostics(): readonly string[];
+export declare function runtimeDiagnosticVisible(verbose: boolean, selection: {
+    fallbackReason?: string;
+}): boolean;
+export declare function resetParserBackendSelectionCache(): void;
+export declare function selectParserBackendFor(language: ParserLanguage, options?: SelectParserBackendOptions): Promise<ParserBackendSelection>;
+//# sourceMappingURL=parser-runtime.d.ts.map

package/dist/plugins/shared/parser-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-runtime.d.ts","sourceRoot":"","sources":["../../../src/plugins/shared/parser-runtime.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,EAML,KAAK,mBAAmB,EAEzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAyB,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAE5F,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC;AAsBpC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,mBAAqE,GAC7E,IAAI,CA6CN;AAGD,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,mBAAmB,CAmBjG;AAGD,wBAAgB,2BAA2B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEzF;AAGD,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAC;AAElF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAErC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAEhC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAEjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,0BAA0B;IAEzC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAE7B,YAAY,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAErC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAEpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,sBAAsB,KAAK,IAAI,CAAC;CAC1E;AAMD,wBAAgB,2BAA2B,IAAI,SAAS,MAAM,EAAE,CAE/D;AAOD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACrC,OAAO,CAET;AAeD,wBAAgB,gCAAgC,IAAI,IAAI,CAIvD;AAQD,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,sBAAsB,CAAC,CAuBjC"}

package/dist/plugins/shared/parser-runtime.js

@@ -0,0 +1,152 @@
+import { ParserInitializationError } from './parser-backend.js';
+import { NativeParserBackend, defaultNativeLoaders, nativeGrammarModule, nativeParserBackend, readNativeModuleRootEnv, } from './native-parser-backend.js';
+import { isParserRuntimePolicy } from '../../types/parser-runtime.js';
+export { defaultNativeLoaders, readNativeModuleRootEnv, } from './native-parser-backend.js';
+const PROBE_FIXTURES = {
+    go: { code: 'package main\n', rootType: 'source_file' },
+    java: { code: 'class A {}\n', rootType: 'program' },
+    python: { code: 'x = 1\n', rootType: 'module' },
+    cpp: { code: 'int main() { return 0; }\n', rootType: 'translation_unit' },
+    kotlin: { code: 'fun main() {}\n', rootType: 'source_file' },
+};
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function probeNativeBinding(language, loaders = defaultNativeLoaders(readNativeModuleRootEnv())) {
+    let Runtime;
+    try {
+        Runtime = loaders.loadRuntime();
+    }
+    catch (error) {
+        throw new Error(`cannot load native tree-sitter runtime ("tree-sitter"): ${errorMessage(error)}`);
+    }
+    let grammar;
+    try {
+        grammar = loaders.loadGrammar(language);
+    }
+    catch (error) {
+        throw new Error(`cannot load native ${language} grammar ("${nativeGrammarModule(language)}"): ${errorMessage(error)}`);
+    }
+    const fixture = PROBE_FIXTURES[language];
+    let parser;
+    try {
+        parser = new Runtime();
+        parser.setLanguage(grammar);
+    }
+    catch (error) {
+        parser?.delete?.();
+        throw new Error(`cannot bind native ${language} grammar to the tree-sitter runtime (ABI incompatibility?): ${errorMessage(error)}`);
+    }
+    try {
+        const tree = parser.parse(fixture.code);
+        const rootType = tree?.rootNode?.type;
+        if (rootType !== fixture.rootType) {
+            throw new Error(`probe parsed unexpected root node ${JSON.stringify(rootType)} ` +
+                `(expected "${fixture.rootType}") — grammar/runtime mismatch`);
+        }
+    }
+    catch (error) {
+        throw new Error(`native ${language} parse health check failed: ${errorMessage(error)}`);
+    }
+    finally {
+        parser.delete?.();
+    }
+}
+export function readParserRuntimePolicy(env = process.env) {
+    const runtime = env.ARCHGUARD_PARSER_RUNTIME;
+    if (runtime !== undefined && runtime !== '') {
+        if (isParserRuntimePolicy(runtime))
+            return runtime;
+        throw new Error(`Invalid ARCHGUARD_PARSER_RUNTIME value "${runtime}" (expected "auto", "native", or "wasm")`);
+    }
+    const backend = env.ARCHGUARD_PARSER_BACKEND;
+    if (backend !== undefined && backend !== '') {
+        emitDeprecatedAliasWarning();
+        if (backend === 'native' || backend === 'wasm')
+            return backend;
+        throw new Error(`Invalid ARCHGUARD_PARSER_BACKEND value "${backend}" (expected "native" or "wasm")`);
+    }
+    return 'auto';
+}
+export function hasParserRuntimeEnvOverride(env = process.env) {
+    return Boolean(env.ARCHGUARD_PARSER_RUNTIME || env.ARCHGUARD_PARSER_BACKEND);
+}
+const selectionCache = new Map();
+const diagnosticsLog = [];
+export function getParserRuntimeDiagnostics() {
+    return diagnosticsLog;
+}
+export function runtimeDiagnosticVisible(verbose, selection) {
+    return verbose || selection.fallbackReason !== undefined;
+}
+let deprecatedAliasWarningEmitted = false;
+function emitDeprecatedAliasWarning() {
+    if (deprecatedAliasWarningEmitted)
+        return;
+    deprecatedAliasWarningEmitted = true;
+    console.error('[parser-runtime] WARNING: ARCHGUARD_PARSER_BACKEND is deprecated and will be removed in a ' +
+        'future release; use the canonical ARCHGUARD_PARSER_RUNTIME (auto|native|wasm) instead.');
+}
+export function resetParserBackendSelectionCache() {
+    selectionCache.clear();
+    diagnosticsLog.length = 0;
+    deprecatedAliasWarningEmitted = false;
+}
+export async function selectParserBackendFor(language, options = {}) {
+    const policy = options.policy ?? readParserRuntimePolicy();
+    const source = options.policy !== undefined
+        ? (options.policySource ?? 'explicit')
+        : hasParserRuntimeEnvOverride()
+            ? 'env'
+            : 'default';
+    const cacheable = options.nativeLoaders === undefined && options.nativeModuleRoot === undefined;
+    if (!cacheable) {
+        return computeSelection(language, policy, options, source);
+    }
+    const key = `${policy}:${language}`;
+    const cached = selectionCache.get(key);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const selection = computeSelection(language, policy, options, source);
+    selectionCache.set(key, selection);
+    selection.catch(() => selectionCache.delete(key));
+    return selection;
+}
+async function computeSelection(language, policy, options, source) {
+    if (policy === 'wasm') {
+        const { wasmParserBackend } = await import('./wasm-parser-backend.js');
+        return finishSelection({ language, policy, runtime: 'wasm', backend: wasmParserBackend }, source, options);
+    }
+    const moduleRoot = options.nativeModuleRoot ?? readNativeModuleRootEnv();
+    const loaders = options.nativeLoaders ?? (moduleRoot ? defaultNativeLoaders(moduleRoot) : undefined);
+    try {
+        probeNativeBinding(language, loaders ?? defaultNativeLoaders());
+    }
+    catch (error) {
+        const reason = errorMessage(error);
+        if (policy === 'native') {
+            throw new ParserInitializationError(language, 'native', new Error(`${reason}\n` +
+                `Native tree-sitter is required by policy (ARCHGUARD_PARSER_RUNTIME=native). ` +
+                `Install the optional native accelerator packages ("tree-sitter" and ` +
+                `"${nativeGrammarModule(language)}") into ArchGuard's own package scope, or set ` +
+                `ARCHGUARD_NATIVE_MODULE_ROOT to a trusted module root containing them, or relax ` +
+                `the policy to ARCHGUARD_PARSER_RUNTIME=auto|wasm.`));
+        }
+        const { wasmParserBackend } = await import('./wasm-parser-backend.js');
+        return finishSelection({ language, policy, runtime: 'wasm', backend: wasmParserBackend, fallbackReason: reason }, source, options);
+    }
+    const backend = loaders ? new NativeParserBackend({ loaders }) : nativeParserBackend;
+    return finishSelection({ language, policy, runtime: 'native', backend }, source, options);
+}
+function finishSelection(selection, source, options) {
+    const diagnostic = selection.fallbackReason
+        ? `[parser-runtime] ${selection.language}: policy=${selection.policy} source=${source} -> ` +
+            `${selection.runtime} (native probe failed: ${selection.fallbackReason})`
+        : `[parser-runtime] ${selection.language}: policy=${selection.policy} source=${source} -> ${selection.runtime}`;
+    diagnosticsLog.push(diagnostic);
+    const full = { ...selection, source, diagnostic };
+    options.onDiagnostic?.(diagnostic, full);
+    return full;
+}
+//# sourceMappingURL=parser-runtime.js.map

package/dist/plugins/shared/parser-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-runtime.js","sourceRoot":"","sources":["../../../src/plugins/shared/parser-runtime.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,GAGxB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,qBAAqB,EAA4B,MAAM,2BAA2B,CAAC;AAE5F,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GAExB,MAAM,4BAA4B,CAAC;AAGpC,MAAM,cAAc,GAA+D;IACjF,EAAE,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,EAAE;IACvD,IAAI,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE;IACnD,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAC/C,GAAG,EAAE,EAAE,IAAI,EAAE,4BAA4B,EAAE,QAAQ,EAAE,kBAAkB,EAAE;IACzE,MAAM,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,aAAa,EAAE;CAC7D,CAAC;AAEF,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AASD,MAAM,UAAU,kBAAkB,CAChC,QAAwB,EACxB,UAA+B,oBAAoB,CAAC,uBAAuB,EAAE,CAAC;IAE9E,IAAI,OAAuD,CAAC;IAC5D,IAAI,CAAC;QACH,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,2DAA2D,YAAY,CAAC,KAAK,CAAC,EAAE,CACjF,CAAC;IACJ,CAAC;IAED,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,sBAAsB,QAAQ,cAAc,mBAAmB,CAAC,QAAQ,CAAC,OAAO,YAAY,CAAC,KAAK,CAAC,EAAE,CACtG,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,MAAoC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QACvB,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,sBAAsB,QAAQ,+DAA+D,YAAY,CAAC,KAAK,CAAC,EAAE,CACnH,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC;QACtC,IAAI,QAAQ,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,qCAAqC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG;gBAC9D,cAAc,OAAO,CAAC,QAAQ,+BAA+B,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,UAAU,QAAQ,+BAA+B,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;AACH,CAAC;AAGD,MAAM,UAAU,uBAAuB,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC1E,MAAM,OAAO,GAAG,GAAG,CAAC,wBAAwB,CAAC;IAC7C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QAC5C,IAAI,qBAAqB,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,2CAA2C,OAAO,0CAA0C,CAC7F,CAAC;IACJ,CAAC;IAGD,MAAM,OAAO,GAAG,GAAG,CAAC,wBAAwB,CAAC;IAC7C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QAC5C,0BAA0B,EAAE,CAAC;QAC7B,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,MAAM;YAAE,OAAO,OAAO,CAAC;QAC/D,MAAM,IAAI,KAAK,CACb,2CAA2C,OAAO,iCAAiC,CACpF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAGD,MAAM,UAAU,2BAA2B,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC9E,OAAO,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAC/E,CAAC;AA+BD,MAAM,cAAc,GAAG,IAAI,GAAG,EAA2C,CAAC;AAC1E,MAAM,cAAc,GAAa,EAAE,CAAC;AAGpC,MAAM,UAAU,2BAA2B;IACzC,OAAO,cAAc,CAAC;AACxB,CAAC;AAOD,MAAM,UAAU,wBAAwB,CACtC,OAAgB,EAChB,SAAsC;IAEtC,OAAO,OAAO,IAAI,SAAS,CAAC,cAAc,KAAK,SAAS,CAAC;AAC3D,CAAC;AAED,IAAI,6BAA6B,GAAG,KAAK,CAAC;AAG1C,SAAS,0BAA0B;IACjC,IAAI,6BAA6B;QAAE,OAAO;IAC1C,6BAA6B,GAAG,IAAI,CAAC;IACrC,OAAO,CAAC,KAAK,CACX,4FAA4F;QAC1F,wFAAwF,CAC3F,CAAC;AACJ,CAAC;AAGD,MAAM,UAAU,gCAAgC;IAC9C,cAAc,CAAC,KAAK,EAAE,CAAC;IACvB,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,6BAA6B,GAAG,KAAK,CAAC;AACxC,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAwB,EACxB,UAAsC,EAAE;IAExC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,uBAAuB,EAAE,CAAC;IAC3D,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,KAAK,SAAS;QAC1B,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,IAAI,UAAU,CAAC;QACtC,CAAC,CAAC,2BAA2B,EAAE;YAC7B,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,SAAS,CAAC;IAClB,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,KAAK,SAAS,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,CAAC;IAChG,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,QAAQ,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACtE,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAGnC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,QAAwB,EACxB,MAA2B,EAC3B,OAAmC,EACnC,MAAiC;IAEjC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QACvE,OAAO,eAAe,CACpB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,EACjE,MAAM,EACN,OAAO,CACR,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,IAAI,uBAAuB,EAAE,CAAC;IACzE,MAAM,OAAO,GACX,OAAO,CAAC,aAAa,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACvF,IAAI,CAAC;QACH,kBAAkB,CAAC,QAAQ,EAAE,OAAO,IAAI,oBAAoB,EAAE,CAAC,CAAC;IAClE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,MAAM,IAAI,yBAAyB,CACjC,QAAQ,EACR,QAAQ,EACR,IAAI,KAAK,CACP,GAAG,MAAM,IAAI;gBACX,8EAA8E;gBAC9E,sEAAsE;gBACtE,IAAI,mBAAmB,CAAC,QAAQ,CAAC,gDAAgD;gBACjF,kFAAkF;gBAClF,mDAAmD,CACtD,CACF,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QACvE,OAAO,eAAe,CACpB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,EAAE,EACzF,MAAM,EACN,OAAO,CACR,CAAC;IACJ,CAAC;IAID,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;IACrF,OAAO,eAAe,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5F,CAAC;AAED,SAAS,eAAe,CACtB,SAAgE,EAChE,MAAiC,EACjC,OAAmC;IAInC,MAAM,UAAU,GAAG,SAAS,CAAC,cAAc;QACzC,CAAC,CAAC,oBAAoB,SAAS,CAAC,QAAQ,YAAY,SAAS,CAAC,MAAM,WAAW,MAAM,MAAM;YACzF,GAAG,SAAS,CAAC,OAAO,0BAA0B,SAAS,CAAC,cAAc,GAAG;QAC3E,CAAC,CAAC,oBAAoB,SAAS,CAAC,QAAQ,YAAY,SAAS,CAAC,MAAM,WAAW,MAAM,OAAO,SAAS,CAAC,OAAO,EAAE,CAAC;IAClH,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChC,MAAM,IAAI,GAA2B,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC1E,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/plugins/shared/plugin-factory.d.ts

@@ -0,0 +1,5 @@
+import type { ILanguagePlugin } from '../../core/interfaces/language-plugin.js';
+import type { ParserLanguage } from './parser-backend.js';
+import { type SelectParserBackendOptions } from './parser-runtime.js';
+export declare function createLanguagePlugin(language: ParserLanguage, options?: SelectParserBackendOptions): Promise<ILanguagePlugin>;
+//# sourceMappingURL=plugin-factory.d.ts.map

package/dist/plugins/shared/plugin-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-factory.d.ts","sourceRoot":"","sources":["../../../src/plugins/shared/plugin-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAA0B,KAAK,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAG9F,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,eAAe,CAAC,CAyB1B"}

package/dist/plugins/shared/plugin-factory.js

@@ -0,0 +1,27 @@
+import { selectParserBackendFor } from './parser-runtime.js';
+export async function createLanguagePlugin(language, options = {}) {
+    const { backend } = await selectParserBackendFor(language, options);
+    switch (language) {
+        case 'go': {
+            const { GoAtlasPlugin } = await import('../../plugins/golang/atlas/index.js');
+            return new GoAtlasPlugin(backend);
+        }
+        case 'java': {
+            const { JavaPlugin } = await import('../../plugins/java/index.js');
+            return new JavaPlugin(backend);
+        }
+        case 'python': {
+            const { PythonPlugin } = await import('../../plugins/python/index.js');
+            return new PythonPlugin(backend);
+        }
+        case 'cpp': {
+            const { CppPlugin } = await import('../../plugins/cpp/index.js');
+            return new CppPlugin(backend);
+        }
+        case 'kotlin': {
+            const { KotlinPlugin } = await import('../../plugins/kotlin/index.js');
+            return new KotlinPlugin(backend);
+        }
+    }
+}
+//# sourceMappingURL=plugin-factory.js.map

package/dist/plugins/shared/plugin-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-factory.js","sourceRoot":"","sources":["../../../src/plugins/shared/plugin-factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAmC,MAAM,qBAAqB,CAAC;AAG9F,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAwB,EACxB,UAAsC,EAAE;IAExC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEpE,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,IAAI,CAAC,CAAC,CAAC;YACV,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;YAC1E,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;YAC/D,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;YACnE,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QACD,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;YAC7D,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;YACnE,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/plugins/shared/syntax-tree.d.ts

@@ -0,0 +1,32 @@
+export type ParserRuntimeKind = 'native' | 'wasm';
+export interface SyntaxPointLike {
+    readonly row: number;
+    readonly column: number;
+}
+export interface SyntaxNodeLike {
+    readonly type: string;
+    readonly text: string;
+    readonly startIndex: number;
+    readonly endIndex: number;
+    readonly startPosition: SyntaxPointLike;
+    readonly endPosition: SyntaxPointLike;
+    readonly isNamed: boolean;
+    readonly parent: SyntaxNodeLike | null;
+    readonly children: SyntaxNodeLike[];
+    readonly namedChildren: SyntaxNodeLike[];
+    readonly namedChildCount: number;
+    namedChild(index: number): SyntaxNodeLike | null;
+    childForFieldName(name: string): SyntaxNodeLike | null;
+    descendantsOfType(type: string | string[]): SyntaxNodeLike[];
+}
+export interface SyntaxTreeLike {
+    readonly rootNode: SyntaxNodeLike;
+    dispose(): void;
+}
+export interface ParserSession {
+    readonly language: string;
+    readonly runtime: ParserRuntimeKind;
+    parse(code: string): SyntaxTreeLike;
+    dispose(): void;
+}
+//# sourceMappingURL=syntax-tree.d.ts.map

package/dist/plugins/shared/syntax-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-tree.d.ts","sourceRoot":"","sources":["../../../src/plugins/shared/syntax-tree.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,cAAc,EAAE,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IACjD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IACvD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC;IACpC,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/plugins/shared/syntax-tree.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=syntax-tree.js.map

package/dist/plugins/shared/syntax-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-tree.js","sourceRoot":"","sources":["../../../src/plugins/shared/syntax-tree.ts"],"names":[],"mappings":""}

package/dist/plugins/shared/wasm-parser-backend.d.ts

@@ -0,0 +1,18 @@
+import type { ParserBackend, ParserLanguage } from './parser-backend.js';
+import type { ParserSession } from './syntax-tree.js';
+export interface WasmParserBackendOptions {
+    assetsDir?: string;
+}
+export declare function resetWasmParserRuntimeCache(): void;
+export declare class WasmParserBackend implements ParserBackend {
+    readonly runtime: "wasm";
+    private readonly assetsDir;
+    private readonly cache;
+    constructor(options?: WasmParserBackendOptions);
+    get cachedLanguageCount(): number;
+    createSession(language: ParserLanguage): Promise<ParserSession>;
+    private initializeRuntime;
+    private loadLanguage;
+}
+export declare const wasmParserBackend: WasmParserBackend;
+//# sourceMappingURL=wasm-parser-backend.d.ts.map

package/dist/plugins/shared/wasm-parser-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-parser-backend.d.ts","sourceRoot":"","sources":["../../../src/plugins/shared/wasm-parser-backend.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAkC,MAAM,kBAAkB,CAAC;AAkDtF,MAAM,WAAW,wBAAwB;IAMvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAmBD,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,OAAO,EAAG,MAAM,CAAU;IAEnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;gBAE7B,OAAO,GAAE,wBAA6B;IAWlD,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IAEK,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAgBrE,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,YAAY;CAmBrB;AAiCD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/plugins/shared/wasm-parser-backend.js

@@ -0,0 +1,118 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { ParserInitializationError } from './parser-backend.js';
+const GRAMMAR_WASM_FILES = {
+    go: 'tree-sitter-go.wasm',
+    java: 'tree-sitter-java.wasm',
+    python: 'tree-sitter-python.wasm',
+    cpp: 'tree-sitter-cpp.wasm',
+    kotlin: 'tree-sitter-kotlin.wasm',
+};
+const RUNTIME_WASM_FILE = 'tree-sitter.wasm';
+function defaultAssetsDir() {
+    return fileURLToPath(new URL('../../../assets/grammars/', import.meta.url));
+}
+const runtimeCaches = new Map();
+export function resetWasmParserRuntimeCache() {
+    runtimeCaches.clear();
+}
+export class WasmParserBackend {
+    runtime = 'wasm';
+    assetsDir;
+    cache;
+    constructor(options = {}) {
+        this.assetsDir = path.resolve(options.assetsDir ?? defaultAssetsDir());
+        let cache = runtimeCaches.get(this.assetsDir);
+        if (!cache) {
+            cache = { languagePromises: new Map() };
+            runtimeCaches.set(this.assetsDir, cache);
+        }
+        this.cache = cache;
+    }
+    get cachedLanguageCount() {
+        return this.cache.languagePromises.size;
+    }
+    async createSession(language) {
+        let parser;
+        try {
+            const wts = await this.initializeRuntime();
+            const loadedLanguage = await this.loadLanguage(wts, language);
+            parser = new wts.Parser();
+            parser.setLanguage(loadedLanguage);
+            return new WasmParserSession(language, parser);
+        }
+        catch (error) {
+            if (error instanceof ParserInitializationError)
+                throw error;
+            parser?.delete();
+            throw new ParserInitializationError(language, this.runtime, error);
+        }
+    }
+    initializeRuntime() {
+        if (this.cache.modulePromise)
+            return this.cache.modulePromise;
+        const initialized = (async () => {
+            const wts = (await import('web-tree-sitter'));
+            const runtimePath = path.join(this.assetsDir, RUNTIME_WASM_FILE);
+            const locateFile = existsSync(runtimePath) ? { locateFile: () => runtimePath } : undefined;
+            await wts.Parser.init(locateFile);
+            return wts;
+        })();
+        initialized.catch(() => {
+            if (this.cache.modulePromise === initialized)
+                this.cache.modulePromise = undefined;
+        });
+        this.cache.modulePromise ??= initialized;
+        return this.cache.modulePromise;
+    }
+    loadLanguage(wts, language) {
+        if (this.cache.languagePromises.has(language)) {
+            return this.cache.languagePromises.get(language);
+        }
+        const loaded = (async () => {
+            const grammarPath = path.join(this.assetsDir, GRAMMAR_WASM_FILES[language]);
+            if (!existsSync(grammarPath)) {
+                throw new Error(`bundled ${language} grammar WASM not found at ${grammarPath} ` +
+                    `(rebuild with: node scripts/fetch-grammar-wasms.mjs --update)`);
+            }
+            return wts.Language.load(grammarPath);
+        })();
+        loaded.catch(() => this.cache.languagePromises.delete(language));
+        this.cache.languagePromises.set(language, loaded);
+        return loaded;
+    }
+}
+class WasmParserSession {
+    language;
+    parser;
+    runtime = 'wasm';
+    disposed = false;
+    constructor(language, parser) {
+        this.language = language;
+        this.parser = parser;
+    }
+    parse(code) {
+        if (this.disposed)
+            throw new Error(`${this.language} parser session has been disposed`);
+        const tree = this.parser.parse(code);
+        let disposed = false;
+        return {
+            rootNode: tree.rootNode,
+            dispose() {
+                if (disposed)
+                    return;
+                disposed = true;
+                tree.delete();
+            },
+        };
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.parser.delete();
+    }
+}
+export const wasmParserBackend = new WasmParserBackend();
+//# sourceMappingURL=wasm-parser-backend.js.map

package/dist/plugins/shared/wasm-parser-backend.js.map

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

package/dist/plugins/typescript/builders/module-graph-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-graph-builder.d.ts","sourceRoot":"","sources":["../../../../src/plugins/typescript/builders/module-graph-builder.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EACV,aAAa,EAId,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAQ/C,qBAAa,kBAAkB;IAQ7B,KAAK,CACH,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,UAAU,EAAE,EACzB,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,aAAa;IAoLhB,OAAO,CAAC,YAAY;CAmErB"}
+{"version":3,"file":"module-graph-builder.d.ts","sourceRoot":"","sources":["../../../../src/plugins/typescript/builders/module-graph-builder.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EACV,aAAa,EAId,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAQ/C,qBAAa,kBAAkB;IAQ7B,KAAK,CACH,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,UAAU,EAAE,EACzB,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,aAAa;IAqLhB,OAAO,CAAC,YAAY;CAmErB"}

package/dist/plugins/typescript/builders/module-graph-builder.js

@@ -88,9 +88,10 @@ export class ModuleGraphBuilder {
             entityStatsMap.set(moduleId, { classes: 0, interfaces: 0, functions: 0, enums: 0 });
         }
         for (const entity of entities) {
-            const entityDir = path
+            const rawDir = path
                 .dirname(entity.id.split('.').slice(0, -1).join('.'))
                 .replace(/\\/g, '/');
+            const entityDir = rawDir === '.' ? '' : rawDir;
             const stats = entityStatsMap.get(entityDir);
             if (stats) {
                 if (entity.type === 'class')