@appinternalleads/ui 0.2.0

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

@@ -0,0 +1,150 @@
+import { type ReactNode } from 'react';
+import { type IconName } from '../core';
+/**
+ * **Solarium Building Blocks — overlay.** O2 Collapsible · O3 Dropdown menu · O4 Modal, Popover,
+ * Tooltip. (O1 Toast is the existing `ToastProvider`, extended with a title/body notice in
+ * `overlays.tsx` — one notification system, not two.)
+ *
+ * Menu, popover and modal share `core/Layer`: focus is trapped inside while open, Escape and a
+ * backdrop press close, and focus returns to the control that opened the layer. On React Native
+ * the menu is a sheet — "Bottom sheet on RN" — which the caller gets by using `core/Select` or
+ * `HomeSheet` there; this menu is the pointer-and-keyboard surface.
+ */
+/**
+ * **A Row header with a chevron; the body stays mounted and is inert when closed.** Mounted, so
+ * its state (a half-typed field) survives a close; inert, so a closed body is neither focusable
+ * nor read out. The header is a button with `aria-expanded` and `aria-controls`.
+ *
+ * Open/close eases the height at `slow` (M3) and turns the chevron 180°; reduced motion jumps.
+ * Controlled when `open` is passed, uncontrolled from `defaultOpen` otherwise.
+ */
+export declare function Collapsible({ title, subtitle, children, open: controlled, defaultOpen, onOpenChange, variant, leading, meta, }: {
+    title: string;
+    subtitle?: string;
+    children: ReactNode;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** `plain`: no border — a row inside a card (onboarding Permissions); the header fills on hover. */
+    variant?: 'card' | 'plain';
+    /** Before the title — a tile. */
+    leading?: ReactNode;
+    /** Before the chevron — a count chip. */
+    meta?: ReactNode;
+}): import("react").JSX.Element;
+export type MenuItem<T extends string = string> = {
+    value: T;
+    label: string;
+};
+/** A menu is never narrower than this — the handoff's "min 220 wide". */
+export declare const MENU_MIN_WIDTH = 220;
+/**
+ * **A trigger and a menu of 36px items; ✓ on the selected one.** The trigger is a button with
+ * `aria-haspopup="menu"` and `aria-expanded`. Opening focuses the selected item (or the first);
+ * ArrowUp/Down move, Home/End jump, Enter chooses, Escape and Tab close — and focus goes back to
+ * the trigger, the one place a keyboard user expects to be after a menu.
+ *
+ * `value` makes it a single-choice menu (`menuitemradio` with `aria-checked`); omit it for a menu
+ * of actions (`menuitem`).
+ */
+export declare function Menu<T extends string>({ label, items, value, onSelect, trigger, }: {
+    /** The menu's name, and the trigger's when `trigger` is omitted. */
+    label: string;
+    items: MenuItem<T>[];
+    value?: T;
+    onSelect: (value: T) => void;
+    /** The trigger's visible text. Defaults to the selected item's label, then `label`. */
+    trigger?: string;
+}): import("react").JSX.Element;
+export type ActionMenuItem<T extends string = string> = {
+    value: T;
+    label: string;
+    /** The consequence, said before it happens — "12 members become unassigned". */
+    detail?: string;
+    /** `danger`: apricot deep text and a trash glyph. Never red. */
+    tone?: 'danger';
+};
+/**
+ * **An icon button that opens a menu of actions** — a row's "⋯" (Rename · Remove) or its Delete
+ * with a confirm step. The same contract as `Menu`: `aria-haspopup="menu"`, focus moves to the
+ * first item on open, arrows / Home / End move, Escape and Tab close, focus returns to the trigger.
+ * A **danger** item uses apricot deep text, a trash glyph and explicit consequence copy (decision
+ * §5.4 of the batch-2 handoff).
+ *
+ * `open` / `onOpenChange` make it controlled, so a restored session can open with it showing; it
+ * measures its anchor on mount when it starts open.
+ */
+export declare function ActionMenu<T extends string>({ label, triggerLabel, triggerIcon, items, onSelect, open: openProp, onOpenChange, disabled, width, trigger, side, align, }: {
+    /** The menu's name. */
+    label: string;
+    /** The trigger's accessible name — "Delete Engineering". */
+    triggerLabel: string;
+    triggerIcon?: IconName;
+    items: ActionMenuItem<T>[];
+    onSelect: (value: T) => void;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    disabled?: boolean;
+    width?: number;
+    /**
+     * A text trigger instead of the icon — the ghost button a footer carries ("Snooze", batch 3's
+     * Event Reminder). The same 8px ghost as `Button variant="secondary"`, at the density's height.
+     */
+    trigger?: string;
+    /** Open upward — a menu on a card's footer. */
+    side?: 'below' | 'above';
+    /** `end`: the menu's right edge on the trigger's. */
+    align?: 'start' | 'end';
+}): import("react").JSX.Element;
+/**
+ * **A dialog over a scrim: title, body, verb buttons.** `role="dialog"`, `aria-modal`, named by
+ * its title. Focus is trapped while open; Escape and the scrim close it; focus returns to whatever
+ * opened it (pass `returnFocus`, usually `useAnchor().focus`). Buttons say the verb — "Remove",
+ * not "OK" — the same rule `useConfirm` states.
+ */
+export declare function Modal({ open, onClose, title, children, actions, returnFocus, maxWidth, }: {
+    open: boolean;
+    onClose: () => void;
+    title: string;
+    children?: ReactNode;
+    /** The verb buttons, primary last. */
+    actions?: ReactNode;
+    returnFocus?: () => void;
+    maxWidth?: number;
+}): import("react").JSX.Element;
+/**
+ * **Anchored content that is not a menu** — a small form, a detail. A button with
+ * `aria-haspopup="dialog"` opens a labelled, non-scrimmed layer below it; Escape and an outside
+ * press close it and return focus to the trigger.
+ */
+export declare function Popover({ label, trigger, children, width, }: {
+    label: string;
+    /** The trigger's visible text. */
+    trigger: string;
+    children: ReactNode;
+    width?: number;
+}): import("react").JSX.Element;
+/** Hover or focus must rest this long before a tooltip appears — the handoff's 300ms. */
+export declare const TOOLTIP_DELAY_MS = 300;
+export type TooltipTriggerProps = {
+    onHoverIn: () => void;
+    onHoverOut: () => void;
+    onFocus: () => void;
+    onBlur: () => void;
+    onKeyDown: (e: {
+        key: string;
+        preventDefault: () => void;
+    }) => void;
+    'aria-describedby': string;
+};
+/**
+ * **A short description, shown after 300ms of hover or focus; Escape dismisses it.** A render
+ * prop hands the trigger its handlers and `aria-describedby`, so the tooltip describes a real
+ * control instead of wrapping it in a second button. Never put anything in a tooltip that a touch
+ * user needs: touch has no hover, and this does not pretend otherwise.
+ */
+export declare function Tooltip({ label, children, }: {
+    label: string;
+    children: (trigger: TooltipTriggerProps) => ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=blockOverlay.d.ts.map

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

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

package/dist/esm/ds/blockOverlay.js

@@ -0,0 +1,229 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useEffect, useId, useRef, useState } from 'react';
+import { Box, Icon, Layer, MotionView, Pressable, Text, useAnchor, useTween, } from '../core';
+import { blockRadii, useDs } from '../tokens';
+/**
+ * **Solarium Building Blocks — overlay.** O2 Collapsible · O3 Dropdown menu · O4 Modal, Popover,
+ * Tooltip. (O1 Toast is the existing `ToastProvider`, extended with a title/body notice in
+ * `overlays.tsx` — one notification system, not two.)
+ *
+ * Menu, popover and modal share `core/Layer`: focus is trapped inside while open, Escape and a
+ * backdrop press close, and focus returns to the control that opened the layer. On React Native
+ * the menu is a sheet — "Bottom sheet on RN" — which the caller gets by using `core/Select` or
+ * `HomeSheet` there; this menu is the pointer-and-keyboard surface.
+ */
+/* ── O2 · Collapsible ────────────────────────────────────────────────────── */
+/**
+ * **A Row header with a chevron; the body stays mounted and is inert when closed.** Mounted, so
+ * its state (a half-typed field) survives a close; inert, so a closed body is neither focusable
+ * nor read out. The header is a button with `aria-expanded` and `aria-controls`.
+ *
+ * Open/close eases the height at `slow` (M3) and turns the chevron 180°; reduced motion jumps.
+ * Controlled when `open` is passed, uncontrolled from `defaultOpen` otherwise.
+ */
+export function Collapsible({ title, subtitle, children, open: controlled, defaultOpen = false, onOpenChange, variant = 'card', leading, meta, }) {
+    const { colors, density } = useDs();
+    const [own, setOwn] = useState(defaultOpen);
+    const [hover, setHover] = useState(false);
+    const open = controlled ?? own;
+    const [height, setHeight] = useState(null);
+    const t = useTween(open ? 1 : 0);
+    const body = useRef(null);
+    const id = `collapsible-${useId().replace(/:/g, '')}`;
+    /* `inert` is the web's one attribute for "present but not interactive". react-native-web does
+       not forward it, so it is set on the DOM node directly; on native the node has no such method
+       and the aria-hidden + pointerEvents pair below carries the same meaning. */
+    useEffect(() => {
+        const el = body.current;
+        if (!el?.setAttribute)
+            return;
+        if (open)
+            el.removeAttribute?.('inert');
+        else
+            el.setAttribute('inert', '');
+    }, [open]);
+    const toggle = () => {
+        if (controlled === undefined)
+            setOwn(!open);
+        onOpenChange?.(!open);
+    };
+    return (_jsxs(Box, { style: variant === 'plain' ? { overflow: 'hidden' } : { borderRadius: blockRadii.mid, boxShadow: `0 0 0 1px ${colors.hairlineStrong}`, overflow: 'hidden', backgroundColor: colors.surface1 }, children: [_jsxs(Pressable, { onPress: toggle, onHoverIn: variant === 'plain' ? () => setHover(true) : undefined, onHoverOut: variant === 'plain' ? () => setHover(false) : undefined, "aria-expanded": open, "aria-controls": id, "aria-label": title, row: true, justify: "space-between", gap: "s3", px: variant === 'plain' ? 's2' : 's3', minHeight: Math.max(44, density.rowH), style: variant === 'plain' ? { borderRadius: blockRadii.inset, backgroundColor: hover ? colors.surfaceSunken : undefined } : undefined, children: [leading, _jsxs(Box, { flex: 1, style: { minWidth: 0 }, children: [_jsx(Text, { variant: "caption", style: { fontWeight: '600' }, color: "textPrimary", children: title }), subtitle ? _jsx(Text, { variant: "caption", color: "textSecondary", style: { fontSize: 12 }, children: subtitle }) : null] }), meta, _jsx(MotionView, { style: { transform: [{ rotate: t.interpolate({ inputRange: [0, 1], outputRange: ['0deg', '180deg'] }) }] }, children: _jsx(Icon, { name: "chev-d", size: 14, color: colors.textSecondary }) })] }), _jsx(MotionView, { style: {
+                    overflow: 'hidden',
+                    opacity: t,
+                    height: height === null ? (open ? undefined : 0) : t.interpolate({ inputRange: [0, 1], outputRange: [0, height] }),
+                }, children: _jsx(Box, { ref: body, nativeID: id, role: "region", "aria-label": title, "aria-hidden": !open, style: { pointerEvents: open ? 'auto' : 'none' }, onLayout: e => {
+                        const h = e.nativeEvent.layout.height;
+                        if (h > 0 && h !== height)
+                            setHeight(h);
+                    }, children: _jsx(Box, { px: variant === 'plain' ? 's2' : 's3', pb: "s3", children: children }) }) })] }));
+}
+/** A menu is never narrower than this — the handoff's "min 220 wide". */
+export const MENU_MIN_WIDTH = 220;
+/**
+ * **A trigger and a menu of 36px items; ✓ on the selected one.** The trigger is a button with
+ * `aria-haspopup="menu"` and `aria-expanded`. Opening focuses the selected item (or the first);
+ * ArrowUp/Down move, Home/End jump, Enter chooses, Escape and Tab close — and focus goes back to
+ * the trigger, the one place a keyboard user expects to be after a menu.
+ *
+ * `value` makes it a single-choice menu (`menuitemradio` with `aria-checked`); omit it for a menu
+ * of actions (`menuitem`).
+ */
+export function Menu({ label, items, value, onSelect, trigger, }) {
+    const { colors, density } = useDs();
+    const anchor = useAnchor();
+    const [open, setOpen] = useState(false);
+    const refs = useRef([]);
+    const selected = value === undefined ? -1 : items.findIndex(i => i.value === value);
+    const menuId = `menu-${useId().replace(/:/g, '')}`;
+    const close = () => setOpen(false);
+    const focusAt = (i) => refs.current[(i + items.length) % items.length]?.focus();
+    const focusSelected = useCallback(() => refs.current[Math.max(0, selected)]?.focus(), [selected]);
+    const current = selected >= 0 ? items[selected].label : undefined;
+    return (_jsxs(_Fragment, { children: [_jsxs(Pressable, { ref: anchor.ref, onPress: () => { anchor.measure(); setOpen(true); }, "aria-haspopup": "menu", "aria-expanded": open, "aria-controls": open ? menuId : undefined, "aria-label": current ? `${label}: ${current}` : label, row: true, gap: "s2", px: "s3", alignSelf: "flex-start", minHeight: density.controlH, style: { borderRadius: blockRadii.inset, boxShadow: `0 0 0 1px ${colors.hairlineStrong}`, backgroundColor: colors.surface1 }, children: [_jsx(Text, { variant: "caption", color: "textPrimary", numberOfLines: 1, children: trigger ?? current ?? label }), _jsx(Icon, { name: "chev-d", size: 12, color: colors.textSecondary })] }), _jsx(Layer, { open: open, onClose: close, label: label, initialFocus: focusSelected, returnFocus: anchor.focus, placement: { kind: 'anchor', rect: anchor.rect, width: MENU_MIN_WIDTH }, children: _jsx(Box, { nativeID: menuId, role: "menu", "aria-label": label, style: { padding: 4, borderRadius: blockRadii.mid, backgroundColor: colors.surface1 }, lift: 2, children: items.map((item, i) => {
+                        const on = i === selected;
+                        return (_jsxs(Pressable, { ref: el => { refs.current[i] = el; }, role: value === undefined ? 'menuitem' : 'menuitemradio', "aria-checked": value === undefined ? undefined : on, "aria-label": item.label, tabIndex: -1, onPress: () => { onSelect(item.value); close(); }, onKeyDown: e => {
+                                if (e.key === 'ArrowDown') {
+                                    e.preventDefault();
+                                    focusAt(i + 1);
+                                }
+                                else if (e.key === 'ArrowUp') {
+                                    e.preventDefault();
+                                    focusAt(i - 1);
+                                }
+                                else if (e.key === 'Home') {
+                                    e.preventDefault();
+                                    focusAt(0);
+                                }
+                                else if (e.key === 'End') {
+                                    e.preventDefault();
+                                    focusAt(items.length - 1);
+                                }
+                                else if (e.key === 'Escape' || e.key === 'Tab') {
+                                    e.preventDefault();
+                                    close();
+                                }
+                            }, row: true, justify: "space-between", px: "s3", height: 36, style: { borderRadius: blockRadii.inset, backgroundColor: on ? colors.surfaceSunken : undefined }, children: [_jsx(Text, { variant: "caption", color: "textPrimary", numberOfLines: 1, children: item.label }), on ? _jsx(Icon, { name: "check", size: 14, color: colors.accentInk }) : null] }, item.value));
+                    }) }) })] }));
+}
+/**
+ * **An icon button that opens a menu of actions** — a row's "⋯" (Rename · Remove) or its Delete
+ * with a confirm step. The same contract as `Menu`: `aria-haspopup="menu"`, focus moves to the
+ * first item on open, arrows / Home / End move, Escape and Tab close, focus returns to the trigger.
+ * A **danger** item uses apricot deep text, a trash glyph and explicit consequence copy (decision
+ * §5.4 of the batch-2 handoff).
+ *
+ * `open` / `onOpenChange` make it controlled, so a restored session can open with it showing; it
+ * measures its anchor on mount when it starts open.
+ */
+export function ActionMenu({ label, triggerLabel, triggerIcon = 'more', items, onSelect, open: openProp, onOpenChange, disabled, width = MENU_MIN_WIDTH + 40, trigger, side = 'below', align = 'start', }) {
+    const { colors, density } = useDs();
+    const anchor = useAnchor();
+    const [ownOpen, setOwnOpen] = useState(false);
+    const open = openProp ?? ownOpen;
+    const setOpen = (v) => { setOwnOpen(v); onOpenChange?.(v); };
+    const refs = useRef([]);
+    const menuId = `amenu-${useId().replace(/:/g, '')}`;
+    const focusAt = (i) => refs.current[(i + items.length) % items.length]?.focus();
+    const focusFirst = useCallback(() => refs.current[0]?.focus(), []);
+    /* A menu that starts open (a restored session) still needs its anchor measured. */
+    useEffect(() => { if (open)
+        anchor.measure(); }, [open]);
+    return (_jsxs(_Fragment, { children: [_jsx(Pressable, { ref: anchor.ref, onPress: () => { anchor.measure(); setOpen(!open); }, "aria-haspopup": "menu", "aria-expanded": open, "aria-controls": open ? menuId : undefined, "aria-label": triggerLabel, disabled: disabled, ...(trigger !== undefined
+                    ? {
+                        row: true, px: 's3', minHeight: density.controlH,
+                        style: { borderRadius: blockRadii.inset, borderWidth: 1, borderColor: colors.hairlineStrong, backgroundColor: colors.surface1, opacity: disabled ? 0.45 : 1 },
+                    }
+                    : { width: 32, height: 32, radius: 'pill' }), children: trigger !== undefined
+                    ? _jsx(Text, { variant: "caption", numeric: true, color: "textPrimary", numberOfLines: 1, style: { fontSize: 13, fontWeight: '600' }, children: trigger })
+                    : _jsx(Icon, { name: triggerIcon, size: 16, color: colors.textSecondary }) }), _jsx(Layer, { open: open, onClose: () => setOpen(false), label: label, initialFocus: focusFirst, returnFocus: anchor.focus, placement: { kind: 'anchor', rect: anchor.rect, width, side, align }, children: _jsx(Box, { nativeID: menuId, role: "menu", "aria-label": label, lift: 2, style: { padding: 4, borderRadius: blockRadii.mid, backgroundColor: colors.surface1, borderWidth: 1, borderColor: colors.hairlineStrong }, children: items.map((item, i) => {
+                        const danger = item.tone === 'danger';
+                        const ink = danger ? colors.status.needsUser : colors.textPrimary;
+                        return (_jsxs(Pressable, { ref: el => { refs.current[i] = el; }, role: "menuitem", "aria-label": item.detail ? `${item.label} · ${item.detail}` : item.label, tabIndex: -1, onPress: () => { setOpen(false); onSelect(item.value); }, onKeyDown: e => {
+                                if (e.key === 'ArrowDown') {
+                                    e.preventDefault();
+                                    focusAt(i + 1);
+                                }
+                                else if (e.key === 'ArrowUp') {
+                                    e.preventDefault();
+                                    focusAt(i - 1);
+                                }
+                                else if (e.key === 'Home') {
+                                    e.preventDefault();
+                                    focusAt(0);
+                                }
+                                else if (e.key === 'End') {
+                                    e.preventDefault();
+                                    focusAt(items.length - 1);
+                                }
+                                else if (e.key === 'Escape' || e.key === 'Tab') {
+                                    e.preventDefault();
+                                    setOpen(false);
+                                }
+                            }, row: true, align: "flex-start", justify: "flex-start", gap: "s2", style: { borderRadius: blockRadii.inset, paddingVertical: 8, paddingHorizontal: 10 }, children: [danger ? _jsx(Box, { pt: "s1", children: _jsx(Icon, { name: "trash", size: 14, color: ink }) }) : null, _jsxs(Box, { flex: 1, style: { minWidth: 0 }, children: [_jsx(Text, { variant: "caption", style: { color: ink, fontWeight: danger ? '600' : '400' }, children: item.label }), item.detail ? _jsx(Text, { variant: "caption", style: { fontSize: 12, color: danger ? colors.status.needsUser : colors.textSecondary }, children: item.detail }) : null] })] }, item.value));
+                    }) }) })] }));
+}
+/* ── O4 · Modal ──────────────────────────────────────────────────────────── */
+/**
+ * **A dialog over a scrim: title, body, verb buttons.** `role="dialog"`, `aria-modal`, named by
+ * its title. Focus is trapped while open; Escape and the scrim close it; focus returns to whatever
+ * opened it (pass `returnFocus`, usually `useAnchor().focus`). Buttons say the verb — "Remove",
+ * not "OK" — the same rule `useConfirm` states.
+ */
+export function Modal({ open, onClose, title, children, actions, returnFocus, maxWidth = 420, }) {
+    const { colors, lift2 } = useDs();
+    const titleId = `modal-${useId().replace(/:/g, '')}`;
+    return (_jsx(Layer, { open: open, onClose: onClose, returnFocus: returnFocus, scrim: true, labelledBy: titleId, placement: { kind: 'center', maxWidth }, children: _jsxs(Box, { p: "s5", gap: "s3", style: { borderRadius: blockRadii.major, backgroundColor: colors.surface1, boxShadow: lift2 }, children: [_jsx(Text, { nativeID: titleId, variant: "heading", role: "heading", "aria-level": 2, children: title }), typeof children === 'string' ? _jsx(Text, { variant: "caption", color: "textSecondary", children: children }) : children, actions ? _jsx(Box, { row: true, wrap: true, gap: "s2", justify: "flex-end", children: actions }) : null] }) }));
+}
+/* ── O4 · Popover ────────────────────────────────────────────────────────── */
+/**
+ * **Anchored content that is not a menu** — a small form, a detail. A button with
+ * `aria-haspopup="dialog"` opens a labelled, non-scrimmed layer below it; Escape and an outside
+ * press close it and return focus to the trigger.
+ */
+export function Popover({ label, trigger, children, width = 260, }) {
+    const { colors, density, lift2 } = useDs();
+    const anchor = useAnchor();
+    const [open, setOpen] = useState(false);
+    const close = () => setOpen(false);
+    return (_jsxs(_Fragment, { children: [_jsx(Pressable, { ref: anchor.ref, onPress: () => { anchor.measure(); setOpen(true); }, "aria-haspopup": "dialog", "aria-expanded": open, "aria-label": trigger, px: "s3", alignSelf: "flex-start", minHeight: density.controlH, style: { borderRadius: blockRadii.inset, boxShadow: `0 0 0 1px ${colors.hairlineStrong}`, backgroundColor: colors.surface1 }, children: _jsx(Text, { variant: "caption", color: "textPrimary", children: trigger }) }), _jsx(Layer, { open: open, onClose: close, returnFocus: anchor.focus, label: label, placement: { kind: 'anchor', rect: anchor.rect, width }, children: _jsx(Box, { p: "s3", gap: "s2", style: { borderRadius: blockRadii.mid, backgroundColor: colors.surface1, boxShadow: lift2 }, children: children }) })] }));
+}
+/* ── O4 · Tooltip ────────────────────────────────────────────────────────── */
+/** Hover or focus must rest this long before a tooltip appears — the handoff's 300ms. */
+export const TOOLTIP_DELAY_MS = 300;
+/**
+ * **A short description, shown after 300ms of hover or focus; Escape dismisses it.** A render
+ * prop hands the trigger its handlers and `aria-describedby`, so the tooltip describes a real
+ * control instead of wrapping it in a second button. Never put anything in a tooltip that a touch
+ * user needs: touch has no hover, and this does not pretend otherwise.
+ */
+export function Tooltip({ label, children, }) {
+    const { colors } = useDs();
+    const [shown, setShown] = useState(false);
+    const timer = useRef(null);
+    const id = `tip-${useId().replace(/:/g, '')}`;
+    useEffect(() => () => { if (timer.current)
+        clearTimeout(timer.current); }, []);
+    const show = () => {
+        if (timer.current)
+            clearTimeout(timer.current);
+        timer.current = setTimeout(() => setShown(true), TOOLTIP_DELAY_MS);
+    };
+    const hide = () => {
+        if (timer.current)
+            clearTimeout(timer.current);
+        setShown(false);
+    };
+    return (_jsxs(Box, { alignSelf: "flex-start", style: { position: 'relative' }, children: [children({
+                onHoverIn: show, onHoverOut: hide, onFocus: show, onBlur: hide,
+                onKeyDown: e => { if (e.key === 'Escape')
+                    hide(); },
+                'aria-describedby': id,
+            }), _jsx(Box, { nativeID: id, role: "tooltip", "aria-hidden": !shown, style: {
+                    position: 'absolute', bottom: '100%', left: 0, marginBottom: 6,
+                    paddingHorizontal: 8, paddingVertical: 4, borderRadius: blockRadii.inset,
+                    backgroundColor: colors.textPrimary, minWidth: 120, maxWidth: 240,
+                    opacity: shown ? 1 : 0, pointerEvents: 'none',
+                }, children: _jsx(Text, { variant: "caption", style: { fontSize: 12, color: colors.surface1 }, children: label }) })] }));
+}
+//# sourceMappingURL=blockOverlay.js.map

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

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

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

@@ -0,0 +1,79 @@
+/**
+ * **Solarium Building Blocks — sequence.** Q1 Vertical stepper · Q2 Horizontal timeline ·
+ * Q3 Dot pager · Q4 Step counter.
+ *
+ * **Always neutral — never hue-coded.** A sequence is progress through ONE thing, so every step is
+ * the same category; colouring steps would make them read as different kinds of work. This is also
+ * why Q1 is "not Solarium's hue-coded Step" (the handoff's own words): `solarium`'s `Step` is a
+ * different component with a different job.
+ */
+export type BlockStepState = 'done' | 'current' | 'pending' | 'attention';
+export type BlockStep = {
+    id: string;
+    label: string;
+    /** A second line — a date, a branch, "Sep 22". */
+    detail?: string;
+    state: BlockStepState;
+    /** A bold apricot line under the detail — "Delayed". `variant="track"` only. */
+    note?: string;
+};
+/**
+ * **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 declare function VerticalStepper({ label, steps }: {
+    label: string;
+    steps: BlockStep[];
+}): import("react").JSX.Element;
+/** A column never narrower than this; past the container's width the timeline scrolls. */
+export declare 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 declare function Timeline({ label, steps, variant }: {
+    label: string;
+    steps: BlockStep[];
+    /**
+     * `track` — batch 3's Q2 (Shipping Update): an ordered list whose columns are at least 120px, the
+     * label left-aligned under a node, a connector to the next node whose ink fill grows (M6), and
+     * `attention` drawn as a 3px apricot-deep ring (a delay — no red). Default `centred`: as before.
+     */
+    variant?: 'centred' | 'track';
+}): import("react").JSX.Element;
+/** Q2 `track`: a column is never narrower than this — narrow screens scroll the list, not the page. */
+export declare const TRACK_MIN_COLUMN = 120;
+/** Past this many pages, a row of dots stops being countable — use `StepCounter`. */
+export declare const DOT_PAGER_MAX = 7;
+/**
+ * **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 declare function DotPager({ label, count, index, onChange, tone, itemLabel, }: {
+    label: string;
+    count: number;
+    index: number;
+    onChange: (next: number) => void;
+    tone?: 'neutral' | 'accent';
+    /** A dot's name. Default "Page 2 of 4". */
+    itemLabel?: (i: number, count: number) => string;
+}): import("react").JSX.Element;
+/**
+ * **"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 declare function StepCounter({ index, total, next, doneLabel, }: {
+    /** 0-based. */
+    index: number;
+    total: number;
+    /** The next step's name. Ignored on the last step. */
+    next?: string;
+    doneLabel?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=blockSequence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blockSequence.d.ts","sourceRoot":"","sources":["../../../src/ds/blockSequence.tsx"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAE1E,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,CAAC;IACtB,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAoCF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,+BAmCtF;AAID,0FAA0F;AAC1F,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAmB,EAAE,EAAE;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CAC/B,+BAGA;AAmDD,uGAAuG;AACvG,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAwEpC,qFAAqF;AACrF,eAAO,MAAM,aAAa,IAAI,CAAC;AAwB/B;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAgB,EAAE,SAAS,GAC3D,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CAClD,+BAmBA;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAqB,GAC1C,EAAE;IACD,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAUA"}