@appinternalleads/ui 0.2.0

package/dist/esm/ds/groupedRows.js

@@ -0,0 +1,59 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Children, isValidElement } from 'react';
+import { Box, Icon, Pressable, Text } from '../core';
+import { isAndroid, useDs } from '../tokens';
+import { ProvenanceTag } from './tags';
+/**
+ * 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 function GroupedRow(props) {
+    const { title, subtitle, icon, provenance, titleMono, leading, selected, testID, value, valueMono, control, onPush, onPress } = props;
+    const { colors } = useDs();
+    const body = (_jsxs(Box, { row: true, align: "center", gap: "s3", role: "listitem", testID: onPush || onPress ? undefined : testID, 
+        /* 14 all round on iOS; Android is 15/14, two points taller for the platform's larger minimum
+           touch target. Neither is on the 4pt grid, and the handoff is explicit about both. */
+        style: { paddingVertical: isAndroid ? 15 : 14, paddingHorizontal: 14 }, children: [icon ? _jsx(Icon, { name: icon, size: 18, color: colors.textSecondary }) : null, provenance ? _jsx(Box, { children: _jsx(ProvenanceTag, { source: provenance }) }) : null, leading, _jsxs(Box, { style: subtitle ? { flexGrow: 1, flexShrink: 1, minWidth: 0 } : { flexGrow: 1, flexShrink: 0 }, children: [_jsx(Text, { variant: "rowTitleDense", mono: titleMono, numberOfLines: 1, children: title }), subtitle ? (_jsx(Text, { variant: "rowSubtitle", color: "textSecondary", numberOfLines: 1, style: { marginTop: 2 }, children: subtitle })) : null] }), value === undefined ? null : (_jsx(Text, { variant: "caption", mono: valueMono, color: "textSecondary", align: "right", numberOfLines: 1, style: { flexShrink: 1, minWidth: 0 }, children: value })), control, onPush ? _jsx(Icon, { name: "chev-r", size: 15, color: colors.textSecondary }) : null] }));
+    const handler = onPush ?? onPress;
+    if (!handler)
+        return body;
+    return (
+    /* The value belongs in the label: iOS reads a Pressable as ONE element, so a value drawn beside the
+       title — `200 MB`, an address — was on screen and never announced. */
+    _jsx(Pressable, { onPress: handler, press: "scale", align: "stretch", justify: "flex-start", "aria-label": [title, value, subtitle, selected ? 'selected' : null].filter(Boolean).join(', '), testID: testID, children: body }));
+}
+/**
+ * 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 function RowGroup({ children, style, testID, accent, }) {
+    const ds = useDs();
+    const rows = Children.toArray(children).filter(isValidElement);
+    const ringed = ds.lift1.startsWith('0 0 0 1px');
+    return (_jsx(Box, { bg: "surface1", lift: 1, role: "list", testID: testID, style: [
+            { borderRadius: ds.radii.card },
+            ringed ? null : { borderWidth: 1, borderColor: ds.colors.hairlineStrong },
+            /* Ring at 50%; the glow at ~2% (`05`) — turned down to almost nothing the same day (14 Sep 2026, product ask). */
+            accent ? { boxShadow: `0 0 0 1px ${accent}80, 0 10px 24px -10px ${accent}05` } : null,
+            style,
+        ], children: rows.map((row, i) => (_jsx(Box, { hairline: i < rows.length - 1 ? { side: 'bottom' } : undefined, children: row }, row.key ?? i))) }));
+}
+//# sourceMappingURL=groupedRows.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * **The `@comppack/ds` component layer — C6.**
+ *
+ * Ported from `canvas-app/packages/ds/src`, which is the canonical copy of four that had already
+ * drifted. Everything here composes the primitives and the token layer; nothing re-derives a
+ * material value.
+ *
+ * `Button` is the one deliberate exception to going through `core/Pressable`: that primitive owns
+ * a square hit target and a dimming press, and a button is a stretchable pill with a scale press.
+ * Two different objects that happen to both respond to a tap.
+ */
+export { Button, Caption, KindChip, StatusLabel, type ButtonProps, type ButtonSize, type ButtonVariant, } from './Button';
+export { PanelScreen, Substrate, useSubstrateStyle, useTabBarSpace } from './screen';
+export { EmptyState, SectionLabel } from './EmptyState';
+export { Banner, Chip } from './Banner';
+export { Preview, SectionHeader, SegmentedControl, StatCard, TabItem } from './lists';
+export { FileTile, KindTag, KindTile, ProvenanceTag, SuccessState } from './tags';
+export { PlatformSwitch, SettingRow } from './PlatformSwitch';
+export { GroupedRow, RowGroup, type GroupedRowProps } from './groupedRows';
+export { BackButton, SubScreenHeader, type BackButtonProps, type SubScreenHeaderProps } from './SubScreenHeader';
+export { Card, Card as V2Card, ConnectorLogo, ListRow, SearchField, ShortcutRow, type ListRowProps, } from './rows';
+export { AppHeader, ConfirmProvider, HomeSheet, NoticeToast, TabBarChrome, Toast, ToastProvider, useConfirm, useToast, NOTICE_MS, type ConfirmRequest, type SheetGroup, type SheetRow, type ToastNotice, } from './overlays';
+export { ReachBar, ReachEmptyState, ReachProvider, reachCopy, useReach, type Reach, } from './Reach';
+export { BlockCard, Callout, MetaChip, TypeTile, type BlockCardProps, type BlockCardStatus, type CalloutTone, type MetaChipProps, } from './blocks';
+export { AmountField, Checkbox, CheckboxGroup, ColorField, NumberStepper, OtpInput, RadioGroup, SelectableCardGroup, TagInput, ToggleCardGroup, isHexColor, parseAmount, useRovingSelect, STEPPER_HOLD_MS, STEPPER_REPEAT_MS, type CheckState, type RadioOption, type SelectableCardOption, type ToggleCardOption, } from './blockControls';
+export { AvatarGroup, CheckItem, CheckList, CodeBlock, Dot, HeaderMeta, MediaSlot, ProgressBar, SkeletonBar, StatWell, StateChip, TickNumber, allocationOf, COPIED_MS, NEAR_LIMIT, type Allocation, type AvatarPerson, type CheckItemState, type DotTone, type ProgressTone, type StateChipTone, } from './blockDisplay';
+export { DotPager, StepCounter, Timeline, VerticalStepper, DOT_PAGER_MAX, TIMELINE_MIN_COLUMN, TRACK_MIN_COLUMN, type BlockStep, type BlockStepState, } from './blockSequence';
+export { ActionMenu, Collapsible, Menu, Modal, Popover, Tooltip, MENU_MIN_WIDTH, TOOLTIP_DELAY_MS, type ActionMenuItem, type MenuItem, type TooltipTriggerProps, } from './blockOverlay';
+export { CardGrid, PanelItem, TwoPanel, gridColumns, sidebarWidth, TWO_PANEL_STACK } from './blockLayout';
+export { DROPZONE_COPY, Dropzone, IconButton, type DropzoneCopy, type DropzoneValue } from './Dropzone';
+export { BrandPreview, initialsOf, type BrandPreviewKind, type BrandPreviewProps } from './BrandPreview';
+export { BLOCK_CATALOGUE, BLOCK_GROUPS, BLOCKS_INTRODUCED, blockBySlug, getBlocks, type BlockApiRow, type BlockEntry, type BlockGroup, type BlockOrigin, type BlockStatus, } from './blockCatalog';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/esm/ds/index.js

