@hamak/ui-shell-impl 0.4.6 → 0.4.16

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@hamak/ui-shell-impl",
-  "version": "0.4.6",
+  "version": "0.4.16",
   "private": false,
   "type": "module",
   "description": "UI Shell Implementation - Core UI shell functionality",
   "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,10 +35,10 @@
     }
   },
   "dependencies": {
-    "@hamak/ui-shell-api": "0.4.6",
-    "@hamak/ui-shell-spi": "0.4.6",
-    "@hamak/microkernel-api": "0.4.6",
-    "@hamak/microkernel-spi": "0.4.6"
+    "@hamak/ui-shell-api": "*",
+    "@hamak/ui-shell-spi": "*",
+    "@hamak/microkernel-api": "*",
+    "@hamak/microkernel-spi": "*"
   },
   "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-impl",
-  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
-  "sourceRoot": "packages/ui-shell/ui-shell-impl/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/core/DefaultFeatureManager.ts

@@ -1,101 +0,0 @@
-/**
- * Default Feature Manager Implementation
- */
-
-import type { IFeatureManager } from '@hamak/ui-shell-api';
-import type { FeatureFlags } from '@hamak/ui-shell-api';
-
-export class DefaultFeatureManager implements IFeatureManager {
-  private features: FeatureFlags;
-  private listeners: Map<string, Set<(value: any) => void>> = new Map();
-
-  constructor(initialFeatures: FeatureFlags = {}) {
-    this.features = { ...initialFeatures };
-  }
-
-  isEnabled(key: string): boolean {
-    const value = this.features[key];
-    return typeof value === 'boolean' ? value : Boolean(value);
-  }
-
-  get<T = any>(key: string, defaultValue?: T): T {
-    const value = this.features[key];
-    return (value !== undefined ? value : defaultValue) as T;
-  }
-
-  set(key: string, value: any): void {
-    const oldValue = this.features[key];
-    if (oldValue === value) return;
-
-    this.features[key] = value;
-    this.notifyListeners(key, value);
-  }
-
-  enable(key: string): void {
-    this.set(key, true);
-  }
-
-  disable(key: string): void {
-    this.set(key, false);
-  }
-
-  toggle(key: string): void {
-    this.set(key, !this.isEnabled(key));
-  }
-
-  update(updates: FeatureFlags): void {
-    Object.entries(updates).forEach(([key, value]) => {
-      this.set(key, value);
-    });
-  }
-
-  getAll(): Readonly<FeatureFlags> {
-    return { ...this.features };
-  }
-
-  has(key: string): boolean {
-    return key in this.features;
-  }
-
-  subscribe(key: string, listener: (value: any) => void): () => void {
-    if (!this.listeners.has(key)) {
-      this.listeners.set(key, new Set());
-    }
-    this.listeners.get(key)!.add(listener);
-
-    return () => {
-      const listeners = this.listeners.get(key);
-      if (listeners) {
-        listeners.delete(listener);
-        if (listeners.size === 0) {
-          this.listeners.delete(key);
-        }
-      }
-    };
-  }
-
-  subscribeAll(listener: (key: string, value: any) => void): () => void {
-    const unsubscribers: (() => void)[] = [];
-    const currentKeys = Object.keys(this.features);
-
-    currentKeys.forEach(key => {
-      const unsub = this.subscribe(key, value => listener(key, value));
-      unsubscribers.push(unsub);
-    });
-
-    return () => {
-      unsubscribers.forEach(unsub => unsub());
-    };
-  }
-
-  destroy(): void {
-    this.listeners.clear();
-  }
-
-  private notifyListeners(key: string, value: any): void {
-    const listeners = this.listeners.get(key);
-    if (listeners) {
-      listeners.forEach(listener => listener(value));
-    }
-  }
-}

package/src/core/DefaultLayoutManager.ts

