@hai3/framework 0.4.0-alpha.0 → 0.4.0-alpha.1

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { HAI3Config, HAI3AppBuilder, HAI3Plugin, ThemesConfig, Presets, HAI3App, ScreensetsConfig, ChangeThemePayload, ShowPopupPayload, SetLanguagePayload, ThemeRegistry } from './types.cjs';
 export { HAI3Store, PluginFactory, PluginLifecycle, PluginProvides, Preset, RouterMode, ThemeApplyFn, ThemeConfig, UikitTheme } from './types.cjs';
-import { Extension, ExtensionDomain, MfeHandler } from '@hai3/screensets';
-export { Action, ActionsChain, ChildMfeBridge, ContainerProvider, Extension, ExtensionDomain, ExtensionPresentation, HAI3_ACTION_LOAD_EXT, HAI3_ACTION_MOUNT_EXT, HAI3_ACTION_UNMOUNT_EXT, HAI3_SCREEN_EXTENSION_TYPE, HAI3_SHARED_PROPERTY_LANGUAGE, HAI3_SHARED_PROPERTY_THEME, JSONSchema, LayoutDomain, LifecycleHook, LifecycleStage, LoadExtPayload, MfeBridgeFactory, MfeEntry, MfeEntryLifecycle, MfeEntryMF, MfeHandler, MountExtPayload, ParentMfeBridge, ScreenExtension, ScreensetsRegistry, ScreensetsRegistryConfig, ScreensetsRegistryFactory, SharedProperty, TypeSystemPlugin, UnmountExtPayload, ValidationError, ValidationResult, createShadowRoot, extractGtsPackage, injectCssVariables, screensetsRegistryFactory } from '@hai3/screensets';
+import { Extension, ExtensionDomain, TypeSystemPlugin, MfeHandler } from '@hai3/screensets';
+export { Action, ActionsChain, ChildMfeBridge, ContainerProvider, Extension, ExtensionDomain, ExtensionPresentation, HAI3_ACTION_LOAD_EXT, HAI3_ACTION_MOUNT_EXT, HAI3_ACTION_UNMOUNT_EXT, HAI3_MFE_ENTRY_MF, HAI3_SCREEN_EXTENSION_TYPE, HAI3_SHARED_PROPERTY_LANGUAGE, HAI3_SHARED_PROPERTY_THEME, JSONSchema, LayoutDomain, LifecycleHook, LifecycleStage, LoadExtPayload, MfeBridgeFactory, MfeEntry, MfeEntryLifecycle, MfeEntryMF, MfeHandler, MountExtPayload, ParentMfeBridge, ScreenExtension, ScreensetsRegistry, ScreensetsRegistryConfig, ScreensetsRegistryFactory, SharedProperty, TypeSystemPlugin, UnmountExtPayload, ValidationError, ValidationResult, createShadowRoot, extractGtsPackage, injectCssVariables, screensetsRegistryFactory } from '@hai3/screensets';
 export { MfeHandlerMF } from '@hai3/screensets/mfe/handler';
 export { gtsPlugin } from '@hai3/screensets/plugins/gts';
 import * as _hai3_state from '@hai3/state';
