@hai3/react 0.2.0-alpha.4 → 0.4.0-alpha.0

package/dist/index.d.cts

@@ -1,11 +1,10 @@
 import * as React from 'react';
-import React__default, { ReactNode } from 'react';
-import { HAI3ProviderProps, UseTranslationReturn, UseScreenTranslationsReturn, UseNavigationReturn, UseThemeReturn, AppRouterProps } from './types.cjs';
-export { AppRouterComponent, HAI3ProviderComponent, RouterConfig, RouterType, UseAppDispatchReturn, UseAppSelector, UseHAI3Return, UseLanguageReturn, UseMenuReturn, UseOverlayReturn, UsePopupReturn, UseScreenReturn, UseScreensetReturn } from './types.cjs';
-import { HAI3App, AppDispatch, RootState, TranslationMap, TranslationLoader, RouteParams as RouteParams$1, EventPayloadMap as EventPayloadMap$1 } from '@hai3/framework';
-export { ACCOUNTS_DOMAIN, ApiPlugin, ApiPluginBase, ApiPluginErrorContext, ApiProtocol, ApiRequestContext, ApiResponseContext, ApiServiceConfig, AppDispatch, BaseApiService, BasePluginHooks, ChangeThemePayload, EventHandler, EventSourceLike, FooterConfig, FooterState, HAI3App, HAI3AppBuilder, HAI3Config, HAI3Plugin, HAI3Store, HeaderConfig, HeaderState, HeaderUser, I18nConfig, I18nRegistry, I18nRegistryImpl, I18nRegistryType, JsonCompatible, JsonObject, JsonPrimitive, JsonValue, LAYOUT_SLICE_NAME, Language, LanguageDisplayMode, LanguageMetadata, LayoutDomain, LayoutDomainReducers, LayoutDomainState, LayoutState, MOCK_PLUGIN, MenuItem, MenuItemConfig, MenuScreenItem, MenuState, MockEventSource, MockEvents, MockMap, MockState, MockTogglePayload, NavigateToScreenPayload, NavigateToScreensetPayload, OverlayConfig, OverlayState, PluginClass, PluginFactory, PluginLifecycle, PluginProvides, PopupConfig, PopupSliceState, PopupState, Preset, Presets, ProtocolClass, ProtocolPluginType, RestMockConfig, RestMockPlugin, RestPlugin, RestPluginHooks, RestPluginWithConfig, RestProtocol, RestProtocolConfig, RestRequestContext, RestResponseContext, RestShortCircuitResponse, RootState, RootStateWithLayout, RouteRegistry, SUPPORTED_LANGUAGES, ScreenConfig, ScreenId, ScreenLoader, ScreenState, ScreensetCategory, ScreensetConfig, ScreensetDefinition, ScreensetId, ScreensetRegistry, ScreensetsConfig, SetLanguagePayload, ShortCircuitResponse, ShowPopupPayload, SidebarPosition, SidebarState, SliceObject, SseConnectContext, SseMockConfig, SseMockEvent, SseMockPlugin, SsePlugin, SsePluginHooks, SsePluginWithConfig, SseProtocol, SseProtocolConfig, SseShortCircuitResponse, Subscription, TENANT_SLICE_NAME, Tenant, TenantChangedPayload, TenantClearedPayload, TenantEvents, TenantState, TextDirection, ThemeApplyFn, ThemeConfig, ThemeRegistry, TranslationDictionary, TranslationLoader, TranslationMap, UikitTheme, apiRegistry, changeTenant, clearActiveScreen, clearTenant, clearTenantAction, clearUser, closeAllPopups, closePopup, closeTopPopup, createHAI3, createHAI3App, createI18nRegistry, createRouteRegistry, createScreensetRegistry, createSlice, createStore, createThemeRegistry, effects, footerActions, footerSlice, getLanguageMetadata, getStore, hasSlice, headerActions, headerSlice, hideOverlay, i18n, i18nRegistry, initMockEffects, initTenantEffects, isMockPlugin, isRestShortCircuit, isShortCircuit, isSseShortCircuit, layout, layoutDomainReducers, layoutReducer, menuActions, menuSlice, mockActions, mockSlice, navigateTo, navigation, openPopup, overlayActions, overlaySlice, popupActions, popupSlice, presets, registerSlice, routing, screenActions, screenSlice, screensetRegistry, screensets, setActiveScreen, setFooterConfig, setFooterVisible, setHeaderLoading, setMenuCollapsed, setMenuConfig, setMenuItems, setMenuVisible, setMockEnabled, setOverlayVisible, setScreenLoading, setSidebarCollapsed, setSidebarConfig, setSidebarContent, setSidebarPosition, setSidebarTitle, setSidebarVisible, setSidebarWidth, setTenant, setTenantLoading, setTenantLoadingState, setUser, showOverlay, sidebarActions, sidebarSlice, tenantActions, tenantReducer, tenantSlice, themes, toggleMenu, toggleMockMode, toggleSidebar } from '@hai3/framework';
+import React__default, { RefObject } from 'react';
+import { H as HAI3ProviderProps, U as UseTranslationReturn, a as UseScreenTranslationsReturn, b as UseFormattersReturn, c as UseThemeReturn, M as MfeContextValue } from './types-CcLYaLwF.cjs';
+export { d as MfeContext, e as UseAppDispatchReturn, f as UseAppSelector, g as UseHAI3Return, u as useMfeContext } from './types-CcLYaLwF.cjs';
+import { HAI3App, AppDispatch, RootState, TranslationMap, TranslationLoader, ChildMfeBridge, Extension, ContainerProvider, ScreensetsRegistry, ParentMfeBridge, EventPayloadMap as EventPayloadMap$1, EventBus } from '@hai3/framework';
+export { ACCOUNTS_DOMAIN, Action, ActionsChain, ApiPlugin, ApiPluginBase, ApiPluginErrorContext, ApiProtocol, ApiRequestContext, ApiResponseContext, ApiServiceConfig, AppDispatch, BaseApiService, BasePluginHooks, ChangeThemePayload, ChildMfeBridge, ContainerProvider, EventHandler, EventSourceLike, Extension, ExtensionDomain, ExtensionPresentation, ExtensionRegistrationState, FooterConfig, FooterState, HAI3App, HAI3AppBuilder, HAI3Config, HAI3Plugin, HAI3Store, HAI3_ACTION_LOAD_EXT, HAI3_ACTION_MOUNT_EXT, HAI3_ACTION_UNMOUNT_EXT, HAI3_OVERLAY_DOMAIN, HAI3_POPUP_DOMAIN, HAI3_SCREEN_DOMAIN, HAI3_SCREEN_EXTENSION_TYPE, HAI3_SHARED_PROPERTY_LANGUAGE, HAI3_SHARED_PROPERTY_THEME, HAI3_SIDEBAR_DOMAIN, HeaderConfig, HeaderState, HeaderUser, I18nConfig, I18nRegistry, I18nRegistryImpl, I18nRegistryType, JSONSchema, JsonCompatible, JsonObject, JsonPrimitive, JsonValue, LAYOUT_SLICE_NAME, Language, LanguageDisplayMode, LanguageMetadata, LayoutDomain, LayoutDomainReducers, LayoutDomainState, LayoutState, LifecycleHook, LifecycleStage, LoadExtPayload, MOCK_PLUGIN, MenuItem, MenuState, MfeBridgeFactory, MfeEntry, MfeEntryLifecycle, MfeEntryMF, MfeHandler, MfeHandlerMF, MfeState, MockEventSource, MockEvents, MockMap, MockState, MockTogglePayload, MountExtPayload, OverlayConfig, OverlayState, ParentMfeBridge, PluginClass, PluginFactory, PluginLifecycle, PluginProvides, PopupConfig, PopupSliceState, PopupState, Preset, Presets, ProtocolClass, ProtocolPluginType, ReducerPayload, RegisterExtensionPayload, RestMockConfig, RestMockPlugin, RestPlugin, RestPluginHooks, RestPluginWithConfig, RestProtocol, RestProtocolConfig, RestRequestContext, RestResponseContext, RestShortCircuitResponse, RootState, RootStateWithLayout, SUPPORTED_LANGUAGES, ScreenExtension, ScreenState, ScreensetsConfig, ScreensetsRegistry, ScreensetsRegistryConfig, ScreensetsRegistryFactory, SetLanguagePayload, SharedProperty, ShortCircuitResponse, ShowPopupPayload, SidebarPosition, SidebarState, SliceObject, SseConnectContext, SseMockConfig, SseMockEvent, SseMockPlugin, SsePlugin, SsePluginHooks, SsePluginWithConfig, SseProtocol, SseProtocolConfig, SseShortCircuitResponse, Subscription, TENANT_SLICE_NAME, Tenant, TenantChangedPayload, TenantClearedPayload, TenantEvents, TenantState, TextDirection, ThemeApplyFn, ThemeConfig, ThemeRegistry, TranslationDictionary, TranslationLoader, TranslationMap, TypeSystemPlugin, UikitTheme, UnmountExtPayload, UnregisterExtensionPayload, ValidationError, ValidationResult, apiRegistry, changeTenant, clearActiveScreen, clearTenant, clearTenantAction, clearUser, closeAllPopups, closePopup, closeTopPopup, createHAI3, createHAI3App, createI18nRegistry, createShadowRoot, createSlice, createStore, createThemeRegistry, effects, extractGtsPackage, footerActions, footerSlice, getLanguageMetadata, getStore, gtsPlugin, hasSlice, headerActions, headerSlice, hideOverlay, i18n, i18nRegistry, initMockEffects, initTenantEffects, injectCssVariables, isMockPlugin, isRestShortCircuit, isShortCircuit, isSseShortCircuit, layout, layoutDomainReducers, layoutReducer, loadExtension, menuActions, menuSlice, microfrontends, mock, mockActions, mockSlice, mountExtension, navigateTo, openPopup, overlayActions, overlayDomain, overlaySlice, popupActions, popupDomain, popupSlice, presets, registerExtension, registerSlice, screenActions, screenDomain, screenSlice, screensets, screensetsRegistryFactory, selectExtensionError, selectExtensionState, selectRegisteredExtensions, setActiveScreen, setFooterConfig, setFooterVisible, setHeaderLoading, setMenuCollapsed, setMenuConfig, setMenuItems, setMenuVisible, setMockEnabled, setOverlayVisible, setScreenLoading, setSidebarCollapsed, setSidebarConfig, setSidebarContent, setSidebarPosition, setSidebarTitle, setSidebarVisible, setSidebarWidth, setTenant, setTenantLoading, setTenantLoadingState, setUser, showOverlay, sidebarActions, sidebarDomain, sidebarSlice, tenantActions, tenantReducer, tenantSlice, themes, toggleMenu, toggleMockMode, toggleSidebar, unmountExtension, unregisterExtension } from '@hai3/framework';
 import { TypedUseSelectorHook } from 'react-redux';
