@stigmer/react 1.0.4 → 2.0.1

package/internal/file-tree/__tests__/filterFileTree.test.js

@@ -0,0 +1,120 @@
+import { describe, it, expect } from "vitest";
+import { filterFileTree } from "../filterFileTree";
+function names(nodes) {
+    return nodes.map((n) => n.name);
+}
+const SAMPLE_TREE = [
+    {
+        name: "src",
+        path: "src/",
+        children: [
+            { name: "index.ts", path: "src/index.ts" },
+            {
+                name: "utils",
+                path: "src/utils/",
+                children: [
+                    { name: "helper.ts", path: "src/utils/helper.ts" },
+                    { name: "format.ts", path: "src/utils/format.ts" },
+                ],
+            },
+            { name: "App.tsx", path: "src/App.tsx" },
+        ],
+    },
+    { name: "README.md", path: "README.md" },
+    { name: "package.json", path: "package.json" },
+    {
+        name: "docs",
+        path: "docs/",
+        children: [
+            { name: "guide.md", path: "docs/guide.md" },
+        ],
+    },
+];
+describe("filterFileTree", () => {
+    it("returns the original reference for an empty query", () => {
+        const result = filterFileTree(SAMPLE_TREE, "");
+        expect(result).toBe(SAMPLE_TREE);
+    });
+    it("returns the original reference for a whitespace-only query", () => {
+        const result = filterFileTree(SAMPLE_TREE, "   ");
+        expect(result).toBe(SAMPLE_TREE);
+    });
+    it("matches leaf files by name substring", () => {
+        const result = filterFileTree(SAMPLE_TREE, "helper");
+        expect(result).toHaveLength(1);
+        expect(result[0].name).toBe("src");
+        expect(result[0].children).toHaveLength(1);
+        expect(result[0].children[0].name).toBe("utils");
+        expect(result[0].children[0].children).toHaveLength(1);
+        expect(result[0].children[0].children[0].name).toBe("helper.ts");
+    });
+    it("is case-insensitive", () => {
+        const result = filterFileTree(SAMPLE_TREE, "README");
+        expect(names(result)).toContain("README.md");
+        const lower = filterFileTree(SAMPLE_TREE, "readme");
+        expect(names(lower)).toContain("README.md");
+        const mixed = filterFileTree(SAMPLE_TREE, "ReAdMe");
+        expect(names(mixed)).toContain("README.md");
+    });
+    it("returns an empty array when nothing matches", () => {
+        const result = filterFileTree(SAMPLE_TREE, "nonexistent-xyz");
+        expect(result).toEqual([]);
+    });
+    it("preserves parent folders for deeply nested matches", () => {
+        const result = filterFileTree(SAMPLE_TREE, "format");
+        expect(result).toHaveLength(1);
+        const src = result[0];
+        expect(src.name).toBe("src");
+        expect(src.children).toHaveLength(1);
+        const utils = src.children[0];
+        expect(utils.name).toBe("utils");
+        expect(utils.children).toHaveLength(1);
+        expect(utils.children[0].name).toBe("format.ts");
+    });
+    it("includes a matching folder with all its original children", () => {
+        const result = filterFileTree(SAMPLE_TREE, "utils");
+        expect(result).toHaveLength(1);
+        const src = result[0];
+        expect(src.name).toBe("src");
+        expect(src.children).toHaveLength(1);
+        const utils = src.children[0];
+        expect(utils.name).toBe("utils");
+        expect(utils.children).toHaveLength(2);
+        expect(names(utils.children)).toEqual(["helper.ts", "format.ts"]);
+    });
+    it("matches multiple items across different branches", () => {
+        const result = filterFileTree(SAMPLE_TREE, ".md");
+        expect(names(result)).toContain("README.md");
+        expect(names(result)).toContain("docs");
+        const docs = result.find((n) => n.name === "docs");
+        expect(docs?.children).toHaveLength(1);
+        expect(docs?.children[0].name).toBe("guide.md");
+    });
+    it("matches root-level files directly", () => {
+        const result = filterFileTree(SAMPLE_TREE, "package");
+        expect(result).toHaveLength(1);
+        expect(result[0].name).toBe("package.json");
+        expect(result[0].children).toBeUndefined();
+    });
+    it("does not mutate the original tree", () => {
+        const originalLength = SAMPLE_TREE.length;
+        const originalSrcChildren = SAMPLE_TREE[0].children.length;
+        filterFileTree(SAMPLE_TREE, "helper");
+        expect(SAMPLE_TREE).toHaveLength(originalLength);
+        expect(SAMPLE_TREE[0].children).toHaveLength(originalSrcChildren);
+    });
+    it("handles an empty tree", () => {
+        const result = filterFileTree([], "query");
+        expect(result).toEqual([]);
+    });
+    it("handles a tree with only root-level files", () => {
+        const flat = [
+            { name: "a.ts", path: "a.ts" },
+            { name: "b.ts", path: "b.ts" },
+        ];
+        const result = filterFileTree(flat, "a");
+        expect(result).toHaveLength(1);
+        expect(result[0].name).toBe("a.ts");
+    });
+});
+//# sourceMappingURL=filterFileTree.test.js.map

