dirvi-lib 0.11.0-beta.6 → 0.11.0-beta.8

package/dist/app/reducer/reducer.js

@@ -1,24 +1,76 @@
-function firstAvailableAdditionalFoldIndex(foldsApi, state) {
+function firstAvailableAdditionalFoldIndex(foldsApi, folds) {
     let index = 1;
-    while (foldsApi.hasAtIndex(state.folds, index)) {
+    while (foldsApi.hasAtIndex(folds, index)) {
         index += 1;
     }
     return index;
 }
-export function createReducer(treeNodeApi, foldsApi) {
+export function createReducer(stateApi, navNodeApi) {
+    const { treeNodeApi, foldsApi, cursorApi } = stateApi;
+    /**
+     * Preserve the cursor if its position remains navigable. Otherwise, move it
+     * to a fold marker containing its representative entry, or to the nearest
+     * visible ancestor.
+     */
+    function reconcileCursor(state) {
+        const navigation = navNodeApi.from(stateApi.getRoot(state), stateApi.getFolds(state));
+        if (navigation === undefined || navigation.children === null) {
+            // StateApi guarantees that the root is a loaded branch.
+            throw new Error('Cannot navigate state: root is not a loaded branch.');
+        }
+        const cursor = stateApi.getCursor(state);
+        const positions = [
+            { path: [] },
+            ...navNodeApi.cursors(navigation.children),
+        ];
+        if (positions.some((position) => cursorApi.equal(position, cursor))) {
+            return state;
+        }
+        const path = cursorApi.getPath(cursor);
+        while (path.length > 0) {
+            const entryId = path.at(-1);
+            if (entryId !== undefined) {
+                const parentPath = path.slice(0, -1);
+                const parent = navNodeApi.getNodeAtPath(navigation.children, parentPath);
+                const foldEntry = parent?.entries.find((entry) => navNodeApi.entryIsFold(entry) &&
+                    entry.folded.some((foldedEntry) => !navNodeApi.entryIsFold(foldedEntry) &&
+                        foldedEntry.id === entryId));
+                if (foldEntry !== undefined && navNodeApi.entryIsFold(foldEntry)) {
+                    const firstEntry = foldEntry.folded.find((entry) => !navNodeApi.entryIsFold(entry));
+                    if (firstEntry !== undefined && !navNodeApi.entryIsFold(firstEntry)) {
+                        const foldCursor = {
+                            parentPath,
+                            firstId: firstEntry.id,
+                        };
+                        if (positions.some((position) => cursorApi.equal(position, foldCursor))) {
+                            return stateApi.update(state, { cursor: foldCursor }) ?? state;
+                        }
+                    }
+                }
+                const nodeCursor = { path: [...path] };
+                if (positions.some((position) => cursorApi.equal(position, nodeCursor))) {
+                    return stateApi.update(state, { cursor: nodeCursor }) ?? state;
+                }
+            }
+            path.pop();
+        }
+        // The root cursor is always included in `positions`.
+        return stateApi.update(state, { cursor: { path: [] } }) ?? state;
+    }
+    function update(state, changes) {
+        const nextState = stateApi.update(state, changes);
+        return nextState === undefined ? state : reconcileCursor(nextState);
+    }
     return (state, action) => {
         switch (action.kind) {
             case 'changeCursor':
-                return {
-                    ...state,
-                    cursor: action.cursor,
-                };
+                return update(state, { cursor: action.cursor });
             case 'updateBranch': {
-                const root = treeNodeApi.updateAtPath(state.root, action.path, (node) => {
+                const root = treeNodeApi.updateAtPath(stateApi.getRoot(state), action.path, (node) => {
                     /*
-                     * Loading/unloading is a branch-only operation. TreeNodeApi can
-                     * structurally convert any node, but the application reducer must
-                     * not turn a leaf into a branch.
+                     * Loading/unloading is a branch-only operation. TreeMethods can
+                     * structurally convert any node, but the reducer must not turn a
+                     * leaf into a branch.
                      */
                     if (treeNodeApi.kind(node) === 'leaf') {
                         return undefined;
@@ -35,19 +87,14 @@ export function createReducer(treeNodeApi, foldsApi) {
                 if (root === undefined || treeNodeApi.kind(root) !== 'loaded-branch') {
                     return state;
                 }
-                return {
-                    ...state,
-                    root,
-                };
+                return update(state, { root });
             }
             case 'setState': {
                 // A newer update has already been applied.
                 if (state !== action.oldState) {
                     return state;
                 }
-                return {
-                    ...action.newState,
-                };
+                return reconcileCursor(action.newState);
             }
             case 'addToFoldTree': {
                 const entryId = action.path.at(-1);
@@ -55,82 +102,69 @@ export function createReducer(treeNodeApi, foldsApi) {
                     return state;
                 }
                 const parentPath = action.path.slice(0, -1);
-                const folds = foldsApi.hideEntryAtPath(state.folds, action.foldTreeIndex, parentPath, entryId);
+                const folds = foldsApi.hideEntryAtPath(stateApi.getFolds(state), action.foldTreeIndex, parentPath, entryId);
                 if (folds === undefined) {
                     return state;
                 }
-                return {
-                    ...state,
+                return update(state, {
                     folds,
                     cursor: action.cursor,
-                };
+                });
             }
             case 'removeFromFoldTree': {
-                // TODO: Change to show only entry at cursor. mirroring addToFoldTree
-                const folds = foldsApi.showAllHiddenEntriesAtPath(state.folds, action.foldTreeIndex, action.path);
-                if (folds === undefined) {
-                    return state;
+                let folds = stateApi.getFolds(state);
+                if (action.entryIds === null) {
+                    const nextFolds = foldsApi.showAllHiddenEntriesAtPath(folds, action.foldTreeIndex, action.path);
+                    if (nextFolds === undefined) {
+                        return state;
+                    }
+                    folds = nextFolds;
+                }
+                else {
+                    for (const entryId of action.entryIds) {
+                        const nextFolds = foldsApi.showEntryAtPath(folds, action.foldTreeIndex, action.path, entryId);
+                        if (nextFolds === undefined) {
+                            return state;
+                        }
+                        folds = nextFolds;
+                    }
                 }
-                return {
-                    ...state,
+                return update(state, {
                     folds,
                     cursor: action.cursor,
-                };
+                });
             }
             case 'fold': {
-                const folds = foldsApi.activateAtIndex(state.folds, action.foldTreeIndex);
-                return folds === undefined
-                    ? state
-                    : {
-                        ...state,
-                        folds,
-                    };
+                const folds = foldsApi.activateAtIndex(stateApi.getFolds(state), action.foldTreeIndex);
+                return folds === undefined ? state : update(state, { folds });
             }
             case 'unfold': {
-                const folds = foldsApi.deactivateAtIndex(state.folds, action.foldTreeIndex);
-                return folds === undefined
-                    ? state
-                    : {
-                        ...state,
-                        folds,
-                    };
+                const folds = foldsApi.deactivateAtIndex(stateApi.getFolds(state), action.foldTreeIndex);
+                return folds === undefined ? state : update(state, { folds });
             }
             case 'toggleFold': {
-                const folds = foldsApi.toggleActiveAtIndex(state.folds, action.foldTreeIndex);
-                return folds === undefined
-                    ? state
-                    : {
-                        ...state,
-                        folds,
-                    };
+                const folds = foldsApi.toggleActiveAtIndex(stateApi.getFolds(state), action.foldTreeIndex);
+                return folds === undefined ? state : update(state, { folds });
             }
             case 'createFoldTree': {
-                const index = firstAvailableAdditionalFoldIndex(foldsApi, state);
-                const folds = foldsApi.setAdditionalFoldAtIndex(state.folds, index, 
-                // Obtain this through the actual TreeNodeApi root-ID operation.
-                treeNodeApi.id(state.root), {
+                const currentFolds = stateApi.getFolds(state);
+                const index = firstAvailableAdditionalFoldIndex(foldsApi, currentFolds);
+                const folds = foldsApi.setAdditionalFoldAtIndex(currentFolds, index, 
+                // Obtain this through the actual TreeMethods root-ID operation.
+                treeNodeApi.id(stateApi.getRoot(state)), {
                     name: action.name,
                     description: null,
                 });
-                return folds === undefined
-                    ? state
-                    : {
-                        ...state,
-                        folds,
-                    };
+                return folds === undefined ? state : update(state, { folds });
             }
             case 'deleteFoldTree': {
-                const index = foldsApi.getIndexByName(state.folds, action.name);
+                const currentFolds = stateApi.getFolds(state);
+                const index = foldsApi.getIndexByName(currentFolds, action.name);
                 if (index === undefined || index === 0) {
                     return state;
                 }
-                const folds = foldsApi.removeAdditionalFoldAtIndex(state.folds, index);
-                return folds === undefined
-                    ? state
-                    : {
-                        ...state,
-                        folds,
-                    };
+                const folds = foldsApi.removeAdditionalFoldAtIndex(currentFolds, index);
+                return folds === undefined ? state : update(state, { folds });
             }
             default: {
                 const _exhaustive = action;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export * from './trees/index.js';
+export * from './state-and-nav/index.js';
 export * from './feedback/index.js';
 export * from './app/index.js';
 export * from './input/application/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AAEjC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,8BAA8B,CAAC;AAE7C,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AAEzC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,8BAA8B,CAAC;AAE7C,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -1,4 +1,4 @@
-export * from './trees/index.js';
+export * from './state-and-nav/index.js';
 export * from './feedback/index.js';
 export * from './app/index.js';
 export * from './input/application/index.js';

package/dist/input/application/intent-to-effect.d.ts

@@ -1,4 +1,4 @@
-import type { CursorApi, SerializableKey, State, StateApi, TreeNodeApi } from '../../trees/index.js';
+import type { SerializableKey, State, StateApi } from '../../state-and-nav/index.js';
 import type { Effect, Intent } from '../domain/index.js';
 /**
  * Converts a user intent and the current tree state into an effect.
@@ -10,5 +10,5 @@ import type { Effect, Intent } from '../domain/index.js';
  * @typeParam Value - Application-owned data stored in each tree node.
  */
 export type IntentToEffect<Id extends SerializableKey, Value> = (intent: Intent, state: State<Id, Value>) => Effect<Id, Value> | undefined;
-export declare function createIntentToEffect<Id extends SerializableKey, Value>(registeredCommands: ReadonlySet<string>, stateApi: StateApi<Id, Value>, cursorApi: CursorApi<Id>, treeNodeApi: TreeNodeApi<Id, Value>): IntentToEffect<Id, Value>;
+export declare function createIntentToEffect<Id extends SerializableKey, Value>(registeredCommands: ReadonlySet<string>, stateApi: StateApi<Id, Value>): IntentToEffect<Id, Value>;
 //# sourceMappingURL=intent-to-effect.d.ts.map

package/dist/input/application/intent-to-effect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intent-to-effect.d.ts","sourceRoot":"","sources":["../../../src/input/application/intent-to-effect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,KAAK,EACL,QAAQ,EACR,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAKvE;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,IAAI,CAC9D,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,KACpB,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,SAAS,CAAC;AAEnC,wBAAgB,oBAAoB,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EACpE,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,EACvC,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,EAC7B,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,EACxB,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,KAAK,CAAC,GAClC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAkE3B"}
+{"version":3,"file":"intent-to-effect.d.ts","sourceRoot":"","sources":["../../../src/input/application/intent-to-effect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,KAAK,EACL,QAAQ,EACT,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAKvE;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,IAAI,CAC9D,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,KACpB,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,SAAS,CAAC;AAEnC,wBAAgB,oBAAoB,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EACpE,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,EACvC,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,GAC5B,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAgE3B"}

package/dist/input/application/intent-to-effect.js

@@ -1,14 +1,14 @@
 import { parseExCommand } from './parse-ex-command.js';
 import { parseNormalCommand } from './parse-normal-command.js';
-export function createIntentToEffect(registeredCommands, stateApi, cursorApi, treeNodeApi) {
+export function createIntentToEffect(registeredCommands, stateApi) {
     return (intent, state) => {
         switch (intent.intentType) {
             case 'setNormalBuffer':
                 return normalBufferToEffectResult(intent.normalBuffer);
             case 'normalRight':
-                return normalInteractRightToEffect(state, stateApi, cursorApi, treeNodeApi);
+                return normalInteractRightToEffect(state, stateApi);
             case 'normalLeft':
-                return normalInteractLeftToEffect(state, cursorApi);
+                return normalInteractLeftToEffect(state, stateApi);
             case 'normalDown':
                 return dispatchAction({
                     effectActionType: 'nextEntry',
@@ -106,16 +106,16 @@ function normalBufferToEffectResult(updatedNormalBuffer) {
  * - An open branch dispatches an action that closes/unloads its children.
  * - A leaf has no right-interaction effect.
  */
-function normalInteractRightToEffect(state, stateApi, cursorApi, treeNodeApi) {
+function normalInteractRightToEffect(state, stateApi) {
     const currentEntry = stateApi.getNodeAtCursor(state);
     if (currentEntry === undefined) {
         return undefined;
     }
-    const path = cursorApi.getPath(state.cursor);
+    const path = stateApi.cursorPath(state);
     if (path === undefined) {
         return undefined;
     }
-    switch (treeNodeApi.kind(currentEntry)) {
+    switch (stateApi.treeNodeApi.kind(currentEntry)) {
         case 'unloaded-branch':
             return {
                 effectType: 'loadBranchEntries',
@@ -137,9 +137,8 @@ function normalInteractRightToEffect(state, stateApi, cursorApi, treeNodeApi) {
  * Left from the root has no effect. Otherwise dispatch navigation to the
  * parent entry.
  */
-function normalInteractLeftToEffect(state, cursorApi) {
-    const path = cursorApi.getPath(state.cursor);
-    if (path === undefined || path.length === 0) {
+function normalInteractLeftToEffect(state, stateApi) {
+    if (stateApi.isCursorRoot(state)) {
         return undefined;
     }
     return dispatchAction({

package/dist/input/application/parse-ex-command.d.ts

@@ -1,4 +1,4 @@
-import type { SerializableKey } from '../../trees/index.js';
+import type { SerializableKey } from '../../state-and-nav/index.js';
 import type { Effect } from '../domain/index.js';
 /**
  * Parses a Vim-style Ex command line into an application effect.

package/dist/input/application/parse-ex-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-ex-command.d.ts","sourceRoot":"","sources":["../../../src/input/application/parse-ex-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA6IjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,cAAc,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EAC9D,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,GACtC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,SAAS,CAoE/B"}
+{"version":3,"file":"parse-ex-command.d.ts","sourceRoot":"","sources":["../../../src/input/application/parse-ex-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA6IjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,cAAc,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EAC9D,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,GACtC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,SAAS,CAoE/B"}

package/dist/input/application/parse-normal-command.d.ts

@@ -1,4 +1,4 @@
-import type { SerializableKey } from '../../trees/index.js';
+import type { SerializableKey } from '../../state-and-nav/index.js';
 import type { EffectAction } from '../domain/index.js';
 export type ParseNormalCommandResult<Id extends SerializableKey, Value> = {
     kind: 'incomplete';

package/dist/input/application/parse-normal-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-normal-command.d.ts","sourceRoot":"","sources":["../../../src/input/application/parse-normal-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOvD,MAAM,MAAM,wBAAwB,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,IAClE;IACE,IAAI,EAAE,YAAY,CAAC;CACpB,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;CACjC,GACD;IACE,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAEN,wBAAgB,kBAAkB,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EAClE,YAAY,EAAE,MAAM,GACnB,wBAAwB,CAAC,EAAE,EAAE,KAAK,CAAC,CAwCrC"}
+{"version":3,"file":"parse-normal-command.d.ts","sourceRoot":"","sources":["../../../src/input/application/parse-normal-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOvD,MAAM,MAAM,wBAAwB,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,IAClE;IACE,IAAI,EAAE,YAAY,CAAC;CACpB,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;CACjC,GACD;IACE,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAEN,wBAAgB,kBAAkB,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EAClE,YAAY,EAAE,MAAM,GACnB,wBAAwB,CAAC,EAAE,EAAE,KAAK,CAAC,CAwCrC"}

package/dist/input/domain/effect.d.ts

@@ -1,6 +1,5 @@
 import type { InputModeState } from './input-mode-state.js';
-import type { SerializableKey, TreeNode } from '../../trees/index.js';
-export type EffectClosure = () => void | Promise<void>;
+import type { SerializableKey, TreeNode } from '../../state-and-nav/index.js';
 /**
  * An effect is some execution to be done in `App`, that could affect the shell
  * or current app of dirvi.

package/dist/input/domain/effect.d.ts.map

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

package/dist/state-and-nav/cursor.d.ts

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+/**
+ * A root-relative path identifying the current tree position.
+ *
+ * The empty path identifies the tree root. A non-empty path identifies a
+ * descendant by following child IDs from the root.
+ *
+ * For example, given:
+ *
+ * ```
+ * root
+ * └── src
+ *     └── main.ts
+ * ```
+ *
+ * the cursors are:
+ *
+ * ```ts
+ * { path: [] }                              // root
+ * { path: ['src'] }                         // src
+ * { path: ['src', 'main.ts'] }              // main.ts
+ * ```
+ *
+ * @typeParam Id - The type of node IDs.
+ */
+export type NodeCursor<Id> = Readonly<{
+    path: readonly Id[];
+}>;
+/**
+ * Fold cursors identify a contiguous fold run by its parent path and the ID of
+ * its first hidden child.
+ */
+export type FoldCursor<Id> = Readonly<{
+    parentPath: readonly Id[];
+    firstId: Id;
+}>;
+/**
+ * A position in navigation.
+ *
+ * Unordered navigation uses node cursors only. Ordered navigation may also
+ * use fold cursors to identify inline fold blocks.
+ */
+export type Cursor<Id> = NodeCursor<Id> | FoldCursor<Id>;
+/**
+ * Creates a schema for cursors.
+ *
+ * The schema validates the IDs in the path using the param, but does not verify
+ * that the path exists in a particular tree.
+ *
+ * @typeParam IdSchema - type passed on so the parsed output can include `Id`
+ * type.
+ * @param idSchema - schema for the `Id` type.
+ */
+export declare function createCursorSchema<IdSchema extends z.ZodTypeAny>(idSchema: IdSchema): z.ZodUnion<readonly [z.ZodObject<{
+    path: z.ZodArray<IdSchema>;
+}, z.core.$strict>, z.ZodObject<{
+    parentPath: z.ZodArray<IdSchema>;
+    firstId: IdSchema;
+}, z.core.$strict>]>;
+/**
+ * Operations for comparing and inspecting cursors.
+ *
+ * @typeParam Id - The type of node IDs.
+ */
+export type CursorMethods<Id> = {
+    isNodeCursor(cursor: Cursor<Id>): cursor is NodeCursor<Id>;
+    isFoldCursor(cursor: Cursor<Id>): cursor is FoldCursor<Id>;
+    /**
+     * Tests whether two cursors identify the same tree position.
+     */
+    equal(left: Cursor<Id>, right: Cursor<Id>): boolean;
+    /**
+     * Returns a mutable copy of the path to the cursor, returning the path of the
+     * first hidden child represented by a fold cursor.
+     *
+     * The empty path identifies the tree root.
+     */
+    getPath(cursor: Cursor<Id>): Id[];
+    /**
+     * Tests whether the cursor's path is within the subtree at `path`.
+     * A fold cursor uses its first hidden child's path as its representative path.
+     *
+     * The subtree includes the node at `path` itself. Therefore, equal
+     * paths return `true`, and an empty `path` contains every cursor.
+     */
+    cursorBelongsToSubtree(cursor: Cursor<Id>, path: readonly Id[]): boolean;
+};
+export declare function createCursorMethods<Id>(): CursorMethods<Id>;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/state-and-nav/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/state-and-nav/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,UAAU,CAAC,EAAE,IAAI,QAAQ,CAAC;IACpC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC;CACrB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,EAAE,IAAI,QAAQ,CAAC;IACpC,UAAU,EAAE,SAAS,EAAE,EAAE,CAAC;IAC1B,OAAO,EAAE,EAAE,CAAC;CACb,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,MAAM,CAAC,EAAE,IAAI,UAAU,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;AAEzD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,SAAS,CAAC,CAAC,UAAU,EAC9D,QAAQ,EAAE,QAAQ;;;;;qBAanB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,EAAE,IAAI;IAC9B,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAC3D,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAE3D;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC;IAEpD;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC;IAElC;;;;;;OAMG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,GAAG,OAAO,CAAC;CAC1E,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,EAAE,KAAK,aAAa,CAAC,EAAE,CAAC,CAqC3D"}

package/dist/state-and-nav/cursor.js

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+/**
+ * Creates a schema for cursors.
+ *
+ * The schema validates the IDs in the path using the param, but does not verify
+ * that the path exists in a particular tree.
+ *
+ * @typeParam IdSchema - type passed on so the parsed output can include `Id`
+ * type.
+ * @param idSchema - schema for the `Id` type.
+ */
+export function createCursorSchema(idSchema) {
+    const pathSchema = z.array(idSchema);
+    return z.union([
+        z.object({
+            path: pathSchema,
+        }).strict(),
+        z.object({
+            parentPath: pathSchema,
+            firstId: idSchema,
+        }).strict(),
+    ]);
+}
+export function createCursorMethods() {
+    function isNodeCursor(cursor) {
+        return 'path' in cursor;
+    }
+    function isFoldCursor(cursor) {
+        return !isNodeCursor(cursor);
+    }
+    function getPath(cursor) {
+        return isNodeCursor(cursor)
+            ? [...cursor.path]
+            : [...cursor.parentPath, cursor.firstId];
+    }
+    return {
+        isNodeCursor,
+        isFoldCursor,
+        equal(left, right) {
+            if (isNodeCursor(left)) {
+                return isNodeCursor(right) && idPathEqual(left.path, right.path);
+            }
+            return (isFoldCursor(right) &&
+                left.firstId === right.firstId &&
+                idPathEqual(left.parentPath, right.parentPath));
+        },
+        getPath,
+        cursorBelongsToSubtree(cursor, path) {
+            return isPathPrefix(path, getPath(cursor));
+        },
+    };
+}
+/**
+ * Returns true when both root-relative paths contain the same IDs in the same
+ * order.
+ */
+function idPathEqual(left, right) {
+    if (left.length !== right.length) {
+        return false;
+    }
+    for (let index = 0; index < left.length; index += 1) {
+        if (left[index] !== right[index]) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Returns true when `prefix` is a prefix of `path`.
+ *
+ * Equal paths are included. An empty prefix is therefore a prefix of every
+ * path.
+ */
+function isPathPrefix(prefix, path) {
+    if (prefix.length > path.length) {
+        return false;
+    }
+    for (let index = 0; index < prefix.length; index += 1) {
+        if (prefix[index] !== path[index]) {
+            return false;
+        }
+    }
+    return true;
+}

package/dist/{trees → state-and-nav}/fold-node/deprecated/fold-node.impl.d.ts

@@ -1,5 +1,5 @@
 import type { FoldNodeApi, FoldNodeService } from './fold-node.types.js';
-import type { SerializableKey } from '../../tree-node/index.js';
+import type { SerializableKey } from '../../tree/index.js';
 /**
  * Creates semantic operations for a fold-state tree.
  *

package/dist/state-and-nav/fold-node/deprecated/fold-node.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-node.impl.d.ts","sourceRoot":"","sources":["../../../../src/state-and-nav/fold-node/deprecated/fold-node.impl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,WAAW,EACX,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,SAAS,eAAe,EAC9D,WAAW,EAAE,WAAW,CAAC,EAAE,CAAC,GAC3B,eAAe,CAAC,EAAE,CAAC,CA0WrB"}

package/dist/state-and-nav/fold-node/deprecated/fold-node.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-node.test.d.ts","sourceRoot":"","sources":["../../../../src/state-and-nav/fold-node/deprecated/fold-node.test.ts"],"names":[],"mappings":""}

package/dist/{trees → state-and-nav}/fold-node/deprecated/fold-node.test.js

@@ -1,7 +1,7 @@
 import { describe, expect, it } from 'vitest';
-import { createTreeNodeApi } from '../../tree-node/tree-node.impl.js';
+import { createTreeMethods } from '../../tree/index.js';
 import { createFoldNodeService } from './fold-node.impl.js';
-const foldNodeApi = createTreeNodeApi();
+const foldNodeApi = createTreeMethods();
 const service = createFoldNodeService(foldNodeApi);
 function createFoldNode(id, options = {}) {
     const node = foldNodeApi.createLoadedBranch(id, {

package/dist/{trees → state-and-nav}/fold-node/deprecated/fold-node.types.d.ts

@@ -1,4 +1,4 @@
-import type { TreeNode, TreeNodeApi, SerializableKey } from '../../tree-node/index.js';
+import type { TreeNode, TreeMethods, SerializableKey } from '../../tree/index.js';
 /**
  * Application-specific state stored in each fold-tree node.
  *
@@ -18,7 +18,7 @@ export type FoldNode<Id extends SerializableKey> = TreeNode<Id, FoldNodeValue<Id
 /**
  * Generic structural operations specialized to a fold-state tree.
  */
-export type FoldNodeApi<Id extends SerializableKey> = TreeNodeApi<Id, FoldNodeValue<Id>>;
+export type FoldNodeApi<Id extends SerializableKey> = TreeMethods<Id, FoldNodeValue<Id>>;
 /**
  * Semantic operations for managing fold state.
  *

package/dist/state-and-nav/fold-node/deprecated/fold-node.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-node.types.d.ts","sourceRoot":"","sources":["../../../../src/state-and-nav/fold-node/deprecated/fold-node.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EACX,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAE7B;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CAAC,EAAE,SAAS,eAAe,IAAI,QAAQ,CAAC;IAC/D,cAAc,EAAE,SAAS,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;CACzC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,CAAC,EAAE,SAAS,eAAe,IAAI,QAAQ,CACzD,EAAE,EACF,aAAa,CAAC,EAAE,CAAC,CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,EAAE,SAAS,eAAe,IAAI,WAAW,CAC/D,EAAE,EACF,aAAa,CAAC,EAAE,CAAC,CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,eAAe,CAAC,EAAE,SAAS,eAAe,IAAI;IACxD;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,EAAE,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAEtC;;;;;;;;;;;;;;OAcG;IACH,sBAAsB,CACpB,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,EACtB,IAAI,EAAE,SAAS,EAAE,EAAE,EACnB,OAAO,EAAE,EAAE,GACV,OAAO,CAAC;IAEX;;;;OAIG;IACH,mBAAmB,CACjB,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,EACtB,IAAI,EAAE,SAAS,EAAE,EAAE,GAClB,EAAE,EAAE,GAAG,SAAS,CAAC;IAEpB;;;;;;;;;;;;;;;;;OAiBG;IACH,oBAAoB,CAClB,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,EACtB,IAAI,EAAE,SAAS,EAAE,EAAE,EACnB,OAAO,EAAE,EAAE,GACV,QAAQ,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;IAE5B;;;;;;;;;;;;;;;;;OAiBG;IACH,uBAAuB,CACrB,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,EACtB,IAAI,EAAE,SAAS,EAAE,EAAE,EACnB,OAAO,EAAE,EAAE,GACV,QAAQ,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;IAE5B;;;;;;;;;;;;;;;;;;OAkBG;IACH,wBAAwB,CACtB,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,EACtB,IAAI,EAAE,SAAS,EAAE,EAAE,GAClB,QAAQ,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;CAC7B,CAAC"}

package/dist/{trees → state-and-nav}/fold-node/fold-node.impl.d.ts

@@ -1,5 +1,5 @@
-import type { SerializableKey, TreeNodeApi } from '../tree-node/index.js';
-import type { FoldsApi } from './fold-node.types.js';
+import type { SerializableKey, TreeMethods } from '../tree/index.js';
+import type { FoldMethods } from './fold-node.types.js';
 /**
  * IDs of direct source-tree entries hidden at one source-tree branch.
  */
@@ -11,6 +11,6 @@ type HiddenEntryIds<Id extends SerializableKey> = readonly Id[];
  * Each fold tree preserves its own hidden-entry definition. An entry is hidden
  * by the aggregate when at least one active fold tree hides it.
  */
-export declare function createFoldsApi<Id extends SerializableKey>(foldTreeApi: TreeNodeApi<Id, HiddenEntryIds<Id>>): FoldsApi<Id>;
+export declare function createFoldMethods<Id extends SerializableKey>(foldTreeApi: TreeMethods<Id, HiddenEntryIds<Id>>): FoldMethods<Id>;
 export {};
 //# sourceMappingURL=fold-node.impl.d.ts.map

package/dist/state-and-nav/fold-node/fold-node.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-node.impl.d.ts","sourceRoot":"","sources":["../../../src/state-and-nav/fold-node/fold-node.impl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAM1B,OAAO,KAAK,EAIV,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,KAAK,cAAc,CAAC,EAAE,SAAS,eAAe,IAAI,SAAS,EAAE,EAAE,CAAC;AA0ChE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,SAAS,eAAe,EAC1D,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC,GAC/C,WAAW,CAAC,EAAE,CAAC,CA8nBjB"}

package/dist/{trees → state-and-nav}/fold-node/fold-node.impl.js

@@ -17,7 +17,7 @@ function hasUniqueValues(values) {
  * Each fold tree preserves its own hidden-entry definition. An entry is hidden
  * by the aggregate when at least one active fold tree hides it.
  */
-export function createFoldsApi(foldTreeApi) {
+export function createFoldMethods(foldTreeApi) {
     function createEmptyFoldTree(rootId) {
         const tree = foldTreeApi.createLoadedBranch(rootId, [], []);
         /*

package/dist/{trees → state-and-nav}/fold-node/fold-node.model.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import type { SerializableKey } from '../tree-node/index.js';
+import type { SerializableKey } from '../tree/index.js';
 /**
  * Serializable semantic representation of one fold-state tree node.
  *

package/dist/state-and-nav/fold-node/fold-node.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-node.model.d.ts","sourceRoot":"","sources":["../../../src/state-and-nav/fold-node/fold-node.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAYxD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,aAAa,CAAC,EAAE,SAAS,eAAe,IAAI,QAAQ,CAAC;IAC/D;;OAEG;IACH,EAAE,EAAE,EAAE,CAAC;IAEP;;;;;OAKG;IACH,cAAc,EAAE,SAAS,EAAE,EAAE,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,EAAE,SAAS,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC;CACxC,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,SAAS,eAAe,EAClE,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,GACtB,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CA0B9B;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CAAC,EAAE,SAAS,eAAe,IAAI,QAAQ,CAAC;IAC/D;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;;;;OAKG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;CACzB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CAAC,EAAE,SAAS,eAAe,IAAI,QAAQ,CAAC;IAC5D,KAAK,EAAE,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;CACtE,CAAC,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,SAAS,eAAe,EAC/D,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,GACtB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAmB3B"}