@mak-98/dirvi-cli 0.4.0 → 0.5.0

package/dist/application/effect-to-action.d.ts

@@ -1,8 +1,6 @@
-import { NavigationNode, State, EffectAction } from 'dirvi-lib';
 import type { ReducerAction } from './reducer-action.js';
-export declare function effectToAction(
-  effectAction: EffectAction,
-  navigation: NavigationNode,
-  state: State,
-): ReducerAction | undefined;
-//# sourceMappingURL=effect-to-action.d.ts.map
+import { SerializableKey, TreeNode, TreeNodeApi } from 'dirvi-lib/dist/tree-surfer/tree-node/tree-node.types.js';
+import { CursorApi, EffectAction, NavNode, NavNodeApi, State } from 'dirvi-lib';
+export type EffectToAction<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>> = (effectAction: EffectAction<Id, BufferNode>, navigation: NavNode<Id, BufferNode>, state: State<Id, BufferNode>) => ReducerAction<Id, BufferNode> | undefined;
+export declare function createEffectToAction<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>>(treeNodeApi: TreeNodeApi<Id, BufferNode>, cursorApi: CursorApi<Id>, navNodeApi: NavNodeApi<Id, BufferNode>): EffectToAction<Id, BufferNode>;
+//# sourceMappingURL=effect-to-action.d.ts.map

