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

package/dist/esm/core/config/onboarding-view.frontend.schemas.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import type { OnboardingTrigger, OnboardingViewOptions, OnboardingElement, RequiredFeaturesConfig } from '@wildo-ai/saas-models';
-import { FrontendView_ScopeMode } from './views-frontend.schemas.js';
-import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas.js';
+import { FrontendView_ScopeMode } from './views-frontend.schemas';
+import type { FrontendResource_ParentResourceRequirement } from '../../core/resources/resource-path.frontend.schemas';
 /**
  * OnboardingViewDefinition — intersects onboarding primitives (saas-models)
  * with view wiring (FrontendView_DefinitionSchema) for frontend rendering.
@@ -12,7 +12,7 @@ import type { FrontendResource_ParentResourceRequirement } from '../../core/reso
  */
 export declare const OnboardingViewDefinitionSchema: z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
     scope: z.ZodLiteral<FrontendView_ScopeMode.APPLICATION>;
-}, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     scope: z.ZodLiteral<FrontendView_ScopeMode.RESOURCE>;
     parentResourcesRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
         resourceType: z.ZodUnion<readonly [z.ZodEnum<typeof import("@wildo-ai/saas-models").CoreResourceType>, z.ZodString]>;
@@ -22,7 +22,7 @@ export declare const OnboardingViewDefinitionSchema: z.ZodIntersection<z.ZodDisc
         requirement: z.ZodEnum<typeof import("@wildo-ai/saas-models").ResourceParentResourceRequirement>;
         isPrimaryScope: z.ZodBoolean;
         primaryScope: z.ZodOptional<z.ZodEnum<typeof import("@wildo-ai/saas-models").ResourcePrimaryScope>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>>;
