@hamak/ui-shell 0.5.1

package/README.md

@@ -0,0 +1,414 @@
+# UI Shell
+
+A comprehensive application shell framework providing theme management, feature flags, routing, and layout orchestration for microkernel-based applications.
+
+## Package Structure
+
+This is a monorepo package containing four sub-packages following the API-SPI-IMPL pattern:
+
+- **[@hamak/ui-shell-api](./ui-shell-api)** - Type definitions, interfaces, and service tokens
+- **[@hamak/ui-shell-spi](./ui-shell-spi)** - Service Provider Interfaces for extensibility
+- **[@hamak/ui-shell-impl](./ui-shell-impl)** - Concrete implementations of all services
+- **[@hamak/ui-shell-templates](./ui-shell-templates)** - React templates, components, and hooks
+
+## Features
+
+### Theme Management
+- **Dynamic theme switching** between light, dark, and system modes
+- **LocalStorage persistence** for user preferences
+- **System preference detection** with automatic fallback
+- **Custom CSS variables** support
+- **Event-driven** theme change notifications
+
+### Feature Configuration
+- **Feature flags** for enabling/disabling functionality
+- **Type-safe** feature access with generic types
+- **Subscribe to feature changes** with fine-grained listeners
+- **Bulk feature updates** for configuration management
+- Includes **common feature definitions** for quick setup
+
+### Router Integration
+- **Lazy loading** support for route components
+- **Navigation guards** for route protection
+- **History and hash modes** for different deployment scenarios
+- **Route metadata** for custom data attachment
+- **Event-driven** navigation updates
+
+### Layout Management
+- **Slot-based layout system** with priority ordering
+- **Responsive breakpoints** (xs, sm, md, lg, xl, 2xl)
+- **Viewport utilities** for responsive behavior
+- **CSS Grid layouts** with pre-built templates
+- **Touch detection** and device pixel ratio utilities
+
+### Microkernel Integration
+- **Plugin module** for seamless microkernel integration
+- **Dependency injection** tokens for all services
+- **Command registration** for shell operations
+- **Event forwarding** to microkernel hooks
+- **Service providers** for easy consumption
+
+## Installation
+
+```bash
+# Install the packages you need
+bun add @hamak/ui-shell-api @hamak/ui-shell-impl @hamak/ui-shell-templates
+```
+
+## Usage
+
+### Basic Shell Setup
+
+```typescript
+import { createShellPlugin } from '@hamak/ui-shell-impl';
+
+const shellPlugin = createShellPlugin({
+  theme: {
+    mode: 'system', // 'light' | 'dark' | 'system'
+    cssVariables: {
+      '--primary-color': '#007bff',
+    },
+  },
+  features: {
+    'ui.sidebar': true,
+    'experimental.ssr': false,
+  },
+});
+
+// Register with your microkernel
+kernel.registerPlugin(shellPlugin);
+```
+
+### Theme Management
+
+```typescript
+import { SHELL_TOKEN } from '@hamak/ui-shell-api';
+import type { IShell } from '@hamak/ui-shell-api';
+
+// In your plugin or component
+const shell = context.resolve<IShell>(SHELL_TOKEN);
+const themeManager = shell.getThemeManager();
+
+// Set theme
+themeManager.setTheme('dark');
+
+// Toggle theme
+themeManager.toggleTheme();
+
+// Subscribe to changes
+themeManager.subscribe((theme) => {
+  console.log('Theme changed to:', theme);
+});
+
+// Get resolved theme (converts 'system' to actual theme)
+const resolvedTheme = themeManager.getResolvedTheme(); // 'light' | 'dark'
+```
+
+### Feature Flags
+
+```typescript
+const featureManager = shell.getFeatureManager();
+
+// Check if enabled
+if (featureManager.isEnabled('ui.sidebar')) {
+  // Show sidebar
+}
+
+// Get feature value
+const pollingInterval = featureManager.get('performance.polling', 5000);
+
+// Toggle feature
+featureManager.toggle('experimental.ssr');
+
+// Subscribe to changes
+featureManager.subscribe('ui.sidebar', (enabled) => {
+  console.log('Sidebar:', enabled ? 'enabled' : 'disabled');
+});
+```
+
+### Router Setup
+
+```typescript
+import { SHELL_TOKEN } from '@hamak/ui-shell-api';
+
+const shell = context.resolve(SHELL_TOKEN);
+const router = shell.setupRouter({
+  mode: 'history',
+  routes: [
+    {
+      path: '/',
+      component: () => import('./pages/Home'),
+    },
+    {
+      path: '/about',
+      component: () => import('./pages/About'),
+      meta: { title: 'About Us' },
+    },
+    {
+      path: '/dashboard',
+      component: () => import('./pages/Dashboard'),
+      beforeEnter: (to, from) => {
+        // Route guard logic
+        return isAuthenticated();
+      },
+    },
+  ],
+});
+
+// Navigate
+await router.push('/about');
+
+// Subscribe to route changes
+router.subscribe((route) => {
+  console.log('Navigated to:', route.path);
+});
+```
+
+### Layout Management
+
+```typescript
+import { SHELL_TOKEN } from '@hamak/ui-shell-api';
+
+const shell = context.resolve(SHELL_TOKEN);
+const layoutManager = shell.getLayoutManager();
+
+// Register slots
+layoutManager.registerSlot({
+  id: 'main-nav',
+  area: 'header',
+  priority: 10,
+});
+
+// Get slots for an area
+const headerSlots = layoutManager.getSlots('header');
+
+// Responsive utilities
+if (ViewportUtils.isMinBreakpoint('md')) {
+  // Desktop layout
+} else {
+  // Mobile layout
+}
+
+const currentBreakpoint = ViewportUtils.getCurrentBreakpoint();
+```
+
+### Microkernel Plugin Integration
+
+```typescript
+import { createShellPlugin } from '@hamak/ui-shell-impl';
+import { CommonFeatures } from '@hamak/ui-shell-api';
+
+export const shellPlugin = createShellPlugin({
+  theme: { mode: 'system' },
+  features: {
+    'ui.sidebar': true,
+  },
+});
+
+// In your plugin
+export function initialize(ctx) {
+  // Access shell services
+  const shell = ctx.resolve(SHELL_TOKEN);
+
+  // Subscribe to theme changes
+  shell.getThemeManager().subscribe((theme) => {
+    console.log('Theme changed:', theme);
+  });
+}
+
+export function activate(ctx) {
+  // Access shell services
+  const shell = ctx.resolve(SHELL_TOKEN);
+  shell.getThemeManager().setTheme('dark');
+}
+```
+
+### Using React Templates
+
+```typescript
+import { ShellProvider, DashboardLayout } from '@hamak/ui-shell-templates';
+import { useTheme, useFeatures } from '@hamak/ui-shell-templates/hooks';
+
+// Wrap your app with ShellProvider
+function App() {
+  return (
+    <ShellProvider>
+      <DashboardLayout />
+    </ShellProvider>
+  );
+}
+
+// Use hooks in your components
+function MyComponent() {
+  const { theme, setTheme } = useTheme();
+  const { isEnabled } = useFeatures();
+
+  return (
+    <div>
+      <button onClick={() => setTheme('dark')}>Dark Mode</button>
+      {isEnabled('ui.sidebar') && <Sidebar />}
+    </div>
+  );
+}
+```
+
+### Shell Context
+
+```typescript
+import { SHELL_TOKEN } from '@hamak/ui-shell-api';
+
+const shell = context.resolve(SHELL_TOKEN);
+const shellContext = shell.getContext();
+
+// Access current theme
+console.log('Current theme:', shellContext.theme);
+
+// Set theme
+shellContext.setTheme('dark');
+
+// Check features
+if (shellContext.isFeatureEnabled('ui.sidebar')) {
+  // ...
+}
+
+// Responsive info
+if (shellContext.viewport.isMobile) {
+  // Mobile UI
+} else if (shellContext.viewport.isDesktop) {
+  // Desktop UI
+}
+```
+
+### Shell Events
+
+```typescript
+// Subscribe to events
+shell.on('theme:changed', (event) => {
+  console.log('Theme changed:', event.payload);
+});
+
+shell.on('viewport:resized', (event) => {
+  console.log('Viewport:', event.payload.width, 'x', event.payload.height);
+});
+
+shell.on('route:changed', (event) => {
+  console.log('Navigated to:', event.payload.route.path);
+});
+
+// Listen to all events
+shell.on('*', (event) => {
+  console.log('Event:', event.type, event.payload);
+});
+```
+
+## API Reference
+
+### Shell
+
+Main orchestrator for the UI shell.
+
+**Methods:**
+- `initialize()` - Initialize the shell
+- `setupRouter(options)` - Setup router with routes
+- `getRouter()` - Get router instance
+- `getThemeManager()` - Get theme manager
+- `getFeatureManager()` - Get feature manager
+- `getContext()` - Get shell context for consumers
+- `on(type, listener)` - Subscribe to events
+- `emit(type, payload)` - Emit events
+- `destroy()` - Clean up resources
+
+### ThemeManager
+
+Handles theme switching and persistence.
+
+**Methods:**
+- `getTheme()` - Get current theme mode
+- `getResolvedTheme()` - Get resolved theme (light/dark)
+- `setTheme(mode)` - Set theme mode
+- `toggleTheme()` - Toggle between light and dark
+- `subscribe(listener)` - Subscribe to changes
+- `setCSSVariables(vars)` - Set custom CSS variables
+
+### FeatureManager
+
+Manages feature flags and configurations.
+
+**Methods:**
+- `isEnabled(key)` - Check if feature is enabled
+- `get(key, defaultValue)` - Get feature value
+- `set(key, value)` - Set feature value
+- `enable(key)` - Enable feature
+- `disable(key)` - Disable feature
+- `toggle(key)` - Toggle feature
+- `subscribe(key, listener)` - Subscribe to feature changes
+
+### Router
+
+Handles client-side routing with lazy loading.
+
+**Methods:**
+- `push(path)` - Navigate to path
+- `replace(path)` - Replace current route
+- `back()` - Go back
+- `forward()` - Go forward
+- `getCurrentRoute()` - Get current route
+- `subscribe(listener)` - Subscribe to route changes
+- `addGuard(guard)` - Add navigation guard
+
+### LayoutManager
+
+Manages layout slots and areas.
+
+**Methods:**
+- `registerSlot(slot)` - Register a layout slot
+- `unregisterSlot(slot)` - Unregister a slot
+- `getSlots(area)` - Get slots for area
+- `getAreas()` - Get all registered areas
+- `hasSlots(area)` - Check if area has slots
+
+## Architecture
+
+The UI Shell is designed to integrate seamlessly with the microkernel architecture:
+
+1. **Core Services**: Theme, Features, Router, Layout
+2. **Plugin Integration**: Provides services via DI tokens
+3. **Event System**: Forwards events to microkernel hooks
+4. **Commands**: Registers shell commands for cross-plugin use
+5. **Context API**: Provides reactive access to shell state
+
+## Common Patterns
+
+### Responsive Layouts
+
+```typescript
+import { useViewport } from '@hamak/ui-shell-templates/hooks';
+
+// In React components
+function MyComponent() {
+  const { isMobile, isDesktop, breakpoint } = useViewport();
+
+  return isMobile ? <MobileLayout /> : <DesktopLayout />;
+}
+```
+
+### Feature Gating
+
+```typescript
+import { CommonFeatures } from '@hamak/ui-shell-api';
+import { useFeatures } from '@hamak/ui-shell-templates/hooks';
+
+function MyComponent() {
+  const { isEnabled } = useFeatures();
+
+  return (
+    <div>
+      {isEnabled(CommonFeatures.VOICE_MODE) && <VoiceInput />}
+    </div>
+  );
+}
+```
+
+## License
+
+MIT

