tskb 0.0.1

package/dist/core/visualization/dot-generator.js

@@ -0,0 +1,200 @@
+/**
+ * Generate a Graphviz DOT file from a knowledge graph.
+ *
+ * This creates a hierarchical visualization showing:
+ * - Folders as nested subgraphs (boxes)
+ * - Modules within their folders (ellipses)
+ * - Terms as separate cluster (diamonds)
+ * - Docs as separate cluster (notes)
+ * - Reference relationships as directed edges
+ */
+export function generateDot(graph) {
+    const lines = [];
+    // Build folder hierarchy map
+    const folderChildren = new Map();
+    const modulesByFolder = new Map();
+    const exportsByFolder = new Map();
+    const exportsByModule = new Map();
+    for (const edge of graph.edges) {
+        if (edge.type === "contains") {
+            if (!folderChildren.has(edge.from)) {
+                folderChildren.set(edge.from, []);
+            }
+            folderChildren.get(edge.from).push(edge.to);
+        }
+        if (edge.type === "belongs-to") {
+            const fromNode = graph.nodes.modules[edge.from] || graph.nodes.exports[edge.from];
+            if (fromNode?.type === "module") {
+                if (!modulesByFolder.has(edge.to)) {
+                    modulesByFolder.set(edge.to, []);
+                }
+                modulesByFolder.get(edge.to).push(edge.from);
+            }
+            else if (fromNode?.type === "export") {
+                // Check if export belongs to a module or folder
+                const toNode = graph.nodes.modules[edge.to] || graph.nodes.folders[edge.to];
+                if (toNode?.type === "module") {
+                    if (!exportsByModule.has(edge.to)) {
+                        exportsByModule.set(edge.to, []);
+                    }
+                    exportsByModule.get(edge.to).push(edge.from);
+                }
+                else if (toNode?.type === "folder") {
+                    if (!exportsByFolder.has(edge.to)) {
+                        exportsByFolder.set(edge.to, []);
+                    }
+                    exportsByFolder.get(edge.to).push(edge.from);
+                }
+            }
+        }
+    }
+    // Header
+    lines.push("digraph KnowledgeGraph {");
+    lines.push("  rankdir=TB;");
+    lines.push("  compound=true;");
+    lines.push('  node [fontname="Arial", fontsize=10];');
+    lines.push('  edge [fontname="Arial", fontsize=8];');
+    lines.push("");
+    // Generate folder hierarchy
+    const rootFolders = Object.keys(graph.nodes.folders).filter((id) => !graph.edges.some((e) => e.type === "contains" && e.to === id));
+    for (const rootId of rootFolders) {
+        generateFolderSubgraph(rootId, graph, folderChildren, modulesByFolder, exportsByFolder, exportsByModule, lines, 1);
+    }
+    // Terms (outside folder hierarchy)
+    lines.push("  // Terms");
+    lines.push("  subgraph cluster_terms {");
+    lines.push('    label="Terms";');
+    lines.push("    style=dashed;");
+    lines.push("    color=gray;");
+    for (const [id, node] of Object.entries(graph.nodes.terms)) {
+        const label = formatLabel(id, node.desc, undefined, "term");
+        lines.push(`    "${id}" [label="${label}", shape=diamond, fillcolor="#F0F4C3", style=filled];`);
+    }
+    lines.push("  }");
+    lines.push("");
+    // Docs (outside folder hierarchy)
+    lines.push("  // Documentation");
+    lines.push("  subgraph cluster_docs {");
+    lines.push('    label="Documentation";');
+    lines.push("    style=dashed;");
+    lines.push("    color=gray;");
+    for (const [id, node] of Object.entries(graph.nodes.docs)) {
+        // Strip HTML tags from content for cleaner visualization
+        // Tags are preserved in the JSON for semantic meaning
+        const cleanContent = node.content
+            .replace(/<[^>]+>/g, "") // Remove all HTML tags
+            .substring(0, 100)
+            .replace(/"/g, '\\"')
+            .replace(/\n/g, "\\n");
+        // Use id (relative path) instead of filePath (absolute path) for portability
+        const label = `${id}\\n${cleanContent}...\\n📄 ${id}`;
+        lines.push(`    "${id}" [label="${label}", shape=note, fillcolor="#E1BEE7", style=filled];`);
+    }
+    lines.push("  }");
+    lines.push("");
+    // Edges
+    lines.push("  // Relationships");
+    const edgesByType = {};
+    for (const edge of graph.edges) {
+        // Skip hierarchy edges as they're shown by subgraph nesting
+        if (edge.type === "contains" || edge.type === "belongs-to")
+            continue;
+        if (!edgesByType[edge.type]) {
+            edgesByType[edge.type] = [];
+        }
+        edgesByType[edge.type].push(`  "${edge.from}" -> "${edge.to}";`);
+    }
+    // Group edges by type with different styles
+    const edgeStyles = {
+        references: "[color=grey, style=dashed]",
+    };
+    for (const [type, edges] of Object.entries(edgesByType)) {
+        lines.push(`  // ${type} edges`);
+        const style = edgeStyles[type] || "";
+        for (const edge of edges) {
+            lines.push(edge.replace(";", ` ${style};`));
+        }
+        lines.push("");
+    }
+    // Footer
+    lines.push("}");
+    return lines.join("\n");
+}
+/**
+ * Generate a folder subgraph with nested folders and modules
+ */
+function generateFolderSubgraph(folderId, graph, folderChildren, modulesByFolder, exportsByFolder, exportsByModule, lines, depth) {
+    const folder = graph.nodes.folders[folderId];
+    if (!folder)
+        return;
+    const indent = "  ".repeat(depth);
+    const clusterId = `cluster_${folderId.replace(/\./g, "_")}`;
+    lines.push(`${indent}subgraph ${clusterId} {`);
+    lines.push(`${indent}  label="${folderId}";`);
+    lines.push(`${indent}  style=filled;`);
+    lines.push(`${indent}  fillcolor="#E3F2FD";`);
+    lines.push(`${indent}  color="#1976D2";`);
+    lines.push("");
+    // Add folder node itself
+    const folderLabel = formatLabel(folderId, folder.desc, folder.path, "folder");
+    lines.push(`${indent}  "${folderId}" [label="${folderLabel}", shape=box, fillcolor="#BBDEFB", style=filled];`);
+    lines.push("");
+    // Add modules that belong to this folder
+    const modules = modulesByFolder.get(folderId) || [];
+    if (modules.length > 0) {
+        lines.push(`${indent}  // Modules in ${folderId}`);
+        for (const moduleId of modules) {
+            const module = graph.nodes.modules[moduleId];
+            if (module) {
+                const label = formatLabel(moduleId, module.desc, module.resolvedPath, "module");
+                lines.push(`${indent}  "${moduleId}" [label="${label}", shape=ellipse, fillcolor="#FFF9C4", style=filled];`);
+                // Add exports that belong to this module
+                const moduleExports = exportsByModule.get(moduleId) || [];
+                for (const exportId of moduleExports) {
+                    const exp = graph.nodes.exports[exportId];
+                    if (exp) {
+                        const exportLabel = formatLabel(exportId, exp.desc, exp.resolvedPath, "export");
+                        lines.push(`${indent}    "${exportId}" [label="${exportLabel}", shape=component, fillcolor="#C5E1A5", style=filled];`);
+                    }
+                }
+            }
+        }
+        lines.push("");
+    }
+    // Add exports that belong directly to this folder (no module)
+    const folderExports = exportsByFolder.get(folderId) || [];
+    if (folderExports.length > 0) {
+        lines.push(`${indent}  // Exports in ${folderId}`);
+        for (const exportId of folderExports) {
+            const exp = graph.nodes.exports[exportId];
+            if (exp) {
+                const label = formatLabel(exportId, exp.desc, exp.resolvedPath, "export");
+                lines.push(`${indent}  "${exportId}" [label="${label}", shape=component, fillcolor="#C5E1A5", style=filled];`);
+            }
+        }
+        lines.push("");
+    }
+    // Recursively add child folders
+    const children = folderChildren.get(folderId) || [];
+    for (const childId of children) {
+        generateFolderSubgraph(childId, graph, folderChildren, modulesByFolder, exportsByFolder, exportsByModule, lines, depth + 1);
+    }
+    lines.push(`${indent}}`);
+    lines.push("");
+}
+/**
+ * Format a node label with ID, description, and optional path
+ */
+function formatLabel(id, desc, path, type) {
+    // Escape quotes and newlines
+    const escapedDesc = desc.replace(/"/g, '\\"').replace(/\n/g, "\\n");
+    const escapedPath = path ? path.replace(/"/g, '\\"') : "";
+    // Format with type syntax - escape inner quotes for DOT format
+    const typeName = type ? type.charAt(0).toUpperCase() + type.slice(1) : "";
+    const typePrefix = type ? `${typeName}\\<\\"${id}\\"\\>\\n` : `${id}\\n`;
+    if (escapedPath) {
+        return `${typePrefix}${escapedDesc}\\n📁 ${escapedPath}`;
+    }
+    return `${typePrefix}${escapedDesc}`;
+}
+//# sourceMappingURL=dot-generator.js.map

package/dist/core/visualization/dot-generator.js.map

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

package/dist/core/visualization/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Visualization Module - Generates visual representations of knowledge graphs
+ *
+ * Public API for creating visualizations from knowledge graphs.
+ */
+export { generateDot } from "./dot-generator.js";
+/**
+ * Generate a Graphviz DOT file from a knowledge graph.
+ *
+ * Creates a hierarchical visualization with:
+ * - Nested folder subgraphs
+ * - Modules grouped within folders
+ * - Terms and docs in separate clusters
+ * - Colored edges showing relationships
+ *
+ * @param graph - Knowledge graph to visualize
+ * @returns DOT file content as a string
+ */
+export declare function generateDotGraph(graph: import("../graph/types.js").KnowledgeGraph): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/visualization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/visualization/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,mBAAmB,EAAE,cAAc,GAAG,MAAM,CAE1F"}

package/dist/core/visualization/index.js

@@ -0,0 +1,23 @@
+/**
+ * Visualization Module - Generates visual representations of knowledge graphs
+ *
+ * Public API for creating visualizations from knowledge graphs.
+ */
+import { generateDot } from "./dot-generator.js";
+export { generateDot } from "./dot-generator.js";
+/**
+ * Generate a Graphviz DOT file from a knowledge graph.
+ *
+ * Creates a hierarchical visualization with:
+ * - Nested folder subgraphs
+ * - Modules grouped within folders
+ * - Terms and docs in separate clusters
+ * - Colored edges showing relationships
+ *
+ * @param graph - Knowledge graph to visualize
+ * @returns DOT file content as a string
+ */
+export function generateDotGraph(graph) {
+    return generateDot(graph);
+}
+//# sourceMappingURL=index.js.map

package/dist/core/visualization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/visualization/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiD;IAChF,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * tskb - TypeScript Semantic Knowledge Base
+ *
+ * Public API for building and visualizing knowledge graphs from TypeScript projects.
+ */
+export type { Term, Module, Folder, Export } from "./runtime/registry.js";
+export * from "./runtime/jsx.js";
+export { ref } from "./runtime/jsx.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC1E,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * tskb - TypeScript Semantic Knowledge Base
+ *
+ * Public API for building and visualizing knowledge graphs from TypeScript projects.
+ */
+export * from "./runtime/jsx.js";
+export { ref } from "./runtime/jsx.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/jsx-runtime.d.ts

@@ -0,0 +1,7 @@
+export * from "./runtime/jsx.js";
+export declare function jsx(type: any, props: any): any;
+export declare const jsxs: typeof jsx;
+export declare const Fragment: ({ children }: {
+    children: any;
+}) => any;
+//# sourceMappingURL=jsx-runtime.d.ts.map

package/dist/jsx-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.d.ts","sourceRoot":"","sources":["../src/jsx-runtime.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AAEjC,wBAAgB,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,OAKxC;AAED,eAAO,MAAM,IAAI,YAAM,CAAC;AACxB,eAAO,MAAM,QAAQ,GAAI,cAAc;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,QAAa,CAAC"}

package/dist/jsx-runtime.js

@@ -0,0 +1,11 @@
+// JSX runtime for react-jsx transform
+export * from "./runtime/jsx.js";
+export function jsx(type, props) {
+    if (typeof type === "function") {
+        return type(props);
+    }
+    return { type, props };
+}
+export const jsxs = jsx;
+export const Fragment = ({ children }) => children;
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/jsx-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.js","sourceRoot":"","sources":["../src/jsx-runtime.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,cAAc,kBAAkB,CAAC;AAEjC,MAAM,UAAU,GAAG,CAAC,IAAS,EAAE,KAAU;IACvC,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,CAAC;AACxB,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EAAE,QAAQ,EAAqB,EAAE,EAAE,CAAC,QAAQ,CAAC"}

package/dist/runtime/jsx.d.ts

@@ -0,0 +1,84 @@
+/**
+ * tskb ReactNode type - pure documentation node types without React dependency
+ *
+ * Supports:
+ * - Primitives: string, number, boolean, null, undefined
+ * - Arrays of nodes
+ * - Ref assertions: objects with desc and either path or type properties
+ */
+export type ReactNode = string | number | boolean | null | undefined | ReactNode[] | {
+    desc: string;
+    path: string;
+} | {
+    desc: string;
+    type: unknown;
+};
+export declare const ref: ReactNode;
+/**
+ * Documentation container - just renders children
+ */
+export declare function Doc({ children }: {
+    children: any;
+}): any;
+export declare function H1({ children }: {
+    children: any;
+}): any;
+export declare function H2({ children }: {
+    children: any;
+}): any;
+export declare function H3({ children }: {
+    children: any;
+}): any;
+export declare function P({ children }: {
+    children: any;
+}): any;
+export declare function List({ children }: {
+    children: any;
+}): any;
+export declare function Li({ children }: {
+    children: any;
+}): any;
+/**
+ * Code snippet component - embeds executable code for documentation
+ *
+ * Usage:
+ *   <Snippet code={() => {
+ *     const result = someFunction();
+ *     return result;
+ *   }} />
+ *
+ * The function is converted to a string and stored in the knowledge graph.
+ */
+export declare function Snippet({ code }: {
+    code: () => any;
+}): any;
+/**
+ * Architecture Decision Record component
+ *
+ * Usage:
+ *   <Adr
+ *     id="001"
+ *     title="Use React for UI layer"
+ *     status="accepted"
+ *     date="2024-01-15"
+ *     deciders="Tech Team"
+ *   >
+ *     <H2>Context</H2>
+ *     <P>We need a UI framework...</P>
+ *
+ *     <H2>Decision</H2>
+ *     <P>We will use React...</P>
+ *
+ *     <H2>Consequences</H2>
+ *     <P>Positive: Large ecosystem...</P>
+ *   </Adr>
+ */
+export declare function Adr({ id, title, status, date, deciders, children, }: {
+    id: string;
+    title: string;
+    status: "proposed" | "accepted" | "deprecated" | "superseded";
+    date?: string;
+    deciders?: string;
+    children: any;
+}): any;
+//# sourceMappingURL=jsx.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.d.ts","sourceRoot":"","sources":["../../src/runtime/jsx.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,SAAS,EAAE,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAcpC,eAAO,MAAM,GAAG,EAAE,SAAqC,CAAC;AAExD;;GAEG;AACH,wBAAgB,GAAG,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,GAAG,GAAG,CAExD;AAWD,wBAAgB,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,GAAG,GAAG,CAEvD;AAED,wBAAgB,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,GAAG,GAAG,CAEvD;AAED,wBAAgB,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,GAAG,GAAG,CAEvD;AAED,wBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,GAAG,GAAG,CAEtD;AAED,wBAAgB,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,GAAG,GAAG,CAEzD;AAED,wBAAgB,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,GAAG,GAAG,CAEvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,GAAG,CAAA;CAAE,GAAG,GAAG,CAG1D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,GAAG,CAAC,EAClB,EAAE,EACF,KAAK,EACL,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,CAAC;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,GAAG,CAAC;CACf,GAAG,GAAG,CAYN"}

package/dist/runtime/jsx.js

@@ -0,0 +1,93 @@
+/* ============================================================
+ * Reference Helper
+ * ============================================================
+ *
+ * Used with type assertions for type-safe, Shift+F12 trackable references:
+ *
+ *   {ref as tskb.Folders['MyFolder']}
+ *   {ref as tskb.Modules['MyModule']}
+ *   {ref as tskb.Terms['MyTerm']}
+ *   {ref as tskb.Exports['MyExport']}
+ */
+export const ref = Symbol("tskb.ref");
+/**
+ * Documentation container - just renders children
+ */
+export function Doc({ children }) {
+    return children;
+}
+/* ============================================================
+ * Helper components for structured content
+ * ============================================================
+ *
+ * These components add semantic HTML markers to preserve document
+ * structure in the extracted content. The tags are kept in the JSON
+ * output for AI/tooling but stripped in visualizations for clarity.
+ */
+export function H1({ children }) {
+    return `<h1>${children}</h1>`;
+}
+export function H2({ children }) {
+    return `<h2>${children}</h2>`;
+}
+export function H3({ children }) {
+    return `<h3>${children}</h3>`;
+}
+export function P({ children }) {
+    return `<p>${children}</p>`;
+}
+export function List({ children }) {
+    return `<ul>${children}</ul>`;
+}
+export function Li({ children }) {
+    return `<li>${children}</li>`;
+}
+/**
+ * Code snippet component - embeds executable code for documentation
+ *
+ * Usage:
+ *   <Snippet code={() => {
+ *     const result = someFunction();
+ *     return result;
+ *   }} />
+ *
+ * The function is converted to a string and stored in the knowledge graph.
+ */
+export function Snippet({ code }) {
+    const codeString = code.toString();
+    return `<snippet>${codeString}</snippet>`;
+}
+/**
+ * Architecture Decision Record component
+ *
+ * Usage:
+ *   <Adr
+ *     id="001"
+ *     title="Use React for UI layer"
+ *     status="accepted"
+ *     date="2024-01-15"
+ *     deciders="Tech Team"
+ *   >
+ *     <H2>Context</H2>
+ *     <P>We need a UI framework...</P>
+ *
+ *     <H2>Decision</H2>
+ *     <P>We will use React...</P>
+ *
+ *     <H2>Consequences</H2>
+ *     <P>Positive: Large ecosystem...</P>
+ *   </Adr>
+ */
+export function Adr({ id, title, status, date, deciders, children, }) {
+    const metadata = [
+        `id="${id}"`,
+        `title="${title}"`,
+        `status="${status}"`,
+        date ? `date="${date}"` : null,
+        deciders ? `deciders="${deciders}"` : null,
+    ]
+        .filter(Boolean)
+        .join(" ");
+    return `<adr ${metadata}>${children}</adr>`;
+}
+//# sourceMappingURL=jsx.js.map

package/dist/runtime/jsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.js","sourceRoot":"","sources":["../../src/runtime/jsx.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,GAAG,GAAc,MAAM,CAAC,UAAU,CAAQ,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,GAAG,CAAC,EAAE,QAAQ,EAAqB;IACjD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AAEH,MAAM,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAqB;IAChD,OAAO,OAAO,QAAQ,OAAc,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAqB;IAChD,OAAO,OAAO,QAAQ,OAAc,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAqB;IAChD,OAAO,OAAO,QAAQ,OAAc,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAqB;IAC/C,OAAO,MAAM,QAAQ,MAAa,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,EAAE,QAAQ,EAAqB;IAClD,OAAO,OAAO,QAAQ,OAAc,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAqB;IAChD,OAAO,OAAO,QAAQ,OAAc,CAAC;AACvC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,EAAE,IAAI,EAAuB;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IACnC,OAAO,YAAY,UAAU,YAAmB,CAAC;AACnD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,GAAG,CAAC,EAClB,EAAE,EACF,KAAK,EACL,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,QAAQ,GAQT;IACC,MAAM,QAAQ,GAAG;QACf,OAAO,EAAE,GAAG;QACZ,UAAU,KAAK,GAAG;QAClB,WAAW,MAAM,GAAG;QACpB,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI;QAC9B,QAAQ,CAAC,CAAC,CAAC,aAAa,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI;KAC3C;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,OAAO,QAAQ,QAAQ,IAAI,QAAQ,QAAe,CAAC;AACrD,CAAC"}

package/dist/runtime/registry.d.ts

@@ -0,0 +1,61 @@
+declare global {
+    namespace tskb {
+        interface Folders {
+        }
+        interface Modules {
+        }
+        interface Terms {
+        }
+        interface Exports {
+        }
+    }
+}
+/**
+ * Base Abstraction's shapes (definitions)
+ */
+interface InternalFolderDefinition {
+    desc: string;
+    path: string;
+}
+interface InternalModuleDefinition {
+    desc: string;
+    type: unknown;
+}
+type InternalTermDefinition = string;
+interface InternalExportDefinition {
+    desc: string;
+    type: unknown;
+}
+/**
+ * Normalized views:
+ * - If a consumer provides a value that doesn't satisfy the base shape,
+ *   it will show as `never`/error when used through these types.
+ */
+type NormalizeFolders<T> = {
+    [K in keyof T]: T[K] extends InternalFolderDefinition ? T[K] : never;
+};
+type NormalizeModules<T> = {
+    [K in keyof T]: T[K] extends InternalModuleDefinition ? T[K] : never;
+};
+type NormalizeTerms<T> = {
+    [K in keyof T]: T[K] extends InternalTermDefinition ? T[K] : never;
+};
+type NormalizeExports<T> = {
+    [K in keyof T]: T[K] extends InternalExportDefinition ? T[K] : never;
+};
+export type FolderRegistry = NormalizeFolders<tskb.Folders>;
+export type ModuleRegistry = NormalizeModules<tskb.Modules>;
+export type TermRegistry = NormalizeTerms<tskb.Terms>;
+export type ExportRegistry = NormalizeExports<tskb.Exports>;
+/** Keys used for autocomplete. */
+export type FolderName = keyof tskb.Folders;
+export type ModuleName = keyof tskb.Modules;
+export type TermName = keyof tskb.Terms;
+export type ExportName = keyof tskb.Exports;
+/** Generic helpers for nicer authoring ergonomics. */
+export type Folder<Ext extends InternalFolderDefinition> = Ext;
+export type Module<Ext extends InternalModuleDefinition> = Ext;
+export type Term<Ext extends InternalTermDefinition> = Ext;
+export type Export<Ext extends InternalExportDefinition> = Ext;
+export {};
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/runtime/registry.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,IAAI,CAAC;QACb,UAAU,OAAO;SAAG;QACpB,UAAU,OAAO;SAAG;QACpB,UAAU,KAAK;SAAG;QAClB,UAAU,OAAO;SAAG;KACrB;CACF;AAED;;GAEG;AAEH,UAAU,wBAAwB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,wBAAwB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED,KAAK,sBAAsB,GAAG,MAAM,CAAC;AAErC,UAAU,wBAAwB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;GAIG;AACH,KAAK,gBAAgB,CAAC,CAAC,IAAI;KACxB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,wBAAwB,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CACrE,CAAC;AAEF,KAAK,gBAAgB,CAAC,CAAC,IAAI;KACxB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,wBAAwB,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CACrE,CAAC;AAEF,KAAK,cAAc,CAAC,CAAC,IAAI;KACtB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,sBAAsB,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CACnE,CAAC;AAEF,KAAK,gBAAgB,CAAC,CAAC,IAAI;KACxB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,wBAAwB,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CACrE,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACtD,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAE5D,kCAAkC;AAClC,MAAM,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;AAC5C,MAAM,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;AAC5C,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC;AACxC,MAAM,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;AAE5C,sDAAsD;AACtD,MAAM,MAAM,MAAM,CAAC,GAAG,SAAS,wBAAwB,IAAI,GAAG,CAAC;AAC/D,MAAM,MAAM,MAAM,CAAC,GAAG,SAAS,wBAAwB,IAAI,GAAG,CAAC;AAC/D,MAAM,MAAM,IAAI,CAAC,GAAG,SAAS,sBAAsB,IAAI,GAAG,CAAC;AAC3D,MAAM,MAAM,MAAM,CAAC,GAAG,SAAS,wBAAwB,IAAI,GAAG,CAAC"}

package/dist/runtime/registry.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry.js.map

package/dist/runtime/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/runtime/registry.ts"],"names":[],"mappings":""}

package/dist/typescript/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * TypeScript Module - TypeScript compiler infrastructure
+ *
+ * Utilities for working with the TypeScript compiler API.
+ */
+export { createProgram } from "./program.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/typescript/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/typescript/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/typescript/index.js

@@ -0,0 +1,7 @@
+/**
+ * TypeScript Module - TypeScript compiler infrastructure
+ *
+ * Utilities for working with the TypeScript compiler API.
+ */
+export { createProgram } from "./program.js";
+//# sourceMappingURL=index.js.map

package/dist/typescript/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/typescript/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/typescript/program.d.ts

@@ -0,0 +1,33 @@
+import ts from "typescript";
+/**
+ * Creates a TypeScript Program from a list of files and a tsconfig.
+ *
+ * WHAT IS A TYPESCRIPT PROGRAM?
+ * It's TypeScript compiler's internal representation of your code:
+ * - Source files (parsed into AST)
+ * - Type checker (resolves types, finds symbols)
+ * - Compiler options (from tsconfig.json)
+ *
+ * WHY WE NEED IT:
+ * We're not compiling code, we're ANALYZING it. The TypeScript compiler
+ * API gives us tools to:
+ * 1. Parse .ts/.tsx files into syntax trees
+ * 2. Resolve types (what is Context<{...}>?)
+ * 3. Find symbols (where is "tskb" namespace defined?)
+ * 4. Walk ASTs to extract information
+ *
+ * THE PROCESS:
+ * 1. Read tsconfig.json using ts.readConfigFile
+ * 2. Parse it to get compiler options
+ * 3. Create a Program with our files + those options
+ * 4. Set noEmit=true because we're only reading, not compiling
+ *
+ * RESULT:
+ * A Program object we can query to extract registry and docs.
+ *
+ * @param files - Array of absolute file paths to analyze
+ * @param tsconfigPath - Path to tsconfig.json (for compiler options)
+ * @returns TypeScript Program ready for analysis
+ */
+export declare function createProgram(files: string[], tsconfigPath: string): ts.Program;
+//# sourceMappingURL=program.d.ts.map

package/dist/typescript/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/typescript/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC,OAAO,CA+D/E"}