package/internal/file-tree/__tests__/filterFileTree.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterFileTree.test.js","sourceRoot":"","sources":["../../../../src/internal/file-tree/__tests__/filterFileTree.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,SAAS,KAAK,CAAC,KAA0B;IACvC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,WAAW,GAAe;IAC9B;QACE,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE;YAC1C;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,YAAY;gBAClB,QAAQ,EAAE;oBACR,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,qBAAqB,EAAE;oBAClD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,qBAAqB,EAAE;iBACnD;aACF;YACD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE;SACzC;KACF;IACD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE;IACxC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE;IAC9C;QACE,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE;SAC5C;KACF;CACF,CAAC;AAEF,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAS,CAAC,CAAC,CAAC,CAAC,QAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACrD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAE7C,MAAM,KAAK,GAAG,cAAc,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAE5C,MAAM,KAAK,GAAG,cAAc,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAE/B,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAErC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAS,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,QAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAE/B,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAErC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAS,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAExC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,EAAE,QAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC;QAC1C,MAAM,mBAAmB,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAS,CAAC,MAAM,CAAC;QAC5D,cAAc,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;QACjD,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,IAAI,GAAe;YACvB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;YAC9B,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;SAC/B,CAAC;QACF,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/internal/file-tree/filterFileTree.d.ts

@@ -0,0 +1,17 @@
+import type { TreeNode } from "./tree-node";
+/**
+ * Filters a {@link TreeNode} hierarchy by a search query.
+ *
+ * Returns a new tree containing only nodes whose `name` matches
+ * the query (case-insensitive substring), plus all ancestor folders
+ * needed to preserve the hierarchy. Folder nodes that match are
+ * included with all their original children (the match implies the
+ * entire subtree is relevant). Folder nodes that do not match
+ * themselves are included only when they contain matching descendants.
+ *
+ * Returns the original `tree` reference when `query` is empty or
+ * whitespace-only, preserving referential stability for downstream
+ * `React.memo` consumers.
+ */
+export declare function filterFileTree(tree: readonly TreeNode[], query: string): readonly TreeNode[];
+//# sourceMappingURL=filterFileTree.d.ts.map

package/internal/file-tree/filterFileTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterFileTree.d.ts","sourceRoot":"","sources":["../../../src/internal/file-tree/filterFileTree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,QAAQ,EAAE,EACzB,KAAK,EAAE,MAAM,GACZ,SAAS,QAAQ,EAAE,CAMrB"}

package/internal/file-tree/filterFileTree.js

