@flyingrobots/graft 0.5.0 → 0.6.1

package/dist/parser/markdown.js

@@ -0,0 +1,168 @@
+// ---------------------------------------------------------------------------
+// Markdown outline extraction — heading-based structural summary
+// ---------------------------------------------------------------------------
+import { OutlineEntry, JumpEntry } from "./types.js";
+// ---------------------------------------------------------------------------
+// Fence detection
+// ---------------------------------------------------------------------------
+function isFenceLine(line) {
+    const match = /^\s*([`~])\1{2,}.*$/.exec(line);
+    if (match === null)
+        return null;
+    const marker = match[1];
+    if (marker !== "`" && marker !== "~")
+        return null;
+    const markerRun = /^([`~]+)/.exec(match[0].trimStart());
+    if (markerRun === null)
+        return null;
+    const run = markerRun[1];
+    if (run === undefined)
+        return null;
+    return { marker, length: run.length };
+}
+function isFenceClose(line, marker, length) {
+    const pattern = marker === "`"
+        ? new RegExp(`^\\s*\`{${String(length)},}\\s*$`)
+        : new RegExp(`^\\s*~{${String(length)},}\\s*$`);
+    return pattern.test(line);
+}
+// ---------------------------------------------------------------------------
+// Heading parsing
+// ---------------------------------------------------------------------------
+function parseAtxHeading(line, lineNumber) {
+    const match = /^\s{0,3}(#{1,6})[ \t]+(.+?)\s*#*\s*$/.exec(line);
+    if (match === null)
+        return null;
+    const hashes = match[1];
+    const rawName = match[2]?.trim() ?? "";
+    if (hashes === undefined || rawName.length === 0)
+        return null;
+    return {
+        level: hashes.length,
+        name: rawName,
+        start: lineNumber,
+        end: lineNumber,
+    };
+}
+function parseSetextHeading(currentLine, nextLine, lineNumber) {
+    if (nextLine === undefined)
+        return null;
+    if (currentLine.trim().length === 0)
+        return null;
+    if (parseAtxHeading(currentLine, lineNumber) !== null)
+        return null;
+    if (/^\s{0,3}=+\s*$/.test(nextLine)) {
+        return { level: 1, name: currentLine.trim(), start: lineNumber, end: lineNumber + 1 };
+    }
+    if (/^\s{0,3}-+\s*$/.test(nextLine)) {
+        return { level: 2, name: currentLine.trim(), start: lineNumber, end: lineNumber + 1 };
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Hierarchy and range finalization
+// ---------------------------------------------------------------------------
+function finalizeMarkdownRanges(headings, totalLines) {
+    for (let i = 0; i < headings.length; i++) {
+        const current = headings[i];
+        if (current === undefined)
+            continue;
+        let end = totalLines;
+        for (let j = i + 1; j < headings.length; j++) {
+            const next = headings[j];
+            if (next === undefined)
+                continue;
+            if (next.level <= current.level) {
+                end = next.start - 1;
+                break;
+            }
+        }
+        current.end = end;
+    }
+}
+function buildMarkdownHierarchy(headings) {
+    const roots = [];
+    const stack = [];
+    for (const heading of headings) {
+        const node = { ...heading, children: [] };
+        while (stack.length > 0) {
+            const last = stack[stack.length - 1];
+            if (last === undefined || last.level < node.level)
+                break;
+            stack.pop();
+        }
+        const parent = stack[stack.length - 1];
+        if (parent === undefined)
+            roots.push(node);
+        else
+            parent.children.push(node);
+        stack.push(node);
+    }
+    return roots;
+}
+// ---------------------------------------------------------------------------
+// Conversion
+// ---------------------------------------------------------------------------
+function toOutlineEntry(node) {
+    return new OutlineEntry({
+        kind: "heading",
+        name: node.name,
+        exported: false,
+        ...(node.children.length > 0
+            ? { children: node.children.map((child) => toOutlineEntry(child)) }
+            : {}),
+    });
+}
+function buildMarkdownJumpEntry(heading) {
+    return new JumpEntry({
+        symbol: heading.name,
+        kind: "heading",
+        start: heading.start,
+        end: heading.end,
+    });
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export function extractMarkdownOutline(source) {
+    const lines = source.split("\n");
+    const headings = [];
+    let inFence = false;
+    let activeFence = null;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined)
+            continue;
+        const lineNumber = i + 1;
+        const fence = isFenceLine(line);
+        if (inFence) {
+            if (activeFence !== null && isFenceClose(line, activeFence.marker, activeFence.length)) {
+                inFence = false;
+                activeFence = null;
+            }
+            continue;
+        }
+        if (fence !== null) {
+            inFence = true;
+            activeFence = fence;
+            continue;
+        }
+        const atx = parseAtxHeading(line, lineNumber);
+        if (atx !== null) {
+            headings.push(atx);
+            continue;
+        }
+        const setext = parseSetextHeading(line, lines[i + 1], lineNumber);
+        if (setext !== null) {
+            headings.push(setext);
+            i++;
+        }
+    }
+    finalizeMarkdownRanges(headings, lines.length);
+    const hierarchy = buildMarkdownHierarchy(headings);
+    return {
+        entries: hierarchy.map((node) => toOutlineEntry(node)),
+        jumpTable: headings.map((heading) => buildMarkdownJumpEntry(heading)),
+    };
+}
+//# sourceMappingURL=markdown.js.map

package/dist/parser/markdown.js.map

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

package/dist/parser/outline.d.ts

@@ -0,0 +1,12 @@
+import type { SupportedStructuredFormat } from "./lang.js";
+import type { OutlineResult } from "./types.js";
+/**
+ * Extract a structural outline from source code.
+ *
+ * @param source - The source code text.
+ * @param lang - Structured format identifier. Defaults to `"ts"`.
+ * @returns An {@link OutlineResult} with entries, jump table, and partial flag.
+ */
+export declare function extractOutline(source: string, lang?: SupportedStructuredFormat): OutlineResult;
+export declare function extractOutlineForFile(filePath: string, source: string): OutlineResult | null;
+//# sourceMappingURL=outline.d.ts.map

package/dist/parser/outline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline.d.ts","sourceRoot":"","sources":["../../src/parser/outline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAE3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA+LhD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,yBAAgC,GACrC,aAAa,CAmGf;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,aAAa,GAAG,IAAI,CAOtB"}

package/dist/parser/outline.js

@@ -0,0 +1,251 @@
+import { detectStructuredFormat } from "./lang.js";
+import { OutlineEntry, JumpEntry } from "./types.js";
+import { parseStructuredTree } from "./runtime.js";
+import { extractMarkdownOutline } from "./markdown.js";
+const MAX_SIGNATURE_LENGTH = 199;
+// ---------------------------------------------------------------------------
+// Signature helpers
+// ---------------------------------------------------------------------------
+/** Compact object-literal default values: `= { ... }` becomes `= {…}`. */
+function compactObjectDefaults(sig) {
+    return sig.replace(/=\s*\{[^}]*\}/g, "= {…}");
+}
+/** Truncate a signature to fit within MAX_SIGNATURE_LENGTH. */
+function boundSignature(raw) {
+    let sig = compactObjectDefaults(raw);
+    if (sig.length >= MAX_SIGNATURE_LENGTH) {
+        sig = sig.slice(0, MAX_SIGNATURE_LENGTH - 1) + "…";
+    }
+    return sig;
+}
+function nodeKind(nodeType) {
+    switch (nodeType) {
+        case "function_declaration":
+        case "generator_function_declaration":
+            return "function";
+        case "class_declaration":
+            return "class";
+        case "method_definition":
+            return "method";
+        case "interface_declaration":
+            return "interface";
+        case "type_alias_declaration":
+            return "type";
+        case "enum_declaration":
+            return "enum";
+        default:
+            return undefined;
+    }
+}
+// ---------------------------------------------------------------------------
+// Tree-sitter extraction helpers
+// ---------------------------------------------------------------------------
+function extractFunctionSignature(node) {
+    const nameNode = node.childForFieldName("name");
+    if (!nameNode)
+        return undefined;
+    const params = node.childForFieldName("parameters");
+    const returnType = node.childForFieldName("return_type");
+    let sig = nameNode.text;
+    if (params) {
+        sig += params.text;
+    }
+    if (returnType) {
+        // return_type node text includes the leading `: ` in some grammars
+        const rt = returnType.text.replace(/^:\s*/, "");
+        sig += ": " + rt;
+    }
+    return boundSignature(sig);
+}
+function extractName(node) {
+    const nameNode = node.childForFieldName("name");
+    return nameNode?.text;
+}
+function extractClassChildren(node) {
+    const body = node.childForFieldName("body");
+    if (!body)
+        return [];
+    const children = [];
+    for (const child of body.namedChildren) {
+        if (child.type === "method_definition") {
+            const name = extractName(child);
+            if (!name)
+                continue;
+            const sig = extractFunctionSignature(child);
+            children.push(new OutlineEntry({
+                kind: "method",
+                name,
+                exported: false,
+                ...(sig !== undefined ? { signature: sig } : {}),
+            }));
+        }
+    }
+    return children;
+}
+function processDeclaration(node, exported) {
+    const kind = nodeKind(node.type);
+    if (!kind)
+        return undefined;
+    const name = extractName(node);
+    if (!name)
+        return undefined;
+    const sig = kind === "function" ? extractFunctionSignature(node) : undefined;
+    const children = kind === "class" ? extractClassChildren(node) : undefined;
+    return new OutlineEntry({
+        kind,
+        name,
+        exported,
+        ...(sig !== undefined ? { signature: sig } : {}),
+        ...(children !== undefined && children.length > 0 ? { children } : {}),
+    });
+}
+function extractArrowSignature(name, arrowNode) {
+    const params = arrowNode.childForFieldName("parameters");
+    const returnType = arrowNode.childForFieldName("return_type");
+    let sig = name;
+    if (params) {
+        sig += params.text;
+    }
+    if (returnType) {
+        const rt = returnType.text.replace(/^:\s*/, "");
+        sig += ": " + rt;
+    }
+    return boundSignature(sig);
+}
+function processLexicalExport(node) {
+    const entries = [];
+    for (const child of node.namedChildren) {
+        if (child.type === "variable_declarator") {
+            const name = extractName(child);
+            if (!name)
+                continue;
+            // Check if the value is an arrow function or function expression
+            const value = child.childForFieldName("value");
+            if (value && (value.type === "arrow_function" || value.type === "function")) {
+                const sig = extractArrowSignature(name, value);
+                entries.push(new OutlineEntry({
+                    kind: "function",
+                    name,
+                    exported: true,
+                    ...(sig !== undefined ? { signature: sig } : {}),
+                }));
+            }
+            else {
+                entries.push(new OutlineEntry({ kind: "export", name, exported: true }));
+            }
+        }
+    }
+    return entries;
+}
+// ---------------------------------------------------------------------------
+// Jump table builder
+// ---------------------------------------------------------------------------
+function buildJumpEntry(name, kind, node) {
+    return new JumpEntry({
+        symbol: name,
+        kind,
+        start: node.startPosition.row + 1,
+        end: node.endPosition.row + 1,
+    });
+}
+// ---------------------------------------------------------------------------
+// Main extraction
+// ---------------------------------------------------------------------------
+/**
+ * Extract a structural outline from source code.
+ *
+ * @param source - The source code text.
+ * @param lang - Structured format identifier. Defaults to `"ts"`.
+ * @returns An {@link OutlineResult} with entries, jump table, and partial flag.
+ */
+export function extractOutline(source, lang = "ts") {
+    if (lang === "md") {
+        return extractMarkdownOutline(source);
+    }
+    const parsed = parseStructuredTree(lang, source);
+    const root = parsed.root;
+    const entries = [];
+    const jumpTable = [];
+    const hasError = root.hasError();
+    for (const child of root.children) {
+        if (child.type === "export_statement") {
+            // export_statement wraps a declaration
+            const inner = child.namedChildren.find((c) => c.type === "function_declaration" ||
+                c.type === "generator_function_declaration" ||
+                c.type === "class_declaration" ||
+                c.type === "interface_declaration" ||
+                c.type === "type_alias_declaration" ||
+                c.type === "enum_declaration");
+            if (inner) {
+                const entry = processDeclaration(inner, true);
+                if (entry) {
+                    entries.push(entry);
+                    jumpTable.push(buildJumpEntry(entry.name, entry.kind, child));
+                }
+                continue;
+            }
+            // Check for lexical declaration (const/let exports)
+            const lexical = child.namedChildren.find((c) => c.type === "lexical_declaration");
+            if (lexical) {
+                const lexEntries = processLexicalExport(lexical);
+                for (const entry of lexEntries) {
+                    entries.push(entry);
+                    jumpTable.push(buildJumpEntry(entry.name, entry.kind, child));
+                }
+                continue;
+            }
+            // Re-exports: export { A, B } from './x'
+            const exportClause = child.namedChildren.find((c) => c.type === "export_clause");
+            if (exportClause) {
+                for (const spec of exportClause.namedChildren) {
+                    if (spec.type === "export_specifier") {
+                        const nameNode = spec.childForFieldName("alias") ?? spec.childForFieldName("name");
+                        if (nameNode) {
+                            entries.push(new OutlineEntry({ kind: "export", name: nameNode.text, exported: true }));
+                            jumpTable.push(buildJumpEntry(nameNode.text, "export", child));
+                        }
+                    }
+                }
+                continue;
+            }
+            // Wildcard re-export: export * from './x'
+            const moduleSpecifier = child.namedChildren.find((c) => c.type === "string");
+            const hasWildcard = child.children.some((c) => c.type === "*" || c.type === "namespace_export");
+            if (hasWildcard && moduleSpecifier) {
+                const name = `* from ${moduleSpecifier.text}`;
+                entries.push(new OutlineEntry({ kind: "export", name, exported: true }));
+                jumpTable.push(buildJumpEntry(name, "export", child));
+                continue;
+            }
+            // Other export forms — skip
+        }
+        else {
+            // Non-exported top-level declaration
+            const kind = nodeKind(child.type);
+            if (kind) {
+                const entry = processDeclaration(child, false);
+                if (entry) {
+                    entries.push(entry);
+                    jumpTable.push(buildJumpEntry(entry.name, entry.kind, child));
+                }
+            }
+        }
+    }
+    parsed.delete();
+    const result = {
+        entries,
+        jumpTable,
+    };
+    if (hasError) {
+        result.partial = true;
+    }
+    return result;
+}
+export function extractOutlineForFile(filePath, source) {
+    const lang = detectStructuredFormat(filePath);
+    if (lang === null) {
+        return null;
+    }
+    return extractOutline(source, lang);
+}
+//# sourceMappingURL=outline.js.map

package/dist/parser/outline.js.map

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

package/dist/parser/runtime.d.ts

@@ -0,0 +1,13 @@
+import Parser from "web-tree-sitter";
+import type { SupportedLang } from "./lang.js";
+export interface ParsedTree {
+    readonly format: SupportedLang;
+    readonly parser: Parser;
+    readonly tree: Parser.Tree;
+    readonly root: Parser.SyntaxNode;
+    readonly source: string;
+    delete(): void;
+}
+export declare function parseStructuredTree(format: SupportedLang, source: string): ParsedTree;
+export declare function parseStructuredTreeForFile(filePath: string, source: string): ParsedTree | null;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/parser/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/parser/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,iBAAiB,CAAC;AAGrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AA2B/C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,UAAU,CAiBZ;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,UAAU,GAAG,IAAI,CAMnB"}

package/dist/parser/runtime.js

@@ -0,0 +1,43 @@
+import Parser from "web-tree-sitter";
+import { createRequire } from "node:module";
+import { detectLang } from "./lang.js";
+const esmRequire = createRequire(import.meta.url);
+await Parser.init();
+const tsLang = await Parser.Language.load(esmRequire.resolve("tree-sitter-wasms/out/tree-sitter-typescript.wasm"));
+const tsxLang = await Parser.Language.load(esmRequire.resolve("tree-sitter-wasms/out/tree-sitter-tsx.wasm"));
+const jsLang = await Parser.Language.load(esmRequire.resolve("tree-sitter-wasms/out/tree-sitter-javascript.wasm"));
+function languageFor(format) {
+    switch (format) {
+        case "ts":
+            return tsLang;
+        case "tsx":
+            return tsxLang;
+        case "js":
+            return jsLang;
+    }
+}
+export function parseStructuredTree(format, source) {
+    const parser = new Parser();
+    parser.setLanguage(languageFor(format));
+    const tree = parser.parse(source);
+    const root = tree.rootNode;
+    return {
+        format,
+        parser,
+        tree,
+        root,
+        source,
+        delete() {
+            tree.delete();
+            parser.delete();
+        },
+    };
+}
+export function parseStructuredTreeForFile(filePath, source) {
+    const format = detectLang(filePath);
+    if (format === null) {
+        return null;
+    }
+    return parseStructuredTree(format, source);
+}
+//# sourceMappingURL=runtime.js.map

package/dist/parser/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/parser/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,iBAAiB,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAElD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;AAEpB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CACvC,UAAU,CAAC,OAAO,CAAC,mDAAmD,CAAC,CACxE,CAAC;AACF,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CACxC,UAAU,CAAC,OAAO,CAAC,4CAA4C,CAAC,CACjE,CAAC;AACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CACvC,UAAU,CAAC,OAAO,CAAC,mDAAmD,CAAC,CACxE,CAAC;AAEF,SAAS,WAAW,CAAC,MAAqB;IACxC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,IAAI;YACP,OAAO,MAAM,CAAC;QAChB,KAAK,KAAK;YACR,OAAO,OAAO,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAWD,MAAM,UAAU,mBAAmB,CACjC,MAAqB,EACrB,MAAc;IAEd,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;IAE3B,OAAO;QACL,MAAM;QACN,MAAM;QACN,IAAI;QACJ,IAAI;QACJ,MAAM;QACN,MAAM;YACJ,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAAgB,EAChB,MAAc;IAEd,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC"}

package/dist/parser/types.d.ts

@@ -0,0 +1,41 @@
+/** The kind of a top-level or member declaration. */
+export type EntryKind = "function" | "class" | "method" | "interface" | "type" | "enum" | "export" | "heading";
+/** A single entry in a file outline. */
+export declare class OutlineEntry {
+    /** @internal Brand prevents structural forgery from plain objects. */
+    private readonly _brand;
+    readonly kind: EntryKind;
+    readonly name: string;
+    readonly signature?: string;
+    readonly exported: boolean;
+    readonly children?: readonly OutlineEntry[];
+    constructor(opts: {
+        kind: EntryKind;
+        name: string;
+        exported: boolean;
+        signature?: string;
+        children?: readonly OutlineEntry[];
+    });
+}
+/** A jump-table entry mapping a symbol to its 1-based line range. */
+export declare class JumpEntry {
+    /** @internal Brand prevents structural forgery from plain objects. */
+    private readonly _brand;
+    readonly symbol: string;
+    readonly kind: string;
+    readonly start: number;
+    readonly end: number;
+    constructor(opts: {
+        symbol: string;
+        kind: string;
+        start: number;
+        end: number;
+    });
+}
+/** Result of outline extraction. */
+export interface OutlineResult {
+    entries: OutlineEntry[];
+    jumpTable?: JumpEntry[];
+    partial?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/parser/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/parser/types.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,OAAO,GACP,QAAQ,GACR,WAAW,GACX,MAAM,GACN,MAAM,GACN,QAAQ,GACR,SAAS,CAAC;AAEd,wCAAwC;AACxC,qBAAa,YAAY;IACvB,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;gBAEhC,IAAI,EAAE;QAChB,IAAI,EAAE,SAAS,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;KACpC;CAWF;AAED,qEAAqE;AACrE,qBAAa,SAAS;IACpB,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb;CAaF;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/parser/types.js

@@ -0,0 +1,46 @@
+/** A single entry in a file outline. */
+export class OutlineEntry {
+    /** @internal Brand prevents structural forgery from plain objects. */
+    _brand = "OutlineEntry";
+    kind;
+    name;
+    signature;
+    exported;
+    children;
+    constructor(opts) {
+        if (opts.name.trim().length === 0) {
+            throw new Error("OutlineEntry: name must be non-empty");
+        }
+        this.kind = opts.kind;
+        this.name = opts.name.trim();
+        this.exported = opts.exported;
+        if (opts.signature !== undefined)
+            this.signature = opts.signature;
+        if (opts.children !== undefined)
+            this.children = Object.freeze([...opts.children]);
+        Object.freeze(this);
+    }
+}
+/** A jump-table entry mapping a symbol to its 1-based line range. */
+export class JumpEntry {
+    /** @internal Brand prevents structural forgery from plain objects. */
+    _brand = "JumpEntry";
+    symbol;
+    kind;
+    start; // 1-based line
+    end; // 1-based line
+    constructor(opts) {
+        if (!Number.isInteger(opts.start) || opts.start < 1) {
+            throw new Error("JumpEntry: start must be an integer >= 1");
+        }
+        if (!Number.isInteger(opts.end) || opts.end < opts.start) {
+            throw new Error("JumpEntry: end must be an integer >= start");
+        }
+        this.symbol = opts.symbol;
+        this.kind = opts.kind;
+        this.start = opts.start;
+        this.end = opts.end;
+        Object.freeze(this);
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/parser/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/parser/types.ts"],"names":[],"mappings":"AAWA,wCAAwC;AACxC,MAAM,OAAO,YAAY;IACvB,sEAAsE;IACrD,MAAM,GAAG,cAAuB,CAAC;IACzC,IAAI,CAAY;IAChB,IAAI,CAAS;IACb,SAAS,CAAU;IACnB,QAAQ,CAAU;IAClB,QAAQ,CAA2B;IAE5C,YAAY,IAMX;QACC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAClE,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,OAAO,SAAS;IACpB,sEAAsE;IACrD,MAAM,GAAG,WAAoB,CAAC;IACtC,MAAM,CAAS;IACf,IAAI,CAAS;IACb,KAAK,CAAS,CAAC,eAAe;IAC9B,GAAG,CAAS,CAAC,eAAe;IAErC,YAAY,IAKX;QACC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;CACF"}

package/dist/policy/evaluate.d.ts

@@ -0,0 +1,8 @@
+import type { PolicyInput, PolicyOptions } from "./types.js";
+import type { PolicyResult } from "./types.js";
+export declare const STATIC_THRESHOLDS: {
+    readonly lines: 150;
+    readonly bytes: 12288;
+};
+export declare function evaluatePolicy(input: PolicyInput, options?: PolicyOptions): PolicyResult;
+//# sourceMappingURL=evaluate.d.ts.map

package/dist/policy/evaluate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/policy/evaluate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAA6B,MAAM,YAAY,CAAC;AAExF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,iBAAiB;;;CAAwC,CAAC;AA0FvE,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CAkFxF"}