@wildo-ai/saas-frontend-lib 1.0.1 → 1.1.0

package/dist/esm/core/commons/devices.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"devices.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/commons/devices.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,yBAAW,CAAA;AACb,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,6BAAiB,CAAA;IACjB,uBAAW,CAAA;IACX,yBAAa,CAAA;AACf,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;IACtD,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE;IACnB,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;IAC1D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC"}
+{"version":3,"file":"devices.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/commons/devices.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,yBAAW,CAAA;AACb,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,6BAAiB,CAAA;IACjB,uBAAW,CAAA;IACX,yBAAa,CAAA;AACf,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;IACtD,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE;IACnB,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;IAC1D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC","sourcesContent":["/**\n * Device Shared Schemas\n * \n * Centralized device-related schemas and enums\n */\n\nimport { z } from 'zod';\n\n/**\n * Device type enum for authentication, sessions, and DTOs\n */\nexport enum DeviceType {\n  DESKTOP = 'desktop',\n  MOBILE = 'mobile',\n  TABLET = 'tablet',\n  API = 'api'\n}\n\n/**\n * SameSite cookie option enum\n */\nexport enum SameSite {\n  STRICT = 'strict',\n  LAX = 'lax',\n  NONE = 'none'\n}\n\nexport const DeviceInfoSchema = z.object({\n  userAgent: z.string().min(1, 'User agent is required'),\n  ipAddress: z.ipv4(),\n  deviceType: z.enum(DeviceType).default(DeviceType.DESKTOP),\n  location: z.string().optional(),\n  fingerprint: z.string().optional()\n});\n\nexport type DeviceInfo = z.infer<typeof DeviceInfoSchema>;\n\n// Type exports\nexport type DeviceTypeValue = DeviceType; \n"]}

package/dist/esm/core/commons/local-storage.frontend.schemas.d.ts

@@ -1,20 +1,27 @@
 /**
- * [Capacitor] [OAuth2] [SAML]
- * This module is the single abstraction point for persistent key-value storage.
- * Currently backed by browser localStorage.
+ * Single abstraction point for persistent key-value storage in the browser.
  *
- * When Ionic Capacitor is introduced, these functions should be swapped to use
- * platform-aware secure storage:
- * - iOS: Keychain via @capacitor/preferences or @nicepkg/capacitor-secure-storage
- * - Android: Keystore-backed EncryptedSharedPreferences
- * - Web: remains localStorage (or optionally IndexedDB for larger payloads)
+ * Backed by `window.localStorage`. The framework targets web stacks
+ * exclusively (the engine's value prop is sharing TypeScript across
+ * browser-rendered surfaces — SAAS_APP, STATIC_WEBSITE, TECH_DOC), so
+ * there is no native secure-storage variant to swap in.
+ */
+/**
+ * Web-storage keys whose STORAGE AREA is chosen at runtime rather than fixed.
  *
- * Critical keys affected:
- * - JWT_TOKEN, REFRESH_TOKEN — auth tokens must be encrypted at rest on mobile
- * - All other keys are non-sensitive preferences, but should move to the same
- *   backend for consistency (Capacitor Preferences API is async, so the getters
- *   will need to become async too — plan for that interface change).
+ * Kept separate from {@link LOCAL_STORAGE_KEYS} instead of merged into it: that enum is the registry of
+ * keys that always live in `localStorage`, and a key which may live in either area is a different thing.
+ * Merging them would make the enum's name a lie for one member — the kind of convenience merge the
+ * framework's design rules exist to prevent.
  */
+export declare enum RUNTIME_SCOPED_STORAGE_KEYS {
+    /**
+     * The client-install identifier. Lives in `sessionStorage` or `localStorage` depending on the
+     * application's authored `compliance.clientInstanceIdScope`, and in NEITHER when that is `DISABLED`
+     * (the default). Owned by `client-instance-id.frontend.service.ts`.
+     */
+    CLIENT_INSTANCE_ID = "clientInstanceId"
+}
 export declare enum LOCAL_STORAGE_KEYS {
     JWT_TOKEN = "jwtToken",
     REFRESH_TOKEN = "refreshToken",
@@ -22,6 +29,24 @@ export declare enum LOCAL_STORAGE_KEYS {
     CURRENT_ORGANIZATION_ID = "currentOrganizationId",
     SCOPE_VALUES = "scopeValues",
     SIDEBAR_SECTION_COLLAPSED = "wildo-sidebar-section-collapsed",
+    /**
+     * Whole-sidebar rail collapse state (`'true'` / `'false'`). Desktop-only semantics:
+     * hydrated synchronously by `useSidebarBehavior`'s lazy `useState` initializer so the
+     * first paint already renders the persisted width (no expand→collapse flash), and
+     * written on every user toggle. The mobile drawer open/close state is deliberately
+     * NOT persisted — a drawer is transient by definition.
+     */
+    SIDEBAR_COLLAPSED = "wildo-sidebar-collapsed",
+    /**
+     * User-curated sidebar favorites: a JSON `string[]` of resolved launcher item
+     * ids (deterministic — `resolved-<resourceType>-<operation>-<variant>`,
+     * `resolved-view-<ref>`, …), in the order the user favorited them. Read by
+     * `useSidebarBehavior` to populate `SidebarSectionBehavior.FAVORITES`
+     * sections and written on every star toggle. Same machine-local persistence
+     * tier as `SIDEBAR_COLLAPSED`; per-user server-side sync (user preferences)
+     * is a deliberate future extension, not this key's job.
+     */
+    SIDEBAR_FAVORITES = "wildo-sidebar-favorites",
     ANONYMOUS_USER_ID = "anonymousUserId",
     ANONYMOUS_SESSION_TOKEN = "anonymousSessionToken"
 }

package/dist/esm/core/commons/local-storage.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-storage.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/commons/local-storage.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,oBAAY,kBAAkB;IAC5B,SAAS,aAA4B;IACrC,aAAa,iBAA4B;IACzC,QAAQ,aAA6B;IACrC,uBAAuB,0BAA2B;IAClD,YAAY,gBAA4B;IACxC,yBAAyB,oCAAoC;IAC7D,iBAAiB,oBAA2B;IAC5C,uBAAuB,0BAA2B;CACnD;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAO1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,IAOhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,IAOpD,CAAC"}
+{"version":3,"file":"local-storage.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/commons/local-storage.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,oBAAY,2BAA2B;IACrC;;;;OAIG;IACH,kBAAkB,qBAAqB;CACxC;AAED,oBAAY,kBAAkB;IAC5B,SAAS,aAA4B;IACrC,aAAa,iBAA4B;IACzC,QAAQ,aAA6B;IACrC,uBAAuB,0BAA2B;IAClD,YAAY,gBAA4B;IACxC,yBAAyB,oCAAoC;IAC7D;;;;;;OAMG;IACH,iBAAiB,4BAAmC;IACpD;;;;;;;;OAQG;IACH,iBAAiB,4BAAmC;IACpD,iBAAiB,oBAA2B;IAC5C,uBAAuB,0BAA2B;CACnD;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAO1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,IAOhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,IAOpD,CAAC"}

package/dist/esm/core/commons/local-storage.frontend.schemas.js

@@ -1,20 +1,28 @@
 /**
- * [Capacitor] [OAuth2] [SAML]
- * This module is the single abstraction point for persistent key-value storage.
- * Currently backed by browser localStorage.
+ * Single abstraction point for persistent key-value storage in the browser.
  *
- * When Ionic Capacitor is introduced, these functions should be swapped to use
- * platform-aware secure storage:
- * - iOS: Keychain via @capacitor/preferences or @nicepkg/capacitor-secure-storage
- * - Android: Keystore-backed EncryptedSharedPreferences
- * - Web: remains localStorage (or optionally IndexedDB for larger payloads)
+ * Backed by `window.localStorage`. The framework targets web stacks
+ * exclusively (the engine's value prop is sharing TypeScript across
+ * browser-rendered surfaces — SAAS_APP, STATIC_WEBSITE, TECH_DOC), so
+ * there is no native secure-storage variant to swap in.
+ */
+/**
+ * Web-storage keys whose STORAGE AREA is chosen at runtime rather than fixed.
  *
- * Critical keys affected:
- * - JWT_TOKEN, REFRESH_TOKEN — auth tokens must be encrypted at rest on mobile
- * - All other keys are non-sensitive preferences, but should move to the same
- *   backend for consistency (Capacitor Preferences API is async, so the getters
- *   will need to become async too — plan for that interface change).
+ * Kept separate from {@link LOCAL_STORAGE_KEYS} instead of merged into it: that enum is the registry of
+ * keys that always live in `localStorage`, and a key which may live in either area is a different thing.
+ * Merging them would make the enum's name a lie for one member — the kind of convenience merge the
+ * framework's design rules exist to prevent.
  */
+export var RUNTIME_SCOPED_STORAGE_KEYS;
+(function (RUNTIME_SCOPED_STORAGE_KEYS) {
+    /**
+     * The client-install identifier. Lives in `sessionStorage` or `localStorage` depending on the
+     * application's authored `compliance.clientInstanceIdScope`, and in NEITHER when that is `DISABLED`
+     * (the default). Owned by `client-instance-id.frontend.service.ts`.
+     */
+    RUNTIME_SCOPED_STORAGE_KEYS["CLIENT_INSTANCE_ID"] = "clientInstanceId";
+})(RUNTIME_SCOPED_STORAGE_KEYS || (RUNTIME_SCOPED_STORAGE_KEYS = {}));
 export var LOCAL_STORAGE_KEYS;
 (function (LOCAL_STORAGE_KEYS) {
     LOCAL_STORAGE_KEYS["JWT_TOKEN"] = "jwtToken";
@@ -23,6 +31,24 @@ export var LOCAL_STORAGE_KEYS;
     LOCAL_STORAGE_KEYS["CURRENT_ORGANIZATION_ID"] = "currentOrganizationId";
     LOCAL_STORAGE_KEYS["SCOPE_VALUES"] = "scopeValues";
     LOCAL_STORAGE_KEYS["SIDEBAR_SECTION_COLLAPSED"] = "wildo-sidebar-section-collapsed";
+    /**
+     * Whole-sidebar rail collapse state (`'true'` / `'false'`). Desktop-only semantics:
+     * hydrated synchronously by `useSidebarBehavior`'s lazy `useState` initializer so the
+     * first paint already renders the persisted width (no expand→collapse flash), and
+     * written on every user toggle. The mobile drawer open/close state is deliberately
+     * NOT persisted — a drawer is transient by definition.
+     */
+    LOCAL_STORAGE_KEYS["SIDEBAR_COLLAPSED"] = "wildo-sidebar-collapsed";
+    /**
+     * User-curated sidebar favorites: a JSON `string[]` of resolved launcher item
+     * ids (deterministic — `resolved-<resourceType>-<operation>-<variant>`,
+     * `resolved-view-<ref>`, …), in the order the user favorited them. Read by
+     * `useSidebarBehavior` to populate `SidebarSectionBehavior.FAVORITES`
+     * sections and written on every star toggle. Same machine-local persistence
+     * tier as `SIDEBAR_COLLAPSED`; per-user server-side sync (user preferences)
+     * is a deliberate future extension, not this key's job.
+     */
+    LOCAL_STORAGE_KEYS["SIDEBAR_FAVORITES"] = "wildo-sidebar-favorites";
     LOCAL_STORAGE_KEYS["ANONYMOUS_USER_ID"] = "anonymousUserId";
     LOCAL_STORAGE_KEYS["ANONYMOUS_SESSION_TOKEN"] = "anonymousSessionToken";
 })(LOCAL_STORAGE_KEYS || (LOCAL_STORAGE_KEYS = {}));
@@ -70,4 +96,4 @@ export const removeLocalStorageItem = (key) => {
         // Silently fail if localStorage is not available
     }
 };
