@appinternalleads/ui 0.2.0

package/dist/esm/components/onboarding/quick-actions/engine.d.ts

@@ -0,0 +1,41 @@
+import type { StateChipTone } from '../../../ds';
+import type { QuickActionsScene, QuickActionsSettings } from './contract';
+/** **The Quick Actions engine** — pure: each action's phase, and the finish. */
+export type TryPhase = 'idle' | 'busy' | 'done';
+export type QuickActionsState = {
+    rows: TryPhase[];
+    finish: 'idle' | 'finishing' | 'done';
+};
+export type QuickActionsSeed = Partial<QuickActionsState>;
+export type QuickActionsAction = {
+    type: 'try';
+    index: number;
+} | {
+    type: 'tried';
+    index: number;
+} | {
+    type: 'failed';
+    index: number;
+} | {
+    type: 'finish';
+} | {
+    type: 'finished';
+} | {
+    type: 'finishFailed';
+};
+export declare function initialQuickActions(c: QuickActionsSettings, seed?: QuickActionsSeed): QuickActionsState;
+export declare function quickActionsSeed(c: QuickActionsSettings, scene: QuickActionsScene): QuickActionsSeed;
+export declare function reduceQuickActions(s: QuickActionsState, a: QuickActionsAction): QuickActionsState;
+export declare function quickActionsView(c: QuickActionsSettings, s: QuickActionsState): {
+    tried: number;
+    scene: QuickActionsScene;
+    chip: {
+        tone: StateChipTone;
+        label: string;
+    };
+    footerHint: string;
+    primaryLabel: string;
+    canContinue: boolean;
+    showSecondary: boolean;
+};
+//# sourceMappingURL=engine.d.ts.map

package/dist/esm/components/onboarding/quick-actions/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../../src/components/onboarding/quick-actions/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE1E,gFAAgF;AAEhF,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAChD,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAA;CAAE,CAAC;AAC5F,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE1D,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC;AAE7B,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAI,GAAE,gBAAqB,GAAG,iBAAiB,CAE3G;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,oBAAoB,EAAE,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,CAMpG;AAID,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,CAUjG;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,oBAAoB,EAAE,CAAC,EAAE,iBAAiB;;WAQyD,iBAAiB;;cAClE,aAAa;;;;;;;EAMlG"}

package/dist/esm/components/onboarding/quick-actions/engine.js

