@hai3/screensets 0.2.0-alpha.0

package/CLAUDE.md

@@ -0,0 +1,135 @@
+# @hai3/screensets
+
+Pure TypeScript contracts and registry for HAI3 screenset management.
+
+## SDK Layer
+
+This package is part of the **SDK Layer (L1)** - it has **ZERO dependencies** and can be used independently. It contains only TypeScript types and a simple registry implementation.
+
+## What This Package Contains
+
+| Export | Description |
+|--------|-------------|
+| `screensetRegistry` | Singleton registry for screenset registration |
+| `LayoutDomain` | Enum of layout domains (header, footer, menu, etc.) |
+| `ScreensetCategory` | Enum for three-stage workflow (Drafts, Mockups, Production) |
+| `ScreensetDefinition` | Complete screenset configuration type |
+| `MenuItemConfig` | Menu item structure type |
+| `ScreenLoader` | Lazy screen loader function type |
+
+## What This Package Does NOT Contain
+
+- **NO translation types** - Use `@hai3/i18n` for translation types
+- **NO Redux slices** - Layout state management is in `@hai3/framework`
+- **NO selectors** - State selectors are in `@hai3/framework`
+- **NO dependencies** - Pure TypeScript, zero runtime dependencies
+
+## Screenset Registry
+
+The registry is a pure storage implementation (~20 lines, Map wrapper) with no side effects:
+
+```typescript
+import { screensetRegistry, ScreensetDefinition, ScreensetCategory } from '@hai3/screensets';
+
+const myScreenset: ScreensetDefinition = {
+  id: 'myApp',
+  name: 'My Application',
+  category: ScreensetCategory.Production,
+  defaultScreen: 'home',
+  menu: [
+    { menuItem: { id: 'home', label: 'Home' }, screen: () => import('./HomeScreen') }
+  ]
+};
+
+// Register
+screensetRegistry.register(myScreenset);
+
+// Query
+screensetRegistry.get('myApp');      // ScreensetDefinition | undefined
+screensetRegistry.getAll();          // ScreensetDefinition[]
+screensetRegistry.has('myApp');      // boolean
+```
+
+## Translations
+
+Screensets register translations directly with `i18nRegistry` from `@hai3/framework`:
+
+```typescript
+import { i18nRegistry, I18nRegistry, Language } from '@hai3/framework';
+import { SCREENSET_ID } from './ids';
+
+// Register translations (not on screenset config)
+i18nRegistry.registerLoader(
+  `screenset.${SCREENSET_ID}`,
+  I18nRegistry.createLoader({
+    [Language.English]: () => import('./i18n/en.json'),
+    [Language.Spanish]: () => import('./i18n/es.json'),
+    // ... all 36 languages
+  })
+);
+```
+
+## Layout Domains
+
+HAI3 defines 7 layout domains that screensets can use:
+
+| Domain | Description |
+|--------|-------------|
+| `header` | Top navigation bar |
+| `footer` | Bottom bar |
+| `menu` | Side navigation menu |
+| `sidebar` | Collapsible side panel |
+| `screen` | Main content area |
+| `popup` | Modal dialogs |
+| `overlay` | Full-screen overlays |
+
+```typescript
+import { LayoutDomain } from '@hai3/screensets';
+
+// Use in screenset configuration
+const visibleDomains = [LayoutDomain.Header, LayoutDomain.Menu, LayoutDomain.Screen];
+```
+
+## Screenset Definition
+
+Complete definition of a screenset:
+
+```typescript
+import {
+  ScreensetDefinition,
+  ScreensetCategory,
+  MenuScreenItem
+} from '@hai3/screensets';
+
+const demoScreenset: ScreensetDefinition = {
+  id: 'demo',                          // Unique identifier
+  name: 'Demo Screenset',              // Display name
+  category: ScreensetCategory.Drafts,  // Workflow stage
+  defaultScreen: 'home',               // Default screen to show
+  menu: [                              // Menu items with screens
+    { menuItem: homeMenuItem, screen: () => import('./HomeScreen') }
+  ]
+};
+```
+
+**Note:** Translations are registered separately via `i18nRegistry`, not on the screenset definition.
+
+## Key Rules
+
+1. **This package is contracts only** - No business logic, no state management
+2. **ZERO dependencies** - Keep it pure TypeScript, no @hai3 inter-dependencies
+3. **Registry is pure storage** - No side effects, just a Map wrapper
+4. **Use for screenset definitions** - Import types to define your screensets
+5. **Translations via i18n** - Screensets register translations directly with `i18nRegistry`
+6. **Import layout state from @hai3/framework** - HeaderState, MenuState, selectors are there
+
+## Package Relationship
+
+```
+@hai3/screensets (SDK L1)           @hai3/framework (L2)
+├── Contracts (types)        ──>    ├── Re-exports contracts
+├── screensetRegistry        ──>    ├── Re-exports registry
+└── ZERO dependencies               ├── Layout state shapes
+                                    ├── Layout slices
+                                    └── i18nRegistry (from @hai3/i18n)
+```

package/dist/index.cjs

