@appinternalleads/ui 0.2.0

package/dist/esm/components/onboarding/brand-kit/presets.json

@@ -0,0 +1,210 @@
+{
+    "component": "brand-kit",
+    "base": {
+        "type": "file",
+        "icon": "palette",
+        "previewKind": "appbar",
+        "title": "Brand your workspace",
+        "subtitle": "Logo, colours and font for the app.",
+        "brandName": "Northwind",
+        "accept": [
+            "svg",
+            "png"
+        ],
+        "maxSizeMB": 2,
+        "colorLabels": [
+            "Primary",
+            "Accent"
+        ],
+        "fontOptions": [
+            "Nunito Sans",
+            "Georgia",
+            "Trebuchet MS",
+            "System UI"
+        ],
+        "defaults": {
+            "logo": "empty",
+            "colors": [
+                "#1F4E79",
+                "#F2B544"
+            ],
+            "font": "Nunito Sans"
+        },
+        "demoColors": [
+            "#1F4E79",
+            "#F2B544"
+        ],
+        "primaryLabel": "Save brand kit",
+        "savingLabel": "Saving…",
+        "savedLabel": "Saved",
+        "retryLabel": "Retry",
+        "secondaryLabel": "Skip",
+        "savedHint": "Saved · applies to everyone in the workspace",
+        "saveErrorTitle": "Couldn’t save your brand kit",
+        "saveErrorBody": "Nothing was changed. Check your connection, then retry.",
+        "loadErrorTitle": "Couldn’t load your brand kit",
+        "loadErrorBody": "Your saved settings are safe. Retry to load them again.",
+        "emptyTitle": "No brand kit yet",
+        "emptyBody": "Add a logo and colours so what you share looks like your brand.",
+        "emptyCta": "Set up brand kit"
+    },
+    "cases": {
+        "case1": {},
+        "case2": {
+            "icon": "mail",
+            "previewKind": "email",
+            "title": "Newsletter header",
+            "subtitle": "Shown at the top of every issue.",
+            "brandName": "The Weekly Crop",
+            "accept": [
+                "png",
+                "jpg"
+            ],
+            "colorLabels": [
+                "Header",
+                "Button"
+            ],
+            "fontOptions": [
+                "Arial",
+                "Georgia",
+                "Verdana",
+                "Times New Roman",
+                "Trebuchet MS"
+            ],
+            "defaults": {
+                "logo": "filled",
+                "colors": [
+                    "#24543F",
+                    "#E08A2B"
+                ],
+                "font": "Georgia"
+            },
+            "demoColors": [
+                "#24543F",
+                "#E08A2B"
+            ],
+            "primaryLabel": "Save header",
+            "savedHint": "Saved · used from the next issue"
+        },
+        "case3": {
+            "icon": "layout",
+            "previewKind": "login",
+            "title": "White-label the client portal",
+            "subtitle": "Applies to the portal login page.",
+            "brandName": "Harbor Legal",
+            "accept": [
+                "svg"
+            ],
+            "colorLabels": [
+                "Brand",
+                "Link"
+            ],
+            "defaults": {
+                "logo": "filled",
+                "colors": [
+                    "#18324A",
+                    "#2F6BE"
+                ],
+                "touched": [
+                    false,
+                    true
+                ],
+                "lastValid": [
+                    null,
+                    "#2F6BEB"
+                ],
+                "font": "Nunito Sans"
+            },
+            "demoColors": [
+                "#18324A",
+                "#2F6BEB"
+            ],
+            "primaryLabel": "Save portal branding",
+            "savedHint": "Saved · live on the client’s login page"
+        },
+        "case4": {
+            "type": "data",
+            "icon": "receipt",
+            "previewKind": "invoice",
+            "title": "Invoice branding",
+            "subtitle": "Appears on every invoice you send.",
+            "brandName": "Ledgerly Studio",
+            "accept": [
+                "png"
+            ],
+            "maxSizeMB": 1,
+            "colorLabels": [
+                "Accent"
+            ],
+            "fontOptions": [
+                "Georgia",
+                "Nunito Sans"
+            ],
+            "defaults": {
+                "logo": "empty",
+                "colors": [
+                    "#2E6F62"
+                ],
+                "font": "Georgia"
+            },
+            "demoColors": [
+                "#2E6F62"
+            ],
+            "primaryLabel": "Save invoice branding",
+            "savedHint": "Saved · applies to new invoices"
+        },
+        "case5": {
+            "type": "date",
+            "icon": "ticket",
+            "previewKind": "ticket",
+            "title": "Ticket design",
+            "subtitle": "Printed on each ticket and stub.",
+            "brandName": "Lumen Fest 2026",
+            "colorLabels": [
+                "Ticket",
+                "Stub"
+            ],
+            "defaults": {
+                "logo": "uploading",
+                "colors": [
+                    "#3B2A6B",
+                    "#F4C95D"
+                ],
+                "font": "Trebuchet MS"
+            },
+            "demoColors": [
+                "#3B2A6B",
+                "#F4C95D"
+            ],
+            "primaryLabel": "Save ticket design",
+            "savedHint": "Saved · applies to tickets issued from now"
+        }
+    },
+    "meta": {
+        "case1": {
+            "eyebrow": "Case study 1 · Product",
+            "title": "Workspace branding",
+            "scenario": "A workspace admin adds a logo and two colours so every teammate sees the company brand in the app’s top bar and sidebar."
+        },
+        "case2": {
+            "eyebrow": "Case study 2 · Marketing",
+            "title": "Newsletter header",
+            "scenario": "A marketer sets the header band and button colour used at the top of every issue. Fonts are limited to ones that render in email clients."
+        },
+        "case3": {
+            "eyebrow": "Case study 3 · Agency",
+            "title": "Client portal white-label",
+            "scenario": "An agency puts a client’s brand on their portal login page. The board opens with a mistyped link colour so the invalid-hex state is visible."
+        },
+        "case4": {
+            "eyebrow": "Case study 4 · Finance",
+            "title": "Invoice branding",
+            "scenario": "A studio adds its logo and a single accent colour to every invoice. PNG only, up to 1 MB."
+        },
+        "case5": {
+            "eyebrow": "Case study 5 · Events",
+            "title": "Event ticket",
+            "scenario": "An organiser brands the ticket and its stub. The board opens mid-upload, so the progress state is visible before anything else."
+        }
+    }
+}