@@ -274,6 +274,11 @@ declare const overlayDomain: ExtensionDomain;
  * Configuration for the microfrontends plugin.
  */
 interface MicrofrontendsConfig {
+    /**
+     * Type system plugin for entity validation.
+     * The registry uses this for domain, extension, and handler type validation.
+     */
+    typeSystem: TypeSystemPlugin;
     /**
      * Optional MFE handlers to register with the screensets registry.
      * Handlers enable loading of specific MFE entry types (e.g., MfeEntryMF).
@@ -292,7 +297,7 @@ interface MicrofrontendsConfig {
  * **Key Principles:**
  * - Optional mfeHandlers config for handler registration
  * - NO static domain registration - domains are registered at runtime
- * - Builds screensetsRegistry with GTS plugin at plugin initialization
+ * - Builds screensetsRegistry with provided TypeSystemPlugin at plugin initialization
  * - Same TypeSystemPlugin instance is propagated throughout
  * - Integrates MFE lifecycle with Flux data flow (actions, effects, slice)
  *
@@ -301,11 +306,14 @@ interface MicrofrontendsConfig {
  * @example
  * ```typescript
  * import { createHAI3, microfrontends } from '@hai3/framework';
- * import { MfeHandlerMF } from '@hai3/screensets/mfe/handler';
+ * import { MfeHandlerMF, HAI3_MFE_ENTRY_MF } from '@hai3/screensets/mfe/handler';
  * import { gtsPlugin } from '@hai3/screensets/plugins/gts';
  *
  * const app = createHAI3()
- *   .use(microfrontends({ mfeHandlers: [new MfeHandlerMF(gtsPlugin)] }))
+ *   .use(microfrontends({
+ *     typeSystem: gtsPlugin,
+ *     mfeHandlers: [new MfeHandlerMF(HAI3_MFE_ENTRY_MF)],
+ *   }))
  *   .build();
  *
  * // Register domains dynamically at runtime:
@@ -316,7 +324,7 @@ interface MicrofrontendsConfig {
  * app.actions.mountExtension('my.extension.v1');
  * ```
  */
-declare function microfrontends(config?: MicrofrontendsConfig): HAI3Plugin;
+declare function microfrontends(config: MicrofrontendsConfig): HAI3Plugin;
 
 /**
  * Presets - Pre-configured plugin combinations
@@ -351,13 +359,13 @@ interface FullPresetConfig {
  * @example
  * ```typescript
  * import { applyTheme } from '@hai3/uikit';
- * import { MfeHandlerMF } from '@hai3/screensets/mfe/handler';
+ * import { MfeHandlerMF, HAI3_MFE_ENTRY_MF } from '@hai3/screensets/mfe/handler';
  * import { gtsPlugin } from '@hai3/screensets/plugins/gts';
  *
  * const app = createHAI3()
  *   .use(full({
  *     themes: { applyFn: applyTheme },
- *     microfrontends: { mfeHandlers: [new MfeHandlerMF(gtsPlugin)] }
+ *     microfrontends: { typeSystem: gtsPlugin, mfeHandlers: [new MfeHandlerMF(HAI3_MFE_ENTRY_MF)] }
  *   }))
  *   .build();
  * ```
@@ -424,19 +432,6 @@ interface HAI3AppConfig extends HAI3Config, FullPresetConfig {
  */
 declare function createHAI3App(config?: HAI3AppConfig): HAI3App;
 
-/**
- * Screensets Plugin - Provides screenset registry and screen slice
- *
- * This is the minimal plugin for screenset orchestration.
- * It does NOT include navigation actions - those are in the navigation plugin.
- *
- * Framework Layer: L2
- *
- * NOTE: Translations are NOT handled by this plugin. Screensets register
- * their translations directly with i18nRegistry via framework re-exports.
- * This maintains clean separation: @hai3/screensets has zero knowledge of i18n.
- */
-
 /**
  * Screensets plugin factory.
  *
@@ -934,13 +929,6 @@ declare module '@hai3/state' {
  */
 declare function initTenantEffects(): () => void;
 
-/**
- * Tenant Actions
- *
- * Action functions for setting and clearing tenant.
- * These emit events that are consumed by tenantEffects.
- */
-
 /**
  * Set tenant via event bus
  * This is the recommended way for consuming apps to set tenant.

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { HAI3Config, HAI3AppBuilder, HAI3Plugin, ThemesConfig, Presets, HAI3App, ScreensetsConfig, ChangeThemePayload, ShowPopupPayload, SetLanguagePayload, ThemeRegistry } from './types.js';
 export { HAI3Store, PluginFactory, PluginLifecycle, PluginProvides, Preset, RouterMode, ThemeApplyFn, ThemeConfig, UikitTheme } from './types.js';
-import { Extension, ExtensionDomain, MfeHandler } from '@hai3/screensets';
-export { Action, ActionsChain, ChildMfeBridge, ContainerProvider, Extension, ExtensionDomain, ExtensionPresentation, HAI3_ACTION_LOAD_EXT, HAI3_ACTION_MOUNT_EXT, HAI3_ACTION_UNMOUNT_EXT, HAI3_SCREEN_EXTENSION_TYPE, HAI3_SHARED_PROPERTY_LANGUAGE, HAI3_SHARED_PROPERTY_THEME, JSONSchema, LayoutDomain, LifecycleHook, LifecycleStage, LoadExtPayload, MfeBridgeFactory, MfeEntry, MfeEntryLifecycle, MfeEntryMF, MfeHandler, MountExtPayload, ParentMfeBridge, ScreenExtension, ScreensetsRegistry, ScreensetsRegistryConfig, ScreensetsRegistryFactory, SharedProperty, TypeSystemPlugin, UnmountExtPayload, ValidationError, ValidationResult, createShadowRoot, extractGtsPackage, injectCssVariables, screensetsRegistryFactory } from '@hai3/screensets';
+import { Extension, ExtensionDomain, TypeSystemPlugin, MfeHandler } from '@hai3/screensets';
+export { Action, ActionsChain, ChildMfeBridge, ContainerProvider, Extension, ExtensionDomain, ExtensionPresentation, HAI3_ACTION_LOAD_EXT, HAI3_ACTION_MOUNT_EXT, HAI3_ACTION_UNMOUNT_EXT, HAI3_MFE_ENTRY_MF, HAI3_SCREEN_EXTENSION_TYPE, HAI3_SHARED_PROPERTY_LANGUAGE, HAI3_SHARED_PROPERTY_THEME, JSONSchema, LayoutDomain, LifecycleHook, LifecycleStage, LoadExtPayload, MfeBridgeFactory, MfeEntry, MfeEntryLifecycle, MfeEntryMF, MfeHandler, MountExtPayload, ParentMfeBridge, ScreenExtension, ScreensetsRegistry, ScreensetsRegistryConfig, ScreensetsRegistryFactory, SharedProperty, TypeSystemPlugin, UnmountExtPayload, ValidationError, ValidationResult, createShadowRoot, extractGtsPackage, injectCssVariables, screensetsRegistryFactory } from '@hai3/screensets';
 export { MfeHandlerMF } from '@hai3/screensets/mfe/handler';
 export { gtsPlugin } from '@hai3/screensets/plugins/gts';
 import * as _hai3_state from '@hai3/state';
@@ -274,6 +274,11 @@ declare const overlayDomain: ExtensionDomain;
  * Configuration for the microfrontends plugin.
  */
 interface MicrofrontendsConfig {
+    /**
+     * Type system plugin for entity validation.
+     * The registry uses this for domain, extension, and handler type validation.
+     */
+    typeSystem: TypeSystemPlugin;
     /**
      * Optional MFE handlers to register with the screensets registry.
      * Handlers enable loading of specific MFE entry types (e.g., MfeEntryMF).
@@ -292,7 +297,7 @@ interface MicrofrontendsConfig {
  * **Key Principles:**
  * - Optional mfeHandlers config for handler registration
  * - NO static domain registration - domains are registered at runtime
- * - Builds screensetsRegistry with GTS plugin at plugin initialization
+ * - Builds screensetsRegistry with provided TypeSystemPlugin at plugin initialization
  * - Same TypeSystemPlugin instance is propagated throughout
  * - Integrates MFE lifecycle with Flux data flow (actions, effects, slice)
  *
@@ -301,11 +306,14 @@ interface MicrofrontendsConfig {
  * @example
  * ```typescript
  * import { createHAI3, microfrontends } from '@hai3/framework';
- * import { MfeHandlerMF } from '@hai3/screensets/mfe/handler';
+ * import { MfeHandlerMF, HAI3_MFE_ENTRY_MF } from '@hai3/screensets/mfe/handler';
  * import { gtsPlugin } from '@hai3/screensets/plugins/gts';
  *
  * const app = createHAI3()
- *   .use(microfrontends({ mfeHandlers: [new MfeHandlerMF(gtsPlugin)] }))
+ *   .use(microfrontends({
+ *     typeSystem: gtsPlugin,
+ *     mfeHandlers: [new MfeHandlerMF(HAI3_MFE_ENTRY_MF)],
+ *   }))
  *   .build();
  *
  * // Register domains dynamically at runtime:
@@ -316,7 +324,7 @@ interface MicrofrontendsConfig {
  * app.actions.mountExtension('my.extension.v1');
  * ```
  */
-declare function microfrontends(config?: MicrofrontendsConfig): HAI3Plugin;
+declare function microfrontends(config: MicrofrontendsConfig): HAI3Plugin;
 
 /**
  * Presets - Pre-configured plugin combinations
@@ -351,13 +359,13 @@ interface FullPresetConfig {
  * @example
  * ```typescript
  * import { applyTheme } from '@hai3/uikit';
- * import { MfeHandlerMF } from '@hai3/screensets/mfe/handler';
+ * import { MfeHandlerMF, HAI3_MFE_ENTRY_MF } from '@hai3/screensets/mfe/handler';
  * import { gtsPlugin } from '@hai3/screensets/plugins/gts';
  *
  * const app = createHAI3()
  *   .use(full({
  *     themes: { applyFn: applyTheme },
- *     microfrontends: { mfeHandlers: [new MfeHandlerMF(gtsPlugin)] }
+ *     microfrontends: { typeSystem: gtsPlugin, mfeHandlers: [new MfeHandlerMF(HAI3_MFE_ENTRY_MF)] }
  *   }))
  *   .build();
  * ```
@@ -424,19 +432,6 @@ interface HAI3AppConfig extends HAI3Config, FullPresetConfig {
  */
 declare function createHAI3App(config?: HAI3AppConfig): HAI3App;
 
-/**
- * Screensets Plugin - Provides screenset registry and screen slice
- *
- * This is the minimal plugin for screenset orchestration.
- * It does NOT include navigation actions - those are in the navigation plugin.
- *
- * Framework Layer: L2
- *
- * NOTE: Translations are NOT handled by this plugin. Screensets register
- * their translations directly with i18nRegistry via framework re-exports.
- * This maintains clean separation: @hai3/screensets has zero knowledge of i18n.
- */
-
 /**
  * Screensets plugin factory.
  *
@@ -934,13 +929,6 @@ declare module '@hai3/state' {
  */
 declare function initTenantEffects(): () => void;
 
-/**
- * Tenant Actions
- *
- * Action functions for setting and clearing tenant.
- * These emit events that are consumed by tenantEffects.
- */
-
 /**
  * Set tenant via event bus
  * This is the recommended way for consuming apps to set tenant.

package/dist/index.js

@@ -22,6 +22,8 @@ var HAI3AppBuilderImpl = class {
    * Add a plugin to the application.
    * Also accepts an array of plugins (for preset support).
    */
+  // @cpt-begin:cpt-hai3-flow-framework-composition-app-bootstrap:p1:inst-1
+  // @cpt-begin:cpt-hai3-state-framework-composition-builder:p1:inst-1
   use(plugin) {
     if (Array.isArray(plugin)) {
       plugin.forEach((p) => this.use(p));
@@ -39,6 +41,8 @@ var HAI3AppBuilderImpl = class {
     this.plugins.push(resolved);
     return this;
   }
+  // @cpt-end:cpt-hai3-flow-framework-composition-app-bootstrap:p1:inst-1
+  // @cpt-end:cpt-hai3-state-framework-composition-builder:p1:inst-1
   /**
    * Add multiple plugins at once.
    */
@@ -49,6 +53,8 @@ var HAI3AppBuilderImpl = class {
   /**
    * Build the application.
    */
+  // @cpt-begin:cpt-hai3-flow-framework-composition-app-bootstrap:p1:inst-2
+  // @cpt-begin:cpt-hai3-state-framework-composition-builder:p1:inst-2
   build() {
     const orderedPlugins = this.resolveDependencies();
     orderedPlugins.forEach((plugin) => {
@@ -78,9 +84,13 @@ var HAI3AppBuilderImpl = class {
     });
     return app;
   }
+  // @cpt-end:cpt-hai3-flow-framework-composition-app-bootstrap:p1:inst-2
+  // @cpt-end:cpt-hai3-state-framework-composition-builder:p1:inst-2
   /**
    * Resolve plugin dependencies using topological sort.
    */
+  // @cpt-begin:cpt-hai3-algo-framework-composition-dep-resolution:p1:inst-1
+  // @cpt-begin:cpt-hai3-flow-framework-composition-plugin-dependency:p1:inst-2
   resolveDependencies() {
     const resolved = [];
     const visited = /* @__PURE__ */ new Set();
@@ -119,9 +129,12 @@ Add the missing plugin: .use(${depName}())`
     this.plugins.forEach(visit);
     return resolved;
   }
+  // @cpt-end:cpt-hai3-algo-framework-composition-dep-resolution:p1:inst-1
+  // @cpt-end:cpt-hai3-flow-framework-composition-plugin-dependency:p1:inst-2
   /**
    * Aggregate all provides from plugins.
    */
+  // @cpt-begin:cpt-hai3-algo-framework-composition-provides-aggregation:p1:inst-1
   aggregateProvides(plugins) {
     const registries = {};
     const slices = [];
@@ -144,6 +157,7 @@ Add the missing plugin: .use(${depName}())`
     });
     return { registries, slices, effects: effects2, actions: actions2 };
   }
+  // @cpt-end:cpt-hai3-algo-framework-composition-provides-aggregation:p1:inst-1
   /**
    * Create store with all aggregated slices.
    *
@@ -166,6 +180,7 @@ Add the missing plugin: .use(${depName}())`
   /**
    * Destroy the app and cleanup resources.
    */
+  // @cpt-begin:cpt-hai3-flow-framework-composition-teardown:p2:inst-1
   destroyApp(plugins, app) {
     [...plugins].reverse().forEach((plugin) => {
       if (plugin.onDestroy) {
@@ -173,6 +188,7 @@ Add the missing plugin: .use(${depName}())`
       }
     });
   }
+  // @cpt-end:cpt-hai3-flow-framework-composition-teardown:p2:inst-1
 };
 function createHAI3(config) {
   return new HAI3AppBuilderImpl(config);
@@ -631,6 +647,8 @@ function themes(config) {
         changeTheme
       }
     },
+    // @cpt-begin:cpt-hai3-flow-framework-composition-theme-propagation:p1:inst-2
+    // @cpt-begin:cpt-hai3-dod-framework-composition-propagation:p1:inst-1
     onInit(app) {
       eventBus.on("theme/changed", (payload) => {
         themeRegistry.apply(payload.themeId);
@@ -645,6 +663,8 @@ function themes(config) {
         themeRegistry.apply(themes2[0].id);
       }
     }
+    // @cpt-end:cpt-hai3-flow-framework-composition-theme-propagation:p1:inst-2
+    // @cpt-end:cpt-hai3-dod-framework-composition-propagation:p1:inst-1
   };
 }
 
@@ -746,6 +766,8 @@ function i18n() {
         setLanguage
       }
     },
+    // @cpt-begin:cpt-hai3-flow-framework-composition-i18n-propagation:p1:inst-2
+    // @cpt-begin:cpt-hai3-dod-framework-composition-propagation:p1:inst-2
     onInit(app) {
       eventBus3.on("i18n/language/changed", async (payload) => {
         await i18nRegistry2.setLanguage(payload.language);
@@ -759,6 +781,8 @@ function i18n() {
         console.warn("[HAI3] Failed to load initial translations:", err);
       });
     }
+    // @cpt-end:cpt-hai3-flow-framework-composition-i18n-propagation:p1:inst-2
+    // @cpt-end:cpt-hai3-dod-framework-composition-propagation:p1:inst-2
   };
 }
 
@@ -859,7 +883,6 @@ import {
   HAI3_ACTION_MOUNT_EXT as HAI3_ACTION_MOUNT_EXT3,
   HAI3_ACTION_UNMOUNT_EXT as HAI3_ACTION_UNMOUNT_EXT3
 } from "@hai3/screensets";
-import { gtsPlugin } from "@hai3/screensets/plugins/gts";
 import { getStore as getStore4 } from "@hai3/state";
 
 // src/plugins/microfrontends/slice.ts
@@ -1087,9 +1110,9 @@ var overlayDomain = {
 };
 
 // src/plugins/microfrontends/index.ts
-function microfrontends(config = {}) {
+function microfrontends(config) {
   const screensetsRegistry2 = screensetsRegistryFactory.build({
-    typeSystem: gtsPlugin,
+    typeSystem: config.typeSystem,
     mfeHandlers: config.mfeHandlers
   });
   const originalExecuteActionsChain = screensetsRegistry2.executeActionsChain.bind(screensetsRegistry2);
@@ -1150,15 +1173,18 @@ function microfrontends(config = {}) {
 
 // src/presets/index.ts
 function full(config) {
-  return [
+  const plugins = [
     effects(),
     screensets({ autoDiscover: true }),
     themes(config?.themes),
     layout(),
     i18n(),
-    mock(),
-    microfrontends(config?.microfrontends)
+    mock()
   ];
+  if (config?.microfrontends) {
+    plugins.push(microfrontends(config.microfrontends));
+  }
+  return plugins;
 }
 function minimal() {
   return [
@@ -1187,7 +1213,8 @@ function createHAI3App(config) {
 
 // src/index.ts
 import {
-  HAI3_SCREEN_EXTENSION_TYPE as HAI3_SCREEN_EXTENSION_TYPE2
+  HAI3_SCREEN_EXTENSION_TYPE as HAI3_SCREEN_EXTENSION_TYPE2,
+  HAI3_MFE_ENTRY_MF
 } from "@hai3/screensets";
 import {
   HAI3_ACTION_LOAD_EXT as HAI3_ACTION_LOAD_EXT3,
@@ -1207,7 +1234,7 @@ import {
   ContainerProvider
 } from "@hai3/screensets";
 import { MfeHandlerMF } from "@hai3/screensets/mfe/handler";
-import { gtsPlugin as gtsPlugin2 } from "@hai3/screensets/plugins/gts";
+import { gtsPlugin } from "@hai3/screensets/plugins/gts";
 import {
   createShadowRoot,
   injectCssVariables,
@@ -1351,6 +1378,7 @@ export {
   HAI3_ACTION_LOAD_EXT3 as HAI3_ACTION_LOAD_EXT,
   HAI3_ACTION_MOUNT_EXT4 as HAI3_ACTION_MOUNT_EXT,
   HAI3_ACTION_UNMOUNT_EXT4 as HAI3_ACTION_UNMOUNT_EXT,
+  HAI3_MFE_ENTRY_MF,
   HAI3_OVERLAY_DOMAIN,
   HAI3_POPUP_DOMAIN,
   HAI3_SCREEN_DOMAIN,
@@ -1421,7 +1449,7 @@ export {
   getLanguageMetadata,
   getLayoutDomainState,
   getStore7 as getStore,
-  gtsPlugin2 as gtsPlugin,
+  gtsPlugin,
   hasLegacyUicoreState,
   hasNewLayoutState,
   hasSlice,