-//# sourceMappingURL=local-storage.frontend.schemas.js.map
+//# sourceMappingURL=local-storage.frontend.schemas.js.map

package/dist/esm/core/commons/local-storage.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-storage.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/commons/local-storage.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,CAAN,IAAY,kBASX;AATD,WAAY,kBAAkB;IAC5B,4CAAqC,CAAA;IACrC,oDAAyC,CAAA;IACzC,2CAAqC,CAAA;IACrC,uEAAkD,CAAA;IAClD,kDAAwC,CAAA;IACxC,mFAA6D,CAAA;IAC7D,2DAA4C,CAAA;IAC5C,uEAAkD,CAAA;AACpD,CAAC,EATW,kBAAkB,KAAlB,kBAAkB,QAS7B;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAiB,EAAE;IAChE,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAE,KAAa,EAAQ,EAAE;IACtE,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAW,EAAQ,EAAE;IAC1D,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,CAAC;QACH,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"local-storage.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/commons/local-storage.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,2BAOX;AAPD,WAAY,2BAA2B;IACrC;;;;OAIG;IACH,sEAAuC,CAAA;AACzC,CAAC,EAPW,2BAA2B,KAA3B,2BAA2B,QAOtC;AAED,MAAM,CAAN,IAAY,kBA2BX;AA3BD,WAAY,kBAAkB;IAC5B,4CAAqC,CAAA;IACrC,oDAAyC,CAAA;IACzC,2CAAqC,CAAA;IACrC,uEAAkD,CAAA;IAClD,kDAAwC,CAAA;IACxC,mFAA6D,CAAA;IAC7D;;;;;;OAMG;IACH,mEAAoD,CAAA;IACpD;;;;;;;;OAQG;IACH,mEAAoD,CAAA;IACpD,2DAA4C,CAAA;IAC5C,uEAAkD,CAAA;AACpD,CAAC,EA3BW,kBAAkB,KAAlB,kBAAkB,QA2B7B;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAiB,EAAE;IAChE,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAE,KAAa,EAAQ,EAAE;IACtE,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAW,EAAQ,EAAE;IAC1D,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,CAAC;QACH,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC,CAAC","sourcesContent":["/**\n * Single abstraction point for persistent key-value storage in the browser.\n *\n * Backed by `window.localStorage`. The framework targets web stacks\n * exclusively (the engine's value prop is sharing TypeScript across\n * browser-rendered surfaces — SAAS_APP, STATIC_WEBSITE, TECH_DOC), so\n * there is no native secure-storage variant to swap in.\n */\n\n/**\n * Web-storage keys whose STORAGE AREA is chosen at runtime rather than fixed.\n *\n * Kept separate from {@link LOCAL_STORAGE_KEYS} instead of merged into it: that enum is the registry of\n * keys that always live in `localStorage`, and a key which may live in either area is a different thing.\n * Merging them would make the enum's name a lie for one member — the kind of convenience merge the\n * framework's design rules exist to prevent.\n */\nexport enum RUNTIME_SCOPED_STORAGE_KEYS {\n  /**\n   * The client-install identifier. Lives in `sessionStorage` or `localStorage` depending on the\n   * application's authored `compliance.clientInstanceIdScope`, and in NEITHER when that is `DISABLED`\n   * (the default). Owned by `client-instance-id.frontend.service.ts`.\n   */\n  CLIENT_INSTANCE_ID = 'clientInstanceId',\n}\n\nexport enum LOCAL_STORAGE_KEYS {\n  JWT_TOKEN                = 'jwtToken',\n  REFRESH_TOKEN            = 'refreshToken',\n  LANGUAGE                 = 'language',\n  CURRENT_ORGANIZATION_ID  = 'currentOrganizationId',\n  SCOPE_VALUES             = 'scopeValues',\n  SIDEBAR_SECTION_COLLAPSED = 'wildo-sidebar-section-collapsed',\n  /**\n   * Whole-sidebar rail collapse state (`'true'` / `'false'`). Desktop-only semantics:\n   * hydrated synchronously by `useSidebarBehavior`'s lazy `useState` initializer so the\n   * first paint already renders the persisted width (no expand→collapse flash), and\n   * written on every user toggle. The mobile drawer open/close state is deliberately\n   * NOT persisted — a drawer is transient by definition.\n   */\n  SIDEBAR_COLLAPSED        = 'wildo-sidebar-collapsed',\n  /**\n   * User-curated sidebar favorites: a JSON `string[]` of resolved launcher item\n   * ids (deterministic — `resolved-<resourceType>-<operation>-<variant>`,\n   * `resolved-view-<ref>`, …), in the order the user favorited them. Read by\n   * `useSidebarBehavior` to populate `SidebarSectionBehavior.FAVORITES`\n   * sections and written on every star toggle. Same machine-local persistence\n   * tier as `SIDEBAR_COLLAPSED`; per-user server-side sync (user preferences)\n   * is a deliberate future extension, not this key's job.\n   */\n  SIDEBAR_FAVORITES        = 'wildo-sidebar-favorites',\n  ANONYMOUS_USER_ID        = 'anonymousUserId',\n  ANONYMOUS_SESSION_TOKEN  = 'anonymousSessionToken',\n}\n\n/**\n * Get an item from localStorage\n * @param key - The key to retrieve\n * @returns The stored value or null if not found or unavailable\n */\nexport const getLocalStorageItem = (key: string): string | null => {\n  if (typeof window === 'undefined') return null;\n  try {\n    return localStorage.getItem(key);\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Set an item in localStorage\n * @param key - The key to store\n * @param value - The value to store\n */\nexport const setLocalStorageItem = (key: string, value: string): void => {\n  if (typeof window === 'undefined') return;\n  try {\n    localStorage.setItem(key, value);\n  } catch {\n    // Silently fail if localStorage is not available\n  }\n};\n\n/**\n * Remove an item from localStorage\n * @param key - The key to remove\n */\nexport const removeLocalStorageItem = (key: string): void => {\n  if (typeof window === 'undefined') return;\n  try {\n    localStorage.removeItem(key);\n  } catch {\n    // Silently fail if localStorage is not available\n  }\n};\n"]}

