dirvi-lib 0.10.0 → 0.11.0-beta.12

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

@@ -1,12 +1,24 @@
 import type { InputModeState } from './input-mode-state.js';
-import type { SerializableKey, TreeNode } from '../../trees/index.js';
+import type { SerializableKey, TreeNode } from '../../state-and-nav/index.js';
 /**
- * An effect produced by interpreting an intent against the current state.
+ * An effect is some execution to be done in `App`, that could affect the shell
+ * or current app of dirvi.
+ *
+ * It is produced by interpreting an intent against the current state.
  *
  * @typeParam Id - The sibling-unique tree-node ID type.
  * @typeParam Value - Application-owned data stored in each tree node.
  */
 export type Effect<Id extends SerializableKey, Value> = Readonly<{
+    effectType: 'quit';
+    exitMessage: string;
+}> | Readonly<{
+    effectType: 'listApps';
+}> | Readonly<{
+    effectType: 'switchApp';
+    appId: string;
+    input: string | undefined;
+}> | Readonly<{
     effectType: 'dispatchEffectAction';
     action: EffectAction<Id, Value>;
 }> | Readonly<{
@@ -19,19 +31,18 @@ export type Effect<Id extends SerializableKey, Value> = Readonly<{
 }> | Readonly<{
     effectType: 'loadView';
     name: string;
-}> | Readonly<{
-    effectType: 'emitVisibleLeavesPaths';
 }> | Readonly<{
     effectType: 'listFolds';
-}> | Readonly<{
-    effectType: 'quit';
-    exitMessage: string;
 }> | Readonly<{
     effectType: 'setInputState';
     inputState: InputModeState;
 }> | Readonly<{
-    effectType: 'unrecognizedCommand';
-    commandLine: string;
+    effectType: 'userExCommand';
+    name: string;
+    args: readonly string[];
+}> | Readonly<{
+    effectType: 'emitError';
+    message: string;
 }>;
 /**
  * A user-facing reference to a fold tree.

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, [], []);
         /*
@@ -180,7 +180,7 @@ export function createFoldsApi(foldTreeApi) {
         return foldTreeApi.withLoadedChildren(tree, updatedChildren);
     }
     function foldTreeToModel(tree) {
-        return foldTreeApi.match(tree, {
+        return foldTreeApi.matchByKind(tree, {
             leaf: () => {
                 throw new Error('Fold trees must contain loaded branch nodes');
             },

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"}

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

@@ -1,4 +1,4 @@
-import type { SerializableKey } from '../tree-node/index.js';
+import type { SerializableKey } from '../tree/index.js';
 import type { FoldSlotModel, FoldsModel } from './fold-node.model.js';
 declare const foldsBrand: unique symbol;
 /**
@@ -39,7 +39,7 @@ export type Folds<Id extends SerializableKey> = {
         readonly id: Id;
     };
 };
-export type FoldsApi<Id extends SerializableKey> = Readonly<{
+export type FoldMethods<Id extends SerializableKey> = Readonly<{
     /**
      * Creates Folds with its required primary fold tree in slot zero.
      *

package/dist/state-and-nav/fold-node/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/fold-node.types.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/state-and-nav/fold-node/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

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

@@ -0,0 +1,16 @@
+export type { SerializableKey } from './tree/index.js';
+export type { TreeNode } from './tree/index.js';
+export type { Folds } from './fold-node/index.js';
+export type { Cursor } from './cursor.js';
+export type { TreeMethods } from './tree/index.js';
+export { createTreeMethods } from './tree/index.js';
+export type { FoldIndex, FoldMethods } from './fold-node/index.js';
+export { createFoldMethods } from './fold-node/index.js';
+export type { CursorMethods } from './cursor.js';
+export { createCursorMethods } from './cursor.js';
+export type { State, StateMethods } from './state/state.types.js';
+export { createStateApi } from './state/state.impl.js';
+export type { NavEntry, NavFold, NavNode, NavMethods, NavBranch } from './nav/nav.types.js';
+export { createOrderedNavMethods } from './nav/nav.ordered.impl.js';
+export { createUnorderedNavMethods } from './nav/nav.unordered.impl.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state-and-nav/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIvD,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIlD,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC"}

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

@@ -0,0 +1,6 @@
+export { createTreeMethods } from './tree/index.js';
+export { createFoldMethods } from './fold-node/index.js';
+export { createCursorMethods } from './cursor.js';
+export { createStateApi } from './state/state.impl.js';
+export { createOrderedNavMethods } from './nav/nav.ordered.impl.js';
+export { createUnorderedNavMethods } from './nav/nav.unordered.impl.js';

package/dist/state-and-nav/nav/nav.ordered.impl.d.ts

@@ -0,0 +1,12 @@
+import type { SerializableKey, TreeMethods } from '../tree/index.js';
+import type { FoldMethods } from '../fold-node/index.js';
+import type { CursorMethods } from '../cursor.js';
+import type { NavMethods } from './nav.types.js';
+/**
+ * Creates an ordered navigation projection.
+ *
+ * Source sibling order is preserved. Each maximal contiguous run of hidden
+ * direct children becomes one inline fold marker.
+ */
+export declare function createOrderedNavMethods<Id extends SerializableKey, Value>(treeMethods: TreeMethods<Id, Value>, foldMethods: FoldMethods<Id>, cursorMethods: CursorMethods<Id>): NavMethods<Id, Value>;
+//# sourceMappingURL=nav.ordered.impl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nav.ordered.impl.d.ts","sourceRoot":"","sources":["../../../src/state-and-nav/nav/nav.ordered.impl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAY,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,KAAK,EAAS,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAIV,UAAU,EAEX,MAAM,gBAAgB,CAAC;AAGxB;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EACvE,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,KAAK,CAAC,EACnC,WAAW,EAAE,WAAW,CAAC,EAAE,CAAC,EAC5B,aAAa,EAAE,aAAa,CAAC,EAAE,CAAC,GAC/B,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,CAmGvB"}

package/dist/state-and-nav/nav/nav.ordered.impl.js

@@ -0,0 +1,77 @@
+import { createNavTraversalMethods } from './nav.traversal.js';
+/**
+ * Creates an ordered navigation projection.
+ *
+ * Source sibling order is preserved. Each maximal contiguous run of hidden
+ * direct children becomes one inline fold marker.
+ */
+export function createOrderedNavMethods(treeMethods, foldMethods, cursorMethods) {
+    /**
+     * Projects loaded direct children without changing their source order.
+     */
+    function createNavNode(entries, foldRoot, parentPath) {
+        const visibleEntries = [];
+        let foldedEntries;
+        for (const entry of entries) {
+            const entryId = treeMethods.id(entry);
+            const entryPath = [...parentPath, entryId];
+            const navigationEntry = createNavEntry(entry, foldRoot, entryPath);
+            const isFolded = foldMethods.isEntryHiddenAtPath(foldRoot, parentPath, entryId);
+            if (isFolded) {
+                /*
+                 * Append a marker when a hidden run begins. Subsequent hidden
+                 * siblings extend that same marker until a visible sibling ends it.
+                 */
+                if (foldedEntries === undefined) {
+                    foldedEntries = {
+                        folded: [],
+                    };
+                    visibleEntries.push(foldedEntries);
+                }
+                /*
+                 * Retain the complete projection for later fold inspection.
+                 * Ordinary traversal never descends into this hidden projection.
+                 */
+                foldedEntries.folded.push(navigationEntry);
+                continue;
+            }
+            foldedEntries = undefined;
+            visibleEntries.push(navigationEntry);
+        }
+        return {
+            entries: visibleEntries,
+        };
+    }
+    function createNavEntry(entry, foldRoot, entryPath) {
+        return treeMethods.matchByKind(entry, {
+            leaf: ({ id }) => ({
+                id,
+            }),
+            unloadedBranch: ({ id }) => ({
+                id,
+                children: null,
+            }),
+            loadedBranch: ({ id, children }) => ({
+                id,
+                children: createNavNode(children, foldRoot, entryPath),
+            }),
+        });
+    }
+    function createRootNavBranch(root, foldRoot) {
+        return treeMethods.matchByKind(root, {
+            leaf: () => undefined,
+            unloadedBranch: ({ id }) => ({
+                id,
+                children: null,
+            }),
+            loadedBranch: ({ id, children }) => ({
+                id,
+                children: createNavNode(children, foldRoot, []),
+            }),
+        });
+    }
+    return {
+        ...createNavTraversalMethods(cursorMethods, true),
+        from: createRootNavBranch,
+    };
+}

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

@@ -0,0 +1,11 @@
+import type { CursorMethods } from '../cursor.js';
+import type { SerializableKey } from '../tree/index.js';
+import type { NavMethods } from './nav.types.js';
+/**
+ * Shared navigation operations over both projection styles.
+ *
+ * Fold summaries exist in either projection, but only ordered navigation
+ * exposes them as cursor destinations.
+ */
+export declare function createNavTraversalMethods<Id extends SerializableKey, Value>(cursorMethods: CursorMethods<Id>, navigateFolds: boolean): Omit<NavMethods<Id, Value>, 'from'>;
+//# sourceMappingURL=nav.traversal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nav.traversal.d.ts","sourceRoot":"","sources":["../../../src/state-and-nav/nav/nav.traversal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,aAAa,EAAc,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAIV,UAAU,EAEX,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,SAAS,eAAe,EAAE,KAAK,EACzE,aAAa,EAAE,aAAa,CAAC,EAAE,CAAC,EAChC,aAAa,EAAE,OAAO,GACrB,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAsSrC"}