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

package/dist/index.cjs

@@ -21,18 +21,29 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   ACCOUNTS_DOMAIN: () => ACCOUNTS_DOMAIN,
+  ApiPlugin: () => import_api3.ApiPlugin,
+  ApiPluginBase: () => import_api3.ApiPluginBase,
+  ApiProtocol: () => import_api3.ApiProtocol,
   BaseApiService: () => import_api3.BaseApiService,
   I18nRegistry: () => import_i18n6.I18nRegistryImpl,
   I18nRegistryImpl: () => import_i18n5.I18nRegistryImpl,
   LAYOUT_SLICE_NAME: () => LAYOUT_SLICE_NAME,
   Language: () => import_i18n5.Language,
   LanguageDisplayMode: () => import_i18n5.LanguageDisplayMode,
-  LayoutDomain: () => import_screensets7.LayoutDomain,
-  MockPlugin: () => import_api3.MockPlugin,
+  LayoutDomain: () => import_screensets6.LayoutDomain,
+  MOCK_PLUGIN: () => import_api3.MOCK_PLUGIN,
+  MockEventSource: () => import_api3.MockEventSource,
+  MockEvents: () => MockEvents,
+  RestMockPlugin: () => import_api3.RestMockPlugin,
+  RestPlugin: () => import_api3.RestPlugin,
+  RestPluginWithConfig: () => import_api3.RestPluginWithConfig,
   RestProtocol: () => import_api3.RestProtocol,
   STATE_PATH_MAPPING: () => STATE_PATH_MAPPING,
   SUPPORTED_LANGUAGES: () => import_i18n5.SUPPORTED_LANGUAGES,
-  ScreensetCategory: () => import_screensets7.ScreensetCategory,
+  ScreensetCategory: () => import_screensets6.ScreensetCategory,
+  SseMockPlugin: () => import_api3.SseMockPlugin,
+  SsePlugin: () => import_api3.SsePlugin,
+  SsePluginWithConfig: () => import_api3.SsePluginWithConfig,
   SseProtocol: () => import_api3.SseProtocol,
   TENANT_SLICE_NAME: () => TENANT_SLICE_NAME,
   TenantEvents: () => TenantEvents,
