@gitwand/core 2.2.0 → 2.4.1

package/dist/structural/parsers/adapters/tauri.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Tauri adapter for loading tree-sitter grammar WASM files.
+ *
+ * Uses `window.__TAURI_INTERNALS__.convertFileSrc` (Tauri v2) to convert a
+ * local asset path into a fetch-able asset:// URL, then loads via fetch.
+ *
+ * Grammar WASM files must be included in the Tauri bundle under the path
+ * specified by `grammarDir` (default: "/assets/grammars" relative to the
+ * Tauri resource directory).
+ */
+export interface TauriLoaderOptions {
+    /**
+     * Absolute path to the directory containing grammar WASM files inside
+     * the Tauri resource bundle.
+     * Defaults to "/assets/grammars".
+     */
+    grammarDir?: string;
+}
+/**
+ * Load grammar WASM bytes in a Tauri webview context.
+ *
+ * @param grammarName - e.g. "tree-sitter-typescript"
+ * @param opts        - Tauri-specific options
+ */
+export declare function loadGrammarBytes(grammarName: string, opts?: TauriLoaderOptions): Promise<Uint8Array>;
+//# sourceMappingURL=tauri.d.ts.map

package/dist/structural/parsers/adapters/tauri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tauri.d.ts","sourceRoot":"","sources":["../../../../src/structural/parsers/adapters/tauri.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,UAAU,CAAC,CAuBrB"}

package/dist/structural/parsers/adapters/tauri.js

@@ -0,0 +1,34 @@
+/**
+ * Tauri adapter for loading tree-sitter grammar WASM files.
+ *
+ * Uses `window.__TAURI_INTERNALS__.convertFileSrc` (Tauri v2) to convert a
+ * local asset path into a fetch-able asset:// URL, then loads via fetch.
+ *
+ * Grammar WASM files must be included in the Tauri bundle under the path
+ * specified by `grammarDir` (default: "/assets/grammars" relative to the
+ * Tauri resource directory).
+ */
+/**
+ * Load grammar WASM bytes in a Tauri webview context.
+ *
+ * @param grammarName - e.g. "tree-sitter-typescript"
+ * @param opts        - Tauri-specific options
+ */
+export async function loadGrammarBytes(grammarName, opts = {}) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const tauri = window.__TAURI_INTERNALS__;
+    if (typeof tauri?.convertFileSrc !== "function") {
+        throw new Error("[structural] Tauri adapter: __TAURI_INTERNALS__.convertFileSrc is not available. " +
+            "Ensure you are running inside a Tauri webview and using Tauri v2.");
+    }
+    const grammarDir = opts.grammarDir ?? "/assets/grammars";
+    const localPath = `${grammarDir}/${grammarName}.wasm`;
+    const url = tauri.convertFileSrc(localPath, "asset");
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`[structural] Failed to fetch grammar WASM via Tauri: ${localPath} (HTTP ${response.status})`);
+    }
+    const buffer = await response.arrayBuffer();
+    return new Uint8Array(buffer);
+}
+//# sourceMappingURL=tauri.js.map

package/dist/structural/parsers/adapters/tauri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tauri.js","sourceRoot":"","sources":["../../../../src/structural/parsers/adapters/tauri.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,OAA2B,EAAE;IAE7B,8DAA8D;IAC9D,MAAM,KAAK,GAAI,MAAc,CAAC,mBAAmB,CAAC;IAClD,IAAI,OAAO,KAAK,EAAE,cAAc,KAAK,UAAU,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,mFAAmF;YACjF,mEAAmE,CACtE,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,kBAAkB,CAAC;IACzD,MAAM,SAAS,GAAG,GAAG,UAAU,IAAI,WAAW,OAAO,CAAC;IACtD,MAAM,GAAG,GAAW,KAAK,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,wDAAwD,SAAS,UAAU,QAAQ,CAAC,MAAM,GAAG,CAC9F,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC"}

