@hamak/ui-store-api 0.2.6 → 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,41 @@
+## 0.4.0 (2025-11-10)
+
+### 🚀 Features
+
+- implement notification plugin with UI and backend components ([c19ffcf](https://github.com/amah/app-framework/commit/c19ffcf))
+- add ES2015 build support and fix TypeScript config for logging packages ([be5e45e](https://github.com/amah/app-framework/commit/be5e45e))
+- complete logging system build and add optional console interception ([f390bc6](https://github.com/amah/app-framework/commit/f390bc6))
+- implement core pluggable logging system (Phase 1) ([2abdc1a](https://github.com/amah/app-framework/commit/2abdc1a))
+
+### 🩹 Fixes
+
+- add notification packages to workspaces ([97a234d](https://github.com/amah/app-framework/commit/97a234d))
+
+### ❤️ Thank You
+
+- Amah
+- Claude
+
+## 0.3.0 (2025-11-06)
+
+### 🚀 Features
+
+- migrate from Turbo to Nx 22 with comprehensive monorepo setup ([e63801e](https://github.com/amah/app-framework/commit/e63801e))
+- add Nx Release for automated dependency management ([01d474f](https://github.com/amah/app-framework/commit/01d474f))
+- migrate from Turbo to Nx 22 monorepo orchestration ([d374271](https://github.com/amah/app-framework/commit/d374271))
+- add configurable main padding and resizable sidebar to DashboardLayout ([c1d25bf](https://github.com/amah/app-framework/commit/c1d25bf))
+- add debug logging and version management system ([ea514fc](https://github.com/amah/app-framework/commit/ea514fc))
+- **ui-store:** add STORE_EXTENSIONS_TOKEN for DI-based middleware/reducer registration ([e855bdd](https://github.com/amah/app-framework/commit/e855bdd))
+- Rename package scope from @amk to @hamak and configure npm publishing ([b6040b5](https://github.com/amah/app-framework/commit/b6040b5))
+- Add hybrid local/CI-CD development workflow with bun link ([d09f528](https://github.com/amah/app-framework/commit/d09f528))
+- Add Turborepo for intelligent build orchestration and fix test type errors ([ba41db8](https://github.com/amah/app-framework/commit/ba41db8))
+- Add Redux store integration with ui-store package and demo ([e5aafa8](https://github.com/amah/app-framework/commit/e5aafa8))
+
+### 🩹 Fixes
+
+- move git config to top-level release.git in nx.json ([1bb2187](https://github.com/amah/app-framework/commit/1bb2187))
+
+### ❤️ Thank You
+
+- Amah
+- Claude

package/dist/es2015/fs/contracts/filesystem-facade.contract.js

@@ -0,0 +1 @@
+export {};

package/dist/es2015/fs/contracts/filesystem-manager.contract.js

@@ -0,0 +1 @@
+export {};

package/dist/es2015/fs/index.js

@@ -0,0 +1,6 @@
+// Filesystem types
+export * from './types/fs-node.types';
+export * from './types/fs-state.types';
+// Filesystem contracts
+export * from './contracts/filesystem-manager.contract';
+export * from './contracts/filesystem-facade.contract';

package/dist/es2015/fs/types/fs-node.types.js

@@ -0,0 +1 @@
+export {};

package/dist/es2015/fs/types/fs-state.types.js

@@ -0,0 +1,12 @@
+/**
+ * Create initial filesystem node state
+ */
+export function fileSystemNodeInitialState(contentPresent = true) {
+    return {
+        contentLoaded: contentPresent,
+        contentLoading: false,
+        contentLoadError: undefined,
+        contentHistory: [],
+        extensionStates: {}
+    };
+}

package/dist/es2015/index.js

@@ -5,3 +5,4 @@
 export * from './types';
 export * from './api';
 export * from './tokens';
+export * from './fs';

package/dist/fs/contracts/filesystem-facade.contract.d.ts

@@ -0,0 +1,58 @@
+import { FileSystemNode, DirectoryNode, FileNode } from '../types/fs-node.types';
+import { Path } from '@hamak/navigation-utils';
+/**
+ * High-level facade for filesystem operations
+ * Provides a convenient API over the filesystem manager
+ */
+export interface IFileSystemFacade {
+    /**
+     * Get the root directory node
+     */
+    getRoot(): DirectoryNode;
+    /**
+     * Resolve a file or directory at the given path
+     */
+    resolve(path: Path): FileSystemNode | undefined;
+    /**
+     * Resolve a file at the given path
+     */
+    resolveFile<T = any>(path: Path): FileNode<T> | undefined;
+    /**
+     * Resolve a directory at the given path
+     */
+    resolveDirectory(path: Path): DirectoryNode | undefined;
+    /**
+     * Create or update a file at the given path
+     */
+    setFile<T = any>(path: Path, content: T, schema?: string, params?: {
+        override?: boolean;
+        contentIsPresent?: boolean;
+    }): void;
+    /**
+     * Update file content at the given path
+     */
+    updateFileContent<T = any>(path: Path, content: T): void;
+    /**
+     * Create a directory at the given path
+     */
+    mkdir(path: Path, params?: {
+        override?: boolean;
+    }): void;
+    /**
+     * Remove a file or directory at the given path
+     */
+    remove(path: Path): void;
+    /**
+     * Check if a path exists
+     */
+    exists(path: Path): boolean;
+    /**
+     * Check if a path is a file
+     */
+    isFile(path: Path): boolean;
+    /**
+     * Check if a path is a directory
+     */
+    isDirectory(path: Path): boolean;
+}
+//# sourceMappingURL=filesystem-facade.contract.d.ts.map

package/dist/fs/contracts/filesystem-facade.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-facade.contract.d.ts","sourceRoot":"","sources":["../../../src/fs/contracts/filesystem-facade.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,IAAI,aAAa,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,cAAc,GAAG,SAAS,CAAC;IAEhD;;OAEG;IACH,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAE1D;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,GAAG,SAAS,CAAC;IAExD;;OAEG;IACH,OAAO,CAAC,CAAC,GAAG,GAAG,EACb,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,CAAC,EACV,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1D,IAAI,CAAC;IAER;;OAEG;IACH,iBAAiB,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IAE5B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IAE5B;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;CAClC"}

package/dist/fs/contracts/filesystem-facade.contract.js

@@ -0,0 +1 @@
+export {};

package/dist/fs/contracts/filesystem-manager.contract.d.ts

@@ -0,0 +1,41 @@
+import { FileSystemNode, FileSystemState } from '../types/fs-node.types';
+import { Action } from 'redux';
+/**
+ * Redux selector function type
+ */
+export type Selector<S, R> = (state: S) => R;
+/**
+ * Actions for filesystem operations
+ */
+export interface FileSystemNodeAction extends Action {
+    command: any;
+}
+/**
+ * Parameters for filesystem node actions
+ */
+export interface FileSystemNodeActionParams {
+    override?: boolean;
+    contentIsPresent?: boolean;
+}
+/**
+ * Filesystem manager interface - manages Redux state for virtual filesystem
+ */
+export interface IFileSystemManager {
+    /**
+     * Get the slice name for this filesystem
+     */
+    readonly sliceName: string;
+    /**
+     * Get initial filesystem state
+     */
+    getInitialState(): FileSystemState;
+    /**
+     * Get the reducer function for filesystem operations
+     */
+    getReducer(): (state: FileSystemState, action: Action) => FileSystemState;
+    /**
+     * Create a selector for a specific path in the filesystem
+     */
+    createSelector<S>(fileSystemSelector: Selector<S, FileSystemState | undefined>, path: string | string[]): Selector<S, FileSystemNode | undefined>;
+}
+//# sourceMappingURL=filesystem-manager.contract.d.ts.map

package/dist/fs/contracts/filesystem-manager.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-manager.contract.d.ts","sourceRoot":"","sources":["../../../src/fs/contracts/filesystem-manager.contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA2B,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAElG,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,MAAM;IAClD,OAAO,EAAE,GAAG,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,eAAe,IAAI,eAAe,CAAC;IAEnC;;OAEG;IACH,UAAU,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,KAAK,eAAe,CAAC;IAE1E;;OAEG;IACH,cAAc,CAAC,CAAC,EACd,kBAAkB,EAAE,QAAQ,CAAC,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC,EAC5D,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GACtB,QAAQ,CAAC,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC;CAC5C"}

package/dist/fs/contracts/filesystem-manager.contract.js

@@ -0,0 +1 @@
+export {};

package/dist/fs/index.d.ts

@@ -0,0 +1,6 @@
+export * from './types/fs-node.types';
+export * from './types/fs-state.types';
+export * from './contracts/filesystem-manager.contract';
+export * from './contracts/filesystem-facade.contract';
+export type { FileContentSchema } from '@hamak/navigation-utils';
+//# 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,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AAGvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/fs/index.js

@@ -0,0 +1,6 @@
+// Filesystem types
+export * from './types/fs-node.types';
+export * from './types/fs-state.types';
+// Filesystem contracts
+export * from './contracts/filesystem-manager.contract';
+export * from './contracts/filesystem-facade.contract';

package/dist/fs/types/fs-node.types.d.ts

@@ -0,0 +1,37 @@
+import { AbstractFileNode, AbstractDirectoryNode, FileContentSchema } from '@hamak/navigation-utils';
+import { FileSystemNodeState } from './fs-state.types';
+/**
+ * Base interface for filesystem nodes with state
+ */
+export interface FileSystemNodeBase {
+    type: 'directory' | 'file';
+    name: string;
+    state: FileSystemNodeState;
+}
+/**
+ * Directory node with state management
+ */
+export interface DirectoryNode extends FileSystemNodeBase, Omit<AbstractDirectoryNode<FileSystemNode>, 'children'> {
+    type: 'directory';
+    children: Record<string, FileSystemNode>;
+}
+/**
+ * File node with state management
+ */
+export interface FileNode<T = any> extends FileSystemNodeBase, AbstractFileNode<T> {
+    type: 'file';
+    content: T;
+    schema: string | FileContentSchema;
+    state: FileSystemNodeState;
+}
+/**
+ * Union type for filesystem nodes
+ */
+export type FileSystemNode = DirectoryNode | FileNode;
+/**
+ * Root filesystem state
+ */
+export interface FileSystemState {
+    root: DirectoryNode;
+}
+//# sourceMappingURL=fs-node.types.d.ts.map

package/dist/fs/types/fs-node.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-node.types.d.ts","sourceRoot":"","sources":["../../../src/fs/types/fs-node.types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,mBAAmB,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,kBAAkB,EAAE,IAAI,CAAC,qBAAqB,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IAChH,IAAI,EAAE,WAAW,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,kBAAkB,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAChF,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,CAAC,CAAA;IACV,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAAA;IAClC,KAAK,EAAE,mBAAmB,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,QAAQ,CAAA;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAA;CACpB"}

package/dist/fs/types/fs-node.types.js

@@ -0,0 +1 @@
+export {};

package/dist/fs/types/fs-state.types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Holder interface for values that can be undefined
+ */
+export interface Holder<T = any> {
+    value: T;
+}
+/**
+ * Memo state for tracking file modifications
+ */
+export interface FileMemoState {
+    originalContent: Holder;
+    modified: boolean;
+}
+/**
+ * State information for filesystem nodes
+ */
+export interface FileSystemNodeState {
+    contentLoaded: boolean;
+    contentLoading: boolean;
+    contentLoadError?: {
+        code?: string;
+        message?: string;
+    };
+    memo?: FileMemoState;
+    contentHistory: any[];
+    extensionStates: Record<string, unknown>;
+}
+/**
+ * Create initial filesystem node state
+ */
+export declare function fileSystemNodeInitialState(contentPresent?: boolean): FileSystemNodeState;
+//# sourceMappingURL=fs-state.types.d.ts.map

package/dist/fs/types/fs-state.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-state.types.d.ts","sourceRoot":"","sources":["../../../src/fs/types/fs-state.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,GAAG;IAC7B,KAAK,EAAC,CAAC,CAAA;CACR;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,OAAO,CAAA;IACtB,cAAc,EAAE,OAAO,CAAA;IACvB,gBAAgB,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACtD,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,cAAc,EAAE,GAAG,EAAE,CAAA;IACrB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACzC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,cAAc,UAAO,GAAG,mBAAmB,CAQrF"}

package/dist/fs/types/fs-state.types.js

@@ -0,0 +1,12 @@
+/**
+ * Create initial filesystem node state
+ */
+export function fileSystemNodeInitialState(contentPresent = true) {
+    return {
+        contentLoaded: contentPresent,
+        contentLoading: false,
+        contentLoadError: undefined,
+        contentHistory: [],
+        extensionStates: {}
+    };
+}

package/dist/index.d.ts

@@ -5,4 +5,5 @@
 export * from './types';
 export * from './api';
 export * from './tokens';
+export * from './fs';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC"}

package/dist/index.js

@@ -5,3 +5,4 @@
 export * from './types';
 export * from './api';
 export * from './tokens';
+export * from './fs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamak/ui-store-api",
-  "version": "0.2.6",
+  "version": "0.4.0",
   "private": false,
   "type": "module",
   "description": "UI Store API - Redux store interfaces and contracts",
@@ -34,6 +34,7 @@
     }
   },
   "dependencies": {
+    "@hamak/navigation-utils": "0.4.0",
     "redux": "^5.0.1"
   },
   "devDependencies": {

package/project.json

@@ -0,0 +1,24 @@
+{
+  "name": "@hamak/ui-store-api",
+  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "packages/ui-store/ui-store-api/src",
+  "projectType": "library",
+  "targets": {
+    "build": {
+      "executor": "nx:run-commands",
+      "outputs": ["{projectRoot}/dist"],
+      "options": {
+        "command": "tsc -p tsconfig.json && tsc -p tsconfig.es2015.json",
+        "cwd": "{projectRoot}"
+      }
+    },
+    "clean": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "rm -rf dist",
+        "cwd": "{projectRoot}"
+      }
+    }
+  },
+  "tags": ["type:library", "scope:ui-store"]
+}

package/src/fs/contracts/filesystem-facade.contract.ts

@@ -0,0 +1,68 @@
+import { FileSystemNode, DirectoryNode, FileNode } from '../types/fs-node.types';
+import { Path } from '@hamak/navigation-utils';
+
+/**
+ * High-level facade for filesystem operations
+ * Provides a convenient API over the filesystem manager
+ */
+export interface IFileSystemFacade {
+  /**
+   * Get the root directory node
+   */
+  getRoot(): DirectoryNode;
+
+  /**
+   * Resolve a file or directory at the given path
+   */
+  resolve(path: Path): FileSystemNode | undefined;
+
+  /**
+   * Resolve a file at the given path
+   */
+  resolveFile<T = any>(path: Path): FileNode<T> | undefined;
+
+  /**
+   * Resolve a directory at the given path
+   */
+  resolveDirectory(path: Path): DirectoryNode | undefined;
+
+  /**
+   * Create or update a file at the given path
+   */
+  setFile<T = any>(
+    path: Path,
+    content: T,
+    schema?: string,
+    params?: { override?: boolean; contentIsPresent?: boolean }
+  ): void;
+
+  /**
+   * Update file content at the given path
+   */
+  updateFileContent<T = any>(path: Path, content: T): void;
+
+  /**
+   * Create a directory at the given path
+   */
+  mkdir(path: Path, params?: { override?: boolean }): void;
+
+  /**
+   * Remove a file or directory at the given path
+   */
+  remove(path: Path): void;
+
+  /**
+   * Check if a path exists
+   */
+  exists(path: Path): boolean;
+
+  /**
+   * Check if a path is a file
+   */
+  isFile(path: Path): boolean;
+
+  /**
+   * Check if a path is a directory
+   */
+  isDirectory(path: Path): boolean;
+}

package/src/fs/contracts/filesystem-manager.contract.ts

@@ -0,0 +1,51 @@
+import { FileSystemNode, DirectoryNode, FileNode, FileSystemState } from '../types/fs-node.types';
+import { Path } from '@hamak/navigation-utils';
+import { Action } from 'redux';
+
+/**
+ * Redux selector function type
+ */
+export type Selector<S, R> = (state: S) => R;
+
+/**
+ * Actions for filesystem operations
+ */
+export interface FileSystemNodeAction extends Action {
+  command: any // Will be typed more specifically in implementation
+}
+
+/**
+ * Parameters for filesystem node actions
+ */
+export interface FileSystemNodeActionParams {
+  override?: boolean
+  contentIsPresent?: boolean
+}
+
+/**
+ * Filesystem manager interface - manages Redux state for virtual filesystem
+ */
+export interface IFileSystemManager {
+  /**
+   * Get the slice name for this filesystem
+   */
+  readonly sliceName: string;
+
+  /**
+   * Get initial filesystem state
+   */
+  getInitialState(): FileSystemState;
+
+  /**
+   * Get the reducer function for filesystem operations
+   */
+  getReducer(): (state: FileSystemState, action: Action) => FileSystemState;
+
+  /**
+   * Create a selector for a specific path in the filesystem
+   */
+  createSelector<S>(
+    fileSystemSelector: Selector<S, FileSystemState | undefined>,
+    path: string | string[]
+  ): Selector<S, FileSystemNode | undefined>;
+}

package/src/fs/index.ts

@@ -0,0 +1,10 @@
+// Filesystem types
+export * from './types/fs-node.types';
+export * from './types/fs-state.types';
+
+// Filesystem contracts
+export * from './contracts/filesystem-manager.contract';
+export * from './contracts/filesystem-facade.contract';
+
+// Re-export from navigation-utils for convenience
+export type { FileContentSchema } from '@hamak/navigation-utils';

package/src/fs/types/fs-node.types.ts

@@ -0,0 +1,45 @@
+import {
+  AbstractFileNode,
+  AbstractDirectoryNode,
+  FileContentSchema
+} from '@hamak/navigation-utils';
+import { FileSystemNodeState } from './fs-state.types';
+
+/**
+ * Base interface for filesystem nodes with state
+ */
+export interface FileSystemNodeBase {
+  type: 'directory' | 'file'
+  name: string
+  state: FileSystemNodeState
+}
+
+/**
+ * Directory node with state management
+ */
+export interface DirectoryNode extends FileSystemNodeBase, Omit<AbstractDirectoryNode<FileSystemNode>, 'children'> {
+  type: 'directory'
+  children: Record<string, FileSystemNode>
+}
+
+/**
+ * File node with state management
+ */
+export interface FileNode<T = any> extends FileSystemNodeBase, AbstractFileNode<T> {
+  type: 'file'
+  content: T
+  schema: string | FileContentSchema
+  state: FileSystemNodeState
+}
+
+/**
+ * Union type for filesystem nodes
+ */
+export type FileSystemNode = DirectoryNode | FileNode
+
+/**
+ * Root filesystem state
+ */
+export interface FileSystemState {
+  root: DirectoryNode
+}

package/src/fs/types/fs-state.types.ts

@@ -0,0 +1,39 @@
+/**
+ * Holder interface for values that can be undefined
+ */
+export interface Holder<T = any>{
+  value:T
+}
+
+/**
+ * Memo state for tracking file modifications
+ */
+export interface FileMemoState {
+  originalContent: Holder
+  modified: boolean // tell whether the current file content is modified compared to original
+}
+
+/**
+ * State information for filesystem nodes
+ */
+export interface FileSystemNodeState {
+  contentLoaded: boolean
+  contentLoading: boolean
+  contentLoadError?: { code?: string, message?: string }
+  memo?: FileMemoState
+  contentHistory: any[]
+  extensionStates: Record<string, unknown>
+}
+
+/**
+ * Create initial filesystem node state
+ */
+export function fileSystemNodeInitialState(contentPresent = true): FileSystemNodeState {
+  return {
+    contentLoaded: contentPresent,
+    contentLoading: false,
+    contentLoadError: undefined,
+    contentHistory: [],
+    extensionStates: {}
+  }
+}

package/src/index.ts

@@ -6,3 +6,4 @@
 export * from './types';
 export * from './api';
 export * from './tokens';
+export * from './fs';