+    }, z.core.$strip>>>;
     additionalResourceRequirements: z.ZodOptional<z.ZodArray<z.ZodObject<{
         resourceType: z.ZodUnion<readonly [z.ZodEnum<typeof import("@wildo-ai/saas-models").CoreResourceType>, z.ZodString]>;
         foreignKeyField: z.ZodOptional<z.ZodString>;
@@ -31,8 +31,9 @@ export declare const OnboardingViewDefinitionSchema: z.ZodIntersection<z.ZodDisc
         requirement: z.ZodEnum<typeof import("@wildo-ai/saas-models").ResourceParentResourceRequirement>;
         isPrimaryScope: z.ZodBoolean;
         primaryScope: z.ZodOptional<z.ZodEnum<typeof import("@wildo-ai/saas-models").ResourcePrimaryScope>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>>;
-}, z.core.$strip, core.$ZodObjectExtra>], "scope">, z.ZodObject<{
+    }, z.core.$strip>>>;
+}, z.core.$strip>], "scope">, z.ZodObject<{
+    ref: z.ZodString;
     trigger: z.ZodOptional<z.ZodObject<{
         type: z.ZodDefault<z.ZodEnum<{
             readonly FIRST_VISIT: "first-visit";
@@ -48,8 +49,8 @@ export declare const OnboardingViewDefinitionSchema: z.ZodIntersection<z.ZodDisc
             newUsersOnly: z.ZodDefault<z.ZodBoolean>;
             triggerOnce: z.ZodDefault<z.ZodBoolean>;
             requiredRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip, core.$ZodObjectExtra>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     options: z.ZodObject<{
         showProgress: z.ZodDefault<z.ZodBoolean>;
         allowDismiss: z.ZodDefault<z.ZodBoolean>;
@@ -57,156 +58,118 @@ export declare const OnboardingViewDefinitionSchema: z.ZodIntersection<z.ZodDisc
         autoStart: z.ZodDefault<z.ZodBoolean>;
         allowSkip: z.ZodDefault<z.ZodBoolean>;
         className: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip, core.$ZodObjectExtra>;
+    }, z.core.$strip>;
     elements: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         ref: z.ZodString;
-        title: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
         status: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingStatus>>;
         order: z.ZodNumber;
         targetField: z.ZodOptional<z.ZodString>;
         showProgress: z.ZodDefault<z.ZodBoolean>;
         type: z.ZodLiteral<import("@wildo-ai/saas-models").OnboardingElementType.CHECKLIST>;
         items: z.ZodArray<z.ZodString>;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         ref: z.ZodString;
-        title: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
         status: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingStatus>>;
         order: z.ZodNumber;
         targetField: z.ZodOptional<z.ZodString>;
-        actionLabel: z.ZodOptional<z.ZodString>;
         actionRef: z.ZodOptional<z.ZodString>;
         type: z.ZodLiteral<import("@wildo-ai/saas-models").OnboardingElementType.CHECKLIST_ITEM>;
         completed: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         ref: z.ZodString;
-        title: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
         status: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingStatus>>;
         order: z.ZodNumber;
         targetField: z.ZodOptional<z.ZodString>;
         steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
             ref: z.ZodString;
-            title: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
             order: z.ZodNumber;
             placement: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").TourStepPlacement>>;
             targetSelector: z.ZodOptional<z.ZodString>;
             targetField: z.ZodOptional<z.ZodString>;
-            content: z.ZodOptional<z.ZodString>;
             imageUrl: z.ZodOptional<z.ZodURL>;
             videoUrl: z.ZodOptional<z.ZodURL>;
-        }, z.core.$strip, core.$ZodObjectExtra>>>;
+        }, z.core.$strip>>>;
         autoStart: z.ZodDefault<z.ZodBoolean>;
         allowSkip: z.ZodDefault<z.ZodBoolean>;
         type: z.ZodLiteral<import("@wildo-ai/saas-models").OnboardingElementType.TOUR>;
         currentStepIndex: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         ref: z.ZodString;
-        title: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
         status: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingStatus>>;
         order: z.ZodNumber;
         targetField: z.ZodOptional<z.ZodString>;
         targetSelector: z.ZodString;
         placement: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").TourStepPlacement>>;
-        content: z.ZodString;
         showOnce: z.ZodDefault<z.ZodBoolean>;
         type: z.ZodLiteral<import("@wildo-ai/saas-models").OnboardingElementType.TOOLTIP>;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         ref: z.ZodString;
-        title: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
         status: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingStatus>>;
         order: z.ZodNumber;
         targetField: z.ZodOptional<z.ZodString>;
-        content: z.ZodString;
         imageUrl: z.ZodOptional<z.ZodURL>;
         videoUrl: z.ZodOptional<z.ZodURL>;
-        ctaText: z.ZodOptional<z.ZodString>;
         ctaAction: z.ZodOptional<z.ZodString>;
         dismissible: z.ZodDefault<z.ZodBoolean>;
         type: z.ZodLiteral<import("@wildo-ai/saas-models").OnboardingElementType.MODAL>;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         ref: z.ZodString;
-        title: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
         status: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingStatus>>;
         order: z.ZodNumber;
         targetField: z.ZodOptional<z.ZodString>;
-        content: z.ZodString;
         variant: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingVariant>>;
         dismissible: z.ZodDefault<z.ZodBoolean>;
         position: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingBannerPosition>>;
-        actionLabel: z.ZodOptional<z.ZodString>;
         actionRef: z.ZodOptional<z.ZodString>;
         type: z.ZodLiteral<import("@wildo-ai/saas-models").OnboardingElementType.BANNER>;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         ref: z.ZodString;
-        title: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
         status: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingStatus>>;
         order: z.ZodNumber;
         targetField: z.ZodOptional<z.ZodString>;
-        content: z.ZodString;
         variant: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingVariant>>;
         dismissible: z.ZodDefault<z.ZodBoolean>;
         icon: z.ZodOptional<z.ZodString>;
-        actionLabel: z.ZodOptional<z.ZodString>;
         actionRef: z.ZodOptional<z.ZodString>;
         type: z.ZodLiteral<import("@wildo-ai/saas-models").OnboardingElementType.ANNOUNCEMENT>;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         ref: z.ZodString;
-        title: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
         status: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingStatus>>;
         order: z.ZodNumber;
         targetField: z.ZodOptional<z.ZodString>;
-        content: z.ZodOptional<z.ZodString>;
         icon: z.ZodOptional<z.ZodString>;
         variant: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingBadgeVariant>>;
         color: z.ZodOptional<z.ZodString>;
         unlocked: z.ZodDefault<z.ZodBoolean>;
-        actionLabel: z.ZodOptional<z.ZodString>;
         actionRef: z.ZodOptional<z.ZodString>;
         type: z.ZodLiteral<import("@wildo-ai/saas-models").OnboardingElementType.BADGE>;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         ref: z.ZodString;
-        title: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
         status: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingStatus>>;
         order: z.ZodNumber;
         targetField: z.ZodOptional<z.ZodString>;
-        content: z.ZodString;
         icon: z.ZodOptional<z.ZodString>;
         imageUrl: z.ZodOptional<z.ZodURL>;
         variant: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingCardVariant>>;
-        actionLabel: z.ZodOptional<z.ZodString>;
         actionRef: z.ZodOptional<z.ZodString>;
         type: z.ZodLiteral<import("@wildo-ai/saas-models").OnboardingElementType.CARD>;
-    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         ref: z.ZodString;
-        title: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
         status: z.ZodDefault<z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingStatus>>;
         order: z.ZodNumber;
         targetField: z.ZodOptional<z.ZodString>;
         questions: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             ref: z.ZodOptional<z.ZodString>;
-            question: z.ZodString;
             type: z.ZodEnum<typeof import("@wildo-ai/saas-models").OnboardingSurveyQuestionType>;
             options: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 ref: z.ZodString;
-                value: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip, core.$ZodObjectExtra>>>;
+            }, z.core.$strip>>>;
             required: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip, core.$ZodObjectExtra>>>;
-        submitLabel: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
         allowSkip: z.ZodDefault<z.ZodBoolean>;
         type: z.ZodLiteral<import("@wildo-ai/saas-models").OnboardingElementType.SURVEY>;
-    }, z.core.$strip, core.$ZodObjectExtra>], "type">>;
+    }, z.core.$strip>], "type">>;
     requiredFeatures: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
         features: z.ZodOptional<z.ZodArray<z.ZodString>>;
         mode: z.ZodOptional<z.ZodEnum<{
@@ -222,12 +185,13 @@ export declare const OnboardingViewDefinitionSchema: z.ZodIntersection<z.ZodDisc
                 aggregate: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     operation: z.ZodEnum<typeof import("@wildo-ai/saas-models").AggregationOperation>;
-                }, z.core.$strip, core.$ZodObjectExtra>>;
-            }, z.core.$strip, core.$ZodObjectExtra>>;
-        }, z.core.$strip, core.$ZodObjectExtra>>>;
-    }, z.core.$strip, core.$ZodObjectExtra>]>>;
-}, z.core.$strip, core.$ZodObjectExtra>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>>;
 export interface OnboardingViewDefinition {
+    ref: string;
     scope: FrontendView_ScopeMode;
     parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];
     additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];

