@appinternalleads/ui 0.2.0

package/dist/esm/ds/SubScreenHeader.js

@@ -0,0 +1,43 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Icon, Pressable, Text } from '../core';
+import { isAndroid, useDs } from '../tokens';
+/**
+ * **The one back control** (13 Sep 2026). Every pushed screen in app 1 draws this, whether through
+ * `SubScreenHeader`, `AppHeader`, or on its own above a custom head — so a back button looks and sits the
+ * same on every page. Before it there were eight: a typed `‹` in grey, chevrons at 15/16/20pt in two inks,
+ * the accent caret, and React Navigation's native header.
+ *
+ * - **iOS:** the accent caret and the label, 44pt tall, at the start of its row.
+ * - **Android:** the M3 40dp round `←`, no label (the accessible name still carries it).
+ *
+ * The caller owns horizontal position through its gutter; this adds no margin of its own.
+ */
+export function BackButton({ onPress, label = 'Back' }) {
+    const { colors } = useDs();
+    if (isAndroid) {
+        /* Centred in the M3 app bar's 56dp row even when drawn on its own, so a screen without SubScreenHeader
+           puts the arrow at the same height as one with it. */
+        return (_jsx(Box, { height: 56, justify: "center", children: _jsx(Pressable, { onPress: onPress, hit: 40, radius: "pill", "aria-label": label, children: _jsx(Icon, { name: "back", size: 22, color: colors.textPrimary }) }) }));
+    }
+    return (_jsxs(Pressable, { onPress: onPress, row: true, align: "center", justify: "flex-start", gap: "s1", minHeight: 44, alignSelf: "flex-start", "aria-label": label, children: [_jsx(Icon, { name: "caretLeft", size: 16, color: colors.accentInk }), _jsx(Text, { color: "accentInk", variant: "label", style: { fontWeight: '400' }, children: label })] }));
+}
+/**
+ * **A pushed screen's header, in each platform's own shape** (Settings handoff, SET-15, 13 Sep 2026).
+ *
+ * - **iOS:** `‹ Back` on its own row, then the 32px large title, then the subtitle.
+ * - **Android:** the M3 top app bar — a 56dp row with a 40dp round `←` and an 18/600 title — then the
+ *   subtitle 2dp beneath. Every Android frame in the handoff draws this, root included.
+ *
+ * **Not a change to `AppHeader`.** That header serves every screen in two apps, and swapping its
+ * Android shape would restyle screens no handoff has redrawn. A screen opts in by using this.
+ */
+export function SubScreenHeader({ title, subtitle, onBack, backLabel = 'Back', accent }) {
+    const sub = subtitle === undefined || subtitle === null || subtitle === '' ? null : (_jsx(Text, { variant: "screenSubtitle", color: "textSecondary", style: [{ marginTop: isAndroid ? 2 : 4 }, accent ? { color: accent, fontWeight: '600' } : null], children: subtitle }));
+    const bar = accent ? (_jsx(Box, { style: { width: 28, height: 4, borderRadius: 2, marginTop: 6, backgroundColor: accent, boxShadow: `0 0 8px ${accent}` } })) : null;
+    if (isAndroid) {
+        return (_jsxs(Box, { children: [_jsxs(Box, { row: true, align: "center", height: 56, style: { gap: 14 }, children: [onBack ? _jsx(BackButton, { onPress: onBack, label: backLabel }) : null, _jsx(Text, { variant: "appBarTitle", role: "heading", numberOfLines: 1, style: { flexShrink: 1 }, children: title })] }), bar, sub] }));
+    }
+    return (_jsxs(Box, { gap: "s2", children: [onBack ? _jsx(BackButton, { onPress: onBack, label: backLabel }) : null, _jsxs(Box, { children: [_jsx(Text, { variant: "screenTitle", role: "heading", children: title }), bar, sub] })] }));
+}
+//# sourceMappingURL=SubScreenHeader.js.map

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

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

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