@@ -0,0 +1,85 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  LayoutDomain: () => LayoutDomain,
+  ScreensetCategory: () => ScreensetCategory,
+  createScreensetRegistry: () => createScreensetRegistry,
+  screensetRegistry: () => screensetRegistry
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/registry.ts
+function createScreensetRegistry() {
+  const screensets = /* @__PURE__ */ new Map();
+  return {
+    register(screenset) {
+      screensets.set(screenset.id, screenset);
+    },
+    registerMany(configs) {
+      for (const config of configs) {
+        screensets.set(config.id, config);
+      }
+    },
+    get(id) {
+      return screensets.get(id);
+    },
+    getAll() {
+      return Array.from(screensets.values());
+    },
+    has(id) {
+      return screensets.has(id);
+    },
+    unregister(id) {
+      return screensets.delete(id);
+    },
+    clear() {
+      screensets.clear();
+    }
+  };
+}
+var screensetRegistry = createScreensetRegistry();
+
+// src/types.ts
+var LayoutDomain = /* @__PURE__ */ ((LayoutDomain2) => {
+  LayoutDomain2["Header"] = "header";
+  LayoutDomain2["Footer"] = "footer";
+  LayoutDomain2["Menu"] = "menu";
+  LayoutDomain2["Sidebar"] = "sidebar";
+  LayoutDomain2["Screen"] = "screen";
+  LayoutDomain2["Popup"] = "popup";
+  LayoutDomain2["Overlay"] = "overlay";
+  return LayoutDomain2;
+})(LayoutDomain || {});
+var ScreensetCategory = /* @__PURE__ */ ((ScreensetCategory2) => {
+  ScreensetCategory2["Drafts"] = "drafts";
+  ScreensetCategory2["Mockups"] = "mockups";
+  ScreensetCategory2["Production"] = "production";
+  return ScreensetCategory2;
+})(ScreensetCategory || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LayoutDomain,
+  ScreensetCategory,
+  createScreensetRegistry,
+  screensetRegistry
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/registry.ts","../src/types.ts"],"sourcesContent":["/**\n * @hai3/screensets\n *\n * Pure TypeScript contracts and registry for HAI3 screenset management.\n * This package has ZERO dependencies - SDK Layer (L1).\n *\n * Screensets are HAI3's first-class citizen - self-contained vertical slices\n * that can be composed into applications or injected into external platforms.\n *\n * NOTE: Translations are NOT part of this package. Use @hai3/i18n for translations.\n * Screensets register translations directly with i18nRegistry via framework.\n *\n * @example\n * ```typescript\n * import {\n *   screensetRegistry,\n *   ScreensetDefinition,\n *   ScreensetCategory,\n *   LayoutDomain,\n * } from '@hai3/screensets';\n *\n * const myScreenset: ScreensetDefinition = {\n *   id: 'myApp',\n *   name: 'My Application',\n *   category: ScreensetCategory.Production,\n *   defaultScreen: 'home',\n *   menu: [\n *     { menuItem: homeMenuItem, screen: () => import('./HomeScreen') }\n *   ]\n * };\n *\n * screensetRegistry.register(myScreenset);\n * ```\n */\n\n// ============================================================================\n// Registry\n// ============================================================================\n\nexport { screensetRegistry, createScreensetRegistry } from './registry';\n\n// ============================================================================\n// Types and Contracts\n// ============================================================================\n\nexport {\n  // Enums\n  LayoutDomain,\n  ScreensetCategory,\n\n  // Branded types\n  type ScreensetId,\n  type ScreenId,\n\n  // Configuration interfaces\n  type MenuItemConfig,\n  type ScreenLoader,\n  type ScreenConfig,\n  type MenuScreenItem,\n  type ScreensetDefinition,\n\n  // Registry interface\n  type ScreensetRegistry,\n} from './types';\n","/**\n * @hai3/screensets - Screenset Registry\n *\n * Pure storage implementation for screenset registration.\n * This is a simple Map wrapper with no side effects.\n * ~20 lines of implementation - minimal and focused.\n *\n * NOTE: i18n wiring happens in @hai3/framework when it re-exports this registry.\n */\n\nimport type { ScreensetDefinition, ScreensetRegistry } from './types';\n\n/**\n * Create a new screenset registry instance.\n * This is a pure storage implementation with no dependencies.\n */\nfunction createScreensetRegistry(): ScreensetRegistry {\n  const screensets = new Map<string, ScreensetDefinition>();\n\n  return {\n    register(screenset: ScreensetDefinition): void {\n      screensets.set(screenset.id, screenset);\n    },\n\n    registerMany(configs: ScreensetDefinition[]): void {\n      for (const config of configs) {\n        screensets.set(config.id, config);\n      }\n    },\n\n    get(id: string): ScreensetDefinition | undefined {\n      return screensets.get(id);\n    },\n\n    getAll(): ScreensetDefinition[] {\n      return Array.from(screensets.values());\n    },\n\n    has(id: string): boolean {\n      return screensets.has(id);\n    },\n\n    unregister(id: string): boolean {\n      return screensets.delete(id);\n    },\n\n    clear(): void {\n      screensets.clear();\n    },\n  };\n}\n\n/**\n * Singleton screenset registry instance.\n * Use this for screenset registration throughout the application.\n *\n * @example\n * ```typescript\n * import { screensetRegistry } from '@hai3/screensets';\n *\n * // Register a screenset\n * screensetRegistry.register(myScreenset);\n *\n * // Get all screensets\n * const all = screensetRegistry.getAll();\n * ```\n */\nexport const screensetRegistry: ScreensetRegistry = createScreensetRegistry();\n\n// Also export the factory for testing purposes\nexport { createScreensetRegistry };\n","/**\n * @hai3/screensets - Type Definitions\n *\n * Pure TypeScript contracts for HAI3 screenset management.\n * This package has ZERO dependencies - pure types and contracts only.\n *\n * NOTE: Layout state shapes (HeaderState, MenuState, etc.) are in @hai3/framework\n */\n\nimport type { ComponentType } from 'react';\n\n// ============================================================================\n// Layout Domain Enum\n// ============================================================================\n\n/**\n * Layout Domain Enum\n * Defines all layout domains that can be orchestrated.\n */\nexport enum LayoutDomain {\n  Header = 'header',\n  Footer = 'footer',\n  Menu = 'menu',\n  Sidebar = 'sidebar',\n  Screen = 'screen',\n  Popup = 'popup',\n  Overlay = 'overlay',\n}\n\n// ============================================================================\n// Branded Types for Type Safety\n// ============================================================================\n\n/**\n * Branded type for Screenset IDs\n * Provides compile-time safety for screenset identification.\n *\n * @example\n * ```typescript\n * const chatScreensetId = 'chat' as ScreensetId;\n * const demoScreensetId = 'demo' as ScreensetId;\n * ```\n */\nexport type ScreensetId = string & { readonly __brand: 'ScreensetId' };\n\n/**\n * Branded type for Screen IDs\n * Provides compile-time safety for screen identification.\n *\n * @example\n * ```typescript\n * const homeScreenId = 'home' as ScreenId;\n * const profileScreenId = 'profile' as ScreenId;\n * ```\n */\nexport type ScreenId = string & { readonly __brand: 'ScreenId' };\n\n// ============================================================================\n// Screenset Category\n// ============================================================================\n\n/**\n * Screenset Category Enum\n * Defines the three-stage development workflow categories.\n */\nexport enum ScreensetCategory {\n  /** AI-generated initial layouts */\n  Drafts = 'drafts',\n  /** Designer-refined versions */\n  Mockups = 'mockups',\n  /** Engineer-finalized, production-ready screens */\n  Production = 'production',\n}\n\n// ============================================================================\n// Menu Item Configuration\n// ============================================================================\n\n/**\n * Menu Item Configuration\n * Defines the structure of a menu item.\n *\n * @example\n * ```typescript\n * const menuItem: MenuItemConfig = {\n *   id: 'dashboard',\n *   label: 'screen.dashboard:title',  // Translation key\n *   icon: 'dashboard:home',           // Icon ID\n *   screenId: 'dashboard',\n * };\n * ```\n */\nexport interface MenuItemConfig {\n  /** Unique identifier for the menu item */\n  id: string;\n  /** Translation key for the label */\n  label: string;\n  /** Icon identifier (format: screensetId:iconName) */\n  icon?: string;\n  /** Screen ID to navigate to on click */\n  screenId?: string;\n  /** External URL (mutually exclusive with screenId) */\n  href?: string;\n  /** Click handler (for custom actions) */\n  onClick?: () => void;\n  /** Child menu items for nested menus */\n  children?: MenuItemConfig[];\n  /** Badge content (string or number) */\n  badge?: string | number;\n}\n\n// ============================================================================\n// Screen Configuration\n// ============================================================================\n\n/**\n * Screen Loader Function Type\n * Returns a Promise resolving to a module with a default React component.\n *\n * @example\n * ```typescript\n * const loader: ScreenLoader = () => import('./screens/HomeScreen');\n * ```\n */\nexport type ScreenLoader = () => Promise<{ default: ComponentType }>;\n\n/**\n * Screen Configuration\n * Defines the structure of a screen.\n *\n * @example\n * ```typescript\n * const screen: ScreenConfig = {\n *   id: 'home',\n *   loader: () => import('./screens/HomeScreen'),\n * };\n * ```\n */\nexport interface ScreenConfig {\n  /** Unique identifier for the screen */\n  id: string;\n  /** Lazy loader function for the screen component */\n  loader: ScreenLoader;\n}\n\n// ============================================================================\n// Screenset Definition\n// ============================================================================\n\n/**\n * Menu Screen Item\n * Combines menu item config with its screen loader.\n */\nexport interface MenuScreenItem {\n  /** Menu item configuration */\n  menuItem: MenuItemConfig;\n  /** Screen loader function */\n  screen: ScreenLoader;\n}\n\n/**\n * Screenset Definition\n * Complete definition of a screenset including screens and menu.\n *\n * NOTE: Translations are NOT part of screenset definition.\n * Screensets register translations directly with i18nRegistry via framework.\n *\n * @example\n * ```typescript\n * const demoScreenset: ScreensetDefinition = {\n *   id: 'demo',\n *   name: 'Demo Screenset',\n *   category: ScreensetCategory.Drafts,\n *   defaultScreen: 'home',\n *   menu: [\n *     { menuItem: homeMenuItem, screen: () => import('./screens/HomeScreen') },\n *   ],\n * };\n * ```\n */\nexport interface ScreensetDefinition {\n  /** Unique identifier for the screenset */\n  id: string;\n  /** Display name for the screenset */\n  name: string;\n  /** Category (drafts, mockups, production) */\n  category: ScreensetCategory;\n  /** Default screen ID to show when screenset is selected */\n  defaultScreen: string;\n  /** Menu items with their associated screens */\n  menu: MenuScreenItem[];\n}\n\n// ============================================================================\n// Screenset Registry Interface\n// ============================================================================\n\n/**\n * Screenset Registry Interface\n * Pure storage interface for screenset registration.\n * Implementation is a simple Map wrapper with no side effects.\n */\nexport interface ScreensetRegistry {\n  /** Register a screenset */\n  register(screenset: ScreensetDefinition): void;\n  /** Get a screenset by ID */\n  get(id: string): ScreensetDefinition | undefined;\n  /** Register multiple screensets at once */\n  registerMany(configs: ScreensetDefinition[]): void;\n  /** Get all registered screensets */\n  getAll(): ScreensetDefinition[];\n  /** Check if a screenset is registered */\n  has(id: string): boolean;\n  /** Unregister a screenset */\n  unregister(id: string): boolean;\n  /** Clear all screensets (useful for testing) */\n  clear(): void;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACgBA,SAAS,0BAA6C;AACpD,QAAM,aAAa,oBAAI,IAAiC;AAExD,SAAO;AAAA,IACL,SAAS,WAAsC;AAC7C,iBAAW,IAAI,UAAU,IAAI,SAAS;AAAA,IACxC;AAAA,IAEA,aAAa,SAAsC;AACjD,iBAAW,UAAU,SAAS;AAC5B,mBAAW,IAAI,OAAO,IAAI,MAAM;AAAA,MAClC;AAAA,IACF;AAAA,IAEA,IAAI,IAA6C;AAC/C,aAAO,WAAW,IAAI,EAAE;AAAA,IAC1B;AAAA,IAEA,SAAgC;AAC9B,aAAO,MAAM,KAAK,WAAW,OAAO,CAAC;AAAA,IACvC;AAAA,IAEA,IAAI,IAAqB;AACvB,aAAO,WAAW,IAAI,EAAE;AAAA,IAC1B;AAAA,IAEA,WAAW,IAAqB;AAC9B,aAAO,WAAW,OAAO,EAAE;AAAA,IAC7B;AAAA,IAEA,QAAc;AACZ,iBAAW,MAAM;AAAA,IACnB;AAAA,EACF;AACF;AAiBO,IAAM,oBAAuC,wBAAwB;;;AChDrE,IAAK,eAAL,kBAAKA,kBAAL;AACL,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,UAAO;AACP,EAAAA,cAAA,aAAU;AACV,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,aAAU;AAPA,SAAAA;AAAA,GAAA;AA8CL,IAAK,oBAAL,kBAAKC,uBAAL;AAEL,EAAAA,mBAAA,YAAS;AAET,EAAAA,mBAAA,aAAU;AAEV,EAAAA,mBAAA,gBAAa;AANH,SAAAA;AAAA,GAAA;","names":["LayoutDomain","ScreensetCategory"]}

package/dist/index.d.cts

@@ -0,0 +1,37 @@
+import { ScreensetRegistry } from './types.cjs';
+export { LayoutDomain, MenuItemConfig, MenuScreenItem, ScreenConfig, ScreenId, ScreenLoader, ScreensetCategory, ScreensetDefinition, ScreensetId } from './types.cjs';
+import 'react';
+
+/**
+ * @hai3/screensets - Screenset Registry
+ *
+ * Pure storage implementation for screenset registration.
+ * This is a simple Map wrapper with no side effects.
+ * ~20 lines of implementation - minimal and focused.
+ *
+ * NOTE: i18n wiring happens in @hai3/framework when it re-exports this registry.
+ */
+
+/**
+ * Create a new screenset registry instance.
+ * This is a pure storage implementation with no dependencies.
+ */
+declare function createScreensetRegistry(): ScreensetRegistry;
+/**
+ * Singleton screenset registry instance.
+ * Use this for screenset registration throughout the application.
+ *
+ * @example
+ * ```typescript
+ * import { screensetRegistry } from '@hai3/screensets';
+ *
+ * // Register a screenset
+ * screensetRegistry.register(myScreenset);
+ *
+ * // Get all screensets
+ * const all = screensetRegistry.getAll();
+ * ```
+ */
+declare const screensetRegistry: ScreensetRegistry;
+
+export { ScreensetRegistry, createScreensetRegistry, screensetRegistry };

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import { ScreensetRegistry } from './types.js';
+export { LayoutDomain, MenuItemConfig, MenuScreenItem, ScreenConfig, ScreenId, ScreenLoader, ScreensetCategory, ScreensetDefinition, ScreensetId } from './types.js';
+import 'react';
+
+/**
+ * @hai3/screensets - Screenset Registry
+ *
+ * Pure storage implementation for screenset registration.
+ * This is a simple Map wrapper with no side effects.
+ * ~20 lines of implementation - minimal and focused.
+ *
+ * NOTE: i18n wiring happens in @hai3/framework when it re-exports this registry.
+ */
+
+/**
+ * Create a new screenset registry instance.
+ * This is a pure storage implementation with no dependencies.
+ */
+declare function createScreensetRegistry(): ScreensetRegistry;
+/**
+ * Singleton screenset registry instance.
+ * Use this for screenset registration throughout the application.
+ *
+ * @example
+ * ```typescript
+ * import { screensetRegistry } from '@hai3/screensets';
+ *
+ * // Register a screenset
+ * screensetRegistry.register(myScreenset);
+ *
+ * // Get all screensets
+ * const all = screensetRegistry.getAll();
+ * ```
+ */
+declare const screensetRegistry: ScreensetRegistry;
+
+export { ScreensetRegistry, createScreensetRegistry, screensetRegistry };

package/dist/index.js

@@ -0,0 +1,55 @@
+// src/registry.ts
+function createScreensetRegistry() {
+  const screensets = /* @__PURE__ */ new Map();
+  return {
+    register(screenset) {
+      screensets.set(screenset.id, screenset);
+    },
+    registerMany(configs) {
+      for (const config of configs) {
+        screensets.set(config.id, config);
+      }
+    },
+    get(id) {
+      return screensets.get(id);
+    },
+    getAll() {
+      return Array.from(screensets.values());
+    },
+    has(id) {
+      return screensets.has(id);
+    },
+    unregister(id) {
+      return screensets.delete(id);
+    },
+    clear() {
+      screensets.clear();
+    }
+  };
+}
+var screensetRegistry = createScreensetRegistry();
+
+// src/types.ts
+var LayoutDomain = /* @__PURE__ */ ((LayoutDomain2) => {
+  LayoutDomain2["Header"] = "header";
+  LayoutDomain2["Footer"] = "footer";
+  LayoutDomain2["Menu"] = "menu";
+  LayoutDomain2["Sidebar"] = "sidebar";
+  LayoutDomain2["Screen"] = "screen";
+  LayoutDomain2["Popup"] = "popup";
+  LayoutDomain2["Overlay"] = "overlay";
+  return LayoutDomain2;
+})(LayoutDomain || {});
+var ScreensetCategory = /* @__PURE__ */ ((ScreensetCategory2) => {
+  ScreensetCategory2["Drafts"] = "drafts";
+  ScreensetCategory2["Mockups"] = "mockups";
+  ScreensetCategory2["Production"] = "production";
+  return ScreensetCategory2;
+})(ScreensetCategory || {});
+export {
+  LayoutDomain,
+  ScreensetCategory,
+  createScreensetRegistry,
+  screensetRegistry
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/registry.ts","../src/types.ts"],"sourcesContent":["/**\n * @hai3/screensets - Screenset Registry\n *\n * Pure storage implementation for screenset registration.\n * This is a simple Map wrapper with no side effects.\n * ~20 lines of implementation - minimal and focused.\n *\n * NOTE: i18n wiring happens in @hai3/framework when it re-exports this registry.\n */\n\nimport type { ScreensetDefinition, ScreensetRegistry } from './types';\n\n/**\n * Create a new screenset registry instance.\n * This is a pure storage implementation with no dependencies.\n */\nfunction createScreensetRegistry(): ScreensetRegistry {\n  const screensets = new Map<string, ScreensetDefinition>();\n\n  return {\n    register(screenset: ScreensetDefinition): void {\n      screensets.set(screenset.id, screenset);\n    },\n\n    registerMany(configs: ScreensetDefinition[]): void {\n      for (const config of configs) {\n        screensets.set(config.id, config);\n      }\n    },\n\n    get(id: string): ScreensetDefinition | undefined {\n      return screensets.get(id);\n    },\n\n    getAll(): ScreensetDefinition[] {\n      return Array.from(screensets.values());\n    },\n\n    has(id: string): boolean {\n      return screensets.has(id);\n    },\n\n    unregister(id: string): boolean {\n      return screensets.delete(id);\n    },\n\n    clear(): void {\n      screensets.clear();\n    },\n  };\n}\n\n/**\n * Singleton screenset registry instance.\n * Use this for screenset registration throughout the application.\n *\n * @example\n * ```typescript\n * import { screensetRegistry } from '@hai3/screensets';\n *\n * // Register a screenset\n * screensetRegistry.register(myScreenset);\n *\n * // Get all screensets\n * const all = screensetRegistry.getAll();\n * ```\n */\nexport const screensetRegistry: ScreensetRegistry = createScreensetRegistry();\n\n// Also export the factory for testing purposes\nexport { createScreensetRegistry };\n","/**\n * @hai3/screensets - Type Definitions\n *\n * Pure TypeScript contracts for HAI3 screenset management.\n * This package has ZERO dependencies - pure types and contracts only.\n *\n * NOTE: Layout state shapes (HeaderState, MenuState, etc.) are in @hai3/framework\n */\n\nimport type { ComponentType } from 'react';\n\n// ============================================================================\n// Layout Domain Enum\n// ============================================================================\n\n/**\n * Layout Domain Enum\n * Defines all layout domains that can be orchestrated.\n */\nexport enum LayoutDomain {\n  Header = 'header',\n  Footer = 'footer',\n  Menu = 'menu',\n  Sidebar = 'sidebar',\n  Screen = 'screen',\n  Popup = 'popup',\n  Overlay = 'overlay',\n}\n\n// ============================================================================\n// Branded Types for Type Safety\n// ============================================================================\n\n/**\n * Branded type for Screenset IDs\n * Provides compile-time safety for screenset identification.\n *\n * @example\n * ```typescript\n * const chatScreensetId = 'chat' as ScreensetId;\n * const demoScreensetId = 'demo' as ScreensetId;\n * ```\n */\nexport type ScreensetId = string & { readonly __brand: 'ScreensetId' };\n\n/**\n * Branded type for Screen IDs\n * Provides compile-time safety for screen identification.\n *\n * @example\n * ```typescript\n * const homeScreenId = 'home' as ScreenId;\n * const profileScreenId = 'profile' as ScreenId;\n * ```\n */\nexport type ScreenId = string & { readonly __brand: 'ScreenId' };\n\n// ============================================================================\n// Screenset Category\n// ============================================================================\n\n/**\n * Screenset Category Enum\n * Defines the three-stage development workflow categories.\n */\nexport enum ScreensetCategory {\n  /** AI-generated initial layouts */\n  Drafts = 'drafts',\n  /** Designer-refined versions */\n  Mockups = 'mockups',\n  /** Engineer-finalized, production-ready screens */\n  Production = 'production',\n}\n\n// ============================================================================\n// Menu Item Configuration\n// ============================================================================\n\n/**\n * Menu Item Configuration\n * Defines the structure of a menu item.\n *\n * @example\n * ```typescript\n * const menuItem: MenuItemConfig = {\n *   id: 'dashboard',\n *   label: 'screen.dashboard:title',  // Translation key\n *   icon: 'dashboard:home',           // Icon ID\n *   screenId: 'dashboard',\n * };\n * ```\n */\nexport interface MenuItemConfig {\n  /** Unique identifier for the menu item */\n  id: string;\n  /** Translation key for the label */\n  label: string;\n  /** Icon identifier (format: screensetId:iconName) */\n  icon?: string;\n  /** Screen ID to navigate to on click */\n  screenId?: string;\n  /** External URL (mutually exclusive with screenId) */\n  href?: string;\n  /** Click handler (for custom actions) */\n  onClick?: () => void;\n  /** Child menu items for nested menus */\n  children?: MenuItemConfig[];\n  /** Badge content (string or number) */\n  badge?: string | number;\n}\n\n// ============================================================================\n// Screen Configuration\n// ============================================================================\n\n/**\n * Screen Loader Function Type\n * Returns a Promise resolving to a module with a default React component.\n *\n * @example\n * ```typescript\n * const loader: ScreenLoader = () => import('./screens/HomeScreen');\n * ```\n */\nexport type ScreenLoader = () => Promise<{ default: ComponentType }>;\n\n/**\n * Screen Configuration\n * Defines the structure of a screen.\n *\n * @example\n * ```typescript\n * const screen: ScreenConfig = {\n *   id: 'home',\n *   loader: () => import('./screens/HomeScreen'),\n * };\n * ```\n */\nexport interface ScreenConfig {\n  /** Unique identifier for the screen */\n  id: string;\n  /** Lazy loader function for the screen component */\n  loader: ScreenLoader;\n}\n\n// ============================================================================\n// Screenset Definition\n// ============================================================================\n\n/**\n * Menu Screen Item\n * Combines menu item config with its screen loader.\n */\nexport interface MenuScreenItem {\n  /** Menu item configuration */\n  menuItem: MenuItemConfig;\n  /** Screen loader function */\n  screen: ScreenLoader;\n}\n\n/**\n * Screenset Definition\n * Complete definition of a screenset including screens and menu.\n *\n * NOTE: Translations are NOT part of screenset definition.\n * Screensets register translations directly with i18nRegistry via framework.\n *\n * @example\n * ```typescript\n * const demoScreenset: ScreensetDefinition = {\n *   id: 'demo',\n *   name: 'Demo Screenset',\n *   category: ScreensetCategory.Drafts,\n *   defaultScreen: 'home',\n *   menu: [\n *     { menuItem: homeMenuItem, screen: () => import('./screens/HomeScreen') },\n *   ],\n * };\n * ```\n */\nexport interface ScreensetDefinition {\n  /** Unique identifier for the screenset */\n  id: string;\n  /** Display name for the screenset */\n  name: string;\n  /** Category (drafts, mockups, production) */\n  category: ScreensetCategory;\n  /** Default screen ID to show when screenset is selected */\n  defaultScreen: string;\n  /** Menu items with their associated screens */\n  menu: MenuScreenItem[];\n}\n\n// ============================================================================\n// Screenset Registry Interface\n// ============================================================================\n\n/**\n * Screenset Registry Interface\n * Pure storage interface for screenset registration.\n * Implementation is a simple Map wrapper with no side effects.\n */\nexport interface ScreensetRegistry {\n  /** Register a screenset */\n  register(screenset: ScreensetDefinition): void;\n  /** Get a screenset by ID */\n  get(id: string): ScreensetDefinition | undefined;\n  /** Register multiple screensets at once */\n  registerMany(configs: ScreensetDefinition[]): void;\n  /** Get all registered screensets */\n  getAll(): ScreensetDefinition[];\n  /** Check if a screenset is registered */\n  has(id: string): boolean;\n  /** Unregister a screenset */\n  unregister(id: string): boolean;\n  /** Clear all screensets (useful for testing) */\n  clear(): void;\n}\n"],"mappings":";AAgBA,SAAS,0BAA6C;AACpD,QAAM,aAAa,oBAAI,IAAiC;AAExD,SAAO;AAAA,IACL,SAAS,WAAsC;AAC7C,iBAAW,IAAI,UAAU,IAAI,SAAS;AAAA,IACxC;AAAA,IAEA,aAAa,SAAsC;AACjD,iBAAW,UAAU,SAAS;AAC5B,mBAAW,IAAI,OAAO,IAAI,MAAM;AAAA,MAClC;AAAA,IACF;AAAA,IAEA,IAAI,IAA6C;AAC/C,aAAO,WAAW,IAAI,EAAE;AAAA,IAC1B;AAAA,IAEA,SAAgC;AAC9B,aAAO,MAAM,KAAK,WAAW,OAAO,CAAC;AAAA,IACvC;AAAA,IAEA,IAAI,IAAqB;AACvB,aAAO,WAAW,IAAI,EAAE;AAAA,IAC1B;AAAA,IAEA,WAAW,IAAqB;AAC9B,aAAO,WAAW,OAAO,EAAE;AAAA,IAC7B;AAAA,IAEA,QAAc;AACZ,iBAAW,MAAM;AAAA,IACnB;AAAA,EACF;AACF;AAiBO,IAAM,oBAAuC,wBAAwB;;;AChDrE,IAAK,eAAL,kBAAKA,kBAAL;AACL,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,UAAO;AACP,EAAAA,cAAA,aAAU;AACV,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,aAAU;AAPA,SAAAA;AAAA,GAAA;AA8CL,IAAK,oBAAL,kBAAKC,uBAAL;AAEL,EAAAA,mBAAA,YAAS;AAET,EAAAA,mBAAA,aAAU;AAEV,EAAAA,mBAAA,gBAAa;AANH,SAAAA;AAAA,GAAA;","names":["LayoutDomain","ScreensetCategory"]}

package/dist/types.cjs

@@ -0,0 +1,48 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types.ts
+var types_exports = {};
+__export(types_exports, {
+  LayoutDomain: () => LayoutDomain,
+  ScreensetCategory: () => ScreensetCategory
+});
+module.exports = __toCommonJS(types_exports);
+var LayoutDomain = /* @__PURE__ */ ((LayoutDomain2) => {
+  LayoutDomain2["Header"] = "header";
+  LayoutDomain2["Footer"] = "footer";
+  LayoutDomain2["Menu"] = "menu";
+  LayoutDomain2["Sidebar"] = "sidebar";
+  LayoutDomain2["Screen"] = "screen";
+  LayoutDomain2["Popup"] = "popup";
+  LayoutDomain2["Overlay"] = "overlay";
+  return LayoutDomain2;
+})(LayoutDomain || {});
+var ScreensetCategory = /* @__PURE__ */ ((ScreensetCategory2) => {
+  ScreensetCategory2["Drafts"] = "drafts";
+  ScreensetCategory2["Mockups"] = "mockups";
+  ScreensetCategory2["Production"] = "production";
+  return ScreensetCategory2;
+})(ScreensetCategory || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LayoutDomain,
+  ScreensetCategory
+});
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * @hai3/screensets - Type Definitions\n *\n * Pure TypeScript contracts for HAI3 screenset management.\n * This package has ZERO dependencies - pure types and contracts only.\n *\n * NOTE: Layout state shapes (HeaderState, MenuState, etc.) are in @hai3/framework\n */\n\nimport type { ComponentType } from 'react';\n\n// ============================================================================\n// Layout Domain Enum\n// ============================================================================\n\n/**\n * Layout Domain Enum\n * Defines all layout domains that can be orchestrated.\n */\nexport enum LayoutDomain {\n  Header = 'header',\n  Footer = 'footer',\n  Menu = 'menu',\n  Sidebar = 'sidebar',\n  Screen = 'screen',\n  Popup = 'popup',\n  Overlay = 'overlay',\n}\n\n// ============================================================================\n// Branded Types for Type Safety\n// ============================================================================\n\n/**\n * Branded type for Screenset IDs\n * Provides compile-time safety for screenset identification.\n *\n * @example\n * ```typescript\n * const chatScreensetId = 'chat' as ScreensetId;\n * const demoScreensetId = 'demo' as ScreensetId;\n * ```\n */\nexport type ScreensetId = string & { readonly __brand: 'ScreensetId' };\n\n/**\n * Branded type for Screen IDs\n * Provides compile-time safety for screen identification.\n *\n * @example\n * ```typescript\n * const homeScreenId = 'home' as ScreenId;\n * const profileScreenId = 'profile' as ScreenId;\n * ```\n */\nexport type ScreenId = string & { readonly __brand: 'ScreenId' };\n\n// ============================================================================\n// Screenset Category\n// ============================================================================\n\n/**\n * Screenset Category Enum\n * Defines the three-stage development workflow categories.\n */\nexport enum ScreensetCategory {\n  /** AI-generated initial layouts */\n  Drafts = 'drafts',\n  /** Designer-refined versions */\n  Mockups = 'mockups',\n  /** Engineer-finalized, production-ready screens */\n  Production = 'production',\n}\n\n// ============================================================================\n// Menu Item Configuration\n// ============================================================================\n\n/**\n * Menu Item Configuration\n * Defines the structure of a menu item.\n *\n * @example\n * ```typescript\n * const menuItem: MenuItemConfig = {\n *   id: 'dashboard',\n *   label: 'screen.dashboard:title',  // Translation key\n *   icon: 'dashboard:home',           // Icon ID\n *   screenId: 'dashboard',\n * };\n * ```\n */\nexport interface MenuItemConfig {\n  /** Unique identifier for the menu item */\n  id: string;\n  /** Translation key for the label */\n  label: string;\n  /** Icon identifier (format: screensetId:iconName) */\n  icon?: string;\n  /** Screen ID to navigate to on click */\n  screenId?: string;\n  /** External URL (mutually exclusive with screenId) */\n  href?: string;\n  /** Click handler (for custom actions) */\n  onClick?: () => void;\n  /** Child menu items for nested menus */\n  children?: MenuItemConfig[];\n  /** Badge content (string or number) */\n  badge?: string | number;\n}\n\n// ============================================================================\n// Screen Configuration\n// ============================================================================\n\n/**\n * Screen Loader Function Type\n * Returns a Promise resolving to a module with a default React component.\n *\n * @example\n * ```typescript\n * const loader: ScreenLoader = () => import('./screens/HomeScreen');\n * ```\n */\nexport type ScreenLoader = () => Promise<{ default: ComponentType }>;\n\n/**\n * Screen Configuration\n * Defines the structure of a screen.\n *\n * @example\n * ```typescript\n * const screen: ScreenConfig = {\n *   id: 'home',\n *   loader: () => import('./screens/HomeScreen'),\n * };\n * ```\n */\nexport interface ScreenConfig {\n  /** Unique identifier for the screen */\n  id: string;\n  /** Lazy loader function for the screen component */\n  loader: ScreenLoader;\n}\n\n// ============================================================================\n// Screenset Definition\n// ============================================================================\n\n/**\n * Menu Screen Item\n * Combines menu item config with its screen loader.\n */\nexport interface MenuScreenItem {\n  /** Menu item configuration */\n  menuItem: MenuItemConfig;\n  /** Screen loader function */\n  screen: ScreenLoader;\n}\n\n/**\n * Screenset Definition\n * Complete definition of a screenset including screens and menu.\n *\n * NOTE: Translations are NOT part of screenset definition.\n * Screensets register translations directly with i18nRegistry via framework.\n *\n * @example\n * ```typescript\n * const demoScreenset: ScreensetDefinition = {\n *   id: 'demo',\n *   name: 'Demo Screenset',\n *   category: ScreensetCategory.Drafts,\n *   defaultScreen: 'home',\n *   menu: [\n *     { menuItem: homeMenuItem, screen: () => import('./screens/HomeScreen') },\n *   ],\n * };\n * ```\n */\nexport interface ScreensetDefinition {\n  /** Unique identifier for the screenset */\n  id: string;\n  /** Display name for the screenset */\n  name: string;\n  /** Category (drafts, mockups, production) */\n  category: ScreensetCategory;\n  /** Default screen ID to show when screenset is selected */\n  defaultScreen: string;\n  /** Menu items with their associated screens */\n  menu: MenuScreenItem[];\n}\n\n// ============================================================================\n// Screenset Registry Interface\n// ============================================================================\n\n/**\n * Screenset Registry Interface\n * Pure storage interface for screenset registration.\n * Implementation is a simple Map wrapper with no side effects.\n */\nexport interface ScreensetRegistry {\n  /** Register a screenset */\n  register(screenset: ScreensetDefinition): void;\n  /** Get a screenset by ID */\n  get(id: string): ScreensetDefinition | undefined;\n  /** Register multiple screensets at once */\n  registerMany(configs: ScreensetDefinition[]): void;\n  /** Get all registered screensets */\n  getAll(): ScreensetDefinition[];\n  /** Check if a screenset is registered */\n  has(id: string): boolean;\n  /** Unregister a screenset */\n  unregister(id: string): boolean;\n  /** Clear all screensets (useful for testing) */\n  clear(): void;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBO,IAAK,eAAL,kBAAKA,kBAAL;AACL,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,UAAO;AACP,EAAAA,cAAA,aAAU;AACV,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,aAAU;AAPA,SAAAA;AAAA,GAAA;AA8CL,IAAK,oBAAL,kBAAKC,uBAAL;AAEL,EAAAA,mBAAA,YAAS;AAET,EAAAA,mBAAA,aAAU;AAEV,EAAAA,mBAAA,gBAAa;AANH,SAAAA;AAAA,GAAA;","names":["LayoutDomain","ScreensetCategory"]}

package/dist/types.d.cts

@@ -0,0 +1,189 @@
+import { ComponentType } from 'react';
+
+/**
+ * @hai3/screensets - Type Definitions
+ *
+ * Pure TypeScript contracts for HAI3 screenset management.
+ * This package has ZERO dependencies - pure types and contracts only.
+ *
+ * NOTE: Layout state shapes (HeaderState, MenuState, etc.) are in @hai3/framework
+ */
+
+/**
+ * Layout Domain Enum
+ * Defines all layout domains that can be orchestrated.
+ */
+declare enum LayoutDomain {
+    Header = "header",
+    Footer = "footer",
+    Menu = "menu",
+    Sidebar = "sidebar",
+    Screen = "screen",
+    Popup = "popup",
+    Overlay = "overlay"
+}
+/**
+ * Branded type for Screenset IDs
+ * Provides compile-time safety for screenset identification.
+ *
+ * @example
+ * ```typescript
+ * const chatScreensetId = 'chat' as ScreensetId;
+ * const demoScreensetId = 'demo' as ScreensetId;
+ * ```
+ */
+type ScreensetId = string & {
+    readonly __brand: 'ScreensetId';
+};
+/**
+ * Branded type for Screen IDs
+ * Provides compile-time safety for screen identification.
+ *
+ * @example
+ * ```typescript
+ * const homeScreenId = 'home' as ScreenId;
+ * const profileScreenId = 'profile' as ScreenId;
+ * ```
+ */
+type ScreenId = string & {
+    readonly __brand: 'ScreenId';
+};
+/**
+ * Screenset Category Enum
+ * Defines the three-stage development workflow categories.
+ */
+declare enum ScreensetCategory {
+    /** AI-generated initial layouts */
+    Drafts = "drafts",
+    /** Designer-refined versions */
+    Mockups = "mockups",
+    /** Engineer-finalized, production-ready screens */
+    Production = "production"
+}
+/**
+ * Menu Item Configuration
+ * Defines the structure of a menu item.
+ *
+ * @example
+ * ```typescript
+ * const menuItem: MenuItemConfig = {
+ *   id: 'dashboard',
+ *   label: 'screen.dashboard:title',  // Translation key
+ *   icon: 'dashboard:home',           // Icon ID
+ *   screenId: 'dashboard',
+ * };
+ * ```
+ */
+interface MenuItemConfig {
+    /** Unique identifier for the menu item */
+    id: string;
+    /** Translation key for the label */
+    label: string;
+    /** Icon identifier (format: screensetId:iconName) */
+    icon?: string;
+    /** Screen ID to navigate to on click */
+    screenId?: string;
+    /** External URL (mutually exclusive with screenId) */
+    href?: string;
+    /** Click handler (for custom actions) */
+    onClick?: () => void;
+    /** Child menu items for nested menus */
+    children?: MenuItemConfig[];
+    /** Badge content (string or number) */
+    badge?: string | number;
+}
+/**
+ * Screen Loader Function Type
+ * Returns a Promise resolving to a module with a default React component.
+ *
+ * @example
+ * ```typescript
+ * const loader: ScreenLoader = () => import('./screens/HomeScreen');
+ * ```
+ */
+type ScreenLoader = () => Promise<{
+    default: ComponentType;
+}>;
+/**
+ * Screen Configuration
+ * Defines the structure of a screen.
+ *
+ * @example
+ * ```typescript
+ * const screen: ScreenConfig = {
+ *   id: 'home',
+ *   loader: () => import('./screens/HomeScreen'),
+ * };
+ * ```
+ */
+interface ScreenConfig {
+    /** Unique identifier for the screen */
+    id: string;
+    /** Lazy loader function for the screen component */
+    loader: ScreenLoader;
+}
+/**
+ * Menu Screen Item
+ * Combines menu item config with its screen loader.
+ */
+interface MenuScreenItem {
+    /** Menu item configuration */
+    menuItem: MenuItemConfig;
+    /** Screen loader function */
+    screen: ScreenLoader;
+}
+/**
+ * Screenset Definition
+ * Complete definition of a screenset including screens and menu.
+ *
+ * NOTE: Translations are NOT part of screenset definition.
+ * Screensets register translations directly with i18nRegistry via framework.
+ *
+ * @example
+ * ```typescript
+ * const demoScreenset: ScreensetDefinition = {
+ *   id: 'demo',
+ *   name: 'Demo Screenset',
+ *   category: ScreensetCategory.Drafts,
+ *   defaultScreen: 'home',
+ *   menu: [
+ *     { menuItem: homeMenuItem, screen: () => import('./screens/HomeScreen') },
+ *   ],
+ * };
+ * ```
+ */
+interface ScreensetDefinition {
+    /** Unique identifier for the screenset */
+    id: string;
+    /** Display name for the screenset */
+    name: string;
+    /** Category (drafts, mockups, production) */
+    category: ScreensetCategory;
+    /** Default screen ID to show when screenset is selected */
+    defaultScreen: string;
+    /** Menu items with their associated screens */
+    menu: MenuScreenItem[];
+}
+/**
+ * Screenset Registry Interface
+ * Pure storage interface for screenset registration.
+ * Implementation is a simple Map wrapper with no side effects.
+ */
+interface ScreensetRegistry {
+    /** Register a screenset */
+    register(screenset: ScreensetDefinition): void;
+    /** Get a screenset by ID */
+    get(id: string): ScreensetDefinition | undefined;
+    /** Register multiple screensets at once */
+    registerMany(configs: ScreensetDefinition[]): void;
+    /** Get all registered screensets */
+    getAll(): ScreensetDefinition[];
+    /** Check if a screenset is registered */
+    has(id: string): boolean;
+    /** Unregister a screenset */
+    unregister(id: string): boolean;
+    /** Clear all screensets (useful for testing) */
+    clear(): void;
+}
+
+export { LayoutDomain, type MenuItemConfig, type MenuScreenItem, type ScreenConfig, type ScreenId, type ScreenLoader, ScreensetCategory, type ScreensetDefinition, type ScreensetId, type ScreensetRegistry };

package/dist/types.d.ts

@@ -0,0 +1,189 @@
+import { ComponentType } from 'react';
+
+/**
+ * @hai3/screensets - Type Definitions
+ *
+ * Pure TypeScript contracts for HAI3 screenset management.
+ * This package has ZERO dependencies - pure types and contracts only.
+ *
+ * NOTE: Layout state shapes (HeaderState, MenuState, etc.) are in @hai3/framework
+ */
+
+/**
+ * Layout Domain Enum
+ * Defines all layout domains that can be orchestrated.
+ */
+declare enum LayoutDomain {
+    Header = "header",
+    Footer = "footer",
+    Menu = "menu",
+    Sidebar = "sidebar",
+    Screen = "screen",
+    Popup = "popup",
+    Overlay = "overlay"
+}
+/**
+ * Branded type for Screenset IDs
+ * Provides compile-time safety for screenset identification.
+ *
+ * @example
+ * ```typescript
+ * const chatScreensetId = 'chat' as ScreensetId;
+ * const demoScreensetId = 'demo' as ScreensetId;
+ * ```
+ */
+type ScreensetId = string & {
+    readonly __brand: 'ScreensetId';
+};
+/**
+ * Branded type for Screen IDs
+ * Provides compile-time safety for screen identification.
+ *
+ * @example
+ * ```typescript
+ * const homeScreenId = 'home' as ScreenId;
+ * const profileScreenId = 'profile' as ScreenId;
+ * ```
+ */
+type ScreenId = string & {
+    readonly __brand: 'ScreenId';
+};
+/**
+ * Screenset Category Enum
+ * Defines the three-stage development workflow categories.
+ */
+declare enum ScreensetCategory {
+    /** AI-generated initial layouts */
+    Drafts = "drafts",
+    /** Designer-refined versions */
+    Mockups = "mockups",
+    /** Engineer-finalized, production-ready screens */
+    Production = "production"
+}
+/**
+ * Menu Item Configuration
+ * Defines the structure of a menu item.
+ *
+ * @example
+ * ```typescript
+ * const menuItem: MenuItemConfig = {
+ *   id: 'dashboard',
+ *   label: 'screen.dashboard:title',  // Translation key
+ *   icon: 'dashboard:home',           // Icon ID
+ *   screenId: 'dashboard',
+ * };
+ * ```
+ */
+interface MenuItemConfig {
+    /** Unique identifier for the menu item */
+    id: string;
+    /** Translation key for the label */
+    label: string;
+    /** Icon identifier (format: screensetId:iconName) */
+    icon?: string;
+    /** Screen ID to navigate to on click */
+    screenId?: string;
+    /** External URL (mutually exclusive with screenId) */
+    href?: string;
+    /** Click handler (for custom actions) */
+    onClick?: () => void;
+    /** Child menu items for nested menus */
+    children?: MenuItemConfig[];
+    /** Badge content (string or number) */
+    badge?: string | number;
+}
+/**
+ * Screen Loader Function Type
+ * Returns a Promise resolving to a module with a default React component.
+ *
+ * @example
+ * ```typescript
+ * const loader: ScreenLoader = () => import('./screens/HomeScreen');
+ * ```
+ */
+type ScreenLoader = () => Promise<{
+    default: ComponentType;
+}>;
+/**
+ * Screen Configuration
+ * Defines the structure of a screen.
+ *
+ * @example
+ * ```typescript
+ * const screen: ScreenConfig = {
+ *   id: 'home',
+ *   loader: () => import('./screens/HomeScreen'),
+ * };
+ * ```
+ */
+interface ScreenConfig {
+    /** Unique identifier for the screen */
+    id: string;
+    /** Lazy loader function for the screen component */
+    loader: ScreenLoader;
+}
+/**
+ * Menu Screen Item
+ * Combines menu item config with its screen loader.
+ */
+interface MenuScreenItem {
+    /** Menu item configuration */
+    menuItem: MenuItemConfig;
+    /** Screen loader function */
+    screen: ScreenLoader;
+}
+/**
+ * Screenset Definition
+ * Complete definition of a screenset including screens and menu.
+ *
+ * NOTE: Translations are NOT part of screenset definition.
+ * Screensets register translations directly with i18nRegistry via framework.
+ *
+ * @example
+ * ```typescript
+ * const demoScreenset: ScreensetDefinition = {
+ *   id: 'demo',
+ *   name: 'Demo Screenset',
+ *   category: ScreensetCategory.Drafts,
+ *   defaultScreen: 'home',
+ *   menu: [
+ *     { menuItem: homeMenuItem, screen: () => import('./screens/HomeScreen') },
+ *   ],
+ * };
+ * ```
+ */
+interface ScreensetDefinition {
+    /** Unique identifier for the screenset */
+    id: string;
+    /** Display name for the screenset */
+    name: string;
+    /** Category (drafts, mockups, production) */
+    category: ScreensetCategory;
+    /** Default screen ID to show when screenset is selected */
+    defaultScreen: string;
+    /** Menu items with their associated screens */
+    menu: MenuScreenItem[];
+}
+/**
+ * Screenset Registry Interface
+ * Pure storage interface for screenset registration.
+ * Implementation is a simple Map wrapper with no side effects.
+ */
+interface ScreensetRegistry {
+    /** Register a screenset */
+    register(screenset: ScreensetDefinition): void;
+    /** Get a screenset by ID */
+    get(id: string): ScreensetDefinition | undefined;
+    /** Register multiple screensets at once */
+    registerMany(configs: ScreensetDefinition[]): void;
+    /** Get all registered screensets */
+    getAll(): ScreensetDefinition[];
+    /** Check if a screenset is registered */
+    has(id: string): boolean;
+    /** Unregister a screenset */
+    unregister(id: string): boolean;
+    /** Clear all screensets (useful for testing) */
+    clear(): void;
+}
+
+export { LayoutDomain, type MenuItemConfig, type MenuScreenItem, type ScreenConfig, type ScreenId, type ScreenLoader, ScreensetCategory, type ScreensetDefinition, type ScreensetId, type ScreensetRegistry };

package/dist/types.js

@@ -0,0 +1,22 @@
+// src/types.ts
+var LayoutDomain = /* @__PURE__ */ ((LayoutDomain2) => {
+  LayoutDomain2["Header"] = "header";
+  LayoutDomain2["Footer"] = "footer";
+  LayoutDomain2["Menu"] = "menu";
+  LayoutDomain2["Sidebar"] = "sidebar";
+  LayoutDomain2["Screen"] = "screen";
+  LayoutDomain2["Popup"] = "popup";
+  LayoutDomain2["Overlay"] = "overlay";
+  return LayoutDomain2;
+})(LayoutDomain || {});
+var ScreensetCategory = /* @__PURE__ */ ((ScreensetCategory2) => {
+  ScreensetCategory2["Drafts"] = "drafts";
+  ScreensetCategory2["Mockups"] = "mockups";
+  ScreensetCategory2["Production"] = "production";
+  return ScreensetCategory2;
+})(ScreensetCategory || {});
+export {
+  LayoutDomain,
+  ScreensetCategory
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * @hai3/screensets - Type Definitions\n *\n * Pure TypeScript contracts for HAI3 screenset management.\n * This package has ZERO dependencies - pure types and contracts only.\n *\n * NOTE: Layout state shapes (HeaderState, MenuState, etc.) are in @hai3/framework\n */\n\nimport type { ComponentType } from 'react';\n\n// ============================================================================\n// Layout Domain Enum\n// ============================================================================\n\n/**\n * Layout Domain Enum\n * Defines all layout domains that can be orchestrated.\n */\nexport enum LayoutDomain {\n  Header = 'header',\n  Footer = 'footer',\n  Menu = 'menu',\n  Sidebar = 'sidebar',\n  Screen = 'screen',\n  Popup = 'popup',\n  Overlay = 'overlay',\n}\n\n// ============================================================================\n// Branded Types for Type Safety\n// ============================================================================\n\n/**\n * Branded type for Screenset IDs\n * Provides compile-time safety for screenset identification.\n *\n * @example\n * ```typescript\n * const chatScreensetId = 'chat' as ScreensetId;\n * const demoScreensetId = 'demo' as ScreensetId;\n * ```\n */\nexport type ScreensetId = string & { readonly __brand: 'ScreensetId' };\n\n/**\n * Branded type for Screen IDs\n * Provides compile-time safety for screen identification.\n *\n * @example\n * ```typescript\n * const homeScreenId = 'home' as ScreenId;\n * const profileScreenId = 'profile' as ScreenId;\n * ```\n */\nexport type ScreenId = string & { readonly __brand: 'ScreenId' };\n\n// ============================================================================\n// Screenset Category\n// ============================================================================\n\n/**\n * Screenset Category Enum\n * Defines the three-stage development workflow categories.\n */\nexport enum ScreensetCategory {\n  /** AI-generated initial layouts */\n  Drafts = 'drafts',\n  /** Designer-refined versions */\n  Mockups = 'mockups',\n  /** Engineer-finalized, production-ready screens */\n  Production = 'production',\n}\n\n// ============================================================================\n// Menu Item Configuration\n// ============================================================================\n\n/**\n * Menu Item Configuration\n * Defines the structure of a menu item.\n *\n * @example\n * ```typescript\n * const menuItem: MenuItemConfig = {\n *   id: 'dashboard',\n *   label: 'screen.dashboard:title',  // Translation key\n *   icon: 'dashboard:home',           // Icon ID\n *   screenId: 'dashboard',\n * };\n * ```\n */\nexport interface MenuItemConfig {\n  /** Unique identifier for the menu item */\n  id: string;\n  /** Translation key for the label */\n  label: string;\n  /** Icon identifier (format: screensetId:iconName) */\n  icon?: string;\n  /** Screen ID to navigate to on click */\n  screenId?: string;\n  /** External URL (mutually exclusive with screenId) */\n  href?: string;\n  /** Click handler (for custom actions) */\n  onClick?: () => void;\n  /** Child menu items for nested menus */\n  children?: MenuItemConfig[];\n  /** Badge content (string or number) */\n  badge?: string | number;\n}\n\n// ============================================================================\n// Screen Configuration\n// ============================================================================\n\n/**\n * Screen Loader Function Type\n * Returns a Promise resolving to a module with a default React component.\n *\n * @example\n * ```typescript\n * const loader: ScreenLoader = () => import('./screens/HomeScreen');\n * ```\n */\nexport type ScreenLoader = () => Promise<{ default: ComponentType }>;\n\n/**\n * Screen Configuration\n * Defines the structure of a screen.\n *\n * @example\n * ```typescript\n * const screen: ScreenConfig = {\n *   id: 'home',\n *   loader: () => import('./screens/HomeScreen'),\n * };\n * ```\n */\nexport interface ScreenConfig {\n  /** Unique identifier for the screen */\n  id: string;\n  /** Lazy loader function for the screen component */\n  loader: ScreenLoader;\n}\n\n// ============================================================================\n// Screenset Definition\n// ============================================================================\n\n/**\n * Menu Screen Item\n * Combines menu item config with its screen loader.\n */\nexport interface MenuScreenItem {\n  /** Menu item configuration */\n  menuItem: MenuItemConfig;\n  /** Screen loader function */\n  screen: ScreenLoader;\n}\n\n/**\n * Screenset Definition\n * Complete definition of a screenset including screens and menu.\n *\n * NOTE: Translations are NOT part of screenset definition.\n * Screensets register translations directly with i18nRegistry via framework.\n *\n * @example\n * ```typescript\n * const demoScreenset: ScreensetDefinition = {\n *   id: 'demo',\n *   name: 'Demo Screenset',\n *   category: ScreensetCategory.Drafts,\n *   defaultScreen: 'home',\n *   menu: [\n *     { menuItem: homeMenuItem, screen: () => import('./screens/HomeScreen') },\n *   ],\n * };\n * ```\n */\nexport interface ScreensetDefinition {\n  /** Unique identifier for the screenset */\n  id: string;\n  /** Display name for the screenset */\n  name: string;\n  /** Category (drafts, mockups, production) */\n  category: ScreensetCategory;\n  /** Default screen ID to show when screenset is selected */\n  defaultScreen: string;\n  /** Menu items with their associated screens */\n  menu: MenuScreenItem[];\n}\n\n// ============================================================================\n// Screenset Registry Interface\n// ============================================================================\n\n/**\n * Screenset Registry Interface\n * Pure storage interface for screenset registration.\n * Implementation is a simple Map wrapper with no side effects.\n */\nexport interface ScreensetRegistry {\n  /** Register a screenset */\n  register(screenset: ScreensetDefinition): void;\n  /** Get a screenset by ID */\n  get(id: string): ScreensetDefinition | undefined;\n  /** Register multiple screensets at once */\n  registerMany(configs: ScreensetDefinition[]): void;\n  /** Get all registered screensets */\n  getAll(): ScreensetDefinition[];\n  /** Check if a screenset is registered */\n  has(id: string): boolean;\n  /** Unregister a screenset */\n  unregister(id: string): boolean;\n  /** Clear all screensets (useful for testing) */\n  clear(): void;\n}\n"],"mappings":";AAmBO,IAAK,eAAL,kBAAKA,kBAAL;AACL,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,UAAO;AACP,EAAAA,cAAA,aAAU;AACV,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,aAAU;AAPA,SAAAA;AAAA,GAAA;AA8CL,IAAK,oBAAL,kBAAKC,uBAAL;AAEL,EAAAA,mBAAA,YAAS;AAET,EAAAA,mBAAA,aAAU;AAEV,EAAAA,mBAAA,gBAAa;AANH,SAAAA;AAAA,GAAA;","names":["LayoutDomain","ScreensetCategory"]}

package/llms.txt

@@ -0,0 +1,52 @@
+# @hai3/layout
+
+> Layout domain slices, selectors, and types for HAI3 SDK. Manages header, footer, menu, sidebar, screen, popup, overlay state.
+
+Part of the HAI3 SDK Layer (L1) - can be used independently without other @hai3 packages. Peer dependency on @reduxjs/toolkit.
+
+## Core API
+
+- [Layout Slices](https://hai3.dev/docs/layout/slices): headerSlice, footerSlice, menuSlice, sidebarSlice, screenSlice, popupSlice, overlaySlice
+- [Layout Selectors](https://hai3.dev/docs/layout/selectors): selectHeader, selectMenu, selectActiveScreen, etc.
+- [Layout Types](https://hai3.dev/docs/layout/types): LayoutState, ScreensetDefinition, MenuItemConfig
+
+## Key Patterns
+
+- Each domain has its own slice (header, footer, menu, sidebar, screen, popup, overlay)
+- Selectors for accessing layout state
+- Screenset definitions with menu items and screens
+- Category-based organization (drafts, mockups, production)
+
+## Quick Start
+
+```typescript
+import {
+  selectActiveScreen,
+  selectMenuCollapsed,
+  ScreensetDefinition,
+  ScreensetCategory
+} from '@hai3/layout';
+
+// Define screenset
+const myScreenset: ScreensetDefinition = {
+  id: 'myScreenset',
+  name: 'My Screenset',
+  category: ScreensetCategory.Drafts,
+  defaultScreen: 'home',
+  menu: [
+    {
+      menuItem: { id: 'home', label: 'Home', icon: 'home' },
+      screen: () => import('./screens/Home')
+    }
+  ]
+};
+
+// Use selectors
+const activeScreen = selectActiveScreen(state);
+const isCollapsed = selectMenuCollapsed(state);
+```
+
+## Optional
+
+- [Migration Guide](https://hai3.dev/docs/layout/migration): Migrating from @hai3/uicore
+- [Custom Layouts](https://hai3.dev/docs/layout/custom): Building custom layout components

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@hai3/screensets",
+  "version": "0.2.0-alpha.0",
+  "description": "Pure TypeScript contracts and registry for HAI3 screenset management",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "require": "./dist/types.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "CLAUDE.md",
+    "llms.txt"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.2"
+  },
+  "peerDependencies": {},
+  "keywords": [
+    "hai3",
+    "screensets",
+    "contracts",
+    "typescript",
+    "vertical-slices"
+  ],
+  "author": "HAI3",
+  "license": "Apache-2.0"
+}