@@ -0,0 +1,34 @@
+/**
+ * **The `@comppack/ds` component layer — C6.**
+ *
+ * Ported from `canvas-app/packages/ds/src`, which is the canonical copy of four that had already
+ * drifted. Everything here composes the primitives and the token layer; nothing re-derives a
+ * material value.
+ *
+ * `Button` is the one deliberate exception to going through `core/Pressable`: that primitive owns
+ * a square hit target and a dimming press, and a button is a stretchable pill with a scale press.
+ * Two different objects that happen to both respond to a tap.
+ */
+export { Button, Caption, KindChip, StatusLabel, } from './Button';
+export { PanelScreen, Substrate, useSubstrateStyle, useTabBarSpace } from './screen';
+export { EmptyState, SectionLabel } from './EmptyState';
+export { Banner, Chip } from './Banner';
+export { Preview, SectionHeader, SegmentedControl, StatCard, TabItem } from './lists';
+export { FileTile, KindTag, KindTile, ProvenanceTag, SuccessState } from './tags';
+export { PlatformSwitch, SettingRow } from './PlatformSwitch';
+export { GroupedRow, RowGroup } from './groupedRows';
+export { BackButton, SubScreenHeader } from './SubScreenHeader';
+export { Card, Card as V2Card, ConnectorLogo, ListRow, SearchField, ShortcutRow, } from './rows';
+export { AppHeader, ConfirmProvider, HomeSheet, NoticeToast, TabBarChrome, Toast, ToastProvider, useConfirm, useToast, NOTICE_MS, } from './overlays';
+export { ReachBar, ReachEmptyState, ReachProvider, reachCopy, useReach, } from './Reach';
+/* ── Solarium Building Blocks (docs/HANDOFF-SOLARIUM-BLOCKS.md §3) ───────── */
+export { BlockCard, Callout, MetaChip, TypeTile, } from './blocks';
+export { AmountField, Checkbox, CheckboxGroup, ColorField, NumberStepper, OtpInput, RadioGroup, SelectableCardGroup, TagInput, ToggleCardGroup, isHexColor, parseAmount, useRovingSelect, STEPPER_HOLD_MS, STEPPER_REPEAT_MS, } from './blockControls';
+export { AvatarGroup, CheckItem, CheckList, CodeBlock, Dot, HeaderMeta, MediaSlot, ProgressBar, SkeletonBar, StatWell, StateChip, TickNumber, allocationOf, COPIED_MS, NEAR_LIMIT, } from './blockDisplay';
+export { DotPager, StepCounter, Timeline, VerticalStepper, DOT_PAGER_MAX, TIMELINE_MIN_COLUMN, TRACK_MIN_COLUMN, } from './blockSequence';
+export { ActionMenu, Collapsible, Menu, Modal, Popover, Tooltip, MENU_MIN_WIDTH, TOOLTIP_DELAY_MS, } from './blockOverlay';
+export { CardGrid, PanelItem, TwoPanel, gridColumns, sidebarWidth, TWO_PANEL_STACK } from './blockLayout';
+export { DROPZONE_COPY, Dropzone, IconButton } from './Dropzone';
+export { BrandPreview, initialsOf } from './BrandPreview';
+export { BLOCK_CATALOGUE, BLOCK_GROUPS, BLOCKS_INTRODUCED, blockBySlug, getBlocks, } from './blockCatalog';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ds/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAEvC,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAwB,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,eAAe,EAAmD,MAAM,mBAAmB,CAAC;AACjH,OAAO,EACL,IAAI,EAAE,IAAI,IAAI,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,GACvE,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EACtF,UAAU,EAAE,QAAQ,EAAE,SAAS,GAChC,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,GAC9D,MAAM,SAAS,CAAC;AACjB,gFAAgF;AAChF,OAAO,EACL,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAEvC,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,mBAAmB,EAC1G,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,GAExG,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAC5G,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,GAE3D,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,GAEvG,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB,GAEzF,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1G,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAyC,MAAM,YAAY,CAAC;AACxG,OAAO,EAAE,YAAY,EAAE,UAAU,EAAiD,MAAM,gBAAgB,CAAC;AACzG,OAAO,EACL,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,SAAS,GAEzE,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,71 @@
+import type { ReactNode } from 'react';
+import type { StyleProp, TextStyle, ViewStyle } from 'react-native';
+/**
+ * The header above a list.
+ *
+ * `eyebrow` switches it from a heading to a mono structural label — `RECENT RUNS`, `STEPS`. The
+ * two are different jobs: a heading names a section a reader chose to look at, an eyebrow names a
+ * grouping the machine made.
+ */
+export declare function SectionHeader({ title, count, description, eyebrow, tone, }: {
+    title: string;
+    count?: number | string;
+    description?: string;
+    eyebrow?: boolean;
+    /** An ink for the eyebrow and count (14 Sep 2026, app 1's vibrant tab roots). Omitted, the tertiary grey as before. */
+    tone?: string;
+}): import("react").JSX.Element;
+/**
+ * A measurement in a tile.
+ *
+ * **The value is left-aligned under its own label.** Numerals right-align in a COLUMN — a table,
+ * a field well — where decimal points line up down the page. A tile has no column, and
+ * left-aligning is what makes the label and value read as one thing.
+ */
+export declare function StatCard({ label, value, meta, primary, }: {
+    label: string;
+    value: ReactNode;
+    meta?: ReactNode;
+    primary?: boolean;
+}): import("react").JSX.Element;
+/**
+ * A segmented control.
+ *
+ * **Android takes the M3 tab treatment — an underline on a hairline track — and iOS the pill.**
+ * The same control, drawn the way each platform's users already read it; forcing one shape on
+ * both is how a control ends up looking imported on the platform that lost.
+ */
+export declare function SegmentedControl<T extends string>({ options, value, onSelect, accent, style, }: {
+    options: {
+        value: T;
+        label: string;
+    }[];
+    value: T;
+    onSelect: (v: T) => void;
+    /** A hue pair for the selected segment (14 Sep 2026, app 1's vibrant tab roots). Omitted, unchanged. */
+    accent?: {
+        bg: string;
+        fg: string;
+    };
+    style?: StyleProp<ViewStyle>;
+}): import("react").JSX.Element;
+/** One tab in a bar. */
+export declare function TabItem({ label, selected, onPress, }: {
+    label: string;
+    selected?: boolean;
+    onPress?: () => void;
+}): import("react").JSX.Element;
+/**
+ * A shortcut template with its tokens marked.
+ *
+ * **A prompted token and an automatic one must not look alike** — one will stop and ask, the
+ * other will not, and a user reading the preview is deciding whether this shortcut is safe to
+ * fire without looking. `{{?name}}` prompts; `{{date}}` resolves itself.
+ */
+export declare function Preview({ children, numberOfLines, style, }: {
+    children: string;
+    size?: number;
+    numberOfLines?: number;
+    style?: StyleProp<TextStyle>;
+}): import("react").JSX.Element;
+//# sourceMappingURL=lists.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lists.d.ts","sourceRoot":"","sources":["../../../src/ds/lists.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIpE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,OAAe,EAAE,IAAI,GACjD,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uHAAuH;IACvH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,+BA0BA;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAe,GACpC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,+BAgB1E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,EACjD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,GACxC,EAAE;IACD,OAAO,EAAE;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IACzB,wGAAwG;IACxG,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,+BAsDA;AAED,wBAAwB;AACxB,wBAAgB,OAAO,CAAC,EACtB,KAAK,EAAE,QAAQ,EAAE,OAAO,GACzB,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,+BAM7D;AAID;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,EACtB,QAAQ,EAAE,aAAa,EAAE,KAAK,GAC/B,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;CAAE,+BAuB3F"}

