@hai3/framework 0.2.0-alpha.1 → 0.2.0-alpha.2

package/CLAUDE.md

@@ -57,6 +57,35 @@ const headlessApp = createHAI3()
 | `routing()` | routeRegistry, URL sync | screensets |
 | `i18n()` | i18nRegistry, setLanguage action | - |
 | `effects()` | Core effect coordination | - |
+| `mock()` | mockSlice, toggleMockMode action | effects |
+
+### Mock Mode Control
+
+The `mock()` plugin provides centralized mock mode control. It's included in the `full()` preset by default, so apps don't need manual setup:
+
+```typescript
+import { createHAI3App } from '@hai3/framework';
+
+// Full preset includes mock plugin automatically
+const app = createHAI3App();
+
+// Toggle mock mode via actions (used by HAI3 Studio ApiModeToggle)
+app.actions.toggleMockMode(true);  // Activates all registered mock plugins
+app.actions.toggleMockMode(false); // Deactivates all registered mock plugins
+```
+
+For custom plugin compositions:
+
+```typescript
+import { createHAI3, effects, mock } from '@hai3/framework';
+
+const app = createHAI3()
+  .use(effects())  // Required dependency
+  .use(mock())     // Automatic mock mode control
+  .build();
+```
+
+Services register mock plugins using `registerPlugin()` in their constructor. The framework automatically manages plugin activation based on mock mode state.
 
 ### Built Application
 
@@ -125,7 +154,7 @@ For convenience, this package re-exports from SDK packages:
 
 - From @hai3/state: `eventBus`, `createStore`, `getStore`, `registerSlice`, `hasSlice`, `createSlice`
 - From @hai3/screensets: `LayoutDomain`, `ScreensetCategory`, `screensetRegistry`, contracts/types
-- From @hai3/api: `apiRegistry`, `BaseApiService`, `RestProtocol`, `MockPlugin`
+- From @hai3/api: `apiRegistry`, `BaseApiService`, `RestProtocol`, `RestMockPlugin`, `SseMockPlugin`, `MOCK_PLUGIN`, `isMockPlugin`
 - From @hai3/i18n: `i18nRegistry`, `Language`, `SUPPORTED_LANGUAGES`, `getLanguageMetadata`
 
 **Layout Slices (owned by @hai3/framework):**
@@ -149,7 +178,7 @@ const menu = useAppSelector((state: RootStateWithLayout) => state.layout.menu);
 - `presets` - Available presets (full, minimal, headless)
 
 ### Plugins
-- `screensets`, `themes`, `layout`, `navigation`, `routing`, `i18n`, `effects`
+- `screensets`, `themes`, `layout`, `navigation`, `routing`, `i18n`, `effects`, `mock`
 
 ### Registries
 - `createScreensetRegistry`, `createThemeRegistry`, `createRouteRegistry`

package/commands/hai3-quick-ref.md

@@ -27,10 +27,8 @@
 - REQUIRED: Screen files orchestrate components only.
 
 ## Registry
-- REQUIRED: export const MY_DOMAIN = 'my-domain'.
 - REQUIRED: class MyService extends BaseApiService.
-- REQUIRED: declare module '@hai3/api' { interface ApiServicesMap }.
-- REQUIRED: apiRegistry.register(MY_DOMAIN, MyService).
+- REQUIRED: apiRegistry.register(MyService).
 
 ## Styling
 - Inline styles ONLY in screensets/*/uikit/base/ (rare local primitives).