@wildo-ai/saas-models 1.1.4 → 1.1.5

package/dist/esm/config/frontend/onboarding.shared.schemas.js

@@ -1,8 +1,8 @@
 import { z } from 'zod';
-import { createSchemaFamily } from '../../resources/utils/schema-family-builder.utils.js';
 /** ──────────────────────────────────────────────────────────────
  * OnboardingView – Core primitives
  * ────────────────────────────────────────────────────────────── */
+/** @wildo_source:part:start saas.models.onboarding-trigger facet:layer:shared facet:family:guidance facet:audience:app-developer */
 /** Onboarding Trigger Types - when/how onboarding flows are activated */
 export const OnboardingTriggerType = {
     /** Triggered when user first visits the app */
@@ -16,6 +16,8 @@ export const OnboardingTriggerType = {
     /** Triggered after a specific time delay */
     DELAYED: 'delayed',
 };
+/** @wildo_source:part:end saas.models.onboarding-trigger */
+/** @wildo_source:part:start saas.models.onboarding-elements facet:layer:shared facet:family:guidance facet:audience:app-developer */
 /** Onboarding Element Types */
 export var OnboardingElementType;
 (function (OnboardingElementType) {
@@ -39,6 +41,7 @@ export var OnboardingStatus;
     OnboardingStatus["SKIPPED"] = "skipped";
     OnboardingStatus["DISMISSED"] = "dismissed";
 })(OnboardingStatus || (OnboardingStatus = {}));
+/** @wildo_source:part:end saas.models.onboarding-elements */
 /**
  * Terminal onboarding/guidance statuses — the end states from which no further
  * lifecycle transition is valid. A flow in `COMPLETED`, `SKIPPED`, or
@@ -62,6 +65,7 @@ export function isTerminalOnboardingStatus(status) {
         || status === OnboardingStatus.SKIPPED
         || status === OnboardingStatus.DISMISSED);
 }
+/** @wildo_source:part:start saas.models.onboarding-elements */
 /** Tour Step Placement */
 export var TourStepPlacement;
 (function (TourStepPlacement) {
@@ -71,15 +75,6 @@ export var TourStepPlacement;
     TourStepPlacement["RIGHT"] = "right";
     TourStepPlacement["CENTER"] = "center";
 })(TourStepPlacement || (TourStepPlacement = {}));
-/** Onboarding Position */
-export var OnboardingPosition;
-(function (OnboardingPosition) {
-    OnboardingPosition["CENTER"] = "center";
-    OnboardingPosition["TOP"] = "top";
-    OnboardingPosition["BOTTOM"] = "bottom";
-    OnboardingPosition["LEFT"] = "left";
-    OnboardingPosition["RIGHT"] = "right";
-})(OnboardingPosition || (OnboardingPosition = {}));
 /** Onboarding Variant */
 export var OnboardingVariant;
 (function (OnboardingVariant) {
@@ -121,22 +116,44 @@ export var OnboardingBannerPosition;
     OnboardingBannerPosition["TOP"] = "top";
     OnboardingBannerPosition["BOTTOM"] = "bottom";
 })(OnboardingBannerPosition || (OnboardingBannerPosition = {}));
+/** @wildo_source:part:end saas.models.onboarding-elements */
 /** ──────────────────────────────────────────────────────────────
  * OnboardingView – Schemas
  * ────────────────────────────────────────────────────────────── */
-/** Onboarding Trigger Conditions Schema */
-export const OnboardingTriggerConditionsSchema = z.object({
-    /** Only trigger for users who haven't completed this onboarding before */
-    newUsersOnly: z.boolean().default(true),
-    /** Only trigger once per user (persisted via user preferences) */
-    triggerOnce: z.boolean().default(true),
-    /** Required user roles to trigger this onboarding */
-    requiredRoles: z.array(z.string()).optional(),
-});
+/*
+ * `OnboardingTriggerConditionsSchema` and the `trigger.conditions` field were REMOVED (#1369).
+ * They declared `newUsersOnly`, `triggerOnce` and `requiredRoles`, were validated by BOTH
+ * specification surfaces, and were read by NOTHING: repo-wide the vocabulary had exactly one
+ * producer (the resource-guidance compiler, which emitted a constant) and zero consumers. No
+ * application ever authored one.
+ *
+ * What made it worse than an ignored field is that the behaviour it described DOES happen, by a
+ * different mechanism — a flow does not re-trigger, because every status transition refuses from a
+ * terminal status via `isTerminalOnboardingStatus`. So an author declaring `triggerOnce: true`
+ * observed exactly what they asked for and concluded the field worked. It was falsifiable only in
+ * the direction nobody tries: `triggerOnce: false` changed nothing, and an application wanting a
+ * flow to re-trigger could not express it and got no error saying so.
+ *
+ * `requiredRoles` was the dangerous one, because it reads as a GATE. A flow declaring it was shown
+ * to everybody. Role gating is real one level up — `GuidanceAudienceSchema.roles`, enforced in
+ * `guidance-audience.frontend.utils.ts` — so there were two spellings of one question and only one
+ * of them worked.
+ *
+ * Removed rather than wired, on the same ground as the flow-level `options` block (#1368): each key
+ * either duplicates a mechanism that IS enforced (`audience.roles`, and the terminal-status rule
+ * that `newUsersOnly` restates) or names a mode that does not exist (`triggerOnce: false`). Making
+ * a flow re-trigger is a real capability and deserves to be asked as its own question, against the
+ * state that would drive it — not carried as a default nobody could turn off.
+ */
+/** @wildo_source:part:start saas.models.onboarding-trigger */
 /** Onboarding Trigger Schema - defines when/how an onboarding or guidance flow is activated.
  *  Important runtime note:
- *  - `EVENT` is the only trigger type evaluated by the backend operation pipeline.
- *  - `FIRST_VISIT`, `ROUTE_MATCH`, `DELAYED`, and `MANUAL` are frontend/manual concerns. */
+ *  - `EVENT` is the only trigger type evaluated by the backend operation pipeline. Its `eventName`
+ *    for a resource operation succeeding is `<resourceType>:<operationIdentifier>` — build it from
+ *    your resource-type enum and `CoreResourceOperation`, e.g.
+ *    `` `${MyModule_ResourceType.PROJECTS}:${CoreResourceOperation.CREATE}` ``.
+ *  - `FIRST_VISIT`, `ROUTE_MATCH`, `DELAYED`, and `MANUAL` are frontend/manual concerns.
+ *  - A flow shows once per subject: it does not re-trigger after it is completed, skipped or dismissed. */
 export const OnboardingTriggerSchema = z.object({
     /** The type of trigger that activates this onboarding */
     type: z.enum(OnboardingTriggerType).default(OnboardingTriggerType.FIRST_VISIT),
@@ -146,10 +163,10 @@ export const OnboardingTriggerSchema = z.object({
     eventName: z.string().optional(),
     /** For DELAYED: Delay in milliseconds before triggering */
     delayMs: z.number().positive().optional(),
-    /** Conditions that must be met for the trigger to activate */
-    conditions: OnboardingTriggerConditionsSchema.optional(),
 });
-/** Onboarding View Options Schema */
+/** @wildo_source:part:end saas.models.onboarding-trigger */
+/** @wildo_source:part:start saas.frontend.onboarding-view */
+/** Onboarding View Options Schema — the `options` of an onboarding DOCUMENT (guidance flows have none). */
 export const OnboardingViewOptionsSchema = z.object({
     showProgress: z.boolean().default(true),
     allowDismiss: z.boolean().default(true),
@@ -158,6 +175,7 @@ export const OnboardingViewOptionsSchema = z.object({
     allowSkip: z.boolean().default(true),
     className: z.string().optional(),
 });
+/** @wildo_source:part:end saas.frontend.onboarding-view */
 /** ──────────────────────────────────────────────────────────────
  * OnboardingView – Reusable Config Schemas
  *
@@ -165,6 +183,7 @@ export const OnboardingViewOptionsSchema = z.object({
  * for each onboarding element, separated from base identity/state fields.
  * for reuse across packages.
  * ────────────────────────────────────────────────────────────── */
+/** @wildo_source:part:start saas.models.onboarding-elements */
 /** Tour Step Schema */
 export const OnboardingTourStepSchema = z.object({
     ref: z.string(),
@@ -183,6 +202,65 @@ export const OnboardingSurveyQuestionSchema = z.object({
     type: z.enum(OnboardingSurveyQuestionType),
     options: z.array(z.object({ ref: z.string() })).optional(),
     required: z.boolean().default(false),
+    /**
+     * The field of the survey's bound resource this answer is written to.
+     *
+     * Omitted, the answer is recorded on the subject's own guidance-state row and nothing else reads
+     * it — which is right for a genuine survey.
+     *
+     * Declared, the answer becomes a value the application owns: it is written through the target
+     * resource's ordinary default `API_CALL` UPDATE, under the ordinary authorization, alongside every
+     * other bound answer in the same submission. It is NOT a second write path — a bound survey is a
+     * form whose fields were asked one at a time.
+     *
+     * It is meaningless without `bindTo` on the survey itself, and the element schema REFUSES that
+     * combination rather than ignoring it.
+     */
+    bindToField: z.string().min(1).optional(),
+});
+/**
+ * The question types a field binding accepts, because their answer IS the value.
+ *
+ * The choice types are excluded ON PURPOSE rather than by oversight. An option carries only a
+ * `ref`, which is an i18n key — so binding a RADIO, CHECKBOX or SINGLE_CHOICE question would write
+ * that key into an application's resource field and store `favouriteColourBlue` where the
+ * application expected a colour. Silently, and durably.
+ *
+ * Refused rather than documented, because a binding that stores the wrong thing is worse than one
+ * that does not exist: nothing downstream can tell a key from a value. Admitting the choice types
+ * means giving an option a VALUE alongside its ref, which is an additive change to this schema and
+ * the natural next step if an application needs it.
+ */
+export const SURVEY_QUESTION_TYPES_WHOSE_ANSWER_IS_A_VALUE = [
+    OnboardingSurveyQuestionType.TEXT,
+    OnboardingSurveyQuestionType.TEXTAREA,
+    OnboardingSurveyQuestionType.RATING,
+];
+/**
+ * Where a survey's answers land, beyond the guidance-state row.
+ *
+ * ## Why the resource is named once, and the field per question
+ *
+ * A survey writes ONE row in ONE submission. Naming the resource per question would let a single
+ * submit fan out across several resources, which buys nothing an application cannot express with two
+ * surveys, and costs partial-failure semantics: three writes, the second refused, and an element
+ * that is neither complete nor cleanly incomplete. One resource, one write, one outcome.
+ *
+ * ## What the target has to be
+ *
+ * A resource the current subject already has a row of, reachable without naming an id — the shape
+ * `userProfiles` has, and the shape an application's own `USERS → <resource>` composition has. The
+ * scope parameters are injected by `ScopedResourceRegistryProvider`, exactly as they are for the
+ * guidance-state write itself, so the binding never addresses a row by id and cannot reach another
+ * subject's data.
+ *
+ * v1 performs an UPDATE and does not create a missing row. That is a stated limitation rather than a
+ * silent one: the write is refused, loudly, and the element does not complete. Create-if-absent is
+ * additive and can be added against a real target that needs it.
+ */
+export const OnboardingSurveyBindingSchema = z.object({
+    /** The resource type whose row receives the bound answers. */
+    resourceType: z.string().min(1),
 });
 /** Checklist Config Schema - type-specific fields only */
 export const OnboardingChecklistConfigSchema = z.object({
@@ -244,7 +322,46 @@ export const OnboardingCardConfigSchema = z.object({
 export const OnboardingSurveyConfigSchema = z.object({
     questions: z.array(OnboardingSurveyQuestionSchema).default([]),
     allowSkip: z.boolean().default(true),
+    /** Where bound answers are written. See {@link OnboardingSurveyBindingSchema}. */
+    bindTo: OnboardingSurveyBindingSchema.optional(),
 });
+/**
+ * A question may only name a field when its survey names a resource.
+ *
+ * Refused rather than ignored, because an ignored `bindToField` is the exact defect this capability
+ * was built alongside: an author declares where an answer should go, the runtime drops it on the
+ * floor, and nothing says so until somebody reads the row and finds it empty.
+ *
+ * It lives as a standalone function rather than a `.superRefine` on the config schema because that
+ * schema's `.shape` is SPREAD into a discriminated-union member, and a refinement wrapper has no
+ * `.shape`; and it cannot sit on the union member either, since `z.discriminatedUnion` requires
+ * plain object members. So the union applies it, once, for the SURVEY case.
+ */
+export function assertSurveyFieldBindingsHaveATarget(survey, ctx, pathPrefix = []) {
+    survey.questions.forEach((question, index) => {
+        if (question.bindToField === undefined)
+            return;
+        if (!survey.bindTo) {
+            ctx.addIssue({
+                code: 'custom',
+                path: [...pathPrefix, 'questions', index, 'bindToField'],
+                message: `question "${question.id}" declares bindToField "${question.bindToField}" but the survey declares no `
+                    + 'bindTo.resourceType, so the answer has nowhere to be written. Declare the survey\'s target resource, '
+                    + 'or remove the field binding.',
+            });
+            return;
+        }
+        if (!SURVEY_QUESTION_TYPES_WHOSE_ANSWER_IS_A_VALUE.includes(question.type)) {
+            ctx.addIssue({
+                code: 'custom',
+                path: [...pathPrefix, 'questions', index, 'bindToField'],
+                message: `question "${question.id}" is a ${question.type} question and cannot be bound to a field. Its answer is an `
+                    + 'option REF, which is an i18n key rather than a value, so writing it to a resource would store the key. '
+                    + `Bind a ${SURVEY_QUESTION_TYPES_WHOSE_ANSWER_IS_A_VALUE.join(' / ')} question instead.`,
+            });
+        }
+    });
+}
 /** ──────────────────────────────────────────────────────────────
  * OnboardingView – Element Base Schema (for reuse)
  *
@@ -264,82 +381,8 @@ export const OnboardingElementBaseSchema = z.object({
     targetField: z.string().optional(),
 });
 /** ──────────────────────────────────────────────────────────────
- * OnboardingView – Element Schema Family
- *
- * Uses createSchemaFamily for discriminated union with automatic
- * inheritance configuration generation. Each variant extends the
- * base with type-specific fields from config schemas.
+ * OnboardingView – Element Union
  * ────────────────────────────────────────────────────────────── */
-export const OnboardingElementSchemaFamily = createSchemaFamily({
-    base: OnboardingElementBaseSchema,
-    discriminator: {
-        field: 'type',
-        baseValues: [], // All element types have variants
-    },
-    variants: {
-        [OnboardingElementType.CHECKLIST]: {
-            extend: z.object({
-                /** References to checklist item elements */
-                items: z.array(z.string()),
-                ...OnboardingChecklistConfigSchema.shape,
-            }),
-        },
-        [OnboardingElementType.CHECKLIST_ITEM]: {
-            extend: z.object({
-                /** Whether this item is completed */
-                completed: z.boolean().default(false),
-                ...OnboardingChecklistItemConfigSchema.shape,
-            }),
-        },
-        [OnboardingElementType.TOUR]: {
-            extend: z.object({
-                /** Current step index in the tour */
-                currentStepIndex: z.number().int().nonnegative().default(0),
-                ...OnboardingTourConfigSchema.shape,
-            }),
-        },
-        [OnboardingElementType.TOOLTIP]: {
-            extend: z.object({
-                ...OnboardingTooltipConfigSchema.shape,
-            }),
-        },
-        [OnboardingElementType.MODAL]: {
-            extend: z.object({
-                ...OnboardingModalConfigSchema.shape,
-            }),
-        },
-        [OnboardingElementType.BANNER]: {
-            extend: z.object({
-                ...OnboardingBannerConfigSchema.shape,
-            }),
-        },
-        [OnboardingElementType.ANNOUNCEMENT]: {
-            extend: z.object({
-                ...OnboardingAnnouncementConfigSchema.shape,
-            }),
-        },
-        [OnboardingElementType.BADGE]: {
-            extend: z.object({
-                ...OnboardingBadgeConfigSchema.shape,
-            }),
-        },
-        [OnboardingElementType.CARD]: {
-            extend: z.object({
-                ...OnboardingCardConfigSchema.shape,
-            }),
-        },
-        [OnboardingElementType.SURVEY]: {
-            extend: z.object({
-                ...OnboardingSurveyConfigSchema.shape,
-            }),
-        },
-    },
-});
-/**
- * Schema family with full access to base, variants, union, and inheritenceSchemaDefinition.
- * Use for resource configuration and cross-package integration.
- * Access variants via: OnboardingElementSchemaFamily.variants[OnboardingElementType.CHECKLIST]
- */
 /**
  * Typed discriminated union of all onboarding element types.
  * Use this for runtime validation and type inference.
@@ -389,5 +432,10 @@ export const OnboardingElementSchema = z.discriminatedUnion('type', [
         type: z.literal(OnboardingElementType.SURVEY),
         ...OnboardingSurveyConfigSchema.shape,
     }),
-]);
+]).superRefine((element, ctx) => {
+    // The one cross-field rule in this vocabulary, applied where a discriminated union allows it.
+    if (element.type !== OnboardingElementType.SURVEY)
+        return;
+    assertSurveyFieldBindingsHaveATarget(element, ctx);
+});
 //# sourceMappingURL=onboarding.shared.schemas.js.map

package/dist/esm/config/frontend/onboarding.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"onboarding.shared.schemas.js","sourceRoot":"","sources":["../../../../../src/config/frontend/onboarding.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { createSchemaFamily } from '../../resources/utils/schema-family-builder.utils';\n\n/** ──────────────────────────────────────────────────────────────\n * OnboardingView – Core primitives\n * ────────────────────────────────────────────────────────────── */\n\n/** Onboarding Trigger Types - when/how onboarding flows are activated */\nexport const OnboardingTriggerType = {\n  /** Triggered when user first visits the app */\n  FIRST_VISIT: 'first-visit',\n  /** Triggered when a specific URL/route is visited */\n  ROUTE_MATCH: 'route-match',\n  /** Triggered by a specific event */\n  EVENT: 'event',\n  /** Triggered manually (via API or user action) */\n  MANUAL: 'manual',\n  /** Triggered after a specific time delay */\n  DELAYED: 'delayed',\n} as const;\nexport type OnboardingTriggerType = typeof OnboardingTriggerType[keyof typeof OnboardingTriggerType];\n\n/** Onboarding Element Types */\nexport enum OnboardingElementType {\n  CHECKLIST = \"checklist\",\n  CHECKLIST_ITEM = \"checklist-item\",\n  TOUR = \"tour\",\n  TOOLTIP = \"tooltip\",\n  MODAL = \"modal\",\n  BANNER = \"banner\",\n  ANNOUNCEMENT = \"announcement\",\n  BADGE = \"badge\",\n  CARD = \"card\",\n  SURVEY = \"survey\",\n}\n\n/** Onboarding Status */\nexport enum OnboardingStatus {\n  NOT_STARTED = \"not-started\",\n  IN_PROGRESS = \"in-progress\",\n  COMPLETED = \"completed\",\n  SKIPPED = \"skipped\",\n  DISMISSED = \"dismissed\",\n}\n\n/**\n * Terminal onboarding/guidance statuses — the end states from which no further\n * lifecycle transition is valid. A flow in `COMPLETED`, `SKIPPED`, or\n * `DISMISSED` has been finished, skipped, or dismissed by the user and must not\n * be re-completed / re-dismissed / re-skipped / re-activated.\n *\n * `NOT_STARTED`, `IN_PROGRESS`, and \"no persisted state yet\" (`undefined`) are\n * the NON-terminal states. Treating `undefined` as non-terminal is the crux for\n * surfaces that render a flow WITHOUT routing it through the guidance trigger\n * engine (e.g. a standalone `OnboardingView`): such a flow legitimately has no\n * persisted state on first render, yet the user's first action (dismiss / skip /\n * complete) must still be recorded. Guarding on `=== IN_PROGRESS` would silently\n * drop that first action and the surface would reappear on reload.\n *\n * Single source of truth for the four guidance lifecycle guards\n * (activate / complete / dismiss / skip) — terminal-state reasoning lives here,\n * not inlined per call site, to prevent drift between them.\n */\nexport function isTerminalOnboardingStatus(status: OnboardingStatus | undefined): boolean {\n  return (\n    status === OnboardingStatus.COMPLETED\n    || status === OnboardingStatus.SKIPPED\n    || status === OnboardingStatus.DISMISSED\n  );\n}\n\n/** Tour Step Placement */\nexport enum TourStepPlacement {\n  TOP = \"top\",\n  BOTTOM = \"bottom\",\n  LEFT = \"left\",\n  RIGHT = \"right\",\n  CENTER = \"center\",\n}\n\n\n/** Onboarding Position */\nexport enum OnboardingPosition {\n  CENTER = \"center\",\n  TOP = \"top\",\n  BOTTOM = \"bottom\",\n  LEFT = \"left\",\n  RIGHT = \"right\",\n}\n\n/** Onboarding Variant */\nexport enum OnboardingVariant {\n  INFO = \"info\",\n  SUCCESS = \"success\",\n  WARNING = \"warning\",\n  ERROR = \"error\",\n}\n\n/** Badge Variant */\nexport enum OnboardingBadgeVariant {\n  DEFAULT = \"default\",\n  PRIMARY = \"primary\",\n  SECONDARY = \"secondary\",\n  SUCCESS = \"success\",\n  WARNING = \"warning\",\n  ERROR = \"error\",\n}\n\n/** Card Variant */\nexport enum OnboardingCardVariant {\n  DEFAULT = \"default\",\n  OUTLINED = \"outlined\",\n  ELEVATED = \"elevated\",\n}\n\n/** Survey Question Type */\nexport enum OnboardingSurveyQuestionType {\n  TEXT = \"text\",\n  RADIO = \"radio\",\n  CHECKBOX = \"checkbox\",\n  RATING = \"rating\",\n  TEXTAREA = \"textarea\",\n  SINGLE_CHOICE = \"single-choice\",\n}\n\n/** Banner Position */\nexport enum OnboardingBannerPosition {\n  TOP = \"top\",\n  BOTTOM = \"bottom\",\n}\n\n/** ──────────────────────────────────────────────────────────────\n * OnboardingView – Schemas\n * ────────────────────────────────────────────────────────────── */\n\n/** Onboarding Trigger Conditions Schema */\nexport const OnboardingTriggerConditionsSchema = z.object({\n  /** Only trigger for users who haven't completed this onboarding before */\n  newUsersOnly: z.boolean().default(true),\n  /** Only trigger once per user (persisted via user preferences) */\n  triggerOnce: z.boolean().default(true),\n  /** Required user roles to trigger this onboarding */\n  requiredRoles: z.array(z.string()).optional(),\n});\n\n/** Onboarding Trigger Schema - defines when/how an onboarding or guidance flow is activated.\n *  Important runtime note:\n *  - `EVENT` is the only trigger type evaluated by the backend operation pipeline.\n *  - `FIRST_VISIT`, `ROUTE_MATCH`, `DELAYED`, and `MANUAL` are frontend/manual concerns. */\nexport const OnboardingTriggerSchema = z.object({\n  /** The type of trigger that activates this onboarding */\n  type: z.enum(OnboardingTriggerType).default(OnboardingTriggerType.FIRST_VISIT),\n\n  /** For ROUTE_MATCH: Route pattern to match (regex or glob) */\n  routePattern: z.string().optional(),\n\n  /** For EVENT: Event name to listen for */\n  eventName: z.string().optional(),\n\n  /** For DELAYED: Delay in milliseconds before triggering */\n  delayMs: z.number().positive().optional(),\n\n  /** Conditions that must be met for the trigger to activate */\n  conditions: OnboardingTriggerConditionsSchema.optional(),\n});\n\n/** Onboarding View Options Schema */\nexport const OnboardingViewOptionsSchema = z.object({\n  showProgress: z.boolean().default(true),\n  allowDismiss: z.boolean().default(true),\n  persistState: z.boolean().default(true),\n  autoStart: z.boolean().default(false),\n  allowSkip: z.boolean().default(true),\n  className: z.string().optional(),\n});\n\n/** ──────────────────────────────────────────────────────────────\n * OnboardingView – Reusable Config Schemas\n *\n * These config schemas define the type-specific structural/runtime properties\n * for each onboarding element, separated from base identity/state fields.\n * for reuse across packages.\n * ────────────────────────────────────────────────────────────── */\n\n/** Tour Step Schema */\nexport const OnboardingTourStepSchema = z.object({\n  ref: z.string(),\n  order: z.number().int().nonnegative(),\n  placement: z.enum(TourStepPlacement).default(TourStepPlacement.BOTTOM),\n  targetSelector: z.string().optional(),\n  /** Optional resource field name this step targets — resolved to [data-guidance-field=\"...\"] at render time */\n  targetField: z.string().optional(),\n  imageUrl: z.url().optional(),\n  videoUrl: z.url().optional(),\n});\n\n/** Survey Question Schema */\nexport const OnboardingSurveyQuestionSchema = z.object({\n  id: z.string(),\n  ref: z.string().optional(),\n  type: z.enum(OnboardingSurveyQuestionType),\n  options: z.array(z.object({ ref: z.string() })).optional(),\n  required: z.boolean().default(false),\n});\n\n/** Checklist Config Schema - type-specific fields only */\nexport const OnboardingChecklistConfigSchema = z.object({\n  showProgress: z.boolean().default(true),\n});\n\n/** Checklist Item Config Schema - type-specific fields only */\nexport const OnboardingChecklistItemConfigSchema = z.object({\n  actionRef: z.string().optional(),\n});\n\n/** Tour Config Schema - type-specific fields only */\nexport const OnboardingTourConfigSchema = z.object({\n  steps: z.array(OnboardingTourStepSchema).default([]),\n  autoStart: z.boolean().default(false),\n  allowSkip: z.boolean().default(true),\n});\n\n/** Tooltip Config Schema - type-specific fields only */\nexport const OnboardingTooltipConfigSchema = z.object({\n  targetSelector: z.string(),\n  placement: z.enum(TourStepPlacement).default(TourStepPlacement.BOTTOM),\n  showOnce: z.boolean().default(true),\n});\n\n/** Modal Config Schema - type-specific fields only */\nexport const OnboardingModalConfigSchema = z.object({\n  imageUrl: z.url().optional(),\n  videoUrl: z.url().optional(),\n  ctaAction: z.string().optional(),\n  dismissible: z.boolean().default(true),\n});\n\n/** Banner Config Schema - type-specific fields only */\nexport const OnboardingBannerConfigSchema = z.object({\n  variant: z.enum(OnboardingVariant).default(OnboardingVariant.INFO),\n  dismissible: z.boolean().default(true),\n  position: z.enum(OnboardingBannerPosition).default(OnboardingBannerPosition.TOP),\n  actionRef: z.string().optional(),\n});\n\n/** Announcement Config Schema - type-specific fields only */\nexport const OnboardingAnnouncementConfigSchema = z.object({\n  variant: z.enum(OnboardingVariant).default(OnboardingVariant.INFO),\n  dismissible: z.boolean().default(true),\n  icon: z.string().optional(),\n  actionRef: z.string().optional(),\n});\n\n/** Badge Config Schema - type-specific fields only */\nexport const OnboardingBadgeConfigSchema = z.object({\n  icon: z.string().optional(),\n  variant: z.enum(OnboardingBadgeVariant).default(OnboardingBadgeVariant.DEFAULT),\n  color: z.string().optional(),\n  unlocked: z.boolean().default(false),\n  actionRef: z.string().optional(),\n});\n\n/** Card Config Schema - type-specific fields only */\nexport const OnboardingCardConfigSchema = z.object({\n  icon: z.string().optional(),\n  imageUrl: z.url().optional(),\n  variant: z.enum(OnboardingCardVariant).default(OnboardingCardVariant.DEFAULT),\n  actionRef: z.string().optional(),\n});\n\n/** Survey Config Schema - type-specific fields only */\nexport const OnboardingSurveyConfigSchema = z.object({\n  questions: z.array(OnboardingSurveyQuestionSchema).default([]),\n  allowSkip: z.boolean().default(true),\n});\n\n/** ──────────────────────────────────────────────────────────────\n * OnboardingView – Element Base Schema (for reuse)\n *\n * Contains common fields shared by all onboarding element types.\n * Extracted for reuse across packages.\n * ────────────────────────────────────────────────────────────── */\n\nexport const OnboardingElementBaseSchema = z.object({\n  /** Unique reference for this element */\n  ref: z.string(),\n  /** Element type discriminator */\n  type: z.enum(OnboardingElementType),\n  /** Current status */\n  status: z.enum(OnboardingStatus).default(OnboardingStatus.NOT_STARTED),\n  /** Display order */\n  order: z.number().int().nonnegative(),\n  /** Optional resource field name this element targets — resolved to a CSS selector [data-guidance-field=\"...\"] at render time */\n  targetField: z.string().optional(),\n});\n\nexport type OnboardingElementBase = z.infer<typeof OnboardingElementBaseSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * OnboardingView – Element Schema Family\n *\n * Uses createSchemaFamily for discriminated union with automatic\n * inheritance configuration generation. Each variant extends the\n * base with type-specific fields from config schemas.\n * ────────────────────────────────────────────────────────────── */\n\nexport const OnboardingElementSchemaFamily = createSchemaFamily({\n  base: OnboardingElementBaseSchema,\n  discriminator: {\n    field: 'type',\n    baseValues: [], // All element types have variants\n  },\n  variants: {\n    [OnboardingElementType.CHECKLIST]: {\n      extend: z.object({\n        /** References to checklist item elements */\n        items: z.array(z.string()),\n        ...OnboardingChecklistConfigSchema.shape,\n      }),\n    },\n    [OnboardingElementType.CHECKLIST_ITEM]: {\n      extend: z.object({\n        /** Whether this item is completed */\n        completed: z.boolean().default(false),\n        ...OnboardingChecklistItemConfigSchema.shape,\n      }),\n    },\n    [OnboardingElementType.TOUR]: {\n      extend: z.object({\n        /** Current step index in the tour */\n        currentStepIndex: z.number().int().nonnegative().default(0),\n        ...OnboardingTourConfigSchema.shape,\n      }),\n    },\n    [OnboardingElementType.TOOLTIP]: {\n      extend: z.object({\n        ...OnboardingTooltipConfigSchema.shape,\n      }),\n    },\n    [OnboardingElementType.MODAL]: {\n      extend: z.object({\n        ...OnboardingModalConfigSchema.shape,\n      }),\n    },\n    [OnboardingElementType.BANNER]: {\n      extend: z.object({\n        ...OnboardingBannerConfigSchema.shape,\n      }),\n    },\n    [OnboardingElementType.ANNOUNCEMENT]: {\n      extend: z.object({\n        ...OnboardingAnnouncementConfigSchema.shape,\n      }),\n    },\n    [OnboardingElementType.BADGE]: {\n      extend: z.object({\n        ...OnboardingBadgeConfigSchema.shape,\n      }),\n    },\n    [OnboardingElementType.CARD]: {\n      extend: z.object({\n        ...OnboardingCardConfigSchema.shape,\n      }),\n    },\n    [OnboardingElementType.SURVEY]: {\n      extend: z.object({\n        ...OnboardingSurveyConfigSchema.shape,\n      }),\n    },\n  },\n});\n\n/**\n * Schema family with full access to base, variants, union, and inheritenceSchemaDefinition.\n * Use for resource configuration and cross-package integration.\n * Access variants via: OnboardingElementSchemaFamily.variants[OnboardingElementType.CHECKLIST]\n */\n\n/**\n * Typed discriminated union of all onboarding element types.\n * Use this for runtime validation and type inference.\n * Note: Created separately from SchemaFamily to preserve full TypeScript type inference.\n */\nexport const OnboardingElementSchema = z.discriminatedUnion('type', [\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.CHECKLIST),\n    items: z.array(z.string()),\n    ...OnboardingChecklistConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.CHECKLIST_ITEM),\n    completed: z.boolean().default(false),\n    ...OnboardingChecklistItemConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.TOUR),\n    currentStepIndex: z.number().int().nonnegative().default(0),\n    ...OnboardingTourConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.TOOLTIP),\n    ...OnboardingTooltipConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.MODAL),\n    ...OnboardingModalConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.BANNER),\n    ...OnboardingBannerConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.ANNOUNCEMENT),\n    ...OnboardingAnnouncementConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.BADGE),\n    ...OnboardingBadgeConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.CARD),\n    ...OnboardingCardConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.SURVEY),\n    ...OnboardingSurveyConfigSchema.shape,\n  }),\n]);\n\n/** ──────────────────────────────────────────────────────────────\n * Onboarding – Type Definitions\n * ────────────────────────────────────────────────────────────── */\n\nexport type OnboardingTriggerConditions = z.infer<typeof OnboardingTriggerConditionsSchema>;\nexport type OnboardingTrigger = z.infer<typeof OnboardingTriggerSchema>;\nexport type OnboardingViewOptions = z.infer<typeof OnboardingViewOptionsSchema>;\nexport type OnboardingTourStep = z.infer<typeof OnboardingTourStepSchema>;\nexport type OnboardingSurveyQuestion = z.infer<typeof OnboardingSurveyQuestionSchema>;\nexport type OnboardingElement = z.infer<typeof OnboardingElementSchema>;\n\n/** Config schema types */\nexport type OnboardingChecklistConfig = z.infer<typeof OnboardingChecklistConfigSchema>;\nexport type OnboardingChecklistItemConfig = z.infer<typeof OnboardingChecklistItemConfigSchema>;\nexport type OnboardingTourConfig = z.infer<typeof OnboardingTourConfigSchema>;\nexport type OnboardingTooltipConfig = z.infer<typeof OnboardingTooltipConfigSchema>;\nexport type OnboardingModalConfig = z.infer<typeof OnboardingModalConfigSchema>;\nexport type OnboardingBannerConfig = z.infer<typeof OnboardingBannerConfigSchema>;\nexport type OnboardingAnnouncementConfig = z.infer<typeof OnboardingAnnouncementConfigSchema>;\nexport type OnboardingBadgeConfig = z.infer<typeof OnboardingBadgeConfigSchema>;\nexport type OnboardingCardConfig = z.infer<typeof OnboardingCardConfigSchema>;\nexport type OnboardingSurveyConfig = z.infer<typeof OnboardingSurveyConfigSchema>;\n\n/**\n * Individual element variant types - extracted from OnboardingElement discriminated union.\n */\nexport type OnboardingChecklistElement = Extract<OnboardingElement, { type: OnboardingElementType.CHECKLIST }>;\nexport type OnboardingChecklistItemElement = Extract<OnboardingElement, { type: OnboardingElementType.CHECKLIST_ITEM }>;\nexport type OnboardingTourElement = Extract<OnboardingElement, { type: OnboardingElementType.TOUR }>;\nexport type OnboardingTooltipElement = Extract<OnboardingElement, { type: OnboardingElementType.TOOLTIP }>;\nexport type OnboardingModalElement = Extract<OnboardingElement, { type: OnboardingElementType.MODAL }>;\nexport type OnboardingBannerElement = Extract<OnboardingElement, { type: OnboardingElementType.BANNER }>;\nexport type OnboardingAnnouncementElement = Extract<OnboardingElement, { type: OnboardingElementType.ANNOUNCEMENT }>;\nexport type OnboardingBadgeElement = Extract<OnboardingElement, { type: OnboardingElementType.BADGE }>;\nexport type OnboardingCardElement = Extract<OnboardingElement, { type: OnboardingElementType.CARD }>;\nexport type OnboardingSurveyElement = Extract<OnboardingElement, { type: OnboardingElementType.SURVEY }>;\n\n/** Alias for OnboardingChecklistItemElement (backward compatibility) */\nexport type OnboardingChecklistItem = OnboardingChecklistItemElement;\n"]}
+{"version":3,"file":"onboarding.shared.schemas.js","sourceRoot":"","sources":["../../../../../src/config/frontend/onboarding.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\n/** ──────────────────────────────────────────────────────────────\n * OnboardingView – Core primitives\n * ────────────────────────────────────────────────────────────── */\n\n/** @wildo_source:part:start saas.models.onboarding-trigger facet:layer:shared facet:family:guidance facet:audience:app-developer */\n/** Onboarding Trigger Types - when/how onboarding flows are activated */\nexport const OnboardingTriggerType = {\n  /** Triggered when user first visits the app */\n  FIRST_VISIT: 'first-visit',\n  /** Triggered when a specific URL/route is visited */\n  ROUTE_MATCH: 'route-match',\n  /** Triggered by a specific event */\n  EVENT: 'event',\n  /** Triggered manually (via API or user action) */\n  MANUAL: 'manual',\n  /** Triggered after a specific time delay */\n  DELAYED: 'delayed',\n} as const;\nexport type OnboardingTriggerType = typeof OnboardingTriggerType[keyof typeof OnboardingTriggerType];\n/** @wildo_source:part:end saas.models.onboarding-trigger */\n\n/** @wildo_source:part:start saas.models.onboarding-elements facet:layer:shared facet:family:guidance facet:audience:app-developer */\n/** Onboarding Element Types */\nexport enum OnboardingElementType {\n  CHECKLIST = \"checklist\",\n  CHECKLIST_ITEM = \"checklist-item\",\n  TOUR = \"tour\",\n  TOOLTIP = \"tooltip\",\n  MODAL = \"modal\",\n  BANNER = \"banner\",\n  ANNOUNCEMENT = \"announcement\",\n  BADGE = \"badge\",\n  CARD = \"card\",\n  SURVEY = \"survey\",\n}\n\n/** Onboarding Status */\nexport enum OnboardingStatus {\n  NOT_STARTED = \"not-started\",\n  IN_PROGRESS = \"in-progress\",\n  COMPLETED = \"completed\",\n  SKIPPED = \"skipped\",\n  DISMISSED = \"dismissed\",\n}\n/** @wildo_source:part:end saas.models.onboarding-elements */\n\n/**\n * Terminal onboarding/guidance statuses — the end states from which no further\n * lifecycle transition is valid. A flow in `COMPLETED`, `SKIPPED`, or\n * `DISMISSED` has been finished, skipped, or dismissed by the user and must not\n * be re-completed / re-dismissed / re-skipped / re-activated.\n *\n * `NOT_STARTED`, `IN_PROGRESS`, and \"no persisted state yet\" (`undefined`) are\n * the NON-terminal states. Treating `undefined` as non-terminal is the crux for\n * surfaces that render a flow WITHOUT routing it through the guidance trigger\n * engine (e.g. a standalone `OnboardingView`): such a flow legitimately has no\n * persisted state on first render, yet the user's first action (dismiss / skip /\n * complete) must still be recorded. Guarding on `=== IN_PROGRESS` would silently\n * drop that first action and the surface would reappear on reload.\n *\n * Single source of truth for the four guidance lifecycle guards\n * (activate / complete / dismiss / skip) — terminal-state reasoning lives here,\n * not inlined per call site, to prevent drift between them.\n */\nexport function isTerminalOnboardingStatus(status: OnboardingStatus | undefined): boolean {\n  return (\n    status === OnboardingStatus.COMPLETED\n    || status === OnboardingStatus.SKIPPED\n    || status === OnboardingStatus.DISMISSED\n  );\n}\n\n/** @wildo_source:part:start saas.models.onboarding-elements */\n/** Tour Step Placement */\nexport enum TourStepPlacement {\n  TOP = \"top\",\n  BOTTOM = \"bottom\",\n  LEFT = \"left\",\n  RIGHT = \"right\",\n  CENTER = \"center\",\n}\n\n\n/** Onboarding Variant */\nexport enum OnboardingVariant {\n  INFO = \"info\",\n  SUCCESS = \"success\",\n  WARNING = \"warning\",\n  ERROR = \"error\",\n}\n\n/** Badge Variant */\nexport enum OnboardingBadgeVariant {\n  DEFAULT = \"default\",\n  PRIMARY = \"primary\",\n  SECONDARY = \"secondary\",\n  SUCCESS = \"success\",\n  WARNING = \"warning\",\n  ERROR = \"error\",\n}\n\n/** Card Variant */\nexport enum OnboardingCardVariant {\n  DEFAULT = \"default\",\n  OUTLINED = \"outlined\",\n  ELEVATED = \"elevated\",\n}\n\n/** Survey Question Type */\nexport enum OnboardingSurveyQuestionType {\n  TEXT = \"text\",\n  RADIO = \"radio\",\n  CHECKBOX = \"checkbox\",\n  RATING = \"rating\",\n  TEXTAREA = \"textarea\",\n  SINGLE_CHOICE = \"single-choice\",\n}\n\n/** Banner Position */\nexport enum OnboardingBannerPosition {\n  TOP = \"top\",\n  BOTTOM = \"bottom\",\n}\n/** @wildo_source:part:end saas.models.onboarding-elements */\n\n/** ──────────────────────────────────────────────────────────────\n * OnboardingView – Schemas\n * ────────────────────────────────────────────────────────────── */\n\n/*\n * `OnboardingTriggerConditionsSchema` and the `trigger.conditions` field were REMOVED (#1369).\n * They declared `newUsersOnly`, `triggerOnce` and `requiredRoles`, were validated by BOTH\n * specification surfaces, and were read by NOTHING: repo-wide the vocabulary had exactly one\n * producer (the resource-guidance compiler, which emitted a constant) and zero consumers. No\n * application ever authored one.\n *\n * What made it worse than an ignored field is that the behaviour it described DOES happen, by a\n * different mechanism — a flow does not re-trigger, because every status transition refuses from a\n * terminal status via `isTerminalOnboardingStatus`. So an author declaring `triggerOnce: true`\n * observed exactly what they asked for and concluded the field worked. It was falsifiable only in\n * the direction nobody tries: `triggerOnce: false` changed nothing, and an application wanting a\n * flow to re-trigger could not express it and got no error saying so.\n *\n * `requiredRoles` was the dangerous one, because it reads as a GATE. A flow declaring it was shown\n * to everybody. Role gating is real one level up — `GuidanceAudienceSchema.roles`, enforced in\n * `guidance-audience.frontend.utils.ts` — so there were two spellings of one question and only one\n * of them worked.\n *\n * Removed rather than wired, on the same ground as the flow-level `options` block (#1368): each key\n * either duplicates a mechanism that IS enforced (`audience.roles`, and the terminal-status rule\n * that `newUsersOnly` restates) or names a mode that does not exist (`triggerOnce: false`). Making\n * a flow re-trigger is a real capability and deserves to be asked as its own question, against the\n * state that would drive it — not carried as a default nobody could turn off.\n */\n\n/** @wildo_source:part:start saas.models.onboarding-trigger */\n/** Onboarding Trigger Schema - defines when/how an onboarding or guidance flow is activated.\n *  Important runtime note:\n *  - `EVENT` is the only trigger type evaluated by the backend operation pipeline. Its `eventName`\n *    for a resource operation succeeding is `<resourceType>:<operationIdentifier>` — build it from\n *    your resource-type enum and `CoreResourceOperation`, e.g.\n *    `` `${MyModule_ResourceType.PROJECTS}:${CoreResourceOperation.CREATE}` ``.\n *  - `FIRST_VISIT`, `ROUTE_MATCH`, `DELAYED`, and `MANUAL` are frontend/manual concerns.\n *  - A flow shows once per subject: it does not re-trigger after it is completed, skipped or dismissed. */\nexport const OnboardingTriggerSchema = z.object({\n  /** The type of trigger that activates this onboarding */\n  type: z.enum(OnboardingTriggerType).default(OnboardingTriggerType.FIRST_VISIT),\n\n  /** For ROUTE_MATCH: Route pattern to match (regex or glob) */\n  routePattern: z.string().optional(),\n\n  /** For EVENT: Event name to listen for */\n  eventName: z.string().optional(),\n\n  /** For DELAYED: Delay in milliseconds before triggering */\n  delayMs: z.number().positive().optional(),\n});\n/** @wildo_source:part:end saas.models.onboarding-trigger */\n\n/** @wildo_source:part:start saas.frontend.onboarding-view */\n/** Onboarding View Options Schema — the `options` of an onboarding DOCUMENT (guidance flows have none). */\nexport const OnboardingViewOptionsSchema = z.object({\n  showProgress: z.boolean().default(true),\n  allowDismiss: z.boolean().default(true),\n  persistState: z.boolean().default(true),\n  autoStart: z.boolean().default(false),\n  allowSkip: z.boolean().default(true),\n  className: z.string().optional(),\n});\n/** @wildo_source:part:end saas.frontend.onboarding-view */\n\n/** ──────────────────────────────────────────────────────────────\n * OnboardingView – Reusable Config Schemas\n *\n * These config schemas define the type-specific structural/runtime properties\n * for each onboarding element, separated from base identity/state fields.\n * for reuse across packages.\n * ────────────────────────────────────────────────────────────── */\n\n/** @wildo_source:part:start saas.models.onboarding-elements */\n/** Tour Step Schema */\nexport const OnboardingTourStepSchema = z.object({\n  ref: z.string(),\n  order: z.number().int().nonnegative(),\n  placement: z.enum(TourStepPlacement).default(TourStepPlacement.BOTTOM),\n  targetSelector: z.string().optional(),\n  /** Optional resource field name this step targets — resolved to [data-guidance-field=\"...\"] at render time */\n  targetField: z.string().optional(),\n  imageUrl: z.url().optional(),\n  videoUrl: z.url().optional(),\n});\n\n/** Survey Question Schema */\nexport const OnboardingSurveyQuestionSchema = z.object({\n  id: z.string(),\n  ref: z.string().optional(),\n  type: z.enum(OnboardingSurveyQuestionType),\n  options: z.array(z.object({ ref: z.string() })).optional(),\n  required: z.boolean().default(false),\n  /**\n   * The field of the survey's bound resource this answer is written to.\n   *\n   * Omitted, the answer is recorded on the subject's own guidance-state row and nothing else reads\n   * it — which is right for a genuine survey.\n   *\n   * Declared, the answer becomes a value the application owns: it is written through the target\n   * resource's ordinary default `API_CALL` UPDATE, under the ordinary authorization, alongside every\n   * other bound answer in the same submission. It is NOT a second write path — a bound survey is a\n   * form whose fields were asked one at a time.\n   *\n   * It is meaningless without `bindTo` on the survey itself, and the element schema REFUSES that\n   * combination rather than ignoring it.\n   */\n  bindToField: z.string().min(1).optional(),\n});\n\n/**\n * The question types a field binding accepts, because their answer IS the value.\n *\n * The choice types are excluded ON PURPOSE rather than by oversight. An option carries only a\n * `ref`, which is an i18n key — so binding a RADIO, CHECKBOX or SINGLE_CHOICE question would write\n * that key into an application's resource field and store `favouriteColourBlue` where the\n * application expected a colour. Silently, and durably.\n *\n * Refused rather than documented, because a binding that stores the wrong thing is worse than one\n * that does not exist: nothing downstream can tell a key from a value. Admitting the choice types\n * means giving an option a VALUE alongside its ref, which is an additive change to this schema and\n * the natural next step if an application needs it.\n */\nexport const SURVEY_QUESTION_TYPES_WHOSE_ANSWER_IS_A_VALUE: readonly OnboardingSurveyQuestionType[] = [\n  OnboardingSurveyQuestionType.TEXT,\n  OnboardingSurveyQuestionType.TEXTAREA,\n  OnboardingSurveyQuestionType.RATING,\n];\n\n/**\n * Where a survey's answers land, beyond the guidance-state row.\n *\n * ## Why the resource is named once, and the field per question\n *\n * A survey writes ONE row in ONE submission. Naming the resource per question would let a single\n * submit fan out across several resources, which buys nothing an application cannot express with two\n * surveys, and costs partial-failure semantics: three writes, the second refused, and an element\n * that is neither complete nor cleanly incomplete. One resource, one write, one outcome.\n *\n * ## What the target has to be\n *\n * A resource the current subject already has a row of, reachable without naming an id — the shape\n * `userProfiles` has, and the shape an application's own `USERS → <resource>` composition has. The\n * scope parameters are injected by `ScopedResourceRegistryProvider`, exactly as they are for the\n * guidance-state write itself, so the binding never addresses a row by id and cannot reach another\n * subject's data.\n *\n * v1 performs an UPDATE and does not create a missing row. That is a stated limitation rather than a\n * silent one: the write is refused, loudly, and the element does not complete. Create-if-absent is\n * additive and can be added against a real target that needs it.\n */\nexport const OnboardingSurveyBindingSchema = z.object({\n  /** The resource type whose row receives the bound answers. */\n  resourceType: z.string().min(1),\n});\n\n/** Checklist Config Schema - type-specific fields only */\nexport const OnboardingChecklistConfigSchema = z.object({\n  showProgress: z.boolean().default(true),\n});\n\n/** Checklist Item Config Schema - type-specific fields only */\nexport const OnboardingChecklistItemConfigSchema = z.object({\n  actionRef: z.string().optional(),\n});\n\n/** Tour Config Schema - type-specific fields only */\nexport const OnboardingTourConfigSchema = z.object({\n  steps: z.array(OnboardingTourStepSchema).default([]),\n  autoStart: z.boolean().default(false),\n  allowSkip: z.boolean().default(true),\n});\n\n/** Tooltip Config Schema - type-specific fields only */\nexport const OnboardingTooltipConfigSchema = z.object({\n  targetSelector: z.string(),\n  placement: z.enum(TourStepPlacement).default(TourStepPlacement.BOTTOM),\n  showOnce: z.boolean().default(true),\n});\n\n/** Modal Config Schema - type-specific fields only */\nexport const OnboardingModalConfigSchema = z.object({\n  imageUrl: z.url().optional(),\n  videoUrl: z.url().optional(),\n  ctaAction: z.string().optional(),\n  dismissible: z.boolean().default(true),\n});\n\n/** Banner Config Schema - type-specific fields only */\nexport const OnboardingBannerConfigSchema = z.object({\n  variant: z.enum(OnboardingVariant).default(OnboardingVariant.INFO),\n  dismissible: z.boolean().default(true),\n  position: z.enum(OnboardingBannerPosition).default(OnboardingBannerPosition.TOP),\n  actionRef: z.string().optional(),\n});\n\n/** Announcement Config Schema - type-specific fields only */\nexport const OnboardingAnnouncementConfigSchema = z.object({\n  variant: z.enum(OnboardingVariant).default(OnboardingVariant.INFO),\n  dismissible: z.boolean().default(true),\n  icon: z.string().optional(),\n  actionRef: z.string().optional(),\n});\n\n/** Badge Config Schema - type-specific fields only */\nexport const OnboardingBadgeConfigSchema = z.object({\n  icon: z.string().optional(),\n  variant: z.enum(OnboardingBadgeVariant).default(OnboardingBadgeVariant.DEFAULT),\n  color: z.string().optional(),\n  unlocked: z.boolean().default(false),\n  actionRef: z.string().optional(),\n});\n\n/** Card Config Schema - type-specific fields only */\nexport const OnboardingCardConfigSchema = z.object({\n  icon: z.string().optional(),\n  imageUrl: z.url().optional(),\n  variant: z.enum(OnboardingCardVariant).default(OnboardingCardVariant.DEFAULT),\n  actionRef: z.string().optional(),\n});\n\n/** Survey Config Schema - type-specific fields only */\nexport const OnboardingSurveyConfigSchema = z.object({\n  questions: z.array(OnboardingSurveyQuestionSchema).default([]),\n  allowSkip: z.boolean().default(true),\n  /** Where bound answers are written. See {@link OnboardingSurveyBindingSchema}. */\n  bindTo: OnboardingSurveyBindingSchema.optional(),\n});\n\n/**\n * A question may only name a field when its survey names a resource.\n *\n * Refused rather than ignored, because an ignored `bindToField` is the exact defect this capability\n * was built alongside: an author declares where an answer should go, the runtime drops it on the\n * floor, and nothing says so until somebody reads the row and finds it empty.\n *\n * It lives as a standalone function rather than a `.superRefine` on the config schema because that\n * schema's `.shape` is SPREAD into a discriminated-union member, and a refinement wrapper has no\n * `.shape`; and it cannot sit on the union member either, since `z.discriminatedUnion` requires\n * plain object members. So the union applies it, once, for the SURVEY case.\n */\nexport function assertSurveyFieldBindingsHaveATarget(\n  survey: {\n    bindTo?: { resourceType: string };\n    questions: { id: string; type: OnboardingSurveyQuestionType; bindToField?: string }[];\n  },\n  ctx: z.RefinementCtx,\n  pathPrefix: (string | number)[] = [],\n): void {\n  survey.questions.forEach((question, index) => {\n    if (question.bindToField === undefined) return;\n    if (!survey.bindTo) {\n      ctx.addIssue({\n        code: 'custom',\n        path: [...pathPrefix, 'questions', index, 'bindToField'],\n        message:\n          `question \"${question.id}\" declares bindToField \"${question.bindToField}\" but the survey declares no `\n          + 'bindTo.resourceType, so the answer has nowhere to be written. Declare the survey\\'s target resource, '\n          + 'or remove the field binding.',\n      });\n      return;\n    }\n    if (!SURVEY_QUESTION_TYPES_WHOSE_ANSWER_IS_A_VALUE.includes(question.type)) {\n      ctx.addIssue({\n        code: 'custom',\n        path: [...pathPrefix, 'questions', index, 'bindToField'],\n        message:\n          `question \"${question.id}\" is a ${question.type} question and cannot be bound to a field. Its answer is an `\n          + 'option REF, which is an i18n key rather than a value, so writing it to a resource would store the key. '\n          + `Bind a ${SURVEY_QUESTION_TYPES_WHOSE_ANSWER_IS_A_VALUE.join(' / ')} question instead.`,\n      });\n    }\n  });\n}\n\n/** ──────────────────────────────────────────────────────────────\n * OnboardingView – Element Base Schema (for reuse)\n *\n * Contains common fields shared by all onboarding element types.\n * Extracted for reuse across packages.\n * ────────────────────────────────────────────────────────────── */\n\nexport const OnboardingElementBaseSchema = z.object({\n  /** Unique reference for this element */\n  ref: z.string(),\n  /** Element type discriminator */\n  type: z.enum(OnboardingElementType),\n  /** Current status */\n  status: z.enum(OnboardingStatus).default(OnboardingStatus.NOT_STARTED),\n  /** Display order */\n  order: z.number().int().nonnegative(),\n  /** Optional resource field name this element targets — resolved to a CSS selector [data-guidance-field=\"...\"] at render time */\n  targetField: z.string().optional(),\n});\n\nexport type OnboardingElementBase = z.infer<typeof OnboardingElementBaseSchema>;\n\n/** ──────────────────────────────────────────────────────────────\n * OnboardingView – Element Union\n * ────────────────────────────────────────────────────────────── */\n\n/**\n * Typed discriminated union of all onboarding element types.\n * Use this for runtime validation and type inference.\n * Note: Created separately from SchemaFamily to preserve full TypeScript type inference.\n */\nexport const OnboardingElementSchema = z.discriminatedUnion('type', [\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.CHECKLIST),\n    items: z.array(z.string()),\n    ...OnboardingChecklistConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.CHECKLIST_ITEM),\n    completed: z.boolean().default(false),\n    ...OnboardingChecklistItemConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.TOUR),\n    currentStepIndex: z.number().int().nonnegative().default(0),\n    ...OnboardingTourConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.TOOLTIP),\n    ...OnboardingTooltipConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.MODAL),\n    ...OnboardingModalConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.BANNER),\n    ...OnboardingBannerConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.ANNOUNCEMENT),\n    ...OnboardingAnnouncementConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.BADGE),\n    ...OnboardingBadgeConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.CARD),\n    ...OnboardingCardConfigSchema.shape,\n  }),\n  OnboardingElementBaseSchema.extend({\n    type: z.literal(OnboardingElementType.SURVEY),\n    ...OnboardingSurveyConfigSchema.shape,\n  }),\n]).superRefine((element, ctx) => {\n  // The one cross-field rule in this vocabulary, applied where a discriminated union allows it.\n  if (element.type !== OnboardingElementType.SURVEY) return;\n  assertSurveyFieldBindingsHaveATarget(element, ctx);\n});\n/** @wildo_source:part:end saas.models.onboarding-elements */\n\n/*\n * Maintainer note — outside the anchor because it is history. An `OnboardingElementSchemaFamily`\n * (a `createSchemaFamily` re-declaration of the same ten variants) once sat beside the union above\n * and was removed: nothing consumed it, and its own comment admitted the union was the copy that was\n * read. Two hand-maintained declarations of one vocabulary drift on the eleventh element type — keep\n * the union as the only one.\n */\n\n/** ──────────────────────────────────────────────────────────────\n * Onboarding – Type Definitions\n * ────────────────────────────────────────────────────────────── */\n\nexport type OnboardingTrigger = z.infer<typeof OnboardingTriggerSchema>;\nexport type OnboardingViewOptions = z.infer<typeof OnboardingViewOptionsSchema>;\nexport type OnboardingTourStep = z.infer<typeof OnboardingTourStepSchema>;\nexport type OnboardingSurveyQuestion = z.infer<typeof OnboardingSurveyQuestionSchema>;\nexport type OnboardingElement = z.infer<typeof OnboardingElementSchema>;\n\n/** Config schema types */\nexport type OnboardingChecklistConfig = z.infer<typeof OnboardingChecklistConfigSchema>;\nexport type OnboardingChecklistItemConfig = z.infer<typeof OnboardingChecklistItemConfigSchema>;\nexport type OnboardingTourConfig = z.infer<typeof OnboardingTourConfigSchema>;\nexport type OnboardingTooltipConfig = z.infer<typeof OnboardingTooltipConfigSchema>;\nexport type OnboardingModalConfig = z.infer<typeof OnboardingModalConfigSchema>;\nexport type OnboardingBannerConfig = z.infer<typeof OnboardingBannerConfigSchema>;\nexport type OnboardingAnnouncementConfig = z.infer<typeof OnboardingAnnouncementConfigSchema>;\nexport type OnboardingBadgeConfig = z.infer<typeof OnboardingBadgeConfigSchema>;\nexport type OnboardingCardConfig = z.infer<typeof OnboardingCardConfigSchema>;\nexport type OnboardingSurveyConfig = z.infer<typeof OnboardingSurveyConfigSchema>;\n\n/**\n * Individual element variant types - extracted from OnboardingElement discriminated union.\n */\nexport type OnboardingChecklistElement = Extract<OnboardingElement, { type: OnboardingElementType.CHECKLIST }>;\nexport type OnboardingChecklistItemElement = Extract<OnboardingElement, { type: OnboardingElementType.CHECKLIST_ITEM }>;\nexport type OnboardingTourElement = Extract<OnboardingElement, { type: OnboardingElementType.TOUR }>;\nexport type OnboardingTooltipElement = Extract<OnboardingElement, { type: OnboardingElementType.TOOLTIP }>;\nexport type OnboardingModalElement = Extract<OnboardingElement, { type: OnboardingElementType.MODAL }>;\nexport type OnboardingBannerElement = Extract<OnboardingElement, { type: OnboardingElementType.BANNER }>;\nexport type OnboardingAnnouncementElement = Extract<OnboardingElement, { type: OnboardingElementType.ANNOUNCEMENT }>;\nexport type OnboardingBadgeElement = Extract<OnboardingElement, { type: OnboardingElementType.BADGE }>;\nexport type OnboardingCardElement = Extract<OnboardingElement, { type: OnboardingElementType.CARD }>;\nexport type OnboardingSurveyElement = Extract<OnboardingElement, { type: OnboardingElementType.SURVEY }>;\n\n"]}

package/dist/esm/config/registration-acquisition-policy.shared.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registration-acquisition-policy.shared.utils.d.ts","sourceRoot":"","sources":["../../../src/config/registration-acquisition-policy.shared.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,gBAAgB,EACjB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAElF;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAwCT;AAED,MAAM,WAAW,6BAA6B;IAC5C,wEAAwE;IACxE,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,gFAAgF;IAChF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,GAAG,SAAS,EAC7E,kBAAkB,EAAE,SAAS,MAAM,EAAE,EACrC,gBAAgB,EAAE,SAAS,MAAM,EAAE,EACnC,OAAO,EAAE,8BAA8B,GACtC,6BAA6B,CAe/B"}
+{"version":3,"file":"registration-acquisition-policy.shared.utils.d.ts","sourceRoot":"","sources":["../../../../src/config/registration-acquisition-policy.shared.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,gBAAgB,EACjB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAElF;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAwCT;AAED,MAAM,WAAW,6BAA6B;IAC5C,wEAAwE;IACxE,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,gFAAgF;IAChF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,GAAG,SAAS,EAC7E,kBAAkB,EAAE,SAAS,MAAM,EAAE,EACrC,gBAAgB,EAAE,SAAS,MAAM,EAAE,EACnC,OAAO,EAAE,8BAA8B,GACtC,6BAA6B,CAe/B"}

package/dist/esm/config-authoring.entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-authoring.entry.d.ts","sourceRoot":"","sources":["../../src/config-authoring.entry.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yDAAyD,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EACL,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,4BAA4B,EAC5B,KAAK,sBAAsB,EAC3B,iCAAiC,EACjC,KAAK,2BAA2B,EAChC,iDAAiD,EACjD,KAAK,0CAA0C,GAChD,MAAM,wDAAwD,CAAC"}
+{"version":3,"file":"config-authoring.entry.d.ts","sourceRoot":"","sources":["../../../src/config-authoring.entry.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yDAAyD,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EACL,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,4BAA4B,EAC5B,KAAK,sBAAsB,EAC3B,iCAAiC,EACjC,KAAK,2BAA2B,EAChC,iDAAiD,EACjD,KAAK,0CAA0C,GAChD,MAAM,wDAAwD,CAAC"}

package/dist/esm/crdt/crdt-merge.shared.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crdt-merge.shared.utils.d.ts","sourceRoot":"","sources":["../../../src/crdt/crdt-merge.shared.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAG3E;;;;;;;GAOG;AACH,oBAAY,oBAAoB;IAC9B,QAAQ,aAAa;IACrB,QAAQ,aAAa;CACtB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAEnG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAUlF;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,GAAE,OAAc,GAAG,WAAW,CAAC,MAAM,CAAC,CAqBxG"}
+{"version":3,"file":"crdt-merge.shared.utils.d.ts","sourceRoot":"","sources":["../../../../src/crdt/crdt-merge.shared.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAG3E;;;;;;;GAOG;AACH,oBAAY,oBAAoB;IAC9B,QAAQ,aAAa;IACrB,QAAQ,aAAa;CACtB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAEnG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAUlF;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,GAAE,OAAc,GAAG,WAAW,CAAC,MAAM,CAAC,CAqBxG"}

package/dist/esm/data-seeding/data-seeding-config.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-seeding-config.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/data-seeding/data-seeding-config.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;iBAwDlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"data-seeding-config.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/data-seeding/data-seeding-config.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;iBAwDlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}