@appinternalleads/ui 0.2.0

package/dist/esm/components/onboarding/shared/actions-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions-data.js","sourceRoot":"","sources":["../../../../../src/components/onboarding/shared/actions-data.ts"],"names":[],"mappings":"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"}

package/dist/esm/components/onboarding/shared/actions.d.ts

@@ -0,0 +1,20 @@
+import type { OnboardingOutcome } from './mock';
+/**
+ * **Button actions — custom functions for any button, with a fallback.** Every button that does
+ * work runs a named operation (`confirm`, `save`, `publish`…); the rest report an event
+ * (`onContinue`, `onSkip`…); the error state's Retry runs `reload`. A host — or an agent — can
+ * attach an action to any of them. For an operation the order is:
+ *
+ *   1. `operations.<id>` — the host's own code, as always;
+ *   2. `actions.<id>` — a function, or a JSON spec an agent can send;
+ *   3. `onButtonButtonAction(id, request)` — one catch-all for every button operation;
+ *   4. the built-in demo — what runs today when nothing is given.
+ *
+ * An event action runs after the component's own callback. Whatever an action does, the component
+ * keeps its own states: an action that fails (throws, answers `{ ok: false }`, a webhook's non-2xx)
+ * ends as the component's failed state, with Retry.
+ */
+import type { ButtonAction, ButtonActionContext } from './actions-data';
+/** Run one action — the same for an operation, an event or Retry. Never throws: a failure is `{ ok: false, message }`. */
+export declare function runButtonAction(action: ButtonAction, request: unknown, ctx: ButtonActionContext): Promise<OnboardingOutcome>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/esm/components/onboarding/shared/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../../src/components/onboarding/shared/actions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAgBxE,0HAA0H;AAC1H,wBAAsB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAIlI"}

package/dist/esm/components/onboarding/shared/actions.js

@@ -0,0 +1,69 @@
+'use client';
+import { Linking } from 'react-native';
+const wait = (ms, signal) => new Promise((res, rej) => {
+    if (!ms) {
+        res();
+        return;
+    }
+    const t = setTimeout(res, ms);
+    signal.addEventListener('abort', () => { clearTimeout(t); rej(Object.assign(new Error('Aborted'), { name: 'AbortError' })); }, { once: true });
+});
+/** A function's answer, as an outcome. An object with `ok` is passed through (a data operation's result). */
+function outcome(v) {
+    if (v === undefined || v === null || v === true)
+        return { ok: true };
+    if (v === false)
+        return { ok: false };
+    if (typeof v === 'object' && typeof v.ok === 'boolean')
+        return v;
+    return { ok: true };
+}
+/** Run one action — the same for an operation, an event or Retry. Never throws: a failure is `{ ok: false, message }`. */
+export async function runButtonAction(action, request, ctx) {
+    const done = await run(action, request, ctx);
+    if (done.ok)
+        ctx.onProgress?.(1); /* a progress operation (an upload) finishes at 100% */
+    return done;
+}
+async function run(action, request, ctx) {
+    try {
+        if (typeof action === 'function')
+            return outcome(await action(request, ctx));
+        switch (action.type) {
+            case 'succeed':
+                await wait(action.delayMs ?? 0, ctx.signal);
+                return { ok: true, ...(action.message ? { message: action.message } : {}) };
+            case 'fail':
+                await wait(action.delayMs ?? 0, ctx.signal);
+                return { ok: false, message: action.message };
+            case 'link':
+                await Linking.openURL(action.url);
+                return { ok: true };
+            case 'post-message': {
+                const w = globalThis.window;
+                w?.parent?.postMessage({ source: 'comppack', component: ctx.component, action: ctx.action, request }, action.targetOrigin ?? '*');
+                return { ok: true };
+            }
+            case 'webhook': {
+                const method = action.method ?? 'POST';
+                const res = await fetch(action.url, {
+                    method,
+                    headers: { 'content-type': 'application/json', ...action.headers },
+                    body: method === 'GET' ? undefined : JSON.stringify({ component: ctx.component, action: ctx.action, request }),
+                    signal: ctx.signal,
+                });
+                if (!res.ok)
+                    return { ok: false, message: `The server answered ${res.status}.` };
+                const body = await res.json().catch(() => null);
+                return body && typeof body === 'object' && typeof body.ok === 'boolean' ? body : { ok: true };
+            }
+            default: return { ok: false, message: 'Unknown action.' };
+        }
+    }
+    catch (err) {
+        if (err.name === 'AbortError')
+            throw err;
+        return { ok: false, message: err.message || 'The action failed.' };
+    }
+}
+//# sourceMappingURL=actions.js.map