package/dist/structural/parsers/grammars/languages.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Language registry for the structural merge engine.
+ *
+ * Maps file extensions → language identifiers → tree-sitter grammar WASM names.
+ * Grammar WASM names correspond to the filenames published by `tree-sitter-wasms`.
+ */
+export type SupportedLanguage = "typescript" | "tsx" | "javascript" | "jsx" | "python" | "go" | "rust";
+export interface LanguageSpec {
+    /** Grammar WASM name as published in `tree-sitter-wasms/out/` */
+    grammarName: string;
+    /** File extensions handled by this language (lowercase, with dot) */
+    extensions: string[];
+}
+export declare const LANGUAGE_SPECS: Record<SupportedLanguage, LanguageSpec>;
+/**
+ * Detect the language for a given file path.
+ * Returns `null` if the file extension is not supported.
+ */
+export declare function languageForFile(filePath: string): SupportedLanguage | null;
+/**
+ * Returns `true` if the file can be handled by the structural merge engine.
+ *
+ * Excludes TypeScript declaration files (`.d.ts`) — they have no implementation
+ * to merge. Excludes `.min.js` and other generated bundles via the generated-file
+ * detector in the main resolver pipeline.
+ */
+export declare function isStructuralLanguage(filePath: string): boolean;
+/**
+ * Return the grammar WASM name for a file, or `null` if not supported.
+ */
+export declare function grammarNameForFile(filePath: string): string | null;
+//# sourceMappingURL=languages.d.ts.map

package/dist/structural/parsers/grammars/languages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.d.ts","sourceRoot":"","sources":["../../../../src/structural/parsers/grammars/languages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,KAAK,GACL,YAAY,GACZ,KAAK,GACL,QAAQ,GACR,IAAI,GACJ,MAAM,CAAC;AAEX,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAID,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,iBAAiB,EAAE,YAAY,CA8BlE,CAAC;AAYF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAM1E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlE"}

package/dist/structural/parsers/grammars/languages.js

@@ -0,0 +1,73 @@
+/**
+ * Language registry for the structural merge engine.
+ *
+ * Maps file extensions → language identifiers → tree-sitter grammar WASM names.
+ * Grammar WASM names correspond to the filenames published by `tree-sitter-wasms`.
+ */
+// ─── Language specs ───────────────────────────────────────────────────────────
+export const LANGUAGE_SPECS = {
+    typescript: {
+        grammarName: "tree-sitter-typescript",
+        extensions: [".ts"],
+    },
+    tsx: {
+        grammarName: "tree-sitter-tsx",
+        extensions: [".tsx"],
+    },
+    javascript: {
+        grammarName: "tree-sitter-javascript",
+        extensions: [".js", ".mjs", ".cjs"],
+    },
+    jsx: {
+        // JSX is parsed by the JavaScript grammar (tree-sitter-javascript supports JSX natively)
+        grammarName: "tree-sitter-javascript",
+        extensions: [".jsx"],
+    },
+    python: {
+        grammarName: "tree-sitter-python",
+        extensions: [".py"],
+    },
+    go: {
+        grammarName: "tree-sitter-go",
+        extensions: [".go"],
+    },
+    rust: {
+        grammarName: "tree-sitter-rust",
+        extensions: [".rs"],
+    },
+};
+// ─── Extension → language lookup table ───────────────────────────────────────
+const EXT_TO_LANGUAGE = new Map(Object.entries(LANGUAGE_SPECS).flatMap(([lang, spec]) => spec.extensions.map((ext) => [ext, lang])));
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Detect the language for a given file path.
+ * Returns `null` if the file extension is not supported.
+ */
+export function languageForFile(filePath) {
+    const lower = filePath.toLowerCase();
+    for (const [ext, lang] of EXT_TO_LANGUAGE) {
+        if (lower.endsWith(ext))
+            return lang;
+    }
+    return null;
+}
+/**
+ * Returns `true` if the file can be handled by the structural merge engine.
+ *
+ * Excludes TypeScript declaration files (`.d.ts`) — they have no implementation
+ * to merge. Excludes `.min.js` and other generated bundles via the generated-file
+ * detector in the main resolver pipeline.
+ */
+export function isStructuralLanguage(filePath) {
+    if (/\.d\.ts$/i.test(filePath))
+        return false;
+    return languageForFile(filePath) !== null;
+}
+/**
+ * Return the grammar WASM name for a file, or `null` if not supported.
+ */
+export function grammarNameForFile(filePath) {
+    const lang = languageForFile(filePath);
+    return lang ? LANGUAGE_SPECS[lang].grammarName : null;
+}
+//# sourceMappingURL=languages.js.map

