@mmnto/totem 0.1.0

package/dist/chunkers/chunker.d.ts

@@ -0,0 +1,12 @@
+import type { ChunkStrategy, ContentType } from '../config-schema.js';
+import type { Chunk } from '../types.js';
+/**
+ * All chunkers implement this interface.
+ * Given file content and metadata, produce an array of Chunks.
+ */
+export interface Chunker {
+    readonly strategy: ChunkStrategy;
+    chunk(content: string, filePath: string, type: ContentType): Chunk[];
+}
+export declare function createChunker(strategy: ChunkStrategy): Chunker;
+//# sourceMappingURL=chunker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/chunkers/chunker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAOzC;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAEjC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,KAAK,EAAE,CAAC;CACtE;AAUD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAG9D"}

package/dist/chunkers/chunker.js

@@ -0,0 +1,17 @@
+import { MarkdownChunker } from './markdown-chunker.js';
+import { SchemaFileChunker } from './schema-file-chunker.js';
+import { SessionLogChunker } from './session-log-chunker.js';
+import { TestFileChunker } from './test-file-chunker.js';
+import { TypeScriptChunker } from './typescript-chunker.js';
+const CHUNKER_MAP = {
+    'session-log': SessionLogChunker,
+    'markdown-heading': MarkdownChunker,
+    'typescript-ast': TypeScriptChunker,
+    'schema-file': SchemaFileChunker,
+    'test-file': TestFileChunker,
+};
+export function createChunker(strategy) {
+    const Ctor = CHUNKER_MAP[strategy];
+    return new Ctor();
+}
+//# sourceMappingURL=chunker.js.map

package/dist/chunkers/chunker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.js","sourceRoot":"","sources":["../../src/chunkers/chunker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAY5D,MAAM,WAAW,GAA6C;IAC5D,aAAa,EAAE,iBAAiB;IAChC,kBAAkB,EAAE,eAAe;IACnC,gBAAgB,EAAE,iBAAiB;IACnC,aAAa,EAAE,iBAAiB;IAChC,WAAW,EAAE,eAAe;CAC7B,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,QAAuB;IACnD,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACnC,OAAO,IAAI,IAAI,EAAE,CAAC;AACpB,CAAC"}

package/dist/chunkers/markdown-chunker.d.ts

@@ -0,0 +1,17 @@
+import type { ChunkStrategy, ContentType } from '../config-schema.js';
+import type { Chunk } from '../types.js';
+import type { Chunker } from './chunker.js';
+/**
+ * Markdown Heading Chunker.
+ *
+ * Chunks by ## and ### heading boundaries.
+ * Extracts YAML frontmatter as metadata on every chunk.
+ */
+export declare class MarkdownChunker implements Chunker {
+    readonly strategy: ChunkStrategy;
+    private onWarn;
+    constructor(onWarn?: (msg: string) => void);
+    chunk(content: string, filePath: string, type: ContentType): Chunk[];
+    private extractFrontmatter;
+}
+//# sourceMappingURL=markdown-chunker.d.ts.map

package/dist/chunkers/markdown-chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-chunker.d.ts","sourceRoot":"","sources":["../../src/chunkers/markdown-chunker.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,OAAO;IAC7C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAsB;IACtD,OAAO,CAAC,MAAM,CAAsC;gBAExC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI;IAI1C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,KAAK,EAAE;IAkEpE,OAAO,CAAC,kBAAkB;CAuB3B"}

package/dist/chunkers/markdown-chunker.js

