@terreno/mcp 0.21.0

package/dist/resources.d.ts

@@ -0,0 +1,76 @@
+interface TypeDocType {
+    type: string;
+    name?: string;
+    value?: unknown;
+    types?: TypeDocType[];
+    elementType?: TypeDocType;
+    typeArguments?: TypeDocType[];
+    declaration?: {
+        signatures?: unknown[];
+    };
+}
+interface TypeDocProp {
+    id: number;
+    name: string;
+    variant: string;
+    kind: number;
+    flags: {
+        isOptional?: boolean;
+    };
+    comment?: {
+        summary?: {
+            kind: string;
+            text: string;
+        }[];
+        blockTags?: {
+            tag: string;
+            content: {
+                kind: string;
+                text: string;
+            }[];
+        }[];
+    };
+    type?: TypeDocType;
+}
+interface TypeDocInterface {
+    id: number;
+    name: string;
+    variant: string;
+    kind: number;
+    children?: TypeDocProp[];
+}
+interface TypeDocModule {
+    id: number;
+    name: string;
+    children?: TypeDocInterface[];
+}
+export interface TypeDocRoot {
+    children?: TypeDocModule[];
+}
+interface ComponentDoc {
+    name: string;
+    interfaceName: string;
+    props: {
+        name: string;
+        type: string;
+        description: string;
+        required: boolean;
+        defaultValue?: string;
+    }[];
+}
+export declare const loadTypeDocJson: () => TypeDocRoot | null;
+export declare const extractTypeString: (typeObj: TypeDocType | null | undefined) => string;
+export declare const parseComponentsFromTypeDoc: (typeDoc: TypeDocRoot) => ComponentDoc[];
+export declare const componentToSlug: (name: string) => string;
+export declare const formatComponentMarkdown: (component: ComponentDoc) => string;
+export declare const generateComponentListMarkdown: (components: ComponentDoc[]) => string;
+interface Resource {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    content: string;
+}
+export declare const resources: Resource[];
+export {};
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAUA,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE;QAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAA;KAAC,CAAC;CACxC;AAED,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAC,CAAC;IAC9B,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,EAAE,CAAC;QACzC,SAAS,CAAC,EAAE;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE;gBAAC,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAA;aAAC,EAAE,CAAA;SAAC,EAAE,CAAC;KACtE,CAAC;IACF,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,UAAU,aAAa;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,EAAE,CAAC;CACL;AAED,eAAO,MAAM,eAAe,QAAO,WAAW,GAAG,IAMhD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,SAAS,WAAW,GAAG,IAAI,GAAG,SAAS,KAAG,MAqC3E,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,SAAS,WAAW,KAAG,YAAY,EAyC7E,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAE9C,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,WAAW,YAAY,KAAG,MAwBjE,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAI,YAAY,YAAY,EAAE,KAAG,MAwC1E,CAAC;AAEF,UAAU,QAAQ;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AA2ED,eAAO,MAAM,SAAS,EAAE,QAAQ,EAAqB,CAAC"}

package/dist/resources.js