package/dist/structural/parsers/grammars/languages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.js","sourceRoot":"","sources":["../../../../src/structural/parsers/grammars/languages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,iFAAiF;AAEjF,MAAM,CAAC,MAAM,cAAc,GAA4C;IACrE,UAAU,EAAE;QACV,WAAW,EAAE,wBAAwB;QACrC,UAAU,EAAE,CAAC,KAAK,CAAC;KACpB;IACD,GAAG,EAAE;QACH,WAAW,EAAE,iBAAiB;QAC9B,UAAU,EAAE,CAAC,MAAM,CAAC;KACrB;IACD,UAAU,EAAE;QACV,WAAW,EAAE,wBAAwB;QACrC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;KACpC;IACD,GAAG,EAAE;QACH,yFAAyF;QACzF,WAAW,EAAE,wBAAwB;QACrC,UAAU,EAAE,CAAC,MAAM,CAAC;KACrB;IACD,MAAM,EAAE;QACN,WAAW,EAAE,oBAAoB;QACjC,UAAU,EAAE,CAAC,KAAK,CAAC;KACpB;IACD,EAAE,EAAE;QACF,WAAW,EAAE,gBAAgB;QAC7B,UAAU,EAAE,CAAC,KAAK,CAAC;KACpB;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,kBAAkB;QAC/B,UAAU,EAAE,CAAC,KAAK,CAAC;KACpB;CACF,CAAC;AAEF,gFAAgF;AAEhF,MAAM,eAAe,GAAmC,IAAI,GAAG,CAC5D,MAAM,CAAC,OAAO,CAAC,cAAc,CAAyC,CAAC,OAAO,CAC7E,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAA+B,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CACzF,CACF,CAAC;AAEF,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,eAAe,EAAE,CAAC;QAC1C,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,eAAe,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC"}

package/dist/structural/parsers/grammars/ts.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Grammar loaders for all structural-merge–supported languages.
+ *
+ * Uses the unified language registry from `languages.ts` to map file paths
+ * to the correct `tree-sitter-wasms` grammar WASM.
+ */
+import { type Language, type LoaderOptions } from "../loader.js";
+/** Load the TypeScript grammar. */
+export declare function loadTypeScriptGrammar(opts?: LoaderOptions): Promise<Language | null>;
+/** Load the TSX grammar. */
+export declare function loadTsxGrammar(opts?: LoaderOptions): Promise<Language | null>;
+/** Load the JavaScript grammar (also used for JSX). */
+export declare function loadJavaScriptGrammar(opts?: LoaderOptions): Promise<Language | null>;
+/** Load the Python grammar. */
+export declare function loadPythonGrammar(opts?: LoaderOptions): Promise<Language | null>;
+/** Load the Go grammar. */
+export declare function loadGoGrammar(opts?: LoaderOptions): Promise<Language | null>;
+/** Load the Rust grammar. */
+export declare function loadRustGrammar(opts?: LoaderOptions): Promise<Language | null>;
+/**
+ * Load the appropriate grammar for a given file path.
+ * Returns `null` if the file extension is not supported or the grammar WASM
+ * is unavailable.
+ */
+export declare function loadGrammarForFile(filePath: string, opts?: LoaderOptions): Promise<Language | null>;
+//# sourceMappingURL=ts.d.ts.map