@@ -1,74 +0,0 @@
-/**
- * Default Layout Manager Implementation
- */
-
-import type { ILayoutManager } from '@hamak/ui-shell-api';
-import type { LayoutSlot, LayoutArea } from '@hamak/ui-shell-api';
-
-export class DefaultLayoutManager implements ILayoutManager {
-  private slots: Map<string, Set<LayoutSlot>> = new Map();
-  private listeners: Set<() => void> = new Set();
-
-  registerSlot(slot: LayoutSlot): () => void {
-    const area = slot.area;
-    if (!this.slots.has(area)) {
-      this.slots.set(area, new Set());
-    }
-
-    this.slots.get(area)!.add(slot);
-    this.notifyListeners();
-
-    return () => this.unregisterSlot(slot);
-  }
-
-  unregisterSlot(slot: LayoutSlot): void {
-    const area = slot.area;
-    const slots = this.slots.get(area);
-    if (slots) {
-      slots.delete(slot);
-      if (slots.size === 0) {
-        this.slots.delete(area);
-      }
-      this.notifyListeners();
-    }
-  }
-
-  getSlots(area: LayoutArea): LayoutSlot[] {
-    const slots = this.slots.get(area);
-    if (!slots) return [];
-
-    return Array.from(slots).sort((a, b) => {
-      const priorityA = a.priority || 0;
-      const priorityB = b.priority || 0;
-      return priorityB - priorityA; // Higher priority first
-    });
-  }
-
-  getAreas(): LayoutArea[] {
-    return Array.from(this.slots.keys()) as LayoutArea[];
-  }
-
-  hasSlots(area: LayoutArea): boolean {
-    const slots = this.slots.get(area);
-    return Boolean(slots && slots.size > 0);
-  }
-
-  subscribe(listener: () => void): () => void {
-    this.listeners.add(listener);
-    return () => this.listeners.delete(listener);
-  }
-
-  clear(): void {
-    this.slots.clear();
-    this.notifyListeners();
-  }
-
-  destroy(): void {
-    this.slots.clear();
-    this.listeners.clear();
-  }
-
-  private notifyListeners(): void {
-    this.listeners.forEach(listener => listener());
-  }
-}

package/src/core/DefaultRouter.ts

@@ -1,135 +0,0 @@
-/**
- * Default Router Implementation
- */
-
-import type { IRouter } from '@hamak/ui-shell-api';
-import type { RouteConfig, RouterOptions } from '@hamak/ui-shell-api';
-import type { IRouterStrategy } from '@hamak/ui-shell-spi';
-import type { NavigationGuard } from '@hamak/ui-shell-spi';
-
-export class DefaultRouter implements IRouter {
-  private routes: Map<string, RouteConfig> = new Map();
-  private currentRoute: RouteConfig | null = null;
-  private guards: NavigationGuard[] = [];
-  private listeners: Set<(route: RouteConfig) => void> = new Set();
-  private strategy: IRouterStrategy;
-
-  constructor(options: RouterOptions, strategy: IRouterStrategy) {
-    this.strategy = strategy;
-    this.guards = [];
-    this.registerRoutes(options.routes);
-    this.setupNavigationListener();
-  }
-
-  private registerRoutes(routes: RouteConfig[]): void {
-    routes.forEach(route => {
-      this.routes.set(route.path, route);
-      if (route.children) {
-        this.registerRoutes(route.children);
-      }
-    });
-  }
-
-  async push(path: string): Promise<boolean> {
-    const route = this.matchRoute(path);
-    if (!route) {
-      console.error(`Route not found: ${path}`);
-      return false;
-    }
-
-    if (!(await this.runGuards(route))) {
-      return false;
-    }
-
-    if (route.beforeEnter && !(await route.beforeEnter(route, this.currentRoute!))) {
-      return false;
-    }
-
-    this.currentRoute = route;
-    this.strategy.push(path);
-    this.notifyListeners(route);
-    return true;
-  }
-
-  async replace(path: string): Promise<boolean> {
-    const route = this.matchRoute(path);
-    if (!route) {
-      console.error(`Route not found: ${path}`);
-      return false;
-    }
-
-    if (!(await this.runGuards(route))) {
-      return false;
-    }
-
-    this.currentRoute = route;
-    this.strategy.replace(path);
-    this.notifyListeners(route);
-    return true;
-  }
-
-  back(): void {
-    this.strategy.back();
-  }
-
-  forward(): void {
-    this.strategy.forward();
-  }
-
-  getCurrentRoute(): RouteConfig | null {
-    return this.currentRoute;
-  }
-
-  subscribe(listener: (route: RouteConfig) => void): () => void {
-    this.listeners.add(listener);
-    return () => this.listeners.delete(listener);
-  }
-
-  async loadRouteComponent(route: RouteConfig): Promise<any> {
-    try {
-      const component = await route.component();
-      return component;
-    } catch (error) {
-      console.error(`Failed to load route component for ${route.path}:`, error);
-      throw error;
-    }
-  }
-
-  addGuard(guard: NavigationGuard): () => void {
-    this.guards.push(guard);
-    return () => {
-      const index = this.guards.indexOf(guard);
-      if (index > -1) {
-        this.guards.splice(index, 1);
-      }
-    };
-  }
-
-  destroy(): void {
-    this.strategy.destroy();
-    this.listeners.clear();
-    this.guards = [];
-  }
-
-  private matchRoute(path: string): RouteConfig | null {
-    return this.routes.get(path) || null;
-  }
-
-  private async runGuards(to: RouteConfig): Promise<boolean> {
-    for (const guard of this.guards) {
-      const result = await guard(to, this.currentRoute);
-      if (!result) return false;
-    }
-    return true;
-  }
-
-  private setupNavigationListener(): void {
-    this.strategy.listen((path) => {
-      this.push(path);
-    });
-  }
-
-  private notifyListeners(route: RouteConfig): void {
-    this.listeners.forEach(listener => listener(route));
-  }
-}

