@hamak/ui-shell-spi 0.1.0

package/.turbo/turbo-build.log

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

package/dist/guards/NavigationGuard.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Navigation Guard
+ * Interface for route navigation guards
+ */
+import type { RouteConfig } from '@amk/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>;
+//# sourceMappingURL=NavigationGuard.d.ts.map

package/dist/guards/NavigationGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationGuard.d.ts","sourceRoot":"","sources":["../../src/guards/NavigationGuard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,eAAe,GAAG,CAC5B,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,WAAW,GAAG,IAAI,KACrB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,EAAE,EAAE,WAAW,CAAC;IAChB,iCAAiC;IACjC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzB,uBAAuB;IACvB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,gCAAgC;IAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,OAAO,EAAE,sBAAsB,KAC5B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/guards/NavigationGuard.js

@@ -0,0 +1,5 @@
+/**
+ * Navigation Guard
+ * Interface for route navigation guards
+ */
+export {};

package/dist/guards/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Guards
+ * Export all guard interfaces
+ */
+export * from './NavigationGuard';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guards/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC"}

package/dist/guards/index.js

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

package/dist/hooks/ShellHooks.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Shell Hooks
+ * Lifecycle hooks for shell customization
+ */
+import type { ShellConfig, ShellContext } from '@amk/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>;
+}
+//# sourceMappingURL=ShellHooks.d.ts.map

package/dist/hooks/ShellHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellHooks.d.ts","sourceRoot":"","sources":["../../src/hooks/ShellHooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,UAAU,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD;;OAEG;IACH,SAAS,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;OAEG;IACH,iBAAiB,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnF;;OAEG;IACH,gBAAgB,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD;;OAEG;IACH,mBAAmB,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5F;;OAEG;IACH,kBAAkB,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE;;OAEG;IACH,aAAa,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;;OAEG;IACH,YAAY,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC"}

package/dist/hooks/ShellHooks.js

@@ -0,0 +1,5 @@
+/**
+ * Shell Hooks
+ * Lifecycle hooks for shell customization
+ */
+export {};

package/dist/hooks/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Hooks
+ * Export all hook interfaces
+ */
+export * from './ShellHooks';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,cAAc,CAAC"}

package/dist/hooks/index.js

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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 declare const version = "0.1.0";
+export * from './providers';
+export * from './guards';
+export * from './hooks';
+export * from './slots';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,cAAc,aAAa,CAAC;AAG5B,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * 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.1.0';
+// 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/dist/providers/IRouterStrategy.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=IRouterStrategy.d.ts.map

package/dist/providers/IRouterStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRouterStrategy.d.ts","sourceRoot":"","sources":["../../src/providers/IRouterStrategy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;OAEG;IACH,cAAc,IAAI,MAAM,CAAC;IAEzB;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAErD;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/providers/IRouterStrategy.js

@@ -0,0 +1,5 @@
+/**
+ * Router Strategy Interface
+ * Abstraction for routing strategies (history, hash, memory)
+ */
+export {};

package/dist/providers/IStorageProvider.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=IStorageProvider.d.ts.map

package/dist/providers/IStorageProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IStorageProvider.d.ts","sourceRoot":"","sources":["../../src/providers/IStorageProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1C;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,KAAK,CAAC,IAAI,IAAI,CAAC;IAEf;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;CACxB"}

package/dist/providers/IStorageProvider.js

@@ -0,0 +1,5 @@
+/**
+ * Storage Provider Interface
+ * Abstraction for storage mechanisms (localStorage, sessionStorage, cookies, etc.)
+ */
+export {};

package/dist/providers/ITemplateProvider.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Template Provider Interface
+ * Extension point for custom layout templates
+ */
+import type { LayoutSlot } from '@amk/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;
+}
+//# sourceMappingURL=ITemplateProvider.d.ts.map

package/dist/providers/ITemplateProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITemplateProvider.d.ts","sourceRoot":"","sources":["../../src/providers/ITemplateProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,2CAA2C;IAC3C,UAAU,CAAC,EAAE;QACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC/B,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,IAAI,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC;IAEnD;;OAEG;IACH,SAAS,IAAI,eAAe,CAAC;CAC9B"}

package/dist/providers/ITemplateProvider.js

@@ -0,0 +1,5 @@
+/**
+ * Template Provider Interface
+ * Extension point for custom layout templates
+ */
+export {};