package/dist/esm/components/onboarding/brand-kit/runtime.d.ts

@@ -0,0 +1,48 @@
+import { type PickedFile } from '../../../core';
+import type { OnboardingResult } from '../shared/contract';
+import { type OnboardingOperation, type ProgressOperation } from '../shared/mock';
+import type { BrandKitSettings } from './contract';
+import { type BrandAction, type BrandSeed, type BrandState } from './engine';
+export type BrandKitValue = {
+    logo: PickedFile | null;
+    colors: (string | null)[];
+    font: string;
+};
+export type BrandKitOperations = {
+    /** The logo upload, with progress. */
+    upload: ProgressOperation<{
+        file: PickedFile;
+    }>;
+    save: OnboardingOperation<BrandKitValue>;
+};
+/**
+ * **The Brand Kit runtime** — two boundary operations: the logo upload (a progress stream; the
+ * prototype's +12% every 180ms by default) and the save (1400ms; `result` decides it).
+ */
+export declare function useBrandKit({ config, operations, result, initial, onChange, onSave, }: {
+    config: BrandKitSettings;
+    operations?: Partial<BrandKitOperations>;
+    result?: OnboardingResult;
+    initial?: BrandSeed;
+    onChange?: (value: BrandKitValue) => void;
+    onSave?: (value: BrandKitValue) => void;
+}): {
+    state: BrandState;
+    view: {
+        scene: "default" | "dragover" | "filled" | "failed" | "uploading" | "saving" | "saved" | "invalidFile" | "invalidHex";
+        chip: {
+            tone: import("../../..").StateChipTone;
+            label: string;
+        };
+        footerHint: string;
+        canSave: boolean;
+        primaryLabel: string;
+        dropHint: string;
+        previewColors: (string | null)[];
+    };
+    dispatch: import("react").ActionDispatch<[a: BrandAction]>;
+    file: (file: PickedFile) => void;
+    cancelUpload: () => void;
+    save: () => void;
+};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/esm/components/onboarding/brand-kit/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../../src/components/onboarding/brand-kit/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EACgE,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EACtH,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAEL,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAClD,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACjG,MAAM,MAAM,kBAAkB,GAAG;IAC/B,sCAAsC;IACtC,MAAM,EAAE,iBAAiB,CAAC;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IAChD,IAAI,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;CAC1C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EAAE,UAAU,EAAE,MAAkB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAClE,EAAE;IACD,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACzC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CACzC;;;;;;;;;;;;;;;iBA+DgB,UAAU;;;EAa1B"}