@@ -0,0 +1,43 @@
+export function initialQuickActions(c, seed = {}) {
+    return { rows: seed.rows ?? c.actions.map(() => 'idle'), finish: seed.finish ?? 'idle' };
+}
+export function quickActionsSeed(c, scene) {
+    if (scene === 'trying')
+        return { rows: c.actions.map((_, i) => (i === 0 ? 'busy' : 'idle')) };
+    if (scene === 'some')
+        return { rows: c.actions.map((_, i) => (i < 2 ? 'done' : 'idle')) };
+    if (scene === 'all')
+        return { rows: c.actions.map(() => 'done') };
+    if (scene === 'finished')
+        return { rows: c.actions.map(() => 'done'), finish: 'done' };
+    return {};
+}
+const set = (s, i, p) => ({ rows: s.rows.map((x, k) => (k === i ? p : x)), finish: 'idle' });
+export function reduceQuickActions(s, a) {
+    switch (a.type) {
+        /* "Try again" tries a done action again. */
+        case 'try': return s.rows[a.index] !== 'busy' && s.finish === 'idle' ? set(s, a.index, 'busy') : s;
+        case 'tried': return s.rows[a.index] === 'busy' ? set(s, a.index, 'done') : s;
+        case 'failed': return s.rows[a.index] === 'busy' ? set(s, a.index, 'idle') : s;
+        case 'finish': return s.finish === 'idle' ? { ...s, finish: 'finishing' } : s;
+        case 'finished': return s.finish === 'finishing' ? { ...s, finish: 'done' } : s;
+        case 'finishFailed': return s.finish === 'finishing' ? { ...s, finish: 'idle' } : s;
+    }
+}
+export function quickActionsView(c, s) {
+    const total = s.rows.length;
+    const n = s.rows.filter(p => p === 'done').length;
+    const min = Math.min(c.minRequired, total || 1);
+    const met = n >= min;
+    const finished = s.finish === 'done';
+    return {
+        tried: n,
+        scene: (finished ? 'finished' : s.rows.includes('busy') ? 'trying' : total && n === total ? 'all' : n > 0 ? 'some' : 'default'),
+        chip: { tone: (finished || (total > 0 && n === total) ? 'success' : 'neutral'), label: `${n} of ${total} ${c.noun}` },
+        footerHint: finished ? c.finishedHint : met ? 'You’re ready to go' : `Try ${min === total ? `all ${min}` : `at least ${min}`} to continue`,
+        primaryLabel: s.finish === 'finishing' ? 'Continuing…' : finished ? 'Done' : c.primaryLabel,
+        canContinue: met && s.finish === 'idle',
+        showSecondary: !finished && Boolean(c.secondaryLabel),
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/esm/components/onboarding/quick-actions/engine.js.map

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

package/dist/esm/components/onboarding/quick-actions/index.d.ts

@@ -0,0 +1,4 @@
+export { QUICK_ACTIONS_IN_FLIGHT, QUICK_ACTIONS_PRESETS, QUICK_ACTIONS_SCENES, validateQuickActions, type QuickAction, type QuickActionsScene, type QuickActionsSettings, } from './contract';
+export { initialQuickActions, quickActionsSeed, quickActionsView, reduceQuickActions, type QuickActionsAction, type QuickActionsSeed, type QuickActionsState, type TryPhase, } from './engine';
+export { QuickActions, type QuickActionsOperations, type QuickActionsProps } from './QuickActionsView';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/onboarding/quick-actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/onboarding/quick-actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,oBAAoB,EAC1F,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,KAAK,oBAAoB,GACpE,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAC3E,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,QAAQ,GACtF,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,KAAK,sBAAsB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/esm/components/onboarding/quick-actions/index.js

@@ -0,0 +1,4 @@
+export { QUICK_ACTIONS_IN_FLIGHT, QUICK_ACTIONS_PRESETS, QUICK_ACTIONS_SCENES, validateQuickActions, } from './contract';
+export { initialQuickActions, quickActionsSeed, quickActionsView, reduceQuickActions, } from './engine';
+export { QuickActions } from './QuickActionsView';
+//# sourceMappingURL=index.js.map

package/dist/esm/components/onboarding/quick-actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/components/onboarding/quick-actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,oBAAoB,GAE3F,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,GAE5E,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAuD,MAAM,oBAAoB,CAAC"}

package/dist/esm/components/onboarding/quick-actions/presets.json

@@ -0,0 +1,232 @@
+{
+    "component": "quick-actions",
+    "baseCopy": {
+        "loadErrorTitle": "Couldn’t load this step",
+        "loadErrorBody": "Nothing was lost. Retry to load it again.",
+        "retryLabel": "Retry",
+        "emptyCta": "Refresh"
+    },
+    "base": {
+        "type": "file",
+        "icon": "doc",
+        "title": "Try the basics",
+        "subtitle": "Each one takes a few seconds.",
+        "noun": "tried",
+        "minRequired": 4,
+        "actions": [
+            {
+                "type": "file",
+                "icon": "doc",
+                "title": "Create a doc",
+                "description": "Start from a blank page",
+                "result": "Created “Untitled doc”"
+            },
+            {
+                "type": "agent",
+                "icon": "users",
+                "title": "Share it",
+                "description": "Invite someone to edit",
+                "result": "Shared with sam@northwind.com"
+            },
+            {
+                "type": "data",
+                "icon": "chat",
+                "title": "Leave a comment",
+                "description": "Highlight text and reply",
+                "result": "Comment added on line 3"
+            },
+            {
+                "type": "schedule",
+                "icon": "bell",
+                "title": "Set a reminder",
+                "description": "Get nudged about the doc",
+                "result": "Reminder set for tomorrow, 9:00"
+            }
+        ],
+        "tryLabel": "Try it",
+        "tryingLabel": "Trying…",
+        "againLabel": "Try again",
+        "primaryLabel": "Continue",
+        "secondaryLabel": "Skip",
+        "finishedHint": "Nice work · you’ve tried the basics",
+        "emptyTitle": "No actions to try",
+        "emptyBody": "Everything here is already familiar to you.",
+        "emptyCta": "Refresh"
+    },
+    "cases": {
+        "case1": {},
+        "case2": {
+            "type": "agent",
+            "icon": "sparkle",
+            "title": "Try your assistant",
+            "subtitle": "Four things it does well.",
+            "actions": [
+                {
+                    "type": "agent",
+                    "icon": "chat",
+                    "title": "Ask a question",
+                    "description": "About anything in your workspace",
+                    "result": "Answered in 2 seconds"
+                },
+                {
+                    "type": "file",
+                    "icon": "file",
+                    "title": "Summarise a file",
+                    "description": "Get the key points of a PDF",
+                    "result": "Summary of Q3-plan.pdf ready"
+                },
+                {
+                    "type": "action",
+                    "icon": "mail",
+                    "title": "Draft an email",
+                    "description": "A reply you can edit",
+                    "result": "Draft saved to Outbox"
+                },
+                {
+                    "type": "schedule",
+                    "icon": "clock",
+                    "title": "Schedule a task",
+                    "description": "Have it run later",
+                    "result": "Scheduled for Friday, 16:00"
+                }
+            ]
+        },
+        "case3": {
+            "type": "data",
+            "icon": "briefcase",
+            "title": "Try the CRM",
+            "subtitle": "The four things you’ll do every day.",
+            "minRequired": 3,
+            "actions": [
+                {
+                    "type": "data",
+                    "icon": "contacts",
+                    "title": "Add a contact",
+                    "description": "Name, company and email",
+                    "result": "Added Ana Ruiz · Harbor Legal"
+                },
+                {
+                    "type": "schedule",
+                    "icon": "phone",
+                    "title": "Log a call",
+                    "description": "Notes and next steps",
+                    "result": "Call logged · 12 minutes"
+                },
+                {
+                    "type": "action",
+                    "icon": "cash",
+                    "title": "Create a deal",
+                    "description": "Track an opportunity",
+                    "result": "Deal created · $18,000"
+                },
+                {
+                    "type": "schedule",
+                    "icon": "bell",
+                    "title": "Set a follow-up",
+                    "description": "So nothing slips",
+                    "result": "Follow-up set for Monday"
+                }
+            ]
+        },
+        "case4": {
+            "type": "file",
+            "icon": "image",
+            "title": "Try the editor",
+            "subtitle": "Make and share your first design.",
+            "actions": [
+                {
+                    "type": "file",
+                    "icon": "image",
+                    "title": "Upload an image",
+                    "description": "Drag in a photo or logo",
+                    "result": "hero.jpg uploaded · 1.2 MB"
+                },
+                {
+                    "type": "action",
+                    "icon": "template",
+                    "title": "Apply a template",
+                    "description": "Start from a layout",
+                    "result": "Applied “Launch post”"
+                },
+                {
+                    "type": "file",
+                    "icon": "download",
+                    "title": "Export",
+                    "description": "PNG, PDF or SVG",
+                    "result": "Exported launch-post.png"
+                },
+                {
+                    "type": "agent",
+                    "icon": "users",
+                    "title": "Invite a reviewer",
+                    "description": "Get feedback in context",
+                    "result": "Invited jo@northwind.com"
+                }
+            ]
+        },
+        "case5": {
+            "type": "data",
+            "icon": "cash",
+            "title": "Try the money basics",
+            "subtitle": "Two of these are enough to start.",
+            "minRequired": 2,
+            "actions": [
+                {
+                    "type": "data",
+                    "icon": "link",
+                    "title": "Link an account",
+                    "description": "Connect your bank safely",
+                    "result": "Linked Current account ••42"
+                },
+                {
+                    "type": "data",
+                    "icon": "tag",
+                    "title": "Categorise a spend",
+                    "description": "Sort a recent payment",
+                    "result": "Coffee → Eating out"
+                },
+                {
+                    "type": "action",
+                    "icon": "target",
+                    "title": "Set a budget",
+                    "description": "A monthly limit for a category",
+                    "result": "Eating out · $200 a month"
+                },
+                {
+                    "type": "file",
+                    "icon": "download",
+                    "title": "Download a statement",
+                    "description": "September as a PDF",
+                    "result": "statement-2026-09.pdf ready"
+                }
+            ]
+        }
+    },
+    "meta": {
+        "case1": {
+            "eyebrow": "Case study 1 · Productivity",
+            "title": "Docs app",
+            "scenario": "A new user tries the four core actions of a docs app. All four are needed."
+        },
+        "case2": {
+            "eyebrow": "Case study 2 · AI agent",
+            "title": "Assistant",
+            "scenario": "A user tries four things the assistant does well."
+        },
+        "case3": {
+            "eyebrow": "Case study 3 · Sales",
+            "title": "CRM",
+            "scenario": "A sales rep tries the daily CRM actions. Three are enough to continue."
+        },
+        "case4": {
+            "eyebrow": "Case study 4 · Creative",
+            "title": "Design tool",
+            "scenario": "A designer makes, exports and shares a first design."
+        },
+        "case5": {
+            "eyebrow": "Case study 5 · Finance",
+            "title": "Finance app",
+            "scenario": "A new user tries a personal finance app. Two actions are enough."
+        }
+    }
+}

package/dist/esm/components/onboarding/rate-limit/RateLimitView.d.ts

@@ -0,0 +1,33 @@
+import { type DensityName } from '../../../tokens';
+import { type OnboardingPreset, type OnboardingResult, type PatternStatus } from '../shared/contract';
+import { type OnboardingOperation } from '../shared/mock';
+import { type RateLimitSettings } from './contract';
+import { type RateLimitSeed } from './engine';
+export type RateLimitOperations = {
+    save: OnboardingOperation<{
+        limit: number;
+        overage: string;
+    }>;
+};
+export type RateLimitProps = {
+    preset?: OnboardingPreset;
+    config?: Partial<RateLimitSettings>;
+    density?: DensityName;
+    status?: PatternStatus;
+    result?: OnboardingResult;
+    operations?: RateLimitOperations;
+    reload?: OnboardingOperation<void>;
+    initial?: RateLimitSeed;
+    onSave?: (value: {
+        limit: number;
+        overage: string;
+    }) => void;
+    onScene?: (scene: string) => void;
+    testID?: string;
+};
+/** RateLimit, guarded: a wrong-kind config is refused by name and a render error is caught, never thrown to the page (`shared/guard`). */
+export declare const RateLimit: {
+    ({ onError, actions, onButtonAction, ...props }: RateLimitProps & import("..").GuardProps): import("react").JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=RateLimitView.d.ts.map

package/dist/esm/components/onboarding/rate-limit/RateLimitView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimitView.d.ts","sourceRoot":"","sources":["../../../../../src/components/onboarding/rate-limit/RateLimitView.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAiB,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrH,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAM7E,OAAO,EAAyC,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAoD,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAGhG,MAAM,MAAM,mBAAmB,GAAG;IAAE,IAAI,EAAE,mBAAmB,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAEpG,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,MAAM,CAAC,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAqFF,0IAA0I;AAC1I,eAAO,MAAM,SAAS;;;CAA0D,CAAC"}

package/dist/esm/components/onboarding/rate-limit/RateLimitView.js

@@ -0,0 +1,50 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect } from 'react';
+import { Box, Icon, Select, Text } from '../../../core';
+import { Callout, ProgressBar } from '../../../ds';
+import { blockRadii, useDs } from '../../../tokens';
+import { resolveConfig } from '../shared/contract';
+import { ONBOARDING_TIMING } from '../shared/mock';
+import { InvalidConfig } from '../shared/InvalidConfig';
+import { FieldLabel, OnboardingCard } from '../shared/OnboardingCard';
+import { CrossFadeText } from '../shared/parts';
+import { runOutcome, useDefaultOperation, usePatternStatus, useSceneReport, useSeededReducer } from '../shared/runtime';
+import { useOperationRunner } from '../../../runtime/operations';
+import { RATE_LIMIT_PRESETS, validateRateLimit } from './contract';
+import { initialRateLimit, rateLimitView, reduceRateLimit } from './engine';
+import { guarded } from '../shared/guard';
+/**
+ * **Rate Limit** — a limit select (C6), a usage well ("8,200 / 10,000 req/min", cross-fading; an 8px
+ * bar that turns apricot near, at or over the limit, with the warning in words), and an overage
+ * select with a line describing the choice. Save waits for a change.
+ */
+function RateLimitView(props) {
+    const config = resolveConfig(RATE_LIMIT_PRESETS, props.preset, props.config);
+    const issues = validateRateLimit(config);
+    if (issues.length)
+        return _jsx(InvalidConfig, { title: config.title, issues: issues, testID: props.testID });
+    return _jsx(Valid, { ...props, config: config });
+}
+function Valid({ config, density, status = 'ready', result, operations, reload, initial, onSave, onScene, testID, }) {
+    const { colors, density: d } = useDs();
+    const runner = useOperationRunner();
+    const key = JSON.stringify([config, initial ?? null]);
+    const [state, send, ref] = useSeededReducer(reduceRateLimit, () => initialRateLimit(config, initial), key, () => runner.cancel('save'));
+    const pattern = usePatternStatus(status, reload);
+    const v = rateLimitView(config, state);
+    useSceneReport(pattern.status === 'ready' ? v.scene : pattern.status, onScene);
+    const save = useDefaultOperation(operations?.save, ONBOARDING_TIMING.save, () => result === 'error');
+    const run = () => {
+        const value = { limit: ref.current.limit, overage: ref.current.overage };
+        runOutcome(runner, 'save', save, value, { ok: () => { send({ type: 'saved' }); onSave?.(value); }, fail: () => send({ type: 'failed' }) });
+    };
+    useEffect(() => { if (ref.current.save === 'saving')
+        run(); }, [key]);
+    const locked = state.save === 'saving';
+    return (_jsx(OnboardingCard, { testID: testID, header: config, copy: config, density: density, status: pattern.status, onRetry: pattern.retry, onEmptyAction: pattern.retry, chip: v.chip, hint: v.footerHint, primary: { label: v.primaryLabel, disabled: !v.canSave, busy: locked, onPress: () => { if (!rateLimitView(config, ref.current).canSave)
+                return; send({ type: 'save' }); run(); } }, children: _jsxs(Box, { style: { gap: d.gap + 2 }, children: [_jsxs(Box, { gap: "s1", children: [_jsx(FieldLabel, { children: config.limitLabel }), _jsx(Select, { "aria-label": config.limitLabel, value: String(state.limit), disabled: locked, onChange: x => send({ type: 'limit', limit: Number(x) }), options: config.limits.map(x => ({ value: String(x), label: `${x.toLocaleString('en-US')} ${config.unit}` })) })] }), _jsxs(Box, { gap: "s2", style: { borderRadius: blockRadii.mid, backgroundColor: colors.surfaceSunken, paddingVertical: 14, paddingHorizontal: 16 }, children: [_jsxs(Box, { row: true, wrap: true, justify: "space-between", gap: "s2", children: [_jsx(Text, { variant: "caption", color: "textSecondary", style: { fontSize: 12 }, children: config.usageLabel }), _jsx(CrossFadeText, { value: v.usageText, style: { fontSize: 13, fontWeight: '600', color: colors.textPrimary } })] }), _jsx(ProgressBar, { bare: true, track: "surface", label: config.usageLabel, value: v.pct, tone: v.warn ? 'attention' : 'ink', format: () => `${v.pct}% of the limit${v.warn ? ` · ${v.chip.label.toLowerCase()}` : ''}` }), v.warn ? (_jsxs(Box, { row: true, gap: "s2", align: "flex-start", children: [_jsx(Icon, { name: "alert", size: 14, color: colors.status.needsUser }), _jsx(Text, { variant: "caption", style: { fontSize: 12, color: colors.status.needsUser, flex: 1 }, children: v.note })] })) : null] }), _jsxs(Box, { gap: "s1", children: [_jsx(FieldLabel, { children: config.overageLabel }), _jsx(Select, { "aria-label": config.overageLabel, value: state.overage, disabled: locked, onChange: x => send({ type: 'overage', overage: x }), options: config.overageOptions.map(o => ({ value: o.value, label: o.label })) }), _jsx(Text, { variant: "caption", color: "textSecondary", style: { fontSize: 12 }, children: v.option.description })] }), state.save === 'failed' ? _jsx(Callout, { alert: true, title: config.saveErrorTitle, children: config.saveErrorBody }) : null] }) }));
+}
+/** RateLimit, guarded: a wrong-kind config is refused by name and a render error is caught, never thrown to the page (`shared/guard`). */
+export const RateLimit = guarded(RateLimitView, RATE_LIMIT_PRESETS, 'RateLimit');
+//# sourceMappingURL=RateLimitView.js.map

package/dist/esm/components/onboarding/rate-limit/RateLimitView.js.map

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

package/dist/esm/components/onboarding/rate-limit/contract.d.ts

@@ -0,0 +1,42 @@
+import type { HeaderConfig, LoadCopy, OnboardingIssue, PresetsFile } from '../shared/contract';
+/**
+ * **Rate Limit — "limit + usage + overage" (batch 2 §3.9)** — set a usage limit and what happens
+ * when it is exceeded. Near the limit, at it, or set below current usage, the bar and chip turn
+ * apricot and a line says what will happen, in words.
+ */
+export type OverageOption = {
+    value: string;
+    label: string;
+    description: string;
+    outcome: string;
+};
+export declare const RATE_LIMIT_SCENES: readonly ["default", "normal", "near", "atLimit", "below", "saving", "saved", "failed", "loading", "empty", "error"];
+export type RateLimitScene = (typeof RATE_LIMIT_SCENES)[number];
+/** Scenes that are an operation in flight — see `sceneProps`. */
+export declare const RATE_LIMIT_IN_FLIGHT: readonly string[];
+export type RateLimitSettings = HeaderConfig & LoadCopy & {
+    limits: number[];
+    /** "req/min". */
+    unit: string;
+    /** "requests" — "Extra requests will be queued". */
+    unitNoun: string;
+    usage: number;
+    /** The limit saved today. */
+    defaultLimit: number;
+    /** A change the step opens with, not yet saved (case 5 lowers the limit below usage). */
+    pendingLimit?: number;
+    defaultOverage?: string;
+    overageOptions: OverageOption[];
+    /** At or above this share of the limit, usage is "near". */
+    attentionAt: number;
+    limitLabel: string;
+    usageLabel: string;
+    overageLabel: string;
+    primaryLabel: string;
+    savedHint: string;
+    saveErrorTitle: string;
+    saveErrorBody: string;
+};
+export declare const RATE_LIMIT_PRESETS: PresetsFile<RateLimitSettings>;
+export declare function validateRateLimit(c: RateLimitSettings): OnboardingIssue[];
+//# sourceMappingURL=contract.d.ts.map

package/dist/esm/components/onboarding/rate-limit/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../../../src/components/onboarding/rate-limit/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG/F;;;;GAIG;AAEH,MAAM,MAAM,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnG,eAAO,MAAM,iBAAiB,sHAAuH,CAAC;AACtJ,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAChE,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAe,CAAC;AAElE,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,QAAQ,GAAG;IACxD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAA6B,WAAW,CAAC,iBAAiB,CAAC,CAAC;AAE3F,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,iBAAiB,GAAG,eAAe,EAAE,CAQzE"}

package/dist/esm/components/onboarding/rate-limit/contract.js

@@ -0,0 +1,20 @@
+import presetsJson from './presets.json';
+export const RATE_LIMIT_SCENES = ['default', 'normal', 'near', 'atLimit', 'below', 'saving', 'saved', 'failed', 'loading', 'empty', 'error'];
+/** Scenes that are an operation in flight — see `sceneProps`. */
+export const RATE_LIMIT_IN_FLIGHT = ['saving'];
+export const RATE_LIMIT_PRESETS = presetsJson;
+export function validateRateLimit(c) {
+    const issues = [];
+    if (!Array.isArray(c.limits) || !c.limits.length)
+        issues.push({ path: 'limits', message: 'Offer at least one limit.' });
+    else if (!c.limits.includes(c.defaultLimit))
+        issues.push({ path: 'defaultLimit', message: 'defaultLimit must be one of the limits.' });
+    if (c.pendingLimit !== undefined && !c.limits?.includes(c.pendingLimit))
+        issues.push({ path: 'pendingLimit', message: 'pendingLimit must be one of the limits.' });
+    if (!Array.isArray(c.overageOptions) || !c.overageOptions.length)
+        issues.push({ path: 'overageOptions', message: 'Offer at least one overage behaviour.' });
+    if (!(c.attentionAt > 0 && c.attentionAt <= 1))
+        issues.push({ path: 'attentionAt', message: 'attentionAt is a share between 0 and 1.' });
+    return issues;
+}
+//# sourceMappingURL=contract.js.map

package/dist/esm/components/onboarding/rate-limit/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../../../src/components/onboarding/rate-limit/contract.ts"],"names":[],"mappings":"AACA,OAAO,WAAW,MAAM,gBAAgB,CAAC;AAUzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AAEtJ,iEAAiE;AACjE,MAAM,CAAC,MAAM,oBAAoB,GAAsB,CAAC,QAAQ,CAAC,CAAC;AA0BlE,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAwD,CAAC;AAE3F,MAAM,UAAU,iBAAiB,CAAC,CAAoB;IACpD,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC,CAAC;SACnH,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC,CAAC;IACvI,IAAI,CAAC,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC,CAAC;IACnK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC,CAAC;IAC5J,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC,CAAC;IACzI,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/components/onboarding/rate-limit/engine.d.ts

@@ -0,0 +1,52 @@
+import type { StateChipTone } from '../../../ds';
+import type { SavePhase } from '../shared/contract';
+import type { RateLimitScene, RateLimitSettings } from './contract';
+/** **The Rate Limit engine** — pure: the chosen limit and overage against what is saved, and usage. */
+export type RateLimitState = {
+    usage: number;
+    limit: number;
+    overage: string;
+    saved: {
+        limit: number;
+        overage: string;
+    };
+    save: SavePhase;
+};
+export type RateLimitSeed = Partial<RateLimitState>;
+export type UsageMode = 'normal' | 'near' | 'at' | 'below';
+export type RateLimitAction = {
+    type: 'limit';
+    limit: number;
+} | {
+    type: 'overage';
+    overage: string;
+} | {
+    type: 'save';
+} | {
+    type: 'saved';
+} | {
+    type: 'failed';
+};
+export declare function initialRateLimit(c: RateLimitSettings, seed?: RateLimitSeed): RateLimitState;
+/** The prototype's scenes: usage set against the saved limit, or a limit picked below usage. */
+export declare function rateLimitSeed(c: RateLimitSettings, scene: RateLimitScene): RateLimitSeed;
+export declare function reduceRateLimit(s: RateLimitState, a: RateLimitAction): RateLimitState;
+export declare function usageMode(c: RateLimitSettings, s: Pick<RateLimitState, 'usage' | 'limit'>): UsageMode;
+export declare function rateLimitView(c: RateLimitSettings, s: RateLimitState): {
+    mode: UsageMode;
+    warn: boolean;
+    pct: number;
+    usageText: string;
+    option: import("./contract").OverageOption;
+    note: string;
+    scene: RateLimitScene;
+    chip: {
+        tone: StateChipTone;
+        label: string;
+    };
+    dirty: boolean;
+    footerHint: string;
+    primaryLabel: string;
+    canSave: boolean;
+};
+//# sourceMappingURL=engine.d.ts.map

package/dist/esm/components/onboarding/rate-limit/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../../src/components/onboarding/rate-limit/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpE,uGAAuG;AAEvG,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAC3I,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AACpD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC;AAE3D,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,GAAE,aAAkB,GAAG,cAAc,CAI/F;AAED,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,cAAc,GAAG,aAAa,CAgBxF;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,eAAe,GAAG,cAAc,CAQrF;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,SAAS,CAGrG;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,cAAc;;;;;;;WAiBsE,cAAc;;cAEtC,aAAa;;;;;;;EAQ/H"}