package/dist/application/effect-to-action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effect-to-action.d.ts","sourceRoot":"","sources":["../../src/application/effect-to-action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,wBAAgB,cAAc,CAC5B,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,cAAc,EAC1B,KAAK,EAAE,KAAK,GACX,aAAa,GAAG,SAAS,CAwG3B"}
+{"version":3,"file":"effect-to-action.d.ts","sourceRoot":"","sources":["../../src/application/effect-to-action.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,yDAAyD,CAAC;AACjH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEhF,MAAM,MAAM,cAAc,CACxB,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,IACzC,CACF,YAAY,EAAE,YAAY,CAAC,EAAE,EAAE,UAAU,CAAC,EAC1C,UAAU,EAAE,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,EACnC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,KACzB,aAAa,CAAC,EAAE,EAAE,UAAU,CAAC,GAAG,SAAS,CAAC;AAE/C,wBAAgB,oBAAoB,CAClC,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,EAE3C,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,UAAU,CAAC,EACxC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,EACxB,UAAU,EAAE,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,GACrC,cAAc,CAAC,EAAE,EAAE,UAAU,CAAC,CAgHhC"}

package/dist/application/effect-to-action.js

@@ -1,88 +1,83 @@
-import { NavigationNode } from 'dirvi-lib';
-export function effectToAction(effectAction, navigation, state) {
-  switch (effectAction.effectActionType) {
-    case 'nextEntry': {
-      const cursor = NavigationNode.nextCursor(navigation, state.cursor);
-      return cursor === undefined
-        ? undefined
-        : {
-            kind: 'changeCursor',
-            cursor,
-          };
+export function createEffectToAction(treeNodeApi, cursorApi, navNodeApi) {
+    function effectToAction(effectAction, navigation, state) {
+        switch (effectAction.effectActionType) {
+            case 'nextEntry': {
+                const cursor = navNodeApi.nextCursor(navigation, state.cursor);
+                return cursor === undefined
+                    ? undefined
+                    : {
+                        kind: 'changeCursor',
+                        cursor,
+                    };
+            }
+            case 'prevEntry': {
+                const cursor = navNodeApi.previousCursor(navigation, state.cursor);
+                return cursor === undefined
+                    ? undefined
+                    : {
+                        kind: 'changeCursor',
+                        cursor,
+                    };
+            }
+            case 'setBranchEntries':
+                return {
+                    kind: 'updateBranch',
+                    path: effectAction.path,
+                    entries: effectAction.entries,
+                };
+            case 'navigateToParent': {
+                const cursor = navNodeApi.parentCursor(navigation, state.cursor);
+                return cursor === undefined
+                    ? undefined
+                    : {
+                        kind: 'changeCursor',
+                        cursor,
+                    };
+            }
+            case 'fold': {
+                if (state.cursor.kind === 'fold') {
+                    return undefined;
+                }
+                const path = [...state.cursor.parentPath, state.cursor.entryId];
+                const entry = treeNodeApi.getAtPath(state.buffer, path, (node) => node);
+                if (entry === undefined) {
+                    return undefined;
+                }
+                const cursor = navNodeApi.cursorAfterFold(navigation, state.cursor);
+                if (cursor === undefined) {
+                    return undefined;
+                }
+                return {
+                    kind: 'fold',
+                    parentPath: [...state.cursor.parentPath],
+                    entry,
+                    cursor,
+                };
+            }
+            case 'unfold': {
+                if (state.cursor.kind !== 'fold') {
+                    return undefined;
+                }
+                const node = navNodeApi.getNodeAtPath(navigation, [...state.cursor.parentPath]);
+                if (node === undefined || node.foldedEntries.length === 0) {
+                    return undefined;
+                }
+                const firstFoldedEntry = node.foldedEntries[0];
+                return {
+                    kind: 'unfold',
+                    parentPath: [...state.cursor.parentPath],
+                    cursor: {
+                        kind: 'entry',
+                        parentPath: state.cursor.parentPath,
+                        entryId: firstFoldedEntry.id,
+                    },
+                };
+            }
+            case 'toggleFold':
+                return effectToAction(state.cursor.kind === 'fold'
+                    ? { effectActionType: 'unfold' }
+                    : { effectActionType: 'fold' }, navigation, state);
+        }
     }
-    case 'prevEntry': {
-      const cursor = NavigationNode.previousCursor(navigation, state.cursor);
-      return cursor === undefined
-        ? undefined
-        : {
-            kind: 'changeCursor',
-            cursor,
-          };
-    }
-    case 'updateDir':
-      return {
-        kind: 'updateDir',
-        path: effectAction.path,
-        entries: effectAction.entries,
-      };
-    case 'outDir': {
-      const cursor = NavigationNode.parentCursor(navigation, state.cursor);
-      return cursor === undefined
-        ? undefined
-        : {
-            kind: 'changeCursor',
-            cursor,
-          };
-    }
-    case 'fold': {
-      if (state.cursor.kind === 'fold') {
-        return undefined;
-      }
-      const path = [...state.cursor.parentPath, state.cursor.entryName];
-      const entry = NavigationNode.getEntryAtPath(navigation, path);
-      if (entry === undefined) {
-        return undefined;
-      }
-      const cursor = NavigationNode.cursorAfterFold(navigation, state.cursor);
-      if (cursor === undefined) {
-        return undefined;
-      }
-      return {
-        kind: 'fold',
-        parentPath: state.cursor.parentPath,
-        entry,
-        cursor,
-      };
-    }
-    case 'unfold': {
-      if (state.cursor.kind !== 'fold') {
-        return undefined;
-      }
-      const node = NavigationNode.getNodeAtPath(
-        navigation,
-        state.cursor.parentPath,
-      );
-      if (node === undefined || node.foldedEntries.length === 0) {
-        return undefined;
-      }
-      const firstFoldedEntry = node.foldedEntries[0];
-      return {
-        kind: 'unfold',
-        parentPath: state.cursor.parentPath,
-        cursor: {
-          kind: 'entry',
-          parentPath: state.cursor.parentPath,
-          entryName: firstFoldedEntry.name,
-        },
-      };
-    }
-    case 'toggleFold':
-      return effectToAction(
-        state.cursor.kind === 'fold'
-          ? { effectActionType: 'unfold' }
-          : { effectActionType: 'fold' },
-        navigation,
-        state,
-      );
-  }
+    return effectToAction;
 }

package/dist/application/reducer-action.d.ts

@@ -1,23 +1,23 @@
-import { Cursor, UnixEntry, UnixEntryPath } from 'dirvi-lib';
-export type ReducerAction =
-  | {
-      kind: 'changeCursor';
-      cursor: Cursor;
-    }
-  | {
-      kind: 'updateDir';
-      path: UnixEntryPath;
-      entries: UnixEntry[] | undefined;
-    }
-  | {
-      kind: 'fold';
-      parentPath: UnixEntryPath;
-      entry: UnixEntry;
-      cursor: Cursor;
-    }
-  | {
-      kind: 'unfold';
-      parentPath: UnixEntryPath;
-      cursor: Cursor;
-    };
-//# sourceMappingURL=reducer-action.d.ts.map
+import type { Cursor, SerializableKey, State, TreeNode } from 'dirvi-lib';
+export type ReducerAction<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>> = {
+    kind: 'changeCursor';
+    cursor: Cursor<Id>;
+} | {
+    kind: 'updateBranch';
+    path: Id[];
+    entries: BufferNode[] | null;
+} | {
+    kind: 'setState';
+    oldState: State<Id, BufferNode>;
+    newState: State<Id, BufferNode>;
+} | {
+    kind: 'fold';
+    parentPath: Id[];
+    entry: BufferNode;
+    cursor: Cursor<Id>;
+} | {
+    kind: 'unfold';
+    parentPath: Id[];
+    cursor: Cursor<Id>;
+};
+//# sourceMappingURL=reducer-action.d.ts.map

package/dist/application/reducer-action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reducer-action.d.ts","sourceRoot":"","sources":["../../src/application/reducer-action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE7D,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;CAClC,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,aAAa,CAAC;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,aAAa,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}
+{"version":3,"file":"reducer-action.d.ts","sourceRoot":"","sources":["../../src/application/reducer-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1E,MAAM,MAAM,aAAa,CACvB,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,IAEzC;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;CACpB,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,EAAE,EAAE,CAAC;IACX,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;CAC9B,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAChC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;CACjC,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,EAAE,EAAE,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;CACpB,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,EAAE,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;CACpB,CAAC"}

package/dist/application/reducer.d.ts

@@ -1,4 +1,5 @@
-import { State } from 'dirvi-lib';
+import { FoldNodeService, SerializableKey, State, TreeNode, TreeNodeApi } from 'dirvi-lib';
 import { ReducerAction } from './reducer-action.js';
-export declare function reducer(state: State, action: ReducerAction): State;
-//# sourceMappingURL=reducer.d.ts.map
+export type Reducer<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>> = (state: State<Id, BufferNode>, action: ReducerAction<Id, BufferNode>) => State<Id, BufferNode>;
+export declare function createReducer<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>>(treeNodeApi: TreeNodeApi<Id, BufferNode>, foldNodeService: FoldNodeService<Id>): Reducer<Id, BufferNode>;
+//# sourceMappingURL=reducer.d.ts.map

package/dist/application/reducer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../../src/application/reducer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,EAAY,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,GAAG,KAAK,CA8ClE"}
+{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../../src/application/reducer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,eAAe,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,MAAM,OAAO,CACjB,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,IACzC,CACF,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,EAC5B,MAAM,EAAE,aAAa,CAAC,EAAE,EAAE,UAAU,CAAC,KAClC,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;AAE3B,wBAAgB,aAAa,CAC3B,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,EAE3C,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,UAAU,CAAC,EACxC,eAAe,EAAE,eAAe,CAAC,EAAE,CAAC,GACnC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,CA0FzB"}

package/dist/application/reducer.js

@@ -1,43 +1,68 @@
-import { UnixEntry, FoldNode } from 'dirvi-lib';
-export function reducer(state, action) {
-  switch (action.kind) {
-    case 'changeCursor':
-      return {
-        ...state,
-        cursor: action.cursor,
-      };
-    case 'updateDir':
-      return {
-        ...state,
-        buffer: UnixEntry.setEntriesAtPath(
-          state.buffer,
-          action.path,
-          action.entries,
-        ),
-      };
-    case 'fold': {
-      const folds = FoldNode.addFoldedEntryAtPath(
-        state.folds,
-        action.parentPath,
-        action.entry,
-      );
-      return {
-        ...state,
-        folds,
-        cursor: action.cursor,
-      };
-    }
-    case 'unfold': {
-      const folds = FoldNode.modifyAtPath(
-        state.folds,
-        action.parentPath,
-        (node) => FoldNode.clearFoldedEntries(node),
-      );
-      return {
-        ...state,
-        folds,
-        cursor: action.cursor,
-      };
-    }
-  }
+export function createReducer(treeNodeApi, foldNodeService) {
+    return (state, action) => {
+        switch (action.kind) {
+            case 'changeCursor':
+                return {
+                    ...state,
+                    cursor: action.cursor,
+                };
+            case 'updateBranch':
+                const buffer = treeNodeApi.modifyAtPath(state.buffer, action.path, (node) => {
+                    // A branch update cannot turn a leaf into a branch.
+                    if (!treeNodeApi.isBranch(node)) {
+                        return undefined;
+                    }
+                    return {
+                        ...node,
+                        children: action.entries,
+                    };
+                });
+                if (buffer === undefined) {
+                    return state;
+                }
+                return {
+                    ...state,
+                    buffer,
+                };
+            case 'setState': {
+                // A newer update has already been applied.
+                if (state !== action.oldState) {
+                    return state;
+                }
+                return {
+                    ...action.newState,
+                };
+            }
+            case 'fold': {
+                const foldNode = foldNodeService.addFoldedEntryAtPath(state.foldNode, action.parentPath, action.entry.id);
+                /*
+                 * addFoldedEntryAtPath creates missing fold paths, so this should
+                 * normally never be undefined. Preserve the existing state if it is.
+                 */
+                if (foldNode === undefined) {
+                    return state;
+                }
+                return {
+                    ...state,
+                    foldNode,
+                    cursor: action.cursor,
+                };
+            }
+            case 'unfold': {
+                const foldNode = foldNodeService.clearFoldedEntriesAtPath(state.foldNode, action.parentPath);
+                /*
+                 * Unlike adding a fold, clearing only operates on an existing path.
+                 * An undefined result means that the fold path no longer exists.
+                 */
+                if (foldNode === undefined) {
+                    return state;
+                }
+                return {
+                    ...state,
+                    foldNode,
+                    cursor: action.cursor,
+                };
+            }
+        }
+    };
 }

package/dist/domain/app-api.d.ts

@@ -0,0 +1,47 @@
+import { CursorApi, FoldNodeApi, FoldNodeService, NavNodeApi, SerializableKey, StateApi, TreeNode, TreeNodeApi } from 'dirvi-lib';
+export type AppApi<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>> = {
+    /**
+     * Name displayed to distinguish apps.
+     */
+    name: string;
+    /**
+     * Message displayed when the entries are empty and there is nothing
+     * to display.
+     */
+    emptyForestMessage: string;
+    /**
+     * Loads the children of the branch at `path`.
+     *
+     * The empty path represents the root branch.
+     */
+    loadBranches: (path: Id[]) => Promise<BufferNode[]>;
+    /**
+     * Subscribes to external data changes that require the tree state
+     * to be loaded again.
+     *
+     * Returns an unsubscribe function.
+     */
+    subscribeToResync: (listener: () => void) => () => void;
+    treeNodeApi: TreeNodeApi<Id, BufferNode>;
+    /**
+     * Structural fold-tree traversal and immutable path updates.
+     */
+    foldNodeApi: FoldNodeApi<Id>;
+    /**
+     * Semantic fold operations, including creating an empty fold root and
+     * adding, removing, or clearing folded entry names.
+     */
+    foldNodeService: FoldNodeService<Id>;
+    cursorApi: CursorApi<Id>;
+    stateApi: StateApi<Id, BufferNode>;
+    navNodeApi: NavNodeApi<Id, BufferNode>;
+};
+export declare function createAppApis<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>>(): {
+    treeNodeApi: TreeNodeApi<Id, BufferNode>;
+    foldNodeApi: FoldNodeApi<Id>;
+    foldNodeService: FoldNodeService<Id>;
+    cursorApi: CursorApi<Id>;
+    stateApi: StateApi<Id, BufferNode>;
+    navNodeApi: NavNodeApi<Id, BufferNode>;
+};
+//# sourceMappingURL=app-api.d.ts.map

package/dist/domain/app-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-api.d.ts","sourceRoot":"","sources":["../../src/domain/app-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,SAAS,EACT,WAAW,EACX,eAAe,EACf,UAAU,EAAE,eAAe,EAC3B,QAAQ,EACR,QAAQ,EACR,WAAW,EACZ,MAAM,WAAW,CAAC;AAEnB,MAAM,MAAM,MAAM,CAChB,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,IACzC;IACF;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEpD;;;;;OAKG;IACH,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAExD,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAEzC;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;IAE7B;;;OAGG;IACH,eAAe,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC;IAErC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IAEzB,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAEnC,UAAU,EAAE,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;CACxC,CAAC;AAEF,wBAAgB,aAAa,CAC3B,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,KACxC;IACH,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACzC,WAAW,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC;IAC7B,eAAe,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC;IACrC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACnC,UAAU,EAAE,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;CACxC,CAkCA"}

package/dist/domain/app-api.js

@@ -0,0 +1,21 @@
+import { createCursorApi, createFoldNodeApi, createFoldNodeService, createNavNodeApi, createStateApi, createTreeNodeApi, } from 'dirvi-lib';
+export function createAppApis() {
+    const treeNodeApi = createTreeNodeApi();
+    const foldNodeApi = createFoldNodeApi();
+    const foldNodeService = createFoldNodeService(foldNodeApi, (id) => ({
+        id,
+        children: [],
+        folds: new Set(),
+    }));
+    const cursorApi = createCursorApi();
+    const navNodeApi = createNavNodeApi(treeNodeApi, foldNodeApi, cursorApi);
+    const stateApi = createStateApi(treeNodeApi, foldNodeApi, cursorApi, navNodeApi);
+    return {
+        treeNodeApi,
+        foldNodeApi,
+        foldNodeService,
+        cursorApi,
+        stateApi,
+        navNodeApi,
+    };
+}

package/dist/domain/event-message.d.ts

@@ -1,15 +1,12 @@
-import { UnixEntryPath, State } from 'dirvi-lib';
-export type EventMessage =
-  | {
-      type: 'view';
-      view: State;
-    }
-  | {
-      type: 'displayed-files-paths';
-      paths: string[];
-    }
-  | {
-      type: 'file';
-      path: UnixEntryPath;
-    };
-//# sourceMappingURL=event-message.d.ts.map
+import { SerializableKey, State, TreeNode } from 'dirvi-lib';
+export type EventMessage<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>> = {
+    type: 'view';
+    view: State<Id, BufferNode>;
+} | {
+    type: 'displayed-leaves-paths';
+    paths: Id[][];
+} | {
+    type: 'file';
+    path: Id[];
+};
+//# sourceMappingURL=event-message.d.ts.map

package/dist/domain/event-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-message.d.ts","sourceRoot":"","sources":["../../src/domain/event-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,MAAM,YAAY,GACpB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;CACb,GACD;IACE,IAAI,EAAE,uBAAuB,CAAC;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;CACrB,CAAC"}
+{"version":3,"file":"event-message.d.ts","sourceRoot":"","sources":["../../src/domain/event-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE7D,MAAM,MAAM,YAAY,CACtB,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,IAEzC;IACE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;CAC7B,GACD;IACE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC;CACf,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,EAAE,EAAE,CAAC;CACZ,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
 export {};
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,76 +1,74 @@
 #!/usr/bin/env node
-import { jsx as _jsx } from 'react/jsx-runtime';
+import { jsx as _jsx } from "react/jsx-runtime";
 import { Command } from 'commander';
 import { render } from 'ink';
 import { AppShell } from './ui/AppShell.js';
-import { loadInitialProps } from './infrastructure/load-initial-props.js';
 const program = new Command();
 // ---*--- TERMINAL ALTERNATE SCREEN ---*---
-// Restore the terminal during normal cleanup and as a
-// last-resort fallback when Node is exiting.
+// Restore the terminal away from alternate screen
+// during normal cleanup and as a last-resort fallback
+// when Node is exiting.
 // Write UI to stderr
 const uiOutput = process.stderr;
-// Write Views to stdout. The newline makes each update a
-// separate JSON Lines message.
+// The newline makes each message a separate JSON Lines message.
 // Note: if you pipe output you'll need to use FORCE_COLOR=3
 // to keep interactive screen colored.
-const emitEventMsg = (message) => {
-  process.stdout.write(`${JSON.stringify(message)}\n`);
+const emitStdoutMsg = (message) => {
+    process.stdout.write(message);
 };
 const enterAlternateScreen = '\u001b[?1049h\u001b[2J\u001b[H\u001b[?25l';
 const leaveAlternateScreen = '\u001b[?25h\u001b[?1049l';
 // Idempotent terminal restoration
 let alternateScreenActive = false;
 const restoreTerminal = () => {
-  if (!alternateScreenActive) {
-    return;
-  }
-  uiOutput.write(leaveAlternateScreen);
-  alternateScreenActive = false;
+    if (!alternateScreenActive) {
+        return;
+    }
+    uiOutput.write(leaveAlternateScreen);
+    alternateScreenActive = false;
 };
 // Node exit last resort
 process.on('exit', restoreTerminal);
 // ---*--- COMPOSITION ---*---
 program
-  .name('direx')
-  .description('View and manage directories.')
-  .version('0.3.2')
-  .helpOption('--help')
-  .action(async () => {
-    const initialProps = await loadInitialProps();
+    .name('direx')
+    .description('View and manage directories.')
+    .version('0.4.0')
+    .helpOption('--help')
+    .option('-d, --directory <path>', 'Directory to browse')
+    .action(async () => {
+    const options = program.opts();
     let appError;
     const useAlternateScreen = uiOutput.isTTY === true;
+    const stdoutIsInteractive = process.stdout.isTTY === true;
     if (useAlternateScreen) {
-      uiOutput.write(enterAlternateScreen);
-      alternateScreenActive = true;
+        uiOutput.write(enterAlternateScreen);
+        alternateScreenActive = true;
     }
     try {
-      const app = render(
-        _jsx(AppShell, {
-          ...initialProps,
-          print: process.stdout.isTTY ? undefined : emitEventMsg,
-          onError: (error) => {
-            appError = error;
-          },
-        }),
-        { stdout: uiOutput },
-      );
-      // Errors thrown while leaving this await still execute the finally block.
-      await app.waitUntilExit();
-    } finally {
-      restoreTerminal(); // Always restore terminal regardless of error
+        const app = render(_jsx(AppShell, { ...(options.directory === undefined
+                ? {}
+                : { directory: options.directory }), ...(stdoutIsInteractive ? {} : { print: emitStdoutMsg }), onError: (error) => {
+                appError = error;
+            } }), { stdout: uiOutput });
+        // Errors thrown while leaving this await still execute the finally block.
+        await app.waitUntilExit();
+    }
+    finally {
+        restoreTerminal(); // Always restore terminal regardless of error
     }
     // Re-throw an error reported by AppShell after the terminal
     // has been restored, so the outer catch can format it.
     if (appError !== undefined) {
-      throw appError;
+        throw appError;
     }
-  });
+});
 // ---*--- RUN AND HANDLE ERROR ---*---
 try {
-  await program.parseAsync(process.argv);
-} catch (error) {
-  const message = error instanceof Error ? error.message : String(error);
-  process.stderr.write(`direx: ${message}\n`);
-  process.exitCode = 1;
+    await program.parseAsync(process.argv);
+}
+catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`direx: ${message}\n`);
+    process.exitCode = 1;
 }

package/dist/infrastructure/get-dir-entries.d.ts

@@ -0,0 +1,3 @@
+import type { UnixAbsolutePath, PosixNode } from 'dirvi-lib';
+export declare function getDirEntries(address: UnixAbsolutePath): Promise<PosixNode[]>;
+//# sourceMappingURL=get-dir-entries.d.ts.map

package/dist/infrastructure/get-dir-entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-dir-entries.d.ts","sourceRoot":"","sources":["../../src/infrastructure/get-dir-entries.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAG7D,wBAAsB,aAAa,CACjC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,SAAS,EAAE,CAAC,CAyCtB"}

package/dist/infrastructure/get-dir-entries.js

@@ -0,0 +1,33 @@
+import { readdir, readlink } from 'node:fs/promises';
+import { join } from 'node:path';
+import { UnixPathSchema, PosixNameSchema } from 'dirvi-lib';
+export async function getDirEntries(address) {
+    const directoryEntries = await readdir(address, {
+        withFileTypes: true,
+    });
+    return Promise.all(directoryEntries.map(async (directoryEntry) => {
+        const id = PosixNameSchema.parse(directoryEntry.name);
+        if (directoryEntry.isSymbolicLink()) {
+            const target = UnixPathSchema.parse(await readlink(join(address, directoryEntry.name)));
+            return {
+                kind: 'symlink',
+                id,
+                target,
+            };
+        }
+        if (directoryEntry.isDirectory()) {
+            return {
+                kind: 'directory',
+                id: id,
+                children: null, // Directory not expanded.
+            };
+        }
+        if (directoryEntry.isFile()) {
+            return {
+                kind: 'file',
+                id: id,
+            };
+        }
+        throw new Error(`Unsupported filesystem entry "${join(address, directoryEntry.name)}"`);
+    }));
+}