package/dist/esm/components/onboarding/shared/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../../../src/components/onboarding/shared/actions.ts"],"names":[],"mappings":"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"}

package/dist/esm/components/onboarding/shared/contract.d.ts

@@ -0,0 +1,114 @@
+import type { DataType } from '../../../tokens';
+import type { IconName } from '../../../core';
+/**
+ * **What the seven onboarding components share — `onboarding/1`.**
+ *
+ * Source: `design_handoff_onboarding_components` (README "Recommended implementation shape";
+ * `solarium-design-prd-7-components.md` overrides it where they conflict). Each component is
+ * written ONCE and configured by a plain `config` object; its five case studies are presets of that
+ * object and nothing else — the ThresholdFlow pattern.
+ *
+ * Merge order, verbatim from the handoff: `BASE_COPY ← BASE ← CASES[preset] ← config`, shallow —
+ * a case that changes `sources` replaces the whole list, never merges into it.
+ *
+ * **What is NOT config, on purpose.** Pattern status (loading / empty / error), the async result,
+ * density and the demo boards' `scene` are the host's runtime or presentation choices; a restored
+ * session is an `initial` seed. A config that carried them would render the same component
+ * differently depending on where it was saved from.
+ */
+export declare const ONBOARDING_SCHEMA: "onboarding/1";
+export declare const ONBOARDING_COMPONENTS: readonly ["brand-kit", "budget-allocation", "calendar-sync", "carousel", "contact-import", "dashboard-config", "export-format", "setup-tasks", "cicd-setup", "completion", "department-setup", "help-center", "permissions-setup", "plan-selection", "quick-actions", "rate-limit", "seat-allocation", "status-page", "tag-creation", "terms-consent", "trial-countdown", "two-factor", "achievement", "event-reminder", "file-shared", "filter-panel", "floating", "mark-read", "password-expiry", "payment-alert", "onboarding-step", "queue-status", "shipping-update", "id-verification", "table", "grid", "combobox", "tabbed", "fallback", "budget-tracker", "ab-tests", "conversion-funnel", "expandable-feed", "score-summary", "criteria-spider", "activity-heatmap", "tag-cloud", "receipt-printer"];
+export type OnboardingComponent = (typeof ONBOARDING_COMPONENTS)[number];
+export declare const PRESETS: readonly ["case1", "case2", "case3", "case4", "case5", "case6"];
+export type OnboardingPreset = (typeof PRESETS)[number];
+/**
+ * **The case studies one component actually has, in order.** Batches 1–3 have five each; batch 4's
+ * Tabbed, Fallback and C14 have three (the handoff's own count). Every list of a component's case
+ * studies reads this, never `PRESETS`, so a three-case component never shows an empty fourth board.
+ */
+export declare function presetsOf(p: {
+    cases: Partial<Record<OnboardingPreset, unknown>>;
+}): OnboardingPreset[];
+/** The shell's pattern status (S1) — the host's loading of the step, not the component's own action. */
+export type PatternStatus = 'ready' | 'loading' | 'empty' | 'error';
+/** A save-style action's lifecycle — Brand Kit, Budget, Dashboard, Export. */
+export type SavePhase = 'idle' | 'saving' | 'saved' | 'failed';
+/** How the component's one async action turns out, when a host wants to force it (demo, test). */
+export type OnboardingResult = 'success' | 'error';
+/** Case-study copy for the demo boards and the site — eyebrow, title, one-line scenario. */
+export type CaseMeta = {
+    eyebrow: string;
+    title: string;
+    scenario: string;
+};
+/** The copy every component's load states share. */
+export type LoadCopy = {
+    loadErrorTitle: string;
+    loadErrorBody: string;
+    retryLabel: string;
+    emptyTitle: string;
+    emptyBody: string;
+    emptyCta: string;
+};
+/** The header every component draws: a 32px tile, a title, a subtitle. */
+export type HeaderConfig = {
+    /** Resolves the tile's hue through `TYPE_HUE`. */
+    type: DataType;
+    /** A handoff icon name — `iconFor` resolves it. */
+    icon: string;
+    title: string;
+    subtitle: string;
+};
+/**
+ * One component's presets file — `presets.json` next to its code, the single source of its data.
+ * `cases` and `meta` list case1… in order; iterate them with `presetsOf`, since not every component
+ * has five.
+ */
+export type PresetsFile<C> = {
+    component: OnboardingComponent;
+    baseCopy?: Partial<C>;
+    base: C;
+    cases: Record<OnboardingPreset, Partial<C>>;
+    meta: Record<OnboardingPreset, CaseMeta>;
+};
+/** `BASE_COPY ← BASE ← CASES[preset] ← config`, shallow. */
+export declare function resolveConfig<C extends object>(p: PresetsFile<C>, preset?: OnboardingPreset, config?: Partial<C>): C;
+/**
+ * **"What the config changes"** — the keys a resolved config sets differently from the default,
+ * in the order the preset names them. Generated, never hand-written: the site's case-study panel
+ * reads this, so a preset edit is reflected without touching a page.
+ */
+export declare function configChanges<C extends object>(p: PresetsFile<C>, preset: OnboardingPreset): {
+    key: string;
+    value: unknown;
+}[];
+/** A config value as the panel prints it: lists by name or count, objects as their fields. */
+export declare function describeValue(v: unknown): string;
+/** `{source}`-style placeholders in copy. */
+export declare function fill(template: string, values: Record<string, string | number>): string;
+/** A config problem. The view refuses to render an invalid config and says why. */
+export type OnboardingIssue = {
+    path: string;
+    message: string;
+};
+/**
+ * **The handoff's icon names** (the `ICONS` objects in the prototypes) — what a config may name.
+ * `iconFor` maps them onto `core/Icon`'s glyph names; those that differ are aliased below
+ * and an unknown name falls back to `spark`, as the prototypes do.
+ */
+export declare const ONBOARDING_ICONS: readonly ["alert", "bell", "bolt", "briefcase", "building", "calendar", "camera", "cash", "chart", "chat", "clock", "code", "compass", "contacts", "db", "doc", "download", "eye", "file", "flame", "flask", "globe", "grid", "headset", "hourglass", "inbox", "key", "layers", "layout", "lifebuoy", "link", "mail", "megaphone", "monitor", "palette", "pen", "phone", "pie", "pin", "plane", "pulse", "receipt", "refresh", "rocket", "search", "server", "shield", "smile", "spark", "sparkle", "table", "tag", "target", "tasks", "ticket", "trend", "upload", "user", "users", "utensils", "video", "wallet", "bellRing", "book", "box", "card", "cart", "checkCircle", "external", "flag", "folder", "git", "handshake", "hardDrive", "image", "laptop", "lock", "map", "mic", "pencil", "play", "printer", "question", "template", "terminal", "truck", "webhook", "wifi", "check2", "filter", "send", "star", "trophy", "userCheck", "receiptX", "cloud"];
+export type OnboardingIcon = (typeof ONBOARDING_ICONS)[number];
+export declare function iconFor(name: string): IconName;
+/**
+ * **A demo-board scene as props** — the one mapping stories, the site's state switcher and the
+ * playground all use. `loading` / `empty` / `error` are the host's pattern status; every other
+ * scene is an `initial` seed; `default` is the case as it ships. `hold` says the scene is an
+ * operation in flight (Saving…, Connecting…): a board that wants it to stay put passes a
+ * `holdOperation()` — the README's `scene` prop is demo-only and is not shipped.
+ */
+export declare function sceneProps<C, Seed, S extends string>(config: C, scene: S | 'loading' | 'empty' | 'error', seedOf: (config: C, scene: S) => Seed, inFlight: readonly string[]): {
+    status?: PatternStatus;
+    initial?: Seed;
+    hold: boolean;
+};
+//# sourceMappingURL=contract.d.ts.map

