@hamak/ui-shell-spi 0.4.6 → 0.4.16

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@hamak/ui-shell-spi",
-  "version": "0.4.6",
+  "version": "0.4.16",
   "private": false,
   "type": "module",
   "description": "UI Shell SPI - Service Provider Interfaces for UI shell",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "sideEffects": false,
+  "files": [
+    "dist"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/amah/app-framework.git",
@@ -32,7 +35,7 @@
     }
   },
   "dependencies": {
-    "@hamak/ui-shell-api": "0.4.6"
+    "@hamak/ui-shell-api": "*"
   },
   "devDependencies": {
     "typescript": "~5.4.0"

package/.turbo/turbo-build.log

@@ -1 +0,0 @@
-$ tsc -p tsconfig.json && tsc -p tsconfig.es2015.json

package/CHANGELOG.md

@@ -1,41 +0,0 @@
-## 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/project.json

@@ -1,24 +0,0 @@
-{
-  "name": "@hamak/ui-shell-spi",
-  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
-  "sourceRoot": "packages/ui-shell/ui-shell-spi/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-shell"]
-}

package/src/guards/NavigationGuard.ts

@@ -1,26 +0,0 @@
-/**
- * Navigation Guard
- * Interface for route navigation guards
- */
-
-import type { RouteConfig } from '@hamak/ui-shell-api';
-
-export type NavigationGuard = (
-  to: RouteConfig,
-  from: RouteConfig | null
-) => boolean | Promise<boolean>;
-
-export interface NavigationGuardContext {
-  /** Route being navigated to */
-  to: RouteConfig;
-  /** Route being navigated from */
-  from: RouteConfig | null;
-  /** Abort navigation */
-  abort: () => void;
-  /** Redirect to another route */
-  redirect: (path: string) => void;
-}
-
-export type AdvancedNavigationGuard = (
-  context: NavigationGuardContext
-) => void | Promise<void>;

package/src/guards/index.ts

@@ -1,6 +0,0 @@
-/**
- * Guards
- * Export all guard interfaces
- */
-
-export * from './NavigationGuard';

package/src/hooks/ShellHooks.ts

@@ -1,48 +0,0 @@
-/**
- * Shell Hooks
- * Lifecycle hooks for shell customization
- */
-
-import type { ShellConfig, ShellContext } from '@hamak/ui-shell-api';
-
-export interface ShellLifecycleHooks {
-  /**
-   * Called before shell initialization
-   */
-  beforeInit?(config: ShellConfig): void | Promise<void>;
-
-  /**
-   * Called after shell initialization
-   */
-  afterInit?(context: ShellContext): void | Promise<void>;
-
-  /**
-   * Called before theme change
-   */
-  beforeThemeChange?(oldTheme: string, newTheme: string): boolean | Promise<boolean>;
-
-  /**
-   * Called after theme change
-   */
-  afterThemeChange?(theme: string): void | Promise<void>;
-
-  /**
-   * Called before feature toggle
-   */
-  beforeFeatureToggle?(key: string, oldValue: any, newValue: any): boolean | Promise<boolean>;
-
-  /**
-   * Called after feature toggle
-   */
-  afterFeatureToggle?(key: string, value: any): void | Promise<void>;
-
-  /**
-   * Called before shell destroy
-   */
-  beforeDestroy?(): void | Promise<void>;
-
-  /**
-   * Called after shell destroy
-   */
-  afterDestroy?(): void | Promise<void>;
-}

package/src/hooks/index.ts

@@ -1,6 +0,0 @@
-/**
- * Hooks
- * Export all hook interfaces
- */
-
-export * from './ShellHooks';

package/src/index.ts

@@ -1,26 +0,0 @@
-/**
- * UI Shell SPI (Service Provider Interface)
- * Extension points and provider interfaces for UI Shell customization
- *
- * Implement these interfaces to customize shell behavior:
- * - Storage providers (localStorage, cookies, etc.)
- * - Theme providers (CSS vars, styled-components, etc.)
- * - Router strategies (history, hash, memory)
- * - Layout templates
- * - Navigation guards
- * - Lifecycle hooks
- */
-
-export const version = '0.2.2';
-
-// Export all providers
-export * from './providers';
-
-// Export all guards
-export * from './guards';
-
-// Export all hooks
-export * from './hooks';
-
-// Export all slots
-export * from './slots';

package/src/providers/IRouterStrategy.ts

@@ -1,41 +0,0 @@
-/**
- * Router Strategy Interface
- * Abstraction for routing strategies (history, hash, memory)
- */
-
-export interface IRouterStrategy {
-  /**
-   * Push a new entry to the history stack
-   */
-  push(path: string): void;
-
-  /**
-   * Replace the current entry in the history stack
-   */
-  replace(path: string): void;
-
-  /**
-   * Go back in history
-   */
-  back(): void;
-
-  /**
-   * Go forward in history
-   */
-  forward(): void;
-
-  /**
-   * Get the current path
-   */
-  getCurrentPath(): string;
-
-  /**
-   * Listen for navigation changes
-   */
-  listen(callback: (path: string) => void): () => void;
-
-  /**
-   * Clean up resources
-   */
-  destroy(): void;
-}

package/src/providers/IStorageProvider.ts