package/dist/esm/core/commons/window-event.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"window-event.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/commons/window-event.frontend.schemas.ts"],"names":[],"mappings":"AAEA,oBAAY,mBAAmB;IAC7B,MAAM,WAAW;IACjB,iBAAiB,oBAAoB;IACrC,aAAa,kBAAkB;CAChC;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;CACnC,CAAA"}
+{"version":3,"file":"window-event.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/commons/window-event.frontend.schemas.ts"],"names":[],"mappings":"AAEA,oBAAY,mBAAmB;IAC7B,MAAM,WAAW;IACjB,iBAAiB,oBAAoB;IACrC,aAAa,kBAAkB;CAChC;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;CACnC,CAAA"}

package/dist/esm/core/commons/window-event.frontend.schemas.js

@@ -4,4 +4,4 @@ export var WINDOW_EVENTS_SLUGS;
     WINDOW_EVENTS_SLUGS["RESET_ALL_CONTEXT"] = "resetAllContext";
     WINDOW_EVENTS_SLUGS["REFRESH_TOKEN"] = "refresh_token";
 })(WINDOW_EVENTS_SLUGS || (WINDOW_EVENTS_SLUGS = {}));
-//# sourceMappingURL=window-event.frontend.schemas.js.map
+//# sourceMappingURL=window-event.frontend.schemas.js.map

package/dist/esm/core/commons/window-event.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"window-event.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/commons/window-event.frontend.schemas.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,wCAAiB,CAAA;IACjB,4DAAqC,CAAA;IACrC,sDAA+B,CAAA;AACjC,CAAC,EAJW,mBAAmB,KAAnB,mBAAmB,QAI9B"}
+{"version":3,"file":"window-event.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/commons/window-event.frontend.schemas.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,wCAAiB,CAAA;IACjB,4DAAqC,CAAA;IACrC,sDAA+B,CAAA;AACjC,CAAC,EAJW,mBAAmB,KAAnB,mBAAmB,QAI9B","sourcesContent":["\n\nexport enum WINDOW_EVENTS_SLUGS {\n  LOGOUT = 'logout',\n  RESET_ALL_CONTEXT = 'resetAllContext',\n  REFRESH_TOKEN = 'refresh_token',\n}\n\nexport type WindowEventHandler = {\n  slugs: WINDOW_EVENTS_SLUGS,\n  handler: (e: CustomEvent) => void,\n}"]}

package/dist/esm/core/companion/companion-exports.frontend.definitions.d.ts

@@ -0,0 +1,29 @@
+import type { DesignSystemSourceConfig } from '@wildo-ai/presets-components-models';
+import type { RuntimeOwnerCompanionExports, SharedSaaSModule } from '@wildo-ai/saas-models';
+import type { AppConfiguration_Frontend } from '../config/app-configuration-frontend.schemas';
+import type { FrontendModule } from '../runtime/domain-module.frontend.definitions';
+/**
+ * Introspection-safe frontend companion surface for application packages.
+ *
+ * Apps can keep authored config in app-local files while still exposing one
+ * typed contract for companion/tooling consumers. The framework owns the shape;
+ * each application only provides its concrete authored values.
+ */
+export interface FrontendCompanionExports<TDesignSystemConfig = DesignSystemSourceConfig, TNavigationLayoutConfig = AppConfiguration_Frontend['navigationLayout'], TAppShellConfig = AppConfiguration_Frontend['appComponentsConfiguration'], TSettingsHubConfig = AppConfiguration_Frontend['settingsHub'], TErrorPageConfig = AppConfiguration_Frontend['errorPageConfig'], THomeDefinition = AppConfiguration_Frontend['homeDefinition']> extends RuntimeOwnerCompanionExports {
+    designSystemConfig: TDesignSystemConfig;
+    navigationLayoutConfig: TNavigationLayoutConfig;
+    appShellConfig: TAppShellConfig;
+    /**
+     * The application's authored settings rail.
+     *
+     * Optional so an application that has not yet authored one still satisfies the
+     * contract — the companion then plans no settings-hub label units, which is
+     * correct: an unplaced rail has no labels to generate.
+     */
+    settingsHubConfig?: TSettingsHubConfig;
+    errorPageConfig: TErrorPageConfig;
+    homeDefinitionFactory: () => THomeDefinition;
+    loadFrontendModules?: () => Promise<FrontendModule[]>;
+    loadSharedModules?: () => Promise<SharedSaaSModule[]>;
+}
+//# sourceMappingURL=companion-exports.frontend.definitions.d.ts.map

package/dist/esm/core/companion/companion-exports.frontend.definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-exports.frontend.definitions.d.ts","sourceRoot":"","sources":["../../../../../src/core/companion/companion-exports.frontend.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,KAAK,EACV,4BAA4B,EAC5B,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAEpF;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB,CACvC,mBAAmB,GAAG,wBAAwB,EAC9C,uBAAuB,GAAG,yBAAyB,CAAC,kBAAkB,CAAC,EACvE,eAAe,GAAG,yBAAyB,CAAC,4BAA4B,CAAC,EACzE,kBAAkB,GAAG,yBAAyB,CAAC,aAAa,CAAC,EAC7D,gBAAgB,GAAG,yBAAyB,CAAC,iBAAiB,CAAC,EAC/D,eAAe,GAAG,yBAAyB,CAAC,gBAAgB,CAAC,CAC7D,SAAQ,4BAA4B;IACpC,kBAAkB,EAAE,mBAAmB,CAAC;IACxC,sBAAsB,EAAE,uBAAuB,CAAC;IAChD,cAAc,EAAE,eAAe,CAAC;IAChC;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;IACvC,eAAe,EAAE,gBAAgB,CAAC;IAClC,qBAAqB,EAAE,MAAM,eAAe,CAAC;IAC7C,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACtD,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CACvD"}

