@appinternalleads/ui 0.2.0

package/dist/esm/ds/blockSequence.js

@@ -0,0 +1,133 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { Box, Icon, MotionView, Pressable, Scroll, Text, useTween } from '../core';
+import { useDs } from '../tokens';
+import { MetaChip } from './blocks';
+const STATE_WORD = {
+    done: 'done', current: 'current step', pending: 'not started', attention: 'needs attention',
+};
+/** The 20px node — done is ink with a tick, current an ink ring with a dot, pending a hollow rim. */
+function Node({ state }) {
+    const { colors } = useDs();
+    const ring = state === 'current' ? colors.textPrimary
+        : state === 'attention' ? colors.status.needsUser
+            : state === 'done' ? colors.textPrimary
+                : colors.controlBorder;
+    return (_jsxs(Box, { width: 20, height: 20, align: "center", justify: "center", radius: "pill", style: {
+            borderWidth: 1.5,
+            borderColor: ring,
+            backgroundColor: state === 'done' ? colors.textPrimary
+                : state === 'attention' ? colors.statusBg.needsUser
+                    : colors.surface1,
+        }, children: [state === 'done' ? _jsx(Icon, { name: "check", size: 11, color: colors.surface1 }) : null, state === 'current' ? _jsx(Box, { width: 8, height: 8, radius: "pill", style: { backgroundColor: colors.textPrimary } }) : null, state === 'attention' ? _jsx(Icon, { name: "alert", size: 11, color: colors.status.needsUser }) : null] }));
+}
+/* ── Q1 · Vertical stepper ───────────────────────────────────────────────── */
+/**
+ * **Done, current, pending, attention — a list, not a picture of one.** Each step is a list item
+ * whose name includes its state ("Deploy, current step"), and the current one carries
+ * `aria-current="step"`, so a screen reader hears where the user is without seeing the ring.
+ */
+export function VerticalStepper({ label, steps }) {
+    const { colors } = useDs();
+    return (_jsx(Box, { role: "list", "aria-label": label, children: steps.map((s, i) => (_jsxs(Box, { role: "listitem", "aria-label": `${s.label}, ${STATE_WORD[s.state]}`, "aria-current": s.state === 'current' ? 'step' : undefined, row: true, gap: "s3", style: { minHeight: 44 }, children: [_jsxs(Box, { align: "center", style: { width: 20 }, children: [_jsx(Node, { state: s.state }), i < steps.length - 1 ? (_jsx(Box, { flex: 1, style: {
+                                width: 2, minHeight: 16, marginVertical: 2, borderRadius: 1,
+                                backgroundColor: s.state === 'done' ? colors.textPrimary : colors.hairlineStrong,
+                            } })) : null] }), _jsxs(Box, { flex: 1, pb: "s3", style: { minWidth: 0 }, children: [_jsx(Text, { variant: "caption", color: s.state === 'pending' ? 'textSecondary' : 'textPrimary', style: { fontWeight: s.state === 'current' ? '600' : '400', lineHeight: 20 }, children: s.label }), s.detail ? _jsx(Text, { variant: "caption", color: "textSecondary", style: { fontSize: 12 }, children: s.detail }) : null] })] }, s.id))) }));
+}
+/* ── Q2 · Horizontal timeline ────────────────────────────────────────────── */
+/** A column never narrower than this; past the container's width the timeline scrolls. */
+export const TIMELINE_MIN_COLUMN = 96;
+/**
+ * **Columns at least 96px wide; scrolls when they do not fit, and centres the current step.**
+ * The scroll is the container's, so a long shipment history never widens the page.
+ */
+export function Timeline({ label, steps, variant = 'centred' }) {
+    if (variant === 'track')
+        return _jsx(TrackTimeline, { label: label, steps: steps });
+    return _jsx(CentredTimeline, { label: label, steps: steps });
+}
+function CentredTimeline({ label, steps }) {
+    const { colors } = useDs();
+    const scroll = useRef(null);
+    const [width, setWidth] = useState(0);
+    const current = Math.max(0, steps.findIndex(s => s.state === 'current'));
+    const column = Math.max(TIMELINE_MIN_COLUMN, steps.length ? width / steps.length : TIMELINE_MIN_COLUMN);
+    useEffect(() => {
+        if (!width)
+            return;
+        const x = current * column + column / 2 - width / 2;
+        scroll.current?.scrollTo({ x: Math.max(0, x), animated: false });
+    }, [width, current, column]);
+    return (_jsx(Box, { onLayout: e => setWidth(e.nativeEvent.layout.width), style: { width: '100%' }, children: _jsx(Scroll, { horizontal: true, ref: scroll, children: _jsx(Box, { row: true, role: "list", "aria-label": label, children: steps.map((s, i) => (_jsxs(Box, { role: "listitem", "aria-label": `${s.label}${s.detail ? `, ${s.detail}` : ''}, ${STATE_WORD[s.state]}`, "aria-current": s.state === 'current' ? 'step' : undefined, style: { width: column }, gap: "s2", children: [_jsxs(Box, { row: true, align: "center", children: [_jsx(Box, { flex: 1, style: { height: 2, backgroundColor: i === 0 ? 'transparent' : steps[i - 1].state === 'done' ? colors.textPrimary : colors.hairlineStrong } }), _jsx(Node, { state: s.state }), _jsx(Box, { flex: 1, style: { height: 2, backgroundColor: i === steps.length - 1 ? 'transparent' : s.state === 'done' ? colors.textPrimary : colors.hairlineStrong } })] }), _jsxs(Box, { align: "center", px: "s1", children: [_jsx(Text, { variant: "caption", align: "center", numberOfLines: 2, color: s.state === 'pending' ? 'textSecondary' : 'textPrimary', style: { fontWeight: s.state === 'current' ? '600' : '400', fontSize: 12 }, children: s.label }), s.detail ? _jsx(Text, { variant: "caption", color: "textSecondary", align: "center", style: { fontSize: 11 }, children: s.detail }) : null] })] }, s.id))) }) }) }));
+}
+/** Q2 `track`: a column is never narrower than this — narrow screens scroll the list, not the page. */
+export const TRACK_MIN_COLUMN = 120;
+function TrackNode({ state }) {
+    const { colors } = useDs();
+    const done = state === 'done';
+    return (_jsxs(Box, { width: 20, height: 20, align: "center", justify: "center", radius: "pill", style: {
+            backgroundColor: done ? colors.textPrimary : colors.surface1,
+            borderWidth: done ? 0 : state === 'attention' ? 3 : state === 'current' ? 2 : 1.5,
+            borderColor: state === 'attention' ? colors.status.needsUser : state === 'current' ? colors.textPrimary : colors.hairlineStrong,
+        }, children: [done ? _jsx(Icon, { name: "tick", size: 12, color: colors.surface1 }) : null, state === 'current' ? _jsx(Box, { width: 6, height: 6, radius: "pill", style: { backgroundColor: colors.textPrimary } }) : null] }));
+}
+/** The connector after a node: a 2px track whose ink fill grows from the left (M6). */
+function TrackLine({ filled }) {
+    const { colors } = useDs();
+    const k = useTween(filled ? 1 : 0);
+    return (_jsx(Box, { flex: 1, radius: "pill", style: { height: 2, marginHorizontal: 6, overflow: 'hidden', backgroundColor: colors.hairlineStrong }, children: _jsx(MotionView, { style: { height: 2, width: k.interpolate({ inputRange: [0, 1], outputRange: ['0%', '100%'] }), backgroundColor: colors.textPrimary } }) }));
+}
+function TrackTimeline({ label, steps }) {
+    const { colors } = useDs();
+    const [width, setWidth] = useState(0);
+    const column = Math.max(TRACK_MIN_COLUMN, steps.length && width ? width / steps.length : TRACK_MIN_COLUMN);
+    return (_jsx(Box, { onLayout: e => setWidth(e.nativeEvent.layout.width), style: { width: '100%' }, children: _jsx(Scroll, { horizontal: true, children: _jsx(Box, { row: true, role: "list", "aria-label": label, children: steps.map((s, i) => (_jsxs(Box, { role: "listitem", "aria-label": `${s.label}${s.detail ? `, ${s.detail}` : ''}, ${STATE_WORD[s.state]}${s.note ? `, ${s.note}` : ''}`, "aria-current": s.state === 'current' || s.state === 'attention' ? 'step' : undefined, style: { width: column }, gap: "s1", children: [_jsxs(Box, { row: true, align: "center", style: { marginBottom: 2 }, children: [_jsx(TrackNode, { state: s.state }), i < steps.length - 1 ? _jsx(TrackLine, { filled: s.state === 'done' }) : null] }), _jsx(Text, { variant: "caption", color: s.state === 'pending' ? 'textSecondary' : 'textPrimary', style: { fontSize: 13, paddingRight: 8, fontWeight: s.state === 'current' || s.state === 'attention' ? '700' : '600' }, children: s.label }), s.detail ? _jsx(Text, { variant: "caption", color: "textSecondary", numeric: true, style: { fontSize: 12 }, children: s.detail }) : null, s.note ? _jsx(Text, { variant: "caption", style: { fontSize: 12, fontWeight: '700', color: colors.status.needsUser }, children: s.note }) : null] }, s.id))) }) }) }));
+}
+/* ── Q3 · Dot pager ──────────────────────────────────────────────────────── */
+/** Past this many pages, a row of dots stops being countable — use `StepCounter`. */
+export const DOT_PAGER_MAX = 7;
+function PagerDot({ active, tone }) {
+    const { colors } = useDs();
+    /* Neutral: the active dot widens 6 → 18px. Accent (onboarding carousel): an 8px dot that
+       stretches to scaleX(2.5) and turns coral (M7). Both at `--motion-state`; reduced motion jumps. */
+    const w = useTween(active ? 18 : 6);
+    const k = useTween(active ? 2.5 : 1);
+    if (tone === 'accent') {
+        return (_jsx(MotionView, { style: {
+                height: 8, width: 8, borderRadius: 4, transform: [{ scaleX: k }],
+                backgroundColor: active ? colors.accentFill : colors.hairlineStrong,
+            } }));
+    }
+    return (_jsx(MotionView, { style: {
+            height: 6, width: w, borderRadius: 3,
+            backgroundColor: active ? colors.textPrimary : colors.controlBorder,
+        } }));
+}
+/**
+ * **A dot per page; the active one widens.** Each dot is a target named "Page 3 of 5" (or the
+ * caller's `itemLabel`), the active one `aria-current`. Over `DOT_PAGER_MAX` pages this warns in
+ * development and still renders — the fix is the caller's (switch to `StepCounter`).
+ *
+ * `tone="accent"` is the onboarding carousel's pager (decision D14): 28×24 targets, an 8px dot, the
+ * active one coral and stretched. Neutral stays the default — the Building Blocks rule that a
+ * sequence is never hue-coded holds everywhere else.
+ */
+export function DotPager({ label, count, index, onChange, tone = 'neutral', itemLabel, }) {
+    if (count > DOT_PAGER_MAX && typeof process !== 'undefined' && process.env?.NODE_ENV !== 'production') {
+        console.warn(`[DotPager] ${count} pages is past ${DOT_PAGER_MAX} — use StepCounter.`);
+    }
+    return (_jsx(Box, { row: true, align: "center", role: "group", "aria-label": label, alignSelf: "center", wrap: true, children: Array.from({ length: count }, (_, i) => (_jsx(Pressable, { "aria-label": itemLabel ? itemLabel(i, count) : `Page ${i + 1} of ${count}`, "aria-current": i === index ? (tone === 'accent' ? true : 'page') : undefined, onPress: () => onChange(i), width: tone === 'accent' ? 28 : 24, height: 24, children: _jsx(PagerDot, { active: i === index, tone: tone }) }, i))) }));
+}
+/* ── Q4 · Step counter ───────────────────────────────────────────────────── */
+/**
+ * **"Step 2 of 5", with what comes next.** The last step shows a mint "All set" chip instead of a
+ * next line — there is no next, and saying so is the point of reaching it.
+ */
+export function StepCounter({ index, total, next, doneLabel = 'All set', }) {
+    const last = index >= total - 1;
+    return (_jsxs(Box, { row: true, wrap: true, align: "center", gap: "s2", role: "status", "aria-live": "polite", children: [_jsx(Text, { variant: "caption", numeric: true, style: { fontWeight: '600' }, color: "textPrimary", children: `Step ${Math.min(index + 1, total)} of ${total}` }), last
+                ? _jsx(MetaChip, { kind: "status", status: "executed", children: doneLabel })
+                : next ? _jsx(Text, { variant: "caption", color: "textSecondary", children: `Up next · ${next}` }) : null] }));
+}
+//# sourceMappingURL=blockSequence.js.map

