@hamak/ui-store-impl 0.3.0 → 0.4.0

package/dist/fs/commands/structure-commands.d.ts

@@ -0,0 +1,76 @@
+import { Itinerary, StackElement } from '@hamak/navigation-utils';
+/**
+ * Base interface for structure node commands
+ */
+export interface StructureNodeCommandBase {
+    name: "add-at" | "set-at" | "delete-at" | 'insert-at' | "batch-update";
+}
+/**
+ * Base interface for unitary (single operation) commands
+ */
+export interface UnitaryStructureNodeCommandBase extends StructureNodeCommandBase {
+    name: "add-at" | "set-at" | "delete-at" | 'insert-at';
+    itinerary: Itinerary;
+}
+/**
+ * Base interface for commands that insert/update values
+ */
+export interface StructureNodeUpsertCommandBase extends UnitaryStructureNodeCommandBase {
+    name: "add-at" | "set-at" | 'insert-at';
+    prototypes?: StackElement<any>;
+}
+/**
+ * Add a value at the specified itinerary
+ */
+export interface AddStructureNodeCommand extends StructureNodeUpsertCommandBase {
+    name: "add-at";
+    value: any;
+}
+/**
+ * Insert a value at the specified position
+ */
+export interface InsertStructureNodeCommand extends StructureNodeUpsertCommandBase {
+    name: "insert-at";
+    value: any;
+}
+/**
+ * Set a value at the specified itinerary
+ */
+export interface SetStructureNodeCommand extends StructureNodeUpsertCommandBase {
+    name: "set-at";
+    value: any;
+}
+/**
+ * Delete a value at the specified itinerary
+ */
+export interface DeleteStructureNodeCommand extends UnitaryStructureNodeCommandBase {
+    name: "delete-at";
+}
+/**
+ * Batch update multiple operations
+ */
+export interface BatchUpdateStructureNodeCommand extends StructureNodeCommandBase {
+    name: "batch-update";
+    autoRebase?: boolean;
+    commands: UnitaryStructureNodeCommand[];
+}
+/**
+ * Union type for unitary structure node commands
+ */
+export type UnitaryStructureNodeCommand = AddStructureNodeCommand | InsertStructureNodeCommand | SetStructureNodeCommand | DeleteStructureNodeCommand;
+/**
+ * Union type for all structure node commands
+ */
+export type StructureNodeCommand = UnitaryStructureNodeCommand | BatchUpdateStructureNodeCommand;
+/**
+ * Helper class for creating structure node commands
+ */
+export declare class StructureNodeCommandHelper {
+    addNode(itinerary: Itinerary, value: any, prototypes?: StackElement<any>): AddStructureNodeCommand;
+    insertNode(itinerary: Itinerary, value: any, prototypes?: StackElement<any>): InsertStructureNodeCommand;
+    setNode(itinerary: Itinerary, value: any, prototypes?: StackElement<any>): SetStructureNodeCommand;
+    deleteNode(itinerary: Itinerary): DeleteStructureNodeCommand;
+    batchUpdate(commands: UnitaryStructureNodeCommand[], autoRebase?: boolean): BatchUpdateStructureNodeCommand;
+}
+export declare const structs: StructureNodeCommandHelper;
+//# sourceMappingURL=structure-commands.d.ts.map