package/dist/esm/core/{runtime → companion}/companion-exports.frontend.definitions.js

@@ -1 +1 @@
-//# sourceMappingURL=companion-exports.frontend.definitions.js.map
+//# sourceMappingURL=companion-exports.frontend.definitions.js.map

package/dist/esm/core/companion/companion-exports.frontend.definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-exports.frontend.definitions.js","sourceRoot":"","sources":["../../../../../src/core/companion/companion-exports.frontend.definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { DesignSystemSourceConfig } from '@wildo-ai/presets-components-models';\nimport type {\n  RuntimeOwnerCompanionExports,\n  SharedSaaSModule,\n} from '@wildo-ai/saas-models';\nimport type { AppConfiguration_Frontend } from '../config/app-configuration-frontend.schemas';\nimport type { FrontendModule } from '../runtime/domain-module.frontend.definitions';\n\n/**\n * Introspection-safe frontend companion surface for application packages.\n *\n * Apps can keep authored config in app-local files while still exposing one\n * typed contract for companion/tooling consumers. The framework owns the shape;\n * each application only provides its concrete authored values.\n */\nexport interface FrontendCompanionExports<\n  TDesignSystemConfig = DesignSystemSourceConfig,\n  TNavigationLayoutConfig = AppConfiguration_Frontend['navigationLayout'],\n  TAppShellConfig = AppConfiguration_Frontend['appComponentsConfiguration'],\n  TSettingsHubConfig = AppConfiguration_Frontend['settingsHub'],\n  TErrorPageConfig = AppConfiguration_Frontend['errorPageConfig'],\n  THomeDefinition = AppConfiguration_Frontend['homeDefinition'],\n> extends RuntimeOwnerCompanionExports {\n  designSystemConfig: TDesignSystemConfig;\n  navigationLayoutConfig: TNavigationLayoutConfig;\n  appShellConfig: TAppShellConfig;\n  /**\n   * The application's authored settings rail.\n   *\n   * Optional so an application that has not yet authored one still satisfies the\n   * contract — the companion then plans no settings-hub label units, which is\n   * correct: an unplaced rail has no labels to generate.\n   */\n  settingsHubConfig?: TSettingsHubConfig;\n  errorPageConfig: TErrorPageConfig;\n  homeDefinitionFactory: () => THomeDefinition;\n  loadFrontendModules?: () => Promise<FrontendModule[]>;\n  loadSharedModules?: () => Promise<SharedSaaSModule[]>;\n}\n"]}

package/dist/esm/core/components-registry/ComponentNotInjected.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentNotInjected.d.ts","sourceRoot":"","sources":["../../../../src/core/components-registry/ComponentNotInjected.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,yBAAyB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,EAAE,aAAa,EAAE,aAAa,EAAE,EAAE,yBAAyB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA2BnH"}
+{"version":3,"file":"ComponentNotInjected.d.ts","sourceRoot":"","sources":["../../../../../src/core/components-registry/ComponentNotInjected.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,yBAAyB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,EAAE,aAAa,EAAE,aAAa,EAAE,EAAE,yBAAyB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA2BnH"}

package/dist/esm/core/components-registry/ComponentNotInjected.js

@@ -14,4 +14,4 @@ export function ComponentNotInjected({ componentType, componentName }) {
             fontFamily: 'system-ui, sans-serif',
         }, children: [_jsx("div", { style: { fontWeight: 600, marginBottom: '4px' }, children: "Component not injected" }), _jsxs("div", { style: { fontSize: '12px', opacity: 0.8 }, children: [_jsx("strong", { children: componentName }), " (", componentType, ") has no registered preset. Register it via ", _jsx("code", { children: "registerDefaultPresets()" }), " in your app entry point."] })] }));
 }
-//# sourceMappingURL=ComponentNotInjected.js.map
+//# sourceMappingURL=ComponentNotInjected.js.map

package/dist/esm/core/components-registry/ComponentNotInjected.js.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentNotInjected.js","sourceRoot":"","sources":["../../../../src/core/components-registry/ComponentNotInjected.tsx"],"names":[],"mappings":";AAQA,MAAM,UAAU,oBAAoB,CAAC,EAAE,aAAa,EAAE,aAAa,EAA6B;IAC9F,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC1C,OAAO,mBAAK,CAAC;IACf,CAAC;IAED,OAAO,CACL,eACE,KAAK,EAAE;YACL,MAAM,EAAE,oBAAoB;YAC5B,YAAY,EAAE,KAAK;YACnB,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,OAAO;YACf,eAAe,EAAE,SAAS;YAC1B,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,MAAM;YAChB,UAAU,EAAE,uBAAuB;SACpC,aAED,cAAK,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,uCAE9C,EACN,eAAK,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,aAC5C,2BAAS,aAAa,GAAU,QAAG,aAAa,kDAChC,sDAAqC,iCACjD,IACF,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ComponentNotInjected.js","sourceRoot":"","sources":["../../../../../src/core/components-registry/ComponentNotInjected.tsx"],"names":[],"mappings":";AAQA,MAAM,UAAU,oBAAoB,CAAC,EAAE,aAAa,EAAE,aAAa,EAA6B;IAC9F,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC1C,OAAO,mBAAK,CAAC;IACf,CAAC;IAED,OAAO,CACL,eACE,KAAK,EAAE;YACL,MAAM,EAAE,oBAAoB;YAC5B,YAAY,EAAE,KAAK;YACnB,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,OAAO;YACf,eAAe,EAAE,SAAS;YAC1B,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,MAAM;YAChB,UAAU,EAAE,uBAAuB;SACpC,aAED,cAAK,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,uCAE9C,EACN,eAAK,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,aAC5C,2BAAS,aAAa,GAAU,QAAG,aAAa,kDAChC,sDAAqC,iCACjD,IACF,CACP,CAAC;AACJ,CAAC","sourcesContent":["import React from 'react';\n\ninterface ComponentNotInjectedProps {\n  componentType: string;\n  componentName: string;\n  [key: string]: unknown;\n}\n\nexport function ComponentNotInjected({ componentType, componentName }: ComponentNotInjectedProps): React.JSX.Element {\n  if (process.env.NODE_ENV === 'production') {\n    return <></>;\n  }\n\n  return (\n    <div\n      style={{\n        border: '2px dashed #ef4444',\n        borderRadius: '6px',\n        padding: '12px 16px',\n        margin: '4px 0',\n        backgroundColor: '#fef2f2',\n        color: '#991b1b',\n        fontSize: '13px',\n        fontFamily: 'system-ui, sans-serif',\n      }}\n    >\n      <div style={{ fontWeight: 600, marginBottom: '4px' }}>\n        Component not injected\n      </div>\n      <div style={{ fontSize: '12px', opacity: 0.8 }}>\n        <strong>{componentName}</strong> ({componentType}) has no registered preset.\n        Register it via <code>registerDefaultPresets()</code> in your app entry point.\n      </div>\n    </div>\n  );\n}\n"]}