package/dist/esm/components/onboarding/shared/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../../../src/components/onboarding/shared/contract.ts"],"names":[],"mappings":"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"}

package/dist/esm/components/onboarding/shared/contract.js

@@ -0,0 +1,125 @@
+/**
+ * **What the seven onboarding components share — `onboarding/1`.**
+ *
+ * Source: `design_handoff_onboarding_components` (README "Recommended implementation shape";
+ * `solarium-design-prd-7-components.md` overrides it where they conflict). Each component is
+ * written ONCE and configured by a plain `config` object; its five case studies are presets of that
+ * object and nothing else — the ThresholdFlow pattern.
+ *
+ * Merge order, verbatim from the handoff: `BASE_COPY ← BASE ← CASES[preset] ← config`, shallow —
+ * a case that changes `sources` replaces the whole list, never merges into it.
+ *
+ * **What is NOT config, on purpose.** Pattern status (loading / empty / error), the async result,
+ * density and the demo boards' `scene` are the host's runtime or presentation choices; a restored
+ * session is an `initial` seed. A config that carried them would render the same component
+ * differently depending on where it was saved from.
+ */
+export const ONBOARDING_SCHEMA = 'onboarding/1';
+export const ONBOARDING_COMPONENTS = [
+    'brand-kit', 'budget-allocation', 'calendar-sync', 'carousel', 'contact-import', 'dashboard-config', 'export-format',
+    /* Batch 2 (design_handoff_onboarding_components_batch2, 2026-09-25). */
+    'setup-tasks', 'cicd-setup', 'completion', 'department-setup', 'help-center', 'permissions-setup', 'plan-selection',
+    'quick-actions', 'rate-limit', 'seat-allocation', 'status-page', 'tag-creation', 'terms-consent', 'trial-countdown', 'two-factor',
+    /* Batch 3 — notification + verification (design_handoff_notification_components_batch3, 2026-09-25). */
+    'achievement', 'event-reminder', 'file-shared', 'filter-panel', 'floating', 'mark-read', 'password-expiry',
+    'payment-alert', 'onboarding-step', 'queue-status', 'shipping-update', 'id-verification',
+    /* Batch 4 — data views, output containers and C14 (design_handoff_data_components_batch4, 2026-09-25). */
+    'table', 'grid', 'combobox', 'tabbed', 'fallback',
+    /* Batch 5 — data-viz dashboards (design_handoff_dataviz_batch5, 2026-09-26). M15 data reveal. */
+    'budget-tracker', 'ab-tests', 'conversion-funnel',
+    /* Batch 6 — reviews & insight (design_handoff_insights_batch6, 2026-09-26). M15 data reveal; M16 shape morph. */
+    'expandable-feed', 'score-summary', 'criteria-spider', 'activity-heatmap', 'tag-cloud',
+    /* Receipt Printer (2026-09-27) — the first New component animated with Rive (rive/receipt-printer). */
+    'receipt-printer',
+];
+/* Table has a sixth — batch 5's Content Performance. `presetsOf` lists only what a component has. */
+export const PRESETS = ['case1', 'case2', 'case3', 'case4', 'case5', 'case6'];
+/**
+ * **The case studies one component actually has, in order.** Batches 1–3 have five each; batch 4's
+ * Tabbed, Fallback and C14 have three (the handoff's own count). Every list of a component's case
+ * studies reads this, never `PRESETS`, so a three-case component never shows an empty fourth board.
+ */
+export function presetsOf(p) {
+    return PRESETS.filter(k => k in p.cases);
+}
+/** `BASE_COPY ← BASE ← CASES[preset] ← config`, shallow. */
+export function resolveConfig(p, preset, config) {
+    return { ...(p.baseCopy ?? {}), ...p.base, ...(preset ? p.cases[preset] ?? {} : {}), ...(config ?? {}) };
+}
+/**
+ * **"What the config changes"** — the keys a resolved config sets differently from the default,
+ * in the order the preset names them. Generated, never hand-written: the site's case-study panel
+ * reads this, so a preset edit is reflected without touching a page.
+ */
+export function configChanges(p, preset) {
+    const base = resolveConfig(p);
+    const resolved = resolveConfig(p, preset);
+    return Object.keys(p.cases[preset] ?? {})
+        .filter(k => JSON.stringify(base[k]) !== JSON.stringify(resolved[k]))
+        .map(k => ({ key: k, value: resolved[k] }));
+}
+/** A config value as the panel prints it: lists by name or count, objects as their fields. */
+export function describeValue(v) {
+    if (Array.isArray(v)) {
+        const names = v.map(x => (typeof x === 'object' && x !== null
+            ? String(x.label ?? x.name ?? x.title ?? '')
+            : String(x))).filter(Boolean);
+        return names.length === v.length ? names.join(', ') : `${v.length} items`;
+    }
+    if (typeof v === 'object' && v !== null)
+        return Object.entries(v).map(([k, x]) => `${k}: ${Array.isArray(x) ? x.join(', ') : String(x)}`).join(' · ');
+    return String(v);
+}
+/** `{source}`-style placeholders in copy. */
+export function fill(template, values) {
+    return template.replace(/\{(\w+)\}/g, (m, k) => (k in values ? String(values[k]) : m));
+}
+/**
+ * **The handoff's icon names** (the `ICONS` objects in the prototypes) — what a config may name.
+ * `iconFor` maps them onto `core/Icon`'s glyph names; those that differ are aliased below
+ * and an unknown name falls back to `spark`, as the prototypes do.
+ */
+export const ONBOARDING_ICONS = [
+    'alert', 'bell', 'bolt', 'briefcase', 'building', 'calendar', 'camera', 'cash', 'chart', 'chat', 'clock', 'code',
+    'compass', 'contacts', 'db', 'doc', 'download', 'eye', 'file', 'flame', 'flask', 'globe', 'grid', 'headset',
+    'hourglass', 'inbox', 'key', 'layers', 'layout', 'lifebuoy', 'link', 'mail', 'megaphone', 'monitor', 'palette', 'pen',
+    'phone', 'pie', 'pin', 'plane', 'pulse', 'receipt', 'refresh', 'rocket', 'search', 'server', 'shield', 'smile',
+    'spark', 'sparkle', 'table', 'tag', 'target', 'tasks', 'ticket', 'trend', 'upload', 'user', 'users', 'utensils',
+    'video', 'wallet',
+    /* Batch 2. */
+    'bellRing', 'book', 'box', 'card', 'cart', 'checkCircle', 'external', 'flag', 'folder', 'git', 'handshake', 'hardDrive',
+    'image', 'laptop', 'lock', 'map', 'mic', 'pencil', 'play', 'printer', 'question', 'template', 'terminal', 'truck',
+    'webhook', 'wifi',
+    /* Batch 3. */
+    'check2', 'filter', 'send', 'star', 'trophy', 'userCheck',
+    /* Batch 4. */
+    'receiptX',
+    /* Batch 5. */
+    'cloud',
+];
+const ICON_ALIAS = {
+    cloud: 'cloud-up',
+    sparkle: 'spark', smile: 'emoji', db: 'data', pin: 'map-pin',
+    bellRing: 'bell-ringing', checkCircle: 'check', hardDrive: 'hard-drive', image: 'media', pencil: 'edit',
+    check2: 'check', filter: 'funnel', userCheck: 'user-check', receiptX: 'receipt-x',
+};
+export function iconFor(name) {
+    if (ONBOARDING_ICONS.includes(name))
+        return ICON_ALIAS[name] ?? name;
+    return 'spark';
+}
+/**
+ * **A demo-board scene as props** — the one mapping stories, the site's state switcher and the
+ * playground all use. `loading` / `empty` / `error` are the host's pattern status; every other
+ * scene is an `initial` seed; `default` is the case as it ships. `hold` says the scene is an
+ * operation in flight (Saving…, Connecting…): a board that wants it to stay put passes a
+ * `holdOperation()` — the README's `scene` prop is demo-only and is not shipped.
+ */
+export function sceneProps(config, scene, seedOf, inFlight) {
+    if (scene === 'loading' || scene === 'empty' || scene === 'error')
+        return { status: scene, hold: false };
+    if (scene === 'default')
+        return { hold: false };
+    return { initial: seedOf(config, scene), hold: inFlight.includes(scene) };
+}
+//# sourceMappingURL=contract.js.map

