@massa-ai/core 1.2.1

package/dist/services/structural/grammar-integrity.js

@@ -0,0 +1,196 @@
+import { createHash } from "node:crypto";
+import { createRequire } from "node:module";
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { dirname, join, relative, resolve, sep } from "node:path";
+import { NATIVE_LOCK_IDENTITIES, } from "./native-lock-identities.js";
+/**
+ * Runtime load-time integrity verifier for native Tree-sitter grammar
+ * packages.
+ *
+ * WHY: the offline lockfile verifier (`scripts/verify-tree-sitter-grammars.ts`)
+ * pins each package's registry SRI or git identity at publish time, but it
+ * cannot detect a tampered, patched, or wrong-version grammar that has been
+ * installed into `node_modules` after the fact (e.g. a local `bun add`, a
+ * transitive bump, or a supply-chain swap). This module recomputes a hash over
+ * each installed package's ABI-independent source at parser init and compares
+ * it to the pinned `sourceIntegrity`. A mismatch fails loud before the first
+ * parse, so a corrupted grammar can never silently produce wrong structural
+ * output.
+ *
+ * HASHING BASIS (canonical, deterministic, ABI-independent):
+ *   For each pinned package, concatenate (in sorted order):
+ *     1. the exact bytes of `<packageRoot>/package.json`
+ *     2. the exact bytes of `<packageRoot>/grammar.js` if present
+ *     3. the exact bytes of every regular file under `<packageRoot>/src/**`,
+ *        visited depth-first with directory entries sorted by name and file
+ *        paths emitted relative to the package root using POSIX separators.
+ *   Each contribution is prefixed by its relative path (POSIX) and its byte
+ *   length as ASCII digits followed by a single NUL byte, so a payload
+ *   collision cannot arise from concatenation ambiguity. The concatenation is
+ *   sha512-hashed and emitted as `sha512-<base64>`.
+ *
+ * ABI REBUILD SAFETY: compiled artifacts are EXCLUDED by scoping the walk to
+ * `package.json`, `grammar.js`, and `src/**` only. The `prebuilds/`, `build/`,
+ * `bindings/`, and any `*.node` files live outside that scope, so a legitimate
+ * Bun/Node native rebuild cannot flip the hash. Only a change to the grammar
+ * source itself (a real version drift or tampering) fails the check.
+ */
+const SKIP_ENV_FLAG = "MASSA_AI_SKIP_GRAMMAR_INTEGRITY";
+/**
+ * Carries the pinned and recomputed integrity values so callers can report a
+ * precise mismatch surface.
+ */
+export class GrammarIntegrityError extends Error {
+    pkg;
+    expected;
+    actual;
+    code = "GRAMMAR_INTEGRITY_MISMATCH";
+    constructor(pkg, expected, actual) {
+        super(`Grammar source integrity mismatch for ${pkg}: expected ${expected}, got ${actual}`);
+        this.pkg = pkg;
+        this.expected = expected;
+        this.actual = actual;
+        this.name = "GrammarIntegrityError";
+    }
+}
+/**
+ * Directories whose contents are ABI- or platform-derived and must NOT
+ * contribute to the source hash. The walk never enters these because it is
+ * scoped to `src/**` (plus the two named root files), but they are listed
+ * here as the authoritative exclusion contract.
+ */
+const EXCLUDED_ABI_DIRS = new Set([
+    "prebuilds",
+    "build",
+    "bindings",
+    "node_modules",
+]);
+/**
+ * Resolve the installed package root for a pinned grammar by walking up from
+ * the resolved `package.json` entry until the manifest `name` matches. Mirrors
+ * `findPackageRoot` in the offline verifier so both tools agree on the package
+ * boundary.
+ */
+function resolvePackageRoot(requireFromCore, packageName) {
+    const entry = requireFromCore.resolve(`${packageName}/package.json`);
+    let cursor = dirname(entry);
+    while (true) {
+        const manifestPath = join(cursor, "package.json");
+        const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+        if (manifest.name === packageName)
+            return cursor;
+        const parent = dirname(cursor);
+        if (parent === cursor) {
+            throw new Error(`Could not locate package root for ${packageName} from ${entry}`);
+        }
+        cursor = parent;
+    }
+}
+/**
+ * Deterministically list every regular source file under `<root>/src`,
+ * depth-first, sorting directory entries by name. Returns POSIX-style relative
+ * paths so the hash is stable across POSIX and Windows hosts.
+ */
+function listSourceFiles(root) {
+    const srcRoot = join(root, "src");
+    let stat;
+    try {
+        stat = statSync(srcRoot);
+    }
+    catch {
+        return [];
+    }
+    if (!stat.isDirectory())
+        return [];
+    const out = [];
+    const visit = (dir) => {
+        const entries = readdirSync(dir).sort();
+        for (const name of entries) {
+            if (EXCLUDED_ABI_DIRS.has(name))
+                continue;
+            const full = join(dir, name);
+            const entryStat = statSync(full);
+            if (entryStat.isDirectory()) {
+                visit(full);
+            }
+            else if (entryStat.isFile()) {
+                out.push(relative(root, full).split(sep).join("/"));
+            }
+        }
+    };
+    visit(srcRoot);
+    return out;
+}
+/**
+ * Push a length-prefixed, path-prefixed contribution into the running buffer.
+ * The framing (path + NUL + decimal length + NUL + bytes) guarantees that two
+ * different file sets cannot produce the same concatenated stream.
+ */
+function pushContribution(chunks, relPath, bytes) {
+    chunks.push(Buffer.from(relPath, "utf8"));
+    chunks.push(Buffer.from([0]));
+    chunks.push(Buffer.from(String(bytes.byteLength), "ascii"));
+    chunks.push(Buffer.from([0]));
+    chunks.push(bytes);
+}
+/**
+ * Compute the canonical `sha512-<base64>` source-integrity digest for one
+ * installed package. Throws if the package root or required source files are
+ * absent.
+ */
+export function computePackageSourceIntegrity(requireFromCore, packageName) {
+    const root = resolvePackageRoot(requireFromCore, packageName);
+    const chunks = [];
+    const packageJsonPath = join(root, "package.json");
+    pushContribution(chunks, "package.json", readFileSync(packageJsonPath));
+    const grammarPath = join(root, "grammar.js");
+    try {
+        const grammarStat = statSync(grammarPath);
+        if (grammarStat.isFile()) {
+            pushContribution(chunks, "grammar.js", readFileSync(grammarPath));
+        }
+    }
+    catch {
+        // grammar.js is optional for some grammars; its absence is part of the
+        // canonical basis and is stable across installs of the same version.
+    }
+    for (const rel of listSourceFiles(root)) {
+        pushContribution(chunks, rel, readFileSync(resolve(root, rel)));
+    }
+    const digest = createHash("sha512").update(Buffer.concat(chunks)).digest("base64");
+    return `sha512-${digest}`;
+}
+let integrityVerified = false;
+/**
+ * Verify every pinned native grammar package against its `sourceIntegrity`
+ * pin. Runs at most once per process: subsequent calls are a no-op so the
+ * check never taxes per-request parse paths.
+ *
+ * Default behavior is ON (verifies). Set the environment variable
+ * `MASSA_AI_SKIP_GRAMMAR_INTEGRITY=1` to skip, which is intended only for
+ * local development iterations where grammar packages are intentionally
+ * patched or swapped. Production and CI default to verifying.
+ *
+ * @throws {GrammarIntegrityError} when any pinned package's recomputed
+ *   source integrity does not match its pin.
+ */
+export function verifyNativeGrammarIntegrity(requireFromCore = createRequire(import.meta.url)) {
+    if (integrityVerified)
+        return;
+    if (process.env[SKIP_ENV_FLAG] === "1") {
+        integrityVerified = true;
+        return;
+    }
+    for (const [pkg, identity] of Object.entries(NATIVE_LOCK_IDENTITIES)) {
+        const actual = computePackageSourceIntegrity(requireFromCore, pkg);
+        if (actual !== identity.sourceIntegrity) {
+            throw new GrammarIntegrityError(pkg, identity.sourceIntegrity, actual);
+        }
+    }
+    integrityVerified = true;
+}
+/** Test-only seam: reset the module-level memoization flag. */
+export function resetGrammarIntegrityForTests() {
+    integrityVerified = false;
+}
+//# sourceMappingURL=grammar-integrity.js.map