package/src/core/DefaultShell.ts

@@ -1,176 +0,0 @@
-/**
- * Default Shell Implementation
- */
-
-import type { IShell, IThemeManager, IFeatureManager, IRouter } from '@hamak/ui-shell-api';
-import type { ShellConfig, ShellContext, ShellEvent, ShellEventListener, ShellEventType } from '@hamak/ui-shell-api';
-import { DefaultThemeManager } from './DefaultThemeManager';
-import { DefaultFeatureManager } from './DefaultFeatureManager';
-import { LocalStorageProvider } from '../providers/LocalStorageProvider';
-import { CSSVariablesThemeProvider } from '../providers/CSSVariablesThemeProvider';
-
-export class DefaultShell implements IShell {
-  private themeManager: IThemeManager;
-  private featureManager: IFeatureManager;
-  private router: IRouter | null = null;
-  private eventListeners: Map<string, Set<ShellEventListener>> = new Map();
-  private viewportState = {
-    width: typeof window !== 'undefined' ? window.innerWidth : 0,
-    height: typeof window !== 'undefined' ? window.innerHeight : 0,
-  };
-  private config: ShellConfig;
-  private isReady = false;
-
-  constructor(config: ShellConfig = {}) {
-    this.config = config;
-
-    // Create theme manager with providers
-    const storageProvider = new LocalStorageProvider();
-    const themeProvider = new CSSVariablesThemeProvider();
-    this.themeManager = new DefaultThemeManager(config.theme, storageProvider, themeProvider);
-
-    // Create feature manager
-    this.featureManager = new DefaultFeatureManager(config.features);
-
-    this.setupViewportListener();
-  }
-
-  async initialize(): Promise<void> {
-    if (this.isReady) {
-      console.warn('Shell is already initialized');
-      return;
-    }
-
-    // Apply initial theme
-    this.themeManager.setTheme(this.themeManager.getTheme());
-
-    // Subscribe to theme changes
-    this.themeManager.subscribe(theme => {
-      this.emit('theme:changed', { theme });
-    });
-
-    // Subscribe to feature changes
-    this.featureManager.subscribeAll((key, value) => {
-      this.emit('feature:toggled', { key, value });
-    });
-
-    this.isReady = true;
-    this.emit('shell:ready', {});
-  }
-
-  getContext(): ShellContext {
-    return {
-      theme: this.themeManager.getTheme(),
-      setTheme: (mode) => this.themeManager.setTheme(mode),
-      features: this.featureManager.getAll(),
-      isFeatureEnabled: (key) => this.featureManager.isEnabled(key),
-      getFeature: (key, defaultValue) => this.featureManager.get(key, defaultValue),
-      viewport: {
-        width: this.viewportState.width,
-        height: this.viewportState.height,
-        isMobile: this.viewportState.width < 768,
-        isTablet: this.viewportState.width >= 768 && this.viewportState.width < 1024,
-        isDesktop: this.viewportState.width >= 1024,
-      },
-    };
-  }
-
-  getThemeManager(): IThemeManager {
-    return this.themeManager;
-  }
-
-  getFeatureManager(): IFeatureManager {
-    return this.featureManager;
-  }
-
-  getRouter(): IRouter | null {
-    return this.router;
-  }
-
-  setRouter(router: IRouter): void {
-    this.router = router;
-    this.router.subscribe(route => {
-      this.emit('route:changed', { route });
-    });
-  }
-
-  emit(type: ShellEventType, payload?: any): void {
-    const event: ShellEvent = {
-      type,
-      payload,
-      timestamp: Date.now(),
-    };
-
-    const listeners = this.eventListeners.get(type);
-    if (listeners) {
-      listeners.forEach(listener => listener(event));
-    }
-
-    const wildcardListeners = this.eventListeners.get('*');
-    if (wildcardListeners) {
-      wildcardListeners.forEach(listener => listener(event));
-    }
-  }
-
-  on(type: ShellEventType | '*', listener: ShellEventListener): () => void {
-    if (!this.eventListeners.has(type)) {
-      this.eventListeners.set(type, new Set());
-    }
-    this.eventListeners.get(type)!.add(listener);
-
-    return () => {
-      const listeners = this.eventListeners.get(type);
-      if (listeners) {
-        listeners.delete(listener);
-        if (listeners.size === 0) {
-          this.eventListeners.delete(type);
-        }
-      }
-    };
-  }
-
-  off(type: ShellEventType | '*', listener: ShellEventListener): void {
-    const listeners = this.eventListeners.get(type);
-    if (listeners) {
-      listeners.delete(listener);
-    }
-  }
-
-  ready(): boolean {
-    return this.isReady;
-  }
-
-  getConfig(): Readonly<ShellConfig> {
-    return { ...this.config };
-  }
-
-  destroy(): void {
-    this.themeManager.destroy();
-    this.featureManager.destroy();
-    if (this.router) {
-      this.router.destroy();
-    }
-    if (typeof window !== 'undefined') {
-      window.removeEventListener('resize', this.handleResize);
-    }
-    this.eventListeners.clear();
-    this.isReady = false;
-  }
-
-  private setupViewportListener(): void {
-    if (typeof window === 'undefined') return;
-    window.addEventListener('resize', this.handleResize);
-  }
-
-  private handleResize = (): void => {
-    if (typeof window === 'undefined') return;
-
-    this.viewportState.width = window.innerWidth;
-    this.viewportState.height = window.innerHeight;
-
-    this.emit('viewport:resized', {
-      width: this.viewportState.width,
-      height: this.viewportState.height,
-    });
-  };
-}