package/dist/fs/commands/structure-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-commands.d.ts","sourceRoot":"","sources":["../../../src/fs/commands/structure-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,CAAA;CACvE;AAED;;GAEG;AACH,MAAM,WAAW,+BAAgC,SAAQ,wBAAwB;IAC/E,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAA;IACrD,SAAS,EAAE,SAAS,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,+BAA+B;IACrF,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAA;IACvC,UAAU,CAAC,EAAG,YAAY,CAAC,GAAG,CAAC,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,8BAA8B;IAC7E,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,GAAG,CAAA;CACX;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,8BAA8B;IAChF,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,GAAG,CAAA;CACX;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,8BAA8B;IAC7E,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,GAAG,CAAA;CACX;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,+BAA+B;IACjF,IAAI,EAAE,WAAW,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,+BAAgC,SAAQ,wBAAwB;IAC/E,IAAI,EAAE,cAAc,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,EAAE,2BAA2B,EAAE,CAAA;CACxC;AAED;;GAEG;AACH,MAAM,MAAM,2BAA2B,GACnC,uBAAuB,GACvB,0BAA0B,GAC1B,uBAAuB,GACvB,0BAA0B,CAAA;AAE9B;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,2BAA2B,GAAG,+BAA+B,CAAA;AAEhG;;GAEG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,SAAS,EAAG,SAAS,EAAE,KAAK,EAAG,GAAG,EAAE,UAAU,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,GAAI,uBAAuB;IAIrG,UAAU,CAAC,SAAS,EAAG,SAAS,EAAE,KAAK,EAAG,GAAG,EAAE,UAAU,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,GAAI,0BAA0B;IAI3G,OAAO,CAAC,SAAS,EAAG,SAAS,EAAE,KAAK,EAAG,GAAG,EAAE,UAAU,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,GAAI,uBAAuB;IAIrG,UAAU,CAAC,SAAS,EAAG,SAAS,GAAI,0BAA0B;IAI9D,WAAW,CAAC,QAAQ,EAAG,2BAA2B,EAAE,EAAE,UAAU,UAAQ,GAAI,+BAA+B;CAG5G;AAED,eAAO,MAAM,OAAO,4BAAmC,CAAA"}

package/dist/fs/commands/structure-commands.js

@@ -0,0 +1,21 @@
+/**
+ * Helper class for creating structure node commands
+ */
+export class StructureNodeCommandHelper {
+    addNode(itinerary, value, prototypes) {
+        return { name: 'add-at', itinerary, value, prototypes };
+    }
+    insertNode(itinerary, value, prototypes) {
+        return { name: 'insert-at', itinerary, value, prototypes };
+    }
+    setNode(itinerary, value, prototypes) {
+        return { name: 'set-at', itinerary, value, prototypes };
+    }
+    deleteNode(itinerary) {
+        return { name: 'delete-at', itinerary };
+    }
+    batchUpdate(commands, autoRebase = false) {
+        return { name: 'batch-update', commands, autoRebase };
+    }
+}
+export const structs = new StructureNodeCommandHelper();

package/dist/fs/core/fs-adapter.d.ts

@@ -0,0 +1,57 @@
+import { Action } from '@reduxjs/toolkit';
+import { FileSystemCommand, FileSystemCommandHandler } from '../commands/fs-commands';
+import { FileSystemNode, FileSystemState, FileContentSchema, FileSystemNodeActionParams, Selector } from '@hamak/ui-store-api';
+import { StructureNodeCommand } from '../commands/structure-commands';
+/**
+ * Action interface for filesystem operations
+ */
+export interface FileSystemNodeAction extends Action {
+    command: FileSystemCommand;
+}
+/**
+ * Factory function to create a FileSystemAdapter
+ */
+export declare function createFileSystemAdapter(sliceName: string): FileSystemAdapter;
+/**
+ * Filesystem reducer function type
+ */
+export type FileSystemNodeReducerFn = (state: FileSystemState, action: Action) => FileSystemState;
+/**
+ * FileSystemAdapter - Manages Redux state for virtual filesystem
+ */
+export declare class FileSystemAdapter {
+    readonly sliceName: string;
+    readonly actions: FileSystemNodeActions;
+    readonly commandHandler: FileSystemCommandHandler;
+    readonly reducer: FileSystemNodeReducerFn;
+    constructor(sliceName: string);
+    getInitialState(): FileSystemState;
+    getActions(): FileSystemNodeActions;
+    getReducer(extraReducers?: FileSystemNodeReducerFn): FileSystemNodeReducerFn;
+    createSelector<S>(fileSystemSelector: Selector<S, FileSystemState | undefined>, path: string | string[]): Selector<S, FileSystemNode | undefined>;
+}
+/**
+ * FileSystemNodeActions - Action creators for filesystem operations
+ */
+export declare class FileSystemNodeActions {
+    sliceName: string;
+    private readonly _mkdirType;
+    private readonly _setFileType;
+    private readonly _removeType;
+    private readonly _updateFileContentType;
+    private readonly _setFileContentType;
+    private actionTypeSet;
+    constructor(sliceName: string);
+    get mkdirType(): string;
+    get setFileType(): string;
+    get removeType(): string;
+    get updateFileContentType(): string;
+    get setFileContentType(): string;
+    isFileSystemNodeAction(action: Action): action is FileSystemNodeAction;
+    mkdir(path: string | string[], parents?: boolean): FileSystemNodeAction;
+    setFile(path: string | string[], content: any, schema: FileContentSchema, params?: FileSystemNodeActionParams): FileSystemNodeAction;
+    updateFileContent(path: string | string[], contentCommand: StructureNodeCommand): FileSystemNodeAction;
+    setFileContent(path: string | string[], content: any, fromRemote?: boolean): FileSystemNodeAction;
+    removeNode(path: string | string[], recursive?: boolean): FileSystemNodeAction;
+}
+//# sourceMappingURL=fs-adapter.d.ts.map