package/dist/services/structural/grammar-integrity.js.map

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

package/dist/services/structural/grammar-loaders.d.ts

@@ -0,0 +1,69 @@
+import { createRequire } from "node:module";
+import type { GrammarArtifact } from "./types.js";
+export interface NativeTree {
+    readonly rootNode: {
+        readonly type: string;
+        readonly hasError: boolean;
+        readonly endIndex: number;
+        readonly startIndex?: number;
+        walk?(): NativeTreeCursor;
+    };
+    delete(): void;
+}
+export interface NativeTreeCursor {
+    delete(): void;
+}
+export interface NativeQueryNode {
+    readonly type: string;
+    readonly startIndex: number;
+    readonly endIndex: number;
+    readonly namedChildren?: readonly NativeQueryNode[];
+    readonly children?: readonly NativeQueryNode[];
+    readonly parent?: NativeQueryNode | null;
+    childForFieldName?(fieldName: string): NativeQueryNode | null;
+}
+export interface NativeQueryCapture {
+    readonly name: string;
+    readonly node: NativeQueryNode;
+}
+export interface NativeQueryInstance {
+    matches(node: NativeQueryNode, options?: {
+        matchLimit?: number;
+    }): readonly {
+        readonly captures: readonly NativeQueryCapture[];
+    }[];
+    didExceedMatchLimit(): boolean;
+}
+export interface NativeQueryConstructor {
+    new (language: unknown, source: string | Buffer): NativeQueryInstance;
+}
+export interface NativeParserInstance {
+    setLanguage(language: unknown): void;
+    parse(source: string | ((index: number) => string | null)): NativeTree;
+}
+export interface NativeParserConstructor {
+    new (): NativeParserInstance;
+    Query?: NativeQueryConstructor;
+}
+export interface LoadedNativeGrammarSet {
+    Parser: NativeParserConstructor;
+    grammars: ReadonlyMap<string, unknown>;
+}
+export interface BunMaskAdapter {
+    target: object;
+    property?: PropertyKey;
+    getDescriptor?: (target: object, property: PropertyKey) => PropertyDescriptor | undefined;
+    deleteProperty?: (target: object, property: PropertyKey) => boolean;
+    restoreProperty?: (target: object, property: PropertyKey, descriptor: PropertyDescriptor) => void;
+}
+type RuntimeRequire = ReturnType<typeof createRequire>;
+/**
+ * Serialize the process-global Bun compatibility mutation and restore the
+ * complete property descriptor before the caller can use a loaded grammar.
+ */
+export declare function withMaskedBunVersion<T>(callback: () => T | Promise<T>, adapter?: BunMaskAdapter): Promise<T>;
+export declare function grammarArtifactKey(artifact: GrammarArtifact): string;
+/** Load a deduplicated package+selector grammar set without parsing while masked. */
+export declare function loadNativeGrammarSet(artifacts: readonly GrammarArtifact[], requireFromCore?: RuntimeRequire): Promise<LoadedNativeGrammarSet>;
+export {};
+//# sourceMappingURL=grammar-loaders.d.ts.map