package/src/core/DefaultThemeManager.ts

@@ -1,99 +0,0 @@
-/**
- * Default Theme Manager Implementation
- */
-
-import type { IThemeManager } from '@hamak/ui-shell-api';
-import type { ThemeMode, ThemeConfig } from '@hamak/ui-shell-api';
-import type { IStorageProvider, IThemeProvider } from '@hamak/ui-shell-spi';
-
-const THEME_STORAGE_KEY = 'ui-shell-theme';
-
-export class DefaultThemeManager implements IThemeManager {
-  private currentTheme: ThemeMode = 'system';
-  private config: ThemeConfig;
-  private listeners: Set<(theme: ThemeMode) => void> = new Set();
-  private storageProvider: IStorageProvider;
-  private themeProvider: IThemeProvider;
-
-  constructor(
-    config: ThemeConfig = { mode: 'system' },
-    storageProvider: IStorageProvider,
-    themeProvider: IThemeProvider
-  ) {
-    this.config = config;
-    this.storageProvider = storageProvider;
-    this.themeProvider = themeProvider;
-    this.currentTheme = config.mode || this.loadPersistedTheme();
-    this.setupSystemThemeListener();
-    this.applyTheme();
-  }
-
-  getTheme(): ThemeMode {
-    return this.currentTheme;
-  }
-
-  getResolvedTheme(): 'light' | 'dark' {
-    if (this.currentTheme === 'system') {
-      return this.themeProvider.getSystemPreference();
-    }
-    return this.currentTheme;
-  }
-
-  setTheme(mode: ThemeMode): void {
-    if (this.currentTheme === mode) return;
-
-    this.currentTheme = mode;
-    this.persistTheme(mode);
-    this.applyTheme();
-    this.notifyListeners();
-  }
-
-  toggleTheme(): void {
-    const resolved = this.getResolvedTheme();
-    this.setTheme(resolved === 'light' ? 'dark' : 'light');
-  }
-
-  subscribe(listener: (theme: ThemeMode) => void): () => void {
-    this.listeners.add(listener);
-    return () => this.listeners.delete(listener);
-  }
-
-  setCSSVariables(variables: Record<string, string>): void {
-    this.config.cssVariables = { ...this.config.cssVariables, ...variables };
-    this.applyTheme();
-  }
-
-  destroy(): void {
-    this.themeProvider.destroy();
-    this.listeners.clear();
-  }
-
-  private setupSystemThemeListener(): void {
-    this.themeProvider.onSystemThemeChange(() => {
-      if (this.currentTheme === 'system') {
-        this.applyTheme();
-        this.notifyListeners();
-      }
-    });
-  }
-
-  private applyTheme(): void {
-    this.themeProvider.applyTheme(this.currentTheme, this.config);
-  }
-
-  private loadPersistedTheme(): ThemeMode {
-    const stored = this.storageProvider.getItem(THEME_STORAGE_KEY);
-    if (stored === 'light' || stored === 'dark' || stored === 'system') {
-      return stored;
-    }
-    return 'system';
-  }
-
-  private persistTheme(mode: ThemeMode): void {
-    this.storageProvider.setItem(THEME_STORAGE_KEY, mode);
-  }
-
-  private notifyListeners(): void {
-    this.listeners.forEach(listener => listener(this.currentTheme));
-  }
-}

