@mak-98/dirvi-cli 0.6.0 → 0.7.0

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

@@ -1,7 +1,9 @@
-import { CursorApi, FoldNodeApi, FoldNodeService, NavNodeApi, SerializableKey, StateApi, TreeNode, TreeNodeApi } from 'dirvi-lib';
-export type AppApi<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>> = {
+import { CursorApi, FoldNodeApi, FoldNodeService, NavNodeApi, SerializableKey, State, StateApi, TreeNode, TreeNodeApi } from 'dirvi-lib';
+import { ViewApi } from './view-api.js';
+export type AppApi<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>, ViewKey = string> = {
+    appId: string;
     /**
-     * Name displayed to distinguish apps.
+     * Name displayed to distinguish app instance.
      */
     name: string;
     /**
@@ -35,6 +37,8 @@ export type AppApi<Id extends SerializableKey, BufferNode extends TreeNode<Id, B
     cursorApi: CursorApi<Id>;
     stateApi: StateApi<Id, BufferNode>;
     navNodeApi: NavNodeApi<Id, BufferNode>;
+    viewKey: ViewKey;
+    viewApi: ViewApi<State<Id, BufferNode>, ViewKey>;
 };
 export declare function createAppApis<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>>(): {
     treeNodeApi: TreeNodeApi<Id, BufferNode>;

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

@@ -1 +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,EACV,eAAe,EACf,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"}
+{"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,EACV,eAAe,EACf,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,WAAW,EACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,MAAM,MAAM,CAChB,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,EAC3C,OAAO,GAAG,MAAM,IACd;IAIF,KAAK,EAAE,MAAM,CAAC;IAEd;;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;IAEvC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;CAClD,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/posix-tree-node.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { UnixPath } from './unix-path.js';
+import { Cursor, FoldNode, FoldNodeRoot, NavNode, State } from 'dirvi-lib';
+export declare const PosixNameSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodString>;
+export type PosixName = z.output<typeof PosixNameSchema>;
+export declare const PosixTreeNodeSchema: z.ZodType<PosixTreeNode>;
+export type PosixTreeNode = {
+    kind: 'file';
+    id: PosixName;
+} | {
+    kind: 'symlink';
+    id: PosixName;
+    target: UnixPath;
+} | {
+    kind: 'directory';
+    id: PosixName;
+    children: PosixTreeNode[] | null;
+};
+export declare const PosixTreeNodeApi: import("dirvi-lib").TreeNodeApi<string, PosixTreeNode>;
+export declare const PosixFoldNodeSchema: z.ZodType<PosixFoldNode>;
+export declare const PosixFoldNodeRootSchema: z.ZodType<PosixFoldNodeRoot>;
+export type PosixFoldNode = FoldNode<PosixName>;
+export type PosixFoldNodeRoot = FoldNodeRoot<PosixName>;
+export declare const PosixFoldNodeApi: import("dirvi-lib").FoldNodeApi<string>;
+export declare const PosixCursorSchema: z.ZodType<PosixCursor>;
+export type PosixCursor = Cursor<PosixName>;
+export declare const PosixCursorApi: import("dirvi-lib").CursorApi<string>;
+export type PosixNavNode = NavNode<PosixName, PosixTreeNode>;
+export declare const PosixNavApi: import("dirvi-lib").NavNodeApi<string, PosixTreeNode>;
+export declare const PosixStateSchema: z.ZodType<PosixState>;
+export type PosixState = State<PosixName, PosixTreeNode>;
+export declare const PosixStateApi: import("dirvi-lib").StateApi<string, PosixTreeNode>;
+//# sourceMappingURL=posix-tree-node.d.ts.map

package/dist/domain/posix-tree-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posix-tree-node.d.ts","sourceRoot":"","sources":["../../src/domain/posix-tree-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAkB,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAUL,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,OAAO,EAEP,KAAK,EAEN,MAAM,WAAW,CAAC;AAQnB,eAAO,MAAM,eAAe,yEAU3B,CAAC;AAGF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AAUzD,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAsBvD,CAAC;AAGH,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,SAAS,CAAC;CACf,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,QAAQ,CAAC;CAClB,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,SAAS,CAAC;IACd,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;CAClC,CAAC;AAQN,eAAO,MAAM,gBAAgB,wDAAgD,CAAC;AAQ9E,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAkB,CAAC;AAC5E,eAAO,MAAM,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAC7C,CAAC;AAGrB,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;AAChD,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;AAGxD,eAAO,MAAM,gBAAgB,yCAAiC,CAAC;AAK/D,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAChB,CAAC;AAGtC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AAE5C,eAAO,MAAM,cAAc,uCAA+B,CAAC;AAG3D,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAE7D,eAAO,MAAM,WAAW,uDAIvB,CAAC;AAKF,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAIlD,CAAC;AAGF,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAGzD,eAAO,MAAM,aAAa,qDAKzB,CAAC"}

package/dist/domain/posix-tree-node.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { UnixPathSchema } from './unix-path.js';
+import { createCursorApi, createCursorSchema, createFoldNodeApi, createFoldNodeSchemas, createNavNodeApi, createStateApi, createStateSchema, createTreeNodeApi, createTreeNodeSchemas, serializableKeySchema, } from 'dirvi-lib';
+// --- PosixName extends PropertyKey ---
+// Schema
+export const PosixNameSchema = serializableKeySchema.pipe(z
+    .string()
+    .min(1, 'Entry name cannot be empty.')
+    .refine((value) => !value.includes('/'), {
+    message: "Entry name must not contain '/'.",
+})
+    .refine((value) => value !== '.' && value !== '..', {
+    message: "Entry name cannot be '.' or '..'.",
+}));
+// --- PosixTreeNode extends TreeNode ---
+// Schema
+export const PosixTreeNodeSchema = z.lazy(() => {
+    const { leafSchema, closedBranchSchema, openBranchSchema } = createTreeNodeSchemas(PosixNameSchema, PosixTreeNodeSchema);
+    return z.union([
+        leafSchema.extend({
+            kind: z.literal('file'),
+        }),
+        leafSchema.extend({
+            kind: z.literal('symlink'),
+            target: UnixPathSchema,
+        }),
+        closedBranchSchema.extend({
+            kind: z.literal('directory'),
+        }),
+        openBranchSchema.extend({
+            kind: z.literal('directory'),
+        }),
+    ]);
+});
+// API
+export const PosixTreeNodeApi = createTreeNodeApi();
+// --- PosixFoldNode ---
+// Schema
+const { foldNodeSchema, foldNodeRootSchema } = createFoldNodeSchemas(PosixNameSchema);
+export const PosixFoldNodeSchema = foldNodeSchema;
+export const PosixFoldNodeRootSchema = foldNodeRootSchema;
+// API
+export const PosixFoldNodeApi = createFoldNodeApi();
+// --- PosixCursor ---
+// Schema
+export const PosixCursorSchema = createCursorSchema(PosixNameSchema);
+export const PosixCursorApi = createCursorApi();
+export const PosixNavApi = createNavNodeApi(PosixTreeNodeApi, PosixFoldNodeApi, PosixCursorApi);
+// --- PosixState ---
+// Schema
+export const PosixStateSchema = createStateSchema(PosixTreeNodeSchema, PosixFoldNodeRootSchema, PosixCursorSchema);
+// API
+export const PosixStateApi = createStateApi(PosixTreeNodeApi, PosixFoldNodeApi, PosixCursorApi, PosixNavApi);

package/dist/domain/unix-path.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+export declare const UnixPathSchema: z.ZodString;
+export type UnixPath = z.output<typeof UnixPathSchema>;
+export declare const UnixAbsolutePathSchema: z.ZodString;
+export type UnixAbsolutePath = z.output<typeof UnixAbsolutePathSchema>;
+//# sourceMappingURL=unix-path.d.ts.map

package/dist/domain/unix-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix-path.d.ts","sourceRoot":"","sources":["../../src/domain/unix-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,cAAc,aAKvB,CAAC;AAEL,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAEvD,eAAO,MAAM,sBAAsB,aAKlC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/domain/unix-path.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+// UNIX PATHS
+export const UnixPathSchema = z
+    .string()
+    .min(1)
+    .refine((value) => !value.includes('\0'), {
+    message: 'Unix paths must not contain null bytes',
+});
+export const UnixAbsolutePathSchema = UnixPathSchema.refine((value) => value.startsWith('/'), {
+    message: 'Path must be an absolute Unix path',
+});

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

@@ -0,0 +1,11 @@
+export type ViewSummary = {
+    name: string;
+    updatedAt: string;
+};
+export type ViewApi<State, Key> = {
+    save: (key: Key, name: string, state: State) => Promise<void>;
+    load: (key: Key, name: string) => Promise<State | undefined>;
+    list: (key: Key) => Promise<readonly ViewSummary[]>;
+    remove: (key: Key, name: string) => Promise<void>;
+};
+//# sourceMappingURL=view-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"view-api.d.ts","sourceRoot":"","sources":["../../src/domain/view-api.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,OAAO,CAAC,KAAK,EAAE,GAAG,IAAI;IAChC,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAC7D,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IACpD,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD,CAAC"}

package/dist/index.js

@@ -28,7 +28,7 @@ process.on('exit', restoreTerminal);
 program
     .name('direx')
     .description('View and manage directories.')
-    .version('0.5.1')
+    .version('0.7.0')
     .helpOption('--help')
     .option('-d, --directory <path>', 'Directory to browse')
     .action(async () => {
@@ -59,9 +59,7 @@ program
     try {
         const app = render(_jsx(AppShell, { ...(options.directory === undefined
                 ? {}
-                : { directory: options.directory }), ...(stdoutIsInteractive
-                ? {}
-                : { stdout }), clipboard: clipboard, onError: (error) => {
+                : { directory: options.directory }), ...(stdoutIsInteractive ? {} : { stdout }), clipboard: clipboard, onError: (error) => {
                 appError = error;
             } }), { stdout: uiOutput });
         // Errors thrown while leaving this await still execute the finally block.

package/dist/infrastructure/create-file-view-api.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import type { ViewApi } from '../domain/view-api.js';
+import { SerializableKey, State, TreeNode } from 'dirvi-lib';
+export type StateCodec<RuntimeState, StoredState> = {
+    schema: z.ZodType<StoredState>;
+    encode: (state: RuntimeState) => StoredState;
+    decode: (state: StoredState) => RuntimeState;
+};
+/**
+ * Creates a file-backed implementation of ViewApi.
+ *
+ * Each key receives its own directory, and each named view is stored as one
+ * JSON file inside that directory:
+ *
+ *   <directory>/<encoded-key>/<view-name>.json
+ *
+ * The view name is validated before being used as a filename. The key is
+ * converted into one safe path segment by the caller-provided `encodeKey`
+ * function.
+ *
+ * For example:
+ *
+ *   .../posix/views/<directory-hash>/project.json
+ */
+export declare function createFileViewApi<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>, StoredState, Key>({ directory, encodeKey, stateCodec, }: {
+    directory: string;
+    encodeKey: (key: Key) => string;
+    stateCodec: StateCodec<State<Id, BufferNode>, StoredState>;
+}): ViewApi<State<Id, BufferNode>, Key>;
+//# sourceMappingURL=create-file-view-api.d.ts.map

package/dist/infrastructure/create-file-view-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-file-view-api.d.ts","sourceRoot":"","sources":["../../src/infrastructure/create-file-view-api.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,uBAAuB,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE7D,MAAM,MAAM,UAAU,CAAC,YAAY,EAAE,WAAW,IAAI;IAClD,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,WAAW,CAAC;IAC7C,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,YAAY,CAAC;CAC9C,CAAC;AA2BF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,EAC3C,WAAW,EACX,GAAG,EACH,EACA,SAAS,EACT,SAAS,EACT,UAAU,GACX,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,WAAW,CAAC,CAAC;CAC5D,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,GAAG,CAAC,CA0JtC"}

package/dist/infrastructure/create-file-view-api.js

@@ -0,0 +1,154 @@
+import { mkdir, readFile, readdir, rename, unlink, writeFile, } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { viewNameSchema } from './view-name-schema.js';
+function createStoredViewSchema(stateSchema) {
+    return z.object({
+        version: z.literal(1),
+        name: viewNameSchema,
+        updatedAt: z.iso.datetime(),
+        state: stateSchema,
+    });
+}
+function isNodeErrorWithCode(error, code) {
+    return error instanceof Error && 'code' in error && error.code === code;
+}
+/**
+ * Creates a file-backed implementation of ViewApi.
+ *
+ * Each key receives its own directory, and each named view is stored as one
+ * JSON file inside that directory:
+ *
+ *   <directory>/<encoded-key>/<view-name>.json
+ *
+ * The view name is validated before being used as a filename. The key is
+ * converted into one safe path segment by the caller-provided `encodeKey`
+ * function.
+ *
+ * For example:
+ *
+ *   .../posix/views/<directory-hash>/project.json
+ */
+export function createFileViewApi({ directory, encodeKey, stateCodec, }) {
+    const storedViewSchema = createStoredViewSchema(stateCodec.schema);
+    /**
+     * Returns the directory containing all views for one app-specific key.
+     *
+     * `encodeKey` must return one safe path segment. In particular, it must not
+     * return "/", "\\", ".", "..", or a value containing path separators.
+     */
+    function keyDirectory(key) {
+        const encodedKey = encodeKey(key);
+        if (encodedKey.length === 0 ||
+            encodedKey === '.' ||
+            encodedKey === '..' ||
+            encodedKey.includes('/') ||
+            encodedKey.includes('\\')) {
+            throw new Error('encodeKey must return one safe path segment.');
+        }
+        return join(directory, encodedKey);
+    }
+    /**
+     * Returns the file containing one named view for a key.
+     *
+     * View names are validated by `viewNameSchema` before they are used as
+     * filenames. No encoding is necessary because invalid path characters have
+     * already been rejected.
+     */
+    function viewFile(key, name) {
+        const validName = viewNameSchema.parse(name);
+        return join(keyDirectory(key), `${validName}.json`);
+    }
+    async function save(key, name, state) {
+        const dir = keyDirectory(key);
+        await mkdir(dir, {
+            recursive: true,
+            mode: 0o700,
+        });
+        const file = viewFile(key, name);
+        const storedState = stateCodec.encode(state);
+        const value = storedViewSchema.parse({
+            version: 1,
+            name,
+            updatedAt: new Date().toISOString(),
+            state: storedState,
+        });
+        const temporary = `${file}.${process.pid}.${randomUUID()}.tmp`;
+        await writeFile(temporary, `${JSON.stringify(value, null, 2)}\n`, {
+            encoding: 'utf8',
+            mode: 0o600,
+        });
+        await rename(temporary, file);
+    }
+    async function load(key, name) {
+        try {
+            const contents = await readFile(viewFile(key, name), 'utf8');
+            const parsed = JSON.parse(contents);
+            const value = storedViewSchema.parse(parsed);
+            return stateCodec.decode(value.state);
+        }
+        catch (error) {
+            if (isNodeErrorWithCode(error, 'ENOENT')) {
+                return undefined;
+            }
+            throw error;
+        }
+    }
+    async function list(key) {
+        const dir = keyDirectory(key);
+        let files;
+        try {
+            files = await readdir(dir);
+        }
+        catch (error) {
+            // A key with no saved views does not have a directory yet.
+            if (isNodeErrorWithCode(error, 'ENOENT')) {
+                return [];
+            }
+            throw error;
+        }
+        const summaries = [];
+        for (const file of files) {
+            /*
+             * Ignore temporary files, unrelated files, and any future files that
+             * might be stored alongside view files.
+             */
+            if (!file.endsWith('.json')) {
+                continue;
+            }
+            /*
+             * The name and timestamp are stored in the JSON envelope. Listing
+             * therefore requires reading each view file. If this becomes expensive
+             * later, metadata could be kept in a separate index.
+             */
+            const contents = await readFile(join(dir, file), 'utf8');
+            const parsed = JSON.parse(contents);
+            const value = storedViewSchema.parse(parsed);
+            summaries.push({
+                name: value.name,
+                updatedAt: value.updatedAt,
+            });
+        }
+        return summaries;
+    }
+    async function remove(key, name) {
+        try {
+            // viewFile() validates the name before constructing the path.
+            await unlink(viewFile(key, name));
+        }
+        catch (error) {
+            // Removing a view that does not exist is intentionally idempotent.
+            if (isNodeErrorWithCode(error, 'ENOENT')) {
+                return;
+            }
+            throw error;
+        }
+    }
+    return {
+        save,
+        load,
+        list,
+        remove,
+    };
+}

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

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

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

@@ -1 +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"}
+{"version":3,"file":"get-dir-entries.d.ts","sourceRoot":"","sources":["../../src/infrastructure/get-dir-entries.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAkB,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAmB,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE9E,wBAAsB,aAAa,CACjC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,aAAa,EAAE,CAAC,CAyC1B"}

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

@@ -1,6 +1,7 @@
 import { readdir, readlink } from 'node:fs/promises';
 import { join } from 'node:path';
-import { UnixPathSchema, PosixNameSchema } from 'dirvi-lib';
+import { UnixPathSchema } from '../domain/unix-path.js';
+import { PosixNameSchema } from '../domain/posix-tree-node.js';
 export async function getDirEntries(address) {
     const directoryEntries = await readdir(address, {
         withFileTypes: true,

package/dist/infrastructure/get-unix-abs-path.d.ts

@@ -1,3 +1,3 @@
-import type { UnixAbsolutePath } from 'dirvi-lib';
+import { UnixAbsolutePath } from '../domain/unix-path.js';
 export declare function getUnixAbsPath(directory: string): UnixAbsolutePath;
 //# sourceMappingURL=get-unix-abs-path.d.ts.map

package/dist/infrastructure/get-unix-abs-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-unix-abs-path.d.ts","sourceRoot":"","sources":["../../src/infrastructure/get-unix-abs-path.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGlD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAgBlE"}
+{"version":3,"file":"get-unix-abs-path.d.ts","sourceRoot":"","sources":["../../src/infrastructure/get-unix-abs-path.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAEjB,MAAM,wBAAwB,CAAC;AAEhC,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAgBlE"}

package/dist/infrastructure/get-unix-abs-path.js

@@ -1,5 +1,5 @@
 import { resolve } from 'node:path';
-import { UnixAbsolutePathSchema } from 'dirvi-lib';
+import { UnixAbsolutePathSchema, } from '../domain/unix-path.js';
 export function getUnixAbsPath(directory) {
     const absolutePath = resolve(directory);
     const result = UnixAbsolutePathSchema.safeParse(absolutePath);

package/dist/infrastructure/load-posix-app-api.d.ts

@@ -1,4 +1,17 @@
-import { PosixName, PosixNode } from 'dirvi-lib';
 import { AppApi } from '../domain/app-api.js';
-export declare function loadPosixAppApi(directory?: string): AppApi<PosixName, PosixNode>;
+import { PosixName, PosixState, PosixTreeNode } from '../domain/posix-tree-node.js';
+import { UnixAbsolutePath } from '../domain/unix-path.js';
+export type StoredPosixFoldNode = {
+    id: PosixName;
+    children: StoredPosixFoldNode[];
+    folds: PosixName[];
+};
+export type StoredPosixFoldNodeRoot = {
+    children: StoredPosixFoldNode[];
+    folds: PosixName[];
+};
+export type StoredPosixState = Omit<PosixState, 'foldNode'> & {
+    foldNode: StoredPosixFoldNodeRoot;
+};
+export declare function loadPosixAppApi(directory?: string): AppApi<PosixName, PosixTreeNode, UnixAbsolutePath>;
 //# sourceMappingURL=load-posix-app-api.d.ts.map

package/dist/infrastructure/load-posix-app-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-posix-app-api.d.ts","sourceRoot":"","sources":["../../src/infrastructure/load-posix-app-api.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,MAAM,EAAiB,MAAM,sBAAsB,CAAC;AAI7D,wBAAgB,eAAe,CAC7B,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAkB9B"}
+{"version":3,"file":"load-posix-app-api.d.ts","sourceRoot":"","sources":["../../src/infrastructure/load-posix-app-api.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAiB,MAAM,sBAAsB,CAAC;AAM7D,OAAO,EAIL,SAAS,EAET,UAAU,EACV,aAAa,EAEd,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAkB1D,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,SAAS,CAAC;IACd,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB,CAAC;AAsBF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG;IAC5D,QAAQ,EAAE,uBAAuB,CAAC;CACnC,CAAC;AA2DF,wBAAgB,eAAe,CAC7B,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,gBAAgB,CAAC,CAyBpD"}

package/dist/infrastructure/load-posix-app-api.js

@@ -3,18 +3,98 @@ import { watch } from 'node:fs';
 import { createAppApis } from '../domain/app-api.js';
 import { getUnixAbsPath } from './get-unix-abs-path.js';
 import { getDirEntries } from './get-dir-entries.js';
+import envPaths from 'env-paths';
+import { createFileViewApi } from './create-file-view-api.js';
+import { createHash } from 'node:crypto';
+import { PosixCursorSchema, PosixNameSchema, PosixTreeNodeSchema, } from '../domain/posix-tree-node.js';
+import { z } from 'zod';
+// ---*--- App Data ---*---
+// Paths for app data:
+const paths = envPaths('dirvi');
+const posixAppDataDirectory = join(paths.data, 'apps', 'posix');
+const posixAppViewsDirectory = join(posixAppDataDirectory, 'views');
+// Helpers for saving app data:
+// The key for the Posix app instance is just the directory working in.
+function encodeKey(key) {
+    return createHash('sha256').update(key).digest('hex');
+}
+const StoredPosixFoldNodeSchema = z.lazy(() => z.object({
+    id: PosixNameSchema,
+    children: z.array(StoredPosixFoldNodeSchema),
+    folds: z.array(PosixNameSchema),
+}));
+const StoredPosixFoldNodeRootSchema = z.object({
+    children: z.array(StoredPosixFoldNodeSchema),
+    folds: z.array(PosixNameSchema),
+});
+const StoredPosixStateSchema = z.object({
+    buffer: z.array(PosixTreeNodeSchema),
+    foldNode: StoredPosixFoldNodeRootSchema,
+    cursor: PosixCursorSchema,
+});
+// ---*--- Codec ---*---
+function encodePosixFoldNode(node) {
+    return {
+        id: node.id,
+        children: node.children.map(encodePosixFoldNode),
+        folds: [...node.folds],
+    };
+}
+function decodePosixFoldNode(node) {
+    return {
+        id: node.id,
+        children: node.children.map(decodePosixFoldNode),
+        folds: new Set(node.folds),
+    };
+}
+function encodePosixFoldNodeRoot(root) {
+    return {
+        children: root.children.map(encodePosixFoldNode),
+        folds: [...root.folds],
+    };
+}
+function decodePosixFoldNodeRoot(root) {
+    return {
+        children: root.children.map(decodePosixFoldNode),
+        folds: new Set(root.folds),
+    };
+}
+const posixStateCodec = {
+    schema: StoredPosixStateSchema,
+    encode(state) {
+        return {
+            buffer: state.buffer,
+            foldNode: encodePosixFoldNodeRoot(state.foldNode),
+            cursor: state.cursor,
+        };
+    },
+    decode(state) {
+        return {
+            buffer: state.buffer,
+            foldNode: decodePosixFoldNodeRoot(state.foldNode),
+            cursor: state.cursor,
+        };
+    },
+};
+// --- Creating Posix App API ---
 export function loadPosixAppApi(directory) {
     const unixAbsPath = getUnixAbsPath(directory ?? process.cwd());
     const apis = createAppApis();
-    const subscribeToResync = createFsResyncSubscription(join(unixAbsPath));
     return {
+        appId: 'posix',
         name: `Posix(${unixAbsPath})`,
         emptyForestMessage: 'The directory is empty.',
         loadBranches: (path) => {
             const address = join(unixAbsPath, ...path);
             return getDirEntries(address);
         },
-        subscribeToResync,
+        subscribeToResync: createFsResyncSubscription(join(unixAbsPath)),
+        viewKey: unixAbsPath,
+        viewApi: createFileViewApi({
+            directory: posixAppViewsDirectory,
+            encodeKey,
+            stateCodec: posixStateCodec,
+        }),
         ...apis,
     };
 }

package/dist/infrastructure/view-name-schema.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+/**
+ * View names are also used as filenames.
+ *
+ * We intentionally keep the accepted format human-readable instead of
+ * encoding names into opaque filenames. The restrictions are mostly for
+ * portability between POSIX and Windows filesystems:
+ *
+ * - no path separators or control characters;
+ * - no Windows-invalid filename characters;
+ * - no leading/trailing whitespace;
+ * - no trailing periods or spaces;
+ * - no "." or "..";
+ * - no Windows device names such as "CON" or "NUL";
+ * - limited length.
+ */
+export declare const viewNameSchema: z.ZodString;
+//# sourceMappingURL=view-name-schema.d.ts.map

package/dist/infrastructure/view-name-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-name-schema.d.ts","sourceRoot":"","sources":["../../src/infrastructure/view-name-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2BxB;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,aA8BxB,CAAC"}

package/dist/infrastructure/view-name-schema.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+const windowsReservedNames = new Set([
+    'CON',
+    'PRN',
+    'AUX',
+    'NUL',
+    'COM1',
+    'COM2',
+    'COM3',
+    'COM4',
+    'COM5',
+    'COM6',
+    'COM7',
+    'COM8',
+    'COM9',
+    'LPT1',
+    'LPT2',
+    'LPT3',
+    'LPT4',
+    'LPT5',
+    'LPT6',
+    'LPT7',
+    'LPT8',
+    'LPT9',
+]);
+/**
+ * View names are also used as filenames.
+ *
+ * We intentionally keep the accepted format human-readable instead of
+ * encoding names into opaque filenames. The restrictions are mostly for
+ * portability between POSIX and Windows filesystems:
+ *
+ * - no path separators or control characters;
+ * - no Windows-invalid filename characters;
+ * - no leading/trailing whitespace;
+ * - no trailing periods or spaces;
+ * - no "." or "..";
+ * - no Windows device names such as "CON" or "NUL";
+ * - limited length.
+ */
+export const viewNameSchema = z
+    .string()
+    .min(1, 'View name cannot be empty.')
+    .max(100, 'View name cannot be longer than 100 characters.')
+    .refine((name) => name === name.trim(), {
+    message: 'View name cannot start or end with whitespace.',
+})
+    .refine((name) => name !== '.' && name !== '..', {
+    message: 'View name cannot be "." or "..".',
+})
+    .refine((name) => !/[\/\\]/u.test(name), {
+    message: 'View name cannot contain path separators.',
+})
+    .refine((name) => !/[\u0000-\u001f\u007f]/u.test(name), {
+    message: 'View name cannot contain control characters.',
+})
+    .refine((name) => !/[<>:"|?*]/u.test(name), {
+    message: 'View name contains a character that is not portable.',
+})
+    .refine((name) => !/[. ]$/u.test(name), {
+    message: 'View name cannot end with a period or space.',
+})
+    .refine((name) => {
+    const basename = name.split('.')[0].toUpperCase();
+    return !windowsReservedNames.has(basename);
+}, {
+    message: 'View name is reserved by Windows.',
+});

package/dist/ui/App.d.ts

@@ -2,8 +2,8 @@ import { IntentToEffect, SerializableKey, State, TreeNode } from 'dirvi-lib';
 import { EffectToAction } from '../application/effect-to-action.js';
 import { AppApi } from '../domain/app-api.js';
 import { Reducer } from '../application/reducer.js';
-type AppProps<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>> = {
-    appApi: AppApi<Id, BufferNode>;
+type AppProps<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>, ViewKey = string> = {
+    appApi: AppApi<Id, BufferNode, ViewKey>;
     initialState: State<Id, BufferNode>;
     reducer: Reducer<Id, BufferNode>;
     intentToEffect: IntentToEffect<Id, BufferNode>;
@@ -12,6 +12,6 @@ type AppProps<Id extends SerializableKey, BufferNode extends TreeNode<Id, Buffer
     clipboard?: (value: string) => void;
     onError?: (error: Error) => void;
 };
-export declare function App<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>>({ appApi, initialState, reducer, intentToEffect, effectToAction, stdout, clipboard, onError, }: AppProps<Id, BufferNode>): import("react").JSX.Element | null;
+export declare function App<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>, ViewKey = string>({ appApi, initialState, reducer, intentToEffect, effectToAction, stdout, clipboard, onError, }: AppProps<Id, BufferNode, ViewKey>): import("react").JSX.Element | null;
 export {};
 //# sourceMappingURL=App.d.ts.map

package/dist/ui/App.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/ui/App.tsx"],"names":[],"mappings":"AAGA,OAAO,EAGL,cAAc,EACd,eAAe,EACf,KAAK,EACL,QAAQ,EAET,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGpE,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAGpD,KAAK,QAAQ,CACX,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,IACzC;IACF,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/B,YAAY,EAAE,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/C,cAAc,EAAE,cAAc,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF,wBAAgB,GAAG,CACjB,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,EAC3C,EACA,MAAM,EACN,YAAY,EACZ,OAAO,EACP,cAAc,EACd,cAAc,EACd,MAAM,EACe,SAAS,EAC9B,OAAO,GACR,EAAE,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,sCA0K1B"}
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/ui/App.tsx"],"names":[],"mappings":"AAGA,OAAO,EAGL,cAAc,EACd,eAAe,EACf,KAAK,EACL,QAAQ,EAET,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGpE,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAOpD,KAAK,QAAQ,CACX,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,EAC3C,OAAO,GAAG,MAAM,IACd;IACF,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACxC,YAAY,EAAE,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/C,cAAc,EAAE,cAAc,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF,wBAAgB,GAAG,CACjB,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,EAC3C,OAAO,GAAG,MAAM,EAChB,EACA,MAAM,EACN,YAAY,EACZ,OAAO,EACP,cAAc,EACd,cAAc,EACd,MAAM,EACN,SAAS,EACT,OAAO,GACR,EAAE,QAAQ,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,sCA6NnC"}

package/dist/ui/App.js

@@ -6,6 +6,9 @@ import { ViewRowComponent } from './components/ViewRowComponent.js';
 import { StatusBar } from './components/StatusBar.js';
 import { inkInputToUserInput } from '../infrastructure/ink-input-to-user-input.js';
 import { useView } from './hooks/useView.js';
+function toError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
 export function App({ appApi, initialState, reducer, intentToEffect, effectToAction, stdout, clipboard, onError, }) {
     const [state, dispatch] = useReducer(reducer, initialState);
     // Give `subscribeToResync` callback a way to see current state:
@@ -94,6 +97,49 @@ export function App({ appApi, initialState, reducer, intentToEffect, effectToAct
                     normalBuffer: '',
                 });
                 return;
+            case 'saveView': {
+                void appApi.viewApi
+                    .save(appApi.viewKey, effect.name, stateRef.current)
+                    .then(() => {
+                    setInputState({
+                        inputMode: 'normal',
+                        normalBuffer: '',
+                    });
+                })
+                    .catch((error) => {
+                    onError?.(toError(error));
+                    setExitStatus(`Unable to save view: ${toError(error).message}`);
+                });
+                return;
+            }
+            case 'loadView': {
+                void appApi.viewApi
+                    .load(appApi.viewKey, effect.name)
+                    .then((loadedState) => {
+                    if (loadedState === undefined) {
+                        throw new Error(`View not found: ${effect.name}`);
+                    }
+                    // The saved buffer may be stale because the filesystem could have
+                    // changed since the view was saved.
+                    return appApi.stateApi.resync(loadedState, appApi.loadBranches);
+                })
+                    .then((newState) => {
+                    const oldState = stateRef.current;
+                    dispatch({
+                        kind: 'setState',
+                        oldState,
+                        newState,
+                    });
+                    setInputState({
+                        inputMode: 'normal',
+                        normalBuffer: '',
+                    });
+                })
+                    .catch((error) => {
+                    onError?.(toError(error));
+                });
+                return;
+            }
             case 'quit':
                 setExitStatus(effect.exitMessage);
                 return;

package/dist/ui/AppShell.d.ts

@@ -4,5 +4,5 @@ export type ShellAppProps = {
     clipboard?: (value: string) => void;
     onError?: (error: Error) => void;
 };
-export declare function AppShell({ directory, stdout, clipboard, onError }: ShellAppProps): import("react").JSX.Element;
+export declare function AppShell({ directory, stdout, clipboard, onError, }: ShellAppProps): import("react").JSX.Element;
 //# sourceMappingURL=AppShell.d.ts.map

package/dist/ui/AppShell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../src/ui/AppShell.tsx"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC,CAAC;AAIF,wBAAgB,QAAQ,CAAC,EACtB,SAAS,EACT,MAAM,EACN,SAAS,EACT,OAAO,EACT,EAAE,aAAa,+BAYf"}
+{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../src/ui/AppShell.tsx"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC,CAAC;AAIF,wBAAgB,QAAQ,CAAC,EACvB,SAAS,EACT,MAAM,EACN,SAAS,EACT,OAAO,GACR,EAAE,aAAa,+BAYf"}

package/dist/ui/AppShell.js

@@ -4,7 +4,7 @@ import { LoadingApp } from './LoadingApp.js';
 import { useMemo } from 'react';
 // App Shell is for choosing the active app, then loading the api,
 // and showing the app.
-export function AppShell({ directory, stdout, clipboard, onError }) {
+export function AppShell({ directory, stdout, clipboard, onError, }) {
     // Api owns directory watcher and subscriptions
     const posixAppApi = useMemo(() => loadPosixAppApi(directory), [directory]);
     return (_jsx(LoadingApp, { appApi: posixAppApi, ...(stdout === undefined ? {} : { stdout }), ...(clipboard === undefined ? {} : { clipboard }), ...(onError === undefined ? {} : { onError }) }));

package/dist/ui/LoadingApp.d.ts

@@ -1,11 +1,11 @@
 import { SerializableKey, TreeNode } from 'dirvi-lib';
 import { AppApi } from '../domain/app-api.js';
-type LoadingAppProps<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>> = {
-    appApi: AppApi<Id, BufferNode>;
+type LoadingAppProps<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>, ViewKey = string> = {
+    appApi: AppApi<Id, BufferNode, ViewKey>;
     stdout?: (message: string) => void;
     clipboard?: (value: string) => void;
     onError?: (error: Error) => void;
 };
-export declare function LoadingApp<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>>({ appApi, stdout, clipboard, onError }: LoadingAppProps<Id, BufferNode>): import("react").JSX.Element;
+export declare function LoadingApp<Id extends SerializableKey, BufferNode extends TreeNode<Id, BufferNode>, ViewKey = string>({ appApi, stdout, clipboard, onError, }: LoadingAppProps<Id, BufferNode, ViewKey>): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=LoadingApp.d.ts.map

package/dist/ui/LoadingApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LoadingApp.d.ts","sourceRoot":"","sources":["../../src/ui/LoadingApp.tsx"],"names":[],"mappings":"AAGA,OAAO,EAEL,eAAe,EAEf,QAAQ,EACT,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAI9C,KAAK,eAAe,CAClB,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,IACzC;IACF,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC,CAAC;AA0BF,wBAAgB,UAAU,CACxB,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,EAC3C,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,eAAe,CAAC,EAAE,EAAE,UAAU,CAAC,+BAgGxE"}
+{"version":3,"file":"LoadingApp.d.ts","sourceRoot":"","sources":["../../src/ui/LoadingApp.tsx"],"names":[],"mappings":"AAGA,OAAO,EAEL,eAAe,EAEf,QAAQ,EACT,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAI9C,KAAK,eAAe,CAClB,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,EAC3C,OAAO,GAAG,MAAM,IACd;IACF,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC,CAAC;AA0BF,wBAAgB,UAAU,CACxB,EAAE,SAAS,eAAe,EAC1B,UAAU,SAAS,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC,EAC3C,OAAO,GAAG,MAAM,EAChB,EACA,MAAM,EACN,MAAM,EACN,SAAS,EACT,OAAO,GACR,EAAE,eAAe,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,+BAgG1C"}

package/dist/ui/LoadingApp.js

@@ -19,7 +19,7 @@ function createInitialState(rootBranches, createEmptyFoldRoot) {
         },
     };
 }
-export function LoadingApp({ appApi, stdout, clipboard, onError }) {
+export function LoadingApp({ appApi, stdout, clipboard, onError, }) {
     const [initialState, setInitialState] = useState();
     const [empty, setEmpty] = useState(false);
     const [error, setError] = useState();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mak-98/dirvi-cli",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "A Vim-inspired TUI for browsing directories.",
   "type": "module",
   "license": "GPL-3.0-or-later",
@@ -13,9 +13,11 @@
   ],
   "dependencies": {
     "commander": "^13.0.0",
-    "dirvi-lib": "0.6.0",
+    "dirvi-lib": "0.7.0",
+    "env-paths": "^4.0.0",
     "ink": "^7.1.1",
-    "react": "^19.0.0"
+    "react": "^19.0.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

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

@@ -1,12 +0,0 @@
-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 +0,0 @@
-{"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/infrastructure/get-dir-lazy-entries.d.ts

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

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

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

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

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