@nanisoft/prism-ui 0.16.0 → 1.0.0

package/dist/live/tool-call-row.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { cn } from '../lib/utils.js';
+/**
+ * The ink each state is stated in, and the tick beside it.
+ *
+ * The tick is the state's own first letter rather than a glyph this file invented,
+ * so there is nothing to translate and nothing to learn twice: `f` is the failed
+ * call in every locale, and it is a letter rather than a shape, so it survives a
+ * monochrome render and a screen at 200 per cent the way a hairline does not.
+ *
+ * `queued` and `cancelled` share the muted ink, and the letters are what tell them
+ * apart. That is the same trade `Status` makes and states: a wider palette on a
+ * surface a reader scans is a wider set of colours they have to learn, and the
+ * cost of a shared ink is one letter.
+ */
+const STATE_INK = {
+    queued: 'text-muted-foreground',
+    running: 'text-foreground',
+    succeeded: 'text-success',
+    failed: 'text-destructive',
+    cancelled: 'text-muted-foreground',
+};
+/** The tick each state draws, so the five are told apart without relying on colour. */
+const STATE_MARK = {
+    queued: 'q',
+    running: 'r',
+    succeeded: 's',
+    failed: 'f',
+    cancelled: 'c',
+};
+/** The clock a row reads, in UTC, because the surface holds no locale to format in. */
+export const clockOf = (at) => new Date(at).toISOString().slice(11, 19);
+/**
+ * One tool call, drawn as the ledger draws it.
+ *
+ * **This is the tool-call row the `live` Kind owns, and it is shared rather than
+ * copied.** `ToolLedger01` draws one row per call in its ledger, and a
+ * conversation's tool-call part draws the same row inside a message, so the two
+ * surfaces cannot drift into two shapes for one call. `ToolLedger01` renders this
+ * inside its own `<li>`; the message thread renders it inside a part. The
+ * Component owns no `<li>`, so it can sit in either list without nesting one.
+ *
+ * **The duration is the difference between two sightings of the same call, and
+ * only when there are two.** `openedAt` is the moment the surface first saw the
+ * call's `id`; a call seen once has no second timestamp and draws no duration,
+ * because a zero is a claim that a call took no time. The sentence is the
+ * consumer's, on `call.durationLabel`, and the arithmetic is one subtraction of
+ * the consumer's own `at` values. There is no clock in this file.
+ */
+export function ToolCallRow({ call, openedAt }) {
+    // The difference between two sightings of the same call, and only when there
+    // are two. The sentence is the consumer's, the arithmetic is one subtraction of
+    // the consumer's own timestamps, and there is no clock in this file.
+    const elapsed = call.at - openedAt;
+    const duration = elapsed > 0 && call.durationLabel !== undefined
+        ? call.durationLabel(elapsed, { id: call.id, name: call.name })
+        : null;
+    return (_jsxs(_Fragment, { children: [_jsxs("div", { className: "flex flex-wrap items-baseline gap-x-2 gap-y-1", children: [_jsx("span", { "aria-hidden": "true", className: cn('font-mono text-xs', STATE_INK[call.state]), children: STATE_MARK[call.state] }), _jsx("time", { dateTime: new Date(openedAt).toISOString(), className: "text-muted-foreground font-mono text-xs tabular-nums", children: clockOf(openedAt) }), _jsx("span", { className: "text-foreground text-sm font-medium", children: call.name }), call.spanLabel ? (_jsx("span", { "data-slot": "tool-ledger-span", className: "border-border text-muted-foreground rounded border px-1 font-mono text-xs", children: call.spanLabel })) : null, duration === null ? null : (_jsx("span", { "data-slot": "tool-ledger-duration", className: "text-muted-foreground ml-auto font-mono text-xs tabular-nums", children: duration }))] }), call.argumentsText === undefined ? null : (_jsx("span", { "data-slot": "tool-ledger-arguments", className: "text-muted-foreground font-mono text-xs break-words", children: call.argumentsText })), call.resultText === undefined ? null : (_jsx("span", { "data-slot": "tool-ledger-result", className: "text-muted-foreground text-pretty text-xs", children: call.resultText })), call.errorText === undefined ? null : (_jsx("span", { "data-slot": "tool-ledger-error", className: "text-destructive text-pretty text-xs", children: call.errorText })), call.link === undefined ? null : (_jsx("a", { "data-slot": "tool-ledger-link", href: call.link.href, className: "text-foreground self-start rounded-sm text-xs underline-offset-4 hover:underline", children: call.link.label }))] }));
+}
+export default ToolCallRow;