package/dist/api/api/IFeatureManager.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Feature Manager Interface
+ * Public API contract for feature flag management
+ */
+import type { FeatureFlags } from '../types';
+export interface IFeatureManager {
+    /**
+     * Check if a feature is enabled (boolean features)
+     */
+    isEnabled(key: string): boolean;
+    /**
+     * Get a feature value with optional default
+     */
+    get<T = any>(key: string, defaultValue?: T): T;
+    /**
+     * Set a feature value
+     */
+    set(key: string, value: any): void;
+    /**
+     * Enable a feature (set to true)
+     */
+    enable(key: string): void;
+    /**
+     * Disable a feature (set to false)
+     */
+    disable(key: string): void;
+    /**
+     * Toggle a boolean feature
+     */
+    toggle(key: string): void;
+    /**
+     * Update multiple features at once
+     */
+    update(updates: FeatureFlags): void;
+    /**
+     * Get all features
+     */
+    getAll(): Readonly<FeatureFlags>;
+    /**
+     * Check if a feature exists
+     */
+    has(key: string): boolean;
+    /**
+     * Subscribe to feature changes
+     */
+    subscribe(key: string, listener: (value: any) => void): () => void;
+    /**
+     * Subscribe to all feature changes
+     */
+    subscribeAll(listener: (key: string, value: any) => void): () => void;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=IFeatureManager.d.ts.map

package/dist/api/api/IFeatureManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFeatureManager.d.ts","sourceRoot":"","sources":["../../../src/api/api/IFeatureManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAEhC;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAE/C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IAEnC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,MAAM,IAAI,QAAQ,CAAC,YAAY,CAAC,CAAC;IAEjC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAEnE;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAEtE;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/api/api/IFeatureManager.js

@@ -0,0 +1,5 @@
+/**
+ * Feature Manager Interface
+ * Public API contract for feature flag management
+ */
+export {};

package/dist/api/api/ILayoutManager.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Layout Manager Interface
+ * Public API contract for layout management
+ */
+import type { LayoutSlot, LayoutArea } from '../types';
+export interface ILayoutManager {
+    /**
+     * Register a layout slot
+     */
+    registerSlot(slot: LayoutSlot): () => void;
+    /**
+     * Unregister a layout slot
+     */
+    unregisterSlot(slot: LayoutSlot): void;
+    /**
+     * Get all slots for an area
+     */
+    getSlots(area: LayoutArea): LayoutSlot[];
+    /**
+     * Get all registered areas
+     */
+    getAreas(): LayoutArea[];
+    /**
+     * Check if an area has any slots
+     */
+    hasSlots(area: LayoutArea): boolean;
+    /**
+     * Subscribe to layout changes
+     */
+    subscribe(listener: () => void): () => void;
+    /**
+     * Clear all slots
+     */
+    clear(): void;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=ILayoutManager.d.ts.map

package/dist/api/api/ILayoutManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILayoutManager.d.ts","sourceRoot":"","sources":["../../../src/api/api/ILayoutManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,IAAI,CAAC;IAE3C;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC;IAEzC;;OAEG;IACH,QAAQ,IAAI,UAAU,EAAE,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAEpC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAE5C;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/api/api/ILayoutManager.js

@@ -0,0 +1,5 @@
+/**
+ * Layout Manager Interface
+ * Public API contract for layout management
+ */
+export {};

package/dist/api/api/IRouter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Router Interface
+ * Public API contract for routing
+ */
+import type { RouteConfig } from '../types';
+export interface IRouter {
+    /**
+     * Navigate to a path
+     */
+    push(path: string): Promise<boolean>;
+    /**
+     * Replace current route
+     */
+    replace(path: string): Promise<boolean>;
+    /**
+     * Go back in history
+     */
+    back(): void;
+    /**
+     * Go forward in history
+     */
+    forward(): void;
+    /**
+     * Get current route
+     */
+    getCurrentRoute(): RouteConfig | null;
+    /**
+     * Subscribe to route changes
+     */
+    subscribe(listener: (route: RouteConfig) => void): () => void;
+    /**
+     * Load a route component (lazy loading)
+     */
+    loadRouteComponent(route: RouteConfig): Promise<any>;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=IRouter.d.ts.map

package/dist/api/api/IRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRouter.d.ts","sourceRoot":"","sources":["../../../src/api/api/IRouter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExC;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;OAEG;IACH,eAAe,IAAI,WAAW,GAAG,IAAI,CAAC;IAEtC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAE9D;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAErD;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/api/api/IRouter.js

@@ -0,0 +1,5 @@
+/**
+ * Router Interface
+ * Public API contract for routing
+ */
+export {};

package/dist/api/api/IShell.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Shell Interface
+ * Public API contract for the UI Shell
+ */
+import type { ShellConfig, ShellContext, ShellEventListener, ShellEventType } from '../types';
+import type { IThemeManager } from './IThemeManager';
+import type { IFeatureManager } from './IFeatureManager';
+import type { IRouter } from './IRouter';
+export interface IShell {
+    /**
+     * Initialize the shell
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get shell context for consumers
+     */
+    getContext(): ShellContext;
+    /**
+     * Get theme manager
+     */
+    getThemeManager(): IThemeManager;
+    /**
+     * Get feature manager
+     */
+    getFeatureManager(): IFeatureManager;
+    /**
+     * Get router instance
+     */
+    getRouter(): IRouter | null;
+    /**
+     * Emit a shell event
+     */
+    emit(type: ShellEventType, payload?: any): void;
+    /**
+     * Subscribe to shell events
+     */
+    on(type: ShellEventType | '*', listener: ShellEventListener): () => void;
+    /**
+     * Unsubscribe from shell events
+     */
+    off(type: ShellEventType | '*', listener: ShellEventListener): void;
+    /**
+     * Check if shell is ready
+     */
+    ready(): boolean;
+    /**
+     * Get configuration
+     */
+    getConfig(): Readonly<ShellConfig>;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=IShell.d.ts.map

package/dist/api/api/IShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IShell.d.ts","sourceRoot":"","sources":["../../../src/api/api/IShell.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC9F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,UAAU,IAAI,YAAY,CAAC;IAE3B;;OAEG;IACH,eAAe,IAAI,aAAa,CAAC;IAEjC;;OAEG;IACH,iBAAiB,IAAI,eAAe,CAAC;IAErC;;OAEG;IACH,SAAS,IAAI,OAAO,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IAEhD;;OAEG;IACH,EAAE,CAAC,IAAI,EAAE,cAAc,GAAG,GAAG,EAAE,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAAC;IAEzE;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,GAAG,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAEpE;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC;IAEjB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,WAAW,CAAC,CAAC;IAEnC;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/api/api/IShell.js

@@ -0,0 +1,5 @@
+/**
+ * Shell Interface
+ * Public API contract for the UI Shell
+ */
+export {};

package/dist/api/api/IThemeManager.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Theme Manager Interface
+ * Public API contract for theme management
+ */
+import type { ThemeMode } from '../types';
+export interface IThemeManager {
+    /**
+     * Get the current theme mode
+     */
+    getTheme(): ThemeMode;
+    /**
+     * Get the resolved theme (converts 'system' to actual theme)
+     */
+    getResolvedTheme(): 'light' | 'dark';
+    /**
+     * Set the theme mode
+     */
+    setTheme(mode: ThemeMode): void;
+    /**
+     * Toggle between light and dark themes
+     */
+    toggleTheme(): void;
+    /**
+     * Subscribe to theme changes
+     */
+    subscribe(listener: (theme: ThemeMode) => void): () => void;
+    /**
+     * Apply custom CSS variables
+     */
+    setCSSVariables(variables: Record<string, string>): void;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=IThemeManager.d.ts.map

package/dist/api/api/IThemeManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IThemeManager.d.ts","sourceRoot":"","sources":["../../../src/api/api/IThemeManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,IAAI,SAAS,CAAC;IAEtB;;OAEG;IACH,gBAAgB,IAAI,OAAO,GAAG,MAAM,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAEhC;;OAEG;IACH,WAAW,IAAI,IAAI,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAE5D;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/api/api/IThemeManager.js

@@ -0,0 +1,5 @@
+/**
+ * Theme Manager Interface
+ * Public API contract for theme management
+ */
+export {};