package/dist/structural/parsers/grammars/ts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts.d.ts","sourceRoot":"","sources":["../../../../src/structural/parsers/grammars/ts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAe,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAK9E,mCAAmC;AACnC,wBAAsB,qBAAqB,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAE9F;AAED,4BAA4B;AAC5B,wBAAsB,cAAc,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAEvF;AAED,uDAAuD;AACvD,wBAAsB,qBAAqB,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAE9F;AAED,+BAA+B;AAC/B,wBAAsB,iBAAiB,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAE1F;AAED,2BAA2B;AAC3B,wBAAsB,aAAa,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAEtF;AAED,6BAA6B;AAC7B,wBAAsB,eAAe,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAExF;AAID;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAI1B"}

package/dist/structural/parsers/grammars/ts.js

@@ -0,0 +1,46 @@
+/**
+ * Grammar loaders for all structural-merge–supported languages.
+ *
+ * Uses the unified language registry from `languages.ts` to map file paths
+ * to the correct `tree-sitter-wasms` grammar WASM.
+ */
+import { loadGrammar } from "../loader.js";
+import { grammarNameForFile, LANGUAGE_SPECS } from "./languages.js";
+// ─── Named loaders (kept for backward compat + direct use) ───────────────────
+/** Load the TypeScript grammar. */
+export async function loadTypeScriptGrammar(opts = {}) {
+    return loadGrammar(LANGUAGE_SPECS.typescript.grammarName, opts);
+}
+/** Load the TSX grammar. */
+export async function loadTsxGrammar(opts = {}) {
+    return loadGrammar(LANGUAGE_SPECS.tsx.grammarName, opts);
+}
+/** Load the JavaScript grammar (also used for JSX). */
+export async function loadJavaScriptGrammar(opts = {}) {
+    return loadGrammar(LANGUAGE_SPECS.javascript.grammarName, opts);
+}
+/** Load the Python grammar. */
+export async function loadPythonGrammar(opts = {}) {
+    return loadGrammar(LANGUAGE_SPECS.python.grammarName, opts);
+}
+/** Load the Go grammar. */
+export async function loadGoGrammar(opts = {}) {
+    return loadGrammar(LANGUAGE_SPECS.go.grammarName, opts);
+}
+/** Load the Rust grammar. */
+export async function loadRustGrammar(opts = {}) {
+    return loadGrammar(LANGUAGE_SPECS.rust.grammarName, opts);
+}
+// ─── Generic loader ───────────────────────────────────────────────────────────
+/**
+ * Load the appropriate grammar for a given file path.
+ * Returns `null` if the file extension is not supported or the grammar WASM
+ * is unavailable.
+ */
+export async function loadGrammarForFile(filePath, opts = {}) {
+    const grammarName = grammarNameForFile(filePath);
+    if (!grammarName)
+        return null;
+    return loadGrammar(grammarName, opts);
+}
+//# sourceMappingURL=ts.js.map

package/dist/structural/parsers/grammars/ts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts.js","sourceRoot":"","sources":["../../../../src/structural/parsers/grammars/ts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAqC,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpE,gFAAgF;AAEhF,mCAAmC;AACnC,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAsB,EAAE;IAClE,OAAO,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AAClE,CAAC;AAED,4BAA4B;AAC5B,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAsB,EAAE;IAC3D,OAAO,WAAW,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAsB,EAAE;IAClE,OAAO,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AAClE,CAAC;AAED,+BAA+B;AAC/B,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAsB,EAAE;IAC9D,OAAO,WAAW,CAAC,cAAc,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,2BAA2B;AAC3B,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAsB,EAAE;IAC1D,OAAO,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,6BAA6B;AAC7B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAsB,EAAE;IAC5D,OAAO,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,OAAsB,EAAE;IAExB,MAAM,WAAW,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC"}