@@ -0,0 +1,214 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { getDocsRoot } from "./docsRoot.js";
+const loadMarkdown = (filename) => {
+    const filePath = join(getDocsRoot(), "resources", filename);
+    return readFileSync(filePath, "utf-8");
+};
+export const loadTypeDocJson = () => {
+    const filePath = join(getDocsRoot(), "ui-types-documentation.json");
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    return JSON.parse(readFileSync(filePath, "utf-8"));
+};
+export const extractTypeString = (typeObj) => {
+    if (!typeObj) {
+        return "unknown";
+    }
+    if (typeObj.type === "intrinsic") {
+        return typeObj.name ?? "unknown";
+    }
+    if (typeObj.type === "literal") {
+        return JSON.stringify(typeObj.value) ?? "unknown";
+    }
+    if (typeObj.type === "union") {
+        return typeObj.types?.map((t) => extractTypeString(t)).join(" | ") ?? "unknown";
+    }
+    if (typeObj.type === "array") {
+        return `${extractTypeString(typeObj.elementType)}[]`;
+    }
+    if (typeObj.type === "reference") {
+        if (typeObj.typeArguments) {
+            const args = typeObj.typeArguments.map((t) => extractTypeString(t)).join(", ");
+            return `${typeObj.name ?? "unknown"}<${args}>`;
+        }
+        return typeObj.name ?? "unknown";
+    }
+    if (typeObj.type === "reflection" && typeObj.declaration) {
+        if (typeObj.declaration.signatures) {
+            return "function";
+        }
+        return "object";
+    }
+    return typeObj.name ?? "unknown";
+};
+export const parseComponentsFromTypeDoc = (typeDoc) => {
+    const commonModule = typeDoc.children?.find((m) => m.name === "Common");
+    if (!commonModule?.children) {
+        return [];
+    }
+    // Filter to only Props interfaces (convention: ends with "Props")
+    const propsInterfaces = commonModule.children.filter((child) => child.name.endsWith("Props") && child.kind === 256 // Interface kind
+    );
+    return propsInterfaces.map((iface) => {
+        const props = iface.children?.map((prop) => {
+            const description = prop.comment?.summary?.map((s) => s.text).join("") ?? "";
+            const defaultTag = prop.comment?.blockTags?.find((tag) => tag.tag === "@default");
+            const defaultValue = defaultTag?.content
+                ?.map((c) => c.text)
+                .join("")
+                .replace(/```ts?\n?/g, "")
+                .replace(/```/g, "")
+                .trim();
+            return {
+                description,
+                name: prop.name,
+                required: !prop.flags?.isOptional,
+                type: extractTypeString(prop.type),
+                ...(defaultValue && { defaultValue }),
+            };
+        }) ?? [];
+        // Derive component name from interface name (e.g., "ButtonProps" -> "Button")
+        const componentName = iface.name.replace(/Props$/, "");
+        return {
+            interfaceName: iface.name,
+            name: componentName,
+            props,
+        };
+    });
+};
+export const componentToSlug = (name) => {
+    return name.toLowerCase().replace(/\s+/g, "-");
+};
+export const formatComponentMarkdown = (component) => {
+    const lines = [
+        `# ${component.name}`,
+        "",
+        `**Interface:** \`${component.interfaceName}\``,
+        "",
+    ];
+    // Props
+    if (component.props.length > 0) {
+        lines.push("## Props");
+        lines.push("");
+        lines.push("| Name | Type | Required | Description |");
+        lines.push("|------|------|----------|-------------|");
+        for (const prop of component.props) {
+            const required = prop.required ? "Yes" : "No";
+            const desc = prop.description || "-";
+            const defaultStr = prop.defaultValue ? ` (default: \`${prop.defaultValue}\`)` : "";
+            lines.push(`| \`${prop.name}\` | \`${prop.type}\` | ${required} | ${desc}${defaultStr} |`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+};
+export const generateComponentListMarkdown = (components) => {
+    const lines = [
+        "# @terreno/ui Component Reference",
+        "",
+        "Complete props documentation for all UI components extracted from TypeScript interfaces.",
+        "",
+        `**Total Components:** ${components.length}`,
+        "",
+        "## All Components (Alphabetical)",
+        "",
+        "| Component | Interface | Props Count |",
+        "|-----------|-----------|-------------|",
+    ];
+    for (const comp of components.sort((a, b) => a.name.localeCompare(b.name))) {
+        lines.push(`| ${comp.name} | \`${comp.interfaceName}\` | ${comp.props.length} |`);
+    }
+    lines.push("");
+    lines.push("## Quick Reference");
+    lines.push("");
+    for (const comp of components.sort((a, b) => a.name.localeCompare(b.name))) {
+        lines.push(`### ${comp.name}`);
+        lines.push("");
+        if (comp.props.length > 0) {
+            const requiredProps = comp.props.filter((p) => p.required);
+            const optionalProps = comp.props.filter((p) => !p.required);
+            if (requiredProps.length > 0) {
+                lines.push(`**Required:** ${requiredProps.map((p) => `\`${p.name}\``).join(", ")}`);
+            }
+            if (optionalProps.length > 0) {
+                lines.push(`**Optional:** ${optionalProps.map((p) => `\`${p.name}\``).join(", ")}`);
+            }
+        }
+        else {
+            lines.push("*No props*");
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+};
+const buildResources = () => {
+    const staticResources = [
+        {
+            content: loadMarkdown("overview.md"),
+            description: "Overview of the Terreno monorepo and its packages",
+            mimeType: "text/markdown",
+            name: "Terreno Overview",
+            uri: "terreno://docs/overview",
+        },
+        {
+            content: loadMarkdown("api.md"),
+            description: "Complete documentation for the @terreno/api package",
+            mimeType: "text/markdown",
+            name: "@terreno/api Documentation",
+            uri: "terreno://docs/api",
+        },
+        {
+            content: loadMarkdown("ui.md"),
+            description: "Complete documentation for the @terreno/ui package",
+            mimeType: "text/markdown",
+            name: "@terreno/ui Documentation",
+            uri: "terreno://docs/ui",
+        },
+        {
+            content: loadMarkdown("rtk.md"),
+            description: "Complete documentation for the @terreno/rtk package",
+            mimeType: "text/markdown",
+            name: "@terreno/rtk Documentation",
+            uri: "terreno://docs/rtk",
+        },
+        {
+            content: loadMarkdown("patterns.md"),
+            description: "Common patterns and best practices for Terreno development",
+            mimeType: "text/markdown",
+            name: "Terreno Patterns & Best Practices",
+            uri: "terreno://docs/patterns",
+        },
+    ];
+    // Load component documentation from TypeDoc JSON
+    const typeDoc = loadTypeDocJson();
+    const componentResources = [];
+    if (typeDoc) {
+        const componentDocs = parseComponentsFromTypeDoc(typeDoc);
+        if (componentDocs.length > 0) {
+            // Add component list resource
+            componentResources.push({
+                content: generateComponentListMarkdown(componentDocs),
+                description: "List of all @terreno/ui components with their props",
+                mimeType: "text/markdown",
+                name: "@terreno/ui Component Reference",
+                uri: "terreno://docs/ui/components",
+            });
+            // Add individual component resources
+            for (const component of componentDocs) {
+                const slug = componentToSlug(component.name);
+                componentResources.push({
+                    content: formatComponentMarkdown(component),
+                    description: `Props documentation for the ${component.name} component`,
+                    mimeType: "text/markdown",
+                    name: `${component.name} Component`,
+                    uri: `terreno://docs/ui/components/${slug}`,
+                });
+            }
+        }
+    }
+    return [...staticResources, ...componentResources];
+};
+export const resources = buildResources();
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

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