package/dist/fs/core/fs-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-adapter.d.ts","sourceRoot":"","sources":["../../../src/fs/core/fs-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAkB,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EAEzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,cAAc,EAEd,eAAe,EACf,iBAAiB,EACjB,0BAA0B,EAC1B,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,MAAM;IAClD,OAAO,EAAE,iBAAiB,CAAA;CAC3B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,qBAExD;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,KAAK,eAAe,CAAA;AAEjG;;GAEG;AACH,qBAAa,iBAAiB;aAKO,SAAS,EAAE,MAAM;IAJpD,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAA;IACvC,QAAQ,CAAC,cAAc,EAAE,wBAAwB,CAAA;IACjD,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAA;gBAEN,SAAS,EAAE,MAAM;IAapD,eAAe,IAAI,eAAe;IAIlC,UAAU;IAIV,UAAU,CAAC,aAAa,CAAC,EAAE,uBAAuB,GAAG,uBAAuB;IAQ5E,cAAc,CAAC,CAAC,EAAE,kBAAkB,EAAE,QAAQ,CAAC,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,EAAE,IAAI,EAAG,MAAM,GAAG,MAAM,EAAE,GAAI,QAAQ,CAAC,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CAiBpJ;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAQb,SAAS,EAAE,MAAM;IAPpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,aAAa,CAAa;gBAEf,SAAS,EAAE,MAAM;IAgBpC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAED,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,oBAAoB;IAI/D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAC,OAAO,GAAG,oBAAoB;IAOtE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,EAAC,GAAG,EAAE,MAAM,EAAG,iBAAiB,EAAE,MAAM,GAAG,0BAAoE,GAAG,oBAAoB;IAQ9K,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,cAAc,EAAG,oBAAoB,GAAI,oBAAoB;IAOxG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,EAAG,GAAG,EAAE,UAAU,UAAQ,GAAG,oBAAoB;IAQhG,UAAU,CAAC,IAAI,EAAG,MAAM,GAAG,MAAM,EAAE,EAAE,SAAS,CAAC,EAAG,OAAO,GAAG,oBAAoB;CAOxF"}

package/dist/fs/core/fs-adapter.js

