@hamak/ui-shell-api 0.4.6 → 0.4.8

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@hamak/ui-shell-api",
-  "version": "0.4.6",
+  "version": "0.4.8",
   "private": false,
   "type": "module",
   "description": "UI Shell API - Core UI shell interfaces",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "sideEffects": false,
+  "files": [
+    "dist"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/amah/app-framework.git",

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-api",
-  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
-  "sourceRoot": "packages/ui-shell/ui-shell-api/src",
-  "projectType": "library",
-  "targets": {
-    "build": {
-      "executor": "nx:run-commands",
-      "outputs": ["{projectRoot}/dist"],
-      "options": {
-        "command": "tsc -p tsconfig.json && tsc -p tsconfig.es2015.json",
-        "cwd": "{projectRoot}"
-      }
-    },
-    "clean": {
-      "executor": "nx:run-commands",
-      "options": {
-        "command": "rm -rf dist",
-        "cwd": "{projectRoot}"
-      }
-    }
-  },
-  "tags": ["type:library", "scope:ui-shell"]
-}

package/src/api/IFeatureManager.ts

@@ -1,68 +0,0 @@
-/**
- * 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;
-}

package/src/api/ILayoutManager.ts

@@ -1,48 +0,0 @@
-/**
- * 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;
-}

package/src/api/IRouter.ts

@@ -1,48 +0,0 @@
-/**
- * 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;
-}

package/src/api/IShell.ts

@@ -1,66 +0,0 @@
-/**
- * Shell Interface
- * Public API contract for the UI Shell
- */
-
-import type { ShellConfig, ShellContext, ShellEvent, 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;
-}

package/src/api/IThemeManager.ts

@@ -1,43 +0,0 @@
-/**
- * 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;
-}

package/src/api/index.ts

@@ -1,10 +0,0 @@
-/**
- * UI Shell API Interfaces
- * All public interface definitions
- */
-
-export * from './IShell';
-export * from './IThemeManager';
-export * from './IFeatureManager';
-export * from './IRouter';
-export * from './ILayoutManager';

package/src/index.ts

@@ -1,18 +0,0 @@
-/**
- * UI Shell API
- * Public API surface for the UI Shell framework
- *
- * This package contains only type definitions and interfaces.
- * Import implementations from @hamak/ui-shell-impl
- */
-
-export const version = '0.2.2';
-
-// Export all types
-export * from './types';
-
-// Export all API interfaces
-export * from './api';
-
-// Export service tokens
-export * from './tokens';

package/src/tokens/index.ts

@@ -1,6 +0,0 @@
-/**
- * Tokens
- * Export all service tokens
- */
-
-export * from './service-tokens';

package/src/tokens/service-tokens.ts

@@ -1,64 +0,0 @@
-/**
- * Service Tokens
- * Dependency injection tokens for shell services
- */
-
-/**
- * Token for Shell service
- */
-export const SHELL_TOKEN = Symbol('Shell');
-
-/**
- * Token for ThemeManager service
- */
-export const THEME_MANAGER_TOKEN = Symbol('ThemeManager');
-
-/**
- * Token for FeatureManager service
- */
-export const FEATURE_MANAGER_TOKEN = Symbol('FeatureManager');
-
-/**
- * Token for Router service
- */
-export const ROUTER_TOKEN = Symbol('Router');
-
-/**
- * Token for LayoutManager service
- */
-export const LAYOUT_MANAGER_TOKEN = Symbol('LayoutManager');
-
-/**
- * Shell command names
- */
-export const ShellCommands = {
-  SET_THEME: 'shell.setTheme',
-  TOGGLE_THEME: 'shell.toggleTheme',
-  ENABLE_FEATURE: 'shell.enableFeature',
-  DISABLE_FEATURE: 'shell.disableFeature',
-  TOGGLE_FEATURE: 'shell.toggleFeature',
-  NAVIGATE: 'shell.navigate',
-  NAVIGATE_BACK: 'shell.navigateBack',
-} as const;
-
-/**
- * Shell event names
- */
-export const ShellEvents = {
-  READY: 'shell:ready',
-  THEME_CHANGED: 'shell:theme-changed',
-  FEATURE_TOGGLED: 'shell:feature-toggled',
-  ROUTE_CHANGED: 'shell:route-changed',
-  VIEWPORT_RESIZED: 'shell:viewport-resized',
-} as const;
-
-/**
- * Shell view slot names
- */
-export const ShellViewSlots = {
-  HEADER: 'shell.header',
-  SIDEBAR: 'shell.sidebar',
-  MAIN: 'shell.main',
-  FOOTER: 'shell.footer',
-  OVERLAY: 'shell.overlay',
-} as const;

package/src/types/event-types.ts

@@ -1,22 +0,0 @@
-/**
- * Event Types
- * Type definitions for shell events
- */
-
-export type ShellEventType =
-  | 'theme:changed'
-  | 'feature:toggled'
-  | 'route:changed'
-  | 'viewport:resized'
-  | 'shell:ready'
-  | 'shell:error';
-
-export interface ShellEvent {
-  type: string;
-  payload?: any;
-  timestamp: number;
-}
-
-export interface ShellEventListener {
-  (event: ShellEvent): void;
-}