package/dist/search/chunker.d.ts

@@ -0,0 +1,24 @@
+export interface MarkdownChunk {
+    /** Stable id for deduplication and MiniSearch */
+    id: string;
+    /** Path relative to docs root (POSIX-style) */
+    sourcePath: string;
+    /** Nearest heading text for this chunk */
+    title: string;
+    /** Heading trail (e.g. "Guide > Setup") */
+    breadcrumb: string;
+    /** Searchable body (heading line may repeat for BM25) */
+    text: string;
+    /** Short package ids for filtering (api, ui, rtk, docs, …) */
+    packageTags: string[];
+}
+/**
+ * Fallback chunk when markdown has no extractable heading sections but is non-empty.
+ * Exported for unit tests (the `chunkMarkdown` path delegates here).
+ */
+export declare const standaloneDocumentChunk: (sourcePath: string, raw: string, packageTags: string[]) => MarkdownChunk;
+/**
+ * Split markdown into heading-scoped chunks with breadcrumb titles for search indexing.
+ */
+export declare const chunkMarkdown: (sourcePath: string, raw: string, packageTags: string[]) => MarkdownChunk[];
+//# sourceMappingURL=chunker.d.ts.map

package/dist/search/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/search/chunker.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAaD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAClC,YAAY,MAAM,EAClB,KAAK,MAAM,EACX,aAAa,MAAM,EAAE,KACpB,aAOD,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,GACxB,YAAY,MAAM,EAClB,KAAK,MAAM,EACX,aAAa,MAAM,EAAE,KACpB,aAAa,EAqDf,CAAC"}

package/dist/search/chunker.js