package/dist/esm/components/onboarding/shared/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../../../src/components/onboarding/shared/contract.ts"],"names":[],"mappings":"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"}

package/dist/esm/components/onboarding/shared/guard.d.ts

@@ -0,0 +1,46 @@
+import { type ComponentType } from 'react';
+import { type OnboardingPreset, type PresetsFile } from './contract';
+import { type ButtonActions } from './actions-data';
+/**
+ * **Every onboarding component, guarded.** Two nets under the component's own validator:
+ *
+ * 1. **Before rendering** — the config's kinds are held to the presets' (`shapeIssues`); a wrong
+ *    kind is refused with the same "This step can't be shown" card the validator uses, naming the
+ *    field. A key set to `undefined` is left alone: it unsets the preset's value, as it always has.
+ * 2. **While rendering** — anything that still throws is caught here, shown as that card, and
+ *    handed to `onError` for the host's logging. The rest of the page keeps working. A new config,
+ *    preset, seed or status tries again.
+ *
+ * Operations that throw or reject never reach here: they end as the component's own failed state,
+ * with Retry.
+ */
+export type GuardProps = {
+    /** A render error the component could not show — for the host's error reporting. */
+    onError?: (error: Error) => void;
+    /**
+     * Custom actions for the buttons — by operation id (\`confirm\`), event (\`onSkip\`) or \`reload\`
+     * (the error state's Retry). A function, or JSON an agent can send (\`{ type: 'webhook', url }\`).
+     * Used where \`operations\` has none; see \`shared/actions\`.
+     */
+    actions?: ButtonActions;
+    /** One catch-all for every button operation that has neither an operation nor an action. (Not `onAction`: Floating has its own.) */
+    onButtonAction?: (action: string, request: unknown, ctx: {
+        signal: AbortSignal;
+        component: string;
+    }) => unknown;
+};
+type Base = {
+    preset?: OnboardingPreset;
+    config?: object;
+    testID?: string;
+    initial?: unknown;
+    status?: unknown;
+    operations?: object;
+    reload?: unknown;
+};
+export declare function guarded<P extends Base>(View: ComponentType<P>, presets: PresetsFile<object>, name: string): {
+    ({ onError, actions, onButtonAction, ...props }: P & GuardProps): import("react").JSX.Element;
+    displayName: string;
+};
+export {};
+//# sourceMappingURL=guard.d.ts.map