package/dist/esm/core/components-registry/assert-registry-completeness.frontend.helper.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Tier-1 Registration Completeness Check
+ *
+ * Validates that every `FrontendComponentType` value that should have a
+ * registered preset (Tier-1 — DI/registry-resolved) actually has one.
+ *
+ * Tier-2 / framework-internal / dispatcher / i18n-bundle-only slots are
+ * explicitly deny-listed below. Any new addition to the enum that does
+ * NOT belong on that list MUST be registered, otherwise this check fails.
+ *
+ * See `.cursor/plans/compound-component-system.md` Section 15 for the
+ * full Tier-1 vs Tier-2 model.
+ */
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+export interface RegistryCompletenessReport {
+    totalEnumValues: number;
+    registeredCount: number;
+    denyListedCount: number;
+    missing: FrontendComponentType[];
+}
+/**
+ * Compute (without throwing) the set of enum entries that should be
+ * registered but are not. Useful for tests and for the boot-time check.
+ */
+export declare function computeRegistryCompleteness(): RegistryCompletenessReport;
+/**
+ * Boot-time guard.
+ *
+ * Call this once after every `registerDefaultPresets()` /
+ * `registerFrameworkLayouts()` invocation completes during app startup.
+ *
+ * Behaviour:
+ *  - In `development`: throws a hard error listing all missing entries.
+ *    The developer must either register the missing component or add
+ *    its enum value to `KNOWN_NON_REGISTERED_COMPONENT_TYPES` with a
+ *    justification.
+ *  - In `production`: logs a warning and returns. Avoids breaking a
+ *    deployed app over a registration omission, but surfaces it loudly
+ *    in monitoring.
+ *
+ * @returns the same report `computeRegistryCompleteness()` returned.
+ */
+export declare function assertRegistryCompleteness(options?: {
+    /**
+     * When true, throw even outside `development`. Useful for CI / unit
+     * tests that want a strict gate regardless of NODE_ENV.
+     */
+    strict?: boolean;
+}): RegistryCompletenessReport;
+//# sourceMappingURL=assert-registry-completeness.frontend.helper.d.ts.map

package/dist/esm/core/components-registry/assert-registry-completeness.frontend.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-registry-completeness.frontend.helper.d.ts","sourceRoot":"","sources":["../../../../../src/core/components-registry/assert-registry-completeness.frontend.helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAsG5E,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,0BAA0B,CAoBxE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE;IACnD;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,0BAA0B,CAwB7B"}

package/dist/esm/core/components-registry/assert-registry-completeness.frontend.helper.js

@@ -0,0 +1,168 @@
+/**
+ * Tier-1 Registration Completeness Check
+ *
+ * Validates that every `FrontendComponentType` value that should have a
+ * registered preset (Tier-1 — DI/registry-resolved) actually has one.
+ *
+ * Tier-2 / framework-internal / dispatcher / i18n-bundle-only slots are
+ * explicitly deny-listed below. Any new addition to the enum that does
+ * NOT belong on that list MUST be registered, otherwise this check fails.
+ *
+ * See `.cursor/plans/compound-component-system.md` Section 15 for the
+ * full Tier-1 vs Tier-2 model.
+ */
+import { FrontendComponentType } from '@wildo-ai/presets-components-models';
+import { ComponentRegistryService } from './component-registry.frontend.service.js';
+import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
+const logger = LoggerFrontendService.getLogger();
+/**
+ * Enum entries that intentionally have NO registered preset.
+ *
+ * Each entry MUST have a one-line justification explaining why it is not
+ * registered. Categories:
+ *
+ *   (a) i18n-bundle-only — exists for `useI18n({ component })` lookup
+ *       but is rendered via direct composition, not via `resolve()`.
+ *   (b) framework-internal — rendered directly by framework code (e.g.
+ *       flows-actors, guidance, progression, lifecycle), not swappable.
+ *   (c) deprecated — superseded by another slot, kept only for migration.
+ *   (d) dispatcher — meta-slot that resolves to one of several concrete
+ *       slots at render time (HIGH_LEVEL_VIEWS_COMPOSITE etc.).
+ *   (e) orphan — historical leftover, kept on the enum for back-compat
+ *       of i18n keys but no longer wired to any wrapper.
+ */
+const KNOWN_NON_REGISTERED_COMPONENT_TYPES = new Set([
+    // (a) i18n-bundle-only — ContentSectionContainer uses direct composition. (The
+    // SECTION / GROUP / LEGEND slots are now registered ContentSection primitives.)
+    FrontendComponentType.LOW_LEVEL_CONTENT_SECTION_CONTAINER,
+    // (a) i18n-bundle-only — used by OverlayContainer direct composition
+    FrontendComponentType.LOW_LEVEL_OVERLAY_CONTAINER,
+    // (b) framework-internal — Flows-Actors orchestration shells (engine/saas-frontend-lib/src/components/flows-actors/*)
+    FrontendComponentType.LOW_LEVEL_AI_FLOW_NODE,
+    FrontendComponentType.LOW_LEVEL_AI_FLOW_EXECUTION,
+    FrontendComponentType.LOW_LEVEL_AI_SYSTEM_CATALOG,
+    FrontendComponentType.LOW_LEVEL_AI_ACTOR,
+    FrontendComponentType.LOW_LEVEL_AI_EXECUTION_PLAN,
+    FrontendComponentType.LOW_LEVEL_AI_TASK_DETAIL,
+    FrontendComponentType.LOW_LEVEL_AI_TASK_MEMORY,
+    FrontendComponentType.LOW_LEVEL_AI_APPROVAL,
+    FrontendComponentType.LOW_LEVEL_AI_DECISION,
+    FrontendComponentType.LOW_LEVEL_AI_EXECUTION_STREAM,
+    FrontendComponentType.LOW_LEVEL_AI_ARTIFACT_BROWSER,
+    FrontendComponentType.LOW_LEVEL_AI_AGENT_CONFIG,
+    // (b) framework-internal — Guidance renderers (engine/saas-frontend-lib/src/core/guidance/renderers/*)
+    FrontendComponentType.GUIDANCE_CHECKLIST,
+    FrontendComponentType.GUIDANCE_CHECKLIST_ITEM,
+    FrontendComponentType.GUIDANCE_TOUR,
+    FrontendComponentType.GUIDANCE_TOOLTIP,
+    FrontendComponentType.GUIDANCE_MODAL,
+    FrontendComponentType.GUIDANCE_BANNER,
+    FrontendComponentType.GUIDANCE_ANNOUNCEMENT,
+    FrontendComponentType.GUIDANCE_BADGE,
+    FrontendComponentType.GUIDANCE_CARD,
+    FrontendComponentType.GUIDANCE_SURVEY,
+    FrontendComponentType.GUIDANCE_ONBOARDING_VIEW,
+    // (b) framework-internal — Progression renderers (engine/saas-frontend-lib/src/components/progression/*)
+    FrontendComponentType.PROGRESSION_MILESTONE_TRACKER,
+    FrontendComponentType.PROGRESSION_ACHIEVEMENT_BADGE,
+    // (b) framework-internal — Lifecycle renderers (composed directly in app shells)
+    FrontendComponentType.LIFECYCLE_HOME_ACTIVATION_PROGRESS,
+    FrontendComponentType.LIFECYCLE_HOME_WELCOME_BACK,
+    FrontendComponentType.LIFECYCLE_HOME_DASHBOARD,
+    // (d) dispatcher — meta-slots that resolve to a concrete view at render time
+    FrontendComponentType.HIGH_LEVEL_VIEWS_COMPOSITE,
+    FrontendComponentType.HIGH_LEVEL_VIEWS_CHART,
+    FrontendComponentType.HIGH_LEVEL_VIEWS_FULL_CUSTOM,
+    FrontendComponentType.HIGH_LEVEL_VIEWS_FLOWS_ACTORS,
+    FrontendComponentType.HIGH_LEVEL_VIEWS_EXECUTION,
+    FrontendComponentType.HIGH_LEVEL_VIEWS_NOT_FOUND,
+    // (b) framework-internal — H-8: app-owned shell slots. The enum entry is
+    // kept so that (1) host apps can register their own preset implementation
+    // for the slot if/when they need it, and (2) i18n labels remain
+    // addressable. The framework itself does not ship a default preset because
+    // the layout shape is intentionally app-owned (test harness page, security
+    // settings page).
+    FrontendComponentType.APP_LAYOUTS_TEST_COMPONENT,
+    FrontendComponentType.APP_LAYOUTS_SECURITY_SETTINGS,
+    // The Settings Hub + its bespoke panels are composed by the navigation
+    // runtime (NavigationContentRenderer → SettingsHub) and the hub's own panel
+    // resolver, NOT the ComponentRegistry. Their enum entries exist for i18n
+    // label addressability + spec coverage; the framework ships no default preset.
+    FrontendComponentType.APP_LAYOUTS_SETTINGS_HUB,
+    FrontendComponentType.APP_LAYOUTS_APPEARANCE_SETTINGS,
+    FrontendComponentType.APP_LAYOUTS_INVITATIONS_SETTINGS,
+    FrontendComponentType.APP_LAYOUTS_BILLING_SETTINGS,
+    // (e) orphan — H-5: FK editing AND display both flow through the
+    // dedicated RESOURCES_FIELDS_RESOURCE_REFERENCE preset (registered by
+    // category EDIT/DISPLAY in register-framework-layouts.ts) so there is no
+    // separate FORM_FIELD / DISPLAY_FIELD wrapper to register. The enum
+    // entries are kept on the schema for consumers that key i18n labels off
+    // them; renaming has cross-package blast radius (presets, generated
+    // specs, locale bundles), so we treat them as documented orphans rather
+    // than removing them.
+    FrontendComponentType.LOW_LEVEL_FORM_FIELD_FOREIGN_KEY,
+    FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FOREIGN_KEY,
+]);
+/**
+ * Compute (without throwing) the set of enum entries that should be
+ * registered but are not. Useful for tests and for the boot-time check.
+ */
+export function computeRegistryCompleteness() {
+    const allValues = Object.values(FrontendComponentType);
+    const missing = [];
+    let registeredCount = 0;
+    for (const type of allValues) {
+        if (KNOWN_NON_REGISTERED_COMPONENT_TYPES.has(type))
+            continue;
+        if (ComponentRegistryService.hasComponentType(type)) {
+            registeredCount += 1;
+        }
+        else {
+            missing.push(type);
+        }
+    }
+    return {
+        totalEnumValues: allValues.length,
+        registeredCount,
+        denyListedCount: KNOWN_NON_REGISTERED_COMPONENT_TYPES.size,
+        missing,
+    };
+}
+/**
+ * Boot-time guard.
+ *
+ * Call this once after every `registerDefaultPresets()` /
+ * `registerFrameworkLayouts()` invocation completes during app startup.
+ *
+ * Behaviour:
+ *  - In `development`: throws a hard error listing all missing entries.
+ *    The developer must either register the missing component or add
+ *    its enum value to `KNOWN_NON_REGISTERED_COMPONENT_TYPES` with a
+ *    justification.
+ *  - In `production`: logs a warning and returns. Avoids breaking a
+ *    deployed app over a registration omission, but surfaces it loudly
+ *    in monitoring.
+ *
+ * @returns the same report `computeRegistryCompleteness()` returned.
+ */
+export function assertRegistryCompleteness(options) {
+    const report = computeRegistryCompleteness();
+    if (report.missing.length === 0) {
+        return report;
+    }
+    const message = `[ComponentRegistry] Tier-1 completeness check failed: ${report.missing.length} ` +
+        `FrontendComponentType value(s) have no registered preset.\n\n` +
+        `Missing entries:\n${report.missing.map(t => `  - ${t}`).join('\n')}\n\n` +
+        `For each missing entry you must EITHER:\n` +
+        `  (1) register a default preset in registerDefaultPresets() / registerFrameworkLayouts(); OR\n` +
+        `  (2) add the enum value to KNOWN_NON_REGISTERED_COMPONENT_TYPES in ` +
+        `assert-registry-completeness.frontend.helper.ts with a one-line justification ` +
+        `(see compound-component-system.md Section 15 for the Tier-1 vs Tier-2 model).`;
+    const isDev = typeof process !== 'undefined' && process.env?.NODE_ENV === 'development';
+    if (options?.strict || isDev) {
+        throw new Error(message);
+    }
+    logger.warn('component-registry.completeness-check.failed', { message, missing: report.missing });
+    return report;
+}
+//# sourceMappingURL=assert-registry-completeness.frontend.helper.js.map