@@ -0,0 +1,74 @@
+import { createHash } from "node:crypto";
+const HEADING_RE = /^(#{1,6})\s+(.+)$/;
+const stableChunkId = (sourcePath, headingTrail, body) => createHash("sha256")
+    .update(sourcePath)
+    .update("\0")
+    .update(headingTrail.join(">"))
+    .update("\0")
+    .update(body)
+    .digest("hex");
+/**
+ * Fallback chunk when markdown has no extractable heading sections but is non-empty.
+ * Exported for unit tests (the `chunkMarkdown` path delegates here).
+ */
+export const standaloneDocumentChunk = (sourcePath, raw, packageTags) => ({
+    breadcrumb: sourcePath,
+    id: stableChunkId(sourcePath, [], raw),
+    packageTags: [...packageTags],
+    sourcePath,
+    text: raw.trim(),
+    title: "(document)",
+});
+/**
+ * Split markdown into heading-scoped chunks with breadcrumb titles for search indexing.
+ */
+export const chunkMarkdown = (sourcePath, raw, packageTags) => {
+    const lines = raw.split(/\r?\n/);
+    const chunks = [];
+    /** Stack of {level, title} for open headings */
+    const stack = [];
+    let buf = [];
+    let currentTitle = "";
+    const flush = () => {
+        const text = buf.join("\n").trim();
+        if (!text) {
+            buf = [];
+            return;
+        }
+        const trail = stack.map((s) => s.title);
+        const breadcrumb = trail.length ? trail.join(" > ") : sourcePath;
+        const title = currentTitle || trail[trail.length - 1] || "(intro)";
+        const id = stableChunkId(sourcePath, trail, text);
+        chunks.push({
+            breadcrumb,
+            id,
+            packageTags: [...packageTags],
+            sourcePath,
+            text: `${breadcrumb}\n\n${text}`,
+            title,
+        });
+        buf = [];
+    };
+    for (const line of lines) {
+        const m = line.match(HEADING_RE);
+        if (m) {
+            flush();
+            const level = m[1].length;
+            const headingText = m[2].trim();
+            while (stack.length && stack[stack.length - 1].level >= level) {
+                stack.pop();
+            }
+            stack.push({ level, title: headingText });
+            currentTitle = headingText;
+            buf.push(line);
+            continue;
+        }
+        buf.push(line);
+    }
+    flush();
+    if (chunks.length === 0 && raw.trim()) {
+        chunks.push(standaloneDocumentChunk(sourcePath, raw, packageTags));
+    }
+    return chunks;
+};
+//# sourceMappingURL=chunker.js.map

package/dist/search/chunker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.js","sourceRoot":"","sources":["../../src/search/chunker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AAiBvC,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAEvC,MAAM,aAAa,GAAG,CAAC,UAAkB,EAAE,YAAsB,EAAE,IAAY,EAAU,EAAE,CACzF,UAAU,CAAC,QAAQ,CAAC;KACjB,MAAM,CAAC,UAAU,CAAC;KAClB,MAAM,CAAC,IAAI,CAAC;KACZ,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;KAC9B,MAAM,CAAC,IAAI,CAAC;KACZ,MAAM,CAAC,IAAI,CAAC;KACZ,MAAM,CAAC,KAAK,CAAC,CAAC;AAEnB;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,UAAkB,EAClB,GAAW,EACX,WAAqB,EACN,EAAE,CAAC,CAAC;IACnB,UAAU,EAAE,UAAU;IACtB,EAAE,EAAE,aAAa,CAAC,UAAU,EAAE,EAAE,EAAE,GAAG,CAAC;IACtC,WAAW,EAAE,CAAC,GAAG,WAAW,CAAC;IAC7B,UAAU;IACV,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE;IAChB,KAAK,EAAE,YAAY;CACpB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,UAAkB,EAClB,GAAW,EACX,WAAqB,EACJ,EAAE;IACnB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,gDAAgD;IAChD,MAAM,KAAK,GAAqC,EAAE,CAAC;IACnD,IAAI,GAAG,GAAa,EAAE,CAAC;IACvB,IAAI,YAAY,GAAG,EAAE,CAAC;IAEtB,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,GAAG,GAAG,EAAE,CAAC;YACT,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QACjE,MAAM,KAAK,GAAG,YAAY,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;QACnE,MAAM,EAAE,GAAG,aAAa,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC;YACV,UAAU;YACV,EAAE;YACF,WAAW,EAAE,CAAC,GAAG,WAAW,CAAC;YAC7B,UAAU;YACV,IAAI,EAAE,GAAG,UAAU,OAAO,IAAI,EAAE;YAChC,KAAK;SACN,CAAC,CAAC;QACH,GAAG,GAAG,EAAE,CAAC;IACX,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,CAAC;YACN,KAAK,EAAE,CAAC;YACR,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAC1B,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,EAAE,CAAC;gBAC9D,KAAK,CAAC,GAAG,EAAE,CAAC;YACd,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAC,CAAC,CAAC;YACxC,YAAY,GAAG,WAAW,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,KAAK,EAAE,CAAC;IAER,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,UAAU,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/search/docIndex.d.ts

@@ -0,0 +1,13 @@
+import { type MarkdownChunk } from "./chunker.js";
+export interface SearchableChunk extends MarkdownChunk {
+    combined: string;
+}
+export declare const resetDocSearchIndexForTests: () => void;
+export interface SearchDocsParams {
+    queries: string[];
+    packages?: string[];
+    tokenLimit?: number;
+}
+export declare const searchDocs: (params: SearchDocsParams) => string;
+export declare const getComponentDocsMarkdown: (componentName: string) => string;
+//# sourceMappingURL=docIndex.d.ts.map

package/dist/search/docIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docIndex.d.ts","sourceRoot":"","sources":["../../src/search/docIndex.ts"],"names":[],"mappings":"AAUA,OAAO,EAAgB,KAAK,aAAa,EAAC,MAAM,cAAc,CAAC;AAG/D,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,QAAQ,EAAE,MAAM,CAAC;CAClB;AA2HD,eAAO,MAAM,2BAA2B,QAAO,IAG9C,CAAC;AAYF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAyBD,eAAO,MAAM,UAAU,GAAI,QAAQ,gBAAgB,KAAG,MAqFrD,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,eAAe,MAAM,KAAG,MAiDhE,CAAC"}