@@ -51,39 +62,44 @@ __export(src_exports, {
   createI18nRegistry: () => import_i18n5.createI18nRegistry,
   createLegacySelector: () => createLegacySelector,
   createRouteRegistry: () => createRouteRegistry,
-  createScreensetRegistry: () => import_screensets6.createScreensetRegistry,
-  createSlice: () => import_state16.createSlice,
-  createStore: () => import_state16.createStore,
+  createScreensetRegistry: () => import_screensets4.createScreensetRegistry,
+  createSlice: () => import_state17.createSlice,
+  createStore: () => import_state17.createStore,
   createThemeRegistry: () => createThemeRegistry,
   effects: () => effects,
-  eventBus: () => import_state16.eventBus,
-  fetchCurrentUser: () => fetchCurrentUser,
+  eventBus: () => import_state17.eventBus,
   footerActions: () => footerActions,
   footerSlice: () => footerSlice,
   full: () => full,
   getLanguageMetadata: () => import_i18n5.getLanguageMetadata,
   getLayoutDomainState: () => getLayoutDomainState,
-  getStore: () => import_state16.getStore,
+  getStore: () => import_state17.getStore,
   hasLegacyUicoreState: () => hasLegacyUicoreState,
   hasNewLayoutState: () => hasNewLayoutState,
-  hasSlice: () => import_state16.hasSlice,
+  hasSlice: () => import_state17.hasSlice,
   headerActions: () => headerActions,
   headerSlice: () => headerSlice,
   headless: () => headless,
   hideOverlay: () => hideOverlay,
   i18n: () => i18n,
   i18nRegistry: () => import_i18n5.i18nRegistry,
+  initMockEffects: () => initMockEffects,
   initTenantEffects: () => initTenantEffects,
   isDeprecationWarningsEnabled: () => isDeprecationWarningsEnabled,
+  isMockPlugin: () => import_api3.isMockPlugin,
+  isRestShortCircuit: () => import_api3.isRestShortCircuit,
+  isShortCircuit: () => import_api3.isShortCircuit,
+  isSseShortCircuit: () => import_api3.isSseShortCircuit,
   layout: () => layout,
   layoutDomainReducers: () => layoutDomainReducers,
   layoutReducer: () => layoutReducer,
-  legacySelectors: () => legacySelectors,
   menuActions: () => menuActions,
   menuSlice: () => menuSlice,
   minimal: () => minimal,
+  mock: () => mock,
+  mockActions: () => mockActions,
+  mockSlice: () => mockSlice,
   navigateTo: () => navigateTo,
-  navigateToScreen: () => navigateToScreen,
   navigation: () => navigation,
   openPopup: () => openPopup,
   overlayActions: () => overlayActions,
@@ -91,12 +107,11 @@ __export(src_exports, {
   popupActions: () => popupActions,
   popupSlice: () => popupSlice,
   presets: () => presets,
-  registerSlice: () => import_state16.registerSlice,
-  routeRegistry: () => routeRegistry,
+  registerSlice: () => import_state17.registerSlice,
   routing: () => routing,
   screenActions: () => screenActions,
   screenSlice: () => screenSlice,
-  screensetRegistry: () => import_screensets3.screensetRegistry,
+  screensetRegistry: () => import_screensets5.screensetRegistry,
   screensets: () => screensets,
   setActiveScreen: () => setActiveScreen,
   setDeprecationWarnings: () => setDeprecationWarnings,
@@ -107,6 +122,7 @@ __export(src_exports, {
   setMenuConfig: () => setMenuConfig,
   setMenuItems: () => setMenuItems,
   setMenuVisible: () => setMenuVisible,
+  setMockEnabled: () => setMockEnabled,
   setOverlayVisible: () => setOverlayVisible,
   setScreenLoading: () => setScreenLoading,
   setSidebarCollapsed: () => setSidebarCollapsed,
@@ -126,9 +142,9 @@ __export(src_exports, {
   tenantActions: () => tenantActions,
   tenantReducer: () => tenantSlice_default,
   tenantSlice: () => tenantSlice,
-  themeRegistry: () => themeRegistry,
   themes: () => themes,
   toggleMenu: () => toggleMenu,
+  toggleMockMode: () => toggleMockMode,
   toggleSidebar: () => toggleSidebar
 });
 module.exports = __toCommonJS(src_exports);
@@ -294,8 +310,8 @@ Add the missing plugin: .use(${depName}())`
    */
   createStoreWithSlices(slices) {
     const store = (0, import_state.getStore)();
-    slices.forEach((slice9) => {
-      (0, import_state.registerSlice)(slice9);
+    slices.forEach((slice10) => {
+      (0, import_state.registerSlice)(slice10);
     });
     return store;
   }
@@ -579,6 +595,25 @@ var tenantSlice = slice8;
 var tenantActions = { setTenant, setTenantLoading, clearTenant };
 var tenantSlice_default = slice8.reducer;
 
+// src/slices/mockSlice.ts
+var import_state10 = require("@hai3/state");
+var SLICE_KEY9 = "mock";
+var initialState9 = {
+  enabled: false
+};
+var { slice: slice9, setMockEnabled } = (0, import_state10.createSlice)({
+  name: SLICE_KEY9,
+  initialState: initialState9,
+  reducers: {
+    setMockEnabled: (state, action) => {
+      state.enabled = action.payload;
+    }
+  }
+});
+var mockSlice = slice9;
+var mockActions = { setMockEnabled };
+var mockSlice_default = slice9.reducer;
+
 // src/slices/index.ts
 var LAYOUT_SLICE_NAME = "layout";
 var TENANT_SLICE_NAME = "app/tenant";
@@ -624,39 +659,34 @@ function screensets(config) {
 // src/plugins/themes.ts
 var import_state11 = require("@hai3/state");
 
-// src/compat.ts
-var import_state10 = require("@hai3/state");
-var import_api2 = require("@hai3/api");
-var import_screensets2 = require("@hai3/screensets");
-
 // src/registries/themeRegistry.ts
-function createThemeRegistry() {
+function createThemeRegistry(config) {
   const themes2 = /* @__PURE__ */ new Map();
-  const legacyThemes = /* @__PURE__ */ new Map();
+  const uikitThemes = /* @__PURE__ */ new Map();
   let currentThemeId = null;
-  let customApplyFn = null;
+  const customApplyFn = config?.applyFn ?? null;
   const subscribers = /* @__PURE__ */ new Set();
   let version = 0;
   function notifySubscribers() {
     version++;
     subscribers.forEach((callback) => callback());
   }
-  function applyCSSVariables(config) {
+  function applyCSSVariables(config2) {
     if (typeof document === "undefined") return;
     const root = document.documentElement;
-    Object.entries(config.variables).forEach(([key, value]) => {
+    Object.entries(config2.variables).forEach(([key, value]) => {
       root.style.setProperty(key, value);
     });
   }
   return {
     /**
      * Register a theme.
-     * Supports both new API (config only) and legacy API (id + theme).
+     * Supports both config-based API and UIKit theme API.
      */
-    register(configOrId, legacyTheme) {
+    register(configOrId, uikitTheme) {
       if (typeof configOrId === "string") {
         const id = configOrId;
-        if (!legacyTheme) {
+        if (!uikitTheme) {
           console.warn(`register() called with ID "${id}" but no theme object. Skipping.`);
           return;
         }
@@ -664,39 +694,33 @@ function createThemeRegistry() {
           console.warn(`Theme "${id}" is already registered. Skipping.`);
           return;
         }
-        legacyThemes.set(id, legacyTheme);
+        uikitThemes.set(id, uikitTheme);
         let themeName = id;
-        if (legacyTheme && typeof legacyTheme === "object" && "name" in legacyTheme) {
-          const nameValue = legacyTheme.name;
+        if (uikitTheme && typeof uikitTheme === "object" && "name" in uikitTheme) {
+          const nameValue = uikitTheme.name;
           if (typeof nameValue === "string") {
             themeName = nameValue;
           }
         }
-        const config2 = {
+        const config3 = {
           id,
           name: themeName,
           variables: {}
-          // Legacy themes use custom apply function
+          // UIKit themes use custom apply function
         };
-        themes2.set(id, config2);
+        themes2.set(id, config3);
         return;
       }
-      const config = configOrId;
-      if (themes2.has(config.id)) {
-        console.warn(`Theme "${config.id}" is already registered. Skipping.`);
+      const config2 = configOrId;
+      if (themes2.has(config2.id)) {
+        console.warn(`Theme "${config2.id}" is already registered. Skipping.`);
         return;
       }
-      themes2.set(config.id, config);
-      if (config.default && currentThemeId === null) {
-        this.apply(config.id);
+      themes2.set(config2.id, config2);
+      if (config2.default && currentThemeId === null) {
+        this.apply(config2.id);
       }
     },
-    /**
-     * Set the apply function (legacy API).
-     */
-    setApplyFunction(applyFn) {
-      customApplyFn = applyFn;
-    },
     /**
      * Get theme by ID.
      */
@@ -713,16 +737,17 @@ function createThemeRegistry() {
      * Apply a theme.
      */
     apply(id) {
-      const config = themes2.get(id);
-      if (!config) {
+      const config2 = themes2.get(id);
+      if (!config2) {
         console.warn(`Theme "${id}" not found. Cannot apply.`);
         return;
       }
-      const legacyTheme = legacyThemes.get(id);
-      if (legacyTheme && customApplyFn) {
-        customApplyFn(legacyTheme, id);
-      } else if (config.variables && Object.keys(config.variables).length > 0) {
-        applyCSSVariables(config);
+      if (config2.variables && Object.keys(config2.variables).length > 0) {
+        applyCSSVariables(config2);
+      }
+      const uikitTheme = uikitThemes.get(id);
+      if (uikitTheme && customApplyFn) {
+        customApplyFn(uikitTheme, id);
       }
       currentThemeId = id;
       notifySubscribers();
@@ -753,117 +778,18 @@ function createThemeRegistry() {
   };
 }
 
-// src/registries/routeRegistry.ts
-function createRouteRegistry(screensetRegistry3) {
-  let routes = null;
-  function buildRoutes() {
-    if (routes !== null) {
-      return routes;
-    }
-    routes = [];
-    const screensets2 = screensetRegistry3.getAll();
-    screensets2.forEach((screenset) => {
-      screenset.menu.forEach((menuScreenItem) => {
-        const screenId = menuScreenItem.menuItem.screenId ?? menuScreenItem.menuItem.id;
-        if (screenId && menuScreenItem.screen) {
-          routes.push({
-            screensetId: screenset.id,
-            screenId,
-            loader: menuScreenItem.screen
-          });
-        }
-      });
-    });
-    return routes;
-  }
-  return {
-    /**
-     * Check if a screen exists by screenId only (globally unique).
-     */
-    hasScreenById(screenId) {
-      const allRoutes = buildRoutes();
-      return allRoutes.some((route) => route.screenId === screenId);
-    },
-    /**
-     * Check if a screen exists (legacy, requires both IDs).
-     */
-    hasScreen(screensetId, screenId) {
-      const allRoutes = buildRoutes();
-      return allRoutes.some(
-        (route) => route.screensetId === screensetId && route.screenId === screenId
-      );
-    },
-    /**
-     * Get screenset ID for a given screen ID (reverse lookup).
-     * Screen IDs are globally unique across all screensets.
-     */
-    getScreensetForScreen(screenId) {
-      const allRoutes = buildRoutes();
-      const route = allRoutes.find((r) => r.screenId === screenId);
-      return route?.screensetId;
-    },
-    /**
-     * Get screen loader by screenId only.
-     */
-    getScreenById(screenId) {
-      const allRoutes = buildRoutes();
-      const route = allRoutes.find((r) => r.screenId === screenId);
-      return route?.loader;
-    },
-    /**
-     * Get screen loader (legacy, requires both IDs).
-     */
-    getScreen(screensetId, screenId) {
-      const allRoutes = buildRoutes();
-      const route = allRoutes.find(
-        (r) => r.screensetId === screensetId && r.screenId === screenId
-      );
-      return route?.loader;
-    },
-    /**
-     * Get all routes.
-     */
-    getAll() {
-      const allRoutes = buildRoutes();
-      return allRoutes.map(({ screensetId, screenId }) => ({
-        screensetId,
-        screenId
-      }));
-    }
-  };
-}
-
-// src/compat.ts
-var import_screensets3 = require("@hai3/screensets");
-var screenActions3 = screenActions;
-var ACCOUNTS_DOMAIN = "accounts";
-var themeRegistry = createThemeRegistry();
-var routeRegistry = createRouteRegistry(import_screensets2.screensetRegistry);
-var navigateToScreen = (screenId) => {
-  (0, import_state10.getStore)().dispatch(screenActions3.setActiveScreen(screenId));
-};
-var fetchCurrentUser = () => (_dispatch) => {
-  try {
-    const accountsService = import_api2.apiRegistry.getService(ACCOUNTS_DOMAIN);
-    const service = accountsService;
-    service.getCurrentUser?.();
-  } catch {
-    console.warn("fetchCurrentUser: accounts service not registered");
-  }
-};
-
 // src/plugins/themes.ts
 function changeTheme(payload) {
   import_state11.eventBus.emit("theme/changed", payload);
 }
-function themes() {
-  const themeRegistry2 = themeRegistry;
+function themes(config) {
+  const themeRegistry = createThemeRegistry(config);
   return {
     name: "themes",
     dependencies: [],
     provides: {
       registries: {
-        themeRegistry: themeRegistry2
+        themeRegistry
       },
       actions: {
         changeTheme
@@ -871,11 +797,11 @@ function themes() {
     },
     onInit(_app) {
       import_state11.eventBus.on("theme/changed", (payload) => {
-        themeRegistry2.apply(payload.themeId);
+        themeRegistry.apply(payload.themeId);
       });
-      const themes2 = themeRegistry2.getAll();
+      const themes2 = themeRegistry.getAll();
       if (themes2.length > 0) {
-        themeRegistry2.apply(themes2[0].id);
+        themeRegistry.apply(themes2[0].id);
       }
     }
   };
@@ -972,60 +898,124 @@ function layout() {
 // src/plugins/navigation.ts
 var import_state13 = require("@hai3/state");
 var import_i18n = require("@hai3/i18n");
-var screenActions4 = screenActions;
-var menuActions3 = menuActions;
-function buildMenuItems(screenset) {
-  return screenset.menu.map((item) => ({
-    id: item.menuItem.screenId ?? item.menuItem.id,
-    label: item.menuItem.label,
-    icon: item.menuItem.icon
-  }));
+
+// src/utils/basePath.ts
+function normalizeBase(base) {
+  if (!base) {
+    return "/";
+  }
+  let normalized = base.startsWith("/") ? base : `/${base}`;
+  if (normalized !== "/" && normalized.endsWith("/")) {
+    normalized = normalized.slice(0, -1);
+  }
+  return normalized;
 }
-function navigateToScreen2(payload) {
+function stripBase(pathname, base) {
+  if (base === "/") {
+    return pathname;
+  }
+  if (!pathname.startsWith(base)) {
+    return null;
+  }
+  const nextChar = pathname.charAt(base.length);
+  if (nextChar && nextChar !== "/") {
+    return null;
+  }
+  return pathname.slice(base.length) || "/";
+}
+function prependBase(path, base) {
+  if (base === "/") {
+    return path;
+  }
+  const cleanPath = path.startsWith("/") ? path : `/${path}`;
+  return `${base}${cleanPath}`;
+}
+function resolveBase(pluginConfig, appConfig) {
+  const rawBase = pluginConfig?.base ?? appConfig?.base ?? "/";
+  return normalizeBase(rawBase);
+}
+
+// src/plugins/navigation.ts
+var screenActions3 = screenActions;
+var menuActions3 = menuActions;
+function navigateToScreen(payload) {
   import_state13.eventBus.emit("navigation/screen/navigated", payload);
 }
 function navigateToScreenset(payload) {
   import_state13.eventBus.emit("navigation/screenset/navigated", payload);
 }
-function navigation() {
+function navigation(config) {
   return {
     name: "navigation",
     dependencies: ["screensets"],
     provides: {
       actions: {
-        navigateToScreen: navigateToScreen2,
+        navigateToScreen,
         navigateToScreenset
       }
     },
     onInit(app) {
       const dispatch = app.store.dispatch;
+      const base = resolveBase(config, app.config);
       let currentScreensetId = null;
-      async function loadScreensetTranslations(screensetId, language) {
-        await import_i18n.i18nRegistry.loadScreensetTranslations(screensetId, language);
-      }
-      function updateMenuForScreenset(screensetId) {
-        if (screensetId === currentScreensetId) return;
+      const loadScreensetTranslations = async (screensetId, language) => {
+        await import_i18n.i18nRegistry.loadScreensetTranslations(
+          screensetId,
+          language
+        );
+      };
+      const updateScreensetMenu = (screenset) => {
+        const menuItems = screenset.menu.map((item) => ({
+          id: item.menuItem.screenId ?? item.menuItem.id,
+          label: item.menuItem.label,
+          icon: item.menuItem.icon
+        }));
+        dispatch(menuActions3.setMenuItems(menuItems));
+      };
+      const activateScreenset = (screensetId) => {
+        if (screensetId === currentScreensetId) {
+          return;
+        }
         const screenset = app.screensetRegistry.get(screensetId);
-        if (!screenset) return;
+        if (!screenset) {
+          return;
+        }
         currentScreensetId = screensetId;
         loadScreensetTranslations(screensetId).catch((err) => {
           console.warn(`[HAI3] Failed to load translations for screenset ${screensetId}:`, err);
         });
-        const menuItems = buildMenuItems(screenset);
-        dispatch(menuActions3.setMenuItems(menuItems));
-      }
+        updateScreensetMenu(screenset);
+      };
+      const extractScreenId = () => {
+        const internalPath = stripBase(window.location.pathname, base);
+        if (!internalPath) {
+          return null;
+        }
+        const parts = internalPath.split("/").filter(Boolean);
+        return parts[0] || null;
+      };
+      const activateScreen = (screenId) => {
+        const screensetId = app.routeRegistry?.getScreensetForScreen(screenId);
+        if (!screensetId) {
+          return;
+        }
+        activateScreenset(screensetId);
+        dispatch(screenActions3.navigateTo(screenId));
+      };
       import_state13.eventBus.on("navigation/screen/navigated", (payload) => {
-        if (app.routeRegistry && !app.routeRegistry.hasScreen(payload.screensetId, payload.screenId)) {
+        if (!app.routeRegistry?.hasScreen(payload.screensetId, payload.screenId)) {
           console.warn(
             `Screen "${payload.screenId}" in screenset "${payload.screensetId}" not found.`
           );
           return;
         }
-        updateMenuForScreenset(payload.screensetId);
-        dispatch(screenActions4.navigateTo(payload.screenId));
+        activateScreenset(payload.screensetId);
+        dispatch(screenActions3.navigateTo(payload.screenId));
         if (typeof window !== "undefined") {
-          const url = `/${payload.screenId}`;
-          window.history.pushState(null, "", url);
+          const url = prependBase(`/${payload.screenId}`, base);
+          if (window.location.pathname !== url) {
+            window.history.pushState(null, "", url);
+          }
         }
       });
       import_state13.eventBus.on("navigation/screenset/navigated", (payload) => {
@@ -1034,7 +1024,7 @@ function navigation() {
           console.warn(`Screenset "${payload.screensetId}" not found.`);
           return;
         }
-        navigateToScreen2({
+        navigateToScreen({
           screensetId: payload.screensetId,
           screenId: screenset.defaultScreen
         });
@@ -1042,15 +1032,18 @@ function navigation() {
       let lastLoadedLanguage = null;
       import_i18n.i18nRegistry.subscribe(() => {
         const currentLanguage = import_i18n.i18nRegistry.getLanguage();
-        if (!currentLanguage || currentLanguage === lastLoadedLanguage) return;
-        if (!currentScreensetId) return;
+        if (!currentLanguage || currentLanguage === lastLoadedLanguage) {
+          return;
+        }
+        if (!currentScreensetId) {
+          return;
+        }
         const screenset = app.screensetRegistry.get(currentScreensetId);
-        if (!screenset) return;
+        if (!screenset) {
+          return;
+        }
         lastLoadedLanguage = currentLanguage;
-        loadScreensetTranslations(currentScreensetId, currentLanguage).then(() => {
-          const menuItems = buildMenuItems(screenset);
-          dispatch(menuActions3.setMenuItems(menuItems));
-        }).catch((err) => {
+        loadScreensetTranslations(currentScreensetId, currentLanguage).then(() => updateScreensetMenu(screenset)).catch((err) => {
           console.warn(
             `[HAI3] Failed to reload translations for screenset ${currentScreensetId}:`,
             err
@@ -1059,31 +1052,15 @@ function navigation() {
       });
       if (typeof window !== "undefined") {
         window.addEventListener("popstate", () => {
-          const path2 = window.location.pathname;
-          const parts2 = path2.split("/").filter(Boolean);
-          if (parts2.length >= 1) {
-            const screenId = parts2[0];
-            const screensetId = app.routeRegistry?.getScreensetForScreen(screenId);
-            if (screensetId) {
-              updateMenuForScreenset(screensetId);
-              dispatch(screenActions4.navigateTo(screenId));
-            }
+          const screenId2 = extractScreenId();
+          if (screenId2) {
+            activateScreen(screenId2);
           }
         });
-        const path = window.location.pathname;
-        const parts = path.split("/").filter(Boolean);
+        const screenId = extractScreenId();
         const autoNavigate = app.config.autoNavigate !== false;
-        if (parts.length >= 1) {
-          const screenId = parts[0];
-          const screensetId = app.routeRegistry?.getScreensetForScreen(screenId);
-          if (screensetId) {
-            navigateToScreen2({ screensetId, screenId });
-          } else if (autoNavigate) {
-            const screensets2 = app.screensetRegistry.getAll();
-            if (screensets2.length > 0) {
-              navigateToScreenset({ screensetId: screensets2[0].id });
-            }
-          }
+        if (screenId) {
+          activateScreen(screenId);
         } else if (autoNavigate) {
           const screensets2 = app.screensetRegistry.getAll();
           if (screensets2.length > 0) {
@@ -1095,6 +1072,86 @@ function navigation() {
   };
 }
 
+// src/registries/routeRegistry.ts
+function createRouteRegistry(screensetRegistry3) {
+  let routes = null;
+  function buildRoutes() {
+    if (routes !== null) {
+      return routes;
+    }
+    routes = [];
+    const screensets2 = screensetRegistry3.getAll();
+    screensets2.forEach((screenset) => {
+      screenset.menu.forEach((menuScreenItem) => {
+        const screenId = menuScreenItem.menuItem.screenId ?? menuScreenItem.menuItem.id;
+        if (screenId && menuScreenItem.screen) {
+          routes.push({
+            screensetId: screenset.id,
+            screenId,
+            loader: menuScreenItem.screen
+          });
+        }
+      });
+    });
+    return routes;
+  }
+  return {
+    /**
+     * Check if a screen exists by screenId only (globally unique).
+     */
+    hasScreenById(screenId) {
+      const allRoutes = buildRoutes();
+      return allRoutes.some((route) => route.screenId === screenId);
+    },
+    /**
+     * Check if a screen exists by both screensetId and screenId (explicit lookup when screenset context is known).
+     */
+    hasScreen(screensetId, screenId) {
+      const allRoutes = buildRoutes();
+      return allRoutes.some(
+        (route) => route.screensetId === screensetId && route.screenId === screenId
+      );
+    },
+    /**
+     * Get screenset ID for a given screen ID (reverse lookup).
+     * Screen IDs are globally unique across all screensets.
+     */
+    getScreensetForScreen(screenId) {
+      const allRoutes = buildRoutes();
+      const route = allRoutes.find((r) => r.screenId === screenId);
+      return route?.screensetId;
+    },
+    /**
+     * Get screen loader by screenId only.
+     */
+    getScreenById(screenId) {
+      const allRoutes = buildRoutes();
+      const route = allRoutes.find((r) => r.screenId === screenId);
+      return route?.loader;
+    },
+    /**
+     * Get screen loader by both screensetId and screenId (explicit lookup when screenset context is known).
+     */
+    getScreen(screensetId, screenId) {
+      const allRoutes = buildRoutes();
+      const route = allRoutes.find(
+        (r) => r.screensetId === screensetId && r.screenId === screenId
+      );
+      return route?.loader;
+    },
+    /**
+     * Get all routes.
+     */
+    getAll() {
+      const allRoutes = buildRoutes();
+      return allRoutes.map(({ screensetId, screenId }) => ({
+        screensetId,
+        screenId
+      }));
+    }
+  };
+}
+
 // src/plugins/routing.ts
 function routing() {
   return {
@@ -1103,8 +1160,8 @@ function routing() {
     onRegister(_app) {
     },
     onInit(app) {
-      const routeRegistry2 = createRouteRegistry(app.screensetRegistry);
-      app.routeRegistry = routeRegistry2;
+      const routeRegistry = createRouteRegistry(app.screensetRegistry);
+      app.routeRegistry = routeRegistry;
     }
   };
 }
@@ -1152,16 +1209,101 @@ function effects() {
   };
 }
 
+// src/effects/mockEffects.ts
+var import_state15 = require("@hai3/state");
+var import_api2 = require("@hai3/api");
+function hasPluginManagement(protocol) {
+  return "plugins" in protocol && typeof protocol.plugins === "object";
+}
+var MockEvents = {
+  Toggle: "mock/toggle"
+};
+function syncMockPlugins(enabled) {
+  for (const service of import_api2.apiRegistry.getAll()) {
+    const registeredPlugins = service.getPlugins();
+    for (const [protocol, plugins] of registeredPlugins) {
+      if (!hasPluginManagement(protocol)) continue;
+      for (const plugin of plugins) {
+        if ((0, import_api2.isMockPlugin)(plugin)) {
+          if (enabled) {
+            const existingPlugins = protocol.plugins.getAll();
+            if (!existingPlugins.includes(plugin)) {
+              protocol.plugins.add(plugin);
+            }
+          } else {
+            protocol.plugins.remove(plugin);
+          }
+        }
+      }
+    }
+  }
+}
+function initMockEffects() {
+  const store = (0, import_state15.getStore)();
+  const unsubscribe = import_state15.eventBus.on(MockEvents.Toggle, (payload) => {
+    store.dispatch(setMockEnabled(payload.enabled));
+    syncMockPlugins(payload.enabled);
+  });
+  const currentState = store.getState();
+  if ("mock" in currentState && currentState.mock && typeof currentState.mock === "object" && "enabled" in currentState.mock) {
+    syncMockPlugins(currentState.mock.enabled);
+  }
+  return () => {
+    unsubscribe.unsubscribe();
+  };
+}
+function toggleMockMode(enabled) {
+  import_state15.eventBus.emit(MockEvents.Toggle, { enabled });
+}
+
+// src/plugins/mock.ts
+var cleanup = null;
+function isDevEnvironment() {
+  if (typeof window === "undefined") return false;
+  const { hostname } = window.location;
+  return hostname === "localhost" || hostname === "127.0.0.1" || hostname.endsWith(".local");
+}
+function mock(config) {
+  return {
+    name: "mock",
+    dependencies: ["effects"],
+    provides: {
+      slices: [mockSlice],
+      actions: {
+        toggleMockMode
+      }
+    },
+    onInit() {
+      cleanup = initMockEffects();
+      const isDev = isDevEnvironment();
+      const enabledByDefault = config?.enabledByDefault ?? isDev;
+      if (enabledByDefault) {
+        toggleMockMode(true);
+        if (isDev) {
+          console.log("[HAI3] Mock mode enabled by default (dev environment detected)");
+        }
+      }
+    },
+    onDestroy() {
+      if (cleanup) {
+        cleanup();
+        cleanup = null;
+      }
+    }
+  };
+}
+
 // src/presets/index.ts
-function full() {
+function full(config) {
   return [
     effects(),
     screensets({ autoDiscover: true }),
-    themes(),
+    themes(config?.themes),
     layout(),
     routing(),
     navigation(),
-    i18n()
+    i18n(),
+    mock()
   ];
 }
 function minimal() {
@@ -1183,28 +1325,28 @@ var presets = {
 
 // src/createHAI3App.ts
 function createHAI3App(config) {
-  return createHAI3(config).useAll(full()).build();
+  return createHAI3(config).useAll(full({ themes: config?.themes })).build();
 }
 
 // src/registries/index.ts
-var import_screensets6 = require("@hai3/screensets");
+var import_screensets4 = require("@hai3/screensets");
 
 // src/index.ts
-var import_state16 = require("@hai3/state");
-var import_screensets7 = require("@hai3/screensets");
+var import_state17 = require("@hai3/state");
+var import_screensets6 = require("@hai3/screensets");
 
 // src/effects/tenantEffects.ts
-var import_state15 = require("@hai3/state");
+var import_state16 = require("@hai3/state");
 var TenantEvents = {
   Changed: "app/tenant/changed",
   Cleared: "app/tenant/cleared"
 };
 function initTenantEffects() {
-  const store = (0, import_state15.getStore)();
-  const subChanged = import_state15.eventBus.on(TenantEvents.Changed, (payload) => {
+  const store = (0, import_state16.getStore)();
+  const subChanged = import_state16.eventBus.on(TenantEvents.Changed, (payload) => {
     store.dispatch(setTenant(payload.tenant));
   });
-  const subCleared = import_state15.eventBus.on(TenantEvents.Cleared, () => {
+  const subCleared = import_state16.eventBus.on(TenantEvents.Cleared, () => {
     store.dispatch(clearTenant());
   });
   return () => {
@@ -1213,13 +1355,13 @@ function initTenantEffects() {
   };
 }
 function changeTenant(tenant) {
-  import_state15.eventBus.emit(TenantEvents.Changed, { tenant });
+  import_state16.eventBus.emit(TenantEvents.Changed, { tenant });
 }
 function clearTenantAction() {
-  import_state15.eventBus.emit(TenantEvents.Cleared, {});
+  import_state16.eventBus.emit(TenantEvents.Cleared, {});
 }
 function setTenantLoadingState(loading) {
-  (0, import_state15.getStore)().dispatch(setTenantLoading(loading));
+  (0, import_state16.getStore)().dispatch(setTenantLoading(loading));
 }
 
 // src/index.ts
@@ -1227,6 +1369,10 @@ var import_api3 = require("@hai3/api");
 var import_i18n5 = require("@hai3/i18n");
 var import_i18n6 = require("@hai3/i18n");
 
+// src/compat.ts
+var import_screensets5 = require("@hai3/screensets");
+var ACCOUNTS_DOMAIN = "accounts";
+
 // src/migration.ts
 var STATE_PATH_MAPPING = {
   // App state (moved to app slice)
@@ -1280,10 +1426,12 @@ function hasLegacyUicoreState(state) {
 function hasNewLayoutState(state) {
   return typeof state === "object" && state !== null && "layout" in state && typeof state.layout === "object";
 }
-var legacySelectors = {};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ACCOUNTS_DOMAIN,
+  ApiPlugin,
+  ApiPluginBase,
+  ApiProtocol,
   BaseApiService,
   I18nRegistry,
   I18nRegistryImpl,
@@ -1291,11 +1439,19 @@ var legacySelectors = {};
   Language,
   LanguageDisplayMode,
   LayoutDomain,
-  MockPlugin,
+  MOCK_PLUGIN,
+  MockEventSource,
+  MockEvents,
+  RestMockPlugin,
+  RestPlugin,
+  RestPluginWithConfig,
   RestProtocol,
   STATE_PATH_MAPPING,
   SUPPORTED_LANGUAGES,
   ScreensetCategory,
+  SseMockPlugin,
+  SsePlugin,
+  SsePluginWithConfig,
   SseProtocol,
   TENANT_SLICE_NAME,
   TenantEvents,
@@ -1320,7 +1476,6 @@ var legacySelectors = {};
   createThemeRegistry,
   effects,
   eventBus,
-  fetchCurrentUser,
   footerActions,
   footerSlice,
   full,
@@ -1336,17 +1491,23 @@ var legacySelectors = {};
   hideOverlay,
   i18n,
   i18nRegistry,
+  initMockEffects,
   initTenantEffects,
   isDeprecationWarningsEnabled,
+  isMockPlugin,
+  isRestShortCircuit,
+  isShortCircuit,
+  isSseShortCircuit,
   layout,
   layoutDomainReducers,
   layoutReducer,
-  legacySelectors,
   menuActions,
   menuSlice,
   minimal,
+  mock,
+  mockActions,
+  mockSlice,
   navigateTo,
-  navigateToScreen,
   navigation,
   openPopup,
   overlayActions,
@@ -1355,7 +1516,6 @@ var legacySelectors = {};
   popupSlice,
   presets,
   registerSlice,
-  routeRegistry,
   routing,
   screenActions,
   screenSlice,
@@ -1370,6 +1530,7 @@ var legacySelectors = {};
   setMenuConfig,
   setMenuItems,
   setMenuVisible,
+  setMockEnabled,
   setOverlayVisible,
   setScreenLoading,
   setSidebarCollapsed,
@@ -1389,9 +1550,9 @@ var legacySelectors = {};
   tenantActions,
   tenantReducer,
   tenantSlice,
-  themeRegistry,
   themes,
   toggleMenu,
+  toggleMockMode,
   toggleSidebar
 });
 //# sourceMappingURL=index.cjs.map