@@ -0,0 +1,75 @@
+/**
+ * **The Solarium Building Blocks catalogue — the single source of truth for the 51 blocks.**
+ *
+ * Pure data: no React, no import of the components themselves — and no text that reads like a hook
+ * call (the word "use", a capital, an opening parenthesis), because `tools/use-client.mjs` marks any
+ * module containing one as a client module, and this one must stay importable from a server
+ * component: the site's static params read it. The site's `/components/blocks` and
+ * `/playground/blocks` routes, their navigation, and the catalogue tests all read THIS list —
+ * adding a block here is what makes it discoverable, and there is no second list anywhere to keep
+ * in step. Storybook registers stories from `*.stories.tsx` as always; each entry names its story
+ * title so the site can link to it.
+ *
+ * A block is not a component FAMILY. Families (`COMPONENT_CATALOGUE`: Directory, Checklist,
+ * ThresholdFlow) own a portable document and a runtime; blocks are the reusable primitives they
+ * are built from, and ThresholdFlow is deliberately absent from this list.
+ *
+ * Source: `design_handoff_solarium_blocks_case_studies` — every ID below is the handoff's own.
+ * Reconciliation: `docs/HANDOFF-SOLARIUM-BLOCKS.md` §3. Solarium 0.2.0 (22 Sep 2026) dropped M1 and M12
+ * and added M14: 51 − 2 + 1 = 50. Batch 4 added C14, the people picker (block #51): 51.
+ */
+export type BlockGroup = 'structure' | 'controls' | 'display' | 'sequence' | 'overlay' | 'motion';
+/**
+ * `implemented` — exported and tested. `deferred` — specified by the handoff but held on an open
+ * decision; it has an entry so the catalogue is complete, and its page says why it is absent. No
+ * entry is deferred today — Solarium 0.2.0 dropped M1 and M12 outright rather than holding them.
+ */
+export type BlockStatus = 'implemented' | 'deferred';
+/** Where the block comes from: built for this handoff, or an existing library component it maps to. */
+export type BlockOrigin = 'new' | 'existing';
+export type BlockApiRow = {
+    prop: string;
+    type: string;
+    note: string;
+};
+export type BlockEntry = {
+    /** The handoff's id — `C1`, `M5`. */
+    id: string;
+    /** Route segment: `/components/blocks/<slug>`. Unique. */
+    slug: string;
+    name: string;
+    group: BlockGroup;
+    status: BlockStatus;
+    origin: BlockOrigin;
+    /** The `@comppack/ui` exports this block is. Empty for a motion-only or deferred entry. */
+    exports: string[];
+    /** Storybook title the block's stories live under. */
+    storyTitle?: string;
+    /** One line. */
+    summary: string;
+    /** The named states the block's page renders side by side; the playground offers them. */
+    states: {
+        key: string;
+        label: string;
+    }[];
+    api: BlockApiRow[];
+    a11y: string[];
+    /** How motion (Solarium 0.2.0: one 160ms duration) and reduced motion change this block — absent when they do not. */
+    profile?: string;
+    density?: string;
+};
+/** When the block catalogue shipped (YYYY-MM-DD) — compared with the families' `introduced`. */
+export declare const BLOCKS_INTRODUCED = "2026-09-23";
+export declare const BLOCK_GROUPS: {
+    key: BlockGroup;
+    label: string;
+    blurb: string;
+}[];
+export declare const BLOCK_CATALOGUE: BlockEntry[];
+/** The catalogue query the site runs — mirrors `getComponents`. */
+export declare function getBlocks(opts?: {
+    group?: BlockGroup;
+    status?: BlockStatus;
+}): BlockEntry[];
+export declare function blockBySlug(slug: string): BlockEntry | undefined;
+//# sourceMappingURL=blockCatalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blockCatalog.d.ts","sourceRoot":"","sources":["../../../src/ds/blockCatalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElG;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,UAAU,CAAC;AAErD,uGAAuG;AACvG,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,UAAU,CAAC;AAE7C,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,MAAM,MAAM,UAAU,GAAG;IACvB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,2FAA2F;IAC3F,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,0FAA0F;IAC1F,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzC,GAAG,EAAE,WAAW,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,sHAAsH;IACtH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C,eAAO,MAAM,YAAY,EAAE;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAO3E,CAAC;AAKF,eAAO,MAAM,eAAe,EAAE,UAAU,EA0evC,CAAC;AAEF,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAAG,UAAU,EAAE,CAI/F;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAEhE"}