-import { EventBus } from '@hai3/state';
 
 /**
  * HAI3 Provider - Main provider component for HAI3 applications
@@ -32,10 +31,15 @@ import { EventBus } from '@hai3/state';
  * </HAI3Provider>
  *
  * // With pre-built app
- * const app = createHAI3().use(screensets()).build();
+ * const app = createHAI3().use(screensets()).use(microfrontends()).build();
  * <HAI3Provider app={app}>
  *   <App />
  * </HAI3Provider>
+ *
+ * // With MFE bridge (for MFE components)
+ * <HAI3Provider mfeBridge={{ bridge, extensionId, domainId }}>
+ *   <MyMfeApp />
+ * </HAI3Provider>
  * ```
  */
 declare const HAI3Provider: React__default.FC<HAI3ProviderProps>;
@@ -162,158 +166,406 @@ declare function useTranslation(): UseTranslationReturn;
 declare function useScreenTranslations(screensetId: string, screenId: string, translations: TranslationMap | TranslationLoader): UseScreenTranslationsReturn;
 
 /**
- * useNavigation Hook - Navigation utilities
+ * useFormatters Hook - Locale-aware formatters
+ *
+ * Returns formatters that use i18nRegistry.getLanguage() internally.
+ * Calls useTranslation() so the component re-renders when language changes.
  *
  * React Layer: L3
  */
 
 /**
- * Hook for navigation utilities.
+ * Hook for accessing locale-aware formatters (date, number, currency, sort).
  *
- * @returns Navigation utilities
+ * Formatters use the current app language from i18nRegistry.getLanguage().
+ * Re-renders when language changes via useTranslation() subscription.
+ *
+ * @returns Object with formatDate, formatTime, formatDateTime, formatRelative,
+ *   formatNumber, formatPercent, formatCompact, formatCurrency, compareStrings, createCollator
  *
  * @example
  * ```tsx
- * const { navigateToScreen, navigateToScreenset, currentScreen } = useNavigation();
- *
- * // Navigate to a simple screen
+ * const { formatDate, formatCurrency } = useFormatters();
  * return (
- *   <button onClick={() => navigateToScreen('demo', 'home')}>
- *     Go to Home
- *   </button>
+ *   <span>{formatDate(new Date(), 'short')}</span>
+ *   <span>{formatCurrency(99.99, 'USD')}</span>
  * );
+ * ```
+ */
+declare function useFormatters(): UseFormattersReturn;
+
+/**
+ * useTheme Hook - Theme utilities
+ *
+ * React Layer: L3
+ */
+
+/**
+ * Hook for theme utilities.
+ *
+ * @returns Theme utilities
+ *
+ * @example
+ * ```tsx
+ * const { currentTheme, themes, setTheme } = useTheme();
  *
- * // Navigate to a parameterized screen
  * return (
- *   <button onClick={() => navigateToScreen('demo', 'user-detail', { id: '123' })}>
- *     View User 123
- *   </button>
+ *   <select
+ *     value={currentTheme}
+ *     onChange={(e) => setTheme(e.target.value)}
+ *   >
+ *     {themes.map((theme) => (
+ *       <option key={theme.id} value={theme.id}>
+ *         {theme.name}
+ *       </option>
+ *     ))}
+ *   </select>
  * );
  * ```
  */