package/dist/live/tool-ledger-01/tool-ledger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-ledger.d.ts","sourceRoot":"","sources":["../../../src/live/tool-ledger-01/tool-ledger.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAOnE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAA;AAEvF;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAA;IACV;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;;;OAOG;IACH,EAAE,EAAE,MAAM,CAAA;IACV,sDAAsD;IACtD,KAAK,EAAE,aAAa,CAAA;IACpB;;;;;;;;;;;;;;;;;OAiBG;IACH,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAA;IAC1E;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE;QACL,qBAAqB;QACrB,IAAI,EAAE,MAAM,CAAA;QACZ,6BAA6B;QAC7B,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;CACF,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;AAE1E;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;;;;;;OAQG;IACH,SAAS,EAAE,aAAa,CAAA;IACxB;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC/B;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;;;OAOG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;OAOG;IACH,KAAK,EAAE,SAAS,CAAA;IAChB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IACxC;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,CACA;IAAE,YAAY,CAAC,EAAE,KAAK,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAC;IAAC,WAAW,CAAC,EAAE,KAAK,CAAA;CAAE,GACjE;IAAE,YAAY,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAClE,CAAA;AA+FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8FG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,SAAS,EACT,cAAc,EACd,KAAK,EACL,KAAK,EACL,KAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,MAAM,EACN,SAAS,GACV,EAAE,iBAAiB,+BAwNnB;AAED,eAAe,YAAY,CAAA"}
+{"version":3,"file":"tool-ledger.d.ts","sourceRoot":"","sources":["../../../src/live/tool-ledger-01/tool-ledger.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAQnE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAA;AAEvF;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB;;;;;;OAMG;IACH,EAAE,EAAE,MAAM,CAAA;IACV;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;;;OAOG;IACH,EAAE,EAAE,MAAM,CAAA;IACV,sDAAsD;IACtD,KAAK,EAAE,aAAa,CAAA;IACpB;;;;;;;;;;;;;;;;;OAiBG;IACH,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAA;IAC1E;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE;QACL,qBAAqB;QACrB,IAAI,EAAE,MAAM,CAAA;QACZ,6BAA6B;QAC7B,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;CACF,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;AAE1E;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;;;;;;OAQG;IACH,SAAS,EAAE,aAAa,CAAA;IACxB;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC/B;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;;;;OAOG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;OAOG;IACH,KAAK,EAAE,SAAS,CAAA;IAChB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IACxC;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,CACA;IAAE,YAAY,CAAC,EAAE,KAAK,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAC;IAAC,WAAW,CAAC,EAAE,KAAK,CAAA;CAAE,GACjE;IAAE,YAAY,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAClE,CAAA;AA8DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8FG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,SAAS,EACT,cAAc,EACd,KAAK,EACL,KAAK,EACL,KAAW,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,MAAM,EACN,SAAS,GACV,EAAE,iBAAiB,+BAgInB;AAED,eAAe,YAAY,CAAA"}

package/dist/live/tool-ledger-01/tool-ledger.js

@@ -5,6 +5,7 @@ import { Button } from '../../components/ui/button.js';
 import { LiveRegion } from '../../components/ui/live-region.js';
 import { ScrollArea } from '../../components/ui/scroll-area.js';
 import { cn } from '../../lib/utils.js';
+import { ToolCallRow } from '../tool-call-row.js';
 /**
  * The one source of truth for order, so a late call with an earlier `at` sorts
  * there and two runs of the same suite render the same ledger. Ties break on
@@ -27,36 +28,6 @@ function seedOf(calls, limit) {
     const dropped = rows.length - limit;
     return { rows: rows.slice(dropped), dropped };
 }
-/**
- * The ink each state is stated in, and the tick beside it.
- *
- * The tick is the state's own first letter rather than a glyph this file invented,
- * so there is nothing to translate and nothing to learn twice: `f` is the failed
- * call in every locale, and it is a letter rather than a shape, so it survives a
- * monochrome render and a screen at 200 per cent the way a hairline does not.
- *
- * `queued` and `cancelled` share the muted ink, and the letters are what tell them
- * apart. That is the same trade `Status` makes and states: a wider palette on a
- * surface a reader scans is a wider set of colours they have to learn, and the
- * cost of a shared ink is one letter.
- */
-const STATE_INK = {
-    queued: 'text-muted-foreground',
-    running: 'text-foreground',
-    succeeded: 'text-success',
-    failed: 'text-destructive',
-    cancelled: 'text-muted-foreground',
-};
-/** The tick each state draws, so the five are told apart without relying on colour. */
-const STATE_MARK = {
-    queued: 'q',
-    running: 'r',
-    succeeded: 's',
-    failed: 'f',
-    cancelled: 'c',
-};
-/** The clock a row reads, in UTC, because the surface holds no locale to format in. */
-const clockOf = (at) => new Date(at).toISOString().slice(11, 19);
 /** One call merged into the ledger, and what fell off the top doing it. */
 function merge(rows, call, limit) {
     const at = rows.findIndex((row) => row.call.id === call.id);
@@ -229,17 +200,6 @@ export function ToolLedger01({ subscribe, callbacks, resubscribeKey, label, empt
                 stop();
         };
     }, [subscribe, resubscribeKey, limit]);
-    return (_jsxs("section", { "data-slot": "tool-ledger", className: cn('border-border flex flex-col gap-4 rounded-lg border p-4', className), children: [LiveRegion({ politeness: 'polite', children: newest }), droppedLabel === undefined && pauseControl !== true ? null : (_jsxs("div", { "data-slot": "tool-ledger-bar", className: "flex flex-wrap items-center gap-3", children: [run.dropped > 0 && droppedLabel !== undefined ? (_jsx("p", { "data-slot": "tool-ledger-dropped", className: "text-muted-foreground text-xs", children: droppedLabel(run.dropped) })) : null, pauseControl !== true ? null : (_jsx(Button, { "data-slot": "tool-ledger-pause", type: "button", variant: "outline", size: "sm", "aria-pressed": held, className: "ml-auto", onClick: () => setHeld(!heldRef.current), children: held ? resumeLabel : pauseLabel }))] })), rows.length === 0 ? (_jsx("p", { "data-slot": "tool-ledger-empty", className: "text-muted-foreground text-sm", children: empty })) : (_jsx(ScrollArea, { label: label, className: "max-h-96", children: _jsx("ol", { "data-slot": "tool-ledger-calls", className: "flex flex-col", children: rows.map((row) => {
-                        const { call } = row;
-                        // The difference between two sightings of the same call, and only when
-                        // there are two. The sentence is the consumer's, the arithmetic is one
-                        // subtraction of the consumer's own timestamps, and there is no clock
-                        // in this file.
-                        const elapsed = call.at - row.openedAt;
-                        const duration = elapsed > 0 && call.durationLabel !== undefined
-                            ? call.durationLabel(elapsed, { id: call.id, name: call.name })
-                            : null;
-                        return (_jsxs("li", { "data-slot": "tool-ledger-call", "data-state": call.state, className: "border-border flex flex-col gap-1 border-b py-3 last:border-b-0", children: [_jsxs("div", { className: "flex flex-wrap items-baseline gap-x-2 gap-y-1", children: [_jsx("span", { "aria-hidden": "true", className: cn('font-mono text-xs', STATE_INK[call.state]), children: STATE_MARK[call.state] }), _jsx("time", { dateTime: new Date(row.openedAt).toISOString(), className: "text-muted-foreground font-mono text-xs tabular-nums", children: clockOf(row.openedAt) }), _jsx("span", { className: "text-foreground text-sm font-medium", children: call.name }), call.spanLabel ? (_jsx("span", { "data-slot": "tool-ledger-span", className: "border-border text-muted-foreground rounded border px-1 font-mono text-xs", children: call.spanLabel })) : null, duration === null ? null : (_jsx("span", { "data-slot": "tool-ledger-duration", className: "text-muted-foreground ml-auto font-mono text-xs tabular-nums", children: duration }))] }), call.argumentsText === undefined ? null : (_jsx("span", { "data-slot": "tool-ledger-arguments", className: "text-muted-foreground font-mono text-xs break-words", children: call.argumentsText })), call.resultText === undefined ? null : (_jsx("span", { "data-slot": "tool-ledger-result", className: "text-muted-foreground text-pretty text-xs", children: call.resultText })), call.errorText === undefined ? null : (_jsx("span", { "data-slot": "tool-ledger-error", className: "text-destructive text-pretty text-xs", children: call.errorText })), call.link === undefined ? null : (_jsx("a", { "data-slot": "tool-ledger-link", href: call.link.href, className: "text-foreground self-start rounded-sm text-xs underline-offset-4 hover:underline", children: call.link.label }))] }, call.id));
-                    }) }) }))] }));
+    return (_jsxs("section", { "data-slot": "tool-ledger", className: cn('border-border flex flex-col gap-4 rounded-lg border p-4', className), children: [LiveRegion({ politeness: 'polite', children: newest }), droppedLabel === undefined && pauseControl !== true ? null : (_jsxs("div", { "data-slot": "tool-ledger-bar", className: "flex flex-wrap items-center gap-3", children: [run.dropped > 0 && droppedLabel !== undefined ? (_jsx("p", { "data-slot": "tool-ledger-dropped", className: "text-muted-foreground text-xs", children: droppedLabel(run.dropped) })) : null, pauseControl !== true ? null : (_jsx(Button, { "data-slot": "tool-ledger-pause", type: "button", variant: "outline", size: "sm", "aria-pressed": held, className: "ml-auto", onClick: () => setHeld(!heldRef.current), children: held ? resumeLabel : pauseLabel }))] })), rows.length === 0 ? (_jsx("p", { "data-slot": "tool-ledger-empty", className: "text-muted-foreground text-sm", children: empty })) : (_jsx(ScrollArea, { label: label, className: "max-h-96", children: _jsx("ol", { "data-slot": "tool-ledger-calls", className: "flex flex-col", children: rows.map((row) => (_jsx("li", { "data-slot": "tool-ledger-call", "data-state": row.call.state, className: "border-border flex flex-col gap-1 border-b py-3 last:border-b-0", children: _jsx(ToolCallRow, { call: row.call, openedAt: row.openedAt }) }, row.call.id))) }) }))] }));
 }
 export default ToolLedger01;