package/dist/structural/parsers/loader.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Grammar loader for web-tree-sitter.
+ *
+ * Handles environment detection, WASM loading, and in-process caching.
+ *
+ * `web-tree-sitter` is an **optional** peer dependency — if it is not
+ * installed, every function here returns `null` gracefully and the
+ * structural merge is silently skipped.
+ */
+/** A loaded tree-sitter Language (opaque to callers). */
+export type Language = unknown;
+/** A ready-to-use tree-sitter Parser (opaque to callers). */
+export type TSParser = unknown;
+export type Environment = "node" | "tauri" | "browser";
+export interface LoaderOptions {
+    /** Base URL used by the browser adapter to locate grammar WASM files. */
+    grammarBaseUrl?: string;
+    /** Directory used by the Tauri adapter to locate grammar WASM files. */
+    grammarDir?: string;
+    /**
+     * URL for `web-tree-sitter.wasm` — the web-tree-sitter runtime WASM.
+     * Pass this when the runtime cannot auto-discover the file (e.g. inside a
+     * Vite bundle where the hashed asset URL is not predictable).
+     * Example: `"/grammars/web-tree-sitter.wasm"`.
+     *
+     * Internally mapped to `locateFile` for web-tree-sitter v0.26+ (Emscripten).
+     */
+    wasmPath?: string;
+    /**
+     * Custom WASM bytes loader — overrides environment detection entirely.
+     * Receives the grammar name (e.g. "tree-sitter-typescript") and must
+     * return the raw WASM bytes.
+     */
+    customLoader?: (grammarName: string) => Promise<Uint8Array>;
+}
+/**
+ * Detect the current runtime environment.
+ * Priority: Tauri (window.__TAURI_INTERNALS__) > Node.js (process.versions.node) > browser.
+ */
+export declare function detectEnvironment(): Environment;
+/**
+ * Ensure web-tree-sitter's WASM runtime is initialized.
+ *
+ * Idempotent — safe to call multiple times; initialization runs only once.
+ *
+ * @returns The Parser class, or `null` if web-tree-sitter is unavailable.
+ */
+export declare function ensureParserInitialized(_opts?: LoaderOptions): Promise<any | null>;
+/**
+ * Load and cache a tree-sitter grammar by name.
+ *
+ * Returns `null` (never throws) if:
+ * - `web-tree-sitter` is not installed
+ * - The grammar WASM file cannot be found or loaded
+ *
+ * @param grammarName - e.g. "tree-sitter-typescript"
+ * @param opts        - Optional WASM path / loader overrides
+ */
+export declare function loadGrammar(grammarName: string, opts?: LoaderOptions): Promise<Language | null>;
+/**
+ * Create a configured tree-sitter Parser instance.
+ *
+ * Returns `null` if web-tree-sitter is unavailable.
+ *
+ * @param language - A language object returned by `loadGrammar()`
+ * @param opts     - Loader options (passed to `ensureParserInitialized`)
+ */
+export declare function createParser(language: Language, opts?: LoaderOptions): Promise<TSParser | null>;
+/**
+ * Reset the in-process grammar cache and initialization state.
+ * Intended for use in tests only.
+ */
+export declare function _resetCache(): void;
+//# sourceMappingURL=loader.d.ts.map

package/dist/structural/parsers/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/structural/parsers/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,yDAAyD;AACzD,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC;AAE/B,6DAA6D;AAC7D,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC;AAE/B,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7D;AAaD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAY/C;AAuCD;;;;;;GAMG;AAEH,wBAAsB,uBAAuB,CAAC,KAAK,GAAE,aAAkB,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAsB5F;AA0BD;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAyB1B;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,QAAQ,EAClB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAQ1B;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAKlC"}

package/dist/structural/parsers/loader.js