@@ -0,0 +1,123 @@
+import { createSelector } from '@reduxjs/toolkit';
+import { FileSystemCommandHandler, pathSteps } from '../commands/fs-commands';
+import { fileSystemNodeInitialState } from '@hamak/ui-store-api';
+/**
+ * Factory function to create a FileSystemAdapter
+ */
+export function createFileSystemAdapter(sliceName) {
+    return new FileSystemAdapter(sliceName);
+}
+/**
+ * FileSystemAdapter - Manages Redux state for virtual filesystem
+ */
+export class FileSystemAdapter {
+    constructor(sliceName) {
+        this.sliceName = sliceName;
+        this.actions = new FileSystemNodeActions(sliceName);
+        this.commandHandler = new FileSystemCommandHandler();
+        this.reducer = (state = this.getInitialState(), action) => {
+            if (this.actions.isFileSystemNodeAction(action)) {
+                return this.commandHandler.execute(state, action.command);
+            }
+            return state;
+        };
+    }
+    getInitialState() {
+        return { root: { type: 'directory', name: '', children: {}, state: fileSystemNodeInitialState() } };
+    }
+    getActions() {
+        return this.actions;
+    }
+    getReducer(extraReducers) {
+        if (extraReducers === undefined) {
+            return this.reducer;
+        }
+        return (state, action) => this.reducer(extraReducers(state, action), action);
+    }
+    createSelector(fileSystemSelector, path) {
+        const rootSelector = createSelector(fileSystemSelector, fs => fs?.root);
+        const steps = pathSteps(path);
+        if (steps === undefined || steps.length === 0) {
+            return rootSelector;
+        }
+        return steps.reduce((acc, step) => {
+            return createSelector(acc, o => {
+                if (o === undefined || o.type === 'file') {
+                    return o;
+                }
+                else {
+                    return o.children[step];
+                }
+            });
+        }, rootSelector);
+    }
+}
+/**
+ * FileSystemNodeActions - Action creators for filesystem operations
+ */
+export class FileSystemNodeActions {
+    constructor(sliceName) {
+        this.sliceName = sliceName;
+        this._mkdirType = `${this.sliceName}/createDirectoryNode`;
+        this._setFileType = `${this.sliceName}/createFileNode`;
+        this._removeType = `${this.sliceName}/removeNode`;
+        this._updateFileContentType = `${this.sliceName}/updateFileContent`;
+        this._setFileContentType = `${this.sliceName}/setFileContent`;
+        this.actionTypeSet = new Set([
+            this._mkdirType,
+            this._setFileType,
+            this._removeType,
+            this._updateFileContentType,
+            this._setFileContentType
+        ]);
+    }
+    get mkdirType() {
+        return this._mkdirType;
+    }
+    get setFileType() {
+        return this._setFileType;
+    }
+    get removeType() {
+        return this._removeType;
+    }
+    get updateFileContentType() {
+        return this._updateFileContentType;
+    }
+    get setFileContentType() {
+        return this._setFileContentType;
+    }
+    isFileSystemNodeAction(action) {
+        return this.actionTypeSet.has(action.type);
+    }
+    mkdir(path, parents) {
+        return {
+            type: this.mkdirType,
+            command: { name: 'mkdir', path, parents }
+        };
+    }
+    setFile(path, content, schema, params = { override: true, contentIsPresent: true }) {
+        const { override, contentIsPresent } = params;
+        return {
+            type: this.setFileType,
+            command: { name: 'set-file', path, content, schema, override, contentIsPresent }
+        };
+    }
+    updateFileContent(path, contentCommand) {
+        return {
+            type: this.updateFileContentType,
+            command: { name: 'update-file-content', path, contentCommand }
+        };
+    }
+    setFileContent(path, content, fromRemote = false) {
+        return {
+            type: this.setFileContentType,
+            command: { name: 'set-file-content', path, content, fromRemote }
+        };
+    }
+    removeNode(path, recursive) {
+        return {
+            type: this.removeType,
+            command: { name: 'remove', path, recursive }
+        };
+    }
+}

package/dist/fs/core/fs-facade.d.ts

@@ -0,0 +1,37 @@
+import { FileNode, FileSystemNode, FileSystemState, Selector } from '@hamak/ui-store-api';
+import { FileSystemAdapter, FileSystemNodeActions } from './fs-adapter';
+import { Path, Pathway, PathwayResolver, RelativePathwayResolver } from '@hamak/navigation-utils';
+/**
+ * Selector that returns a FileSystemNode generally the root of the Filesystem Overlay
+ */
+export interface StoreFileSystemOverlaySelector<S> {
+    /**
+     * The key of the overlay
+     */
+    key: string;
+    selector: Selector<S, FileSystemNode | undefined>;
+}
+/**
+ * StoreFileSystemFacade - High-level API for filesystem operations
+ */
+export declare class StoreFileSystemFacade<S = any> {
+    private fileSystemSelector;
+    private adapter;
+    constructor(fileSystemSelector: Selector<S, FileSystemState | undefined>, adapter: FileSystemAdapter);
+    getActions(): FileSystemNodeActions;
+    createSelector(path: string | string[]): Selector<S, FileSystemNode | undefined>;
+    createFileSelector(path: string | string[]): Selector<S, FileNode | undefined>;
+    selectFromRoot(state: S, path?: string[]): FileSystemNode | undefined;
+    selectFileFromRoot(state: S, path?: string[]): FileNode | undefined;
+}
+/**
+ * StoreFileSystemPathwayResolver - Pathway resolver for filesystem state
+ */
+export declare class StoreFileSystemPathwayResolver<S = any> implements PathwayResolver<FileSystemNode> {
+    private state;
+    private fs;
+    constructor(state: S, fs: StoreFileSystemFacade<S>);
+    resolve(path: string | string[] | Pathway): FileSystemNode | undefined;
+    relativeTo(path: Path): RelativePathwayResolver<FileSystemNode>;
+}
+//# sourceMappingURL=fs-facade.d.ts.map