package/dist/esm/ds/blockSequence.js.map

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

package/dist/esm/ds/blocks.d.ts

@@ -0,0 +1,158 @@
+import type { ReactNode } from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+import { type IconName } from '../core';
+import { type DataType, type Hue, type Status } from '../tokens';
+/**
+ * **Solarium Building Blocks — the pieces ThresholdFlow is assembled from that did not exist.**
+ *
+ * Source: `design_handoff_solarium_blocks_case_studies`, reconciled in
+ * `docs/HANDOFF-SOLARIUM-BLOCKS.md` (§3 grades each block; this file closes D1, D6, D9 and S1).
+ * Geometry reads `blockRadii` and the handoff's pixel values; colour reads `useDs()` and `HUE`,
+ * never a literal.
+ */
+export type CalloutTone = 'attention' | 'info';
+/**
+ * **Says what happened and what to do. No red.**
+ *
+ * Inline, inside a card — which is what separates it from `Banner`, a screen-level bar. The
+ * default tone is apricot (`status.needsUser`): something needs the user, nothing is broken. The
+ * handoff's "no red" is the point — a callout is a request to act, and `alertInk` is reserved for a
+ * terminal failure (C7). `info` takes sky (`reference`), as `Banner` does.
+ */
+export declare function Callout({ title, children, tone, action, alert, strong, testID, style, }: {
+    title: string;
+    /**
+     * A hard failure (batch 3 decision §5.2): the title at 700 — "Couldn't claim your reward",
+     * "Held at customs". Weight, words and a recovery action carry it; still no red.
+     */
+    strong?: boolean;
+    /** Announce on appearance (`role="alert"`) — for a callout that reports something that just
+        happened, like a failed activation. A standing note stays silent. */
+    alert?: boolean;
+    /** What to do about it. */
+    children?: ReactNode;
+    tone?: CalloutTone;
+    action?: ReactNode;
+    testID?: string;
+    style?: StyleProp<ViewStyle>;
+}): import("react").JSX.Element;
+/**
+ * **The leading tile, its hue looked up from the data type rather than chosen.**
+ *
+ * `type` resolves through `TYPE_HUE`; `hue` is an override `hueForType` warns about when it
+ * disagrees. Resting is the hue's soft ground and deep ink; `active` swaps to the mid rung with
+ * its `on` ink — butter's dark brown included, which is why `on` is read and never assumed white.
+ *
+ * Radius is the ladder's tile rung (6) at every size (Solarium 0.2.0).
+ */
+export declare function TypeTile({ type, hue, icon, size, active, label, }: {
+    type?: DataType;
+    hue?: Hue;
+    icon: IconName;
+    size?: number;
+    active?: boolean;
+    /** Only when the tile stands alone; beside its own title it is decoration. */
+    label?: string;
+}): import("react").JSX.Element;
+export type MetaChipProps = 
+/** A status word on its ground, with a 6px dot. The word carries it; the dot is redundant. */
+{
+    kind: 'status';
+    status: Status;
+    children: string;
+}
+/** A number or amount in a category's hue pair. */
+ | {
+    kind: 'count';
+    type?: DataType;
+    hue?: Hue;
+    children: string;
+}
+/** A field name or value — white, hairline, taller. */
+ | {
+    kind: 'field';
+    children: string;
+};
+/**
+ * **Status, count, field — meaning in the label, not the colour.**
+ *
+ * Not `Chip`: that one is a selectable mono label and is used as such across the widgets. This
+ * one never takes a press — it reports.
+ */
+export declare function MetaChip(props: MetaChipProps): import("react").JSX.Element;
+export type BlockCardStatus = 'ready' | 'loading' | 'empty' | 'error';
+export type BlockCardProps = {
+    title: string;
+    /** One line under the title — what the card is for. */
+    subtitle?: string;
+    /** Leading tile. Omit both for a card with no tile. */
+    icon?: IconName;
+    type?: DataType;
+    hue?: Hue;
+    /** Right of the title: a chip, a count. Hidden while loading or empty; replaced while in error. */
+    meta?: ReactNode;
+    status?: BlockCardStatus;
+    /** Body when `status="empty"` — what is missing and **exactly one** way to fix it. */
+    empty?: {
+        title: string;
+        body: string;
+        action?: ReactNode;
+        icon?: IconName;
+    };
+    /**
+     * Body when `status="error"` — the pattern's LOAD failure: an apricot alert and a ghost Retry.
+     * `onRetry` renders the Retry button (the host reloads; the card shows `loading` while it does);
+     * `action` replaces it with the caller's own control.
+     */
+    error?: {
+        title: string;
+        body: string;
+        action?: ReactNode;
+        onRetry?: () => void;
+        retryLabel?: string;
+        chipLabel?: string;
+    };
+    /** Left of the footer: a line of state — "Live · runs on every new request". */
+    hint?: ReactNode;
+    /** Right of the footer: the card's buttons. One primary per view. */
+    actions?: ReactNode;
+    children?: ReactNode;
+    testID?: string;
+    style?: StyleProp<ViewStyle>;
+    /**
+     * `false` draws no header row — a summary card whose body leads (onboarding Completion). The title
+     * still names the card for assistive technology.
+     */
+    header?: boolean;
+    /**
+     * The body without its padding — for a body that draws to the card's edge: a mock app behind a
+     * toast stack, a side panel with its own rule (batch 3's Floating and Filter Panel).
+     */
+    flush?: boolean;
+    /**
+     * `stacked`: the actions full-width on top, the hint centred under them — one full-width primary
+     * (C13), batch 3's Password Expiry. Default `row`: hint left, actions right.
+     */
+    footer?: 'row' | 'stacked';
+    /**
+     * The header's meta may drop under the title when both do not fit — a wide meta (a chip and a
+     * button: batch 3's Mark Read) at phone width. Default: the meta never wraps and the title shrinks.
+     */
+    metaWraps?: boolean;
+};
+/**
+ * **Header · body · footer, in four pattern states — the shell every Solarium component sits in (S1).**
+ *
+ * Solarium 0.2.0 / the onboarding handoff's shared shell: a 1px line-soft border and the flattened
+ * `--lift-1`; header padding 18/20/16 with a line-soft rule; footer padding 14/20 with a hint left
+ * and the actions right. The pattern status changes the BODY, and while it is not `ready` the footer
+ * and the header chip step aside:
+ * - **loading** — four skeleton rows (a 32px block, two pill bars, an 80px pill), `aria-busy`;
+ * - **empty** — centred, padding 56/32: a 40px tile, a title, a body, exactly one action;
+ * - **error** — an apricot alert and a ghost Retry; the header chip becomes "Needs attention".
+ *
+ * A component's OWN failures (a save that did not land) are not this state — they are part of its
+ * ready body, which keeps the user's work on screen.
+ */
+export declare function BlockCard({ title, subtitle, icon, type, hue, meta, status, empty, error, hint, actions, children, testID, style, header, flush, footer, metaWraps, }: BlockCardProps): import("react").JSX.Element;
+//# sourceMappingURL=blocks.d.ts.map