package/dist/esm/core/components-registry/assert-registry-completeness.frontend.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-registry-completeness.frontend.helper.js","sourceRoot":"","sources":["../../../../../src/core/components-registry/assert-registry-completeness.frontend.helper.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tier-1 Registration Completeness Check\n *\n * Validates that every `FrontendComponentType` value that should have a\n * registered preset (Tier-1 — DI/registry-resolved) actually has one.\n *\n * Tier-2 / framework-internal / dispatcher / i18n-bundle-only slots are\n * explicitly deny-listed below. Any new addition to the enum that does\n * NOT belong on that list MUST be registered, otherwise this check fails.\n *\n * See `.cursor/plans/compound-component-system.md` Section 15 for the\n * full Tier-1 vs Tier-2 model.\n */\n\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { ComponentRegistryService } from './component-registry.frontend.service';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\n\n/**\n * Enum entries that intentionally have NO registered preset.\n *\n * Each entry MUST have a one-line justification explaining why it is not\n * registered. Categories:\n *\n *   (a) i18n-bundle-only — exists for `useI18n({ component })` lookup\n *       but is rendered via direct composition, not via `resolve()`.\n *   (b) framework-internal — rendered directly by framework code (e.g.\n *       flows-actors, guidance, progression, lifecycle), not swappable.\n *   (c) deprecated — superseded by another slot, kept only for migration.\n *   (d) dispatcher — meta-slot that resolves to one of several concrete\n *       slots at render time (HIGH_LEVEL_VIEWS_COMPOSITE etc.).\n *   (e) orphan — historical leftover, kept on the enum for back-compat\n *       of i18n keys but no longer wired to any wrapper.\n */\nconst KNOWN_NON_REGISTERED_COMPONENT_TYPES: ReadonlySet<FrontendComponentType> = new Set([\n  // (a) i18n-bundle-only — ContentSectionContainer uses direct composition. (The\n  // SECTION / GROUP / LEGEND slots are now registered ContentSection primitives.)\n  FrontendComponentType.LOW_LEVEL_CONTENT_SECTION_CONTAINER,\n  // (a) i18n-bundle-only — used by OverlayContainer direct composition\n  FrontendComponentType.LOW_LEVEL_OVERLAY_CONTAINER,\n\n  // (b) framework-internal — Flows-Actors orchestration shells (engine/saas-frontend-lib/src/components/flows-actors/*)\n  FrontendComponentType.LOW_LEVEL_AI_FLOW_NODE,\n  FrontendComponentType.LOW_LEVEL_AI_FLOW_EXECUTION,\n  FrontendComponentType.LOW_LEVEL_AI_SYSTEM_CATALOG,\n  FrontendComponentType.LOW_LEVEL_AI_ACTOR,\n  FrontendComponentType.LOW_LEVEL_AI_EXECUTION_PLAN,\n  FrontendComponentType.LOW_LEVEL_AI_TASK_DETAIL,\n  FrontendComponentType.LOW_LEVEL_AI_TASK_MEMORY,\n  FrontendComponentType.LOW_LEVEL_AI_APPROVAL,\n  FrontendComponentType.LOW_LEVEL_AI_DECISION,\n  FrontendComponentType.LOW_LEVEL_AI_EXECUTION_STREAM,\n  FrontendComponentType.LOW_LEVEL_AI_ARTIFACT_BROWSER,\n  FrontendComponentType.LOW_LEVEL_AI_AGENT_CONFIG,\n\n  // (b) framework-internal — Guidance renderers (engine/saas-frontend-lib/src/core/guidance/renderers/*)\n  FrontendComponentType.GUIDANCE_CHECKLIST,\n  FrontendComponentType.GUIDANCE_CHECKLIST_ITEM,\n  FrontendComponentType.GUIDANCE_TOUR,\n  FrontendComponentType.GUIDANCE_TOOLTIP,\n  FrontendComponentType.GUIDANCE_MODAL,\n  FrontendComponentType.GUIDANCE_BANNER,\n  FrontendComponentType.GUIDANCE_ANNOUNCEMENT,\n  FrontendComponentType.GUIDANCE_BADGE,\n  FrontendComponentType.GUIDANCE_CARD,\n  FrontendComponentType.GUIDANCE_SURVEY,\n  FrontendComponentType.GUIDANCE_ONBOARDING_VIEW,\n\n  // (b) framework-internal — Progression renderers (engine/saas-frontend-lib/src/components/progression/*)\n  FrontendComponentType.PROGRESSION_MILESTONE_TRACKER,\n  FrontendComponentType.PROGRESSION_ACHIEVEMENT_BADGE,\n\n  // (b) framework-internal — Lifecycle renderers (composed directly in app shells)\n  FrontendComponentType.LIFECYCLE_HOME_ACTIVATION_PROGRESS,\n  FrontendComponentType.LIFECYCLE_HOME_WELCOME_BACK,\n  FrontendComponentType.LIFECYCLE_HOME_DASHBOARD,\n\n  // (d) dispatcher — meta-slots that resolve to a concrete view at render time\n  FrontendComponentType.HIGH_LEVEL_VIEWS_COMPOSITE,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_CHART,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_FULL_CUSTOM,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_FLOWS_ACTORS,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_EXECUTION,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_NOT_FOUND,\n\n  // (b) framework-internal — H-8: app-owned shell slots. The enum entry is\n  // kept so that (1) host apps can register their own preset implementation\n  // for the slot if/when they need it, and (2) i18n labels remain\n  // addressable. The framework itself does not ship a default preset because\n  // the layout shape is intentionally app-owned (test harness page, security\n  // settings page).\n  FrontendComponentType.APP_LAYOUTS_TEST_COMPONENT,\n  FrontendComponentType.APP_LAYOUTS_SECURITY_SETTINGS,\n  // The Settings Hub + its bespoke panels are composed by the navigation\n  // runtime (NavigationContentRenderer → SettingsHub) and the hub's own panel\n  // resolver, NOT the ComponentRegistry. Their enum entries exist for i18n\n  // label addressability + spec coverage; the framework ships no default preset.\n  FrontendComponentType.APP_LAYOUTS_SETTINGS_HUB,\n  FrontendComponentType.APP_LAYOUTS_APPEARANCE_SETTINGS,\n  FrontendComponentType.APP_LAYOUTS_INVITATIONS_SETTINGS,\n  FrontendComponentType.APP_LAYOUTS_BILLING_SETTINGS,\n\n  // (e) orphan — H-5: FK editing AND display both flow through the\n  // dedicated RESOURCES_FIELDS_RESOURCE_REFERENCE preset (registered by\n  // category EDIT/DISPLAY in register-framework-layouts.ts) so there is no\n  // separate FORM_FIELD / DISPLAY_FIELD wrapper to register. The enum\n  // entries are kept on the schema for consumers that key i18n labels off\n  // them; renaming has cross-package blast radius (presets, generated\n  // specs, locale bundles), so we treat them as documented orphans rather\n  // than removing them.\n  FrontendComponentType.LOW_LEVEL_FORM_FIELD_FOREIGN_KEY,\n  FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FOREIGN_KEY,\n]);\n\nexport interface RegistryCompletenessReport {\n  totalEnumValues: number;\n  registeredCount: number;\n  denyListedCount: number;\n  missing: FrontendComponentType[];\n}\n\n/**\n * Compute (without throwing) the set of enum entries that should be\n * registered but are not. Useful for tests and for the boot-time check.\n */\nexport function computeRegistryCompleteness(): RegistryCompletenessReport {\n  const allValues = Object.values(FrontendComponentType) as FrontendComponentType[];\n  const missing: FrontendComponentType[] = [];\n  let registeredCount = 0;\n\n  for (const type of allValues) {\n    if (KNOWN_NON_REGISTERED_COMPONENT_TYPES.has(type)) continue;\n    if (ComponentRegistryService.hasComponentType(type)) {\n      registeredCount += 1;\n    } else {\n      missing.push(type);\n    }\n  }\n\n  return {\n    totalEnumValues: allValues.length,\n    registeredCount,\n    denyListedCount: KNOWN_NON_REGISTERED_COMPONENT_TYPES.size,\n    missing,\n  };\n}\n\n/**\n * Boot-time guard.\n *\n * Call this once after every `registerDefaultPresets()` /\n * `registerFrameworkLayouts()` invocation completes during app startup.\n *\n * Behaviour:\n *  - In `development`: throws a hard error listing all missing entries.\n *    The developer must either register the missing component or add\n *    its enum value to `KNOWN_NON_REGISTERED_COMPONENT_TYPES` with a\n *    justification.\n *  - In `production`: logs a warning and returns. Avoids breaking a\n *    deployed app over a registration omission, but surfaces it loudly\n *    in monitoring.\n *\n * @returns the same report `computeRegistryCompleteness()` returned.\n */\nexport function assertRegistryCompleteness(options?: {\n  /**\n   * When true, throw even outside `development`. Useful for CI / unit\n   * tests that want a strict gate regardless of NODE_ENV.\n   */\n  strict?: boolean;\n}): RegistryCompletenessReport {\n  const report = computeRegistryCompleteness();\n\n  if (report.missing.length === 0) {\n    return report;\n  }\n\n  const message =\n    `[ComponentRegistry] Tier-1 completeness check failed: ${report.missing.length} ` +\n    `FrontendComponentType value(s) have no registered preset.\\n\\n` +\n    `Missing entries:\\n${report.missing.map(t => `  - ${t}`).join('\\n')}\\n\\n` +\n    `For each missing entry you must EITHER:\\n` +\n    `  (1) register a default preset in registerDefaultPresets() / registerFrameworkLayouts(); OR\\n` +\n    `  (2) add the enum value to KNOWN_NON_REGISTERED_COMPONENT_TYPES in ` +\n    `assert-registry-completeness.frontend.helper.ts with a one-line justification ` +\n    `(see compound-component-system.md Section 15 for the Tier-1 vs Tier-2 model).`;\n\n  const isDev = typeof process !== 'undefined' && process.env?.NODE_ENV === 'development';\n  if (options?.strict || isDev) {\n    throw new Error(message);\n  }\n\n  logger.warn('component-registry.completeness-check.failed', { message, missing: report.missing });\n  return report;\n}\n"]}

package/dist/esm/core/components-registry/component-registry-loader.frontend.service.d.ts

@@ -1,4 +1,4 @@
-import type { FrontendComponentRegistration } from '../runtime/domain-module.frontend.definitions.js';
+import type { FrontendComponentRegistration } from '../runtime/domain-module.frontend.definitions';
 /**
  * Load and register custom components from app-custom libraries
  *
@@ -14,5 +14,5 @@ export declare function getLoadingStats(): {
     totalRegistered: number;
     byCategory: Map<string, number>;
 };
-export declare function registerFrontendComponentRegistrations(registrations: FrontendComponentRegistration[]): void;
+export declare function registerFrontendComponentRegistrations(registrations: FrontendComponentRegistration[]): Promise<void>;
 //# sourceMappingURL=component-registry-loader.frontend.service.d.ts.map

package/dist/esm/core/components-registry/component-registry-loader.frontend.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-registry-loader.frontend.service.d.ts","sourceRoot":"","sources":["../../../../src/core/components-registry/component-registry-loader.frontend.service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AAOnG;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,GACpD,IAAI,CAsCN;AAED,wBAAgB,eAAe,IAAI;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAgBA;AAED,wBAAgB,sCAAsC,CACpD,aAAa,EAAE,6BAA6B,EAAE,GAC7C,IAAI,CASN"}
+{"version":3,"file":"component-registry-loader.frontend.service.d.ts","sourceRoot":"","sources":["../../../../../src/core/components-registry/component-registry-loader.frontend.service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AAOnG;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,GACpD,IAAI,CAsCN;AAED,wBAAgB,eAAe,IAAI;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAgBA;AAED,wBAAsB,sCAAsC,CAC1D,aAAa,EAAE,6BAA6B,EAAE,GAC7C,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/esm/core/components-registry/component-registry-loader.frontend.service.js

@@ -57,9 +57,10 @@ export function getLoadingStats() {
         byCategory
     };
 }
-export function registerFrontendComponentRegistrations(registrations) {
+export async function registerFrontendComponentRegistrations(registrations) {
     for (const registration of registrations) {
-        ComponentRegistryService.register(registration.componentRef, registration.preset ?? CorePresetNames.DEFAULT, registration.component, { isConfigurable: registration.isConfigurable ?? false });
+        const component = await registration.loadComponent();
+        ComponentRegistryService.register(registration.componentRef, registration.preset ?? CorePresetNames.DEFAULT, component, { isConfigurable: registration.isConfigurable ?? false });
     }
 }
-//# sourceMappingURL=component-registry-loader.frontend.service.js.map
+//# sourceMappingURL=component-registry-loader.frontend.service.js.map

package/dist/esm/core/components-registry/component-registry-loader.frontend.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-registry-loader.frontend.service.js","sourceRoot":"","sources":["../../../../src/core/components-registry/component-registry-loader.frontend.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC7F,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AAIpG,MAAM,MAAM,GAA0B,qBAAqB,CAAC,SAAS,EAAE,CAAC;AACxE,MAAM,QAAQ,GAAiE,MAAM,CAAC,WAAW,CAAC,gCAAgC,CAAC,CAAC;AACpI,MAAM,CAAC,mBAAmB,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;AAEpE;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,gBAAqD;IAErD,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,OAAO;IACT,CAAC;IAED,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAClC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAAE,EAAE;YAC/D,MAAM,aAAa,GAAG,gBAAyC,CAAC;YAEhE,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;gBAAE,OAAO;YAEhD,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;gBACvB,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS;oBAAE,OAAO;gBAEzC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,IAAI,eAAe,CAAC,OAAO,CAAC;gBAG9E,MAAM,mBAAmB,GAAG,wBAAwB,CAAC,YAAY,CAAE,aAAa,EAAE,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAE,CAAC;gBAEhH,IAAI,CAAC,mBAAmB,EAAE,CAAC;oBAEzB,wBAAwB,CAAC,QAAQ,CAC/B,aAAa,EAAE,UAAU,EAAE,MAAM,CAAC,SAAS,EAC3C,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,KAAK,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAE,CAAC;oBAEnF,eAAe,EAAE,CAAC;gBACpB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACxB,QAAQ,CAAC,+BAA+B,eAAe,wBAAwB,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAI7B,MAAM,MAAM,GAAG,wBAAwB,CAAC,sBAAsB,EAAE,CAAC;IACjE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE7C,mDAAmD;IACnD,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,aAAa,EAAE,EAAE;QAC9C,uCAAuC;QACvC,yCAAyC;QACzC,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC;QAC5E,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,eAAe,EAAE,wBAAwB,CAAC,oBAAoB,EAAE;QAChE,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sCAAsC,CACpD,aAA8C;IAE9C,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;QACzC,wBAAwB,CAAC,QAAQ,CAC/B,YAAY,CAAC,YAAqC,EAClD,YAAY,CAAC,MAAM,IAAI,eAAe,CAAC,OAAO,EAC9C,YAAY,CAAC,SAAS,EACtB,EAAE,cAAc,EAAE,YAAY,CAAC,cAAc,IAAI,KAAK,EAAE,CACzD,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"component-registry-loader.frontend.service.js","sourceRoot":"","sources":["../../../../../src/core/components-registry/component-registry-loader.frontend.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';\nimport { ComponentRegistryService } from './component-registry.frontend.service';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport type { FrontendComponentRegistration } from '../runtime/domain-module.frontend.definitions';\n\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = logger.debugByType('ComponentRegistryLoaderService');\nlogger.setDebugTypeLogging('ComponentRegistryLoaderService', false);\n\n/**\n * Load and register custom components from app-custom libraries\n *\n * Custom components are already imported in the runnable App.tsx,\n * so their modules are already loaded. This function ensures they\n * are registered in the ComponentRegistryService.\n *\n * This handles the case where custom components use the old\n * registry pattern (direct component in registry object).\n */\nexport function loadCustomComponents(\n  customRegistries: Array<Partial<Record<string, any>>>\n): void {\n  if (!customRegistries || customRegistries.length === 0) {\n    return;\n  }\n\n  let registeredCount = 0;\n\n  customRegistries.forEach(registry => {\n    if (!registry) return;\n\n    Object.entries(registry).forEach(([componentTypeStr, presets]) => {\n      const componentType = componentTypeStr as FrontendComponentType;\n\n      if (!presets || !Array.isArray(presets)) return;\n\n      presets.forEach(preset => {\n        if (!preset || !preset.component) return;\n\n        const presetName = preset.variant || preset.preset || CorePresetNames.DEFAULT;\n\n\n        const isAlreadyRegistered = ComponentRegistryService.isRegistered( componentType, presetName, preset.category );\n\n        if (!isAlreadyRegistered) {\n\n          ComponentRegistryService.register(\n            componentType, presetName, preset.component,\n            { isConfigurable: preset.isConfigurable !== false, category: preset.category } );\n\n          registeredCount++;\n        }\n      });\n    });\n  });\n\n  if (registeredCount > 0) {\n    logDebug(`✅ Custom components loaded: ${registeredCount} components registered`);\n  }\n}\n\nexport function getLoadingStats(): {\n  totalRegistered: number;\n  byCategory: Map<string, number>;\n} {\n  const byType = ComponentRegistryService.getRegistrationsByType();\n  const byCategory = new Map<string, number>();\n\n  // Group by category (LOW_LEVEL, APP_LAYOUTS, etc.)\n  byType.forEach((registrations, componentType) => {\n    // Extract category from component type\n    // e.g., \"LOW_LEVEL_BUTTON\" → \"LOW_LEVEL\"\n    const category = componentType.split('_').slice(0, -1).join('_') || 'OTHER';\n    byCategory.set(category, (byCategory.get(category) || 0) + registrations.length);\n  });\n\n  return {\n    totalRegistered: ComponentRegistryService.getRegistrationCount(),\n    byCategory\n  };\n}\n\nexport async function registerFrontendComponentRegistrations(\n  registrations: FrontendComponentRegistration[],\n): Promise<void> {\n  for (const registration of registrations) {\n    const component = await registration.loadComponent();\n    ComponentRegistryService.register(\n      registration.componentRef as FrontendComponentType,\n      registration.preset ?? CorePresetNames.DEFAULT,\n      component,\n      { isConfigurable: registration.isConfigurable ?? false },\n    );\n  }\n}\n"]}

package/dist/esm/core/components-registry/component-registry.frontend.schemas.d.ts

@@ -1,4 +1,4 @@
-import { FrontendComponentType, FrontEndComponentResourceFieldCategory, CorePresetNames } from '@wildo-ai/presets-components-models';
+import type { FrontendComponentType, FrontEndComponentResourceFieldCategory, CorePresetNames } from '@wildo-ai/presets-components-models';
 export interface ComponentPresetProps {
     preset?: CorePresetNames | string;
 }
@@ -21,6 +21,22 @@ export interface RegistrationInfo {
     isConfigurable: boolean;
     registeredAt: Date;
 }
+/**
+ * One exact component registration a frontend host requires before it can
+ * mount. A component type registered under another preset or field category
+ * does not satisfy this requirement.
+ */
+export interface ComponentRegistrationRequirement {
+    readonly componentType: FrontendComponentType;
+    readonly preset: CorePresetNames | string;
+    readonly category?: FrontEndComponentResourceFieldCategory;
+}
+/** Deterministic result of validating a host's declared component subset. */
+export interface ComponentRegistrationRequirementsReport {
+    readonly requiredCount: number;
+    readonly registeredCount: number;
+    readonly missing: readonly ComponentRegistrationRequirement[];
+}
 export interface ComponentRegistration_LoadResult {
     success: boolean;
     loadTime?: number;