@@ -0,0 +1,120 @@
+import remarkFrontmatter from 'remark-frontmatter';
+import remarkParse from 'remark-parse';
+import { unified } from 'unified';
+import YAML from 'yaml';
+const MAX_SPLIT_DEPTH = 3;
+/**
+ * Markdown Heading Chunker.
+ *
+ * Chunks by ## and ### heading boundaries.
+ * Extracts YAML frontmatter as metadata on every chunk.
+ */
+export class MarkdownChunker {
+    strategy = 'markdown-heading';
+    onWarn;
+    constructor(onWarn) {
+        this.onWarn = onWarn;
+    }
+    chunk(content, filePath, type) {
+        const tree = unified().use(remarkParse).use(remarkFrontmatter, ['yaml']).parse(content);
+        const metadata = this.extractFrontmatter(tree, filePath);
+        const chunks = [];
+        const lines = content.split('\n');
+        let currentHeading = null;
+        let sectionNodes = [];
+        let sectionStartLine = 1;
+        const flush = () => {
+            if (sectionNodes.length === 0 && !currentHeading)
+                return;
+            const sectionText = sectionNodes
+                .map((n) => nodeToSourceText(n, lines))
+                .filter(Boolean)
+                .join('\n\n');
+            if (!sectionText.trim())
+                return;
+            const label = currentHeading ?? filePath;
+            const contextPrefix = `File: ${filePath} | Section: ${label}`;
+            const endLine = sectionNodes.length > 0
+                ? (sectionNodes[sectionNodes.length - 1].position?.end.line ?? sectionStartLine)
+                : sectionStartLine;
+            chunks.push({
+                content: sectionText.trim(),
+                contextPrefix,
+                filePath,
+                type,
+                strategy: this.strategy,
+                label,
+                startLine: sectionStartLine,
+                endLine,
+                metadata,
+            });
+        };
+        for (const node of tree.children) {
+            // Skip YAML frontmatter node
+            if (node.type === 'yaml')
+                continue;
+            if (node.type === 'heading') {
+                const h = node;
+                // Only split on headings up to depth 3
+                if (h.depth <= MAX_SPLIT_DEPTH) {
+                    flush();
+                    currentHeading = extractPlainText(h.children);
+                    sectionNodes = [];
+                    sectionStartLine = h.position?.start.line ?? 1;
+                    continue;
+                }
+            }
+            sectionNodes.push(node);
+        }
+        // Flush final section
+        flush();
+        return chunks;
+    }
+    extractFrontmatter(tree, filePath) {
+        const yamlNode = tree.children.find((n) => n.type === 'yaml');
+        if (!yamlNode || !('value' in yamlNode))
+            return {};
+        try {
+            const parsed = YAML.parse(yamlNode.value);
+            if (typeof parsed !== 'object' || parsed === null)
+                return {};
+            const result = {};
+            for (const [key, value] of Object.entries(parsed)) {
+                result[key] = String(value);
+            }
+            return result;
+        }
+        catch (err) {
+            const msg = `Failed to parse frontmatter in ${filePath}: ${err instanceof Error ? err.message : String(err)}`;
+            if (this.onWarn) {
+                this.onWarn(msg);
+            }
+            else {
+                console.warn(`[Totem Warning] ${msg}`);
+            }
+            return {};
+        }
+    }
+}
+function extractPlainText(nodes) {
+    return nodes
+        .map((n) => {
+        if (n.type === 'text')
+            return n.value;
+        if ('children' in n)
+            return extractPlainText(n.children);
+        return '';
+    })
+        .join('');
+}
+function nodeToSourceText(node, lines) {
+    if (node.position) {
+        const startIdx = node.position.start.line - 1;
+        const endIdx = node.position.end.line;
+        return lines.slice(startIdx, endIdx).join('\n');
+    }
+    if ('value' in node && typeof node.value === 'string')
+        return node.value;
+    return '';
+}
+//# sourceMappingURL=markdown-chunker.js.map

package/dist/chunkers/markdown-chunker.js.map

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

package/dist/chunkers/schema-file-chunker.d.ts

@@ -0,0 +1,15 @@
+import type { ChunkStrategy, ContentType } from '../config-schema.js';
+import type { Chunk } from '../types.js';
+import type { Chunker } from './chunker.js';
+/**
+ * Schema File Chunker.
+ *
+ * Chunks by exported table/relation declarations (Drizzle pgTable, Prisma, etc.).
+ * Falls back to chunking by each exported statement.
+ */
+export declare class SchemaFileChunker implements Chunker {
+    readonly strategy: ChunkStrategy;
+    chunk(content: string, filePath: string, type: ContentType): Chunk[];
+    private isExported;
+}
+//# sourceMappingURL=schema-file-chunker.d.ts.map

package/dist/chunkers/schema-file-chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-file-chunker.d.ts","sourceRoot":"","sources":["../../src/chunkers/schema-file-chunker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,OAAO;IAC/C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAiB;IAEjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,KAAK,EAAE;IAqDpE,OAAO,CAAC,UAAU;CAKnB"}

package/dist/chunkers/schema-file-chunker.js