package/dist/fs/core/fs-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-facade.d.ts","sourceRoot":"","sources":["../../../src/fs/core/fs-facade.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,QAAQ,EACR,cAAc,EACd,eAAe,EACf,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElG;;GAEG;AACH,MAAM,WAAW,8BAA8B,CAAC,CAAC;IAC/C;;OAEG;IACH,GAAG,EAAG,MAAM,CAAC;IACb,QAAQ,EAAG,QAAQ,CAAC,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC,CAAA;CACnD;AAED;;GAEG;AACH,qBAAa,qBAAqB,CAAC,CAAC,GAAG,GAAG;IAEtC,OAAO,CAAC,kBAAkB;IAC1B,OAAO,CAAC,OAAO;gBADP,kBAAkB,EAAE,QAAQ,CAAC,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,EAC5D,OAAO,EAAG,iBAAiB;IAGrC,UAAU,IAAK,qBAAqB;IAIpC,cAAc,CAAC,IAAI,EAAG,MAAM,GAAG,MAAM,EAAE,GAAI,QAAQ,CAAC,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAIlF,kBAAkB,CAAC,IAAI,EAAG,MAAM,GAAG,MAAM,EAAE,GAAI,QAAQ,CAAC,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAWhF,cAAc,CAAC,KAAK,EAAG,CAAC,EAAE,IAAI,GAAG,MAAM,EAAO,GAAI,cAAc,GAAG,SAAS;IAmB5E,kBAAkB,CAAC,KAAK,EAAG,CAAC,EAAE,IAAI,GAAG,MAAM,EAAO,GAAI,QAAQ,GAAG,SAAS;CAY3E;AAGD;;GAEG;AACH,qBAAa,8BAA8B,CAAC,CAAC,GAAG,GAAG,CAAE,YAAW,eAAe,CAAC,cAAc,CAAC;IACjF,OAAO,CAAC,KAAK;IAAM,OAAO,CAAC,EAAE;gBAArB,KAAK,EAAG,CAAC,EAAU,EAAE,EAAG,qBAAqB,CAAC,CAAC,CAAC;IAGpE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,GAAG,cAAc,GAAG,SAAS;IAKtE,UAAU,CAAC,IAAI,EAAG,IAAI,GAAI,uBAAuB,CAAC,cAAc,CAAC;CAGlE"}

package/dist/fs/core/fs-facade.js

@@ -0,0 +1,78 @@
+import { createSelector } from '@reduxjs/toolkit';
+import { Pathway, RelativePathwayResolver } from '@hamak/navigation-utils';
+/**
+ * StoreFileSystemFacade - High-level API for filesystem operations
+ */
+export class StoreFileSystemFacade {
+    constructor(fileSystemSelector, adapter) {
+        this.fileSystemSelector = fileSystemSelector;
+        this.adapter = adapter;
+    }
+    getActions() {
+        return this.adapter.getActions();
+    }
+    createSelector(path) {
+        return this.adapter.createSelector(this.fileSystemSelector, path);
+    }
+    createFileSelector(path) {
+        const nodeSelector = this.adapter.createSelector(this.fileSystemSelector, path);
+        return createSelector([nodeSelector], (f) => {
+            if (f?.type === 'file') {
+                return f;
+            }
+            else {
+                return undefined;
+            }
+        });
+    }
+    selectFromRoot(state, path = []) {
+        const fileSystemState = this.fileSystemSelector(state);
+        if (fileSystemState === undefined || fileSystemState === null) {
+            return undefined;
+        }
+        else {
+            const root = fileSystemState.root;
+            return (path ?? []).reduce((acc, step) => {
+                if (acc === undefined || acc === null) {
+                    return undefined;
+                }
+                else {
+                    switch (acc.type) {
+                        case "directory": return acc.children[step];
+                        case "file": return undefined;
+                    }
+                }
+            }, root);
+        }
+    }
+    selectFileFromRoot(state, path = []) {
+        const fsNode = this.selectFromRoot(state, path);
+        if (fsNode === undefined) {
+            return undefined;
+        }
+        else {
+            if (fsNode.type === "file") {
+                return fsNode;
+            }
+            else {
+                throw new Error(`Expecting file at path '${Pathway.of(path).toString()}' but got '${fsNode.type}'`);
+            }
+        }
+    }
+}
+/**
+ * StoreFileSystemPathwayResolver - Pathway resolver for filesystem state
+ */
+export class StoreFileSystemPathwayResolver {
+    constructor(state, fs) {
+        this.state = state;
+        this.fs = fs;
+    }
+    resolve(path) {
+        const segments = Pathway.of(path).getSegments();
+        return this.fs.selectFromRoot(this.state, segments);
+    }
+    relativeTo(path) {
+        return new RelativePathwayResolver(this, path);
+    }
+}

