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

package/dist/esm/core/config/useVisibleSettingsHubConfig.js

@@ -0,0 +1,61 @@
+/**
+ * Resolves the Settings Hub config gated to what the current user may see.
+ *
+ * Layered on {@link useSettingsHubConfig} (which resolves the application's
+ * authored placements against the engine destination catalog): this hook
+ * collects the live gating signals — primary scope, effective roles, resolved
+ * features, runtime capabilities — and runs the pure
+ * {@link filterSettingsHubConfig}. The hub component consumes the already-gated
+ * config, so it never has to know about scope/role/feature evaluation.
+ *
+ * Note the two stages answer different questions and must stay separate. This
+ * one asks "may THIS USER see the section" and its answer changes as the user's
+ * scope and roles change. Resolution asks "did the APPLICATION place it at all",
+ * and a `no` there is authorship, not gating — it must never be recoverable by a
+ * user gaining a role.
+ *
+ * Signals are sourced from the SAME hooks the rest of the frontend gating layer
+ * uses, so a settings section appears under exactly the same conditions as the
+ * equivalent sidebar/command-menu entry:
+ * - scope → `useAppScopeSafe`
+ * - effective roles → `buildFeaturePolicyRoles(permissions, currentOrganizationId)`
+ * - features → `useFeatures().resolvedFeatures`
+ * - capabilities → `useLauncherRuntimeAvailabilityContext`
+ */
+import { useMemo } from 'react';
+import { useAppScopeSafe } from '../../core/scope/useAppScope.js';
+import { useUserOrgs } from '../../core/security/useUserOrgs.js';
+import { useFeatures } from '../../core/features/useFeatures.js';
+import { useLauncherRuntimeAvailabilityContext } from '../../core/navigation/launcher-runtime-availability.js';
+import { buildFeaturePolicyRoles } from '../../core/features/feature-unavailability.frontend.utils.js';
+import { useSettingsHubConfig } from './useSettingsHubConfig.js';
+import { filterSettingsHubConfig } from './settings-hub-gating.frontend.utils.js';
+export function useVisibleSettingsHubConfig() {
+    const rawConfig = useSettingsHubConfig();
+    const appScope = useAppScopeSafe();
+    const { permissions } = useUserOrgs();
+    const { resolvedFeatures } = useFeatures();
+    const runtimeContext = useLauncherRuntimeAvailabilityContext();
+    const userRoles = useMemo(() => buildFeaturePolicyRoles(permissions, appScope?.currentOrganizationId), [permissions, appScope?.currentOrganizationId]);
+    return useMemo(() => filterSettingsHubConfig(rawConfig, {
+        scopeIds: {
+            currentUserId: appScope?.currentUserId,
+            currentOrganizationId: appScope?.currentOrganizationId,
+            currentApplicationId: appScope?.currentApplicationId,
+            currentAnonymousUserId: appScope?.currentAnonymousUserId,
+        },
+        userRoles,
+        enabledFeatures: resolvedFeatures?.features ?? [],
+        runtimeContext,
+    }), [
+        rawConfig,
+        appScope?.currentUserId,
+        appScope?.currentOrganizationId,
+        appScope?.currentApplicationId,
+        appScope?.currentAnonymousUserId,
+        userRoles,
+        resolvedFeatures?.features,
+        runtimeContext,
+    ]);
+}
+//# sourceMappingURL=useVisibleSettingsHubConfig.js.map

