dirvi-lib 0.7.1 → 0.8.0

package/dist/tree-surfer/tree-node/tree-node.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree-node.schemas.d.ts","sourceRoot":"","sources":["../../../src/tree-surfer/tree-node/tree-node.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEjE;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,iDAA6C,CAAC;AAEhF;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,SAAS,eAAe,EAC1B,SAAS,SAAS,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,EACzC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;;;;;;;;;;;;EAoB3D"}
+{"version":3,"file":"tree-node.schemas.d.ts","sourceRoot":"","sources":["../../../src/tree-surfer/tree-node/tree-node.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEjE;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,iDAA6C,CAAC;AAEhF;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,SAAS,eAAe,EAC1B,IAAI,SAAS,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,EAC/B,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;EAoBrD"}

package/dist/tree-surfer/tree-node/tree-node.schemas.js

@@ -15,7 +15,7 @@ export const serializableKeySchema = z.union([z.string(), z.number().finite()]);
  *
  * The concrete application can extend these schemas with additional fields.
  */
-export function createTreeNodeSchemas(idSchema, childSchema) {
+export function createTreeNodeSchemas(idSchema, nodeSchema) {
     const leafSchema = z.object({
         id: idSchema,
     });
@@ -25,7 +25,7 @@ export function createTreeNodeSchemas(idSchema, childSchema) {
     });
     const openBranchSchema = z.object({
         id: idSchema,
-        children: z.array(childSchema),
+        children: z.array(nodeSchema),
     });
     return {
         leafSchema,

package/dist/tree-surfer/tree-node/tree-node.test.js

@@ -1,7 +1,7 @@
 import { describe, expect, it, vi } from 'vitest';
 import * as fc from 'fast-check';
 import { createTreeNodeApi } from './tree-node.impl.js';
-import { newBranchesOrNullArb, nodesArrayAndBranchPathArb, nodesArrayAndPathAndExpectedArb, } from './tree-node.arb.js';
+import { newBranchesOrNullArb, nodesArrayAndBranchPathArb, nodeAndPathAndExpectedArb, } from './tree-node.arb.js';
 const api = createTreeNodeApi();
 describe('getChildById', () => {
     it('UT: returns the matching direct child', () => {
@@ -23,23 +23,21 @@ describe('getChildById', () => {
 describe('getAtPath', () => {
     // Using `selector = vi.fn...` here is too heavy
     it('applies selector to the node at a valid path', () => {
-        fc.assert(fc.property(nodesArrayAndPathAndExpectedArb, ({ entries, path, expected }) => {
-            expect(api.getAtPath(entries, path, (node) => node)).toBe(expected);
-            expect(api.getAtPath(entries, path, (node) => node.id)).toBe(expected.id);
+        fc.assert(fc.property(nodeAndPathAndExpectedArb, ({ root, path, expected }) => {
+            expect(api.getAtPath(root, path, (node) => node)).toBe(expected);
+            expect(api.getAtPath(root, path, (node) => node.id)).toBe(expected.id);
         }));
     });
     it('UT: calls the selector once with the resolved node', () => {
-        const expected = { id: 'child' };
-        const entries = [
-            {
-                id: 'root',
-                children: [expected],
-            },
-        ];
+        const child = { id: 'child' };
+        const root = {
+            id: 'root',
+            children: [child],
+        };
         const selector = vi.fn((node) => node.id);
-        expect(api.getAtPath(entries, ['root', 'child'], selector)).toBe('child');
+        expect(api.getAtPath(root, ['child'], selector)).toBe('child');
         expect(selector).toHaveBeenCalledOnce();
-        expect(selector).toHaveBeenCalledWith(expected);
+        expect(selector).toHaveBeenCalledWith(child);
     });
     it('UT: returns undefined for an invalid root path without calling the selector', () => {
         const selector = vi.fn((node) => node.id);
@@ -48,38 +46,35 @@ describe('getAtPath', () => {
         expect(selector).not.toHaveBeenCalled();
     });
     it('UT: returns undefined when a child is missing from an open branch', () => {
-        const entries = [
-            {
-                id: 'root',
-                children: [{ id: 'child' }],
-            },
-        ];
+        const root = {
+            id: 'root',
+            children: [{ id: 'child' }],
+        };
         const selector = vi.fn((node) => node.id);
-        const result = api.getAtPath(entries, ['root', 'missing'], selector);
+        const result = api.getAtPath(root, ['root', 'missing'], selector);
         expect(result).toBeUndefined();
         expect(selector).not.toHaveBeenCalled();
     });
-    it('UT: returns undefined for an empty path without calling the selector', () => {
+    it('UT: resolves the root for an empty path', () => {
+        const root = { id: 'root' };
         const selector = vi.fn((node) => node.id);
-        const result = api.getAtPath([{ id: 'root' }], [], selector);
-        expect(result).toBeUndefined();
-        expect(selector).not.toHaveBeenCalled();
+        expect(api.getAtPath(root, [], selector)).toBe('root');
+        expect(selector).toHaveBeenCalledOnce();
+        expect(selector).toHaveBeenCalledWith(root);
     });
     it('UT: returns undefined through a closed branch without calling the selector', () => {
-        const entries = [
-            {
-                id: 'root',
-                children: null,
-            },
-        ];
+        const root = {
+            id: 'root',
+            children: null,
+        };
         const selector = vi.fn((node) => node.id);
-        const result = api.getAtPath(entries, ['root', 'child'], selector);
+        const result = api.getAtPath(root, ['child'], selector);
         expect(result).toBeUndefined();
         expect(selector).not.toHaveBeenCalled();
     });
     it('UT: returns undefined when the selector returns undefined', () => {
         const selector = vi.fn((_node) => undefined);
-        const result = api.getAtPath([{ id: 'root' }], ['root'], selector);
+        const result = api.getAtPath({ id: 'root' }, [], selector);
         expect(result).toBeUndefined();
         expect(selector).toHaveBeenCalledOnce();
         expect(selector).toHaveBeenCalledWith({ id: 'root' });
@@ -87,31 +82,31 @@ describe('getAtPath', () => {
 });
 describe('modifyAtPath', () => {
     it('replaces the generated node', () => {
-        fc.assert(fc.property(nodesArrayAndPathAndExpectedArb, ({ entries, path, expected }) => {
+        fc.assert(fc.property(nodeAndPathAndExpectedArb, ({ root, path, expected }) => {
             const replacement = {
                 id: expected.id,
             };
-            const updatedForest = api.modifyAtPath(entries, path, () => replacement);
-            expect(updatedForest).not.toBeUndefined();
-            if (updatedForest === undefined) {
+            const updatedRoot = api.modifyAtPath(root, path, () => replacement);
+            expect(updatedRoot).not.toBeUndefined();
+            if (updatedRoot === undefined) {
                 return;
             }
-            expect(api.getAtPath(updatedForest, path, (node) => node)).toBe(replacement);
-            expect(api.getAtPath(entries, path, (node) => node)).toBe(expected);
+            expect(api.getAtPath(updatedRoot, path, (node) => node)).toBe(replacement);
+            expect(api.getAtPath(root, path, (node) => node)).toBe(expected);
         }));
-    }, 10000);
+    }, 12000);
     it('replaces children at a branch path', () => {
-        fc.assert(fc.property(nodesArrayAndBranchPathArb, newBranchesOrNullArb, ({ entries, path, expected }, newBranches) => {
+        fc.assert(fc.property(nodesArrayAndBranchPathArb, newBranchesOrNullArb, ({ root, path, expected }, newBranches) => {
             expect(api.isBranch(expected)).toBe(true);
-            const updatedForest = api.modifyAtPath(entries, path, (node) => ({
+            const updatedRoot = api.modifyAtPath(root, path, (node) => ({
                 ...node,
                 children: newBranches,
             }));
-            expect(updatedForest).not.toBeUndefined();
-            if (updatedForest === undefined) {
+            expect(updatedRoot).not.toBeUndefined();
+            if (updatedRoot === undefined) {
                 return;
             }
-            const updatedNode = api.getAtPath(updatedForest, path, (node) => node);
+            const updatedNode = api.getAtPath(updatedRoot, path, (node) => node);
             expect(updatedNode).not.toBeUndefined();
             expect(updatedNode).not.toBe(expected);
             if (updatedNode === undefined ||
@@ -122,69 +117,69 @@ describe('modifyAtPath', () => {
             if (api.isOpenBranch(updatedNode)) {
                 expect([...api.getChildren(updatedNode)]).toStrictEqual(newBranches);
             }
-            expect(api.getAtPath(entries, path, (node) => node)).toBe(expected);
+            expect(api.getAtPath(root, path, (node) => node)).toBe(expected);
         }));
     });
     it('UT: calls the modifier once with the resolved node', () => {
         const child = { id: 'child' };
-        const entries = [
-            {
-                id: 'root',
-                children: [child],
-            },
-        ];
+        const root = {
+            id: 'root',
+            children: [child],
+        };
         const replacement = { id: 'replacement' };
         const modifier = vi.fn(() => replacement);
-        const updatedEntries = api.modifyAtPath(entries, ['root', 'child'], modifier);
-        expect(updatedEntries).toBeDefined();
+        const updatedRoot = api.modifyAtPath(root, ['child'], modifier);
+        expect(updatedRoot).toBeDefined();
         expect(modifier).toHaveBeenCalledOnce();
         expect(modifier).toHaveBeenCalledWith(child);
-        expect(api.getAtPath(updatedEntries, ['root', 'replacement'], (node) => node)).toBe(replacement);
-        expect(api.getAtPath(updatedEntries, ['root', 'child'], (node) => node)).toBeUndefined();
+        expect(api.getAtPath(updatedRoot, ['replacement'], (node) => node)).toBe(replacement);
+        expect(api.getAtPath(updatedRoot, ['child'], (node) => node)).toBeUndefined();
+    });
+    it('UT: modifies the root for an empty path', () => {
+        const root = { id: 'root' };
+        const replacement = { id: 'replacement' };
+        const modifier = vi.fn(() => replacement);
+        const updatedRoot = api.modifyAtPath(root, [], modifier);
+        expect(updatedRoot).toBe(replacement);
+        expect(modifier).toHaveBeenCalledOnce();
+        expect(modifier).toHaveBeenCalledWith(root);
     });
     it.each([
-        {
-            name: 'an empty path',
-            entries: [{ id: 'root' }],
-            path: [],
-        },
-        {
-            name: 'a missing root',
-            entries: [{ id: 'root' }],
-            path: ['missing'],
-        },
         {
             name: 'a missing child',
-            entries: [
-                {
-                    id: 'root',
-                    children: [{ id: 'child' }],
-                },
-            ],
-            path: ['root', 'missing'],
+            root: {
+                id: 'root',
+                children: [],
+            },
+            path: ['missing'],
         },
         {
             name: 'a path through a leaf',
-            entries: [{ id: 'root' }],
-            path: ['root', 'child'],
+            root: {
+                id: 'root',
+            },
+            path: ['child'],
         },
         {
             name: 'a path through a closed branch',
-            entries: [{ id: 'root', children: null }],
-            path: ['root', 'child'],
+            root: {
+                id: 'root',
+                children: null,
+            },
+            path: ['child'],
         },
-    ])('UT: returns undefined and does not call the modifier', ({ entries, path }) => {
+    ])('UT: returns undefined and does not call the modifier', ({ root, path }) => {
         const modifier = vi.fn((node) => node);
-        const result = api.modifyAtPath(entries, path, modifier);
+        const result = api.modifyAtPath(root, path, modifier);
         expect(result).toBeUndefined();
         expect(modifier).not.toHaveBeenCalled();
     });
     it('UT: returns undefined when the modifier aborts', () => {
-        const root = [{ id: 'root' }];
+        const root = { id: 'root' };
         const modifier = vi.fn(() => undefined);
-        const result = api.modifyAtPath(root, ['root'], modifier);
+        const result = api.modifyAtPath(root, [], modifier);
         expect(result).toBeUndefined();
         expect(modifier).toHaveBeenCalledOnce();
-        expect(modifier).toHaveBeenCalledWith(root[0]);
+        expect(modifier).toHaveBeenCalledWith(root);
     });
 });

package/dist/tree-surfer/tree-node/tree-node.types.d.ts

@@ -32,8 +32,7 @@ export type SerializableKey = string | number;
  *
  * @remarks
  *
- * A node's `id` identifies it among its siblings and is used when resolving
- * paths through the tree.
+ * A node's `id` identifies it among its siblings.
  *
  * Nodes are discriminated by the shape of their `children` property:
  *
@@ -79,23 +78,21 @@ export type ClosedBranchTreeNode<Id extends SerializableKey> = {
     children: null;
 };
 /**
- * Operations for inspecting and immutably updating a tree node array.
+ * Operations for inspecting and immutably updating a tree rooted at a node.
  *
  * @remarks
  *
- * A path is an array of IDs beginning at a root node and continuing through
- * its descendants.
+ * A path is an array of IDs relative to the supplied root node.
  *
  * For example, given tree with IDs:
  *
  *   root
  *   └── child
  *
- * the path to `child` is `['root', 'child']`.
+ * the path to `root` is `[]`, and the path to `child` is `['child']`.
  *
  * Paths cannot pass through leaves or closed branches. A closed branch may be
- * the final node in a path. An empty path does not identify a node and is
- * invalid for both lookup and modification operations.
+ * the final node in a path. An empty path identifies the root node.
  *
  * @typeParam Id - The type of node IDs.
  * @typeParam Node - The application-specific recursive node type.
@@ -124,20 +121,20 @@ export type TreeNodeApi<Id extends SerializableKey, Node extends TreeNode<Id, No
      */
     getChildById(node: OpenBranchTreeNode<Id, Node>, id: Id): Node | undefined;
     /**
-     * Applies a selector to the node at a path.
+     * Applies a selector to the node at a path relative to `root`.
      *
      * The selector is called only after the complete path has been resolved.
      * The selected node is not cloned.
      *
-     * @param entries - The root-level nodes of the forest.
-     * @param path - A non-empty path beginning at a root node.
+     * @param root - The node searching through.
+     * @param path - Path relative to root, with empty selecting the root.
      * @param selector - The function to apply to the resolved node.
      * @returns The selector result, or `undefined` when the path cannot be
      * resolved or the selector returns `undefined`.
      */
-    getAtPath<Result>(entries: Node[], path: Id[], selector: (node: Node) => Result): Result | undefined;
+    getAtPath<Result>(root: Node, path: readonly Id[], selector: (node: Node) => Result): Result | undefined;
     /**
-     * Immutably replaces the node at a path.
+     * Immutably replaces the node at a path relative to `root`.
      *
      * The modifier is called only after the complete path has been resolved.
      * Returning `undefined` aborts the modification.
@@ -146,12 +143,12 @@ export type TreeNodeApi<Id extends SerializableKey, Node extends TreeNode<Id, No
      * Unrelated nodes and arrays retain their original object identity. The
      * input array is never modified.
      *
-     * @param entries - The root-level nodes of the forest.
-     * @param path - A non-empty path beginning at a root node.
+     * @param root - The root node to modify.
+     * @param path - A path relative to root. An empty path selects the root.
      * @param modifier - Produces the replacement node.
-     * @returns A new forest, or `undefined` when the path cannot be resolved or
+     * @returns A new root, or `undefined` when the path cannot be resolved or
      * the modifier returns `undefined`.
      */
-    modifyAtPath(entries: Node[], path: Id[], modifier: (node: Node) => Node | undefined): Node[] | undefined;
+    modifyAtPath(root: Node, path: readonly Id[], modifier: (node: Node) => Node | undefined): Node | undefined;
 };
 //# sourceMappingURL=tree-node.types.d.ts.map

package/dist/tree-surfer/tree-node/tree-node.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree-node.types.d.ts","sourceRoot":"","sources":["../../../src/tree-surfer/tree-node/tree-node.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,MAAM,QAAQ,CAClB,EAAE,SAAS,eAAe,EAC1B,IAAI,SAAS,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,IAC7B,YAAY,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;AAEhD,+BAA+B;AAC/B,MAAM,MAAM,YAAY,CAAC,EAAE,SAAS,eAAe,IAAI;IACrD,EAAE,EAAE,EAAE,CAAC;IACP,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB,CAAC;AAEF,gEAAgE;AAChE,MAAM,MAAM,cAAc,CACxB,EAAE,SAAS,eAAe,EAC1B,IAAI,SAAS,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,IAC7B,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;AAK5D,uDAAuD;AACvD,MAAM,MAAM,kBAAkB,CAC5B,EAAE,SAAS,eAAe,EAC1B,IAAI,SAAS,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,IAC7B;IACF,EAAE,EAAE,EAAE,CAAC;IACP,QAAQ,EAAE,IAAI,EAAE,CAAC;CAClB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,oBAAoB,CAAC,EAAE,SAAS,eAAe,IAAI;IAC7D,EAAE,EAAE,EAAE,CAAC;IACP,QAAQ,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,WAAW,CACrB,EAAE,SAAS,eAAe,EAC1B,IAAI,SAAS,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,IAC7B;IACF,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9D,cAAc,CACZ,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,GAC7B,IAAI,IAAI,oBAAoB,CAAC,EAAE,CAAC,CAAC;IACpC,YAAY,CACV,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,GAC7B,IAAI,IAAI,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAExC;;;;;;;;OAQG;IACH,WAAW,CAAC,IAAI,EAAE,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEhE;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAE3E;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,MAAM,EACd,OAAO,EAAE,IAAI,EAAE,EACf,IAAI,EAAE,EAAE,EAAE,EACV,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,GAC/B,MAAM,GAAG,SAAS,CAAC;IAEtB;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CACV,OAAO,EAAE,IAAI,EAAE,EACf,IAAI,EAAE,EAAE,EAAE,EACV,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,SAAS,GACzC,IAAI,EAAE,GAAG,SAAS,CAAC;CACvB,CAAC"}
+{"version":3,"file":"tree-node.types.d.ts","sourceRoot":"","sources":["../../../src/tree-surfer/tree-node/tree-node.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,QAAQ,CAClB,EAAE,SAAS,eAAe,EAC1B,IAAI,SAAS,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,IAC7B,YAAY,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;AAEhD,+BAA+B;AAC/B,MAAM,MAAM,YAAY,CAAC,EAAE,SAAS,eAAe,IAAI;IACrD,EAAE,EAAE,EAAE,CAAC;IACP,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB,CAAC;AAEF,gEAAgE;AAChE,MAAM,MAAM,cAAc,CACxB,EAAE,SAAS,eAAe,EAC1B,IAAI,SAAS,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,IAC7B,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;AAK5D,uDAAuD;AACvD,MAAM,MAAM,kBAAkB,CAC5B,EAAE,SAAS,eAAe,EAC1B,IAAI,SAAS,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,IAC7B;IACF,EAAE,EAAE,EAAE,CAAC;IACP,QAAQ,EAAE,IAAI,EAAE,CAAC;CAClB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,oBAAoB,CAAC,EAAE,SAAS,eAAe,IAAI;IAC7D,EAAE,EAAE,EAAE,CAAC;IACP,QAAQ,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,WAAW,CACrB,EAAE,SAAS,eAAe,EAC1B,IAAI,SAAS,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,IAC7B;IACF,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9D,cAAc,CACZ,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,GAC7B,IAAI,IAAI,oBAAoB,CAAC,EAAE,CAAC,CAAC;IACpC,YAAY,CACV,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,GAC7B,IAAI,IAAI,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAExC;;;;;;;;OAQG;IACH,WAAW,CAAC,IAAI,EAAE,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEhE;;;;;;OAMG;IACH,YAAY,CAAC,IAAI,EAAE,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAE3E;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,MAAM,EACd,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,SAAS,EAAE,EAAE,EACnB,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,GAC/B,MAAM,GAAG,SAAS,CAAC;IAEtB;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CACV,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,SAAS,EAAE,EAAE,EACnB,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,SAAS,GACzC,IAAI,GAAG,SAAS,CAAC;CACrB,CAAC"}

package/dist/tree-surfer-ui/application/intent-to-effect.d.ts

@@ -1,6 +1,10 @@
 import { SerializableKey, TreeNode, TreeNodeApi } from '../../tree-surfer/index.js';
 import { Effect, Intent } from '../domain/index.js';
 import { CursorApi, State, StateApi } from '../../tree-surfer/index.js';
-export type IntentToEffect<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>> = (intent: Intent, state: State<Id, BufferNode>) => Effect<Id, BufferNode> | undefined;
-export declare function createIntentToEffect<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>>(stateApi: StateApi<Id, BufferNode>, cursorApi: CursorApi<Id>, treeNodeApi: TreeNodeApi<Id, BufferNode>): IntentToEffect<Id, BufferNode>;
+/**
+ * By design "effect = intent + state", so it awaits based on the intent and
+ * the current state whether an effect should be executed.
+ */
+export type IntentToEffect<Id extends SerializableKey, Node extends TreeNode<Id, Node>> = (intent: Intent, state: State<Id, Node>) => Effect<Id, Node> | undefined;
+export declare function createIntentToEffect<Id extends SerializableKey, Node extends TreeNode<Id, Node>>(stateApi: StateApi<Id, Node>, cursorApi: CursorApi<Id>, treeNodeApi: TreeNodeApi<Id, Node>): IntentToEffect<Id, Node>;
 //# sourceMappingURL=intent-to-effect.d.ts.map

package/dist/tree-surfer-ui/application/intent-to-effect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intent-to-effect.d.ts","sourceRoot":"","sources":["../../../src/tree-surfer-ui/application/intent-to-effect.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,QAAQ,EACR,WAAW,EACZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,MAAM,EAAgB,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAIxE,MAAM,MAAM,cAAc,CACxB,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,IACzC,CACF,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,KACzB,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,GAAG,SAAS,CAAC;AAGxC,wBAAgB,oBAAoB,CAClC,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,EAE3C,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,EAClC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,EACxB,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,UAAU,CAAC,GACvC,cAAc,CAAC,EAAE,EAAE,UAAU,CAAC,CAkEhC"}
+{"version":3,"file":"intent-to-effect.d.ts","sourceRoot":"","sources":["../../../src/tree-surfer-ui/application/intent-to-effect.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,QAAQ,EACR,WAAW,EACZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,MAAM,EAAgB,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAGxE;;;GAGG;AACH,MAAM,MAAM,cAAc,CACxB,EAAE,SAAS,eAAe,EAC1B,IAAI,SAAS,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,IAC7B,CACF,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,KACnB,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC;AAElC,wBAAgB,oBAAoB,CAClC,EAAE,SAAS,eAAe,EAC1B,IAAI,SAAS,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,EAE/B,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,EAC5B,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,EACxB,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,GACjC,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAmE1B"}

package/dist/tree-surfer-ui/application/intent-to-effect.js

@@ -1,5 +1,4 @@
 import { parseCommand } from './parse-command.js';
-// Factory method, since Apis are needed to derive intent
 export function createIntentToEffect(stateApi, cursorApi, treeNodeApi) {
     return (intent, state) => {
         switch (intent.intentType) {
@@ -73,10 +72,6 @@ function normalBufferToEffectResult(updatedNormalBuffer) {
                     normalBuffer: updatedNormalBuffer,
                 },
             };
-        case 'za':
-            return dispatchAction({
-                effectActionType: 'toggleFold',
-            });
         case 'zc':
             return dispatchAction({
                 effectActionType: 'fold',
@@ -98,12 +93,6 @@ function normalBufferToEffectResult(updatedNormalBuffer) {
 function normalInteractRightToEffect(state, stateApi, cursorApi, treeNodeApi) {
     const currentEntry = stateApi.getNodeAtCursor(state);
     if (currentEntry === undefined) {
-        if (state.cursor.kind === 'fold') {
-            return {
-                effectType: 'peekFold',
-                parentPath: state.cursor.parentPath
-            };
-        }
         return undefined;
     }
     const path = cursorApi.getPath(state.cursor);
@@ -126,7 +115,7 @@ function normalInteractRightToEffect(state, stateApi, cursorApi, treeNodeApi) {
     return;
 }
 function normalInteractLeftToEffect(state) {
-    if (state.cursor.parentPath.length === 0) {
+    if (state.cursor.length === 0) {
         return undefined;
     }
     return dispatchAction({

package/dist/tree-surfer-ui/application/user-input-to-intent.d.ts

@@ -1,3 +1,11 @@
-import { UserInput, InputState, Intent } from '../domain/index.js';
-export declare function userInputToIntent(userInput: UserInput, inputState: InputState): Intent | undefined;
+import { UserInput, InputModeState, Intent } from '../domain/index.js';
+/**
+ * By design "intent = input + mode + modeState", so it interprets the key
+ * inputs depending on the mode and input so far. No context in terms of UI.
+ *
+ * @param userInput - the key user input.
+ * @param inputModeState - the current mode and the user inputs so far.
+ * @returns The user's intent.
+ */
+export declare function userInputToIntent(userInput: UserInput, inputModeState: InputModeState): Intent | undefined;
 //# sourceMappingURL=user-input-to-intent.d.ts.map

package/dist/tree-surfer-ui/application/user-input-to-intent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-input-to-intent.d.ts","sourceRoot":"","sources":["../../../src/tree-surfer-ui/application/user-input-to-intent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGnE,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,UAAU,GACrB,MAAM,GAAG,SAAS,CAQpB"}
+{"version":3,"file":"user-input-to-intent.d.ts","sourceRoot":"","sources":["../../../src/tree-surfer-ui/application/user-input-to-intent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEvE;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,cAAc,GAC7B,MAAM,GAAG,SAAS,CAQpB"}

package/dist/tree-surfer-ui/application/user-input-to-intent.js

@@ -1,10 +1,17 @@
-// Derive the intent from the user input and the current input state.
-export function userInputToIntent(userInput, inputState) {
-    switch (inputState.inputMode) {
+/**
+ * By design "intent = input + mode + modeState", so it interprets the key
+ * inputs depending on the mode and input so far. No context in terms of UI.
+ *
+ * @param userInput - the key user input.
+ * @param inputModeState - the current mode and the user inputs so far.
+ * @returns The user's intent.
+ */
+export function userInputToIntent(userInput, inputModeState) {
+    switch (inputModeState.inputMode) {
         case 'normal':
-            return normalUserInputToIntent(userInput, inputState.normalBuffer);
+            return normalUserInputToIntent(userInput, inputModeState.normalBuffer);
         case 'command':
-            return commandUserInputToIntent(userInput, inputState.commandLine);
+            return commandUserInputToIntent(userInput, inputModeState.commandLine);
     }
 }
 function normalUserInputToIntent(userInput, normalBuffer) {

package/dist/tree-surfer-ui/domain/effect.d.ts

@@ -1,8 +1,8 @@
-import type { InputState } from './input-state.js';
+import type { InputModeState } from './input-mode-state.js';
 import { SerializableKey, TreeNode } from '../../tree-surfer/index.js';
-export type Effect<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>> = {
+export type Effect<Id extends SerializableKey, Node extends TreeNode<Id, Node>> = {
     effectType: 'dispatchEffectAction';
-    action: EffectAction<Id, BufferNode>;
+    action: EffectAction<Id, Node>;
 } | {
     effectType: 'loadBranchEntries';
     path: Id[];
@@ -23,23 +23,21 @@ export type Effect<Id extends SerializableKey, BufferNode extends TreeNode<Id, B
     exitMessage: string;
 } | {
     effectType: 'setInputState';
-    inputState: InputState;
+    inputState: InputModeState;
 };
-export type EffectAction<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>> = {
+export type EffectAction<Id extends SerializableKey, Node extends TreeNode<Id, Node>> = {
     effectActionType: 'nextEntry';
 } | {
     effectActionType: 'prevEntry';
 } | {
     effectActionType: 'setBranchEntries';
     path: Id[];
-    entries: BufferNode[] | null;
+    entries: Node[] | null;
 } | {
     effectActionType: 'navigateToParent';
 } | {
     effectActionType: 'fold';
 } | {
     effectActionType: 'unfold';
-} | {
-    effectActionType: 'toggleFold';
 };
 //# sourceMappingURL=effect.d.ts.map

package/dist/tree-surfer-ui/domain/effect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effect.d.ts","sourceRoot":"","sources":["../../../src/tree-surfer-ui/domain/effect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEvE,MAAM,MAAM,MAAM,CAChB,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,IAEzC;IACE,UAAU,EAAE,sBAAsB,CAAC;IACnC,MAAM,EAAE,YAAY,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;CACtC,GACD;IACE,UAAU,EAAE,mBAAmB,CAAC;IAChC,IAAI,EAAE,EAAE,EAAE,CAAC;CACZ,GACD;IACE,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,SAAS,EAAE,EAAE,CAAC;CAC3B,GACD;IACE,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB,GACD;IACE,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,UAAU,EAAE,wBAAwB,CAAC;CACtC,GACD;IACE,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAGN,MAAM,MAAM,YAAY,CACtB,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,IAEzC;IACE,gBAAgB,EAAE,WAAW,CAAC;CAC/B,GACD;IACE,gBAAgB,EAAE,WAAW,CAAC;CAC/B,GACD;IACE,gBAAgB,EAAE,kBAAkB,CAAC;IACrC,IAAI,EAAE,EAAE,EAAE,CAAC;IACX,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;CAC9B,GACD;IACE,gBAAgB,EAAE,kBAAkB,CAAC;CACtC,GACD;IACE,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,gBAAgB,EAAE,QAAQ,CAAC;CAC5B,GACD;IACE,gBAAgB,EAAE,YAAY,CAAC;CAChC,CAAC"}
+{"version":3,"file":"effect.d.ts","sourceRoot":"","sources":["../../../src/tree-surfer-ui/domain/effect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEvE,MAAM,MAAM,MAAM,CAChB,EAAE,SAAS,eAAe,EAC1B,IAAI,SAAS,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,IAE7B;IACE,UAAU,EAAE,sBAAsB,CAAC;IACnC,MAAM,EAAE,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;CAChC,GACD;IACE,UAAU,EAAE,mBAAmB,CAAC;IAChC,IAAI,EAAE,EAAE,EAAE,CAAC;CACZ,GACD;IACE,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,SAAS,EAAE,EAAE,CAAC;CAC3B,GACD;IACE,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB,GACD;IACE,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,UAAU,EAAE,wBAAwB,CAAC;CACtC,GACD;IACE,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,EAAE,cAAc,CAAC;CAC5B,CAAC;AAGN,MAAM,MAAM,YAAY,CACtB,EAAE,SAAS,eAAe,EAC1B,IAAI,SAAS,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,IAE7B;IACE,gBAAgB,EAAE,WAAW,CAAC;CAC/B,GACD;IACE,gBAAgB,EAAE,WAAW,CAAC;CAC/B,GACD;IACE,gBAAgB,EAAE,kBAAkB,CAAC;IACrC,IAAI,EAAE,EAAE,EAAE,CAAC;IACX,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;CACxB,GACD;IACE,gBAAgB,EAAE,kBAAkB,CAAC;CACtC,GACD;IACE,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,gBAAgB,EAAE,QAAQ,CAAC;CAC5B,CAAC"}

package/dist/tree-surfer-ui/domain/index.d.ts

@@ -1,5 +1,5 @@
 export * from './effect.js';
-export * from './input-state.js';
+export * from './input-mode-state.js';
 export * from './intent.js';
 export * from './user-input.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/tree-surfer-ui/domain/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tree-surfer-ui/domain/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tree-surfer-ui/domain/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/tree-surfer-ui/domain/index.js

@@ -1,4 +1,4 @@
 export * from './effect.js';
-export * from './input-state.js';
+export * from './input-mode-state.js';
 export * from './intent.js';
 export * from './user-input.js';

package/dist/tree-surfer-ui/domain/{input-state.d.ts → input-mode-state.d.ts}

@@ -1,8 +1,8 @@
-export type InputState = {
+export type InputModeState = {
     inputMode: 'normal';
     normalBuffer: string;
 } | {
     inputMode: 'command';
     commandLine: string;
 };
-//# sourceMappingURL=input-state.d.ts.map
+//# sourceMappingURL=input-mode-state.d.ts.map

package/dist/tree-surfer-ui/domain/input-mode-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-mode-state.d.ts","sourceRoot":"","sources":["../../../src/tree-surfer-ui/domain/input-mode-state.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB;IACE,SAAS,EAAE,QAAQ,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,GACD;IACE,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dirvi-lib",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "Dependency for dirvi apps.",
   "license": "LGPL-3.0-or-later",
   "type": "module",

package/dist/tree-surfer/tree-node/tree-node.arb.debug.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=tree-node.arb.debug.d.ts.map

package/dist/tree-surfer/tree-node/tree-node.arb.debug.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tree-node.arb.debug.d.ts","sourceRoot":"","sources":["../../../src/tree-surfer/tree-node/tree-node.arb.debug.ts"],"names":[],"mappings":""}

package/dist/tree-surfer-ui/domain/input-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"input-state.d.ts","sourceRoot":"","sources":["../../../src/tree-surfer-ui/domain/input-state.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB;IACE,SAAS,EAAE,QAAQ,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,GACD;IACE,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}