package/dist/esm/ds/lists.js

@@ -0,0 +1,81 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Pressable, Text } from '../core';
+import { isAndroid, useDs } from '../tokens';
+/**
+ * The header above a list.
+ *
+ * `eyebrow` switches it from a heading to a mono structural label — `RECENT RUNS`, `STEPS`. The
+ * two are different jobs: a heading names a section a reader chose to look at, an eyebrow names a
+ * grouping the machine made.
+ */
+export function SectionHeader({ title, count, description, eyebrow = false, tone, }) {
+    const { headings } = useDs();
+    return (_jsxs(Box, { gap: "s1", py: "s2", children: [_jsxs(Box, { row: true, align: "center", justify: "space-between", gap: "s2", children: [eyebrow ? (_jsx(Text, { variant: headings === 'screen' ? 'eyebrowDense' : 'eyebrow', mono: true, color: "textTertiary", uppercase: true, style: tone ? { color: tone, fontWeight: '700' } : undefined, children: title })) : (_jsx(Text, { variant: "heading", children: title })), count === undefined ? null : (_jsx(Text, { variant: "monoCount", mono: true, numeric: true, color: "textTertiary", style: tone ? { color: tone } : undefined, children: String(count) }))] }), description ? (_jsx(Text, { variant: "caption", color: "textSecondary", children: description })) : null] }));
+}
+/**
+ * A measurement in a tile.
+ *
+ * **The value is left-aligned under its own label.** Numerals right-align in a COLUMN — a table,
+ * a field well — where decimal points line up down the page. A tile has no column, and
+ * left-aligning is what makes the label and value read as one thing.
+ */
+export function StatCard({ label, value, meta, primary = false, }) {
+    return (_jsxs(Box, { gap: "s1", p: "s4", radius: "card", bg: "surfaceSunken", 
+        /* A primary stat takes an accent hairline RING, never a fill — a fill reads as a button. */
+        edge: primary ? 'outline' : undefined, children: [_jsx(Text, { variant: "caption", color: "textSecondary", children: label }), typeof value === 'string' || typeof value === 'number'
+                ? _jsx(Text, { variant: "title", numeric: true, align: "left", children: value })
+                : value, meta] }));
+}
+/**
+ * A segmented control.
+ *
+ * **Android takes the M3 tab treatment — an underline on a hairline track — and iOS the pill.**
+ * The same control, drawn the way each platform's users already read it; forcing one shape on
+ * both is how a control ends up looking imported on the platform that lost.
+ */
+export function SegmentedControl({ options, value, onSelect, accent, style, }) {
+    if (isAndroid) {
+        return (_jsx(Box, { row: true, hairline: { side: 'bottom' }, style: style, children: options.map(o => {
+                const on = o.value === value;
+                return (_jsx(Pressable, { onPress: () => onSelect(o.value), py: "s3", "aria-label": o.label, style: { flex: 1 }, children: _jsx(Text, { variant: "caption", color: on ? 'accentInk' : 'textSecondary', style: on && accent ? { color: accent.fg, fontWeight: '700' } : undefined, children: o.label }) }, o.value));
+            }) }));
+    }
+    return (_jsx(Box, { row: true, p: "s1", gap: "s1", radius: "field", bg: "surfaceSunken", style: style, children: options.map(o => {
+            const on = o.value === value;
+            return (_jsx(Pressable, { onPress: () => onSelect(o.value), py: "s2", px: "s3", radius: "chip", bg: on ? 'surface1' : undefined, "aria-label": o.label, style: [
+                    { flex: 1 },
+                    on && accent ? { backgroundColor: accent.bg, boxShadow: `0 0 0 1px ${accent.fg}33, 0 4px 12px -6px ${accent.fg}` } : null,
+                ], children: _jsx(Text, { variant: "caption", color: on ? 'accentInk' : 'textSecondary', numberOfLines: 1, style: on && accent ? { color: accent.fg, fontWeight: '700' } : undefined, children: o.label }) }, o.value));
+        }) }));
+}
+/** One tab in a bar. */
+export function TabItem({ label, selected, onPress, }) {
+    return (_jsx(Pressable, { onPress: onPress, py: "s2", px: "s3", "aria-label": label, style: { flex: 1 }, children: _jsx(Text, { variant: "caption", color: selected ? 'accentInk' : 'textTertiary', children: label }) }));
+}
+const TOKEN = /\{\{([^}]+)\}\}/g;
+/**
+ * A shortcut template with its tokens marked.
+ *
+ * **A prompted token and an automatic one must not look alike** — one will stop and ask, the
+ * other will not, and a user reading the preview is deciding whether this shortcut is safe to
+ * fire without looking. `{{?name}}` prompts; `{{date}}` resolves itself.
+ */
+export function Preview({ children, numberOfLines, style, }) {
+    const parts = [];
+    let last = 0;
+    let m;
+    TOKEN.lastIndex = 0;
+    while ((m = TOKEN.exec(children)) !== null) {
+        if (m.index > last)
+            parts.push(children.slice(last, m.index));
+        const body = m[1] ?? '';
+        const prompted = body.startsWith('?');
+        parts.push(_jsx(Text, { mono: true, color: prompted ? 'accentInk' : 'reference', children: `{{${body}}}` }, m.index));
+        last = m.index + m[0].length;
+    }
+    if (last < children.length)
+        parts.push(children.slice(last));
+    return (_jsx(Text, { variant: "caption", color: "textSecondary", numberOfLines: numberOfLines, style: style, children: parts }));
+}
+//# sourceMappingURL=lists.js.map

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

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

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