@@ -1,31 +0,0 @@
-/**
- * Storage Provider Interface
- * Abstraction for storage mechanisms (localStorage, sessionStorage, cookies, etc.)
- */
-
-export interface IStorageProvider {
-  /**
-   * Get an item from storage
-   */
-  getItem(key: string): string | null;
-
-  /**
-   * Set an item in storage
-   */
-  setItem(key: string, value: string): void;
-
-  /**
-   * Remove an item from storage
-   */
-  removeItem(key: string): void;
-
-  /**
-   * Clear all items from storage
-   */
-  clear?(): void;
-
-  /**
-   * Check if storage is available
-   */
-  isAvailable(): boolean;
-}

package/src/providers/ITemplateProvider.ts

@@ -1,41 +0,0 @@
-/**
- * Template Provider Interface
- * Extension point for custom layout templates
- */
-
-import type { LayoutSlot } from '@hamak/ui-shell-api';
-
-export interface TemplateOptions {
-  /** Template name/identifier */
-  name: string;
-  /** Template metadata */
-  meta?: Record<string, any>;
-  /** Responsive breakpoints configuration */
-  responsive?: {
-    mobile?: Record<string, any>;
-    tablet?: Record<string, any>;
-    desktop?: Record<string, any>;
-  };
-}
-
-export interface ITemplateProvider {
-  /**
-   * Get template name
-   */
-  getName(): string;
-
-  /**
-   * Get available slot areas for this template
-   */
-  getSlotAreas(): string[];
-
-  /**
-   * Render a slot area
-   */
-  renderSlot(area: string, slots: LayoutSlot[]): any;
-
-  /**
-   * Get template configuration
-   */
-  getConfig(): TemplateOptions;
-}

package/src/providers/IThemeProvider.ts

@@ -1,28 +0,0 @@
-/**
- * Theme Provider Interface
- * Abstraction for theme application strategies (CSS variables, styled-components, etc.)
- */
-
-import type { ThemeMode, ThemeConfig } from '@hamak/ui-shell-api';
-
-export interface IThemeProvider {
-  /**
-   * Apply theme to the UI
-   */
-  applyTheme(mode: ThemeMode, config: ThemeConfig): void;
-
-  /**
-   * Get system theme preference
-   */
-  getSystemPreference(): 'light' | 'dark';
-
-  /**
-   * Listen for system theme changes
-   */
-  onSystemThemeChange(callback: (theme: 'light' | 'dark') => void): () => void;
-
-  /**
-   * Clean up resources
-   */
-  destroy(): void;
-}

package/src/providers/index.ts

@@ -1,9 +0,0 @@
-/**
- * Providers
- * Export all provider interfaces
- */
-
-export * from './IStorageProvider';
-export * from './IThemeProvider';
-export * from './IRouterStrategy';
-export * from './ITemplateProvider';

package/src/slots/LayoutSlotProvider.ts

@@ -1,37 +0,0 @@
-/**
- * Layout Slot Provider
- * Interface for dynamic layout slot registration
- */
-
-import type { LayoutSlot, LayoutArea } from '@hamak/ui-shell-api';
-
-export interface AreaOptions {
-  /** Area name */
-  name: string;
-  /** Display order */
-  order?: number;
-  /** Area metadata */
-  meta?: Record<string, any>;
-}
-
-export interface ILayoutSlotProvider {
-  /**
-   * Register a new layout area dynamically
-   */
-  registerArea(name: string, options?: AreaOptions): () => void;
-
-  /**
-   * Unregister a layout area
-   */
-  unregisterArea(name: string): void;
-
-  /**
-   * Get all registered areas
-   */
-  getRegisteredAreas(): string[];
-
-  /**
-   * Check if an area is registered
-   */
-  isAreaRegistered(name: string): boolean;
-}

package/src/slots/TemplateSlot.ts

@@ -1,40 +0,0 @@
-/**
- * Template Slot
- * Extension point for template customization
- */
-
-import type { LayoutSlot } from '@hamak/ui-shell-api';
-
-export interface TemplateSlotRenderer {
-  /**
-   * Render function for slot content
-   */
-  render(slot: LayoutSlot): any;
-
-  /**
-   * Check if this renderer can handle the slot
-   */
-  canRender(slot: LayoutSlot): boolean;
-
-  /**
-   * Renderer priority (higher = rendered first)
-   */
-  priority?: number;
-}
-
-export interface TemplateSlotExtension {
-  /**
-   * Register a custom slot renderer
-   */
-  registerRenderer(renderer: TemplateSlotRenderer): () => void;
-
-  /**
-   * Get all registered renderers
-   */
-  getRenderers(): TemplateSlotRenderer[];
-
-  /**
-   * Find appropriate renderer for a slot
-   */
-  findRenderer(slot: LayoutSlot): TemplateSlotRenderer | null;
-}

package/src/slots/index.ts

@@ -1,7 +0,0 @@
-/**
- * Slots
- * Export all slot interfaces
- */
-
-export * from './LayoutSlotProvider';
-export * from './TemplateSlot';

package/tsconfig.es2015.json

@@ -1,24 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "target": "ES2015",
-    "lib": [
-      "ES2015",
-      "DOM",
-      "DOM.Iterable"
-    ],
-    "outDir": "dist/es2015",
-    "declaration": false,
-    "declarationMap": false,
-    "sourceMap": false,
-    "downlevelIteration": true,
-    "composite": false
-  },
-  "include": [
-    "src/**/*"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist"
-  ]
-}

package/tsconfig.json

@@ -1,20 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "declaration": true,
-    "declarationMap": true,
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "allowSyntheticDefaultImports": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}