package/src/core/index.ts

@@ -1,10 +0,0 @@
-/**
- * Core Implementations
- * Export all core implementation classes
- */
-
-export * from './DefaultShell';
-export * from './DefaultThemeManager';
-export * from './DefaultFeatureManager';
-export * from './DefaultLayoutManager';
-export * from './DefaultRouter';

package/src/index.ts

@@ -1,51 +0,0 @@
-/**
- * UI Shell Implementation
- * Concrete implementations of UI Shell interfaces
- *
- * This package provides default implementations that can be used directly
- * or extended for custom behavior.
- */
-
-export const version = '0.2.2';
-
-// Export core implementations
-export * from './core';
-
-// Export providers
-export * from './providers';
-
-// Export utilities
-export * from './utils';
-
-// Export plugin integration
-export * from './plugin';
-
-// Factory functions
-import { DefaultShell } from './core/DefaultShell';
-import { DefaultLayoutManager } from './core/DefaultLayoutManager';
-import type { ShellConfig } from '@hamak/ui-shell-api';
-
-export function createShell(config?: ShellConfig): DefaultShell {
-  return new DefaultShell(config);
-}
-
-export function createLayoutManager(): DefaultLayoutManager {
-  return new DefaultLayoutManager();
-}
-
-// Singleton pattern support
-let globalShell: DefaultShell | null = null;
-
-export function getShell(config?: ShellConfig): DefaultShell {
-  if (!globalShell) {
-    globalShell = createShell(config);
-  }
-  return globalShell;
-}
-
-export function resetShell(): void {
-  if (globalShell) {
-    globalShell.destroy();
-    globalShell = null;
-  }
-}

package/src/plugin/ShellPluginFactory.ts