-declare function useNavigation(): UseNavigationReturn;
+declare function useTheme(): UseThemeReturn;
+
+/**
+ * MFE Provider - Provides MFE context to child components
+ *
+ * Wraps MFE components with bridge and metadata.
+ * Used by the MFE mounting system.
+ *
+ * React Layer: L3 (Depends on @hai3/framework)
+ */
+
+/**
+ * MFE Provider Props
+ */
+interface MfeProviderProps {
+    /** MFE context value */
+    value: MfeContextValue;
+    /** Child components */
+    children: React__default.ReactNode;
+}
+/**
+ * MFE Provider Component
+ *
+ * Provides MFE bridge and metadata to child components.
+ * Used by the MFE mounting system to wrap MFE components.
+ *
+ * @example
+ * ```tsx
+ * <MfeProvider value={{ bridge, extensionId, domainId }}>
+ *   <MyMfeComponent />
+ * </MfeProvider>
+ * ```
+ */
+declare const MfeProvider: React__default.FC<MfeProviderProps>;
 
 /**
- * useRouteParams Hook
+ * useMfeBridge Hook - MFE bridge access
  *
- * Provides access to route parameters from the current URL.
- * Supports type-safe route params via module augmentation.
+ * Returns the ChildMfeBridge from context for communication with host.
  *
  * React Layer: L3
+ */
+
+/**
+ * Hook for accessing the MFE bridge.
+ *
+ * Returns the ChildMfeBridge instance for communication with the host.
+ * Must be used within a MfeProvider (i.e., inside an MFE component).
+ *
+ * @returns Child MFE bridge
  *
  * @example
  * ```tsx
- * import { useRouteParams } from '@hai3/react';
+ * function MyMfeComponent() {
+ *   const bridge = useMfeBridge();
  *
- * // Basic usage (no type safety)
- * const UserDetailScreen: React.FC = () => {
- *   const params = useRouteParams();
- *   // params: Record<string, string>
+ *   // Bridge methods:
+ *   // bridge.executeActionsChain(chain);
+ *   // bridge.subscribeToProperty(propertyTypeId, callback);
  *
- *   return <div>User ID: {params.id}</div>;
- * };
+ *   return <div>Domain: {bridge.domainId}</div>;
+ * }
+ * ```
+ */
+declare function useMfeBridge(): ChildMfeBridge;
+
+/**
+ * useSharedProperty Hook - Shared property subscription
+ *
+ * Subscribes to shared property updates from the host.
+ *
+ * React Layer: L3
+ */
+/**
+ * Hook for subscribing to a shared property.
  *
- * // Type-safe usage with module augmentation
- * // First, declare the route params in your app:
- * // declare module '@hai3/framework' {
- * //   interface RouteParams {
- * //     'user-detail': { userId: string };
- * //   }
- * // }
+ * Subscribes to property updates from the host and returns the current value.
+ * Must be used within a MfeProvider (i.e., inside an MFE component).
  *
- * const UserDetailScreen: React.FC = () => {
- *   const params = useRouteParams<'user-detail'>();
- *   // params: { userId: string } - fully typed!
+ * NOTE: This hook provides the interface and uses useSyncExternalStore with a stub subscription.
+ * Full bridge subscription should be implemented when bridge methods are available.
  *
- *   return <div>User ID: {params.userId}</div>;
- * };
+ * @param _propertyTypeId - Type ID of the shared property to subscribe to (currently unused)
+ * @returns Current property value
+ *
+ * @example
+ * ```tsx
+ * function MyMfeComponent() {
+ *   const userData = useSharedProperty('gts.hai3.mfes.comm.shared_property.v1~myapp.user_data.v1');
+ *
+ *   return <div>User: {userData?.name}</div>;
+ * }
  * ```
  */