package/dist/providers/IThemeProvider.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Theme Provider Interface
+ * Abstraction for theme application strategies (CSS variables, styled-components, etc.)
+ */
+import type { ThemeMode, ThemeConfig } from '@amk/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;
+}
+//# sourceMappingURL=IThemeProvider.d.ts.map

package/dist/providers/IThemeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IThemeProvider.d.ts","sourceRoot":"","sources":["../../src/providers/IThemeProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAEvD;;OAEG;IACH,mBAAmB,IAAI,OAAO,GAAG,MAAM,CAAC;IAExC;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAE7E;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/providers/IThemeProvider.js

@@ -0,0 +1,5 @@
+/**
+ * Theme Provider Interface
+ * Abstraction for theme application strategies (CSS variables, styled-components, etc.)
+ */
+export {};

package/dist/providers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Providers
+ * Export all provider interfaces
+ */
+export * from './IStorageProvider';
+export * from './IThemeProvider';
+export * from './IRouterStrategy';
+export * from './ITemplateProvider';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/providers/index.js

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

package/dist/slots/LayoutSlotProvider.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Layout Slot Provider
+ * Interface for dynamic layout slot registration
+ */
+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;
+}
+//# sourceMappingURL=LayoutSlotProvider.d.ts.map

package/dist/slots/LayoutSlotProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutSlotProvider.d.ts","sourceRoot":"","sources":["../../src/slots/LayoutSlotProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,IAAI,CAAC;IAE9D;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE,CAAC;IAE/B;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACzC"}

package/dist/slots/LayoutSlotProvider.js

@@ -0,0 +1,5 @@
+/**
+ * Layout Slot Provider
+ * Interface for dynamic layout slot registration
+ */
+export {};

package/dist/slots/TemplateSlot.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Template Slot
+ * Extension point for template customization
+ */
+import type { LayoutSlot } from '@amk/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;
+}
+//# sourceMappingURL=TemplateSlot.d.ts.map

package/dist/slots/TemplateSlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateSlot.d.ts","sourceRoot":"","sources":["../../src/slots/TemplateSlot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,GAAG,CAAC;IAE9B;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAAC;IAE7D;;OAEG;IACH,YAAY,IAAI,oBAAoB,EAAE,CAAC;IAEvC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,oBAAoB,GAAG,IAAI,CAAC;CAC7D"}

package/dist/slots/TemplateSlot.js

@@ -0,0 +1,5 @@
+/**
+ * Template Slot
+ * Extension point for template customization
+ */
+export {};

package/dist/slots/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Slots
+ * Export all slot interfaces
+ */
+export * from './LayoutSlotProvider';
+export * from './TemplateSlot';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/slots/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC"}

package/dist/slots/index.js

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@hamak/ui-shell-spi",
+  "version": "0.1.0",
+  "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,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/amah/app-framework.git",
+    "directory": "packages/ui-shell/ui-shell-spi"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@hamak/ui-shell-api": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "~5.4.0"
+  }
+}

package/src/guards/NavigationGuard.ts

@@ -0,0 +1,26 @@
+/**
+ * Navigation Guard
+ * Interface for route navigation guards
+ */
+
+import type { RouteConfig } from '@amk/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

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

package/src/hooks/ShellHooks.ts

@@ -0,0 +1,48 @@
+/**
+ * Shell Hooks
+ * Lifecycle hooks for shell customization
+ */
+
+import type { ShellConfig, ShellContext } from '@amk/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

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

package/src/index.ts

@@ -0,0 +1,26 @@
+/**
+ * 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.1.0';
+
+// 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

@@ -0,0 +1,41 @@
+/**
+ * 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

@@ -0,0 +1,31 @@
+/**
+ * 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

@@ -0,0 +1,41 @@
+/**
+ * Template Provider Interface
+ * Extension point for custom layout templates
+ */
+
+import type { LayoutSlot } from '@amk/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

@@ -0,0 +1,28 @@
+/**
+ * Theme Provider Interface
+ * Abstraction for theme application strategies (CSS variables, styled-components, etc.)
+ */
+
+import type { ThemeMode, ThemeConfig } from '@amk/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

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

package/src/slots/LayoutSlotProvider.ts

@@ -0,0 +1,37 @@
+/**
+ * Layout Slot Provider
+ * Interface for dynamic layout slot registration
+ */
+
+import type { LayoutSlot, LayoutArea } from '@amk/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

@@ -0,0 +1,40 @@
+/**
+ * Template Slot
+ * Extension point for template customization
+ */
+
+import type { LayoutSlot } from '@amk/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

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

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "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"]
+}