@@ -1,98 +0,0 @@
-/**
- * Shell Plugin Factory
- * Creates microkernel plugin for UI Shell integration
- */
-
-import type { PluginModule } from '@hamak/microkernel-spi';
-import type { ActivateContext } from '@hamak/microkernel-api';
-import type { ShellConfig } from '@hamak/ui-shell-api';
-import {
-  SHELL_TOKEN,
-  THEME_MANAGER_TOKEN,
-  FEATURE_MANAGER_TOKEN,
-  LAYOUT_MANAGER_TOKEN,
-  ShellCommands,
-  ShellEvents,
-} from '@hamak/ui-shell-api';
-import { DefaultShell } from '../core/DefaultShell';
-import { DefaultLayoutManager } from '../core/DefaultLayoutManager';
-
-export function createShellPlugin(config?: ShellConfig): PluginModule {
-  let shell: DefaultShell;
-  let layoutManager: DefaultLayoutManager;
-
-  return {
-    initialize(ctx) {
-      shell = new DefaultShell(config);
-      layoutManager = new DefaultLayoutManager();
-
-      // Provide shell services
-      ctx.provide({ provide: SHELL_TOKEN, useValue: shell });
-      ctx.provide({ provide: THEME_MANAGER_TOKEN, useValue: shell.getThemeManager() });
-      ctx.provide({ provide: FEATURE_MANAGER_TOKEN, useValue: shell.getFeatureManager() });
-      ctx.provide({ provide: LAYOUT_MANAGER_TOKEN, useValue: layoutManager });
-
-      // Register commands
-      ctx.commands.register(ShellCommands.SET_THEME, (mode: 'light' | 'dark' | 'system') => {
-        shell.getThemeManager().setTheme(mode);
-      });
-
-      ctx.commands.register(ShellCommands.TOGGLE_THEME, () => {
-        shell.getThemeManager().toggleTheme();
-      });
-
-      ctx.commands.register(ShellCommands.ENABLE_FEATURE, (key: string) => {
-        shell.getFeatureManager().enable(key);
-      });
-
-      ctx.commands.register(ShellCommands.DISABLE_FEATURE, (key: string) => {
-        shell.getFeatureManager().disable(key);
-      });
-
-      ctx.commands.register(ShellCommands.TOGGLE_FEATURE, (key: string) => {
-        shell.getFeatureManager().toggle(key);
-      });
-
-      ctx.commands.register(ShellCommands.NAVIGATE, (path: string) => {
-        const router = shell.getRouter();
-        if (!router) {
-          console.warn('Router not initialized');
-          return;
-        }
-        return router.push(path);
-      });
-
-      ctx.commands.register(ShellCommands.NAVIGATE_BACK, () => {
-        const router = shell.getRouter();
-        if (!router) {
-          console.warn('Router not initialized');
-          return;
-        }
-        router.back();
-      });
-
-      // Forward shell events to microkernel hooks
-      shell.on('shell:ready', () => ctx.hooks.emit(ShellEvents.READY, {}));
-      shell.on('theme:changed', (event) => ctx.hooks.emit(ShellEvents.THEME_CHANGED, event.payload));
-      shell.on('feature:toggled', (event) => ctx.hooks.emit(ShellEvents.FEATURE_TOGGLED, event.payload));
-      shell.on('route:changed', (event) => ctx.hooks.emit(ShellEvents.ROUTE_CHANGED, event.payload));
-      shell.on('viewport:resized', (event) => ctx.hooks.emit(ShellEvents.VIEWPORT_RESIZED, event.payload));
-    },
-
-    async activate(ctx: ActivateContext) {
-      await shell.initialize();
-      const shellContext = shell.getContext();
-      ctx.hooks.emit('shell:activated', { context: shellContext });
-    },
-
-    deactivate() {
-      shell.destroy();
-      layoutManager.destroy();
-    },
-  };
-}
-
-// Helper functions
-export function getShellFromContext(ctx: ActivateContext): DefaultShell {
-  return ctx.resolve<DefaultShell>(SHELL_TOKEN);
-}

package/src/plugin/index.ts

@@ -1,6 +0,0 @@
-/**
- * Plugin Integration
- * Export plugin factory and helpers
- */
-
-export * from './ShellPluginFactory';

package/src/providers/CSSVariablesThemeProvider.ts

@@ -1,60 +0,0 @@
-/**
- * CSS Variables Theme Provider
- * Implements theming using CSS custom properties
- */
-
-import type { IThemeProvider } from '@hamak/ui-shell-spi';
-import type { ThemeMode, ThemeConfig } from '@hamak/ui-shell-api';
-
-export class CSSVariablesThemeProvider implements IThemeProvider {
-  private mediaQuery?: MediaQueryList;
-  private listeners: Set<(theme: 'light' | 'dark') => void> = new Set();
-
-  applyTheme(mode: ThemeMode, config: ThemeConfig): void {
-    if (typeof document === 'undefined') return;
-
-    const resolved = mode === 'system' ? this.getSystemPreference() : mode;
-
-    document.documentElement.setAttribute('data-theme', resolved);
-    document.documentElement.style.colorScheme = resolved;
-
-    // Apply custom CSS variables
-    if (config.cssVariables) {
-      Object.entries(config.cssVariables).forEach(([key, value]) => {
-        document.documentElement.style.setProperty(key, value);
-      });
-    }
-  }
-
-  getSystemPreference(): 'light' | 'dark' {
-    if (typeof window === 'undefined') return 'light';
-    return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
-  }
-
-  onSystemThemeChange(callback: (theme: 'light' | 'dark') => void): () => void {
-    if (typeof window === 'undefined') {
-      return () => {};
-    }
-
-    this.listeners.add(callback);
-
-    if (!this.mediaQuery) {
-      this.mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
-      this.mediaQuery.addEventListener('change', this.handleMediaQueryChange);
-    }
-
-    return () => {
-      this.listeners.delete(callback);
-    };
-  }
-
-  destroy(): void {
-    this.mediaQuery?.removeEventListener('change', this.handleMediaQueryChange);
-    this.listeners.clear();
-  }
-
-  private handleMediaQueryChange = (): void => {
-    const theme = this.getSystemPreference();
-    this.listeners.forEach(listener => listener(theme));
-  };
-}

package/src/providers/HashRouterStrategy.ts