+declare function useSharedProperty<T = unknown>(propertyTypeId: string): T | undefined;
 
 /**
- * Hook to access route parameters from the current URL.
+ * useHostAction Hook - Host action requests
+ *
+ * Returns a callback to request host actions via the bridge.
+ *
+ * React Layer: L3
+ */
+/**
+ * Hook for requesting host actions.
+ *
+ * Returns a callback function that sends an actions chain to the host.
+ * Must be used within a MfeProvider (i.e., inside an MFE component).
+ *
+ * NOTE: This hook provides the interface. Bridge executeActionsChain() delegates to the registry.
+ *
+ * @param actionTypeId - Type ID of the action to request
+ * @returns Callback function to request the action with payload
+ *
+ * @example
+ * ```tsx
+ * function MyMfeComponent() {
+ *   const requestNavigation = useHostAction('gts.hai3.mfes.comm.action.v1~myapp.navigate.v1');
  *
- * @template TScreenId - Optional screen ID for type-safe route params
- * @returns Route parameters, optionally typed based on screen ID
+ *   const handleClick = () => {
+ *     requestNavigation({ path: '/dashboard' });
+ *   };
+ *
+ *   return <button onClick={handleClick}>Navigate</button>;
+ * }
+ * ```
  */
-declare function useRouteParams<TScreenId extends keyof RouteParams$1 = string>(): TScreenId extends keyof RouteParams$1 ? RouteParams$1[TScreenId] : Record<string, string>;
+declare function useHostAction<TPayload extends Record<string, unknown> = Record<string, unknown>>(actionTypeId: string): (payload?: TPayload) => void;
 
 /**
- * useTheme Hook - Theme utilities
+ * useDomainExtensions Hook - Domain extension list subscription
+ *
+ * Subscribes to store changes to detect when extensions are registered or unregistered,
+ * and returns the current list of extensions for a domain.
  *
  * React Layer: L3
  */
 
 /**
- * Hook for theme utilities.
+ * Hook for observing extensions registered for a domain.
  *
- * @returns Theme utilities
+ * Subscribes to the HAI3 store to detect registration state changes,
+ * and returns the current list of extensions for the specified domain.
+ *
+ * @param domainId - Domain ID to query extensions for
+ * @returns Array of extensions currently registered for the domain
  *
  * @example
  * ```tsx
- * const { currentTheme, themes, setTheme } = useTheme();
- *
- * return (
- *   <select
- *     value={currentTheme}
- *     onChange={(e) => setTheme(e.target.value)}
- *   >
- *     {themes.map((theme) => (
- *       <option key={theme.id} value={theme.id}>
- *         {theme.name}
- *       </option>
- *     ))}
- *   </select>
- * );
+ * function SidebarExtensions() {
+ *   const extensions = useDomainExtensions('gts.hai3.mfes.ext.domain.v1~hai3.screensets.layout.sidebar.v1');
+ *
+ *   return (
+ *     <div>
+ *       {extensions.map(ext => (
+ *         <div key={ext.id}>{ext.id}</div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
  * ```
  */