@@ -0,0 +1,181 @@
+/**
+ * Grammar loader for web-tree-sitter.
+ *
+ * Handles environment detection, WASM loading, and in-process caching.
+ *
+ * `web-tree-sitter` is an **optional** peer dependency — if it is not
+ * installed, every function here returns `null` gracefully and the
+ * structural merge is silently skipped.
+ */
+// ─── Module-level cache ───────────────────────────────────────────────────────
+const grammarCache = new Map();
+let parserInitialized = false;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let _ParserClass = null;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let _LanguageClass = null;
+// ─── Environment detection ────────────────────────────────────────────────────
+/**
+ * Detect the current runtime environment.
+ * Priority: Tauri (window.__TAURI_INTERNALS__) > Node.js (process.versions.node) > browser.
+ */
+export function detectEnvironment() {
+    if (typeof window !== "undefined" &&
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        window.__TAURI_INTERNALS__ != null) {
+        return "tauri";
+    }
+    if (typeof process !== "undefined" && process.versions?.node) {
+        return "node";
+    }
+    return "browser";
+}
+// ─── web-tree-sitter dynamic import ──────────────────────────────────────────
+/**
+ * Try to dynamically import `web-tree-sitter`.
+ * Returns `null` (never throws) if the package is not installed.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function tryImportTreeSitter() {
+    if (_ParserClass !== null)
+        return _ParserClass;
+    try {
+        // web-tree-sitter is an optional peerDependency — TypeScript cannot
+        // resolve it at compile time when it is not installed.
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore: optional peer — may not be installed
+        const mod = await import("web-tree-sitter");
+        // v0.26+ exports named exports (Parser, Language, …) with no default.
+        // Earlier versions (≤0.22) had a single default export (the Parser class)
+        // with Language available as Parser.Language.
+        // Support both shapes.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const anyMod = mod;
+        if (anyMod.Parser) {
+            // v0.26+ shape: { Parser, Language, … }
+            _ParserClass = anyMod.Parser;
+            _LanguageClass = anyMod.Language;
+        }
+        else {
+            // pre-v0.22 shape: default export is the Parser class; Language is Parser.Language
+            const ParserDefault = anyMod.default ?? anyMod;
+            _ParserClass = ParserDefault;
+            _LanguageClass = ParserDefault.Language;
+        }
+        return _ParserClass;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Ensure web-tree-sitter's WASM runtime is initialized.
+ *
+ * Idempotent — safe to call multiple times; initialization runs only once.
+ *
+ * @returns The Parser class, or `null` if web-tree-sitter is unavailable.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export async function ensureParserInitialized(_opts = {}) {
+    const Parser = await tryImportTreeSitter();
+    if (!Parser)
+        return null;
+    if (!parserInitialized) {
+        // `wasmPath` lets the caller override where web-tree-sitter finds its own
+        // runtime WASM (web-tree-sitter.wasm).  This is needed in bundled
+        // environments (Vite, Tauri) where the file is served as a static asset.
+        //
+        // web-tree-sitter v0.26+ uses the Emscripten `locateFile` callback to
+        // resolve the WASM URL — there is no `wasmPath` option in that API.
+        const initOpts = _opts.wasmPath
+            ? {
+                locateFile: (path) => path.endsWith(".wasm") ? _opts.wasmPath : path,
+            }
+            : {};
+        await Parser.init(initOpts);
+        parserInitialized = true;
+    }
+    return Parser;
+}
+// ─── WASM bytes loading ───────────────────────────────────────────────────────
+async function loadWasmForEnv(env, grammarName, opts) {
+    if (env === "node") {
+        // vite-ignore: Node-only adapter uses `createRequire` — never bundled for browser/Tauri
+        const { loadGrammarBytes } = await import(/* @vite-ignore */ "./adapters/node.js");
+        return loadGrammarBytes(grammarName);
+    }
+    if (env === "tauri") {
+        // vite-ignore: Tauri adapter uses @tauri-apps/plugin-fs — not available in web builds
+        const { loadGrammarBytes } = await import(/* @vite-ignore */ "./adapters/tauri.js");
+        return loadGrammarBytes(grammarName, { grammarDir: opts.grammarDir });
+    }
+    // browser
+    const { loadGrammarBytes } = await import("./adapters/browser.js");
+    return loadGrammarBytes(grammarName, { grammarBaseUrl: opts.grammarBaseUrl });
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Load and cache a tree-sitter grammar by name.
+ *
+ * Returns `null` (never throws) if:
+ * - `web-tree-sitter` is not installed
+ * - The grammar WASM file cannot be found or loaded
+ *
+ * @param grammarName - e.g. "tree-sitter-typescript"
+ * @param opts        - Optional WASM path / loader overrides
+ */
+export async function loadGrammar(grammarName, opts = {}) {
+    const cached = grammarCache.get(grammarName);
+    if (cached !== undefined)
+        return cached;
+    const Parser = await ensureParserInitialized(opts);
+    if (!Parser)
+        return null;
+    try {
+        let wasmBytes;
+        if (opts.customLoader) {
+            wasmBytes = await opts.customLoader(grammarName);
+        }
+        else {
+            const env = detectEnvironment();
+            wasmBytes = await loadWasmForEnv(env, grammarName, opts);
+        }
+        // Use the module-level Language class (v0.26+ separate export;
+        // fall back to Parser.Language for older versions).
+        const LanguageClass = _LanguageClass ?? Parser.Language;
+        const language = await LanguageClass.load(wasmBytes);
+        grammarCache.set(grammarName, language);
+        return language;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Create a configured tree-sitter Parser instance.
+ *
+ * Returns `null` if web-tree-sitter is unavailable.
+ *
+ * @param language - A language object returned by `loadGrammar()`
+ * @param opts     - Loader options (passed to `ensureParserInitialized`)
+ */
+export async function createParser(language, opts = {}) {
+    const Parser = await ensureParserInitialized(opts);
+    if (!Parser)
+        return null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const parser = new Parser();
+    parser.setLanguage(language);
+    return parser;
+}
+/**
+ * Reset the in-process grammar cache and initialization state.
+ * Intended for use in tests only.
+ */
+export function _resetCache() {
+    grammarCache.clear();
+    parserInitialized = false;
+    _ParserClass = null;
+    _LanguageClass = null;
+}
+//# sourceMappingURL=loader.js.map

package/dist/structural/parsers/loader.js.map

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

package/dist/structural/reconstruct.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Merged file reconstruction from entity merge results.
+ *
+ * Follows theirs entity order (to preserve incoming structure), interpolating
+ * the inter-entity whitespace/comments from the theirs source verbatim.
+ * Entities that only exist in ours (ours-added) are appended at the end.
+ */
+import type { TopLevelEntity } from "./entities.js";
+import type { EntityMergeResult } from "./merge.js";
+/**
+ * Reconstruct the merged source file from entity merge results.
+ *
+ * Strategy:
+ *   1. Walk theirs entities in order.
+ *      - Emit the source gap (whitespace, comments) between consecutive
+ *        entities, taken verbatim from `theirsSource`.
+ *      - Emit the merged text for each entity (or skip if deleted).
+ *   2. Emit the trailing content from `theirsSource` after the last entity.
+ *   3. Append any entities that only exist in ours (ours-added), separated
+ *      by a newline.
+ *
+ * @param merges         - Merge decision per entity signature
+ * @param theirsEntities - Top-level entities from the theirs version (ordered)
+ * @param oursEntities   - Top-level entities from the ours version (ordered)
+ * @param theirsSource   - Full source text of the theirs version (for gaps)
+ */
+export declare function reconstructFile(merges: EntityMergeResult[], theirsEntities: TopLevelEntity[], oursEntities: TopLevelEntity[], theirsSource: string): string;
+//# sourceMappingURL=reconstruct.d.ts.map

package/dist/structural/reconstruct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconstruct.d.ts","sourceRoot":"","sources":["../../src/structural/reconstruct.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,iBAAiB,EAAE,EAC3B,cAAc,EAAE,cAAc,EAAE,EAChC,YAAY,EAAE,cAAc,EAAE,EAC9B,YAAY,EAAE,MAAM,GACnB,MAAM,CA2CR"}

package/dist/structural/reconstruct.js

@@ -0,0 +1,63 @@
+/**
+ * Merged file reconstruction from entity merge results.
+ *
+ * Follows theirs entity order (to preserve incoming structure), interpolating
+ * the inter-entity whitespace/comments from the theirs source verbatim.
+ * Entities that only exist in ours (ours-added) are appended at the end.
+ */
+/**
+ * Reconstruct the merged source file from entity merge results.
+ *
+ * Strategy:
+ *   1. Walk theirs entities in order.
+ *      - Emit the source gap (whitespace, comments) between consecutive
+ *        entities, taken verbatim from `theirsSource`.
+ *      - Emit the merged text for each entity (or skip if deleted).
+ *   2. Emit the trailing content from `theirsSource` after the last entity.
+ *   3. Append any entities that only exist in ours (ours-added), separated
+ *      by a newline.
+ *
+ * @param merges         - Merge decision per entity signature
+ * @param theirsEntities - Top-level entities from the theirs version (ordered)
+ * @param oursEntities   - Top-level entities from the ours version (ordered)
+ * @param theirsSource   - Full source text of the theirs version (for gaps)
+ */
+export function reconstructFile(merges, theirsEntities, oursEntities, theirsSource) {
+    const mergeMap = new Map(merges.map((m) => [m.signature, m]));
+    const theirsSigSet = new Set(theirsEntities.map((e) => e.signature));
+    const parts = [];
+    let lastEnd = 0;
+    // ── 1. Follow theirs entity order ────────────────────────
+    for (const entity of theirsEntities) {
+        const merge = mergeMap.get(entity.signature);
+        // Emit the gap between the previous entity and this one (whitespace / comments)
+        const gap = theirsSource.slice(lastEnd, entity.startByte);
+        if (gap)
+            parts.push(gap);
+        if (merge?.include && merge.mergedText !== null) {
+            parts.push(merge.mergedText);
+        }
+        // If the entity is excluded (deleted / conflicted), we still advance
+        // lastEnd to skip over the theirs text for that entity.
+        lastEnd = entity.endByte;
+    }
+    // ── 2. Trailing content after the last theirs entity ─────
+    const trailing = theirsSource.slice(lastEnd);
+    if (trailing)
+        parts.push(trailing);
+    // ── 3. Append ours-added entities ────────────────────────
+    for (const entity of oursEntities) {
+        if (theirsSigSet.has(entity.signature))
+            continue; // already handled above
+        const merge = mergeMap.get(entity.signature);
+        if (!merge?.include || merge.mergedText === null)
+            continue;
+        // Ensure there's at least one newline separator before the appended entity
+        const last = parts[parts.length - 1] ?? "";
+        if (last !== "" && !last.endsWith("\n"))
+            parts.push("\n");
+        parts.push(merge.mergedText);
+    }
+    return parts.join("");
+}
+//# sourceMappingURL=reconstruct.js.map

package/dist/structural/reconstruct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconstruct.js","sourceRoot":"","sources":["../../src/structural/reconstruct.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA2B,EAC3B,cAAgC,EAChC,YAA8B,EAC9B,YAAoB;IAEpB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAErE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,4DAA4D;IAC5D,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAE7C,gFAAgF;QAChF,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAC1D,IAAI,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEzB,IAAI,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/B,CAAC;QACD,qEAAqE;QACrE,wDAAwD;QAExD,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC3B,CAAC;IAED,4DAA4D;IAC5D,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEnC,4DAA4D;IAC5D,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;YAAE,SAAS,CAAC,wBAAwB;QAE1E,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI;YAAE,SAAS;QAE3D,2EAA2E;QAC3E,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,IAAI,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE1D,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC"}