package/dist/esm/core/config/onboarding-view.frontend.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding-view.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/config/onboarding-view.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAiC,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AAEpI;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAmB8kF,IAAK,CAAC,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAAowc,IAAK,CAAC,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAAwwI,IAAK,CAAC,eAAe;;0BAAwE,IAAK,CAAC,eAAe;;;;;;;;;;;;;;;;;;;;kCAAxyd,IAAK,CAAC,eAAe;8BAA6B,IAAK,CAAC,eAAe;0BAAyB,IAAK,CAAC,eAAe;;wCAX7mN,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC3E,8BAA8B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC9E,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C"}
+{"version":3,"file":"onboarding-view.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/onboarding-view.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAiC,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AAEpI;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA2B1C,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,sBAAsB,CAAC;IAC9B,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC3E,8BAA8B,CAAC,EAAE,0CAA0C,EAAE,CAAC;IAC9E,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C"}

package/dist/esm/core/config/onboarding-view.frontend.schemas.js

@@ -10,9 +10,28 @@ import { FrontendView_DefinitionSchema } from './views-frontend.schemas.js';
  * (scope, parent requirements) is frontend-only.
  */
 export const OnboardingViewDefinitionSchema = z.intersection(FrontendView_DefinitionSchema, z.object({
+    /**
+     * Stable string identity for this onboarding view. Used by:
+     * - The companion spec layer (`OnboardingViewSpecification` keys
+     *   this ref against `app.<ref>` for application-scope views and
+     *   `resources.<resourceType>.<ref>` for resource-scope views).
+     * - Future ref-based registry lookups (today the runtime accesses
+     *   onboarding documents by direct array reference via
+     *   `<EmbedOnboarding document={…} />`, but per-ref lookup is the
+     *   coming convention — guidance flows already work this way).
+     *
+     * NOTE on uniqueness: `buildFrontendModuleRegistry` collapses
+     * onboarding views to ref-keyed dedup (mirrors guidance-flow
+     * merge). Two modules contributing the same ref therefore overwrite,
+     * with the last-merged module winning — same semantics as
+     * guidance flows. Spec-layer
+     * `buildOnboardingViewSpecificationMap` ALSO fails closed on
+     * duplicate keys for any app that authors the spec.
+     */
+    ref: z.string().min(1),
     trigger: OnboardingTriggerSchema.optional(),
     options: OnboardingViewOptionsSchema,
     elements: z.array(OnboardingElementSchema),
     requiredFeatures: RequiredFeaturesConfigSchema.optional(),
 }));
-//# sourceMappingURL=onboarding-view.frontend.schemas.js.map
+//# sourceMappingURL=onboarding-view.frontend.schemas.js.map