-declare function useTheme(): UseThemeReturn;
+declare function useDomainExtensions(domainId: string): Extension[];
 
 /**
- * AppRouter Component - Renders the active screen
+ * useRegisteredPackages Hook - Registered GTS packages subscription
+ *
+ * Subscribes to store changes to detect when extensions are registered or unregistered,
+ * and returns the current list of registered GTS packages.
  *
  * React Layer: L3
  */
+/**
+ * Hook for observing registered GTS packages.
+ *
+ * Subscribes to the HAI3 store to detect registration state changes,
+ * and returns the current list of GTS packages extracted from registered
+ * extensions.
+ *
+ * ARCHITECTURAL NOTE ON STORE SUBSCRIPTION COUPLING:
+ * This hook uses `useSyncExternalStore` with `app.store.subscribe`, which
+ * fires on any Redux dispatch. Since `registerExtension()` dispatches to
+ * the mfe store slice, the subscription WILL trigger when packages change.
+ * The `getSnapshot` function calls `screensetsRegistry.getRegisteredPackages()`
+ * which reads the private `packages` Map. This works because every package
+ * map mutation (in registerExtension/unregisterExtension) is always
+ * accompanied by a store dispatch in the same serializer callback.
+ *
+ * IMPORTANT: If a future change mutates the packages map WITHOUT a store
+ * dispatch, this hook would fail to re-render. Keep this coupling documented.
+ *
+ * @returns Array of GTS package strings currently registered
+ *
+ * @example
+ * ```tsx
+ * function PackageList() {
+ *   const packages = useRegisteredPackages();
+ *
+ *   return (
+ *     <div>
+ *       {packages.map(pkg => (
+ *         <div key={pkg}>{pkg}</div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useRegisteredPackages(): string[];
 
 /**
- * AppRouter Component
+ * useActivePackage Hook - Active GTS package subscription
+ *
+ * Subscribes to store changes and returns the GTS package of the currently
+ * mounted screen extension.
+ *
+ * React Layer: L3
+ */
+/**
+ * Hook for observing the active GTS package (the package of the currently
+ * mounted screen extension).
+ *
+ * Subscribes to the HAI3 store to detect mount state changes, and returns
+ * the GTS package extracted from the currently mounted screen extension's ID.
  *
- * Renders the currently active screen based on navigation state.
- * Handles lazy loading and error boundaries.
+ * Returns `undefined` if no screen extension is currently mounted.
+ *
+ * @returns GTS package string of the active screen extension, or undefined
  *
  * @example
  * ```tsx
- * <HAI3Provider>
- *   <Layout>
- *     <AppRouter
- *       fallback={<LoadingSpinner />}
- *       errorFallback={(error) => <ErrorPage error={error} />}
- *     />
- *   </Layout>
- * </HAI3Provider>
+ * function ActivePackageIndicator() {
+ *   const activePackage = useActivePackage();
+ *
+ *   if (!activePackage) {
+ *     return <div>No active screen</div>;
+ *   }
+ *
+ *   return <div>Active package: {activePackage}</div>;
+ * }
  * ```
  */
