@hai3/framework 0.2.0-alpha.0

package/dist/index.d.ts

@@ -0,0 +1,842 @@
+import { HAI3Config, HAI3AppBuilder, HAI3App, ScreensetsConfig, HAI3Plugin, ChangeThemePayload, ShowPopupPayload, NavigateToScreenPayload, NavigateToScreensetPayload, SetLanguagePayload, Presets, ThemeRegistry, RouteRegistry } from './types.js';
+export { HAI3Store, LegacyTheme, PluginFactory, PluginLifecycle, PluginProvides, Preset, ThemeApplyFn, ThemeConfig } from './types.js';
+import { ScreensetRegistry } from '@hai3/screensets';
+export { LayoutDomain, MenuItemConfig, MenuScreenItem, ScreenConfig, ScreenId, ScreenLoader, ScreensetCategory, ScreensetDefinition as ScreensetConfig, ScreensetDefinition, ScreensetId, ScreensetRegistry, ScreensetRegistry as ScreensetRegistryContract, createScreensetRegistry, screensetRegistry } from '@hai3/screensets';
+import * as _hai3_state from '@hai3/state';
+import { AppDispatch } from '@hai3/state';
+export { AppDispatch, EffectInitializer, EventHandler, EventPayloadMap, ReducerPayload, RootState, SliceObject, Subscription, createSlice, createStore, eventBus, getStore, hasSlice, registerSlice } from '@hai3/state';
+import * as redux from 'redux';
+import * as _reduxjs_toolkit from '@reduxjs/toolkit';
+import { Reducer } from '@reduxjs/toolkit';
+export { ApiProtocol, ApiService, ApiServiceConfig, ApiServicesMap, BaseApiService, JsonCompatible, JsonObject, JsonPrimitive, JsonValue, MockMap, MockPlugin, RestProtocol, RestProtocolConfig, SseProtocol, SseProtocolConfig, apiRegistry } from '@hai3/api';
+export { I18nConfig, I18nRegistryImpl as I18nRegistry, I18nRegistryImpl, I18nRegistry as I18nRegistryType, Language, LanguageDisplayMode, LanguageMetadata, SUPPORTED_LANGUAGES, TextDirection, TranslationDictionary, TranslationLoader, TranslationMap, createI18nRegistry, getLanguageMetadata, i18nRegistry } from '@hai3/i18n';
+
+/**
+ * createHAI3 - App Builder Factory
+ *
+ * Creates a HAI3 app builder for custom plugin composition.
+ * This is the core of the plugin architecture.
+ *
+ * Framework Layer: L2 (Depends on SDK packages)
+ */
+
+/**
+ * Create a HAI3 app builder for custom plugin composition.
+ *
+ * @param config - Optional application configuration
+ * @returns App builder for plugin composition
+ *
+ * @example
+ * ```typescript
+ * const app = createHAI3()
+ *   .use(screensets())
+ *   .use(themes())
+ *   .build();
+ * ```
+ */
+declare function createHAI3(config?: HAI3Config): HAI3AppBuilder;
+
+/**
+ * createHAI3App - Convenience function for full HAI3 application
+ *
+ * Creates a fully configured HAI3 application using the full preset.
+ *
+ * Framework Layer: L2
+ */
+
+/**
+ * Create a fully configured HAI3 application.
+ *
+ * This is a convenience function that uses the full preset.
+ * For custom plugin composition, use `createHAI3()` instead.
+ *
+ * @param config - Optional application configuration
+ * @returns The built HAI3 application
+ *
+ * @example
+ * ```typescript
+ * // Default - uses full() preset
+ * const app = createHAI3App();
+ *
+ * // With configuration
+ * const app = createHAI3App({ devMode: true });
+ * ```
+ */
+declare function createHAI3App(config?: HAI3Config): 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.
+ *
+ * @param config - Plugin configuration
+ * @returns Screensets plugin
+ *
+ * @example
+ * ```typescript
+ * const app = createHAI3()
+ *   .use(screensets({ autoDiscover: true }))
+ *   .build();
+ * ```
+ */
+declare function screensets(config?: ScreensetsConfig): HAI3Plugin<ScreensetsConfig>;
+
+/**
+ * Themes Plugin - Provides theme registry and changeTheme action
+ *
+ * Framework Layer: L2
+ */
+
+declare module '@hai3/state' {
+    interface EventPayloadMap {
+        'theme/changed': ChangeThemePayload;
+    }
+}
+/**
+ * Themes plugin factory.
+ *
+ * @returns Themes plugin
+ *
+ * @example
+ * ```typescript
+ * const app = createHAI3()
+ *   .use(screensets())
+ *   .use(themes())
+ *   .build();
+ *
+ * app.actions.changeTheme({ themeId: 'dark' });
+ * ```
+ */
+declare function themes(): HAI3Plugin;
+
+/**
+ * Layout Plugin - Provides all layout domain slices and effects
+ *
+ * Framework Layer: L2
+ *
+ * NOTE: Layout slices are owned by @hai3/framework (not @hai3/uicore which is deprecated)
+ */
+
+declare module '@hai3/state' {
+    interface EventPayloadMap {
+        'layout/popup/requested': ShowPopupPayload;
+        'layout/popup/hidden': void;
+        'layout/overlay/requested': {
+            id: string;
+        };
+        'layout/overlay/hidden': void;
+        'layout/menu/collapsed': {
+            collapsed: boolean;
+        };
+        'layout/sidebar/collapsed': {
+            collapsed: boolean;
+        };
+    }
+}
+/**
+ * Layout plugin factory.
+ *
+ * @returns Layout plugin
+ *
+ * @example
+ * ```typescript
+ * const app = createHAI3()
+ *   .use(screensets())
+ *   .use(layout())
+ *   .build();
+ * ```
+ */
+declare function layout(): HAI3Plugin;
+
+/**
+ * Navigation Plugin - Provides navigation actions and URL sync
+ *
+ * Framework Layer: L2
+ *
+ * NOTE: Uses layout slices from @hai3/framework (not @hai3/uicore which is deprecated)
+ */
+
+declare module '@hai3/state' {
+    interface EventPayloadMap {
+        'navigation/screen/navigated': NavigateToScreenPayload;
+        'navigation/screenset/navigated': NavigateToScreensetPayload;
+    }
+}
+/**
+ * Navigation plugin factory.
+ *
+ * @returns Navigation plugin
+ *
+ * @example
+ * ```typescript
+ * const app = createHAI3()
+ *   .use(screensets())
+ *   .use(navigation())
+ *   .build();
+ *
+ * app.actions.navigateToScreen({ screensetId: 'demo', screenId: 'home' });
+ * ```
+ */
+declare function navigation(): HAI3Plugin;
+
+/**
+ * Routing Plugin - Provides route registry auto-synced from screensets
+ *
+ * Framework Layer: L2
+ */
+
+/**
+ * Routing plugin factory.
+ *
+ * @returns Routing plugin
+ *
+ * @example
+ * ```typescript
+ * const app = createHAI3()
+ *   .use(screensets())
+ *   .use(routing())
+ *   .build();
+ *
+ * // Check if a screen exists
+ * const exists = app.routeRegistry.hasScreen('demo', 'home');
+ * ```
+ */
+declare function routing(): HAI3Plugin;
+
+/**
+ * I18n Plugin - Provides i18n registry wiring and setLanguage action
+ *
+ * Framework Layer: L2
+ */
+
+declare module '@hai3/state' {
+    interface EventPayloadMap {
+        'i18n/language/changed': SetLanguagePayload;
+    }
+}
+/**
+ * I18n plugin factory.
+ *
+ * @returns I18n plugin
+ *
+ * @example
+ * ```typescript
+ * const app = createHAI3()
+ *   .use(i18n())
+ *   .build();
+ *
+ * app.actions.setLanguage({ language: 'de' });
+ * ```
+ */
+declare function i18n(): HAI3Plugin;
+
+/**
+ * Effects Plugin - Core effect coordination infrastructure
+ *
+ * Framework Layer: L2
+ */
+
+/**
+ * Effects plugin factory.
+ *
+ * Provides the core effect coordination infrastructure.
+ * Other plugins register their effects through this system.
+ *
+ * @returns Effects plugin
+ *
+ * @example
+ * ```typescript
+ * const app = createHAI3()
+ *   .use(effects())
+ *   .use(screensets())
+ *   .build();
+ * ```
+ */
+declare function effects(): HAI3Plugin;
+
+/**
+ * Presets - Pre-configured plugin combinations
+ *
+ * Framework Layer: L2
+ */
+
+/**
+ * Full preset - All plugins for the complete HAI3 experience.
+ * This is the default for `hai3 create` projects.
+ *
+ * Includes:
+ * - screensets (screenset registry, screen slice)
+ * - themes (theme registry, changeTheme action)
+ * - layout (all layout domain slices and effects)
+ * - navigation (navigateToScreen, navigateToScreenset actions)
+ * - routing (route registry auto-synced from screensets)
+ * - i18n (i18n registry, setLanguage action)
+ * - effects (effect coordination)
+ */
+declare function full(): HAI3Plugin[];
+/**
+ * Minimal preset - Screensets + themes only.
+ * For users who want basic HAI3 patterns without full layout management.
+ *
+ * Includes:
+ * - screensets (screenset registry, screen slice)
+ * - themes (theme registry, changeTheme action)
+ */
+declare function minimal(): HAI3Plugin[];
+/**
+ * Headless preset - Screensets only.
+ * For external platform integration where you only need screenset orchestration.
+ * The external platform provides its own menu, header, navigation, etc.
+ *
+ * Includes:
+ * - screensets (screenset registry, screen slice)
+ */
+declare function headless(): HAI3Plugin[];
+/**
+ * Presets collection
+ */
+declare const presets: Presets;
+
+/**
+ * Theme Registry - Manages theme registration and application
+ *
+ * Framework Layer: L2
+ */
+
+/**
+ * Create a new theme registry instance.
+ */
+declare function createThemeRegistry(): ThemeRegistry;
+
+/**
+ * Route Registry - Manages routes auto-synced from screensets
+ *
+ * Framework Layer: L2
+ */
+
+/**
+ * Create a new route registry instance.
+ *
+ * @param screensetRegistry - Screenset registry to sync from
+ */
+declare function createRouteRegistry(screensetRegistry: ScreensetRegistry): RouteRegistry;
+
+/**
+ * Layout State Types
+ *
+ * These types define the shape of layout state managed by framework slices.
+ * Defined here in framework to avoid circular dependencies between
+ * framework/react/uicore packages.
+ *
+ * At runtime, these types are satisfied by @hai3/framework slice implementations.
+ */
+/** Tenant entity */
+interface Tenant {
+    id: string;
+}
+/** Tenant state */
+interface TenantState {
+    tenant: Tenant | null;
+    loading: boolean;
+}
+/** User info displayed in header */
+interface HeaderUser {
+    displayName?: string;
+    email?: string;
+    avatarUrl?: string;
+}
+/** Header state with user info */
+interface HeaderState {
+    user: HeaderUser | null;
+    loading: boolean;
+}
+/** Header configuration */
+interface HeaderConfig {
+    user?: HeaderUser;
+}
+/** Footer state */
+interface FooterState {
+    screensetOptions: Array<{
+        category: string;
+        screensets: Array<{
+            id: string;
+            name: string;
+        }>;
+    }>;
+    visible: boolean;
+}
+/** Footer configuration */
+interface FooterConfig {
+    visible?: boolean;
+}
+/** Menu item */
+interface MenuItem {
+    id: string;
+    label: string;
+    icon?: string;
+    path?: string;
+    children?: MenuItem[];
+    disabled?: boolean;
+}
+/** Menu state */
+interface MenuState {
+    collapsed: boolean;
+    items: MenuItem[];
+    visible: boolean;
+}
+/** Sidebar position */
+type SidebarPosition = 'left' | 'right';
+/** Sidebar state */
+interface SidebarState {
+    collapsed: boolean;
+    position: SidebarPosition;
+    title: string | null;
+    content: unknown;
+    visible: boolean;
+    width: number;
+}
+/** Screen state */
+interface ScreenState {
+    activeScreen: string | null;
+    loading: boolean;
+}
+/** Single popup state */
+interface PopupState {
+    id: string;
+    title: string;
+    component: string;
+    props?: Record<string, unknown>;
+    zIndex: number;
+}
+/** Popup configuration */
+interface PopupConfig {
+    id: string;
+    title?: string;
+    component: string;
+    props?: Record<string, unknown>;
+}
+/** Overlay state */
+interface OverlayState {
+    visible: boolean;
+}
+/** Overlay configuration */
+interface OverlayConfig {
+    visible?: boolean;
+}
+/** Combined layout state (legacy) */
+interface LayoutState {
+    theme: string;
+    currentScreenset: string;
+    selectedScreen: string | null;
+}
+/** Layout domain state union */
+type LayoutDomainState = HeaderState | FooterState | MenuState | SidebarState | ScreenState | PopupState | OverlayState;
+/** Root state with layout */
+interface RootStateWithLayout {
+    layout: {
+        header: HeaderState;
+        footer: FooterState;
+        menu: MenuState;
+        sidebar: SidebarState;
+        screen: ScreenState;
+        popup: {
+            stack: PopupState[];
+        };
+        overlay: OverlayState;
+    };
+}
+/** Layout domain reducers type */
+type LayoutDomainReducers = Record<string, unknown>;
+
+declare const setUser: _reduxjs_toolkit.ActionCreatorWithPayload<HeaderUser | null, "layout/header/setUser">;
+declare const setLoading: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/header/setLoading">;
+declare const clearUser: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/header/clearUser">;
+declare const headerSlice: _hai3_state.SliceObject<HeaderState>;
+declare const headerActions: {
+    setUser: _reduxjs_toolkit.ActionCreatorWithPayload<HeaderUser | null, "layout/header/setUser">;
+    setLoading: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/header/setLoading">;
+    clearUser: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/header/clearUser">;
+};
+
+declare const setFooterVisible: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/footer/setFooterVisible">;
+declare const setFooterConfig: _reduxjs_toolkit.ActionCreatorWithPayload<Partial<FooterState>, "layout/footer/setFooterConfig">;
+declare const footerSlice: _hai3_state.SliceObject<FooterState>;
+
+declare const footerActions: {
+    setFooterVisible: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/footer/setFooterVisible">;
+    setFooterConfig: _reduxjs_toolkit.ActionCreatorWithPayload<Partial<FooterState>, "layout/footer/setFooterConfig">;
+};
+
+declare const toggleMenu: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/menu/toggleMenu">;
+declare const setMenuCollapsed: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/menu/setMenuCollapsed">;
+declare const setMenuItems: _reduxjs_toolkit.ActionCreatorWithPayload<MenuItem[], "layout/menu/setMenuItems">;
+declare const setMenuVisible: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/menu/setMenuVisible">;
+declare const setMenuConfig: _reduxjs_toolkit.ActionCreatorWithPayload<Partial<MenuState>, "layout/menu/setMenuConfig">;
+declare const menuSlice: _hai3_state.SliceObject<MenuState>;
+
+declare const menuActions: {
+    toggleMenu: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/menu/toggleMenu">;
+    setMenuCollapsed: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/menu/setMenuCollapsed">;
+    setMenuItems: _reduxjs_toolkit.ActionCreatorWithPayload<MenuItem[], "layout/menu/setMenuItems">;
+    setMenuVisible: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/menu/setMenuVisible">;
+    setMenuConfig: _reduxjs_toolkit.ActionCreatorWithPayload<Partial<MenuState>, "layout/menu/setMenuConfig">;
+};
+
+declare const toggleSidebar: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/sidebar/toggleSidebar">;
+declare const setSidebarCollapsed: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/sidebar/setSidebarCollapsed">;
+declare const setSidebarPosition: _reduxjs_toolkit.ActionCreatorWithPayload<SidebarPosition, "layout/sidebar/setSidebarPosition">;
+declare const setSidebarTitle: _reduxjs_toolkit.ActionCreatorWithPayload<string | null, "layout/sidebar/setSidebarTitle">;
+declare const setSidebarContent: _reduxjs_toolkit.ActionCreatorWithNonInferrablePayload<"layout/sidebar/setSidebarContent">;
+declare const setSidebarVisible: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/sidebar/setSidebarVisible">;
+declare const setSidebarWidth: _reduxjs_toolkit.ActionCreatorWithPayload<number, "layout/sidebar/setSidebarWidth">;
+declare const setSidebarConfig: _reduxjs_toolkit.ActionCreatorWithPayload<Partial<SidebarState>, "layout/sidebar/setSidebarConfig">;
+declare const sidebarSlice: _hai3_state.SliceObject<SidebarState>;
+
+declare const sidebarActions: {
+    toggleSidebar: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/sidebar/toggleSidebar">;
+    setSidebarCollapsed: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/sidebar/setSidebarCollapsed">;
+    setSidebarPosition: _reduxjs_toolkit.ActionCreatorWithPayload<SidebarPosition, "layout/sidebar/setSidebarPosition">;
+    setSidebarTitle: _reduxjs_toolkit.ActionCreatorWithPayload<string | null, "layout/sidebar/setSidebarTitle">;
+    setSidebarContent: _reduxjs_toolkit.ActionCreatorWithNonInferrablePayload<"layout/sidebar/setSidebarContent">;
+    setSidebarVisible: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/sidebar/setSidebarVisible">;
+    setSidebarWidth: _reduxjs_toolkit.ActionCreatorWithPayload<number, "layout/sidebar/setSidebarWidth">;
+    setSidebarConfig: _reduxjs_toolkit.ActionCreatorWithPayload<Partial<SidebarState>, "layout/sidebar/setSidebarConfig">;
+};
+
+declare const setActiveScreen: _reduxjs_toolkit.ActionCreatorWithPayload<string, "layout/screen/setActiveScreen">;
+declare const setScreenLoading: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/screen/setScreenLoading">;
+declare const navigateTo: _reduxjs_toolkit.ActionCreatorWithPayload<string, "layout/screen/navigateTo">;
+declare const clearActiveScreen: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/screen/clearActiveScreen">;
+declare const screenSlice: _hai3_state.SliceObject<ScreenState>;
+
+declare const screenActions: {
+    setActiveScreen: _reduxjs_toolkit.ActionCreatorWithPayload<string, "layout/screen/setActiveScreen">;
+    setScreenLoading: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/screen/setScreenLoading">;
+    navigateTo: _reduxjs_toolkit.ActionCreatorWithPayload<string, "layout/screen/navigateTo">;
+    clearActiveScreen: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/screen/clearActiveScreen">;
+};
+
+interface PopupSliceState {
+    stack: PopupState[];
+}
+declare const openPopup: _reduxjs_toolkit.ActionCreatorWithPayload<Omit<PopupState, "zIndex">, "layout/popup/openPopup">;
+declare const closePopup: _reduxjs_toolkit.ActionCreatorWithPayload<string, "layout/popup/closePopup">;
+declare const closeTopPopup: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/popup/closeTopPopup">;
+declare const closeAllPopups: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/popup/closeAllPopups">;
+declare const popupSlice: _hai3_state.SliceObject<PopupSliceState>;
+
+declare const popupActions: {
+    openPopup: _reduxjs_toolkit.ActionCreatorWithPayload<Omit<PopupState, "zIndex">, "layout/popup/openPopup">;
+    closePopup: _reduxjs_toolkit.ActionCreatorWithPayload<string, "layout/popup/closePopup">;
+    closeTopPopup: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/popup/closeTopPopup">;
+    closeAllPopups: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/popup/closeAllPopups">;
+};
+
+declare const showOverlay: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/overlay/showOverlay">;
+declare const hideOverlay: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/overlay/hideOverlay">;
+declare const setOverlayVisible: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/overlay/setOverlayVisible">;
+declare const overlaySlice: _hai3_state.SliceObject<OverlayState>;
+
+declare const overlayActions: {
+    showOverlay: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/overlay/showOverlay">;
+    hideOverlay: _reduxjs_toolkit.ActionCreatorWithoutPayload<"layout/overlay/hideOverlay">;
+    setOverlayVisible: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "layout/overlay/setOverlayVisible">;
+};
+
+declare const setTenant: _reduxjs_toolkit.ActionCreatorWithPayload<Tenant | null, "app/tenant/setTenant">;
+declare const setTenantLoading: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "app/tenant/setTenantLoading">;
+declare const clearTenant: _reduxjs_toolkit.ActionCreatorWithoutPayload<"app/tenant/clearTenant">;
+declare const tenantSlice: _hai3_state.SliceObject<TenantState>;
+declare const tenantActions: {
+    setTenant: _reduxjs_toolkit.ActionCreatorWithPayload<Tenant | null, "app/tenant/setTenant">;
+    setTenantLoading: _reduxjs_toolkit.ActionCreatorWithPayload<boolean, "app/tenant/setTenantLoading">;
+    clearTenant: _reduxjs_toolkit.ActionCreatorWithoutPayload<"app/tenant/clearTenant">;
+};
+
+declare const _default: redux.Reducer<TenantState>;
+
+declare const LAYOUT_SLICE_NAME: "layout";
+declare const TENANT_SLICE_NAME: "app/tenant";
+/** Explicit type for layout domain reducers to avoid incorrect dts generation */
+interface LayoutDomainReducersType {
+    header: Reducer<HeaderState>;
+    footer: Reducer<FooterState>;
+    menu: Reducer<MenuState>;
+    sidebar: Reducer<SidebarState>;
+    screen: Reducer<ScreenState>;
+    popup: Reducer<PopupSliceState>;
+    overlay: Reducer<OverlayState>;
+}
+declare const layoutDomainReducers: LayoutDomainReducersType;
+declare const layoutReducer: Reducer<{
+    header: HeaderState;
+    footer: FooterState;
+    menu: MenuState;
+    sidebar: SidebarState;
+    screen: ScreenState;
+    popup: PopupSliceState;
+    overlay: OverlayState;
+}, redux.UnknownAction, Partial<{
+    header: HeaderState | undefined;
+    footer: FooterState | undefined;
+    menu: MenuState | undefined;
+    sidebar: SidebarState | undefined;
+    screen: ScreenState | undefined;
+    popup: PopupSliceState | undefined;
+    overlay: OverlayState | undefined;
+}>>;
+
+/**
+ * Tenant Effects
+ *
+ * Listens for tenant events and updates the tenant slice.
+ * Event-driven architecture: consuming apps emit events, effects handle state updates.
+ */
+
+/** Tenant event names */
+declare const TenantEvents: {
+    readonly Changed: "app/tenant/changed";
+    readonly Cleared: "app/tenant/cleared";
+};
+/** Payload for tenant changed event */
+interface TenantChangedPayload {
+    tenant: Tenant;
+}
+/** Payload for tenant cleared event */
+interface TenantClearedPayload {
+}
+declare module '@hai3/state' {
+    interface EventPayloadMap {
+        'app/tenant/changed': TenantChangedPayload;
+        'app/tenant/cleared': TenantClearedPayload;
+    }
+}
+/**
+ * Initialize tenant effects
+ * Call this once during app bootstrap to start listening for tenant events.
+ */
+declare function initTenantEffects(): () => void;
+/**
+ * Set tenant via event bus
+ * This is the recommended way for consuming apps to set tenant.
+ *
+ * @example
+ * ```typescript
+ * import { changeTenant } from '@hai3/framework';
+ * changeTenant({ id: 'tenant-123' });
+ * ```
+ */
+declare function changeTenant(tenant: Tenant): void;
+/**
+ * Clear tenant via event bus
+ */
+declare function clearTenantAction(): void;
+/**
+ * Set tenant loading state (direct dispatch, for internal use)
+ */
+declare function setTenantLoadingState(loading: boolean): void;
+
+/**
+ * Backward Compatibility Exports
+ *
+ * These exports provide backward compatibility with @hai3/uicore API.
+ * They are singletons that mirror the old API.
+ *
+ * NOTE: These are exported for migration convenience but may be deprecated
+ * in future major versions. Prefer using the plugin architecture.
+ */
+
+declare const ACCOUNTS_DOMAIN: "accounts";
+
+/**
+ * Global theme registry singleton
+ *
+ * @deprecated Prefer using app.themeRegistry from createHAI3App()
+ */
+declare const themeRegistry: ThemeRegistry;
+/**
+ * Global route registry singleton
+ *
+ * @deprecated Prefer using app.routeRegistry from createHAI3App()
+ */
+declare const routeRegistry: RouteRegistry;
+/**
+ * Navigate to a screen by ID.
+ * Simply updates the active screen in the store.
+ *
+ * NOTE: This is a simplified backward-compatible function.
+ * For full navigation including screenset switching, use:
+ * - useNavigation().navigateToScreen(screensetId, screenId) hook
+ * - or app.actions.navigateToScreen({ screensetId, screenId })
+ *
+ * @param screenId Screen ID to navigate to
+ * @deprecated Use useNavigation() hook or app.actions.navigateToScreen()
+ */
+declare const navigateToScreen: (screenId: string) => void;
+/**
+ * Fetch current user from API
+ * Returns a thunk action that fetches user data.
+ *
+ * @deprecated Prefer using api services directly in actions
+ */
+declare const fetchCurrentUser: () => (_dispatch: AppDispatch) => void;
+
+/**
+ * Migration Helpers - Utilities for migrating from @hai3/uicore
+ *
+ * These helpers assist users migrating from the deprecated @hai3/uicore package
+ * to the new SDK architecture (@hai3/framework, @hai3/screensets, @hai3/react).
+ *
+ * Framework Layer: L2
+ */
+
+/**
+ * Legacy uicore state structure (for reference/backward compat)
+ */
+interface LegacyUicoreState {
+    app: {
+        user: unknown | null;
+        tenant: unknown | null;
+        language: string | null;
+        translationsReady: boolean;
+        screenTranslationsVersion: number;
+        loading: boolean;
+        error: string | null;
+        useMockApi: boolean;
+    };
+    layout: {
+        theme: string;
+        currentScreenset: string;
+        selectedScreen: string | null;
+    };
+    header: Record<string, unknown>;
+    footer: {
+        screensetOptions: unknown[];
+        visible: boolean;
+    };
+    menu: {
+        collapsed: boolean;
+        items: unknown[];
+        visible: boolean;
+    };
+    sidebar: {
+        collapsed: boolean;
+        position: string;
+        title: string | null;
+        content: unknown;
+        visible: boolean;
+    };
+    screen: {
+        activeScreen: string | null;
+        loading: boolean;
+    };
+    popup: {
+        stack: unknown[];
+    };
+    overlay: {
+        visible: boolean;
+    };
+}
+/**
+ * Legacy root state with uicore key
+ */
+interface LegacyRootState {
+    uicore: LegacyUicoreState;
+    [key: string]: unknown;
+}
+/**
+ * State accessor function type
+ * Note: "Selector" terminology avoided (Redux-specific). Use useAppSelector hook for state access.
+ */
+type Selector<TState, TResult> = (state: TState) => TResult;
+/**
+ * State path mapping from legacy to new structure
+ */
+declare const STATE_PATH_MAPPING: {
+    readonly 'uicore.app.user': "app.user";
+    readonly 'uicore.app.tenant': "app.tenant";
+    readonly 'uicore.app.language': "app.language";
+    readonly 'uicore.app.translationsReady': "app.translationsReady";
+    readonly 'uicore.app.loading': "app.loading";
+    readonly 'uicore.app.error': "app.error";
+    readonly 'uicore.app.useMockApi': "app.useMockApi";
+    readonly 'uicore.layout.theme': "app.theme";
+    readonly 'uicore.layout.currentScreenset': "app.currentScreenset";
+    readonly 'uicore.layout.selectedScreen': "layout.screen.activeScreen";
+    readonly 'uicore.header': "layout.header";
+    readonly 'uicore.footer': "layout.footer";
+    readonly 'uicore.menu': "layout.menu";
+    readonly 'uicore.sidebar': "layout.sidebar";
+    readonly 'uicore.screen': "layout.screen";
+    readonly 'uicore.popup': "layout.popup";
+    readonly 'uicore.overlay': "layout.overlay";
+};
+/**
+ * Enable or disable deprecation warnings globally
+ */
+declare function setDeprecationWarnings(enabled: boolean): void;
+/**
+ * Check if deprecation warnings are enabled
+ */
+declare function isDeprecationWarningsEnabled(): boolean;
+/**
+ * Create a legacy selector that wraps a new selector with deprecation warnings
+ *
+ * @param legacyPath - The old state path being accessed (for warning message)
+ * @param newSelector - The new selector to use
+ * @param migrationHint - Hint for how to migrate (optional)
+ * @returns A selector that logs a deprecation warning then returns the new value
+ *
+ * @example
+ * ```typescript
+ * import { createLegacySelector, selectMenuCollapsed } from '@hai3/framework';
+ *
+ * // Create a legacy selector
+ * const selectMenuCollapsedLegacy = createLegacySelector(
+ *   'uicore.menu.collapsed',
+ *   selectMenuCollapsed,
+ *   'Use selectMenuCollapsed from @hai3/framework'
+ * );
+ *
+ * // In component (will show deprecation warning in dev)
+ * const collapsed = useSelector(selectMenuCollapsedLegacy);
+ * ```
+ */
+declare function createLegacySelector<TState, TResult>(legacyPath: string, newSelector: Selector<TState, TResult>, migrationHint?: string): Selector<TState, TResult>;
+/**
+ * Get layout domain state from the new structure
+ * Maps to what was previously `state.uicore.header`, `state.uicore.menu`, etc.
+ */
+declare function getLayoutDomainState<K extends keyof RootStateWithLayout['layout']>(state: RootStateWithLayout, domain: K): RootStateWithLayout['layout'][K];
+/**
+ * Check if a state object has the legacy uicore structure
+ */
+declare function hasLegacyUicoreState(state: unknown): state is LegacyRootState;
+/**
+ * Check if a state object has the new layout structure
+ */
+declare function hasNewLayoutState(state: unknown): state is RootStateWithLayout;
+/**
+ * Legacy selectors placeholder
+ *
+ * @deprecated Named selectors are removed. Use useAppSelector hook from @hai3/react
+ * with inline state access: `useAppSelector((state) => state.layout.menu)`
+ *
+ * Migration guide:
+ * - Before: `const menu = useSelector(selectMenu);`
+ * - After:  `const menu = useAppSelector((state: RootState) => state.layout.menu);`
+ */
+declare const legacySelectors: {};
+
+export { ACCOUNTS_DOMAIN, ChangeThemePayload, type FooterConfig, type FooterState, HAI3App, HAI3AppBuilder, HAI3Config, HAI3Plugin, type HeaderConfig, type HeaderState, type HeaderUser, LAYOUT_SLICE_NAME, type LayoutDomainReducers, type LayoutDomainState, type LayoutState, type LegacyRootState, type LegacyUicoreState, type MenuItem, type MenuState, NavigateToScreenPayload, NavigateToScreensetPayload, type OverlayConfig, type OverlayState, type PopupConfig, type PopupSliceState, type PopupState, Presets, type RootStateWithLayout, RouteRegistry, STATE_PATH_MAPPING, type ScreenState, ScreensetsConfig, type Selector, SetLanguagePayload, ShowPopupPayload, type SidebarPosition, type SidebarState, TENANT_SLICE_NAME, type Tenant, type TenantChangedPayload, type TenantClearedPayload, TenantEvents, type TenantState, ThemeRegistry, changeTenant, clearActiveScreen, clearTenant, clearTenantAction, clearUser, closeAllPopups, closePopup, closeTopPopup, createHAI3, createHAI3App, createLegacySelector, createRouteRegistry, createThemeRegistry, effects, fetchCurrentUser, footerActions, footerSlice, full, getLayoutDomainState, hasLegacyUicoreState, hasNewLayoutState, headerActions, headerSlice, headless, hideOverlay, i18n, initTenantEffects, isDeprecationWarningsEnabled, layout, layoutDomainReducers, layoutReducer, legacySelectors, menuActions, menuSlice, minimal, navigateTo, navigateToScreen, navigation, openPopup, overlayActions, overlaySlice, popupActions, popupSlice, presets, routeRegistry, routing, screenActions, screenSlice, screensets, setActiveScreen, setDeprecationWarnings, setFooterConfig, setFooterVisible, setLoading as setHeaderLoading, setMenuCollapsed, setMenuConfig, setMenuItems, setMenuVisible, setOverlayVisible, setScreenLoading, setSidebarCollapsed, setSidebarConfig, setSidebarContent, setSidebarPosition, setSidebarTitle, setSidebarVisible, setSidebarWidth, setTenant, setTenantLoading, setTenantLoadingState, setUser, showOverlay, sidebarActions, sidebarSlice, tenantActions, _default as tenantReducer, tenantSlice, themeRegistry, themes, toggleMenu, toggleSidebar };