package/dist/esm/components/onboarding/shared/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../../../src/components/onboarding/shared/guard.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,aAAa,EAAkB,MAAM,OAAO,CAAC;AAEvF,OAAO,EAAiB,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAGpF,OAAO,EAAuD,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIzG;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,UAAU,GAAG;IACvB,oFAAoF;IACpF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,oIAAoI;IACpI,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;CACjH,CAAC;AAEF,KAAK,IAAI,GAAG;IAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAExJ,wBAAgB,OAAO,CAAC,CAAC,SAAS,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM;qDAEvC,CAAC,GAAG,UAAU;;EAchF"}

package/dist/esm/components/onboarding/shared/guard.js

@@ -0,0 +1,85 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Component, useMemo, useRef } from 'react';
+import { BlockCard, Callout } from '../../../ds';
+import { resolveConfig } from './contract';
+import { InvalidConfig } from './InvalidConfig';
+import { shapeIssues } from './shape';
+import { ONBOARDING_BUTTONS, actionIssues } from './actions-data';
+import { runButtonAction } from './actions';
+export function guarded(View, presets, name) {
+    const component = presets.component;
+    function Guarded({ onError, actions, onButtonAction, ...props }) {
+        const issues = useMemo(() => [...shapeIssues(presets, props.config), ...actionIssues(component, actions)], [props.config, actions]);
+        const wired = useButtonActions(component, props, actions, onButtonAction);
+        const title = resolveConfig(presets, props.preset).title;
+        const heading = typeof title === 'string' ? title : undefined;
+        if (issues.length)
+            return _jsx(InvalidConfig, { title: heading, issues: issues, testID: props.testID });
+        return (_jsx(RenderNet, { title: heading, testID: props.testID, onError: onError, resetOn: [props.preset, props.config, props.initial, props.status], children: _jsx(View, { ...props, ...wired }) }));
+    }
+    Guarded.displayName = name;
+    return Guarded;
+}
+class RenderNet extends Component {
+    state = { error: null };
+    static getDerivedStateFromError(error) {
+        return { error: error instanceof Error ? error : new Error(String(error)) };
+    }
+    componentDidCatch(error) {
+        this.props.onError?.(error instanceof Error ? error : new Error(String(error)));
+    }
+    componentDidUpdate(prev) {
+        if (this.state.error && prev.resetOn.some((v, i) => v !== this.props.resetOn[i]))
+            this.setState({ error: null });
+    }
+    render() {
+        if (!this.state.error)
+            return this.props.children;
+        return (_jsx(BlockCard, { title: this.props.title || 'Onboarding step', testID: this.props.testID, children: _jsx(Callout, { alert: true, title: "This step can\u2019t be shown", children: `Something in its data could not be displayed (${this.state.error.message}). Check the config.` }) }));
+    }
+}
+/**
+ * **Actions into the props the component already has.** Operations the host did not give are made
+ * from \`actions\` (then \`onButtonAction\`, for button operations); \`reload\` likewise; event actions run
+ * after the component's own callback. Nothing is added when nothing is asked for, so the built-in
+ * demo stays the last fallback. Stable across renders unless the actions change.
+ */
+function useButtonActions(component, props, actions, onAction) {
+    const latest = useRef(props);
+    latest.current = props;
+    const hostOps = props.operations;
+    const hostReload = props.reload;
+    return useMemo(() => {
+        if (!actions && !onAction)
+            return {};
+        const as = (action, id) => (request, ctx) => runButtonAction(action, request, { ...ctx, component, action: id });
+        const out = {};
+        const made = {};
+        for (const op of ONBOARDING_BUTTONS[component]?.operations ?? []) {
+            if (hostOps?.[op.id])
+                continue;
+            const a = actions?.[op.id];
+            if (a)
+                made[op.id] = as(a, op.id);
+            else if (onAction && !op.data)
+                made[op.id] = as((r, c) => onAction(op.id, r, { signal: c.signal, component }), op.id);
+        }
+        if (Object.keys(made).length)
+            out.operations = { ...hostOps, ...made };
+        if (!hostReload && actions?.reload)
+            out.reload = as(actions.reload, 'reload');
+        for (const [id, a] of Object.entries(actions ?? {})) {
+            if (!/^on[A-Z]/.test(id))
+                continue;
+            out[id] = (...args) => {
+                latest.current[id]?.(...args);
+                void runButtonAction(a, args.length === 1 ? args[0] : args, { signal: new AbortController().signal, component, action: id })
+                    .then(r => { if (!r.ok)
+                    console.warn(`[comppack] ${component} ${id}: ${r.message ?? 'the action failed'}`); });
+            };
+        }
+        return out;
+    }, [actions, onAction, hostOps, hostReload]);
+}
+//# sourceMappingURL=guard.js.map