-declare const AppRouter: React__default.FC<AppRouterProps>;
+declare function useActivePackage(): string | undefined;
 
 /**
- * Route params type
+ * Ref Container Provider
+ *
+ * Concrete ContainerProvider that wraps a React ref.
+ * Created by React components (like ExtensionDomainSlot) for use
+ * by framework-level domain registration code.
+ *
+ * @packageDocumentation
  */
-type RouteParams = Record<string, string>;
+
+/**
+ * Concrete ContainerProvider that wraps a React ref.
+ *
+ * This provider reads the container element from a React ref at mount time.
+ * It is designed to be created by React components but passed to domain
+ * registration code (framework-level).
+ *
+ * Usage pattern:
+ * 1. React component creates a ref via `useRef<HTMLDivElement>(null)`
+ * 2. Framework-level code creates `RefContainerProvider` wrapping the ref
+ * 3. Framework-level code passes the provider to `registerDomain(domain, provider)`
+ * 4. When mount_ext is dispatched, the provider returns `ref.current`
+ */
+declare class RefContainerProvider extends ContainerProvider {
+    private readonly containerRef;
+    constructor(containerRef: RefObject<HTMLDivElement>);
+    getContainer(_extensionId: string): Element;
+    releaseContainer(_extensionId: string): void;
+}
+
 /**
- * Route params context
+ * Extension Domain Slot Component
+ *
+ * React component that renders extensions within a domain slot.
+ * Manages extension lifecycle (mount/unmount) and provides rendering context.
+ *
+ * @packageDocumentation
  */