package/dist/pages/contact-page/index.d.ts

@@ -18,16 +18,16 @@ export type ContactPageOption = {
 /**
  * One declared field of the contact form.
  *
- * **Flat, on purpose, where `ContactField` is a union.** A consumer's form data is
+ * **Flat, on purpose, where `FieldSpec` is a union.** A consumer's form data is
  * flat: a record read out of a content type, a CMS entry or a JSON file has one
  * shape with an optional `options` key, and a caller that had to narrow their own
  * record before they could hand it to a page would be doing the Block's type work
- * at every call site. So the union is built once, inside this module, and the one
- * shape it cannot build is refused here with a message that names the Page's own
- * prop. That is `AboutPage`'s arrangement for the same pair of link fields, and the
- * cost is the same: a caller who wants the compile error rather than the thrown one
- * types their fields against `ContactField` and passes the result here, which
- * works because the two are structurally the same.
+ * at every call site. So the flat record is converted to the shared specification
+ * once, inside this module, and the one shape it cannot build is refused here with
+ * a message that names the Page's own prop. That is `AboutPage`'s arrangement for
+ * the same pair of link fields, and the cost is the same: a caller who wants the
+ * compile error rather than the thrown one types their fields as `FieldSpec` and
+ * composes `Contact01` directly.
  */
 export type ContactPageField = {
     /** The caller's key for this field, and the key the value arrives under. */

package/dist/pages/contact-page/index.d.ts.map

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

package/dist/pages/contact-page/index.js

@@ -4,6 +4,7 @@ import { Contact01, } from '../../blocks/contact-01/index.js';
 import { Card, CardContent, CardHeader, CardTitle } from '../../components/ui/card.js';
 import { CtaLink } from '../../components/ui/cta-link.js';
 import { Section, SectionHeading, childLevel } from '../../components/ui/section.js';
+import { FieldKindName } from '../../lib/field-render.js';
 import { cn } from '../../lib/utils.js';
 /**
  * One declared field as `Contact01` draws it, with the two shapes kept apart.
@@ -16,15 +17,26 @@ import { cn } from '../../lib/utils.js';
  */
 function asContactField(field) {
     const shared = {
-        id: field.id,
+        key: field.id,
         label: field.label,
         required: field.required,
-        description: field.description,
+        help: field.description,
         placeholder: field.placeholder,
         autoComplete: field.autoComplete,
     };
+    if (field.type === 'textarea')
+        return { ...shared, kind: FieldKindName.textarea, rows: 4 };
+    /*
+      `text`, `email` and `tel` all draw Prism's `Input`, which is the control this
+      package ships for a run of characters; the platform's own `type` attributes are
+      not part of the shared vocabulary, so asking for an email is asking for an
+      `Input` with the `autoComplete` hint a password manager reads. `inputMode` and
+      `type` are the platform's, and the caller who needs a numeric keypad reaches for
+      the `NumberField` kind on the Block directly rather than through this Page's
+      flat prop.
+    */
     if (field.type !== 'select')
-        return { ...shared, type: field.type };
+        return { ...shared, kind: FieldKindName.input };
     const options = field.options ?? [];
     if (options.length === 0) {
         throw new Error(`ContactPage: the field "${field.id}" is a select and passes no options, so the control would render with ` +
@@ -32,7 +44,7 @@ function asContactField(field) {
             'there and focusable. Pass the choices, or declare the field as a text field and check the answer in ' +
             'your own handler.');
     }
-    return { ...shared, type: 'select', options: options.map((option) => ({ ...option })) };
+    return { ...shared, kind: FieldKindName.nativeSelect, options: options.map((option) => ({ ...option })) };
 }
 /**
  * The two checks the office union makes for a TypeScript caller, run here for the
@@ -125,7 +137,7 @@ export function ContactPage({ eyebrow, title, description, form, fields, onSubmi
     */
     const BandHeading = childLevel(headingLevel);
     const OfficeHeading = childLevel(BandHeading);
-    return (_jsxs("div", { "data-slot": "contact-page", className: cn(className), children: [_jsx(Section, { "data-slot": "contact-page-heading", children: _jsx(SectionHeading, { as: headingLevel, align: "left", eyebrow: eyebrow, title: title, description: description }) }), _jsx(Contact01, { title: form.title, description: form.description, fields: fields.map(asContactField), onSubmit: onSubmit, submitLabel: submitLabel, consent: consent, status: status, variant: "stacked", headingLevel: BandHeading }), offices === undefined ? null : (_jsxs(Section, { "data-slot": "contact-page-offices", children: [_jsx(SectionHeading, { as: BandHeading, align: "left", title: officesLabel, className: "mb-10" }), _jsx("div", { "data-slot": "contact-page-office-row", className: "grid items-start gap-6 md:grid-cols-2 lg:grid-cols-3", children: offices.map((office) => (_jsxs(Card, { "data-slot": "contact-page-office", "data-office": office.id, className: "h-full", children: [_jsx(CardHeader, { children: _jsx(CardTitle, { as: OfficeHeading, children: office.name }) }), _jsxs(CardContent, { className: "flex flex-col items-start gap-4", children: [_jsx("address", { "data-slot": "contact-page-office-address", className: "text-muted-foreground flex flex-col gap-1 not-italic text-sm", children: office.lines.map((line, index) => (
+    return (_jsxs("div", { "data-slot": "contact-page", className: cn(className), children: [_jsx(Section, { "data-slot": "contact-page-heading", children: _jsx(SectionHeading, { as: headingLevel, align: "left", eyebrow: eyebrow, title: title, description: description }) }), _jsx(Contact01, { title: form.title, description: form.description, groups: [{ fields: fields.map(asContactField) }], onSubmit: onSubmit, submitLabel: submitLabel, consent: consent, status: status, variant: "stacked", headingLevel: BandHeading }), offices === undefined ? null : (_jsxs(Section, { "data-slot": "contact-page-offices", children: [_jsx(SectionHeading, { as: BandHeading, align: "left", title: officesLabel, className: "mb-10" }), _jsx("div", { "data-slot": "contact-page-office-row", className: "grid items-start gap-6 md:grid-cols-2 lg:grid-cols-3", children: offices.map((office) => (_jsxs(Card, { "data-slot": "contact-page-office", "data-office": office.id, className: "h-full", children: [_jsx(CardHeader, { children: _jsx(CardTitle, { as: OfficeHeading, children: office.name }) }), _jsxs(CardContent, { className: "flex flex-col items-start gap-4", children: [_jsx("address", { "data-slot": "contact-page-office-address", className: "text-muted-foreground flex flex-col gap-1 not-italic text-sm", children: office.lines.map((line, index) => (
                                             /*
                                               Positional, because a postal line is display content and a
                                               business with two branches on one street can legitimately

package/dist/pages/docs-shell/docs-shell.d.ts

@@ -188,17 +188,11 @@ export type DocsShellProps = {
      * The accessible name of the rail. Required whenever `nav` is passed, because
      * it is a word a reader hears and a Page that ships no copy ships no
      * reader-facing copy either.
-     *
-     * It is also the visible word on the disclosure that stands in for the rail
-     * below `lg`, because it is already this navigation's name and a Page cannot
-     * invent a second one. A consumer that files its navigation in another language
-     * gets the control in that language by having done this once.
      */
     navLabel: string;
     /**
      * The accessible name of the contents rail. Required whenever `toc` is passed,
-     * for the same reason `navLabel` is, and the contents disclosure below `lg`
-     * carries it for the same reason too.
+     * for the same reason `navLabel` is.
      */
     tocLabel: string;
     /**
@@ -347,32 +341,51 @@ export type DocsShellProps = {
  * a fact about ink, and announcing it would put a sentence in the middle of a
  * list of a consumer's own pages.
  *
- * **Below `lg` there was no navigation at all, and the fix is a native
- * disclosure.** At 768 and at 1024 both rails were `hidden` and the only
- * navigation left inside `<main>` was the two-item pager at the foot of the
- * article, so a reader on a thirty-one document reference at tablet width had no
- * contents, no on-this-page and no way to a sibling page except Previous and
- * Next. The disclosure is `<details>` and `<summary>`, which is the one
- * disclosure widget that needs no runtime at all: it is expanded and collapsed by
- * the platform, it is a real control in the Tab order with a real expanded state,
- * and adding a client boundary to a server Component to reinvent it would put
- * bytes on every documentation page in the family to save a reader one click.
+ * **The tree is in the document once, at every width, and the price of that is a
+ * phone reader crossing the whole navigation to reach the article.** At 768 and
+ * at 1024 both rails used to be `hidden`, so the only navigation left inside
+ * `<main>` was the two-item pager at the foot of the article, and a reader on a
+ * twenty-seven document reference at tablet width had no contents, no
+ * on-this-page and no way to a sibling page except Previous and Next. 0.16.0
+ * closed that gap by drawing the tree a second time behind a `<details>`, one
+ * copy for the rail and one for the narrow frame, and it shipped a doubled
+ * document to every documentation page in the family with it: two
+ * `aria-current` markers for one page, two lists of a consumer's own pages, two
+ * `docs-nav-page` rows for every document, and a second `<nav>` carrying the
+ * rail's own accessible name, which is the thing a consumer's suite reaches the
+ * rail by. Three consumer test files failed against the published package: two on
+ * a count that came back doubled, and two on a `getByRole('navigation', { name })`
+ * that had two answers where it expects one. So there is one copy now, and it
+ * shows at every width.
+ *
+ * **What that costs, with the number.** A consumer's rail measured 1,318 pixels
+ * of content in a built export at 1280 by 680, and those rows wrap on a phone, so
+ * a reader arriving at the top of a documentation page scrolls past a thousand
+ * pixels of navigation before the article begins. That is a real regression for
+ * that reader and it is the reason a disclosure was reached for in the first
+ * place. It is paid rather than hidden, because every arrangement that avoids it
+ * is worse: a rail at `lg` and nothing below it reopens the gap this change
+ * closes, and drawing the tree twice to keep the scroll short is what broke three
+ * consumer test files in the first place.
  *
- * The tree is rendered twice, once in each arrangement, and only one of them is
- * in the document at any width: the rail is `hidden lg:block` and the disclosure
- * is `lg:hidden`, so the other one is `display: none` and is out of the
- * accessibility tree and out of the tab order rather than a second copy a reader
- * meets. The summary carries `navLabel` or `tocLabel`, which is the caller's own
- * word for that navigation and therefore the one word on the control that cannot
- * be wrong in a language the consumer did not write in.
+ * **What would actually remove the scroll.** A collapsed rail below `lg` needs an
+ * open state. A server Component cannot hold one, and `<details>` is the only
+ * disclosure the platform holds on the Page's behalf, so the control that opens
+ * it has to be a client island inside the Page. That is a separate piece of work
+ * with its own budget, and it is not built here: a Page that ships a client
+ * boundary to save one scroll is making a different trade than the one stated
+ * above, and it should be made deliberately rather than smuggled in as the side
+ * effect of fixing a duplicate.
  *
  * **The frame is three columns from `lg`, and the third is the consumer's to
  * fill.** The rail is 15rem, the document takes the rest, and the contents rail
  * is 13rem. The third track exists only when `toc` is passed, because the
  * document takes the second track by auto-placement and a template that named a
  * track no child occupies would leave the document in the 15rem one. Below `lg`
- * the frame is a single column: the document fills it and the two navigations sit
- * above it behind their disclosures.
+ * the frame is a single column and the children flow in the order they are
+ * written: the rail, then the document, then the contents rail. The rail is the
+ * first child for that reason, so a reader below `lg` meets the navigation before
+ * the text rather than after it, and one arrangement serves both widths.
  *
  * It is a Page rather than a Block because it is a whole screen and it is the
  * screen a content pipeline targets: a route that reads one document and hands
@@ -383,10 +396,9 @@ export type DocsShellProps = {
  *
  * It is a server Component. It fetches nothing, it holds no state and it imports
  * no router, so a consumer renders it from whichever route their framework names
- * and hands it the document their pipeline produced. The sub-`lg` disclosure is
- * the reason that stays true under pressure: it is the one feature on this Page
- * that a hand would be tempted to write as a client Component, and it is written
- * as markup instead.
+ * and hands it the document their pipeline produced. Nothing here needs a client
+ * boundary, and the one feature that would want one is named above as work not
+ * done rather than quietly added.
  */
 export declare function DocsShell({ title, description, nav, toc, currentHref, navLabel, tocLabel, pagerLabel, pagerLabels, header, footer, className, children, }: DocsShellProps): import("react").JSX.Element;
 export default DocsShell;

package/dist/pages/docs-shell/docs-shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-shell.d.ts","sourceRoot":"","sources":["../../../src/pages/docs-shell/docs-shell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAOtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,OAAO,CAAA;IACb;;;;;;;;OAQG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;CAC/B,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,SAAS,CAAA;IACf,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,cAAc,CAAA;AAEtE;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB;;;;OAIG;IACH,GAAG,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IAC7B;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IAC7B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;;;OASG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,WAAW,EAAE,eAAe,CAAA;IAC5B;;;;;OAKG;IACH,QAAQ,EAAE,SAAS,CAAA;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsJG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,WAAW,EACX,GAAG,EACH,GAAG,EACH,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,WAAW,EACX,MAAM,EACN,MAAM,EACN,SAAS,EACT,QAAQ,GACT,EAAE,cAAc,+BA6GhB;AAsgBD,eAAe,SAAS,CAAA"}
+{"version":3,"file":"docs-shell.d.ts","sourceRoot":"","sources":["../../../src/pages/docs-shell/docs-shell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAOtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,OAAO,CAAA;IACb;;;;;;;;OAQG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;CAC/B,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,SAAS,CAAA;IACf,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,cAAc,CAAA;AAEtE;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB;;;;OAIG;IACH,GAAG,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IAC7B;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IAC7B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,WAAW,EAAE,eAAe,CAAA;IAC5B;;;;;OAKG;IACH,QAAQ,EAAE,SAAS,CAAA;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwKG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,WAAW,EACX,GAAG,EACH,GAAG,EACH,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,WAAW,EACX,MAAM,EACN,MAAM,EACN,SAAS,EACT,QAAQ,GACT,EAAE,cAAc,+BAiFhB;AA+fD,eAAe,SAAS,CAAA"}

package/dist/pages/docs-shell/docs-shell.js

@@ -113,32 +113,51 @@ import { cn } from '../../lib/utils.js';
  * a fact about ink, and announcing it would put a sentence in the middle of a
  * list of a consumer's own pages.
  *
- * **Below `lg` there was no navigation at all, and the fix is a native
- * disclosure.** At 768 and at 1024 both rails were `hidden` and the only
- * navigation left inside `<main>` was the two-item pager at the foot of the
- * article, so a reader on a thirty-one document reference at tablet width had no
- * contents, no on-this-page and no way to a sibling page except Previous and
- * Next. The disclosure is `<details>` and `<summary>`, which is the one
- * disclosure widget that needs no runtime at all: it is expanded and collapsed by
- * the platform, it is a real control in the Tab order with a real expanded state,
- * and adding a client boundary to a server Component to reinvent it would put
- * bytes on every documentation page in the family to save a reader one click.
- *
- * The tree is rendered twice, once in each arrangement, and only one of them is
- * in the document at any width: the rail is `hidden lg:block` and the disclosure
- * is `lg:hidden`, so the other one is `display: none` and is out of the
- * accessibility tree and out of the tab order rather than a second copy a reader
- * meets. The summary carries `navLabel` or `tocLabel`, which is the caller's own
- * word for that navigation and therefore the one word on the control that cannot
- * be wrong in a language the consumer did not write in.
+ * **The tree is in the document once, at every width, and the price of that is a
+ * phone reader crossing the whole navigation to reach the article.** At 768 and
+ * at 1024 both rails used to be `hidden`, so the only navigation left inside
+ * `<main>` was the two-item pager at the foot of the article, and a reader on a
+ * twenty-seven document reference at tablet width had no contents, no
+ * on-this-page and no way to a sibling page except Previous and Next. 0.16.0
+ * closed that gap by drawing the tree a second time behind a `<details>`, one
+ * copy for the rail and one for the narrow frame, and it shipped a doubled
+ * document to every documentation page in the family with it: two
+ * `aria-current` markers for one page, two lists of a consumer's own pages, two
+ * `docs-nav-page` rows for every document, and a second `<nav>` carrying the
+ * rail's own accessible name, which is the thing a consumer's suite reaches the
+ * rail by. Three consumer test files failed against the published package: two on
+ * a count that came back doubled, and two on a `getByRole('navigation', { name })`
+ * that had two answers where it expects one. So there is one copy now, and it
+ * shows at every width.
+ *
+ * **What that costs, with the number.** A consumer's rail measured 1,318 pixels
+ * of content in a built export at 1280 by 680, and those rows wrap on a phone, so
+ * a reader arriving at the top of a documentation page scrolls past a thousand
+ * pixels of navigation before the article begins. That is a real regression for
+ * that reader and it is the reason a disclosure was reached for in the first
+ * place. It is paid rather than hidden, because every arrangement that avoids it
+ * is worse: a rail at `lg` and nothing below it reopens the gap this change
+ * closes, and drawing the tree twice to keep the scroll short is what broke three
+ * consumer test files in the first place.
+ *
+ * **What would actually remove the scroll.** A collapsed rail below `lg` needs an
+ * open state. A server Component cannot hold one, and `<details>` is the only
+ * disclosure the platform holds on the Page's behalf, so the control that opens
+ * it has to be a client island inside the Page. That is a separate piece of work
+ * with its own budget, and it is not built here: a Page that ships a client
+ * boundary to save one scroll is making a different trade than the one stated
+ * above, and it should be made deliberately rather than smuggled in as the side
+ * effect of fixing a duplicate.
  *
  * **The frame is three columns from `lg`, and the third is the consumer's to
  * fill.** The rail is 15rem, the document takes the rest, and the contents rail
  * is 13rem. The third track exists only when `toc` is passed, because the
  * document takes the second track by auto-placement and a template that named a
  * track no child occupies would leave the document in the 15rem one. Below `lg`
- * the frame is a single column: the document fills it and the two navigations sit
- * above it behind their disclosures.
+ * the frame is a single column and the children flow in the order they are
+ * written: the rail, then the document, then the contents rail. The rail is the
+ * first child for that reason, so a reader below `lg` meets the navigation before
+ * the text rather than after it, and one arrangement serves both widths.
  *
  * It is a Page rather than a Block because it is a whole screen and it is the
  * screen a content pipeline targets: a route that reads one document and hands
@@ -149,10 +168,9 @@ import { cn } from '../../lib/utils.js';
  *
  * It is a server Component. It fetches nothing, it holds no state and it imports
  * no router, so a consumer renders it from whichever route their framework names
- * and hands it the document their pipeline produced. The sub-`lg` disclosure is
- * the reason that stays true under pressure: it is the one feature on this Page
- * that a hand would be tempted to write as a client Component, and it is written
- * as markup instead.
+ * and hands it the document their pipeline produced. Nothing here needs a client
+ * boundary, and the one feature that would want one is named above as work not
+ * done rather than quietly added.
  */
 export function DocsShell({ title, description, nav, toc, currentHref, navLabel, tocLabel, pagerLabel, pagerLabels, header, footer, className, children, }) {
     readTree(nav, 'nav');
@@ -177,10 +195,10 @@ export function DocsShell({ title, description, nav, toc, currentHref, navLabel,
                 // contents rail landed in an implicit `auto` track rather than the
                 // 13rem one. `check-breakpoint-variants.mjs` is the gate that says so
                 // to the next class written against a screen the theme does not emit.
-                contents ? 'lg:grid lg:grid-cols-[15rem_minmax(0,1fr)_13rem]' : 'lg:grid lg:grid-cols-[15rem_minmax(0,1fr)]'), children: [rail || contents ? (_jsxs("div", { "data-slot": "docs-nav-compact", className: "flex flex-col gap-4 lg:hidden", children: [rail ? (_jsx(Disclosure, { label: navLabel, unnamed: unnamedNav, children: _jsx(NavList, { entries: rail, currentHref: currentHref, depth: 0 }) })) : null, contents ? (_jsx(Disclosure, { label: tocLabel, unnamed: unnamedToc, children: _jsx(NavList, { entries: contents, currentHref: currentHref, depth: 0 }) })) : null] })) : null, rail ? (_jsx("aside", { "data-slot": "docs-rail", className: "hidden lg:col-start-1 lg:row-start-1 lg:block", children: _jsx(Rail, { label: navLabel, entries: rail, currentHref: currentHref, unnamed: unnamedNav }) })) : null, _jsxs("article", { "data-slot": "docs-article", className: "flex min-w-0 flex-col gap-8", children: [title ? (_jsxs("header", { className: "flex flex-col gap-3", children: [_jsx(Heading, { as: "h1", className: headingSizeClass('h1'), children: title }), description ? (_jsx(Text, { size: "lg", tone: "muted", className: "max-w-measure", children: description })) : null] })) : description ? (_jsx(Text, { size: "lg", tone: "muted", className: "max-w-measure", children: description })) : null, _jsx(Prose, { fullWidth: true, children: children }), neighbours ? (_jsx(Pager, { previous: neighbours.previous, next: neighbours.next, label: pagerLabel, labels: pagerLabels })) : null] }), contents ? (_jsx("aside", { "data-slot": "docs-contents", className: "hidden lg:col-start-3 lg:row-start-1 lg:block", children: _jsx(Rail, { label: tocLabel, entries: contents, currentHref: currentHref, unnamed: unnamedToc }) })) : null] }), footer] }));
+                contents ? 'lg:grid lg:grid-cols-[15rem_minmax(0,1fr)_13rem]' : 'lg:grid lg:grid-cols-[15rem_minmax(0,1fr)]'), children: [rail ? (_jsx("aside", { "data-slot": "docs-rail", className: "lg:col-start-1 lg:row-start-1", children: _jsx(Rail, { label: navLabel, entries: rail, currentHref: currentHref, unnamed: unnamedNav }) })) : null, _jsxs("article", { "data-slot": "docs-article", className: "flex min-w-0 flex-col gap-8", children: [title ? (_jsxs("header", { className: "flex flex-col gap-3", children: [_jsx(Heading, { as: "h1", className: headingSizeClass('h1'), children: title }), description ? (_jsx(Text, { size: "lg", tone: "muted", className: "max-w-measure", children: description })) : null] })) : description ? (_jsx(Text, { size: "lg", tone: "muted", className: "max-w-measure", children: description })) : null, _jsx(Prose, { fullWidth: true, children: children }), neighbours ? (_jsx(Pager, { previous: neighbours.previous, next: neighbours.next, label: pagerLabel, labels: pagerLabels })) : null] }), contents ? (_jsx("aside", { "data-slot": "docs-contents", className: "lg:col-start-3 lg:row-start-1", children: _jsx(Rail, { label: tocLabel, entries: contents, currentHref: currentHref, unnamed: unnamedToc }) })) : null] }), footer] }));
 }
 /* ------------------------------------------------------------------ *
- * The two rails at lg
+ * The two rails
  * ------------------------------------------------------------------ */
 /**
  * One rail: a region that scrolls inside a bound against the viewport, with the
@@ -214,32 +232,36 @@ export function DocsShell({ title, description, nav, toc, currentHref, navLabel,
  * usual cost of a fade and the reason the padding is part of the answer rather
  * than a detail.
  *
+ * **The bound, the sticky offset, the band and the fade are all written against
+ * the same `lg:`, so below `lg` this rail is an ordinary block in the flow: no
+ * scroll region, no cut, no reservation, no fade.** That is the right shape for a
+ * rail that is the first thing in a single column, because a sticky region a full
+ * viewport tall above the article would be worse than a long one above it.
+ *
+ * **The fade and the band are bound to the cut rather than to the rail, and the
+ * reason is what a fade is for.** A fade marks a cut, so it may only exist where
+ * there is one, and the cut is the `overflow-y` at `lg`: the scroll region, the
+ * cap, the sticky offset, the reserved band and the gradient are one arrangement
+ * or none of them. The fade shipped unprefixed, which put the arrangement out of
+ * step with itself at the one width that has no cut to mark. Below `lg` the region
+ * is an ordinary block, so the `pb-8` reserving the band is inert there and the
+ * gradient fell on the last row or two of a rail that was simply running on. The
+ * band and the fade still measured equal and the reader still lost nothing
+ * legible, which is why looking did not catch it: a gradient painted over content
+ * is a defect, and it is not a legibility one.
+ *
+ * **The limit bought here is stated rather than left to be found.** Below `lg` the
+ * rail is bounded by its content rather than by the viewport, so a long tree runs
+ * past the fold of a phone screen with nothing marking where it ends: no cut to
+ * mark, no band to reserve and no scroll region to scroll inside. That is the
+ * honest price of one copy of the tree at every width, and the measurement behind
+ * it is stated once on the Page above rather than repeated here.
+ *
  * `unnamed` is carried on the `<nav>` rather than logged, for the reason
  * `unnamedIn` gives.
  */
 function Rail({ label, entries, currentHref, unnamed, }) {
-    return (_jsxs("div", { className: "relative lg:sticky lg:top-20", children: [_jsx("nav", { "aria-label": label, "data-unnamed-entries": unnamed, className: "lg:max-h-[calc(100svh-7rem)] lg:overflow-y-auto lg:pe-4 lg:pb-8", children: _jsx(NavList, { entries: entries, currentHref: currentHref, depth: 0 }) }), _jsx("div", { "aria-hidden": "true", "data-slot": "docs-rail-fade", className: "from-background pointer-events-none absolute inset-x-0 bottom-0 h-8 bg-gradient-to-t to-transparent" })] }));
-}
-/**
- * One tree behind a native disclosure, for the widths where there is no rail.
- *
- * `<details>` rather than a Component, and the whole argument is that it needs no
- * runtime: the platform holds the expanded state, the control is in the Tab order
- * with a real expanded state, and the Page stays a server Component. A Page that
- * shipped a client disclosure for this would put JavaScript on every documentation
- * page in the family to replace a browser feature that has been in the platform
- * since 2018.
- *
- * **The summary's word is the caller's.** `navLabel` and `tocLabel` are already
- * required props and already name these two navigations for a screen reader, so
- * the control that opens one says the same thing the region inside it is called
- * and the Page ships no word of its own. Nothing suppresses the browser's own
- * disclosure marker or its own focus ring: the marker is the cheapest honest
- * signal that the row is a disclosure, and `py-3` puts the target at 44 pixels for
- * a coarse pointer without a variant.
- */
-function Disclosure({ label, unnamed, children, }) {
-    return (_jsxs("details", { "data-slot": "docs-nav-disclosure", children: [_jsx("summary", { className: "text-foreground cursor-pointer py-3 text-sm font-medium", children: label }), _jsx("nav", { "aria-label": label, "data-unnamed-entries": unnamed, className: "pb-4", children: children })] }));
+    return (_jsxs("div", { className: "relative lg:sticky lg:top-20", children: [_jsx("nav", { "aria-label": label, "data-unnamed-entries": unnamed, className: "lg:max-h-[calc(100svh-7rem)] lg:overflow-y-auto lg:pe-4 lg:pb-8", children: _jsx(NavList, { entries: entries, currentHref: currentHref, depth: 0 }) }), _jsx("div", { "aria-hidden": "true", "data-slot": "docs-rail-fade", className: "pointer-events-none lg:absolute lg:inset-x-0 lg:bottom-0 lg:h-8 lg:bg-gradient-to-t lg:from-background lg:to-transparent" })] }));
 }
 /* ------------------------------------------------------------------ *
  * The tree