package/dist/services/structural/grammar-loaders.d.ts.map

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

package/dist/services/structural/grammar-loaders.js

@@ -0,0 +1,229 @@
+import { createRequire } from "node:module";
+import { pathToFileURL } from "node:url";
+import { STRUCTURAL_BUN_VERSION, TREE_SITTER_NATIVE_MODULE_ABI, } from "./language-manifest.js";
+const PROCESS_BUN_MASK_ADAPTER = {
+    target: process.versions,
+};
+let bunMaskTail = Promise.resolve();
+function descriptorEquals(left, right) {
+    return (left.configurable === right.configurable &&
+        left.enumerable === right.enumerable &&
+        left.writable === right.writable &&
+        left.value === right.value &&
+        left.get === right.get &&
+        left.set === right.set);
+}
+function asError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+/**
+ * Serialize the process-global Bun compatibility mutation and restore the
+ * complete property descriptor before the caller can use a loaded grammar.
+ */
+export async function withMaskedBunVersion(callback, adapter = PROCESS_BUN_MASK_ADAPTER) {
+    const waitForTurn = bunMaskTail;
+    let releaseTurn;
+    bunMaskTail = new Promise((resolve) => {
+        releaseTurn = resolve;
+    });
+    await waitForTurn;
+    const property = adapter.property ?? "bun";
+    const getDescriptor = adapter.getDescriptor ?? Object.getOwnPropertyDescriptor;
+    const deleteProperty = adapter.deleteProperty ?? Reflect.deleteProperty;
+    const restoreProperty = adapter.restoreProperty ??
+        ((target, key, descriptor) => {
+            Object.defineProperty(target, key, descriptor);
+        });
+    let descriptor;
+    let restoreRequired = false;
+    let result;
+    let operationError;
+    let restorationError;
+    try {
+        descriptor = getDescriptor(adapter.target, property);
+        if (!descriptor) {
+            throw new Error("process.versions.bun descriptor is missing before masking");
+        }
+        if (!descriptor.configurable) {
+            throw new Error("process.versions.bun must be configurable for native loading");
+        }
+        // Arm restoration before invoking the potentially-throwing delete seam.
+        restoreRequired = true;
+        if (!deleteProperty(adapter.target, property)) {
+            throw new Error("failed to mask process.versions.bun");
+        }
+        result = await callback();
+    }
+    catch (error) {
+        operationError = asError(error);
+    }
+    try {
+        if (restoreRequired && descriptor) {
+            let restored;
+            try {
+                restoreProperty(adapter.target, property, descriptor);
+                restored = getDescriptor(adapter.target, property);
+            }
+            catch (error) {
+                restorationError = asError(error);
+            }
+            if (!restored || !descriptorEquals(restored, descriptor)) {
+                try {
+                    // A failing injected/custom restoration hook must not leave the
+                    // process marker absent. This fallback is also used after a partial
+                    // restoration that produced the wrong descriptor.
+                    Object.defineProperty(adapter.target, property, descriptor);
+                    restored = getDescriptor(adapter.target, property);
+                }
+                catch (error) {
+                    restorationError = restorationError
+                        ? new AggregateError([restorationError, asError(error)], "Bun descriptor restoration failed")
+                        : asError(error);
+                }
+            }
+            if (!restored || !descriptorEquals(restored, descriptor)) {
+                restorationError ??= new Error("Bun descriptor restoration failed");
+            }
+        }
+    }
+    finally {
+        // No adapter fault may poison the process-global serialization queue.
+        releaseTurn();
+    }
+    if (operationError && restorationError) {
+        throw new AggregateError([operationError, restorationError], "Native loading and Bun descriptor restoration both failed");
+    }
+    if (operationError)
+        throw operationError;
+    if (restorationError)
+        throw restorationError;
+    return result;
+}
+export function grammarArtifactKey(artifact) {
+    return `${artifact.packageName}#${artifact.exportName ?? "module"}`;
+}
+function assertRuntimeTarget() {
+    const isDarwinArm64 = process.platform === "darwin" && process.arch === "arm64";
+    const isLinuxX64 = process.platform === "linux" && process.arch === "x64";
+    if (!isDarwinArm64 && !isLinuxX64) {
+        throw new Error(`Structural native parsing requires macOS arm64 or Linux glibc x64, got ${process.platform} ${process.arch}`);
+    }
+    if (process.versions.bun !== STRUCTURAL_BUN_VERSION) {
+        throw new Error(`Structural native parsing requires Bun ${STRUCTURAL_BUN_VERSION}, got ${process.versions.bun ?? "none"}`);
+    }
+    if (Number(process.versions.modules) !== TREE_SITTER_NATIVE_MODULE_ABI) {
+        throw new Error(`Structural native parsing requires ABI ${TREE_SITTER_NATIVE_MODULE_ABI}, got ${process.versions.modules ?? "none"}`);
+    }
+}
+async function importDefaultFrom(requireFromCore, packageName) {
+    const imported = await import(pathToFileURL(requireFromCore.resolve(packageName)).href);
+    return imported.default ?? imported;
+}
+async function loadArtifact(requireFromCore, artifact) {
+    let loaded;
+    switch (artifact.packageName) {
+        case "tree-sitter-javascript":
+            loaded = requireFromCore("tree-sitter-javascript");
+            break;
+        case "tree-sitter-typescript":
+            loaded = requireFromCore("tree-sitter-typescript");
+            break;
+        case "tree-sitter-html":
+            loaded = requireFromCore("tree-sitter-html");
+            break;
+        case "tree-sitter-dart":
+            loaded = requireFromCore("tree-sitter-dart");
+            break;
+        case "tree-sitter-python":
+            loaded = requireFromCore("tree-sitter-python");
+            break;
+        case "tree-sitter-php":
+            loaded = requireFromCore("tree-sitter-php");
+            break;
+        case "tree-sitter-java":
+            loaded = requireFromCore("tree-sitter-java");
+            break;
+        case "tree-sitter-go":
+            loaded = requireFromCore("tree-sitter-go");
+            break;
+        case "tree-sitter-rust":
+            loaded = requireFromCore("tree-sitter-rust");
+            break;
+        case "tree-sitter-cpp":
+            loaded = requireFromCore("tree-sitter-cpp");
+            break;
+        case "tree-sitter-c":
+            loaded = requireFromCore("tree-sitter-c");
+            break;
+        case "@tree-sitter-grammars/tree-sitter-markdown":
+            loaded = requireFromCore("@tree-sitter-grammars/tree-sitter-markdown");
+            break;
+        case "tree-sitter-json":
+            loaded = requireFromCore("tree-sitter-json");
+            break;
+        case "@tree-sitter-grammars/tree-sitter-yaml":
+            loaded = requireFromCore("@tree-sitter-grammars/tree-sitter-yaml");
+            break;
+        case "tree-sitter-c-sharp":
+            loaded = await importDefaultFrom(requireFromCore, "tree-sitter-c-sharp");
+            break;
+        case "tree-sitter-ruby":
+            loaded = requireFromCore("tree-sitter-ruby");
+            break;
+        case "tree-sitter-swift":
+            loaded = requireFromCore("tree-sitter-swift");
+            break;
+        case "@tree-sitter-grammars/tree-sitter-kotlin":
+            loaded = requireFromCore("@tree-sitter-grammars/tree-sitter-kotlin");
+            break;
+        case "tree-sitter-scala":
+            loaded = requireFromCore("tree-sitter-scala");
+            break;
+        case "@tree-sitter-grammars/tree-sitter-lua":
+            loaded = await importDefaultFrom(requireFromCore, "@tree-sitter-grammars/tree-sitter-lua");
+            break;
+        case "@tree-sitter-grammars/tree-sitter-zig":
+            loaded = requireFromCore("@tree-sitter-grammars/tree-sitter-zig");
+            break;
+        case "tree-sitter-elixir":
+            loaded = requireFromCore("tree-sitter-elixir");
+            break;
+        case "tree-sitter-erlang":
+            loaded = requireFromCore("tree-sitter-erlang");
+            break;
+        case "tree-sitter-clojure-orchard":
+            loaded = requireFromCore("tree-sitter-clojure-orchard");
+            break;
+        case "tree-sitter-ocaml":
+            loaded = requireFromCore("tree-sitter-ocaml");
+            break;
+        case "tree-sitter-haskell":
+            loaded = requireFromCore("tree-sitter-haskell");
+            break;
+        default: throw new Error(`Unsupported native grammar package: ${artifact.packageName}`);
+    }
+    if (artifact.exportName === "default")
+        return loaded;
+    const module = loaded;
+    return artifact.exportName ? module[artifact.exportName] : module;
+}
+/** Load a deduplicated package+selector grammar set without parsing while masked. */
+export async function loadNativeGrammarSet(artifacts, requireFromCore = createRequire(import.meta.url)) {
+    assertRuntimeTarget();
+    return withMaskedBunVersion(async () => {
+        const Parser = requireFromCore("tree-sitter");
+        const grammars = new Map();
+        for (const artifact of artifacts) {
+            const key = grammarArtifactKey(artifact);
+            if (!grammars.has(key)) {
+                const language = await loadArtifact(requireFromCore, artifact);
+                if (!language) {
+                    throw new Error(`${key} did not expose a Tree-sitter language`);
+                }
+                grammars.set(key, language);
+            }
+        }
+        return { Parser, grammars };
+    });
+}
+//# sourceMappingURL=grammar-loaders.js.map