package/dist/esm/components/onboarding/brand-kit/runtime.js

@@ -0,0 +1,84 @@
+'use client';
+import { useCallback, useEffect, useMemo, useReducer, useRef } from 'react';
+import { useOperationRunner } from '../../../runtime/operations';
+import { checkFile } from '../../../core';
+import { ONBOARDING_TIMING, createMockOperation, createMockProgressOperation, } from '../shared/mock';
+import { runOutcome } from '../shared/runtime';
+import { brandSeed, brandView, initialBrand, reduceBrand, } from './engine';
+/**
+ * **The Brand Kit runtime** — two boundary operations: the logo upload (a progress stream; the
+ * prototype's +12% every 180ms by default) and the save (1400ms; `result` decides it).
+ */
+export function useBrandKit({ config, operations, result = 'success', initial, onChange, onSave, }) {
+    const seed = () => initialBrand(config, initial ?? (config.ship ? brandSeed(config, config.ship) : {}));
+    const [state, send] = useReducer((s, a) => reduceBrand(config, s, a), undefined, seed);
+    const stateRef = useRef(state);
+    stateRef.current = state;
+    const runner = useOperationRunner();
+    const upload = useMemo(() => operations?.upload ?? createMockProgressOperation({ tickMs: 180, step: 0.12 }), [operations?.upload]);
+    const save = useMemo(() => operations?.save ?? createMockOperation({ latencyMs: ONBOARDING_TIMING.save, fail: () => result === 'error' }), [operations?.save, result]);
+    const valueOf = (s) => ({ logo: s.file.status === 'filled' ? s.file.file : null, colors: s.valid, font: s.font });
+    const key = JSON.stringify([config, initial ?? null]);
+    const seeded = useRef(key);
+    useEffect(() => {
+        if (seeded.current === key)
+            return;
+        seeded.current = key;
+        runner.cancel('upload');
+        runner.cancel('save');
+        send({ type: 'reset', state: seed() });
+    });
+    const runUpload = useCallback((file, from) => {
+        runner.run('upload', ctx => upload({ file }, {
+            signal: ctx.signal,
+            onProgress: p => { if (ctx.isCurrent())
+                send({ type: 'progress', progress: Math.max(from, p) }); },
+        }), {
+            onOk: r => (r.ok ? send({ type: 'uploaded' }) : send({ type: 'removeFile' })),
+            onError: () => send({ type: 'removeFile' }),
+        });
+    }, [runner, upload]);
+    const runSave = useCallback(() => {
+        const v = valueOf(stateRef.current);
+        runOutcome(runner, 'save', save, v, {
+            ok: () => { send({ type: 'saved' }); onSave?.(v); },
+            fail: () => send({ type: 'failed' }),
+        });
+    }, [runner, save, onSave]);
+    /* A restored session resumes an upload or a save it was in (case 5 ships mid-upload). */
+    useEffect(() => {
+        const f = stateRef.current.file;
+        if (f.status === 'uploading')
+            runUpload(f.file, f.progress);
+        if (stateRef.current.save === 'saving')
+            runSave();
+    }, [key]);
+    const valueKey = JSON.stringify(valueOf(state));
+    const reported = useRef(valueKey);
+    useEffect(() => {
+        if (reported.current === valueKey)
+            return;
+        reported.current = valueKey;
+        onChange?.(valueOf(state));
+    }, [valueKey]);
+    return {
+        state,
+        view: brandView(config, state),
+        dispatch: send,
+        file: (file) => {
+            send({ type: 'file', file });
+            /* The same rule the reducer applies: an accepted file starts uploading at once. */
+            const ext = file.ext === 'jpeg' ? 'jpg' : file.ext;
+            if (checkFile({ ...file, ext }, { accept: config.accept, maxSizeMB: config.maxSizeMB }).ok)
+                runUpload(file, 0);
+        },
+        cancelUpload: () => { runner.cancel('upload'); send({ type: 'removeFile' }); },
+        save: () => {
+            if (!brandView(config, stateRef.current).canSave)
+                return;
+            send({ type: 'save' });
+            runSave();
+        },
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/esm/components/onboarding/brand-kit/runtime.js.map

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

package/dist/esm/components/onboarding/budget-allocation/BudgetAllocationView.d.ts

@@ -0,0 +1,26 @@
+import { type DensityName } from '../../../tokens';
+import { type OnboardingPreset, type OnboardingResult, type PatternStatus } from '../shared/contract';
+import type { OnboardingOperation } from '../shared/mock';
+import { type BudgetSettings } from './contract';
+import type { BudgetSeed } from './engine';
+import { type BudgetAllocationItem, type BudgetOperations } from './runtime';
+export type BudgetAllocationProps = {
+    preset?: OnboardingPreset;
+    config?: Partial<BudgetSettings>;
+    density?: DensityName;
+    status?: PatternStatus;
+    result?: OnboardingResult;
+    operations?: BudgetOperations;
+    reload?: OnboardingOperation<void>;
+    initial?: BudgetSeed;
+    onChange?: (items: BudgetAllocationItem[]) => void;
+    onSave?: (items: BudgetAllocationItem[]) => void;
+    onScene?: (scene: string) => void;
+    testID?: string;
+};
+/** BudgetAllocation, 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 BudgetAllocation: {
+    ({ onError, actions, onButtonAction, ...props }: BudgetAllocationProps & import("..").GuardProps): import("react").JSX.Element;
+    displayName: string;
+};
+//# sourceMappingURL=BudgetAllocationView.d.ts.map

package/dist/esm/components/onboarding/budget-allocation/BudgetAllocationView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BudgetAllocationView.d.ts","sourceRoot":"","sources":["../../../../../src/components/onboarding/budget-allocation/BudgetAllocationView.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAS,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAA0B,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9H,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAI1D,OAAO,EAAgD,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAC/F,OAAO,KAAK,EAA2B,UAAU,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAuB,KAAK,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGlG,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,MAAM,CAAC,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,IAAI,CAAC;IACnD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,IAAI,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAuJF,iJAAiJ;AACjJ,eAAO,MAAM,gBAAgB;;;CAAoE,CAAC"}

package/dist/esm/components/onboarding/budget-allocation/BudgetAllocationView.js

@@ -0,0 +1,62 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect } from 'react';
+import { Box, Icon, Input, MotionView, Pressable, Text, useBlockMotion, usePresence } from '../../../core';
+import { AmountField, Button, Callout, ProgressBar, StatWell, TickNumber, TypeTile } from '../../../ds';
+import { useDs } from '../../../tokens';
+import { iconFor, resolveConfig } from '../shared/contract';
+import { InvalidConfig } from '../shared/InvalidConfig';
+import { OnboardingCard } from '../shared/OnboardingCard';
+import { usePatternStatus, useSceneReport } from '../shared/runtime';
+import { BUDGET_PRESETS, formatAmount, validateBudget } from './contract';
+import { useBudgetAllocation } from './runtime';
+import { guarded } from '../shared/guard';
+/**
+ * **Budget Allocation** — a stat well (D4, B9: the allocated value cross-fading, an 8px bar ink /
+ * mint / apricot), then one row per category: tile, name, a 4px share bar with its percentage, a
+ * 150px amount field (grouped at rest, B7) and Remove. A share above `attentionAt` turns the bar
+ * and percentage apricot and says so. Rows add and remove with M14. The footer says what remains
+ * — or, in apricot, by how much it is over — and Save is gated on over, no rows, or a new row
+ * without a name.
+ */
+function BudgetAllocationView(props) {
+    const config = resolveConfig(BUDGET_PRESETS, props.preset, props.config);
+    const issues = validateBudget(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, result, operations, reload, initial, onChange, onSave, onScene, testID, }) {
+    const { colors } = useDs();
+    const motion = useBlockMotion();
+    const pattern = usePatternStatus(status ?? (config.categories.length ? 'ready' : 'empty'), reload);
+    const rt = useBudgetAllocation({ config, operations, result, initial, onChange, onSave });
+    const v = rt.view;
+    useSceneReport(pattern.status === 'ready' ? v.scene : pattern.status, onScene);
+    const fmt = (n) => formatAmount(config, n);
+    const over = v.mode === 'over';
+    const locked = rt.state.save === 'saving' || rt.state.save === 'saved';
+    const hint = (_jsxs(Box, { row: true, align: "center", gap: "s1", wrap: true, children: [_jsx(Text, { variant: "caption", style: { fontSize: 12, color: over ? colors.status.needsUser : colors.textSecondary }, children: v.remCaption }), _jsx(TickNumber, { value: Math.abs(v.rem), format: fmt, fontSize: 12, tone: over ? 'apricot' : 'default', label: v.remCaption })] }));
+    return (_jsx(OnboardingCard, { testID: testID, header: config, copy: config, density: density, status: pattern.status, onRetry: pattern.retry, onEmptyAction: () => {
+            /* "No categories yet" → Add category: the step starts from nothing and adds the first. */
+            pattern.set('ready');
+            rt.dispatch({ type: 'reset', state: { rows: [], save: 'idle', nextId: 100 } });
+            rt.dispatch({ type: 'add' });
+        }, chip: v.chip, hint: hint, primary: { label: v.primaryLabel, onPress: rt.save, disabled: !v.canSave, busy: rt.state.save === 'saving' }, children: _jsxs(Box, { gap: "s3", children: [_jsx(StatWell, { label: "Allocated", hint: config.unitHint, value: v.alloc, total: config.total, format: fmt }), _jsx(Box, { role: "list", "aria-label": `${config.title} categories`, children: rt.state.rows.map(r => (_jsx(CategoryRow, { row: r, config: config, share: v.share(r), hot: v.hot(r), locked: locked, dispatch: rt.dispatch, immediate: motion.reduced }, r.id))) }), v.canAdd ? (_jsx(Box, { alignSelf: "flex-start", children: _jsx(Button, { variant: "secondary", size: "small", leadingGlyph: "plus", onPress: () => rt.dispatch({ type: 'add' }), children: "Add category" }) })) : null, rt.state.save === 'failed' ? _jsx(Callout, { alert: true, title: config.saveErrorTitle, children: config.saveErrorBody }) : null] }) }));
+}
+function CategoryRow({ row, config, share, hot, locked, dispatch, immediate, }) {
+    const { colors, density } = useDs();
+    /* M14: a new row fades and settles in; a removed one fades up, then leaves. */
+    const presence = usePresence(!row.leaving, { speed: 'list', appear: row.isNew });
+    useEffect(() => { if (row.leaving && !presence.mounted)
+        dispatch({ type: 'drop', id: row.id }); }, [row.leaving, presence.mounted]);
+    if (!presence.mounted)
+        return null;
+    const pct = Math.round(share * 100);
+    const label = row.name.trim() || 'New category';
+    const hotId = `budget-hot-${row.id}`;
+    return (_jsx(MotionView, { role: "listitem", "aria-hidden": row.leaving || undefined, style: { opacity: presence.opacity, transform: [{ translateY: presence.translateY }] }, children: _jsxs(Box, { row: true, wrap: true, align: "center", gap: "s3", style: { minHeight: density.rowH, paddingVertical: 10, borderBottomWidth: 1, borderBottomColor: colors.hairline }, children: [_jsx(TypeTile, { icon: iconFor(row.icon), type: row.type, size: 32 }), _jsxs(Box, { flex: 1, gap: "s1", style: { minWidth: 150 }, children: [row.isNew ? (_jsx(Input, { value: row.name, onChangeText: name => dispatch({ type: 'name', id: row.id, name }), placeholder: "Category name", "aria-label": "Category name", disabled: locked })) : (_jsx(Text, { variant: "caption", color: "textPrimary", style: { fontWeight: '600', fontSize: 13 }, children: row.name })), _jsxs(Box, { row: true, align: "center", gap: "s2", children: [_jsx(Box, { flex: 1, children: _jsx(ProgressBar, { bare: true, label: `${label} share`, value: Math.min(100, pct), tone: hot ? 'attention' : 'neutral', height: 4, format: () => `${pct}% of the total` }) }), _jsx(Text, { variant: "caption", numeric: true, style: { fontSize: 12, width: 36, textAlign: 'right', color: hot ? colors.status.needsUser : colors.textSecondary, fontWeight: hot ? '600' : '400' }, children: `${pct}%` })] }), hot ? (_jsx(Text, { nativeID: hotId, variant: "caption", style: { fontSize: 12, color: colors.status.needsUser }, children: `More than ${Math.round(config.attentionAt * 100)}% of the total` })) : null] }), _jsx(AmountField, { value: row.amount, onChange: amount => dispatch({ type: 'amount', id: row.id, amount }), label: `${label} amount`, prefix: config.prefix || undefined, suffix: config.fieldSuffix || undefined, disabled: locked, describedBy: hot ? hotId : undefined, width: 150 }), !locked ? (_jsx(Pressable, { "aria-label": `Remove ${row.name.trim() || 'new category'}`, onPress: () => dispatch({ type: 'remove', id: row.id, immediate }), width: 32, height: 32, radius: "pill", children: _jsx(Icon, { name: "trash", size: 15, color: colors.textSecondary }) })) : _jsx(Box, { width: 32 })] }) }));
+}
+/** BudgetAllocation, guarded: a wrong-kind config is refused by name and a render error is caught, never thrown to the page (`shared/guard`). */
+export const BudgetAllocation = guarded(BudgetAllocationView, BUDGET_PRESETS, 'BudgetAllocation');
+//# sourceMappingURL=BudgetAllocationView.js.map

package/dist/esm/components/onboarding/budget-allocation/BudgetAllocationView.js.map

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

package/dist/esm/components/onboarding/budget-allocation/contract.d.ts

@@ -0,0 +1,47 @@
+import type { DataType } from '../../../tokens';
+import type { HeaderConfig, LoadCopy, OnboardingIssue, PresetsFile } from '../shared/contract';
+/**
+ * **Budget Allocation (handoff §3.2)** — split a fixed total across categories and see what is
+ * allocated against what remains.
+ */
+export type BudgetCategory = {
+    name: string;
+    type: DataType;
+    icon: string;
+    amount: number;
+};
+export declare const BUDGET_SCENES: readonly ["default", "under", "exact", "over", "saving", "saved", "failed", "loading", "empty", "error"];
+export type BudgetScene = (typeof BUDGET_SCENES)[number];
+/** Scenes that are an operation in flight — see `sceneProps`. */
+export declare const BUDGET_IN_FLIGHT: readonly string[];
+/** At most this many categories — "+ Add category" hides at seven. */
+export declare const MAX_CATEGORIES = 7;
+export type BudgetSettings = HeaderConfig & LoadCopy & {
+    total: number;
+    /** Before every figure — `$`. Empty for a unit without one (credits). */
+    prefix: string;
+    /** After every figure — ` / mo`, ` credits`. */
+    suffix: string;
+    /** The amount field's own suffix — `credits`. */
+    fieldSuffix: string;
+    /** Right of "Allocated" — "USD per month". */
+    unitHint: string;
+    categories: BudgetCategory[];
+    /** A category's share above this (0–1) is flagged apricot. Decision (PRD §5): a per-category share threshold. */
+    attentionAt: number;
+    allowAdd: boolean;
+    /** How far the demo's "over" scene over-allocates. Demo boards only. */
+    overBy?: number;
+    ship?: BudgetScene;
+    primaryLabel: string;
+    savingLabel: string;
+    savedLabel: string;
+    secondaryLabel?: string;
+    saveErrorTitle: string;
+    saveErrorBody: string;
+};
+export declare const BUDGET_PRESETS: PresetsFile<BudgetSettings>;
+export declare function validateBudget(c: BudgetSettings): OnboardingIssue[];
+/** A figure in the budget's unit — `$25,000`, `1,000,000 credits`. */
+export declare function formatAmount(c: Pick<BudgetSettings, 'prefix' | 'suffix'>, n: number): string;
+//# sourceMappingURL=contract.d.ts.map

package/dist/esm/components/onboarding/budget-allocation/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../../../src/components/onboarding/budget-allocation/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG/F;;;GAGG;AAEH,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5F,eAAO,MAAM,aAAa,0GAA2G,CAAC;AACtI,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AACzD,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAAe,CAAC;AAE9D,sEAAsE;AACtE,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,QAAQ,GAAG;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,iHAAiH;IACjH,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,cAAc,EAA6B,WAAW,CAAC,cAAc,CAAC,CAAC;AAEpF,wBAAgB,cAAc,CAAC,CAAC,EAAE,cAAc,GAAG,eAAe,EAAE,CAUnE;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5F"}

package/dist/esm/components/onboarding/budget-allocation/contract.js

@@ -0,0 +1,28 @@
+import presetsJson from './presets.json';
+export const BUDGET_SCENES = ['default', 'under', 'exact', 'over', 'saving', 'saved', 'failed', 'loading', 'empty', 'error'];
+/** Scenes that are an operation in flight — see `sceneProps`. */
+export const BUDGET_IN_FLIGHT = ['saving'];
+/** At most this many categories — "+ Add category" hides at seven. */
+export const MAX_CATEGORIES = 7;
+export const BUDGET_PRESETS = presetsJson;
+export function validateBudget(c) {
+    if (!Array.isArray(c.categories))
+        return [{ path: 'categories', message: 'categories must be a list.' }];
+    const issues = [];
+    if (!(c.total > 0))
+        issues.push({ path: 'total', message: 'total must be more than 0.' });
+    if (!(c.attentionAt > 0 && c.attentionAt <= 1))
+        issues.push({ path: 'attentionAt', message: 'attentionAt is a share between 0 and 1.' });
+    if (c.categories.length > MAX_CATEGORIES)
+        issues.push({ path: 'categories', message: `At most ${MAX_CATEGORIES} categories.` });
+    c.categories.forEach((k, i) => {
+        if (!(k.amount >= 0) || !Number.isInteger(k.amount))
+            issues.push({ path: `categories[${i}].amount`, message: 'Amounts are whole numbers, 0 or more.' });
+    });
+    return issues;
+}
+/** A figure in the budget's unit — `$25,000`, `1,000,000 credits`. */
+export function formatAmount(c, n) {
+    return `${c.prefix ?? ''}${n.toLocaleString('en-US')}${c.suffix ?? ''}`;
+}
+//# sourceMappingURL=contract.js.map

package/dist/esm/components/onboarding/budget-allocation/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../../../src/components/onboarding/budget-allocation/contract.ts"],"names":[],"mappings":"AAEA,OAAO,WAAW,MAAM,gBAAgB,CAAC;AASzC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AAEtI,iEAAiE;AACjE,MAAM,CAAC,MAAM,gBAAgB,GAAsB,CAAC,QAAQ,CAAC,CAAC;AAE9D,sEAAsE;AACtE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AA2BhC,MAAM,CAAC,MAAM,cAAc,GAAG,WAAqD,CAAC;AAEpF,MAAM,UAAU,cAAc,CAAC,CAAiB;IAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC;IACzG,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC;IAC1F,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,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,cAAc;QAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,cAAc,cAAc,EAAE,CAAC,CAAC;IAChI,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC5B,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,UAAU,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC,CAAC;IAC1J,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,YAAY,CAAC,CAA4C,EAAE,CAAS;IAClF,OAAO,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,GAAG,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;AAC1E,CAAC"}

package/dist/esm/components/onboarding/budget-allocation/engine.d.ts

@@ -0,0 +1,81 @@
+import type { StateChipTone } from '../../../ds';
+import type { SavePhase } from '../shared/contract';
+import { type BudgetScene, type BudgetSettings } from './contract';
+/** **The Budget Allocation engine** — pure: rows, amounts, the save, and every derived figure. */
+export type BudgetRow = {
+    id: string;
+    name: string;
+    type: BudgetSettings['categories'][number]['type'];
+    icon: string;
+    /** `null` while the field is empty — not 0. */
+    amount: number | null;
+    /** Added in this session: its name is an editable field. */
+    isNew: boolean;
+    /** Removed, playing its exit (M14); the engine drops it on `drop`. */
+    leaving: boolean;
+};
+export type BudgetState = {
+    rows: BudgetRow[];
+    save: SavePhase;
+    nextId: number;
+};
+export type BudgetSeed = {
+    amounts?: (number | null)[];
+    save?: SavePhase;
+    rows?: BudgetRow[];
+};
+export type BudgetAction = {
+    type: 'amount';
+    id: string;
+    amount: number | null;
+} | {
+    type: 'name';
+    id: string;
+    name: string;
+} | {
+    type: 'add';
+} | {
+    type: 'remove';
+    id: string;
+    immediate?: boolean;
+} | {
+    type: 'drop';
+    id: string;
+} | {
+    type: 'save';
+} | {
+    type: 'saved';
+} | {
+    type: 'failed';
+} | {
+    type: 'reset';
+    state: BudgetState;
+};
+export declare function initialBudget(c: BudgetSettings, seed?: BudgetSeed): BudgetState;
+/**
+ * The demo scenes as seeds: `under` rescales to ~88% of the total, `over` to total + `overBy`,
+ * `exact` (and the save scenes) to the total — proportionally, rounded to 100, the last row
+ * taking the remainder. Verbatim from the prototype.
+ */
+export declare function budgetSeed(c: BudgetSettings, scene: BudgetScene): BudgetSeed;
+export declare const liveRows: (s: BudgetState) => BudgetRow[];
+export declare const isLocked: (s: BudgetState) => boolean;
+export declare function reduceBudget(s: BudgetState, a: BudgetAction): BudgetState;
+export type Allocation = 'under' | 'exact' | 'over';
+export declare function budgetView(c: BudgetSettings, s: BudgetState): {
+    alloc: number;
+    rem: number;
+    mode: Allocation;
+    chip: {
+        tone: StateChipTone;
+        label: string;
+    };
+    scene: BudgetScene;
+    remCaption: string;
+    canSave: boolean;
+    canAdd: boolean;
+    primaryLabel: string;
+    share: (r: BudgetRow) => number;
+    hot: (r: BudgetRow) => boolean;
+};
+//# sourceMappingURL=engine.d.ts.map