package/dist/esm/ds/blocks.d.ts.map

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

package/dist/esm/ds/blocks.js

@@ -0,0 +1,116 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Icon, MotionView, Text, useSwap } from '../core';
+import { blockRadii, HUE, hueForType, useDs, } from '../tokens';
+import { HeaderMeta, SkeletonBar } from './blockDisplay';
+import { Button } from './Button';
+/**
+ * **Says what happened and what to do. No red.**
+ *
+ * Inline, inside a card — which is what separates it from `Banner`, a screen-level bar. The
+ * default tone is apricot (`status.needsUser`): something needs the user, nothing is broken. The
+ * handoff's "no red" is the point — a callout is a request to act, and `alertInk` is reserved for a
+ * terminal failure (C7). `info` takes sky (`reference`), as `Banner` does.
+ */
+export function Callout({ title, children, tone = 'attention', action, alert = false, strong = false, testID, style, }) {
+    const { colors } = useDs();
+    const skin = tone === 'info'
+        ? { ground: colors.reference.bg, ink: colors.reference.fg, icon: 'info' }
+        : { ground: colors.statusBg.needsUser, ink: colors.status.needsUser, icon: 'alert' };
+    return (_jsxs(Box, { row: true, gap: "s2", p: "s3", role: alert ? 'alert' : undefined, testID: testID, style: [{ backgroundColor: skin.ground, borderRadius: blockRadii.mid }, style], children: [_jsx(Box, { pt: "s1", children: _jsx(Icon, { name: skin.icon, size: 14, color: skin.ink }) }), _jsxs(Box, { flex: 1, gap: "s1", children: [_jsx(Text, { variant: "caption", style: { color: skin.ink, fontWeight: strong ? '700' : '600' }, children: title }), children ? (_jsx(Text, { variant: "caption", color: "textPrimary", style: { fontSize: 12, lineHeight: 17 }, children: children })) : null, action ? _jsx(Box, { pt: "s1", alignSelf: "flex-start", children: action }) : null] })] }));
+}
+/* ── D6 · Type tile ──────────────────────────────────────────────────────── */
+/**
+ * **The leading tile, its hue looked up from the data type rather than chosen.**
+ *
+ * `type` resolves through `TYPE_HUE`; `hue` is an override `hueForType` warns about when it
+ * disagrees. Resting is the hue's soft ground and deep ink; `active` swaps to the mid rung with
+ * its `on` ink — butter's dark brown included, which is why `on` is read and never assumed white.
+ *
+ * Radius is the ladder's tile rung (6) at every size (Solarium 0.2.0).
+ */
+export function TypeTile({ type, hue, icon, size = 28, active = false, label, }) {
+    const set = HUE[hueForType(type, hue)];
+    return (_jsx(Box, { width: size, height: size, align: "center", justify: "center", "aria-label": label, style: {
+            backgroundColor: active ? set.h : set.hs,
+            /* `--r-tile` (6) at every size — 0.2.0's radius ladder names the IconTile's rung once. */
+            borderRadius: blockRadii.tile,
+        }, children: _jsx(Icon, { name: icon, size: Math.round(size * 0.55), color: active ? set.on : set.hd }) }));
+}
+/**
+ * **Status, count, field — meaning in the label, not the colour.**
+ *
+ * Not `Chip`: that one is a selectable mono label and is used as such across the widgets. This
+ * one never takes a press — it reports.
+ */
+export function MetaChip(props) {
+    const { colors } = useDs();
+    const field = props.kind === 'field';
+    let ground;
+    let ink;
+    if (props.kind === 'status') {
+        ground = colors.statusBg[props.status];
+        ink = colors.status[props.status];
+    }
+    else if (props.kind === 'count') {
+        const set = HUE[hueForType(props.type, props.hue)];
+        ground = set.hs;
+        ink = set.hd;
+    }
+    else {
+        ground = colors.surface1;
+        ink = colors.textPrimary;
+    }
+    return (_jsxs(Box, { row: true, align: "center", alignSelf: "flex-start", gap: "s1", height: field ? 28 : 24, radius: "pill", style: {
+            /* 0.2.0 StatusChip: 24px, padding 0 10, 12/600 (FieldChip 28px). */
+            paddingHorizontal: field ? 12 : 10,
+            backgroundColor: ground,
+            ...(field && { borderWidth: 1, borderColor: colors.hairlineStrong }),
+        }, children: [props.kind === 'status' ? (_jsx(Box, { width: 6, height: 6, radius: "pill", style: { backgroundColor: ink } })) : null, _jsx(Text, { variant: "caption", numeric: props.kind === 'count', numberOfLines: 1, style: { color: ink, fontSize: 12, lineHeight: 16, fontWeight: '600' }, children: props.children })] }));
+}
+/** The skeleton rows' bar widths — the onboarding handoff's, verbatim. */
+const SKELETON_ROWS = [['44%', '28%'], ['36%', '22%'], ['50%', '30%'], ['40%', '26%']];
+/**
+ * **Header · body · footer, in four pattern states — the shell every Solarium component sits in (S1).**
+ *
+ * Solarium 0.2.0 / the onboarding handoff's shared shell: a 1px line-soft border and the flattened
+ * `--lift-1`; header padding 18/20/16 with a line-soft rule; footer padding 14/20 with a hint left
+ * and the actions right. The pattern status changes the BODY, and while it is not `ready` the footer
+ * and the header chip step aside:
+ * - **loading** — four skeleton rows (a 32px block, two pill bars, an 80px pill), `aria-busy`;
+ * - **empty** — centred, padding 56/32: a 40px tile, a title, a body, exactly one action;
+ * - **error** — an apricot alert and a ghost Retry; the header chip becomes "Needs attention".
+ *
+ * A component's OWN failures (a save that did not land) are not this state — they are part of its
+ * ready body, which keeps the user's work on screen.
+ */
+export function BlockCard({ title, subtitle, icon, type, hue, meta, status = 'ready', empty, error, hint, actions, children, testID, style, header = true, flush = false, footer = 'row', metaWraps = false, }) {
+    const { colors, lift1 } = useDs();
+    /* M4: when the status changes (loading → ready), the new body fades in. */
+    const bodyFade = useSwap(status);
+    const ready = status === 'ready';
+    const hasFooter = ready && (hint !== undefined || actions !== undefined);
+    let body = children;
+    if (status === 'loading') {
+        body = (_jsx(Box, { gap: "s4", role: "progressbar", "aria-label": `Loading ${title}`, "aria-busy": true, children: SKELETON_ROWS.map(([a, b]) => (_jsxs(Box, { row: true, align: "center", gap: "s3", children: [_jsx(Box, { width: 32, height: 32, style: { borderRadius: blockRadii.tile, backgroundColor: colors.band } }), _jsxs(Box, { flex: 1, gap: "s2", children: [_jsx(SkeletonBar, { width: a, height: 10 }), _jsx(SkeletonBar, { width: b, height: 8 })] }), _jsx(SkeletonBar, { width: 80, height: 10 })] }, a))) }));
+    }
+    else if (status === 'empty' && empty) {
+        body = (_jsxs(Box, { align: "center", gap: "s2", style: { paddingVertical: 36, paddingHorizontal: 12 }, children: [_jsx(Box, { width: 40, height: 40, align: "center", justify: "center", style: { borderRadius: blockRadii.inset, backgroundColor: colors.surfaceSunken }, children: _jsx(Icon, { name: empty.icon ?? icon ?? 'plus', size: 20, color: colors.textSecondary }) }), _jsx(Text, { variant: "label", align: "center", style: { fontWeight: '600', fontSize: 14 }, children: empty.title }), _jsx(Text, { variant: "caption", color: "textSecondary", align: "center", style: { fontSize: 12, maxWidth: 340 }, children: empty.body }), empty.action ? _jsx(Box, { pt: "s2", children: empty.action }) : null] }));
+    }
+    else if (status === 'error' && error) {
+        body = (_jsx(Callout, { alert: true, title: error.title, action: error.action ?? (error.onRetry
+                ? _jsx(Button, { variant: "secondary", size: "small", onPress: error.onRetry, children: error.retryLabel ?? 'Retry' })
+                : undefined), children: error.body }));
+    }
+    const chip = status === 'error'
+        ? _jsx(MetaChip, { kind: "status", status: "needsUser", children: error?.chipLabel ?? 'Needs attention' })
+        : ready ? meta : undefined;
+    return (_jsxs(Box, { bg: "surface1", testID: testID, "aria-label": header ? undefined : title, "aria-busy": status === 'loading' || undefined, style: [{ borderRadius: blockRadii.major, borderWidth: 1, borderColor: colors.hairline, boxShadow: lift1, overflow: 'hidden' }, style], children: [header ? _jsxs(Box, { row: true, align: "center", gap: "s3", wrap: metaWraps, style: { paddingTop: 18, paddingHorizontal: 20, paddingBottom: 16, borderBottomWidth: 1, borderBottomColor: colors.hairline }, children: [icon ? _jsx(TypeTile, { icon: icon, type: type, hue: hue, size: 32 }) : null, _jsxs(Box, { flex: 1, style: { minWidth: metaWraps ? 150 : 0 }, children: [_jsx(Text, { variant: "label", role: "heading", "aria-level": 2, style: { fontWeight: '600', fontSize: 14, letterSpacing: -0.015 * 14 }, numberOfLines: 1, children: title }), subtitle ? _jsx(Text, { variant: "caption", color: "textSecondary", style: { fontSize: 12 }, children: subtitle }) : null] }), chip !== undefined && chip !== null ? (metaWraps ? _jsx(Box, { style: { marginLeft: 'auto' }, children: _jsx(HeaderMeta, { children: chip }) }) : _jsx(HeaderMeta, { children: chip })) : null] }) : null, _jsx(MotionView, { style: { opacity: bodyFade }, children: flush && ready ? _jsx(Box, { children: body }) : _jsx(Box, { p: "s4", gap: "s3", style: { paddingHorizontal: 20 }, children: body }) }), hasFooter && footer === 'stacked' ? (_jsxs(Box, { gap: "s2", style: { paddingVertical: 14, paddingHorizontal: 20, borderTopWidth: 1, borderTopColor: colors.hairline }, children: [actions, typeof hint === 'string'
+                        ? _jsx(Text, { variant: "caption", color: "textSecondary", numeric: true, align: "center", style: { fontSize: 12 }, children: hint })
+                        : hint] })) : hasFooter ? (
+            /* Wraps rather than squeezes: at phone width the hint takes its own line above the buttons. */
+            _jsxs(Box, { row: true, wrap: true, align: "center", gap: "s3", style: { paddingVertical: 14, paddingHorizontal: 20, borderTopWidth: 1, borderTopColor: colors.hairline }, children: [_jsx(Box, { style: { flexGrow: 1, flexBasis: 160, minWidth: 0 }, children: typeof hint === 'string'
+                            ? _jsx(Text, { variant: "caption", color: "textSecondary", numeric: true, style: { fontSize: 12 }, children: hint })
+                            : hint }), actions !== undefined ? _jsx(Box, { row: true, wrap: true, gap: "s2", align: "center", style: { marginLeft: 'auto' }, children: actions }) : null] })) : null] }));
+}
+//# sourceMappingURL=blocks.js.map