package/dist/esm/core/config/onboarding-view.frontend.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding-view.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/config/onboarding-view.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAAE,6BAA6B,EAA0B,MAAM,0BAA0B,CAAC;AAGjG;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,YAAY,CAC1D,6BAA6B,EAC7B,CAAC,CAAC,MAAM,CAAC;IACP,OAAO,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IAC3C,OAAO,EAAE,2BAA2B;IACpC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;IAC1C,gBAAgB,EAAE,4BAA4B,CAAC,QAAQ,EAAE;CAC1D,CAAC,CACH,CAAC"}
+{"version":3,"file":"onboarding-view.frontend.schemas.js","sourceRoot":"","sources":["../../../../../src/core/config/onboarding-view.frontend.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAAE,6BAA6B,EAA0B,MAAM,0BAA0B,CAAC;AAGjG;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,YAAY,CAC1D,6BAA6B,EAC7B,CAAC,CAAC,MAAM,CAAC;IACP;;;;;;;;;;;;;;;;;OAiBG;IACH,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,OAAO,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IAC3C,OAAO,EAAE,2BAA2B;IACpC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;IAC1C,gBAAgB,EAAE,4BAA4B,CAAC,QAAQ,EAAE;CAC1D,CAAC,CACH,CAAC","sourcesContent":["import { z } from 'zod';\nimport {\n  OnboardingTriggerSchema,\n  OnboardingViewOptionsSchema,\n  OnboardingElementSchema,\n  RequiredFeaturesConfigSchema,\n} from '@wildo-ai/saas-models';\nimport type {\n  OnboardingTrigger,\n  OnboardingViewOptions,\n  OnboardingElement,\n  RequiredFeaturesConfig,\n} from '@wildo-ai/saas-models';\nimport { FrontendView_DefinitionSchema, FrontendView_ScopeMode } from './views-frontend.schemas';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\n\n/**\n * OnboardingViewDefinition — intersects onboarding primitives (saas-models)\n * with view wiring (FrontendView_DefinitionSchema) for frontend rendering.\n *\n * The onboarding primitives (triggers, elements, options) are shared because\n * the backend guidance system inspects them. The view definition wrapper\n * (scope, parent requirements) is frontend-only.\n */\nexport const OnboardingViewDefinitionSchema = z.intersection(\n  FrontendView_DefinitionSchema,\n  z.object({\n    /**\n     * Stable string identity for this onboarding view. Used by:\n     * - The companion spec layer (`OnboardingViewSpecification` keys\n     *   this ref against `app.<ref>` for application-scope views and\n     *   `resources.<resourceType>.<ref>` for resource-scope views).\n     * - Future ref-based registry lookups (today the runtime accesses\n     *   onboarding documents by direct array reference via\n     *   `<EmbedOnboarding document={…} />`, but per-ref lookup is the\n     *   coming convention — guidance flows already work this way).\n     *\n     * NOTE on uniqueness: `buildFrontendModuleRegistry` collapses\n     * onboarding views to ref-keyed dedup (mirrors guidance-flow\n     * merge). Two modules contributing the same ref therefore overwrite,\n     * with the last-merged module winning — same semantics as\n     * guidance flows. Spec-layer\n     * `buildOnboardingViewSpecificationMap` ALSO fails closed on\n     * duplicate keys for any app that authors the spec.\n     */\n    ref: z.string().min(1),\n    trigger: OnboardingTriggerSchema.optional(),\n    options: OnboardingViewOptionsSchema,\n    elements: z.array(OnboardingElementSchema),\n    requiredFeatures: RequiredFeaturesConfigSchema.optional(),\n  }),\n);\n\nexport interface OnboardingViewDefinition {\n  ref: string;\n  scope: FrontendView_ScopeMode;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[];\n  additionalResourceRequirements?: FrontendResource_ParentResourceRequirement[];\n  trigger?: OnboardingTrigger;\n  options: OnboardingViewOptions;\n  elements: OnboardingElement[];\n  requiredFeatures?: RequiredFeaturesConfig;\n}\n"]}

package/dist/esm/core/config/resource-owned-view-resolution.frontend.utils.d.ts

@@ -0,0 +1,25 @@
+import { FrontendView_ScopeMode } from './views-frontend.schemas';
+import type { FrontendResourcesRegistry } from '../../core/resources/resources.frontend.schemas';
+export type ResourceOwnedViewFamily = 'composite' | 'chart' | 'execution';
+export interface ResourceOwnedViewResolutionResult {
+    family: ResourceOwnedViewFamily;
+    scope: FrontendView_ScopeMode;
+}
+export interface ResourceOwnedViewReferenceMatch extends ResourceOwnedViewResolutionResult {
+    viewRef: string;
+}
+export declare function listResourceOwnedViewReferences(params: {
+    resourceType: string;
+    registry: FrontendResourcesRegistry;
+}): ResourceOwnedViewReferenceMatch[];
+export declare function findResourceOwnedViewReferenceMatches(params: {
+    resourceType: string;
+    viewRef: string;
+    registry: FrontendResourcesRegistry;
+}): ResourceOwnedViewReferenceMatch[];
+export declare function resolveResourceOwnedViewReference(params: {
+    resourceType: string;
+    viewRef: string;
+    registry: FrontendResourcesRegistry;
+}): ResourceOwnedViewResolutionResult | null;
+//# sourceMappingURL=resource-owned-view-resolution.frontend.utils.d.ts.map

package/dist/esm/core/config/resource-owned-view-resolution.frontend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-owned-view-resolution.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/resource-owned-view-resolution.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAE/G,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,uBAAuB,CAAC;IAChC,KAAK,EAAE,sBAAsB,CAAC;CAC/B;AAED,MAAM,WAAW,+BAAgC,SAAQ,iCAAiC;IACxF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,yBAAyB,CAAC;CACrC,GAAG,+BAA+B,EAAE,CAoBpC;AAED,wBAAgB,qCAAqC,CAAC,MAAM,EAAE;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,yBAAyB,CAAC;CACrC,GAAG,+BAA+B,EAAE,CAKpC;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,yBAAyB,CAAC;CACrC,GAAG,iCAAiC,GAAG,IAAI,CAU3C"}

package/dist/esm/core/config/resource-owned-view-resolution.frontend.utils.js

@@ -0,0 +1,37 @@
+export function listResourceOwnedViewReferences(params) {
+    const frontendConfiguration = params.registry.resourceConfigurations[params.resourceType]?.frontendConfiguration;
+    return [
+        ...(frontendConfiguration?.compositeViews ?? []).map((view) => ({
+            viewRef: view.ref,
+            family: 'composite',
+            scope: view.scope,
+        })),
+        ...(frontendConfiguration?.chartViews ?? []).map((view) => ({
+            viewRef: view.ref,
+            family: 'chart',
+            scope: view.scope,
+        })),
+        ...(frontendConfiguration?.executionViews ?? []).map((view) => ({
+            viewRef: view.ref,
+            family: 'execution',
+            scope: view.scope,
+        })),
+    ];
+}
+export function findResourceOwnedViewReferenceMatches(params) {
+    return listResourceOwnedViewReferences({
+        resourceType: params.resourceType,
+        registry: params.registry,
+    }).filter((view) => view.viewRef === params.viewRef);
+}
+export function resolveResourceOwnedViewReference(params) {
+    const matches = findResourceOwnedViewReferenceMatches(params);
+    if (matches.length !== 1) {
+        return null;
+    }
+    return {
+        family: matches[0].family,
+        scope: matches[0].scope,
+    };
+}
+//# sourceMappingURL=resource-owned-view-resolution.frontend.utils.js.map

package/dist/esm/core/config/resource-owned-view-resolution.frontend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-owned-view-resolution.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/config/resource-owned-view-resolution.frontend.utils.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,+BAA+B,CAAC,MAG/C;IACC,MAAM,qBAAqB,GAAG,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAC;IAEjH,OAAO;QACL,GAAG,CAAC,qBAAqB,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,MAAM,EAAE,WAAoB;YAC5B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,GAAG,CAAC,qBAAqB,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1D,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,MAAM,EAAE,OAAgB;YACxB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,GAAG,CAAC,qBAAqB,EAAE,cAAc,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC9D,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,MAAM,EAAE,WAAoB;YAC5B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,MAIrD;IACC,OAAO,+BAA+B,CAAC;QACrC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,MAIjD;IACC,MAAM,OAAO,GAAG,qCAAqC,CAAC,MAAM,CAAC,CAAC;IAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM;QACzB,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK;KACxB,CAAC;AACJ,CAAC","sourcesContent":["import { FrontendView_ScopeMode } from './views-frontend.schemas';\nimport type { FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\n\nexport type ResourceOwnedViewFamily = 'composite' | 'chart' | 'execution';\n\nexport interface ResourceOwnedViewResolutionResult {\n  family: ResourceOwnedViewFamily;\n  scope: FrontendView_ScopeMode;\n}\n\nexport interface ResourceOwnedViewReferenceMatch extends ResourceOwnedViewResolutionResult {\n  viewRef: string;\n}\n\nexport function listResourceOwnedViewReferences(params: {\n  resourceType: string;\n  registry: FrontendResourcesRegistry;\n}): ResourceOwnedViewReferenceMatch[] {\n  const frontendConfiguration = params.registry.resourceConfigurations[params.resourceType]?.frontendConfiguration;\n\n  return [\n    ...(frontendConfiguration?.compositeViews ?? []).map((view) => ({\n      viewRef: view.ref,\n      family: 'composite' as const,\n      scope: view.scope,\n    })),\n    ...(frontendConfiguration?.chartViews ?? []).map((view) => ({\n      viewRef: view.ref,\n      family: 'chart' as const,\n      scope: view.scope,\n    })),\n    ...(frontendConfiguration?.executionViews ?? []).map((view) => ({\n      viewRef: view.ref,\n      family: 'execution' as const,\n      scope: view.scope,\n    })),\n  ];\n}\n\nexport function findResourceOwnedViewReferenceMatches(params: {\n  resourceType: string;\n  viewRef: string;\n  registry: FrontendResourcesRegistry;\n}): ResourceOwnedViewReferenceMatch[] {\n  return listResourceOwnedViewReferences({\n    resourceType: params.resourceType,\n    registry: params.registry,\n  }).filter((view) => view.viewRef === params.viewRef);\n}\n\nexport function resolveResourceOwnedViewReference(params: {\n  resourceType: string;\n  viewRef: string;\n  registry: FrontendResourcesRegistry;\n}): ResourceOwnedViewResolutionResult | null {\n  const matches = findResourceOwnedViewReferenceMatches(params);\n  if (matches.length !== 1) {\n    return null;\n  }\n\n  return {\n    family: matches[0].family,\n    scope: matches[0].scope,\n  };\n}\n"]}

package/dist/esm/core/config/settings-hub-gating.frontend.utils.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Settings Hub — Section Gating ("face to right management of the user")
+ *
+ * Pure, React-free evaluation of which categories/sections the current user may
+ * see. Kept separate from the {@link useVisibleSettingsHubConfig} hook so the
+ * gating decisions are unit-testable without a React tree.
+ *
+ * Four orthogonal gates, mirroring the framework's existing launcher/view gating
+ * semantics so settings sections behave identically to every other gated surface:
+ *
+ * 1. **Scope** — a category bound to a {@link ResourcePrimaryScope} is hidden
+ *    when that scope has no current value (e.g. the `ORGANIZATIONS` category is
+ *    hidden when no organization is selected). Scope-agnostic categories always
+ *    pass.
+ * 2. **Capability** — `runtimeAvailability.requiredCapabilities` evaluated via
+ *    the SAME {@link isLauncherRuntimeAvailabilitySatisfied} the sidebar/command
+ *    menu use (e.g. `billingEnabled`).
+ * 3. **Role** — `requiredRoles` (OR semantics) evaluated against the merged
+ *    app-level + current-organization role set (`buildFeaturePolicyRoles`).
+ * 4. **Feature** — `requiredFeatures` ({@link RequiredFeaturesConfig}) boolean
+ *    presence check against the resolved feature list. `limitChecks` are
+ *    intentionally ignored: a settings section is shown or hidden, never
+ *    "over-limit".
+ *
+ * @see settings-hub.frontend.schemas.ts — the gated section contract
+ * @see useVisibleSettingsHubConfig.ts — the hook that wires live signals into this
+ */
+import { ResourcePrimaryScope } from '@wildo-ai/saas-models';
+import type { RequiredFeaturesConfig } from '@wildo-ai/saas-models';
+import { type LauncherRuntimeAvailabilityContext } from '../../core/navigation/launcher-runtime-availability';
+import type { ResolvedSettingsHubConfig } from './settings-hub.frontend.schemas';
+/** The current primary-scope values used to evaluate category scope availability. */
+export interface SettingsScopeIds {
+    currentUserId?: string | null;
+    currentOrganizationId?: string | null;
+    currentApplicationId?: string | null;
+    currentAnonymousUserId?: string | null;
+}
+/** Everything the pure filter needs to decide section visibility. */
+export interface SettingsHubGatingContext {
+    scopeIds: SettingsScopeIds;
+    /** Merged app-level + current-org roles (from `buildFeaturePolicyRoles`). */
+    userRoles: string[];
+    /** Resolved boolean feature identifiers currently enabled. */
+    enabledFeatures: string[];
+    /** Runtime-capability context (reused verbatim from the launcher layer). */
+    runtimeContext: LauncherRuntimeAvailabilityContext;
+}
+/**
+ * Whether a category's primary scope currently has a value. A category without a
+ * `scope` is scope-agnostic and always available.
+ */
+export declare function isSettingsScopeAvailable(scope: ResourcePrimaryScope | undefined, scopeIds: SettingsScopeIds): boolean;
+/**
+ * OR-semantics role check: a section with no `requiredRoles` is open; otherwise
+ * the user must hold AT LEAST ONE of the required roles. Matches the role
+ * semantics in `evaluateGuidanceAudience`.
+ */
+export declare function hasRequiredSettingsRoles(requiredRoles: string[] | undefined, userRoles: string[]): boolean;
+/**
+ * Boolean feature gate mirroring {@link RequiredFeaturesConfig} semantics
+ * (shorthand `string[]` = OR; full form honours `mode`). `limitChecks` are not
+ * evaluated for visibility. A section with no `requiredFeatures` is open.
+ */
+export declare function areSettingsFeaturesSatisfied(requiredFeatures: RequiredFeaturesConfig | undefined, enabledFeatures: string[]): boolean;
+/**
+ * Filter a raw {@link ResolvedSettingsHubConfig} down to what the current user may see.
+ *
+ * Categories are dropped when their scope is unavailable OR when every one of
+ * their sections is gated out (an empty rail group would be visual noise). The
+ * `defaultSectionRef` is recomputed when the configured default is no longer
+ * visible, so the hub never tries to open a section the user cannot access.
+ */
+export declare function filterSettingsHubConfig(config: ResolvedSettingsHubConfig, gating: SettingsHubGatingContext): ResolvedSettingsHubConfig;
+//# sourceMappingURL=settings-hub-gating.frontend.utils.d.ts.map

package/dist/esm/core/config/settings-hub-gating.frontend.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-hub-gating.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/config/settings-hub-gating.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAEL,KAAK,kCAAkC,EACxC,MAAM,mEAAmE,CAAC;AAC3E,OAAO,KAAK,EACV,yBAAyB,EAG1B,MAAM,iCAAiC,CAAC;AAEzC,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,qEAAqE;AACrE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,6EAA6E;IAC7E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,8DAA8D;IAC9D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,4EAA4E;IAC5E,cAAc,EAAE,kCAAkC,CAAC;CACpD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,oBAAoB,GAAG,SAAS,EACvC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAaT;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EAAE,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAGT;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,gBAAgB,EAAE,sBAAsB,GAAG,SAAS,EACpD,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAYT;AAWD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,yBAAyB,EACjC,MAAM,EAAE,wBAAwB,GAC/B,yBAAyB,CA0B3B"}

package/dist/esm/core/config/settings-hub-gating.frontend.utils.js

@@ -0,0 +1,106 @@
+/**
+ * Settings Hub — Section Gating ("face to right management of the user")
+ *
+ * Pure, React-free evaluation of which categories/sections the current user may
+ * see. Kept separate from the {@link useVisibleSettingsHubConfig} hook so the
+ * gating decisions are unit-testable without a React tree.
+ *
+ * Four orthogonal gates, mirroring the framework's existing launcher/view gating
+ * semantics so settings sections behave identically to every other gated surface:
+ *
+ * 1. **Scope** — a category bound to a {@link ResourcePrimaryScope} is hidden
+ *    when that scope has no current value (e.g. the `ORGANIZATIONS` category is
+ *    hidden when no organization is selected). Scope-agnostic categories always
+ *    pass.
+ * 2. **Capability** — `runtimeAvailability.requiredCapabilities` evaluated via
+ *    the SAME {@link isLauncherRuntimeAvailabilitySatisfied} the sidebar/command
+ *    menu use (e.g. `billingEnabled`).
+ * 3. **Role** — `requiredRoles` (OR semantics) evaluated against the merged
+ *    app-level + current-organization role set (`buildFeaturePolicyRoles`).
+ * 4. **Feature** — `requiredFeatures` ({@link RequiredFeaturesConfig}) boolean
+ *    presence check against the resolved feature list. `limitChecks` are
+ *    intentionally ignored: a settings section is shown or hidden, never
+ *    "over-limit".
+ *
+ * @see settings-hub.frontend.schemas.ts — the gated section contract
+ * @see useVisibleSettingsHubConfig.ts — the hook that wires live signals into this
+ */
+import { ResourcePrimaryScope } from '@wildo-ai/saas-models';
+import { isLauncherRuntimeAvailabilitySatisfied, } from '../../core/navigation/launcher-runtime-availability.js';
+/**
+ * Whether a category's primary scope currently has a value. A category without a
+ * `scope` is scope-agnostic and always available.
+ */
+export function isSettingsScopeAvailable(scope, scopeIds) {
+    switch (scope) {
+        case undefined:
+            return true;
+        case ResourcePrimaryScope.USER_SELF:
+            return Boolean(scopeIds.currentUserId);
+        case ResourcePrimaryScope.ORGANIZATIONS:
+            return Boolean(scopeIds.currentOrganizationId);
+        case ResourcePrimaryScope.APPLICATION:
+            return Boolean(scopeIds.currentApplicationId);
+        case ResourcePrimaryScope.ANONYMOUS:
+            return Boolean(scopeIds.currentAnonymousUserId);
+    }
+}
+/**
+ * OR-semantics role check: a section with no `requiredRoles` is open; otherwise
+ * the user must hold AT LEAST ONE of the required roles. Matches the role
+ * semantics in `evaluateGuidanceAudience`.
+ */
+export function hasRequiredSettingsRoles(requiredRoles, userRoles) {
+    if (!requiredRoles?.length)
+        return true;
+    return requiredRoles.some(role => userRoles.includes(role));
+}
+/**
+ * Boolean feature gate mirroring {@link RequiredFeaturesConfig} semantics
+ * (shorthand `string[]` = OR; full form honours `mode`). `limitChecks` are not
+ * evaluated for visibility. A section with no `requiredFeatures` is open.
+ */
+export function areSettingsFeaturesSatisfied(requiredFeatures, enabledFeatures) {
+    if (!requiredFeatures)
+        return true;
+    const featureList = Array.isArray(requiredFeatures)
+        ? requiredFeatures
+        : (requiredFeatures.features ?? []);
+    if (featureList.length === 0)
+        return true;
+    const mode = Array.isArray(requiredFeatures) ? 'OR' : (requiredFeatures.mode ?? 'OR');
+    return mode === 'OR'
+        ? featureList.some(feature => enabledFeatures.includes(feature))
+        : featureList.every(feature => enabledFeatures.includes(feature));
+}
+/** A section passes every gate except its category's scope (checked at the category level). */
+function isSectionVisible(section, gating) {
+    return (isLauncherRuntimeAvailabilitySatisfied(section.runtimeAvailability, gating.runtimeContext) &&
+        hasRequiredSettingsRoles(section.requiredRoles, gating.userRoles) &&
+        areSettingsFeaturesSatisfied(section.requiredFeatures, gating.enabledFeatures));
+}
+/**
+ * Filter a raw {@link ResolvedSettingsHubConfig} down to what the current user may see.
+ *
+ * Categories are dropped when their scope is unavailable OR when every one of
+ * their sections is gated out (an empty rail group would be visual noise). The
+ * `defaultSectionRef` is recomputed when the configured default is no longer
+ * visible, so the hub never tries to open a section the user cannot access.
+ */
+export function filterSettingsHubConfig(config, gating) {
+    const scopedCategories = config.categories.filter(category => isSettingsScopeAvailable(category.scope, gating.scopeIds));
+    const scopedCategoryRefs = new Set(scopedCategories.map(category => category.ref));
+    const visibleSections = config.sections.filter(section => scopedCategoryRefs.has(section.categoryRef) && isSectionVisible(section, gating));
+    // Drop categories that ended up with zero visible sections.
+    const populatedCategoryRefs = new Set(visibleSections.map(section => section.categoryRef));
+    const visibleCategories = scopedCategories.filter(category => populatedCategoryRefs.has(category.ref));
+    const defaultSectionRef = config.defaultSectionRef && visibleSections.some(section => section.ref === config.defaultSectionRef)
+        ? config.defaultSectionRef
+        : visibleSections[0]?.ref;
+    return {
+        categories: visibleCategories,
+        sections: visibleSections,
+        defaultSectionRef,
+    };
+}
+//# sourceMappingURL=settings-hub-gating.frontend.utils.js.map

package/dist/esm/core/config/settings-hub-gating.frontend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-hub-gating.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/config/settings-hub-gating.frontend.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Settings Hub — Section Gating (\"face to right management of the user\")\n *\n * Pure, React-free evaluation of which categories/sections the current user may\n * see. Kept separate from the {@link useVisibleSettingsHubConfig} hook so the\n * gating decisions are unit-testable without a React tree.\n *\n * Four orthogonal gates, mirroring the framework's existing launcher/view gating\n * semantics so settings sections behave identically to every other gated surface:\n *\n * 1. **Scope** — a category bound to a {@link ResourcePrimaryScope} is hidden\n *    when that scope has no current value (e.g. the `ORGANIZATIONS` category is\n *    hidden when no organization is selected). Scope-agnostic categories always\n *    pass.\n * 2. **Capability** — `runtimeAvailability.requiredCapabilities` evaluated via\n *    the SAME {@link isLauncherRuntimeAvailabilitySatisfied} the sidebar/command\n *    menu use (e.g. `billingEnabled`).\n * 3. **Role** — `requiredRoles` (OR semantics) evaluated against the merged\n *    app-level + current-organization role set (`buildFeaturePolicyRoles`).\n * 4. **Feature** — `requiredFeatures` ({@link RequiredFeaturesConfig}) boolean\n *    presence check against the resolved feature list. `limitChecks` are\n *    intentionally ignored: a settings section is shown or hidden, never\n *    \"over-limit\".\n *\n * @see settings-hub.frontend.schemas.ts — the gated section contract\n * @see useVisibleSettingsHubConfig.ts — the hook that wires live signals into this\n */\n\nimport { ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport type { RequiredFeaturesConfig } from '@wildo-ai/saas-models';\nimport {\n  isLauncherRuntimeAvailabilitySatisfied,\n  type LauncherRuntimeAvailabilityContext,\n} from '~wildo-frontend-lib/core/navigation/launcher-runtime-availability';\nimport type {\n  ResolvedSettingsHubConfig,\n  SettingsCategory,\n  SettingsSection,\n} from './settings-hub.frontend.schemas';\n\n/** The current primary-scope values used to evaluate category scope availability. */\nexport interface SettingsScopeIds {\n  currentUserId?: string | null;\n  currentOrganizationId?: string | null;\n  currentApplicationId?: string | null;\n  currentAnonymousUserId?: string | null;\n}\n\n/** Everything the pure filter needs to decide section visibility. */\nexport interface SettingsHubGatingContext {\n  scopeIds: SettingsScopeIds;\n  /** Merged app-level + current-org roles (from `buildFeaturePolicyRoles`). */\n  userRoles: string[];\n  /** Resolved boolean feature identifiers currently enabled. */\n  enabledFeatures: string[];\n  /** Runtime-capability context (reused verbatim from the launcher layer). */\n  runtimeContext: LauncherRuntimeAvailabilityContext;\n}\n\n/**\n * Whether a category's primary scope currently has a value. A category without a\n * `scope` is scope-agnostic and always available.\n */\nexport function isSettingsScopeAvailable(\n  scope: ResourcePrimaryScope | undefined,\n  scopeIds: SettingsScopeIds,\n): boolean {\n  switch (scope) {\n    case undefined:\n      return true;\n    case ResourcePrimaryScope.USER_SELF:\n      return Boolean(scopeIds.currentUserId);\n    case ResourcePrimaryScope.ORGANIZATIONS:\n      return Boolean(scopeIds.currentOrganizationId);\n    case ResourcePrimaryScope.APPLICATION:\n      return Boolean(scopeIds.currentApplicationId);\n    case ResourcePrimaryScope.ANONYMOUS:\n      return Boolean(scopeIds.currentAnonymousUserId);\n  }\n}\n\n/**\n * OR-semantics role check: a section with no `requiredRoles` is open; otherwise\n * the user must hold AT LEAST ONE of the required roles. Matches the role\n * semantics in `evaluateGuidanceAudience`.\n */\nexport function hasRequiredSettingsRoles(\n  requiredRoles: string[] | undefined,\n  userRoles: string[],\n): boolean {\n  if (!requiredRoles?.length) return true;\n  return requiredRoles.some(role => userRoles.includes(role));\n}\n\n/**\n * Boolean feature gate mirroring {@link RequiredFeaturesConfig} semantics\n * (shorthand `string[]` = OR; full form honours `mode`). `limitChecks` are not\n * evaluated for visibility. A section with no `requiredFeatures` is open.\n */\nexport function areSettingsFeaturesSatisfied(\n  requiredFeatures: RequiredFeaturesConfig | undefined,\n  enabledFeatures: string[],\n): boolean {\n  if (!requiredFeatures) return true;\n\n  const featureList = Array.isArray(requiredFeatures)\n    ? requiredFeatures\n    : (requiredFeatures.features ?? []);\n  if (featureList.length === 0) return true;\n\n  const mode = Array.isArray(requiredFeatures) ? 'OR' : (requiredFeatures.mode ?? 'OR');\n  return mode === 'OR'\n    ? featureList.some(feature => enabledFeatures.includes(feature))\n    : featureList.every(feature => enabledFeatures.includes(feature));\n}\n\n/** A section passes every gate except its category's scope (checked at the category level). */\nfunction isSectionVisible(section: SettingsSection, gating: SettingsHubGatingContext): boolean {\n  return (\n    isLauncherRuntimeAvailabilitySatisfied(section.runtimeAvailability, gating.runtimeContext) &&\n    hasRequiredSettingsRoles(section.requiredRoles, gating.userRoles) &&\n    areSettingsFeaturesSatisfied(section.requiredFeatures, gating.enabledFeatures)\n  );\n}\n\n/**\n * Filter a raw {@link ResolvedSettingsHubConfig} down to what the current user may see.\n *\n * Categories are dropped when their scope is unavailable OR when every one of\n * their sections is gated out (an empty rail group would be visual noise). The\n * `defaultSectionRef` is recomputed when the configured default is no longer\n * visible, so the hub never tries to open a section the user cannot access.\n */\nexport function filterSettingsHubConfig(\n  config: ResolvedSettingsHubConfig,\n  gating: SettingsHubGatingContext,\n): ResolvedSettingsHubConfig {\n  const scopedCategories: SettingsCategory[] = config.categories.filter(category =>\n    isSettingsScopeAvailable(category.scope, gating.scopeIds),\n  );\n  const scopedCategoryRefs = new Set(scopedCategories.map(category => category.ref));\n\n  const visibleSections = config.sections.filter(\n    section => scopedCategoryRefs.has(section.categoryRef) && isSectionVisible(section, gating),\n  );\n\n  // Drop categories that ended up with zero visible sections.\n  const populatedCategoryRefs = new Set(visibleSections.map(section => section.categoryRef));\n  const visibleCategories = scopedCategories.filter(category =>\n    populatedCategoryRefs.has(category.ref),\n  );\n\n  const defaultSectionRef =\n    config.defaultSectionRef && visibleSections.some(section => section.ref === config.defaultSectionRef)\n      ? config.defaultSectionRef\n      : visibleSections[0]?.ref;\n\n  return {\n    categories: visibleCategories,\n    sections: visibleSections,\n    defaultSectionRef,\n  };\n}\n"]}