package/dist/fs/index.d.ts

@@ -0,0 +1,7 @@
+export * from './core/fs-adapter';
+export * from './core/fs-facade';
+export * from './commands/fs-commands';
+export * from './commands/structure-commands';
+export * from './utils/data-updater';
+export * from './utils/deep-equal';
+//# sourceMappingURL=index.d.ts.map

package/dist/fs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fs/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAG9C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}

package/dist/fs/index.js

@@ -0,0 +1,9 @@
+// Core filesystem functionality
+export * from './core/fs-adapter';
+export * from './core/fs-facade';
+// Commands
+export * from './commands/fs-commands';
+export * from './commands/structure-commands';
+// Utilities
+export * from './utils/data-updater';
+export * from './utils/deep-equal';

package/dist/fs/utils/data-updater.d.ts

@@ -0,0 +1,36 @@
+import { Itinerary, StackElement } from '@hamak/navigation-utils';
+import { UnitaryStructureNodeCommand, BatchUpdateStructureNodeCommand } from '../commands/structure-commands';
+/**
+ * DataUpdater class handles operations on data structures using itineraries
+ */
+export declare class DataUpdater {
+    /**
+     * Delete a value at the specified itinerary
+     */
+    executeDelete(data: any, itinerary: Itinerary | undefined): void;
+    /**
+     * Set a value at the specified itinerary
+     */
+    executeSet(data: any, itinerary: Itinerary | undefined, value: any, prototypeToParent?: StackElement<any>): void;
+    /**
+     * Add a value at the specified itinerary
+     */
+    executeAdd(data: any, itinerary: Itinerary | undefined, value: any, prototypeToParent?: StackElement<any>): void;
+    /**
+     * Insert a value at the specified position
+     */
+    executeInsert(data: any, itinerary: Itinerary, value: any, prototypeToParent?: StackElement<any>): void;
+    /**
+     * Rebase a pending command's itinerary on top of an altering command.
+     * Returns null if the pending command should be dropped (e.g., targets a deleted element).
+     * Enhanced: Handles rebasing for nested itineraries, not just at the first divergence.
+     */
+    rebasePendingCommandOn(alteringCmd: UnitaryStructureNodeCommand, pendingCmd: UnitaryStructureNodeCommand): UnitaryStructureNodeCommand | null;
+    /**
+     * Executes a batch of commands, rebasing each on previous mutations.
+     * @param data The data object to mutate
+     * @param command The batch update command
+     */
+    executeBatch(data: any, command: BatchUpdateStructureNodeCommand): void;
+}
+//# sourceMappingURL=data-updater.d.ts.map

package/dist/fs/utils/data-updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-updater.d.ts","sourceRoot":"","sources":["../../../src/fs/utils/data-updater.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EACT,YAAY,EAKb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,EAChC,MAAM,gCAAgC,CAAC;AAyBxC;;GAEG;AACH,qBAAa,WAAW;IAEtB;;OAEG;IACI,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS;IA8BhE;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,iBAAiB,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC;IA+BhH;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,iBAAiB,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC;IAahH;;OAEG;IACI,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,iBAAiB,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC;IAkBvG;;;;OAIG;IACI,sBAAsB,CAC3B,WAAW,EAAE,2BAA2B,EACxC,UAAU,EAAE,2BAA2B,GACtC,2BAA2B,GAAG,IAAI;IAqFrC;;;;OAIG;IACI,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,+BAA+B,GAAG,IAAI;CA4B/E"}