-declare const RouteParamsContext: React.Context<RouteParams>;
+
 /**
- * Route params provider props
+ * Props for ExtensionDomainSlot component
  */
-interface RouteParamsProviderProps {
-    params: RouteParams;
-    children: ReactNode;
+interface ExtensionDomainSlotProps {
+    /**
+     * The screensets registry instance
+     */
+    registry: ScreensetsRegistry;
+    /**
+     * The domain ID for this slot
+     */
+    domainId: string;
+    /**
+     * The extension ID to render in this slot
+     */
+    extensionId: string;
+    /**
+     * Optional CSS class name for the container
+     */
+    className?: string;
+    /**
+     * Optional callback when extension is mounted
+     */
+    onMounted?: (bridge: ParentMfeBridge) => void;
+    /**
+     * Optional callback when extension is unmounted
+     */
+    onUnmounted?: () => void;
+    /**
+     * Optional error callback
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Optional loading component
+     */
+    loadingComponent?: React__default.ReactNode;
+    /**
+     * Optional error component renderer
+     */
+    errorComponent?: (error: Error) => React__default.ReactNode;
 }
 /**
- * Route params provider component
+ * Extension Domain Slot Component
+ *
+ * Renders an extension within a domain slot. Manages the extension lifecycle:
+ * - Mounts the extension on component mount
+ * - Unmounts the extension on component unmount
+ * - Handles loading and error states
+ *
+ * @example
+ * ```tsx
+ * <ExtensionDomainSlot
+ *   registry={registry}
+ *   domainId="gts.hai3.mfes.ext.domain.v1~hai3.screensets.layout.sidebar.v1"
+ *   extensionId="gts.hai3.mfes.ext.extension.v1~myapp.sidebar.widget.v1"
+ *   className="sidebar-slot"
+ * />
+ * ```
  */
-declare function RouteParamsProvider({ params, children }: RouteParamsProviderProps): JSX.Element;
+declare function ExtensionDomainSlot(props: ExtensionDomainSlotProps): React__default.ReactElement;
 
 /**
  * @hai3/react - React Bindings
@@ -321,7 +573,7 @@ declare function RouteParamsProvider({ params, children }: RouteParamsProviderPr
  * This package provides:
  * - HAI3Provider context provider
  * - Type-safe hooks for state and actions
- * - AppRouter for screen rendering
+ * - MFE context, hooks, and components
  *
  * Layer: L3 (Depends on @hai3/framework)
  */
@@ -335,4 +587,4 @@ interface EventPayloadMap extends EventPayloadMap$1 {
  */
 declare const eventBus: EventBus<EventPayloadMap>;
 
-export { AppRouter, AppRouterProps, type EventPayloadMap, HAI3Context, HAI3Provider, HAI3ProviderProps, type RouteParams, RouteParamsContext, RouteParamsProvider, type RouteParamsProviderProps, UseNavigationReturn, UseScreenTranslationsReturn, UseThemeReturn, UseTranslationReturn, eventBus, useAppDispatch, useAppSelector, useHAI3, useNavigation, useRouteParams, useScreenTranslations, useTheme, useTranslation };
+export { type EventPayloadMap, ExtensionDomainSlot, type ExtensionDomainSlotProps, HAI3Context, HAI3Provider, HAI3ProviderProps, MfeContextValue, MfeProvider, type MfeProviderProps, RefContainerProvider, UseFormattersReturn, UseScreenTranslationsReturn, UseThemeReturn, UseTranslationReturn, eventBus, useActivePackage, useAppDispatch, useAppSelector, useDomainExtensions, useFormatters, useHAI3, useHostAction, useMfeBridge, useRegisteredPackages, useScreenTranslations, useSharedProperty, useTheme, useTranslation };