package/dist/services/structural/grammar-loaders.js.map

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

package/dist/services/structural/language-manifest.d.ts

@@ -0,0 +1,59 @@
+import type { GrammarArtifact, LanguageManifestEntry, StructuralCapabilityRequirement, StructuralLanguageResolution } from "./types.js";
+export declare const LANGUAGE_MANIFEST_VERSION = "1.0.0";
+export declare const INITIAL_QUERY_PACK_VERSION = "1.0.0";
+export declare const INITIAL_RESOLVER_VERSION = "1.0.0";
+export declare const TREE_SITTER_RUNTIME_VERSION = "0.25.0";
+export declare const TREE_SITTER_NATIVE_MODULE_ABI = 137;
+export declare const STRUCTURAL_BUN_VERSION = "1.3.14";
+export declare const TREE_SITTER_PATCH_SHA256 = "cd957e559b88dfe54219b77ab25f4dfd1d5a24c64afe0db6f2d4e6868f49b6e8";
+/** Ordered exactly like DEFAULT_ALLOWED_EXTENSIONS; each extension has one entry. */
+export declare const LANGUAGE_MANIFEST: readonly LanguageManifestEntry[];
+export interface ManifestExhaustivenessReport {
+    expectedCount: number;
+    actualCount: number;
+    missing: readonly string[];
+    extra: readonly string[];
+    duplicates: readonly string[];
+    ordered: boolean;
+    exhaustive: boolean;
+}
+export declare function inspectLanguageManifest(expected?: readonly string[]): ManifestExhaustivenessReport;
+export declare function assertLanguageManifestExhaustive(expected?: readonly string[]): void;
+export declare function getLanguageManifestEntry(extension: string): LanguageManifestEntry | undefined;
+export declare function resolveStructuralLanguage(extension: string): StructuralLanguageResolution;
+export interface HeaderLanguageEvidence {
+    readonly cImporters?: readonly string[];
+    readonly cppImporters?: readonly string[];
+    readonly buildLanguage?: "c" | "cpp" | "conflict";
+}
+/** `.h` is C unless one unambiguous importer/build signal positively proves C++. */
+export declare function resolveStructuralParseLanguage(extension: string, evidence?: HeaderLanguageEvidence): StructuralLanguageResolution;
+/** Stable, serializable inputs. T10 owns the final structural fingerprint hash. */
+export declare const STRUCTURAL_FINGERPRINT_INPUTS: Readonly<{
+    manifestVersion: "1.0.0";
+    runtime: Readonly<{
+        packageName: "tree-sitter";
+        version: "0.25.0";
+        bunVersion: "1.3.14";
+        nativeModuleAbi: 137;
+        patchSha256: "cd957e559b88dfe54219b77ab25f4dfd1d5a24c64afe0db6f2d4e6868f49b6e8";
+    }>;
+    schemas: Readonly<{
+        taxonomy: "1.0.0";
+        sourceSpan: "1.0.0";
+        fqn: "1.0.0";
+    }>;
+    languages: readonly Readonly<{
+        extension: string;
+        language: string;
+        dialect: string;
+        grammarArtifact: GrammarArtifact;
+        alternateGrammarArtifact: GrammarArtifact | undefined;
+        queryPackVersion: string;
+        resolverVersion: string;
+        capabilityTier: import("./types.js").StructuralCapabilityTier;
+        capabilities: Readonly<Record<"imports" | "documentation" | "data_flow" | "declarations" | "type_relations" | "calls" | "specialized_edges", StructuralCapabilityRequirement>>;
+        mixedLanguagePolicy: import("./types.js").MixedLanguagePolicy;
+    }>[];
+}>;
+//# sourceMappingURL=language-manifest.d.ts.map

