@yalehwang/archguard 0.1.31 → 0.1.33

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

@@ -0,0 +1,96 @@
+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();
+            const grammar = this.loaders.loadGrammar(language);
+            parser = new Parser();
+            parser.setLanguage(grammar);
+            return new NativeParserSession(language, parser, grammar, Parser.Query);
+        }
+        catch (error) {
+            parser?.delete?.();
+            throw new ParserInitializationError(language, this.runtime, error);
+        }
+    }
+}
+class NativeParserSession {
+    language;
+    parser;
+    grammar;
+    QueryCtor;
+    runtime = 'native';
+    disposed = false;
+    constructor(language, parser, grammar, QueryCtor) {
+        this.language = language;
+        this.parser = parser;
+        this.grammar = grammar;
+        this.QueryCtor = QueryCtor;
+    }
+    query(source) {
+        if (!this.QueryCtor) {
+            throw new Error(`tree-sitter query support unavailable for ${this.language} ` +
+                '(Parser.Query constructor missing from the native runtime binding)');
+        }
+        return new this.QueryCtor(this.grammar, source);
+    }
+    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":"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"}

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;AAGzE,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;CAQjB;AAkBD,wBAAsB,oBAAoB,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CAQ3F"}

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

@@ -0,0 +1,39 @@
+import { errorMessage } from '../../utils/error-message.js';
+export class ParserInitializationError extends Error {
+    language;
+    backend;
+    constructor(language, backend, cause) {
+        super(`Failed to initialize ${language} parser with ${backend} backend: ${errorMessage(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":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AASxD,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAEvC;IACA;IAFX,YACW,QAAwB,EACxB,OAAe,EACxB,KAAc;QAEd,KAAK,CACH,wBAAwB,QAAQ,gBAAgB,OAAO,aAAa,YAAY,CAAC,KAAK,CAAC,EAAE,EACzF,EAAE,KAAK,EAAE,CACV,CAAC;QAPO,aAAQ,GAAR,QAAQ,CAAgB;QACxB,YAAO,GAAP,OAAO,CAAQ;QAOxB,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;AAwBpC,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,156 @@
+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) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === 'string')
+        return error;
+    return JSON.stringify(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":"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"}

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/query-loader.d.ts

@@ -0,0 +1,14 @@
+import type { ParserQueryLike } from './syntax-tree.js';
+export type QuerySet = Map<string, ParserQueryLike>;
+export interface QueryCompiler {
+    query(source: string): ParserQueryLike;
+}
+export declare class QueryLoader {
+    private readonly queryDir;
+    private readonly session;
+    private readonly cache;
+    constructor(queryDir: string, session: QueryCompiler);
+    loadAll(): QuerySet;
+    load(name: string): ParserQueryLike;
+}
+//# sourceMappingURL=query-loader.d.ts.map

package/dist/plugins/shared/query-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-loader.d.ts","sourceRoot":"","sources":["../../../src/plugins/shared/query-loader.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAGpD,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC;CACxC;AAQD,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;gBAGzC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa;IAQzC,OAAO,IAAI,QAAQ;IAYnB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;CAiBpC"}

package/dist/plugins/shared/query-loader.js

@@ -0,0 +1,47 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { ParseError } from '../../parser/errors.js';
+function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === 'string')
+        return error;
+    return JSON.stringify(error) ?? 'unknown error';
+}
+export class QueryLoader {
+    queryDir;
+    session;
+    cache = new Map();
+    constructor(queryDir, session) {
+        this.queryDir = queryDir;
+        this.session = session;
+    }
+    loadAll() {
+        const queries = new Map();
+        if (!fs.existsSync(this.queryDir))
+            return queries;
+        const files = fs.readdirSync(this.queryDir).filter((f) => f.endsWith('.scm'));
+        for (const file of files) {
+            const name = path.basename(file, '.scm');
+            queries.set(name, this.load(name));
+        }
+        return queries;
+    }
+    load(name) {
+        const cached = this.cache.get(name);
+        if (cached)
+            return cached;
+        const filePath = path.join(this.queryDir, `${name}.scm`);
+        const source = fs.readFileSync(filePath, 'utf-8');
+        let query;
+        try {
+            query = this.session.query(source);
+        }
+        catch (error) {
+            throw new ParseError(`Failed to compile tree-sitter query ${JSON.stringify(filePath)}: ${errorMessage(error)}`, filePath);
+        }
+        this.cache.set(name, query);
+        return query;
+    }
+}
+//# sourceMappingURL=query-loader.js.map

package/dist/plugins/shared/query-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-loader.js","sourceRoot":"","sources":["../../../src/plugins/shared/query-loader.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAWhD,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC;AAClD,CAAC;AAED,MAAM,OAAO,WAAW;IAIH;IACA;IAJF,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IAE5D,YACmB,QAAgB,EAChB,OAAsB;QADtB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,YAAO,GAAP,OAAO,CAAe;IACtC,CAAC;IAOJ,OAAO;QACL,MAAM,OAAO,GAAa,IAAI,GAAG,EAAE,CAAC;QACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,OAAO,CAAC;QAClD,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAGD,IAAI,CAAC,IAAY;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,KAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CAClB,uCAAuC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,EACzF,QAAQ,CACT,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

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

@@ -0,0 +1,45 @@
+export type ParserRuntimeKind = 'native' | 'wasm';
+export interface SyntaxPointLike {
+    readonly row: number;
+    readonly column: number;
+}
+export interface SyntaxNodeLike {
+    readonly id: number;
+    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 QueryCaptureLike {
+    readonly name: string;
+    readonly node: SyntaxNodeLike;
+}
+export interface QueryMatchLike {
+    readonly pattern: number;
+    readonly captures: QueryCaptureLike[];
+}
+export interface ParserQueryLike {
+    matches(node: SyntaxNodeLike): Iterable<QueryMatchLike> | readonly QueryMatchLike[];
+}
+export interface ParserSession {
+    readonly language: string;
+    readonly runtime: ParserRuntimeKind;
+    parse(code: string): SyntaxTreeLike;
+    query(source: string): ParserQueryLike;
+    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;IAE7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,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;AAGD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;CAC/B;AAGD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CACvC;AAOD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,QAAQ,CAAC,cAAc,CAAC,GAAG,SAAS,cAAc,EAAE,CAAC;CACrF;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;IAMpC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC;IACvC,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,EAEV,aAAa,EAGd,MAAM,kBAAkB,CAAC;AAmD1B,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;IAqBzB,OAAO,CAAC,YAAY;CAmBrB;AAuCD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}