package/dist/esm/components/onboarding/shared/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../../../../src/components/onboarding/shared/guard.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/onboarding/shared/index.d.ts

@@ -0,0 +1,11 @@
+export { ONBOARDING_COMPONENTS, ONBOARDING_ICONS, ONBOARDING_SCHEMA, PRESETS, configChanges, describeValue, fill, iconFor, presetsOf, resolveConfig, sceneProps, type CaseMeta, type HeaderConfig, type LoadCopy, type OnboardingComponent, type OnboardingIcon, type OnboardingIssue, type OnboardingPreset, type OnboardingResult, type PatternStatus, type PresetsFile, type SavePhase, } from './contract';
+export { ONBOARDING_TIMING, createMockOperation, createMockProgressOperation, holdOperation, mockReload, type MockOperationOptions, type OnboardingOperation, type OnboardingOutcome, type ProgressOperation, } from './mock';
+export { runOutcome, useDefaultOperation, usePatternStatus, useSceneReport, useSeededReducer } from './runtime';
+export { FieldLabel, OnboardingCard, type FooterButton, type OnboardingCardProps } from './OnboardingCard';
+export { InvalidConfig } from './InvalidConfig';
+export { BusyGhost, CopyField, CrossFadeText, ExpandRegion, Hidden, HueTile, MintCheck, PlainChip, RevealRow, Slot, Spinner, StatusMark, UnreadDot } from './parts';
+export { guarded, type GuardProps } from './guard';
+export { shapeIssues } from './shape';
+export { BUTTON_ACTION_TYPES, ONBOARDING_BUTTONS, actionIssues, type ButtonAction, type ButtonActionContext, type ButtonActionFn, type ButtonActionSpec, type ButtonActions } from './actions-data';
+export { runButtonAction } from './actions';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/onboarding/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/onboarding/shared/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,OAAO,EACnE,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EACjF,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,KAAK,mBAAmB,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EACpH,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,GACnG,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,aAAa,EAAE,UAAU,EAC9F,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,GACpG,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3G,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpK,OAAO,EAAE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpM,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/esm/components/onboarding/shared/index.js