package/dist/esm/core/config/useVisibleSettingsHubConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVisibleSettingsHubConfig.js","sourceRoot":"","sources":["../../../../../src/core/config/useVisibleSettingsHubConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AAC5E,OAAO,EAAE,qCAAqC,EAAE,MAAM,mEAAmE,CAAC;AAC1H,OAAO,EAAE,uBAAuB,EAAE,MAAM,yEAAyE,CAAC;AAClH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAG/E,MAAM,UAAU,2BAA2B;IACzC,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAAC;IACtC,MAAM,EAAE,gBAAgB,EAAE,GAAG,WAAW,EAAE,CAAC;IAC3C,MAAM,cAAc,GAAG,qCAAqC,EAAE,CAAC;IAE/D,MAAM,SAAS,GAAG,OAAO,CACvB,GAAG,EAAE,CAAC,uBAAuB,CAAC,WAAW,EAAE,QAAQ,EAAE,qBAAqB,CAAC,EAC3E,CAAC,WAAW,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAC/C,CAAC;IAEF,OAAO,OAAO,CACZ,GAAG,EAAE,CACH,uBAAuB,CAAC,SAAS,EAAE;QACjC,QAAQ,EAAE;YACR,aAAa,EAAE,QAAQ,EAAE,aAAa;YACtC,qBAAqB,EAAE,QAAQ,EAAE,qBAAqB;YACtD,oBAAoB,EAAE,QAAQ,EAAE,oBAAoB;YACpD,sBAAsB,EAAE,QAAQ,EAAE,sBAAsB;SACzD;QACD,SAAS;QACT,eAAe,EAAE,gBAAgB,EAAE,QAAQ,IAAI,EAAE;QACjD,cAAc;KACf,CAAC,EACJ;QACE,SAAS;QACT,QAAQ,EAAE,aAAa;QACvB,QAAQ,EAAE,qBAAqB;QAC/B,QAAQ,EAAE,oBAAoB;QAC9B,QAAQ,EAAE,sBAAsB;QAChC,SAAS;QACT,gBAAgB,EAAE,QAAQ;QAC1B,cAAc;KACf,CACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Resolves the Settings Hub config gated to what the current user may see.\n *\n * Layered on {@link useSettingsHubConfig} (which resolves the application's\n * authored placements against the engine destination catalog): this hook\n * collects the live gating signals — primary scope, effective roles, resolved\n * features, runtime capabilities — and runs the pure\n * {@link filterSettingsHubConfig}. The hub component consumes the already-gated\n * config, so it never has to know about scope/role/feature evaluation.\n *\n * Note the two stages answer different questions and must stay separate. This\n * one asks \"may THIS USER see the section\" and its answer changes as the user's\n * scope and roles change. Resolution asks \"did the APPLICATION place it at all\",\n * and a `no` there is authorship, not gating — it must never be recoverable by a\n * user gaining a role.\n *\n * Signals are sourced from the SAME hooks the rest of the frontend gating layer\n * uses, so a settings section appears under exactly the same conditions as the\n * equivalent sidebar/command-menu entry:\n * - scope → `useAppScopeSafe`\n * - effective roles → `buildFeaturePolicyRoles(permissions, currentOrganizationId)`\n * - features → `useFeatures().resolvedFeatures`\n * - capabilities → `useLauncherRuntimeAvailabilityContext`\n */\n\nimport { useMemo } from 'react';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport { useFeatures } from '~wildo-frontend-lib/core/features/useFeatures';\nimport { useLauncherRuntimeAvailabilityContext } from '~wildo-frontend-lib/core/navigation/launcher-runtime-availability';\nimport { buildFeaturePolicyRoles } from '~wildo-frontend-lib/core/features/feature-unavailability.frontend.utils';\nimport { useSettingsHubConfig } from './useSettingsHubConfig';\nimport { filterSettingsHubConfig } from './settings-hub-gating.frontend.utils';\nimport type { ResolvedSettingsHubConfig } from './settings-hub.frontend.schemas';\n\nexport function useVisibleSettingsHubConfig(): ResolvedSettingsHubConfig {\n  const rawConfig = useSettingsHubConfig();\n  const appScope = useAppScopeSafe();\n  const { permissions } = useUserOrgs();\n  const { resolvedFeatures } = useFeatures();\n  const runtimeContext = useLauncherRuntimeAvailabilityContext();\n\n  const userRoles = useMemo(\n    () => buildFeaturePolicyRoles(permissions, appScope?.currentOrganizationId),\n    [permissions, appScope?.currentOrganizationId],\n  );\n\n  return useMemo(\n    () =>\n      filterSettingsHubConfig(rawConfig, {\n        scopeIds: {\n          currentUserId: appScope?.currentUserId,\n          currentOrganizationId: appScope?.currentOrganizationId,\n          currentApplicationId: appScope?.currentApplicationId,\n          currentAnonymousUserId: appScope?.currentAnonymousUserId,\n        },\n        userRoles,\n        enabledFeatures: resolvedFeatures?.features ?? [],\n        runtimeContext,\n      }),\n    [\n      rawConfig,\n      appScope?.currentUserId,\n      appScope?.currentOrganizationId,\n      appScope?.currentApplicationId,\n      appScope?.currentAnonymousUserId,\n      userRoles,\n      resolvedFeatures?.features,\n      runtimeContext,\n    ],\n  );\n}\n"]}

package/dist/esm/core/config/verify-feature-references.frontend.d.ts

@@ -1,6 +1,6 @@
 import type { FeatureConfiguration, FeatureReferenceValidationIssues } from '@wildo-ai/saas-models';