@@ -0,0 +1,45 @@
+/**
+ * Filters a {@link TreeNode} hierarchy by a search query.
+ *
+ * Returns a new tree containing only nodes whose `name` matches
+ * the query (case-insensitive substring), plus all ancestor folders
+ * needed to preserve the hierarchy. Folder nodes that match are
+ * included with all their original children (the match implies the
+ * entire subtree is relevant). Folder nodes that do not match
+ * themselves are included only when they contain matching descendants.
+ *
+ * Returns the original `tree` reference when `query` is empty or
+ * whitespace-only, preserving referential stability for downstream
+ * `React.memo` consumers.
+ */
+export function filterFileTree(tree, query) {
+    const trimmed = query.trim();
+    if (trimmed.length === 0)
+        return tree;
+    const lower = trimmed.toLowerCase();
+    return filterNodes(tree, lower);
+}
+function filterNodes(nodes, query) {
+    const result = [];
+    for (const node of nodes) {
+        const nameMatches = node.name.toLowerCase().includes(query);
+        if (node.children) {
+            if (nameMatches) {
+                result.push(node);
+            }
+            else {
+                const filteredChildren = filterNodes(node.children, query);
+                if (filteredChildren.length > 0) {
+                    result.push({ ...node, children: filteredChildren });
+                }
+            }
+        }
+        else {
+            if (nameMatches) {
+                result.push(node);
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=filterFileTree.js.map

package/internal/file-tree/filterFileTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterFileTree.js","sourceRoot":"","sources":["../../../src/internal/file-tree/filterFileTree.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAyB,EACzB,KAAa;IAEb,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,WAAW,CAClB,KAA0B,EAC1B,KAAa;IAEb,MAAM,MAAM,GAAe,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAE5D,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,MAAM,gBAAgB,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAC3D,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAChC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/internal/file-tree/index.d.ts

@@ -0,0 +1,6 @@
+export { buildFileTree } from "./tree-node";
+export type { TreeNode } from "./tree-node";
+export { filterFileTree } from "./filterFileTree";
+export { FileTreeNode, FILE_REF_MIME } from "./FileTreeNode";
+export type { FileTreeNodeProps } from "./FileTreeNode";
+//# sourceMappingURL=index.d.ts.map

package/internal/file-tree/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/file-tree/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/internal/file-tree/index.js

@@ -0,0 +1,4 @@
+export { buildFileTree } from "./tree-node";
+export { filterFileTree } from "./filterFileTree";
+export { FileTreeNode, FILE_REF_MIME } from "./FileTreeNode";
+//# sourceMappingURL=index.js.map

package/internal/file-tree/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/file-tree/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/internal/file-tree/tree-node.d.ts

@@ -0,0 +1,21 @@
+/** A node in a hierarchical file tree. Folders have `children`; files do not. */
+export interface TreeNode {
+    name: string;
+    path: string;
+    children?: TreeNode[];
+}
+/**
+ * Builds a hierarchical {@link TreeNode} array from a flat list of file paths.
+ *
+ * Intermediate folder nodes are synthesized automatically from the path
+ * segments. The input is sorted lexicographically before insertion so the
+ * resulting tree is deterministic regardless of input order.
+ *
+ * The input contract is intentionally minimal — any object with a `path`
+ * string works, allowing both `SkillFileEntry` and `WorkspaceFileEntry`
+ * to use this utility without adaptation.
+ */
+export declare function buildFileTree(files: ReadonlyArray<{
+    readonly path: string;
+}>): TreeNode[];
+//# sourceMappingURL=tree-node.d.ts.map

package/internal/file-tree/tree-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-node.d.ts","sourceRoot":"","sources":["../../../src/internal/file-tree/tree-node.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,QAAQ,EAAE,CAgCzF"}

package/internal/file-tree/tree-node.js

@@ -0,0 +1,40 @@
+/**
+ * Builds a hierarchical {@link TreeNode} array from a flat list of file paths.
+ *
+ * Intermediate folder nodes are synthesized automatically from the path
+ * segments. The input is sorted lexicographically before insertion so the
+ * resulting tree is deterministic regardless of input order.
+ *
+ * The input contract is intentionally minimal — any object with a `path`
+ * string works, allowing both `SkillFileEntry` and `WorkspaceFileEntry`
+ * to use this utility without adaptation.
+ */
+export function buildFileTree(files) {
+    const root = [];
+    const sorted = [...files].sort((a, b) => a.path.localeCompare(b.path));
+    for (const file of sorted) {
+        const parts = file.path.split("/");
+        if (parts.length === 1) {
+            root.push({ name: parts[0], path: file.path });
+        }
+        else {
+            let currentLevel = root;
+            for (let i = 0; i < parts.length - 1; i++) {
+                const folderName = parts[i];
+                let folder = currentLevel.find((n) => n.name === folderName && n.children);
+                if (!folder) {
+                    folder = {
+                        name: folderName,
+                        path: parts.slice(0, i + 1).join("/") + "/",
+                        children: [],
+                    };
+                    currentLevel.push(folder);
+                }
+                currentLevel = folder.children;
+            }
+            currentLevel.push({ name: parts[parts.length - 1], path: file.path });
+        }
+    }
+    return root;
+}
+//# sourceMappingURL=tree-node.js.map

package/internal/file-tree/tree-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-node.js","sourceRoot":"","sources":["../../../src/internal/file-tree/tree-node.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,KAA+C;IAC3E,MAAM,IAAI,GAAe,EAAE,CAAC;IAE5B,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEvE,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,IAAI,YAAY,GAAG,IAAI,CAAC;YACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC5B,IAAI,MAAM,GAAG,YAAY,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,QAAQ,CAC3C,CAAC;gBACF,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,GAAG;wBACP,IAAI,EAAE,UAAU;wBAChB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG;wBAC3C,QAAQ,EAAE,EAAE;qBACb,CAAC;oBACF,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC5B,CAAC;gBACD,YAAY,GAAG,MAAM,CAAC,QAAS,CAAC;YAClC,CAAC;YACD,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/internal/store/__tests__/selection-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=selection-store.test.d.ts.map

package/internal/store/__tests__/selection-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-store.test.d.ts","sourceRoot":"","sources":["../../../../src/internal/store/__tests__/selection-store.test.ts"],"names":[],"mappings":""}

package/internal/store/__tests__/selection-store.test.js

@@ -0,0 +1,93 @@
+import { describe, it, expect, vi } from "vitest";
+import { SelectionStore } from "../selection-store";
+function toolCall(id) {
+    return { kind: "tool-call", toolCallId: id };
+}
+function subAgent(id) {
+    return { kind: "sub-agent", subAgentId: id };
+}
+describe("SelectionStore", () => {
+    it("starts with null selection", () => {
+        const store = new SelectionStore();
+        expect(store.getSelection()).toBeNull();
+    });
+    it("select sets the selection and notifies listeners", () => {
+        const store = new SelectionStore();
+        const listener = vi.fn();
+        store.subscribe(listener);
+        store.select(toolCall("tc-1"));
+        expect(store.getSelection()).toEqual(toolCall("tc-1"));
+        expect(listener).toHaveBeenCalledOnce();
+    });
+    it("select with the same item does not notify", () => {
+        const store = new SelectionStore();
+        store.select(toolCall("tc-1"));
+        const listener = vi.fn();
+        store.subscribe(listener);
+        store.select(toolCall("tc-1"));
+        expect(listener).not.toHaveBeenCalled();
+    });
+    it("deselect clears the selection and notifies", () => {
+        const store = new SelectionStore();
+        store.select(toolCall("tc-1"));
+        const listener = vi.fn();
+        store.subscribe(listener);
+        store.deselect();
+        expect(store.getSelection()).toBeNull();
+        expect(listener).toHaveBeenCalledOnce();
+    });
+    it("deselect when already null does not notify", () => {
+        const store = new SelectionStore();
+        const listener = vi.fn();
+        store.subscribe(listener);
+        store.deselect();
+        expect(listener).not.toHaveBeenCalled();
+    });
+    it("toggle selects when nothing is selected", () => {
+        const store = new SelectionStore();
+        store.toggle(toolCall("tc-1"));
+        expect(store.getSelection()).toEqual(toolCall("tc-1"));
+    });
+    it("toggle deselects when the same item is selected", () => {
+        const store = new SelectionStore();
+        store.select(toolCall("tc-1"));
+        store.toggle(toolCall("tc-1"));
+        expect(store.getSelection()).toBeNull();
+    });
+    it("toggle switches to a different item", () => {
+        const store = new SelectionStore();
+        store.select(toolCall("tc-1"));
+        store.toggle(subAgent("sa-1"));
+        expect(store.getSelection()).toEqual(subAgent("sa-1"));
+    });
+    it("isSelected returns true for the selected item", () => {
+        const store = new SelectionStore();
+        store.select(toolCall("tc-1"));
+        expect(store.isSelected("tool-call", "tc-1")).toBe(true);
+        expect(store.isSelected("tool-call", "tc-2")).toBe(false);
+        expect(store.isSelected("sub-agent", "tc-1")).toBe(false);
+    });
+    it("isSelected returns false when nothing is selected", () => {
+        const store = new SelectionStore();
+        expect(store.isSelected("tool-call", "tc-1")).toBe(false);
+    });
+    it("unsubscribe removes the listener", () => {
+        const store = new SelectionStore();
+        const listener = vi.fn();
+        const unsub = store.subscribe(listener);
+        unsub();
+        store.select(toolCall("tc-1"));
+        expect(listener).not.toHaveBeenCalled();
+    });
+    it("supports multiple listeners", () => {
+        const store = new SelectionStore();
+        const a = vi.fn();
+        const b = vi.fn();
+        store.subscribe(a);
+        store.subscribe(b);
+        store.select(toolCall("tc-1"));
+        expect(a).toHaveBeenCalledOnce();
+        expect(b).toHaveBeenCalledOnce();
+    });
+});
+//# sourceMappingURL=selection-store.test.js.map

package/internal/store/__tests__/selection-store.test.js.map

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

package/internal/store/__tests__/workflow-execution-event-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workflow-execution-event-store.test.d.ts.map

package/internal/store/__tests__/workflow-execution-event-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-execution-event-store.test.d.ts","sourceRoot":"","sources":["../../../../src/internal/store/__tests__/workflow-execution-event-store.test.ts"],"names":[],"mappings":""}

package/internal/store/__tests__/workflow-execution-event-store.test.js

@@ -0,0 +1,215 @@
+import { describe, it, expect, vi } from "vitest";
+import { create } from "@bufbuild/protobuf";
+import { WorkflowExecutionEventSchema, WorkflowEventType, TaskStartedPayloadSchema, TaskCompletedPayloadSchema, ApprovalRequestedPayloadSchema, ApprovalResolvedPayloadSchema, } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/event_pb";
+import { WorkflowExecutionEventStore } from "../workflow-execution-event-store";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeTaskStartedEvent(seq, taskName, opts = {}) {
+    return create(WorkflowExecutionEventSchema, {
+        eventId: `evt-${seq}`,
+        sequenceNumber: BigInt(seq),
+        occurredAt: "2026-05-22T00:00:00Z",
+        taskName,
+        eventType: WorkflowEventType.task_started,
+        payload: {
+            case: "taskStarted",
+            value: create(TaskStartedPayloadSchema, {
+                taskKind: opts.taskKind ?? 1,
+                attemptNumber: opts.attemptNumber ?? 1,
+            }),
+        },
+    });
+}
+function makeTaskCompletedEvent(seq, taskName, opts = {}) {
+    return create(WorkflowExecutionEventSchema, {
+        eventId: `evt-${seq}`,
+        sequenceNumber: BigInt(seq),
+        occurredAt: "2026-05-22T00:00:00Z",
+        taskName,
+        eventType: WorkflowEventType.task_completed,
+        payload: {
+            case: "taskCompleted",
+            value: create(TaskCompletedPayloadSchema, {
+                taskKind: 1,
+                durationMs: opts.durationMs ?? BigInt(100),
+                costMicros: opts.costMicros ?? BigInt(500),
+                tokensUsed: opts.tokensUsed ?? BigInt(200),
+            }),
+        },
+    });
+}
+function makeApprovalRequestedEvent(seq, taskName, prompt = "Please review") {
+    return create(WorkflowExecutionEventSchema, {
+        eventId: `evt-${seq}`,
+        sequenceNumber: BigInt(seq),
+        occurredAt: "2026-05-22T00:00:00Z",
+        taskName,
+        eventType: WorkflowEventType.approval_requested,
+        payload: {
+            case: "approvalRequested",
+            value: create(ApprovalRequestedPayloadSchema, { prompt }),
+        },
+    });
+}
+function makeApprovalResolvedEvent(seq, taskName, opts = {}) {
+    return create(WorkflowExecutionEventSchema, {
+        eventId: `evt-${seq}`,
+        sequenceNumber: BigInt(seq),
+        occurredAt: "2026-05-22T00:00:00Z",
+        taskName,
+        eventType: WorkflowEventType.approval_resolved,
+        payload: {
+            case: "approvalResolved",
+            value: create(ApprovalResolvedPayloadSchema, {
+                resolvedBy: opts.resolvedBy ?? "alice",
+                waitDurationMs: opts.waitDurationMs ?? BigInt(5000),
+            }),
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe("WorkflowExecutionEventStore", () => {
+    describe("appendEvents", () => {
+        it("appends new events and notifies listeners", () => {
+            const store = new WorkflowExecutionEventStore();
+            const listener = vi.fn();
+            store.subscribe(listener);
+            const events = [makeTaskStartedEvent(1, "build")];
+            store.appendEvents(events);
+            expect(store.getEvents()).toHaveLength(1);
+            expect(store.getEvents()[0].taskName).toBe("build");
+            expect(listener).toHaveBeenCalledTimes(1);
+        });
+        it("deduplicates by sequence number (events with seq <= current max are dropped)", () => {
+            const store = new WorkflowExecutionEventStore();
+            store.appendEvents([
+                makeTaskStartedEvent(1, "build"),
+                makeTaskStartedEvent(2, "test"),
+            ]);
+            expect(store.getEvents()).toHaveLength(2);
+            const listener = vi.fn();
+            store.subscribe(listener);
+            store.appendEvents([
+                makeTaskStartedEvent(1, "duplicate"),
+                makeTaskStartedEvent(2, "duplicate"),
+            ]);
+            expect(store.getEvents()).toHaveLength(2);
+            expect(listener).not.toHaveBeenCalled();
+        });
+        it("sorts appended events by sequence number", () => {
+            const store = new WorkflowExecutionEventStore();
+            store.appendEvents([
+                makeTaskStartedEvent(3, "third"),
+                makeTaskStartedEvent(1, "first"),
+                makeTaskStartedEvent(2, "second"),
+            ]);
+            const events = store.getEvents();
+            expect(events[0].sequenceNumber).toBe(BigInt(1));
+            expect(events[1].sequenceNumber).toBe(BigInt(2));
+            expect(events[2].sequenceNumber).toBe(BigInt(3));
+        });
+        it("invalidates taskStates cache on append", () => {
+            const store = new WorkflowExecutionEventStore();
+            store.appendEvents([makeTaskStartedEvent(1, "build")]);
+            const states1 = store.getTaskStates();
+            expect(states1.get("build")?.status).toBe("running");
+            store.appendEvents([makeTaskCompletedEvent(2, "build")]);
+            const states2 = store.getTaskStates();
+            expect(states2.get("build")?.status).toBe("completed");
+            expect(states1).not.toBe(states2);
+        });
+    });
+    describe("deriveTaskStates — approval lifecycle", () => {
+        it("taskStarted sets status to running", () => {
+            const store = new WorkflowExecutionEventStore();
+            store.appendEvents([makeTaskStartedEvent(1, "reviewGate", { taskKind: 16 })]);
+            const states = store.getTaskStates();
+            const task = states.get("reviewGate");
+            expect(task).toBeDefined();
+            expect(task.status).toBe("running");
+            expect(task.taskName).toBe("reviewGate");
+        });
+        it("approvalRequested transitions from running to waiting_approval", () => {
+            const store = new WorkflowExecutionEventStore();
+            store.appendEvents([
+                makeTaskStartedEvent(1, "reviewGate", { taskKind: 16 }),
+                makeApprovalRequestedEvent(2, "reviewGate"),
+            ]);
+            const states = store.getTaskStates();
+            expect(states.get("reviewGate").status).toBe("waiting_approval");
+        });
+        it("approvalResolved transitions from waiting_approval back to running", () => {
+            const store = new WorkflowExecutionEventStore();
+            store.appendEvents([
+                makeTaskStartedEvent(1, "reviewGate", { taskKind: 16 }),
+                makeApprovalRequestedEvent(2, "reviewGate"),
+                makeApprovalResolvedEvent(3, "reviewGate"),
+            ]);
+            const states = store.getTaskStates();
+            expect(states.get("reviewGate").status).toBe("running");
+        });
+        it("approvalResolved is no-op when task is not in waiting_approval", () => {
+            const store = new WorkflowExecutionEventStore();
+            store.appendEvents([
+                makeTaskStartedEvent(1, "reviewGate", { taskKind: 16 }),
+                makeApprovalResolvedEvent(2, "reviewGate"),
+            ]);
+            const states = store.getTaskStates();
+            expect(states.get("reviewGate").status).toBe("running");
+        });
+        it("full lifecycle: taskStarted → approvalRequested → approvalResolved → taskCompleted", () => {
+            const store = new WorkflowExecutionEventStore();
+            store.appendEvents([
+                makeTaskStartedEvent(1, "reviewGate", { taskKind: 16 }),
+                makeApprovalRequestedEvent(2, "reviewGate"),
+                makeApprovalResolvedEvent(3, "reviewGate"),
+                makeTaskCompletedEvent(4, "reviewGate"),
+            ]);
+            const states = store.getTaskStates();
+            const task = states.get("reviewGate");
+            expect(task.status).toBe("completed");
+            expect(task.durationMs).toBe(100);
+            expect(task.costMicros).toBe(BigInt(500));
+        });
+        it("approvalRequested without prior taskStarted is no-op (prev is undefined)", () => {
+            const store = new WorkflowExecutionEventStore();
+            store.appendEvents([makeApprovalRequestedEvent(1, "unknownTask")]);
+            const states = store.getTaskStates();
+            expect(states.has("unknownTask")).toBe(false);
+        });
+    });
+    describe("subscribe / reset", () => {
+        it("subscribe returns unsubscribe function", () => {
+            const store = new WorkflowExecutionEventStore();
+            const listener = vi.fn();
+            const unsub = store.subscribe(listener);
+            store.appendEvents([makeTaskStartedEvent(1, "build")]);
+            expect(listener).toHaveBeenCalledTimes(1);
+            unsub();
+            store.appendEvents([makeTaskCompletedEvent(2, "build")]);
+            expect(listener).toHaveBeenCalledTimes(1);
+        });
+        it("reset clears events, stream state, and caches", () => {
+            const store = new WorkflowExecutionEventStore();
+            store.appendEvents([makeTaskStartedEvent(1, "build")]);
+            store.setStreamState({ stage: "streaming", executionId: "exec-1" });
+            store.reset();
+            expect(store.getEvents()).toHaveLength(0);
+            expect(store.getStreamState()).toEqual({ stage: "idle" });
+            expect(store.getTaskStates().size).toBe(0);
+            expect(store.getLatestSequence()).toBe(BigInt(0));
+        });
+        it("reset notifies listeners", () => {
+            const store = new WorkflowExecutionEventStore();
+            store.appendEvents([makeTaskStartedEvent(1, "build")]);
+            const listener = vi.fn();
+            store.subscribe(listener);
+            store.reset();
+            expect(listener).toHaveBeenCalledTimes(1);
+        });
+    });
+});
+//# sourceMappingURL=workflow-execution-event-store.test.js.map