package/dist/services/structural/language-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-manifest.d.ts","sourceRoot":"","sources":["../../../src/services/structural/language-manifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EAErB,+BAA+B,EAC/B,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAOpB,eAAO,MAAM,yBAAyB,UAAU,CAAC;AACjD,eAAO,MAAM,0BAA0B,UAAU,CAAC;AAClD,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAChD,eAAO,MAAM,2BAA2B,WAAW,CAAC;AACpD,eAAO,MAAM,6BAA6B,MAAM,CAAC;AACjD,eAAO,MAAM,sBAAsB,WAAW,CAAC;AAC/C,eAAO,MAAM,wBAAwB,qEAC+B,CAAC;AA4FrE,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,EAAE,SAAS,qBAAqB,EA0O1D,CAAC;AAML,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,GAAE,SAAS,MAAM,EAA+B,GACvD,4BAA4B,CA6B9B;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,GAAE,SAAS,MAAM,EAA+B,GACvD,IAAI,CASN;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,GAChB,qBAAqB,GAAG,SAAS,CAEnC;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,GAChB,4BAA4B,CAe9B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,KAAK,GAAG,UAAU,CAAC;CACnD;AAED,oFAAoF;AACpF,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,sBAAsB,GAChC,4BAA4B,CAe9B;AAED,mFAAmF;AACnF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BxC,CAAC"}