package/dist/esm/ds/blocks.js.map

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

package/dist/esm/ds/groupedRows.d.ts

@@ -0,0 +1,97 @@
+import { type ReactNode } from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+import { type IconName } from '../core';
+/**
+ * **The Settings handoff's Row, and the group it lives in** (`design_handoff_padki_settings`,
+ * Component Spec · Row — "the single most reused component").
+ *
+ * Not `ListRow`. That row has no value slot, lets its title wrap, pads 12/16 rather than 14, and
+ * sits alone rather than in a divided group; bending it to this spec would move every one of its
+ * call sites in two apps. Not `SettingRow` either — that is a label beside a control and nothing
+ * else.
+ */
+type RowBase = {
+    title: string;
+    /** One line, ellipsized. */
+    subtitle?: string;
+    /** A real glyph only — never a character standing in for one. */
+    icon?: IconName;
+    /** Profile only: where the value came from — `YOU` or `DEVICE`. */
+    provenance?: string;
+    /** Machine-owned titles (`QWERTY`, a trigger) are set in mono — the design system's one rule for it. */
+    titleMono?: boolean;
+    /**
+     * A leading control — Android's selection radio sits here, where iOS puts its check at the trailing
+     * edge (`control`). Drawn before the title, after any icon.
+     */
+    leading?: ReactNode;
+    /** A selection row's state. Announced with the label, since the check or radio is only drawn. */
+    selected?: boolean;
+    testID?: string;
+};
+/** Pushes a sub-screen: carries the chevron, with or without a value beside it. */
+type PushRow = {
+    onPush: () => void;
+    value?: string;
+    valueMono?: boolean;
+    control?: never;
+    onPress?: never;
+};
+/** Shows a value and goes nowhere. */
+type ValueRow = {
+    value: string;
+    valueMono?: boolean;
+    onPush?: never;
+    control?: never;
+    onPress?: never;
+};
+/** Holds its own trailing control — a switch, a selection check. Never a chevron. */
+type ControlRow = {
+    control: ReactNode;
+    onPress?: () => void;
+    onPush?: never;
+    value?: never;
+    valueMono?: never;
+};
+/**
+ * **A row has a value, a control, or a chevron — and a row with none of them does not compile.**
+ * The handoff: *"A row with neither is not a row — it is a button, and buttons are centred with no
+ * chevron (see Log out)."* So the union has no branch for it, rather than a runtime warning a JS
+ * caller could ignore.
+ */
+export type GroupedRowProps = RowBase & (PushRow | ValueRow | ControlRow);
+/**
+ * One row.
+ *
+ * **The chevron means "pushes a sub-screen", and only that** — it is drawn from `onPush`, never
+ * from a row merely being tappable. A selection row is tappable and goes nowhere.
+ *
+ * **The title never truncates; the value gives way first.** The title column does not shrink and
+ * the value does, so a long value ellipsizes against a title that keeps its full width. That one
+ * layout also covers the handoff's Profile case (a short title, a long address) without a prop:
+ * the value takes whatever room is left and right-aligns in it. A subtitle is the exception — its
+ * column must be allowed to shrink or a long subtitle would push the row wider than the screen, so
+ * a row with BOTH a subtitle and a long value can clip its title. No shipped frame has both.
+ */
+export declare function GroupedRow(props: GroupedRowProps): import("react").JSX.Element;
+/**
+ * The card a run of rows sits in: one surface, one lift, a `hairline` rule under every row but the
+ * last.
+ *
+ * **The border is drawn only where the lift has no ring.** Paper's lifts — and every Android lift —
+ * begin `0 0 0 1px`, and that ring IS the border (contract §2.5); adding one doubles the edge.
+ * Solarium's iOS `--lift-1` is a pure drop shadow, and the handoff draws the group with a 1px
+ * `--line` border beside it, which is `hairlineStrong`.
+ *
+ * The radius comes off `useDs().radii`, not `Box`'s `radius` token: `radiusFor` reads the paper
+ * ladder whatever the theme, and the handoff's `--r-mid` is Solarium's 18, not paper's 20.
+ */
+export declare function RowGroup({ children, style, testID, accent, }: {
+    children: ReactNode;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+    /** A hue for a thin ring and a low glow around the group (14 Sep 2026, app 1's vibrant tab roots). Omitted, unchanged. */
+    accent?: string;
+}): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=groupedRows.d.ts.map

package/dist/esm/ds/groupedRows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupedRows.d.ts","sourceRoot":"","sources":["../../../src/ds/groupedRows.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAA8B,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIpE;;;;;;;;GAQG;AAEH,KAAK,OAAO,GAAG;IACb,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wGAAwG;IACxG,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,iGAAiG;IACjG,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,mFAAmF;AACnF,KAAK,OAAO,GAAG;IAAE,MAAM,EAAE,MAAM,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAC7G,sCAAsC;AACtC,KAAK,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AACzG,qFAAqF;AACrF,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,SAAS,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEjH;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,CAAC,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,+BAyDhD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAChC,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0HAA0H;IAC1H,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,+BAwBA"}