@@ -0,0 +1,189 @@
+import { type ReactNode } from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+import { type IconName } from '../core';
+/**
+ * **How long a notice (O1) stays: the Building Blocks handoff's 5s.** A string toast keeps
+ * `DURATION` — changing it would change every existing call site, and the handoff's timing is
+ * specified for the titled notice, which is new. HANDOFF-SOLARIUM-BLOCKS §6 records the split.
+ */
+export declare const NOTICE_MS = 5000;
+/**
+ * **O1 · a titled notice.** Success and information only — "never for failures": a failure the
+ * user must act on belongs where the failure happened (a `Callout`), not in a message that leaves
+ * on its own after five seconds.
+ */
+export type ToastNotice = {
+    title: string;
+    body?: string;
+    tone?: 'success' | 'info';
+};
+type ToastApi = {
+    show: (message: string | ToastNotice) => void;
+    dismiss: () => void;
+};
+export declare function ToastProvider({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** **A screen outside the provider must not crash over a confirmation message.** */
+export declare function useToast(): ToastApi;
+/**
+ * Docked above the tab bar, never over it.
+ *
+ * `bottom` defaults to the lane the tokens reserve: an overlay sitting on a button swallows the
+ * tap, and from the user's side the button simply does not work.
+ */
+export declare function Toast({ children, bottom }: {
+    children: string;
+    bottom?: number;
+}): import("react").JSX.Element;
+/**
+ * **O1 · the notice: 210 wide, padding 12, radius 16, `lift-2`; fades in (M10, opacity only).** Title,
+ * optional body, a dismiss button. A `status` region, so it is announced without taking focus —
+ * a notice that stole focus would interrupt exactly the task it is reporting on.
+ */
+export declare function NoticeToast({ notice, onDismiss, bottom, }: {
+    notice: ToastNotice;
+    onDismiss: () => void;
+    bottom?: number;
+}): import("react").JSX.Element;
+export type ConfirmRequest = {
+    title: string;
+    /** What leaves, whether it comes back, whether anything else is affected. */
+    body: string;
+    /** **The verb is the verb** — Delete, Sign out — never "OK". */
+    verb?: string;
+};
+type ConfirmFn = (request: ConfirmRequest) => Promise<boolean>;
+/**
+ * Destructive confirmation, as a promise.
+ *
+ * A `useConfirm()` call reads as a question with an answer — `if (await confirm({…}))` — rather
+ * than as two callbacks wired to a dialog somewhere else, which is what makes the call site
+ * readable at the point the decision is actually made.
+ */
+export declare function ConfirmProvider({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** Throws outside a provider — unlike `useToast`, a confirmation that silently resolves is unsafe. */
+export declare function useConfirm(): ConfirmFn;
+export type SheetRow = {
+    key: string;
+    label: string;
+    icon?: IconName;
+    /** A connector's brand mark (`ConnectorLogo`), drawn instead of `icon` when set — including
+        `null`, which still reserves the tile so a slow-loading logo does not shift the row. */
+    logo?: string | null;
+    meta?: string;
+    chevron?: boolean;
+    /** Reddens the label only. The row keeps its neutral container — an action the user chose is
+        not a failure, and red is for things that failed. */
+    destructive?: boolean;
+    onPress?: () => void;
+};
+export interface SheetGroup {
+    /** `YOUR CONNECTORS`, `YOUR SHORTCUTS`. Omitted for an ungrouped list. */
+    label?: string;
+    rows: SheetRow[];
+    /**
+     * **Already filtered by whoever supplied it — leave it alone.**
+     *
+     * The local filter matches a row's own LABEL, which is right for a fixed list of connector
+     * names and wrong for anything the server ranked: a hit for *"latest posts"* is `Get latest
+     * posts` under `hackernews`, and re-filtering by the same string would drop every result whose
+     * label does not literally contain the query.
+     */
+    preFiltered?: boolean;
+}
+/**
+ * A bottom sheet with a filterable list.
+ *
+ * **The search field is present only where the list is long enough to need one.** A connector has
+ * sixty-one actions and picking from that by scrolling is not picking; the overflow menu's two
+ * rows get no field, because a filter over two rows is furniture.
+ *
+ * **The query is lifted out** so the sheet can be fed from the server: a purely local filter
+ * matches only the labels it was already handed, so typing narrows what is on screen rather than
+ * what exists.
+ */
+export declare function HomeSheet({ title, slug, search, query, onQueryChange, emptyLabel, groups, onSelect, onDismiss, visible, maxHeightFraction, }: {
+    title: string;
+    slug?: string;
+    search?: string;
+    query?: string;
+    onQueryChange?: (q: string) => void;
+    emptyLabel?: string;
+    groups: SheetGroup[];
+    onSelect?: (key: string) => void;
+    onDismiss: () => void;
+    visible?: boolean;
+    /** See `Sheet`'s prop of the same name. Omitted, the panel sizes to its content as before. */
+    maxHeightFraction?: number;
+}): import("react").JSX.Element;
+/**
+ * A screen header.
+ *
+ * **Whatever goes in `right` is a drawn glyph, never a character** — `⋯` is U+22EF and renders
+ * differently on every platform, which is exactly what an icon exists to prevent.
+ *
+ * The trailing control shares the BACK row rather than the title line, so the iOS large title
+ * still starts at the gutter — which is the whole shape of that title.
+ */
+export declare function AppHeader({ title, sub, back, backLabel, onBack, right, accent, style, }: {
+    title: string;
+    sub?: string;
+    /**
+     * A screen's own hue (14 Sep 2026, app 1's vibrant tab roots): a short bar under the title and the subtitle set in
+     * that ink at 600. Omitted, the header is exactly what it was — the other apps pass nothing.
+     */
+    accent?: string;
+    back?: boolean;
+    backLabel?: string;
+    onBack?: () => void;
+    right?: ReactNode;
+    style?: StyleProp<ViewStyle>;
+}): import("react").JSX.Element;
+/**
+ * The tab bar's own surface: a ground and one top rule.
+ *
+ * A component rather than a style so the bar's material lives in one place; the navigator supplies
+ * the items and this supplies what they sit on.
+ *
+ * **`flex` is what makes it visible at all, and its absence was a real defect.** React Navigation
+ * renders `tabBarBackground()` inside a `<View style={StyleSheet.absoluteFill}>`, so the element
+ * returned here has to fill that box itself. This was `style={{ width: '100%' }}` with no height,
+ * and since the component is normally given no children there was nothing to give it one — so it
+ * measured zero tall and painted nothing. Both apps set `tabBarStyle.backgroundColor` to
+ * transparent on the strength of this drawing the ground, which meant list content scrolled
+ * straight through the tab labels on every root screen. `flex: 1` fills the height; the default
+ * cross-axis stretch fills the width, which is why the explicit `width` is gone rather than kept.
+ *
+ * **`hairline` replaces `lift={2}`, and this is the one place a border beside a lift would have
+ * been wrong to add rather than a lift being wrong to keep.** The ladder is right that a `0 0 0
+ * 1px` ring IS the border and that drawing both is the usual way this material gets implemented
+ * badly. But a lift only says anything on a surface with room around it, and this one is pinned
+ * flush to the bottom of the screen: the ring draws OUTSIDE the box, the box now exactly fills
+ * the bar, and the bar clips it — while both drop shadows point downward, off-screen. Measured on
+ * device: a card on the same frame renders its ring normally (`#EFEEEA` at the edge), and the bar
+ * went page → white with nothing between. So `lift={2}` here was three shadows rendering nothing,
+ * and there is no double edge to worry about because there was never a first one.
+ *
+ * Both design documents say the same thing independently, which is the reason to trust it over
+ * the inference: the KeyShort handoff specifies `border-top: 1px solid` on `--card`, and the
+ * canvas app describes this component as *"on `--card` over a `--line-soft` hairline"*. Neither
+ * mentions a shadow.
+ *
+ * **Settled (A1n, KEYSHORT-REVAMP.md, 11 Sep 2026): `--line-soft` — `hairline`'s default,
+ * unchanged.** They disagree by one token on the rule's colour — KeyShort says `--line`, the
+ * canvas app `--line-soft`. Chasing the citation rather than trusting the paraphrase above
+ * settles it: `design_handoff_ambi_chat_duplex/README.md:53` states the tab bar's rule
+ * explicitly — `border-top: 1px solid var(--line-soft)` — as a primary spec, not an inference
+ * from this component's own behaviour. KeyShort's `--line` is the one document out of step
+ * between the two, and the softer default was already right for the reason given below: a bar
+ * that under-asserts can be strengthened, one that over-asserts has already drawn a line nobody
+ * asked for.
+ */
+export declare function TabBarChrome({ children }: {
+    children?: ReactNode;
+}): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=overlays.d.ts.map

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

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