@@ -0,0 +1,55 @@
+import ts from 'typescript';
+/**
+ * Schema File Chunker.
+ *
+ * Chunks by exported table/relation declarations (Drizzle pgTable, Prisma, etc.).
+ * Falls back to chunking by each exported statement.
+ */
+export class SchemaFileChunker {
+    strategy = 'schema-file';
+    chunk(content, filePath, type) {
+        const sourceFile = ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+        const chunks = [];
+        const lines = content.split('\n');
+        ts.forEachChild(sourceFile, (node) => {
+            if (!this.isExported(node))
+                return;
+            let name = 'unknown';
+            if (ts.isVariableStatement(node)) {
+                for (const decl of node.declarationList.declarations) {
+                    if (ts.isIdentifier(decl.name)) {
+                        name = decl.name.text;
+                    }
+                }
+            }
+            else if ((ts.isTypeAliasDeclaration(node) || ts.isInterfaceDeclaration(node)) &&
+                node.name) {
+                name = node.name.text;
+            }
+            const startPos = node.getStart(sourceFile);
+            const endPos = node.getEnd();
+            const startLine = sourceFile.getLineAndCharacterOfPosition(startPos).line + 1;
+            const endLine = sourceFile.getLineAndCharacterOfPosition(endPos).line + 1;
+            const text = lines.slice(startLine - 1, endLine).join('\n');
+            chunks.push({
+                content: text,
+                contextPrefix: `File: ${filePath} | Schema: ${name}`,
+                filePath,
+                type,
+                strategy: this.strategy,
+                label: `schema: ${name}`,
+                startLine,
+                endLine,
+                metadata: { name },
+            });
+        });
+        return chunks;
+    }
+    isExported(node) {
+        if (!ts.canHaveModifiers(node))
+            return false;
+        const modifiers = ts.getModifiers(node);
+        return modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword) ?? false;
+    }
+}
+//# sourceMappingURL=schema-file-chunker.js.map

package/dist/chunkers/schema-file-chunker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-file-chunker.js","sourceRoot":"","sources":["../../src/chunkers/schema-file-chunker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAM5B;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACnB,QAAQ,GAAkB,aAAa,CAAC;IAEjD,KAAK,CAAC,OAAe,EAAE,QAAgB,EAAE,IAAiB;QACxD,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CACpC,QAAQ,EACR,OAAO,EACP,EAAE,CAAC,YAAY,CAAC,MAAM,EACtB,IAAI,EACJ,EAAE,CAAC,UAAU,CAAC,EAAE,CACjB,CAAC;QAEF,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE;YACnC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO;YAEnC,IAAI,IAAI,GAAG,SAAS,CAAC;YAErB,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,CAAC;oBACrD,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC/B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;oBACxB,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IACL,CAAC,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;gBACpE,IAAI,CAAC,IAAI,EACT,CAAC;gBACD,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YACxB,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,UAAU,CAAC,6BAA6B,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YAC9E,MAAM,OAAO,GAAG,UAAU,CAAC,6BAA6B,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YAE1E,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE5D,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,IAAI;gBACb,aAAa,EAAE,SAAS,QAAQ,cAAc,IAAI,EAAE;gBACpD,QAAQ;gBACR,IAAI;gBACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,WAAW,IAAI,EAAE;gBACxB,SAAS;gBACT,OAAO;gBACP,QAAQ,EAAE,EAAE,IAAI,EAAE;aACnB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,UAAU,CAAC,IAAa;QAC9B,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7C,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC;IACjF,CAAC;CACF"}

package/dist/chunkers/session-log-chunker.d.ts

@@ -0,0 +1,14 @@
+import type { ChunkStrategy, ContentType } from '../config-schema.js';
+import type { Chunk } from '../types.js';
+import type { Chunker } from './chunker.js';
+/**
+ * Session Log Chunker — the most critical chunker.
+ *
+ * Preserves parent heading breadcrumbs for every content block.
+ * Output: `[Session 142 > Traps > Next.js Caching] We found that...`
+ */
+export declare class SessionLogChunker implements Chunker {
+    readonly strategy: ChunkStrategy;
+    chunk(content: string, filePath: string, type: ContentType): Chunk[];
+}
+//# sourceMappingURL=session-log-chunker.d.ts.map

package/dist/chunkers/session-log-chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-log-chunker.d.ts","sourceRoot":"","sources":["../../src/chunkers/session-log-chunker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,OAAO;IAC/C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAiB;IAEjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,KAAK,EAAE;CA8CrE"}