-import type { AppConfiguration_Frontend } from './app-configuration-frontend.schemas.js';
-import type { FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas.js';
+import type { AppConfiguration_Frontend } from './app-configuration-frontend.schemas';
+import type { FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas';
 export interface FrontendFeatureReferenceVerificationResult extends FeatureReferenceValidationIssues {
     isValid: boolean;
     warnings: string[];

package/dist/esm/core/config/verify-feature-references.frontend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify-feature-references.frontend.d.ts","sourceRoot":"","sources":["../../../../src/core/config/verify-feature-references.frontend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,gCAAgC,EAGjC,MAAM,uBAAuB,CAAC;AAK/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACtF,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,+DAA+D,CAAC;AAEvE,MAAM,WAAW,0CAA2C,SAAQ,gCAAgC;IAClG,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,SAAS,EAAE,yBAAyB,CAAC;IACrC,oBAAoB,EAAE,oBAAoB,CAAC;CAC5C,GAAG,0CAA0C,CA6B7C"}
+{"version":3,"file":"verify-feature-references.frontend.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/verify-feature-references.frontend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,gCAAgC,EAGjC,MAAM,uBAAuB,CAAC;AAK/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACtF,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,+DAA+D,CAAC;AAEvE,MAAM,WAAW,0CAA2C,SAAQ,gCAAgC;IAClG,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,SAAS,EAAE,yBAAyB,CAAC;IACrC,oBAAoB,EAAE,oBAAoB,CAAC;CAC5C,GAAG,0CAA0C,CA6B7C"}

package/dist/esm/core/config/verify-feature-references.frontend.js

@@ -30,7 +30,7 @@ function collectAppViewFeatureReferenceUsages(appConfig) {
         ...collectViewArrayFeatureReferenceUsages(appConfig.compositeViews, (view) => `frontend composite view '${view.ref}'`),
         ...collectViewArrayFeatureReferenceUsages(appConfig.fullCustomViews, (view) => `frontend full custom view '${view.ref}'`),
         ...collectViewArrayFeatureReferenceUsages(appConfig.flowsActorsViews, (view) => `frontend flows/actors view '${view.ref}'`),
-        ...collectViewArrayFeatureReferenceUsages(appConfig.onboardingViews, (_view, index) => `frontend onboarding view #${index + 1}`),
+        ...collectViewArrayFeatureReferenceUsages(appConfig.onboardingViews, (view) => `frontend onboarding view '${view.ref}'`),
         ...collectFrontendGuidanceFlowFeatureReferenceUsages(appConfig),
     ];
 }
@@ -114,4 +114,4 @@ function formatFeatureReferences(references) {
         .map((reference) => `'${reference.featureId}' via ${reference.slotLabel}`)
         .join(', ');
 }
-//# sourceMappingURL=verify-feature-references.frontend.js.map
+//# sourceMappingURL=verify-feature-references.frontend.js.map

package/dist/esm/core/config/verify-feature-references.frontend.js.map

@@ -1 +1 @@
-{"version":3,"file":"verify-feature-references.frontend.js","sourceRoot":"","sources":["../../../../src/core/config/verify-feature-references.frontend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"verify-feature-references.frontend.js","sourceRoot":"","sources":["../../../../../src/core/config/verify-feature-references.frontend.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  FeatureConfiguration,\n  FeatureReferenceValidationIssues,\n  FeatureReferenceEntry,\n  FeatureReferenceUsage,\n} from '@wildo-ai/saas-models';\nimport {\n  collectFeatureReferenceValidationIssues,\n  extractFeatureReferencesFromRequiredFeatures,\n} from '@wildo-ai/saas-models';\nimport type { AppConfiguration_Frontend } from './app-configuration-frontend.schemas';\nimport type {\n  AnyFrontendResourceConfiguration,\n  FrontendResourcesRegistry,\n} from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\nexport interface FrontendFeatureReferenceVerificationResult extends FeatureReferenceValidationIssues {\n  isValid: boolean;\n  warnings: string[];\n}\n\n/**\n * DEV-time validation for frontend-authored feature refs that never pass\n * through backend startup. This covers app-level views plus resource-owned UI\n * declarations such as inserted charts and resource guidance.\n */\nexport function verifyFrontendFeatureReferences(params: {\n  resourcesRegistry: FrontendResourcesRegistry;\n  appConfig: AppConfiguration_Frontend;\n  featureConfiguration: FeatureConfiguration;\n}): FrontendFeatureReferenceVerificationResult {\n  const usages: FeatureReferenceUsage[] = [\n    ...collectAppViewFeatureReferenceUsages(params.appConfig),\n    ...collectResourceConfigurationFeatureReferenceUsages(params.resourcesRegistry),\n  ];\n\n  const issues = collectFeatureReferenceValidationIssues({\n    definitions: params.featureConfiguration.definitions,\n    usages,\n  });\n\n  const warnings = [\n    ...issues.unknownIssues.map((issue) => (\n      `${issue.surface}: unknown feature reference(s): ${formatFeatureReferences(issue.references)}`\n    )),\n    ...issues.incompatibleIssues.map((issue) => (\n      `${issue.surface}: incompatible feature reference(s): ${issue.references\n        .map((reference) => (\n          `'${reference.featureId}' via ${reference.slotLabel} expects ${reference.expectedValueType} but registry defines ${reference.actualValueType}`\n        ))\n        .join(', ')}`\n    )),\n  ];\n\n  return {\n    ...issues,\n    warnings,\n    isValid: warnings.length === 0,\n  };\n}\n\nfunction collectAppViewFeatureReferenceUsages(\n  appConfig: AppConfiguration_Frontend,\n): FeatureReferenceUsage[] {\n  return [\n    ...collectViewArrayFeatureReferenceUsages(\n      appConfig.compositeViews,\n      (view) => `frontend composite view '${view.ref}'`,\n    ),\n    ...collectViewArrayFeatureReferenceUsages(\n      appConfig.fullCustomViews,\n      (view) => `frontend full custom view '${view.ref}'`,\n    ),\n    ...collectViewArrayFeatureReferenceUsages(\n      appConfig.flowsActorsViews,\n      (view) => `frontend flows/actors view '${view.ref}'`,\n    ),\n    ...collectViewArrayFeatureReferenceUsages(\n      appConfig.onboardingViews,\n      (view) => `frontend onboarding view '${view.ref}'`,\n    ),\n    ...collectFrontendGuidanceFlowFeatureReferenceUsages(appConfig),\n  ];\n}\n\nfunction collectFrontendGuidanceFlowFeatureReferenceUsages(\n  appConfig: AppConfiguration_Frontend,\n): FeatureReferenceUsage[] {\n  return (appConfig.guidanceFlows ?? []).flatMap((flow) => {\n    const references = extractFeatureReferencesFromRequiredFeatures(\n      flow.audience?.requiredFeatures,\n    );\n    if (references.length === 0) {\n      return [];\n    }\n\n    return [{\n      surface: `frontend guidance flow '${flow.ref}' audience`,\n      references,\n    }];\n  });\n}\n\nfunction collectViewArrayFeatureReferenceUsages<T extends { ref?: string; requiredFeatures?: unknown }>(\n  views: T[] | undefined,\n  surfaceBuilder: (view: T, index: number) => string,\n): FeatureReferenceUsage[] {\n  if (!views) {\n    return [];\n  }\n\n  return views.flatMap((view, index) => {\n    const references = extractFeatureReferencesFromRequiredFeatures(\n      view.requiredFeatures as never,\n    );\n    if (references.length === 0) {\n      return [];\n    }\n\n    return [{\n      surface: surfaceBuilder(view, index),\n      references,\n    }];\n  });\n}\n\nfunction collectResourceConfigurationFeatureReferenceUsages(\n  resourcesRegistry: FrontendResourcesRegistry,\n): FeatureReferenceUsage[] {\n  return Object.entries(resourcesRegistry.resourceConfigurations).flatMap(\n    ([resourceType, resourceConfiguration]) => (\n      collectSingleResourceConfigurationFeatureReferenceUsages(\n        resourceType,\n        resourceConfiguration,\n      )\n    ),\n  );\n}\n\nfunction collectSingleResourceConfigurationFeatureReferenceUsages(\n  resourceType: string,\n  resourceConfiguration: AnyFrontendResourceConfiguration,\n): FeatureReferenceUsage[] {\n  const frontendConfiguration = resourceConfiguration.frontendConfiguration;\n\n  return [\n    ...(frontendConfiguration?.compositeViews ?? []).flatMap((view) => {\n      const references = extractFeatureReferencesFromRequiredFeatures(view.requiredFeatures);\n      if (references.length === 0) {\n        return [];\n      }\n\n      return [{\n        surface: `resource '${resourceType}' composite view '${view.ref}'`,\n        references,\n      }];\n    }),\n    ...(frontendConfiguration?.chartViews ?? []).flatMap((view) => {\n      const references = extractFeatureReferencesFromRequiredFeatures(\n        view.chartDefinition.requiredFeatures,\n      );\n      if (references.length === 0) {\n        return [];\n      }\n\n      return [{\n        surface: `resource '${resourceType}' chart '${view.ref}'`,\n        references,\n      }];\n    }),\n    ...(frontendConfiguration?.executionViews ?? []).flatMap((view) => {\n      const references = extractFeatureReferencesFromRequiredFeatures(view.requiredFeatures);\n      if (references.length === 0) {\n        return [];\n      }\n\n      return [{\n        surface: `resource '${resourceType}' execution view '${view.ref}'`,\n        references,\n      }];\n    }),\n    ...(frontendConfiguration?.guidance ?? []).flatMap((flow) => {\n      const references = extractFeatureReferencesFromRequiredFeatures(\n        flow.audience?.requiredFeatures,\n      );\n      if (references.length === 0) {\n        return [];\n      }\n\n      return [{\n        surface: `resource '${resourceType}' guidance flow '${flow.ref}' audience`,\n        references,\n      }];\n    }),\n  ];\n}\n\nfunction formatFeatureReferences(references: FeatureReferenceEntry[]): string {\n  return references\n    .map((reference) => `'${reference.featureId}' via ${reference.slotLabel}`)\n    .join(', ');\n}\n"]}

package/dist/esm/core/config/verify-launcher-content.d.ts

@@ -12,8 +12,8 @@
  * @see launcher-operation-binding-analysis.md §3.11
  * @see app-shell-implementation-plan.md Step 5
  */
-import type { AppConfiguration_Frontend } from './app-configuration-frontend.schemas.js';
-import type { FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas.js';
+import type { AppConfiguration_Frontend } from './app-configuration-frontend.schemas';
+import type { FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas';
 export declare enum LauncherVerificationSeverity {
     ERROR = "error",
     WARNING = "warning"
@@ -31,10 +31,18 @@ export declare enum LauncherVerificationErrorCode {
     ACTIVITY_BAR_ENABLED_BUT_NO_APP_MODES = "ACTIVITY_BAR_ENABLED_BUT_NO_APP_MODES",
     HOSTED_COMPONENT_NOT_CONFIGURED = "HOSTED_COMPONENT_NOT_CONFIGURED",
     VISIBLE_IN_MODES_ORPHAN = "VISIBLE_IN_MODES_ORPHAN",
-    BADGE_REFERENCE_DUPLICATE = "BADGE_REFERENCE_DUPLICATE",
+    NOTIFICATION_BADGE_REF_NOT_FOUND = "NOTIFICATION_BADGE_REF_NOT_FOUND",
     APP_SCOPE_DUPLICATE_RESOURCE_TYPE = "APP_SCOPE_DUPLICATE_RESOURCE_TYPE",
     VIEW_NOT_LAUNCHABLE = "VIEW_NOT_LAUNCHABLE",
-    UNKNOWN_TARGET_KIND = "UNKNOWN_TARGET_KIND"
+    UNKNOWN_TARGET_KIND = "UNKNOWN_TARGET_KIND",
+    /**
+     * A launcher opens a Settings Hub section the application did not PLACE.
+     *
+     * ERROR, because the failure is silent and lands the user somewhere plausible:
+     * `resolveItemRef` falls back to the hub's DEFAULT section for an unknown
+     * `sectionRef`, so a command labelled "Billing" opens Profile.
+     */
+    SETTINGS_SECTION_NOT_PLACED = "SETTINGS_SECTION_NOT_PLACED"
 }
 export interface LauncherVerificationError {
     severity: LauncherVerificationSeverity;

package/dist/esm/core/config/verify-launcher-content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify-launcher-content.d.ts","sourceRoot":"","sources":["../../../../src/core/config/verify-launcher-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACtF,OAAO,KAAK,EAAE,yBAAyB,EAAoC,MAAM,+DAA+D,CAAC;AAgCjJ,oBAAY,4BAA4B;IACtC,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED,oBAAY,6BAA6B;IACvC,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;IAC3C,cAAc,mBAAmB;IACjC,kBAAkB,uBAAuB;IACzC,qBAAqB,0BAA0B;IAC/C,mCAAmC,wCAAwC;IAC3E,0CAA0C,+CAA+C;IACzF,+CAA+C,oDAAoD;IACnG,qCAAqC,0CAA0C;IAC/E,qCAAqC,0CAA0C;IAC/E,+BAA+B,oCAAoC;IACnE,uBAAuB,4BAA4B;IACnD,yBAAyB,8BAA8B;IACvD,iCAAiC,sCAAsC;IACvE,mBAAmB,wBAAwB;IAC3C,mBAAmB,wBAAwB;CAC5C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,4BAA4B,CAAC;IACvC,IAAI,EAAE,6BAA6B,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,yBAAyB,EAAE,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;CAClB;AAmcD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,yBAAyB,EACnC,SAAS,EAAE,yBAAyB,EACpC,qBAAqB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,GACxD,0BAA0B,CA8N5B;AAMD;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,0BAA0B,GAAG,IAAI,CAqB1F"}
+{"version":3,"file":"verify-launcher-content.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/verify-launcher-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACtF,OAAO,KAAK,EAAE,yBAAyB,EAAoC,MAAM,+DAA+D,CAAC;AAoCjJ,oBAAY,4BAA4B;IACtC,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAID,oBAAY,6BAA6B;IACvC,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;IAC3C,cAAc,mBAAmB;IACjC,kBAAkB,uBAAuB;IACzC,qBAAqB,0BAA0B;IAC/C,mCAAmC,wCAAwC;IAC3E,0CAA0C,+CAA+C;IACzF,+CAA+C,oDAAoD;IACnG,qCAAqC,0CAA0C;IAC/E,qCAAqC,0CAA0C;IAC/E,+BAA+B,oCAAoC;IACnE,uBAAuB,4BAA4B;IACnD,gCAAgC,qCAAqC;IACrE,iCAAiC,sCAAsC;IACvE,mBAAmB,wBAAwB;IAC3C,mBAAmB,wBAAwB;IAC3C;;;;;;OAMG;IACH,2BAA2B,gCAAgC;CAC5D;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,4BAA4B,CAAC;IACvC,IAAI,EAAE,6BAA6B,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,yBAAyB,EAAE,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;CAClB;AAkeD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,yBAAyB,EACnC,SAAS,EAAE,yBAAyB,EACpC,qBAAqB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,GACxD,0BAA0B,CAkK5B;AAMD;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,0BAA0B,GAAG,IAAI,CAqB1F"}

package/dist/esm/core/config/verify-launcher-content.js

@@ -13,9 +13,10 @@
  * @see app-shell-implementation-plan.md Step 5
  */
 import { FrontendView_ScopeMode } from './views-frontend.schemas.js';
+import { findResourceOwnedViewReferenceMatches, resolveResourceOwnedViewReference, } from './resource-owned-view-resolution.frontend.utils.js';
 import { findDuplicateAppScopeResourceTypes, } from './app-configuration-frontend.schemas.js';
 import { ApplicationLevelComponentType, } from './app-level-components.frontend.schemas.js';
-import { LauncherItemTargetKind, SidebarSectionContentKind, ENGINE_PAGE_ROUTES, } from './launcher-items.frontend.schemas.js';
+import { LauncherItemTargetKind, SidebarSectionContentKind, ENGINE_PAGE_METADATA, } from './launcher-items.frontend.schemas.js';
 // ════════════════════════════════════════════════════════════════
 // Verification Result Types
 // ════════════════════════════════════════════════════════════════
@@ -24,6 +25,7 @@ export var LauncherVerificationSeverity;
     LauncherVerificationSeverity["ERROR"] = "error";
     LauncherVerificationSeverity["WARNING"] = "warning";
 })(LauncherVerificationSeverity || (LauncherVerificationSeverity = {}));
+import { resolveSettingsHubConfig } from './useSettingsHubConfig.js';
 export var LauncherVerificationErrorCode;
 (function (LauncherVerificationErrorCode) {
     LauncherVerificationErrorCode["RESOURCE_NOT_FOUND"] = "RESOURCE_NOT_FOUND";
@@ -38,10 +40,18 @@ export var LauncherVerificationErrorCode;
     LauncherVerificationErrorCode["ACTIVITY_BAR_ENABLED_BUT_NO_APP_MODES"] = "ACTIVITY_BAR_ENABLED_BUT_NO_APP_MODES";
     LauncherVerificationErrorCode["HOSTED_COMPONENT_NOT_CONFIGURED"] = "HOSTED_COMPONENT_NOT_CONFIGURED";
     LauncherVerificationErrorCode["VISIBLE_IN_MODES_ORPHAN"] = "VISIBLE_IN_MODES_ORPHAN";
-    LauncherVerificationErrorCode["BADGE_REFERENCE_DUPLICATE"] = "BADGE_REFERENCE_DUPLICATE";
+    LauncherVerificationErrorCode["NOTIFICATION_BADGE_REF_NOT_FOUND"] = "NOTIFICATION_BADGE_REF_NOT_FOUND";
     LauncherVerificationErrorCode["APP_SCOPE_DUPLICATE_RESOURCE_TYPE"] = "APP_SCOPE_DUPLICATE_RESOURCE_TYPE";
     LauncherVerificationErrorCode["VIEW_NOT_LAUNCHABLE"] = "VIEW_NOT_LAUNCHABLE";
     LauncherVerificationErrorCode["UNKNOWN_TARGET_KIND"] = "UNKNOWN_TARGET_KIND";
+    /**
+     * A launcher opens a Settings Hub section the application did not PLACE.
+     *
+     * ERROR, because the failure is silent and lands the user somewhere plausible:
+     * `resolveItemRef` falls back to the hub's DEFAULT section for an unknown
+     * `sectionRef`, so a command labelled "Billing" opens Profile.
+     */
+    LauncherVerificationErrorCode["SETTINGS_SECTION_NOT_PLACED"] = "SETTINGS_SECTION_NOT_PLACED";
 })(LauncherVerificationErrorCode || (LauncherVerificationErrorCode = {}));
 function buildViewRegistry(appConfig) {
     const applicationViewsByRef = new Map();
@@ -141,38 +151,28 @@ function resolveResourceScopedViewEntry(item, registry, context, errors) {
         });
         return null;
     }
-    const frontendConfiguration = resourceConfig.frontendConfiguration;
-    const compositeView = frontendConfiguration?.compositeViews?.find((view) => view.ref === item.viewRef);
-    if (compositeView) {
-        if (compositeView.scope !== FrontendView_ScopeMode.RESOURCE) {
-            errors.push({
-                severity: LauncherVerificationSeverity.ERROR,
-                code: LauncherVerificationErrorCode.VIEW_NOT_LAUNCHABLE,
-                context,
-                message: `Resource view "${item.viewRef}" on resource "${item.resourceType}" must be declared with RESOURCE scope to be targeted by RESOURCE_VIEW launchers`,
-                item,
-            });
-            return null;
-        }
-        return { family: 'composite' };
-    }
-    const chartView = frontendConfiguration?.chartViews?.find((view) => view.ref === item.viewRef);
-    if (chartView) {
-        if (chartView.scope !== FrontendView_ScopeMode.RESOURCE) {
-            errors.push({
-                severity: LauncherVerificationSeverity.ERROR,
-                code: LauncherVerificationErrorCode.VIEW_NOT_LAUNCHABLE,
-                context,
-                message: `Resource view "${item.viewRef}" on resource "${item.resourceType}" must be declared with RESOURCE scope to be targeted by RESOURCE_VIEW launchers`,
-                item,
-            });
-            return null;
-        }
-        return { family: 'chart' };
+    const viewMatches = findResourceOwnedViewReferenceMatches({
+        resourceType: item.resourceType,
+        viewRef: item.viewRef,
+        registry,
+    });
+    if (viewMatches.length > 1) {
+        errors.push({
+            severity: LauncherVerificationSeverity.ERROR,
+            code: LauncherVerificationErrorCode.VIEW_REF_COLLISION,
+            context,
+            message: `Resource view ref "${item.viewRef}" is declared multiple times on resource "${item.resourceType}". RESOURCE_VIEW refs must be unique per resource-owned view namespace.`,
+            item,
+        });
+        return null;
     }
-    const executionView = frontendConfiguration?.executionViews?.find((view) => view.ref === item.viewRef);
-    if (executionView) {
-        if (executionView.scope !== FrontendView_ScopeMode.RESOURCE) {
+    const resolvedView = resolveResourceOwnedViewReference({
+        resourceType: item.resourceType,
+        viewRef: item.viewRef,
+        registry,
+    });
+    if (resolvedView) {
+        if (resolvedView.scope !== FrontendView_ScopeMode.RESOURCE) {
             errors.push({
                 severity: LauncherVerificationSeverity.ERROR,
                 code: LauncherVerificationErrorCode.VIEW_NOT_LAUNCHABLE,
@@ -182,7 +182,7 @@ function resolveResourceScopedViewEntry(item, registry, context, errors) {
             });
             return null;
         }
-        return { family: 'execution' };
+        return { family: resolvedView.family };
     }
     errors.push({
         severity: LauncherVerificationSeverity.ERROR,
@@ -196,7 +196,16 @@ function resolveResourceScopedViewEntry(item, registry, context, errors) {
 // ════════════════════════════════════════════════════════════════
 // Item Reference Verification
 // ════════════════════════════════════════════════════════════════
-function verifyItemRef(item, context, registry, viewRegistry, errors, isComponentRegistered) {
+function verifyItemRef(item, context, registry, viewRegistry, errors, 
+/**
+ * Section refs the application actually placed in its settings rail.
+ *
+ * REQUIRED rather than optional on purpose: an optional parameter lets a call
+ * site silently skip the check, which is precisely the "invariant applied at
+ * one of N call sites" shape (`invariant-call-site-enumeration.md`). Required,
+ * the compiler enumerates the sites for you.
+ */
+placedSettingsSectionRefs, isComponentRegistered) {
     switch (item.kind) {
         case LauncherItemTargetKind.RESOURCE_OPERATION: {
             const resourceConfig = registry.resourceConfigurations[item.resourceType];
@@ -224,7 +233,7 @@ function verifyItemRef(item, context, registry, viewRegistry, errors, isComponen
                 });
             }
             else if (!item.operationVariant) {
-                const defaultOperations = matchingOperations.filter((op) => op.isOperationDefault);
+                const defaultOperations = matchingOperations.filter((op) => op.isOperationDefault === true);
                 if (matchingOperations.length > 1 && defaultOperations.length !== 1) {
                     errors.push({
                         severity: LauncherVerificationSeverity.ERROR,
@@ -246,12 +255,12 @@ function verifyItemRef(item, context, registry, viewRegistry, errors, isComponen
             break;
         }
         case LauncherItemTargetKind.ENGINE_PAGE: {
-            if (!(item.pageRef in ENGINE_PAGE_ROUTES)) {
+            if (!(item.pageRef in ENGINE_PAGE_METADATA)) {
                 errors.push({
                     severity: LauncherVerificationSeverity.ERROR,
                     code: LauncherVerificationErrorCode.ENGINE_PAGE_NOT_FOUND,
                     context,
-                    message: `Engine page ref "${item.pageRef}" has no route mapping in ENGINE_PAGE_ROUTES`,
+                    message: `Engine page ref "${item.pageRef}" has no entry in ENGINE_PAGE_METADATA`,
                     item,
                 });
             }
@@ -269,6 +278,26 @@ function verifyItemRef(item, context, registry, viewRegistry, errors, isComponen
             }
             break;
         }
+        case LauncherItemTargetKind.SETTINGS_SECTION: {
+            // This case used to `break` with a comment saying a settings launcher ref
+            // is "always structurally valid" because the hub falls back to its default
+            // section. That fallback is exactly why the ref MUST be checked: it turns a
+            // dangling reference into a silently wrong destination rather than an
+            // error, so nothing downstream can ever report it.
+            //
+            // An omitted `sectionRef` is legitimate — it means "open the hub at its
+            // default section" — so only a NAMED ref is checked.
+            if (item.sectionRef !== undefined && !placedSettingsSectionRefs.has(item.sectionRef)) {
+                errors.push({
+                    severity: LauncherVerificationSeverity.ERROR,
+                    code: LauncherVerificationErrorCode.SETTINGS_SECTION_NOT_PLACED,
+                    context,
+                    message: `Launcher opens Settings Hub section "${item.sectionRef}", which this application does not place in its settings rail (\`settingsHub.placements\`); the hub would silently open its default section instead.`,
+                    item,
+                });
+            }
+            break;
+        }
         default: {
             errors.push({
                 severity: LauncherVerificationSeverity.ERROR,
@@ -283,18 +312,28 @@ function verifyItemRef(item, context, registry, viewRegistry, errors, isComponen
 /**
  * Recursively verify sidebar items (navigation list children can nest).
  */
-function verifySidebarItems(items, context, registry, viewRegistry, errors, isComponentRegistered) {
+function verifySidebarItems(items, context, registry, viewRegistry, errors, placedSettingsSectionRefs, isComponentRegistered) {
     for (const item of items) {
-        verifyItemRef(item, context, registry, viewRegistry, errors, isComponentRegistered);
+        verifyItemRef(item, context, registry, viewRegistry, errors, placedSettingsSectionRefs, isComponentRegistered);
+        if (item.notificationBadgeRef
+            && !registry.notificationBadgeDefinitions.some((definition) => definition.identifier === item.notificationBadgeRef)) {
+            errors.push({
+                severity: LauncherVerificationSeverity.ERROR,
+                code: LauncherVerificationErrorCode.NOTIFICATION_BADGE_REF_NOT_FOUND,
+                context,
+                message: `notificationBadgeRef "${item.notificationBadgeRef}" does not resolve to a registered notification badge definition`,
+                item,
+            });
+        }
         if (item.children) {
-            verifySidebarItems(item.children, `${context}.children`, registry, viewRegistry, errors, isComponentRegistered);
+            verifySidebarItems(item.children, `${context}.children`, registry, viewRegistry, errors, placedSettingsSectionRefs, isComponentRegistered);
         }
     }
 }
 // ════════════════════════════════════════════════════════════════
 // Sidebar Section Verification
 // ════════════════════════════════════════════════════════════════
-function verifySidebarSection(section, registry, viewRegistry, appModeRefs, errors, isComponentRegistered) {
+function verifySidebarSection(section, registry, viewRegistry, appModeRefs, errors, placedSettingsSectionRefs, isComponentRegistered) {
     const ctx = `sidebar.contentSections[${section.ref}]`;
     // Verify visibleInModes refs match declared appModes
     if (section.visibleInModes && section.visibleInModes.length > 0) {
@@ -324,7 +363,7 @@ function verifySidebarSection(section, registry, viewRegistry, appModeRefs, erro
     switch (section.contentKind) {
         case SidebarSectionContentKind.NAVIGATION_LIST: {
             const navSection = section;
-            verifySidebarItems(navSection.children, ctx, registry, viewRegistry, errors, isComponentRegistered);
+            verifySidebarItems(navSection.children, ctx, registry, viewRegistry, errors, placedSettingsSectionRefs, isComponentRegistered);
             break;
         }
         case SidebarSectionContentKind.RESOURCE_BROWSER: {
@@ -399,6 +438,10 @@ export function verifyLauncherContent(registry, appConfig, isComponentRegistered
     const errors = [];
     const config = appConfig.appComponentsConfiguration;
     const viewRegistry = buildViewRegistry(appConfig);
+    // The section refs this application actually places. Derived through the same
+    // resolver the hub renders with, so the verifier cannot disagree with what a
+    // user will see — an unplaced destination is absent from both.
+    const placedSettingsSectionRefs = new Set(resolveSettingsHubConfig(appConfig.settingsHub).sections.map(section => section.ref));
     // Collect appMode refs for cross-validation
     const appModeRefs = new Set();
     const appModes = appConfig.appModes ?? [];
@@ -431,7 +474,7 @@ export function verifyLauncherContent(registry, appConfig, isComponentRegistered
         const contentSections = sidebarConfig.contentSections;
         if (contentSections) {
             for (const section of contentSections) {
-                verifySidebarSection(section, registry, viewRegistry, appModeRefs, errors, isComponentRegistered);
+                verifySidebarSection(section, registry, viewRegistry, appModeRefs, errors, placedSettingsSectionRefs, isComponentRegistered);
             }
         }
     }
@@ -441,7 +484,7 @@ export function verifyLauncherContent(registry, appConfig, isComponentRegistered
         const commands = cmdConfig.commands;
         if (commands) {
             for (const cmd of commands) {
-                verifyItemRef(cmd, 'command_menu.commands', registry, viewRegistry, errors, isComponentRegistered);
+                verifyItemRef(cmd, 'command_menu.commands', registry, viewRegistry, errors, placedSettingsSectionRefs, isComponentRegistered);
             }
         }
     }
@@ -451,7 +494,7 @@ export function verifyLauncherContent(registry, appConfig, isComponentRegistered
         const bindings = hotkeyConfig.bindings;
         if (bindings) {
             for (const binding of bindings) {
-                verifyItemRef(binding, 'hotkey.bindings', registry, viewRegistry, errors, isComponentRegistered);
+                verifyItemRef(binding, 'hotkey.bindings', registry, viewRegistry, errors, placedSettingsSectionRefs, isComponentRegistered);
             }
         }
     }
@@ -461,7 +504,7 @@ export function verifyLauncherContent(registry, appConfig, isComponentRegistered
         const actions = qabConfig.actions;
         if (actions) {
             for (const action of actions) {
-                verifyItemRef(action, 'quick_action_button.actions', registry, viewRegistry, errors, isComponentRegistered);
+                verifyItemRef(action, 'quick_action_button.actions', registry, viewRegistry, errors, placedSettingsSectionRefs, isComponentRegistered);
             }
         }
     }
@@ -471,7 +514,7 @@ export function verifyLauncherContent(registry, appConfig, isComponentRegistered
         const items = cpConfig.items;
         if (items) {
             for (const item of items) {
-                verifyItemRef(item, 'control_panel.items', registry, viewRegistry, errors, isComponentRegistered);
+                verifyItemRef(item, 'control_panel.items', registry, viewRegistry, errors, placedSettingsSectionRefs, isComponentRegistered);
             }
         }
     }
@@ -481,7 +524,7 @@ export function verifyLauncherContent(registry, appConfig, isComponentRegistered
         const tools = toolbarConfig.tools;
         if (tools) {
             for (const tool of tools) {
-                verifyItemRef(tool, 'toolbar.tools', registry, viewRegistry, errors, isComponentRegistered);
+                verifyItemRef(tool, 'toolbar.tools', registry, viewRegistry, errors, placedSettingsSectionRefs, isComponentRegistered);
             }
         }
     }
@@ -509,7 +552,7 @@ export function verifyLauncherContent(registry, appConfig, isComponentRegistered
             const items = menubarConfig.items;
             if (items) {
                 for (const item of items) {
-                    verifyItemRef(item, 'menubar.items', registry, viewRegistry, errors, isComponentRegistered);
+                    verifyItemRef(item, 'menubar.items', registry, viewRegistry, errors, placedSettingsSectionRefs, isComponentRegistered);
                 }
             }
         }
@@ -538,66 +581,6 @@ export function verifyLauncherContent(registry, appConfig, isComponentRegistered
             });
         }
     }
-    // ── BADGE REFERENCES: collect and check for duplicates ──
-    // Badge sources are registered at runtime via WebSocket, so we cannot
-    // statically validate that a `badgeReference` maps to a registered source.
-    // What we *can* detect: duplicate badgeReference values across launchers,
-    // which would cause badge counts to be shared unintentionally.
-    const badgeRefLocations = new Map();
-    function collectBadgeRef(ref, location) {
-        if (!ref)
-            return;
-        const existing = badgeRefLocations.get(ref);
-        if (existing) {
-            existing.push(location);
-        }
-        else {
-            badgeRefLocations.set(ref, [location]);
-        }
-    }
-    function collectBadgeRefsFromItems(items, location) {
-        for (const item of items) {
-            collectBadgeRef(item.badgeReference, location);
-            if (item.children) {
-                collectBadgeRefsFromItems(item.children, `${location}.children`);
-            }
-        }
-    }
-    // Collect from sidebar navigation list children
-    if (typeof sidebarConfig === 'object' && sidebarConfig !== null && 'contentSections' in sidebarConfig) {
-        const sections = sidebarConfig.contentSections;
-        if (sections) {
-            for (const section of sections) {
-                if (section.contentKind === SidebarSectionContentKind.NAVIGATION_LIST) {
-                    const navSection = section;
-                    collectBadgeRefsFromItems(navSection.children, `sidebar.section[${section.ref}]`);
-                }
-            }
-        }
-    }
-    // Collect from other launcher item arrays
-    const launcherItemArrays = [
-        { items: (typeof toolbarConfig === 'object' && toolbarConfig !== null && 'tools' in toolbarConfig) ? toolbarConfig.tools : undefined, location: 'toolbar' },
-        { items: (typeof cpConfig === 'object' && cpConfig !== null && 'items' in cpConfig) ? cpConfig.items : undefined, location: 'control_panel' },
-    ];
-    for (const { items: launcherItems, location } of launcherItemArrays) {
-        if (launcherItems) {
-            for (const item of launcherItems) {
-                collectBadgeRef(item.badgeReference, location);
-            }
-        }
-    }
-    // Warn on duplicate badgeReference values
-    for (const [ref, locations] of badgeRefLocations) {
-        if (locations.length > 1) {
-            errors.push({
-                severity: LauncherVerificationSeverity.WARNING,
-                code: LauncherVerificationErrorCode.BADGE_REFERENCE_DUPLICATE,
-                context: 'badgeReferences',
-                message: `badgeReference "${ref}" is used in ${locations.length} locations (${locations.join(', ')}) — badge counts will be shared`,
-            });
-        }
-    }
     return { errors, isValid: errors.length === 0 };
 }
 // ════════════════════════════════════════════════════════════════
@@ -621,4 +604,4 @@ export function reportLauncherVerificationResults(result) {
     }
     console.groupEnd();
 }
-//# sourceMappingURL=verify-launcher-content.js.map
+//# sourceMappingURL=verify-launcher-content.js.map