@@ -1,71 +0,0 @@
-/**
- * Hash Router Strategy
- * Uses URL hash for routing
- */
-
-import type { IRouterStrategy } from '@hamak/ui-shell-spi';
-
-export class HashRouterStrategy implements IRouterStrategy {
-  private listeners: Set<(path: string) => void> = new Set();
-
-  constructor() {
-    this.setupListener();
-  }
-
-  push(path: string): void {
-    if (typeof window === 'undefined') return;
-
-    window.location.hash = path;
-  }
-
-  replace(path: string): void {
-    if (typeof window === 'undefined') return;
-
-    window.location.replace(`#${path}`);
-  }
-
-  back(): void {
-    if (typeof window !== 'undefined') {
-      window.history.back();
-    }
-  }
-
-  forward(): void {
-    if (typeof window !== 'undefined') {
-      window.history.forward();
-    }
-  }
-
-  getCurrentPath(): string {
-    if (typeof window === 'undefined') return '/';
-
-    return window.location.hash.slice(1) || '/';
-  }
-
-  listen(callback: (path: string) => void): () => void {
-    this.listeners.add(callback);
-    return () => this.listeners.delete(callback);
-  }
-
-  destroy(): void {
-    if (typeof window !== 'undefined') {
-      window.removeEventListener('hashchange', this.handleHashChange);
-    }
-    this.listeners.clear();
-  }
-
-  private setupListener(): void {
-    if (typeof window !== 'undefined') {
-      window.addEventListener('hashchange', this.handleHashChange);
-    }
-  }
-
-  private handleHashChange = (): void => {
-    const path = this.getCurrentPath();
-    this.notifyListeners(path);
-  };
-
-  private notifyListeners(path: string): void {
-    this.listeners.forEach(listener => listener(path));
-  }
-}

package/src/providers/HistoryRouterStrategy.ts

@@ -1,78 +0,0 @@
-/**
- * History Router Strategy
- * Uses browser History API for routing
- */
-
-import type { IRouterStrategy } from '@hamak/ui-shell-spi';
-
-export class HistoryRouterStrategy implements IRouterStrategy {
-  private base: string;
-  private listeners: Set<(path: string) => void> = new Set();
-
-  constructor(base: string = '/') {
-    this.base = base;
-    this.setupListener();
-  }
-
-  push(path: string): void {
-    if (typeof window === 'undefined') return;
-
-    const fullPath = this.base + path;
-    window.history.pushState({}, '', fullPath);
-    this.notifyListeners(path);
-  }
-
-  replace(path: string): void {
-    if (typeof window === 'undefined') return;
-
-    const fullPath = this.base + path;
-    window.history.replaceState({}, '', fullPath);
-    this.notifyListeners(path);
-  }
-
-  back(): void {
-    if (typeof window !== 'undefined') {
-      window.history.back();
-    }
-  }
-
-  forward(): void {
-    if (typeof window !== 'undefined') {
-      window.history.forward();
-    }
-  }
-
-  getCurrentPath(): string {
-    if (typeof window === 'undefined') return '/';
-
-    const path = window.location.pathname;
-    return path.startsWith(this.base) ? path.slice(this.base.length) : path;
-  }
-
-  listen(callback: (path: string) => void): () => void {
-    this.listeners.add(callback);
-    return () => this.listeners.delete(callback);
-  }
-
-  destroy(): void {
-    if (typeof window !== 'undefined') {
-      window.removeEventListener('popstate', this.handlePopState);
-    }
-    this.listeners.clear();
-  }
-
-  private setupListener(): void {
-    if (typeof window !== 'undefined') {
-      window.addEventListener('popstate', this.handlePopState);
-    }
-  }
-
-  private handlePopState = (): void => {
-    const path = this.getCurrentPath();
-    this.notifyListeners(path);
-  };
-
-  private notifyListeners(path: string): void {
-    this.listeners.forEach(listener => listener(path));
-  }
-}

package/src/providers/LocalStorageProvider.ts