package/dist/chunkers/session-log-chunker.js

@@ -0,0 +1,78 @@
+import remarkParse from 'remark-parse';
+import { unified } from 'unified';
+/**
+ * Session Log Chunker — the most critical chunker.
+ *
+ * Preserves parent heading breadcrumbs for every content block.
+ * Output: `[Session 142 > Traps > Next.js Caching] We found that...`
+ */
+export class SessionLogChunker {
+    strategy = 'session-log';
+    chunk(content, filePath, type) {
+        const tree = unified().use(remarkParse).parse(content);
+        const chunks = [];
+        // Heading breadcrumb stack: index = depth-1, value = heading text.
+        // When we encounter a heading of depth N, we clear all headings deeper than N.
+        const breadcrumbs = [];
+        for (const node of tree.children) {
+            if (node.type === 'heading') {
+                const heading = node;
+                const depth = heading.depth;
+                const text = extractPlainText(heading.children);
+                // Set this depth, truncate deeper levels
+                breadcrumbs[depth - 1] = text;
+                breadcrumbs.length = depth;
+                continue;
+            }
+            // For any content node, emit a chunk with breadcrumb context
+            const text = nodeToText(node, content);
+            if (!text.trim())
+                continue;
+            const breadcrumbPath = breadcrumbs.filter(Boolean).join(' > ');
+            const contextPrefix = breadcrumbPath ? `[${breadcrumbPath}]` : `[${filePath}]`;
+            const label = breadcrumbPath || filePath;
+            const startLine = node.position?.start.line ?? 1;
+            const endLine = node.position?.end.line ?? startLine;
+            chunks.push({
+                content: text.trim(),
+                contextPrefix,
+                filePath,
+                type,
+                strategy: this.strategy,
+                label,
+                startLine,
+                endLine,
+                metadata: {},
+            });
+        }
+        return chunks;
+    }
+}
+/** Extract plain text from mdast phrasing content nodes. */
+function extractPlainText(nodes) {
+    return nodes
+        .map((n) => {
+        if (n.type === 'text')
+            return n.value;
+        if ('children' in n)
+            return extractPlainText(n.children);
+        return '';
+    })
+        .join('');
+}
+/**
+ * Convert an mdast content node back to its original text
+ * using the source position to slice the original content.
+ */
+function nodeToText(node, source) {
+    if (node.position) {
+        const lines = source.split('\n');
+        const startIdx = node.position.start.line - 1;
+        const endIdx = node.position.end.line;
+        return lines.slice(startIdx, endIdx).join('\n');
+    }
+    if ('value' in node && typeof node.value === 'string')
+        return node.value;
+    return '';
+}
+//# sourceMappingURL=session-log-chunker.js.map

package/dist/chunkers/session-log-chunker.js.map

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

package/dist/chunkers/test-file-chunker.d.ts

@@ -0,0 +1,17 @@
+import type { ChunkStrategy, ContentType } from '../config-schema.js';
+import type { Chunk } from '../types.js';
+import type { Chunker } from './chunker.js';
+/**
+ * Test File Chunker.
+ *
+ * Chunks by describe/it/test blocks.
+ * A `describe` block includes its nested `it` calls.
+ * Top-level `it`/`test` calls become their own chunks.
+ */
+export declare class TestFileChunker implements Chunker {
+    readonly strategy: ChunkStrategy;
+    chunk(content: string, filePath: string, type: ContentType): Chunk[];
+    private getCallName;
+    private extractTestLabel;
+}
+//# sourceMappingURL=test-file-chunker.d.ts.map

package/dist/chunkers/test-file-chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-file-chunker.d.ts","sourceRoot":"","sources":["../../src/chunkers/test-file-chunker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,OAAO;IAC7C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAe;IAE/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,KAAK,EAAE;IA2CpE,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,gBAAgB;CAUzB"}

package/dist/chunkers/test-file-chunker.js