package/src/types/feature-types.ts

@@ -1,34 +0,0 @@
-/**
- * Feature Types
- * Type definitions for feature flag management
- */
-
-export interface FeatureFlags {
-  [key: string]: boolean | string | number | object;
-}
-
-/**
- * Common feature flag definitions
- */
-export const CommonFeatures = {
-  // UI Features
-  DARK_MODE: 'ui.darkMode',
-  SIDEBAR: 'ui.sidebar',
-  MOBILE_NAV: 'ui.mobileNav',
-  BREADCRUMBS: 'ui.breadcrumbs',
-
-  // Experimental Features
-  SSR: 'experimental.ssr',
-  STREAMING: 'experimental.streaming',
-  LAZY_LOADING: 'experimental.lazyLoading',
-
-  // User Features
-  VOICE_MODE: 'user.voiceMode',
-  ADVANCED_COMPOSER: 'user.advancedComposer',
-  UPGRADE_PILLS: 'user.upgradePills',
-
-  // Performance Features
-  REQUEST_RETRY: 'performance.requestRetry',
-  POLLING: 'performance.polling',
-  CACHE: 'performance.cache',
-} as const;

package/src/types/index.ts

@@ -1,11 +0,0 @@
-/**
- * UI Shell API Types
- * All public type definitions
- */
-
-export * from './theme-types';
-export * from './feature-types';
-export * from './route-types';
-export * from './layout-types';
-export * from './event-types';
-export * from './shell-context';

package/src/types/layout-types.ts

@@ -1,33 +0,0 @@
-/**
- * Layout Types
- * Type definitions for layout and responsive design
- */
-
-export type LayoutArea = 'header' | 'sidebar' | 'main' | 'footer' | 'overlay';
-
-export interface LayoutSlot {
-  /** Slot identifier */
-  id: string;
-  /** Slot position/area */
-  area: LayoutArea;
-  /** Slot priority for ordering */
-  priority?: number;
-  /** Optional metadata */
-  meta?: Record<string, any>;
-}
-
-export interface ViewportInfo {
-  width: number;
-  height: number;
-  isMobile: boolean;
-  isTablet: boolean;
-  isDesktop: boolean;
-}
-
-export type BreakpointName = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
-
-export interface Breakpoint {
-  name: BreakpointName;
-  minWidth: number;
-  maxWidth?: number;
-}

package/src/types/route-types.ts

@@ -1,24 +0,0 @@
-/**
- * Route Types
- * Type definitions for routing
- */
-
-export interface RouteConfig {
-  path: string;
-  /** Lazy-loaded component factory */
-  component: () => Promise<any>;
-  /** Route metadata */
-  meta?: Record<string, any>;
-  /** Child routes */
-  children?: RouteConfig[];
-  /** Route guards */
-  beforeEnter?: (to: RouteConfig, from: RouteConfig) => boolean | Promise<boolean>;
-}
-
-export type RouterMode = 'history' | 'hash' | 'memory';
-
-export interface RouterOptions {
-  routes: RouteConfig[];
-  mode?: RouterMode;
-  base?: string;
-}

package/src/types/shell-context.ts

@@ -1,36 +0,0 @@
-/**
- * Shell Context Types
- * Type definitions for shell context
- */
-
-import type { ThemeMode, ThemeConfig } from './theme-types';
-import type { FeatureFlags } from './feature-types';
-import type { ViewportInfo } from './layout-types';
-
-export interface ShellConfig {
-  /** Theme configuration */
-  theme?: ThemeConfig;
-  /** Feature flags and experimental configurations */
-  features?: FeatureFlags;
-  /** Enable server-side rendering */
-  ssr?: boolean;
-  /** Enable streaming rendering */
-  streaming?: boolean;
-  /** Custom shell metadata */
-  metadata?: Record<string, any>;
-}
-
-export interface ShellContext {
-  /** Current theme mode */
-  theme: ThemeMode;
-  /** Set theme mode */
-  setTheme: (mode: ThemeMode) => void;
-  /** Feature flags */
-  features: FeatureFlags;
-  /** Check if a feature is enabled */
-  isFeatureEnabled: (key: string) => boolean;
-  /** Get feature value */
-  getFeature: <T = any>(key: string, defaultValue?: T) => T;
-  /** Current viewport size */
-  viewport: ViewportInfo;
-}

package/src/types/theme-types.ts

@@ -1,14 +0,0 @@
-/**
- * Theme Types
- * Type definitions for theme management
- */
-
-export type ThemeMode = 'light' | 'dark' | 'system';
-
-export interface ThemeConfig {
-  mode: ThemeMode;
-  /** Primary color scheme */
-  primaryColor?: string;
-  /** Custom CSS variables */
-  cssVariables?: Record<string, string>;
-}

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