@@ -1,53 +0,0 @@
-/**
- * LocalStorage Provider
- * Implementation using browser localStorage
- */
-
-import type { IStorageProvider } from '@hamak/ui-shell-spi';
-
-export class LocalStorageProvider implements IStorageProvider {
-  getItem(key: string): string | null {
-    if (!this.isAvailable()) return null;
-
-    try {
-      return localStorage.getItem(key);
-    } catch (e) {
-      console.warn('Failed to get item from localStorage:', e);
-      return null;
-    }
-  }
-
-  setItem(key: string, value: string): void {
-    if (!this.isAvailable()) return;
-
-    try {
-      localStorage.setItem(key, value);
-    } catch (e) {
-      console.warn('Failed to set item in localStorage:', e);
-    }
-  }
-
-  removeItem(key: string): void {
-    if (!this.isAvailable()) return;
-
-    try {
-      localStorage.removeItem(key);
-    } catch (e) {
-      console.warn('Failed to remove item from localStorage:', e);
-    }
-  }
-
-  clear(): void {
-    if (!this.isAvailable()) return;
-
-    try {
-      localStorage.clear();
-    } catch (e) {
-      console.warn('Failed to clear localStorage:', e);
-    }
-  }
-
-  isAvailable(): boolean {
-    return typeof localStorage !== 'undefined';
-  }
-}

package/src/providers/MemoryStorageProvider.ts

@@ -1,30 +0,0 @@
-/**
- * Memory Storage Provider
- * In-memory storage for SSR or testing
- */
-
-import type { IStorageProvider } from '@hamak/ui-shell-spi';
-
-export class MemoryStorageProvider implements IStorageProvider {
-  private storage: Map<string, string> = new Map();
-
-  getItem(key: string): string | null {
-    return this.storage.get(key) || null;
-  }
-
-  setItem(key: string, value: string): void {
-    this.storage.set(key, value);
-  }
-
-  removeItem(key: string): void {
-    this.storage.delete(key);
-  }
-
-  clear(): void {
-    this.storage.clear();
-  }
-
-  isAvailable(): boolean {
-    return true;
-  }
-}

package/src/providers/index.ts

@@ -1,10 +0,0 @@
-/**
- * Providers
- * Export all provider implementations
- */
-
-export * from './LocalStorageProvider';
-export * from './MemoryStorageProvider';
-export * from './CSSVariablesThemeProvider';
-export * from './HistoryRouterStrategy';
-export * from './HashRouterStrategy';

package/src/utils/index.ts

@@ -1,6 +0,0 @@
-/**
- * Utilities
- * Export all utility classes
- */
-
-export * from './viewport-utils';

package/src/utils/viewport-utils.ts

@@ -1,64 +0,0 @@
-/**
- * Viewport Utilities
- */
-
-import type { BreakpointName, Breakpoint } from '@hamak/ui-shell-api';
-
-export const BREAKPOINTS: Record<BreakpointName, Breakpoint> = {
-  xs: { name: 'xs', minWidth: 0, maxWidth: 639 },
-  sm: { name: 'sm', minWidth: 640, maxWidth: 767 },
-  md: { name: 'md', minWidth: 768, maxWidth: 1023 },
-  lg: { name: 'lg', minWidth: 1024, maxWidth: 1279 },
-  xl: { name: 'xl', minWidth: 1280, maxWidth: 1535 },
-  '2xl': { name: '2xl', minWidth: 1536 },
-};
-
-export class ViewportUtils {
-  static getCurrentBreakpoint(): BreakpointName {
-    if (typeof window === 'undefined') return 'md';
-
-    const width = window.innerWidth;
-
-    for (const [name, breakpoint] of Object.entries(BREAKPOINTS)) {
-      if (width >= breakpoint.minWidth && (!breakpoint.maxWidth || width <= breakpoint.maxWidth)) {
-        return name as BreakpointName;
-      }
-    }
-
-    return 'md';
-  }
-
-  static matchesBreakpoint(breakpoint: BreakpointName): boolean {
-    if (typeof window === 'undefined') return false;
-
-    const width = window.innerWidth;
-    const bp = BREAKPOINTS[breakpoint];
-
-    return width >= bp.minWidth && (!bp.maxWidth || width <= bp.maxWidth);
-  }
-
-  static isMinBreakpoint(breakpoint: BreakpointName): boolean {
-    if (typeof window === 'undefined') return false;
-
-    const width = window.innerWidth;
-    const bp = BREAKPOINTS[breakpoint];
-
-    return width >= bp.minWidth;
-  }
-
-  static getDimensions(): { width: number; height: number } {
-    if (typeof window === 'undefined') {
-      return { width: 0, height: 0 };
-    }
-
-    return {
-      width: window.innerWidth,
-      height: window.innerHeight,
-    };
-  }
-
-  static isTouchDevice(): boolean {
-    if (typeof window === 'undefined') return false;
-    return 'ontouchstart' in window || navigator.maxTouchPoints > 0;
-  }
-}

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"]
-}