@@ -0,0 +1,66 @@
+import ts from 'typescript';
+const TEST_FUNCTIONS = new Set(['describe', 'it', 'test']);
+/**
+ * Test File Chunker.
+ *
+ * Chunks by describe/it/test blocks.
+ * A `describe` block includes its nested `it` calls.
+ * Top-level `it`/`test` calls become their own chunks.
+ */
+export class TestFileChunker {
+    strategy = 'test-file';
+    chunk(content, filePath, type) {
+        const sourceFile = ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+        const chunks = [];
+        const lines = content.split('\n');
+        ts.forEachChild(sourceFile, (node) => {
+            if (!ts.isExpressionStatement(node))
+                return;
+            if (!ts.isCallExpression(node.expression))
+                return;
+            const callName = this.getCallName(node.expression);
+            if (!callName || !TEST_FUNCTIONS.has(callName))
+                return;
+            const label = this.extractTestLabel(node.expression);
+            const startPos = node.getStart(sourceFile);
+            const endPos = node.getEnd();
+            const startLine = sourceFile.getLineAndCharacterOfPosition(startPos).line + 1;
+            const endLine = sourceFile.getLineAndCharacterOfPosition(endPos).line + 1;
+            const text = lines.slice(startLine - 1, endLine).join('\n');
+            chunks.push({
+                content: text,
+                contextPrefix: `File: ${filePath} | Test: ${label}`,
+                filePath,
+                type,
+                strategy: this.strategy,
+                label: `${callName}: ${label}`,
+                startLine,
+                endLine,
+                metadata: { testType: callName },
+            });
+        });
+        return chunks;
+    }
+    getCallName(expr) {
+        if (ts.isIdentifier(expr.expression)) {
+            return expr.expression.text;
+        }
+        // Handle describe.skip, it.skip, etc.
+        if (ts.isPropertyAccessExpression(expr.expression) &&
+            ts.isIdentifier(expr.expression.expression)) {
+            return expr.expression.expression.text;
+        }
+        return null;
+    }
+    extractTestLabel(expr) {
+        const firstArg = expr.arguments[0];
+        if (firstArg && ts.isStringLiteral(firstArg)) {
+            return firstArg.text;
+        }
+        if (firstArg && ts.isNoSubstitutionTemplateLiteral(firstArg)) {
+            return firstArg.text;
+        }
+        return 'unnamed';
+    }
+}
+//# sourceMappingURL=test-file-chunker.js.map

package/dist/chunkers/test-file-chunker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-file-chunker.js","sourceRoot":"","sources":["../../src/chunkers/test-file-chunker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAM5B,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IACjB,QAAQ,GAAkB,WAAW,CAAC;IAE/C,KAAK,CAAC,OAAe,EAAE,QAAgB,EAAE,IAAiB;QACxD,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CACpC,QAAQ,EACR,OAAO,EACP,EAAE,CAAC,YAAY,CAAC,MAAM,EACtB,IAAI,EACJ,EAAE,CAAC,UAAU,CAAC,EAAE,CACjB,CAAC;QAEF,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE;YACnC,IAAI,CAAC,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC;gBAAE,OAAO;YAC5C,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC;gBAAE,OAAO;YAElD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACnD,IAAI,CAAC,QAAQ,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,OAAO;YAEvD,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,UAAU,CAAC,6BAA6B,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YAC9E,MAAM,OAAO,GAAG,UAAU,CAAC,6BAA6B,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YAE1E,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE5D,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO,EAAE,IAAI;gBACb,aAAa,EAAE,SAAS,QAAQ,YAAY,KAAK,EAAE;gBACnD,QAAQ;gBACR,IAAI;gBACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,GAAG,QAAQ,KAAK,KAAK,EAAE;gBAC9B,SAAS;gBACT,OAAO;gBACP,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;aACjC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,WAAW,CAAC,IAAuB;QACzC,IAAI,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAC9B,CAAC;QACD,sCAAsC;QACtC,IACE,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,UAAU,CAAC;YAC9C,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAC3C,CAAC;YACD,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;QACzC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,gBAAgB,CAAC,IAAuB;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,QAAQ,IAAI,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7C,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QACD,IAAI,QAAQ,IAAI,EAAE,CAAC,+BAA+B,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7D,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/chunkers/typescript-chunker.d.ts

@@ -0,0 +1,17 @@
+import type { ChunkStrategy, ContentType } from '../config-schema.js';
+import type { Chunk } from '../types.js';
+import type { Chunker } from './chunker.js';
+/**
+ * TypeScript AST Chunker.
+ *
+ * Chunks by function, class, interface, type alias, enum declarations.
+ * Detects React components (PascalCase) and hooks (use* prefix).
+ * Context: `File: <path> | Context: The '<name>' <kind>`
+ */
+export declare class TypeScriptChunker implements Chunker {
+    readonly strategy: ChunkStrategy;
+    chunk(content: string, filePath: string, type: ContentType): Chunk[];
+    private extractDeclaration;
+    private classifyFunction;
+}
+//# sourceMappingURL=typescript-chunker.d.ts.map