@@ -0,0 +1,12 @@
+export { ONBOARDING_COMPONENTS, ONBOARDING_ICONS, ONBOARDING_SCHEMA, PRESETS, configChanges, describeValue, fill, iconFor, presetsOf, resolveConfig, sceneProps, } from './contract';
+export { ONBOARDING_TIMING, createMockOperation, createMockProgressOperation, holdOperation, mockReload, } from './mock';
+export { runOutcome, useDefaultOperation, usePatternStatus, useSceneReport, useSeededReducer } from './runtime';
+export { FieldLabel, OnboardingCard } from './OnboardingCard';
+export { InvalidConfig } from './InvalidConfig';
+export { BusyGhost, CopyField, CrossFadeText, ExpandRegion, Hidden, HueTile, MintCheck, PlainChip, RevealRow, Slot, Spinner, StatusMark, UnreadDot } from './parts';
+export { guarded } from './guard';
+export { shapeIssues } from './shape';
+/* The data half (server-importable) and the runner (React Native's Linking) — separate modules, so a server can read the buttons. */
+export { BUTTON_ACTION_TYPES, ONBOARDING_BUTTONS, actionIssues } from './actions-data';
+export { runButtonAction } from './actions';
+//# sourceMappingURL=index.js.map

package/dist/esm/components/onboarding/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/components/onboarding/shared/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,OAAO,EACnE,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,GAGlF,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,aAAa,EAAE,UAAU,GAE/F,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,cAAc,EAA+C,MAAM,kBAAkB,CAAC;AAC3G,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpK,OAAO,EAAE,OAAO,EAAmB,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,qIAAqI;AACrI,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,YAAY,EAA+G,MAAM,gBAAgB,CAAC;AACpM,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}