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

package/commands/hai3-new-action.md

@@ -5,8 +5,7 @@
 1) Read .ai/targets/EVENTS.md before starting.
 2) Summarize 3-6 key rules.
 3) Gather requirements from user.
-4) Create OpenSpec proposal for approval.
-5) After approval, apply implementation.
+4) Implement.
 
 ## GATHER REQUIREMENTS
 Ask user for:
@@ -14,44 +13,9 @@ Ask user for:
 - Which screenset and domain (e.g., "chat/threads", "demo/navigation").
 - Event payload data.
 
-## STEP 1: Create OpenSpec Proposal
-Create `openspec/changes/add-{screenset}-{action}/` with:
+## STEP 1: Implementation
 
-### proposal.md
-```markdown
-# Proposal: Add {ActionName} Action
-
-## Summary
-Add new action "{actionName}" to {screenset}/{domain} domain.
-
-## Details
-- Screenset: {screenset}
-- Domain: {domain}
-- Action: {actionName}
-- Event: {eventName}
-- Payload: {payloadFields}
-
-## Implementation
-Follow HAI3 event-driven flux pattern: Action -> Event -> Effect -> Slice.
-```
-
-### tasks.md
-```markdown
-# Tasks: Add {ActionName} Action
-
-- [ ] Define event in events/{domain}Events.ts
-- [ ] Create action in actions/{domain}Actions.ts
-- [ ] Create effect in effects/{domain}Effects.ts
-- [ ] Validate: `npm run arch:check`
-```
-
-## STEP 2: Wait for Approval
-Tell user: "I've created an OpenSpec proposal at `openspec/changes/add-{screenset}-{action}/`. Please review and run `/openspec:apply add-{screenset}-{action}` to implement."
-
-## STEP 3: Apply Implementation (after approval)
-When user runs `/openspec:apply`, execute:
-
-### 3.1 Define Event
+### 1.1 Define Event
 In src/screensets/{screenset}/events/{domain}Events.ts:
 ```typescript
 import { SCREENSET_ID } from '../ids';
@@ -73,7 +37,7 @@ declare module '@hai3/state' {
 }
 ```
 
-### 3.2 Create Action
+### 1.2 Create Action
 In src/screensets/{screenset}/actions/{domain}Actions.ts:
 ```typescript
 import { eventBus } from '@hai3/state';
@@ -88,7 +52,7 @@ export const {actionName} = (params: ParamsType) => {
 };
 ```
 
-### 3.3 Create Effect
+### 1.3 Create Effect
 In src/screensets/{screenset}/effects/{domain}Effects.ts:
 ```typescript
 import { eventBus, getStore } from '@hai3/state';
@@ -102,14 +66,11 @@ export function init{Domain}Effects(): void {
 }
 ```
 
-### 3.4 Validate
+### 1.4 Validate
 ```bash
 npm run arch:check
 ```
 
-### 3.5 Mark Tasks Complete
-Update tasks.md to mark all completed tasks.
-
 ## RULES
 - Actions use imperative names (selectScreen, changeTheme).
 - Events use past-tense names (screenSelected, themeChanged).

package/dist/index.cjs

@@ -29,6 +29,7 @@ __export(src_exports, {
   HAI3_ACTION_LOAD_EXT: () => import_screensets9.HAI3_ACTION_LOAD_EXT,
   HAI3_ACTION_MOUNT_EXT: () => import_screensets9.HAI3_ACTION_MOUNT_EXT,
   HAI3_ACTION_UNMOUNT_EXT: () => import_screensets9.HAI3_ACTION_UNMOUNT_EXT,
+  HAI3_MFE_ENTRY_MF: () => import_screensets8.HAI3_MFE_ENTRY_MF,
   HAI3_OVERLAY_DOMAIN: () => HAI3_OVERLAY_DOMAIN,
   HAI3_POPUP_DOMAIN: () => HAI3_POPUP_DOMAIN,
   HAI3_SCREEN_DOMAIN: () => HAI3_SCREEN_DOMAIN,
@@ -99,7 +100,7 @@ __export(src_exports, {
   getLanguageMetadata: () => import_i18n4.getLanguageMetadata,
   getLayoutDomainState: () => getLayoutDomainState,
   getStore: () => import_state21.getStore,
-  gtsPlugin: () => import_gts2.gtsPlugin,
+  gtsPlugin: () => import_gts.gtsPlugin,
   hasLegacyUicoreState: () => hasLegacyUicoreState,
   hasNewLayoutState: () => hasNewLayoutState,
   hasSlice: () => import_state21.hasSlice,
@@ -211,6 +212,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));
@@ -228,6 +231,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.
    */
@@ -238,6 +243,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) => {
@@ -267,9 +274,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();
@@ -308,9 +319,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 = [];
@@ -333,6 +347,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.
    *
@@ -355,6 +370,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) {
@@ -362,6 +378,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);
@@ -820,6 +837,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) {
       import_state11.eventBus.on("theme/changed", (payload) => {
         themeRegistry.apply(payload.themeId);
@@ -834,6 +853,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
   };
 }
 
@@ -935,6 +956,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) {
       import_state13.eventBus.on("i18n/language/changed", async (payload) => {
         await i18nRegistry2.setLanguage(payload.language);
@@ -948,6 +971,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
   };
 }
 
@@ -1044,7 +1069,6 @@ function mock(config) {
 
 // src/plugins/microfrontends/index.ts
 var import_screensets5 = require("@hai3/screensets");
-var import_gts = require("@hai3/screensets/plugins/gts");
 var import_state18 = require("@hai3/state");
 
 // src/plugins/microfrontends/slice.ts
@@ -1261,9 +1285,9 @@ var overlayDomain = {
 };
 
 // src/plugins/microfrontends/index.ts
-function microfrontends(config = {}) {
+function microfrontends(config) {
   const screensetsRegistry2 = import_screensets5.screensetsRegistryFactory.build({
-    typeSystem: import_gts.gtsPlugin,
+    typeSystem: config.typeSystem,
     mfeHandlers: config.mfeHandlers
   });
   const originalExecuteActionsChain = screensetsRegistry2.executeActionsChain.bind(screensetsRegistry2);
@@ -1324,15 +1348,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 [
@@ -1365,7 +1392,7 @@ var import_screensets9 = require("@hai3/screensets");
 var import_screensets10 = require("@hai3/screensets");
 var import_screensets11 = require("@hai3/screensets");
 var import_handler = require("@hai3/screensets/mfe/handler");
-var import_gts2 = require("@hai3/screensets/plugins/gts");
+var import_gts = require("@hai3/screensets/plugins/gts");
 var import_screensets12 = require("@hai3/screensets");
 var import_state21 = require("@hai3/state");
 var import_screensets13 = require("@hai3/screensets");
@@ -1475,6 +1502,7 @@ function hasNewLayoutState(state) {
   HAI3_ACTION_LOAD_EXT,
   HAI3_ACTION_MOUNT_EXT,
   HAI3_ACTION_UNMOUNT_EXT,
+  HAI3_MFE_ENTRY_MF,
   HAI3_OVERLAY_DOMAIN,
   HAI3_POPUP_DOMAIN,
   HAI3_SCREEN_DOMAIN,