package/dist/chunkers/typescript-chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-chunker.d.ts","sourceRoot":"","sources":["../../src/chunkers/typescript-chunker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,OAAO;IAC/C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAoB;IAEpD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,KAAK,EAAE;IA+BpE,OAAO,CAAC,kBAAkB;IA4D1B,OAAO,CAAC,gBAAgB;CASzB"}

package/dist/chunkers/typescript-chunker.js

@@ -0,0 +1,94 @@
+import ts from 'typescript';
+/**
+ * TypeScript AST Chunker.
+ *
+ * Chunks by function, class, interface, type alias, enum declarations.
+ * Detects React components (PascalCase) and hooks (use* prefix).
+ * Context: `File: <path> | Context: The '<name>' <kind>`
+ */
+export class TypeScriptChunker {
+    strategy = 'typescript-ast';
+    chunk(content, filePath, type) {
+        const scriptKind = filePath.endsWith('.tsx') ? ts.ScriptKind.TSX : ts.ScriptKind.TS;
+        const sourceFile = ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, true, scriptKind);
+        const chunks = [];
+        const lines = content.split('\n');
+        const visit = (node, depth) => {
+            // Only chunk top-level declarations (class methods stay inside the class chunk)
+            if (depth > 1)
+                return;
+            const extracted = this.extractDeclaration(node, sourceFile, lines, filePath, type);
+            if (extracted) {
+                chunks.push(extracted);
+                return;
+            }
+            ts.forEachChild(node, (child) => visit(child, depth + 1));
+        };
+        ts.forEachChild(sourceFile, (child) => visit(child, 0));
+        return chunks;
+    }
+    extractDeclaration(node, sourceFile, lines, filePath, contentType) {
+        let name = null;
+        let kind = null;
+        if (ts.isFunctionDeclaration(node) && node.name) {
+            name = node.name.text;
+            kind = this.classifyFunction(name);
+        }
+        else if (ts.isClassDeclaration(node) && node.name) {
+            name = node.name.text;
+            kind = 'class';
+        }
+        else if (ts.isInterfaceDeclaration(node)) {
+            name = node.name.text;
+            kind = 'interface';
+        }
+        else if (ts.isTypeAliasDeclaration(node)) {
+            name = node.name.text;
+            kind = 'type alias';
+        }
+        else if (ts.isEnumDeclaration(node)) {
+            name = node.name.text;
+            kind = 'enum';
+        }
+        else if (ts.isVariableStatement(node)) {
+            // Handle: export const MyComponent = () => { ... }
+            for (const decl of node.declarationList.declarations) {
+                if (ts.isIdentifier(decl.name) && decl.initializer) {
+                    if (ts.isArrowFunction(decl.initializer) || ts.isFunctionExpression(decl.initializer)) {
+                        name = decl.name.text;
+                        kind = this.classifyFunction(name);
+                    }
+                }
+            }
+        }
+        if (!name || !kind)
+            return null;
+        const startPos = node.getStart(sourceFile);
+        const endPos = node.getEnd();
+        const startLine = sourceFile.getLineAndCharacterOfPosition(startPos).line + 1;
+        const endLine = sourceFile.getLineAndCharacterOfPosition(endPos).line + 1;
+        const text = lines.slice(startLine - 1, endLine).join('\n');
+        const contextPrefix = `File: ${filePath} | Context: The '${name}' ${kind}`;
+        return {
+            content: text,
+            contextPrefix,
+            filePath,
+            type: contentType,
+            strategy: this.strategy,
+            label: `${kind}: ${name}`,
+            startLine,
+            endLine,
+            metadata: { name, kind },
+        };
+    }
+    classifyFunction(name) {
+        if (name.startsWith('use') && name[3]?.toUpperCase() === name[3]) {
+            return 'hook';
+        }
+        if (name[0]?.toUpperCase() === name[0]) {
+            return 'component';
+        }
+        return 'function';
+    }
+}
+//# sourceMappingURL=typescript-chunker.js.map

package/dist/chunkers/typescript-chunker.js.map

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