@nanisoft/prism-ui 0.16.1 → 1.1.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/document-page/document-page.d.ts

@@ -0,0 +1,146 @@
+import { type ComponentProps, type ReactNode } from 'react';
+import { ActivityFeed01 } from '../../blocks/activity-feed-01/index.js';
+import { Compare01 } from '../../blocks/compare-01/index.js';
+import { DataTable01 } from '../../blocks/data-table-01/index.js';
+import { MemberList01 } from '../../blocks/member-list-01/index.js';
+import { RecordDetail01 } from '../../blocks/record-detail-01/index.js';
+/**
+ * A props type with the heading level removed, distributed over a union.
+ *
+ * `Omit` does not distribute over a union: `Omit<A | B, K>` keeps only the keys
+ * the two arms share, so `Omit<DataTable01Props, 'headingLevel'>` would drop the
+ * selection arm's own members and a caller could no longer pass `selectable`. The
+ * conditional distributes, so each arm loses only its heading level.
+ */
+type WithoutHeading<T> = T extends unknown ? Omit<T, 'headingLevel'> : never;
+/**
+ * The document read in full, plus its body.
+ *
+ * It is the props of `RecordDetail01` minus the two the Page decides for it. The
+ * `title`, `eyebrow`, `description`, `fields`, `actions` and `relations` are the
+ * record's own, unchanged, so the Page mints no document type: a document is a
+ * record, and the record detail is the Block that draws one. `headingLevel` is
+ * removed because the Page owns the document's `h1`, and `children` is replaced by
+ * `body` so the Page can hold the body to the reading measure rather than pass it
+ * through untouched.
+ */
+export type DocumentPageDocument = Omit<ComponentProps<typeof RecordDetail01>, 'headingLevel' | 'children'> & {
+    /**
+     * The document's body: the authored copy between the document's facts and its
+     * regions.
+     *
+     * The Page wraps it in `Prose`, so the measure and the block rhythm are the
+     * system's and the words are the caller's. Omit it for a document that is only
+     * its facts and its regions.
+     */
+    body?: ReactNode;
+};
+/**
+ * One region beside the document body, as the caller's own content.
+ *
+ * **The union is by arrangement and not by subject matter, and that is the whole
+ * of what keeps the Page from minting a document type.** A `version`, a `comment`
+ * and a `source` are each a product's word for its own record, and a member naming
+ * one of them on a Prism type would promise that every consumer's document holds
+ * those things. What the Page knows is which settled Block draws a region: an
+ * `activity` is `ActivityFeed01`, a `table` is `DataTable01`, `members` is
+ * `MemberList01` and `comparison` is `Compare01`. A version list and a source list
+ * are both a `table` with the caller's own columns; a comment thread is `members`
+ * or a `table`; the evidence matrix is `comparison`. So the six document variants
+ * and the research workspace are one Page under different content, exactly as the
+ * decision recorded, and the difference between them is which region the caller
+ * put in the list.
+ *
+ * `key` is the caller's stable key for the region, because a region list is an
+ * ordered list and React needs an identity per entry that survives a reorder.
+ */
+export type DocumentPageRegion = {
+    key: string;
+    block: 'activity';
+    props: WithoutHeading<ComponentProps<typeof ActivityFeed01>>;
+} | {
+    key: string;
+    block: 'table';
+    props: WithoutHeading<ComponentProps<typeof DataTable01>>;
+} | {
+    key: string;
+    block: 'members';
+    props: WithoutHeading<ComponentProps<typeof MemberList01>>;
+} | {
+    key: string;
+    block: 'comparison';
+    props: WithoutHeading<ComponentProps<typeof Compare01>>;
+};
+/**
+ * The props a DocumentPage takes.
+ *
+ * The document is one prop and the regions are another, because the document read
+ * in full is the whole of the page and the regions are what the caller opens
+ * beside its body. Every word, value, column, member and arm is the caller's: the
+ * Page ships no sentence, holds no document, fetches nothing and owns no editor,
+ * no share, no export and no permission.
+ */
+export type DocumentPageProps = {
+    /** The document read in full, with its body. The Page gives it the page's `h1`. */
+    document: DocumentPageDocument;
+    /**
+     * The regions beside the body, in the order a reader should meet them. Omit the
+     * prop for a document that is only its body, which is the deliverable case.
+     */
+    regions?: readonly DocumentPageRegion[];
+    /**
+     * Layout only, exactly as on every Component. Changing a Prism-owned visual
+     * property from here is prohibited.
+     */
+    className?: string;
+};
+/**
+ * A whole document screen: the document read in full with its body, and one or
+ * more regions beside it.
+ *
+ * **This is a Page authored beside `DocsShell`, and neither of that Page's two
+ * rules is relaxed.** `DocsShell` states that a section is a label and not a
+ * control, and that a group with no index is a label and not a route. Both are
+ * statements about a documentation site's navigation tree, where a section is a
+ * topic a reader may reach in any order. This workspace never asks that question:
+ * its status is a state of a region of one document and belongs to the Block that
+ * draws the region, and its route is the document's own contents. So the two are
+ * separate Items, no consumer of `DocsShell` is affected, and this Page owns the
+ * document's `h1` because a route renders it for a document and nothing frames it.
+ *
+ * **One Page draws all seven screens, because the difference between the six
+ * document variants and the research workspace is content rather than
+ * structure.** The record is the same thing in every one of them: an authored
+ * document with a title, a body and a set of things attached to it. What separates
+ * them is which region is open beside the body, which is the caller's content, so
+ * a version list, a comment thread, a source list, an output list and an evidence
+ * matrix are regions of one Page rather than six Items. The Page is the
+ * arrangement that places the document and one or more of those regions, and it
+ * ships none of their words.
+ *
+ * **It composes settled Items and mints no document, version, comment or source
+ * type.** The document read in full is `RecordDetail01`, and the body is `Prose`.
+ * A version list is `ActivityFeed01` or a `table` region; a comment thread is a
+ * `members` region or a `table`; a source list and an output list are `table`
+ * regions with the caller's per-row destination; the evidence comparison matrix is
+ * `Compare01` as a `comparison` region. Nothing here declares a shape named after
+ * a product's record, because a document is a record and every attached thing is
+ * the caller's own rows.
+ *
+ * **The editor, the fetch, the retention, the share, the export and the permission
+ * are the consumer's.** The Page owns no editor, so an annotation anchored to a
+ * passage, a version created, a comment resolved and a document sent are all
+ * behaviour and all the caller's. It fetches nothing, so it holds no document, no
+ * version history and no source; it owns no retention, no archive and no recovery,
+ * which are properties of the caller's store; and it owns no permission, because
+ * who may read or comment is the caller's store. Every figure, word and node is a
+ * prop.
+ *
+ * It is a client Component because the Blocks it composes hold state: a table
+ * holds its selection and a member list attaches a handler. That is a property of
+ * this composition and not of the data, and the caller still owns every row, every
+ * callback and every word.
+ */
+export declare function DocumentPage({ document, regions, className }: DocumentPageProps): import("react").JSX.Element;
+export default DocumentPage;
+//# sourceMappingURL=document-page.d.ts.map

package/dist/pages/document-page/document-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-page.d.ts","sourceRoot":"","sources":["../../../src/pages/document-page/document-page.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAErE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAK9D;;;;;;;GAOG;AACH,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,cAAc,CAAC,GAAG,KAAK,CAAA;AAE5E;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,cAAc,CAAC,OAAO,cAAc,CAAC,EACrC,cAAc,GAAG,UAAU,CAC5B,GAAG;IACF;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IACE,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,UAAU,CAAA;IACjB,KAAK,EAAE,cAAc,CAAC,cAAc,CAAC,OAAO,cAAc,CAAC,CAAC,CAAA;CAC7D,GACD;IACE,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,cAAc,CAAC,cAAc,CAAC,OAAO,WAAW,CAAC,CAAC,CAAA;CAC1D,GACD;IACE,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,cAAc,CAAC,cAAc,CAAC,OAAO,YAAY,CAAC,CAAC,CAAA;CAC3D,GACD;IACE,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,YAAY,CAAA;IACnB,KAAK,EAAE,cAAc,CAAC,cAAc,CAAC,OAAO,SAAS,CAAC,CAAC,CAAA;CACxD,CAAA;AAEL;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,mFAAmF;IACnF,QAAQ,EAAE,oBAAoB,CAAA;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;IACvC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,iBAAiB,+BA2B/E;AAED,eAAe,YAAY,CAAA"}

package/dist/pages/document-page/document-page.js

@@ -0,0 +1,80 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment } from 'react';
+import { ActivityFeed01 } from '../../blocks/activity-feed-01/index.js';
+import { Compare01 } from '../../blocks/compare-01/index.js';
+import { DataTable01 } from '../../blocks/data-table-01/index.js';
+import { MemberList01 } from '../../blocks/member-list-01/index.js';
+import { RecordDetail01 } from '../../blocks/record-detail-01/index.js';
+import { Prose } from '../../components/ui/prose.js';
+import { Section } from '../../components/ui/section.js';
+import { cn } from '../../lib/utils.js';
+/**
+ * One region, drawn by the Block its arrangement names.
+ *
+ * The heading level is set here rather than taken from the caller, so every region
+ * is a section one level under the document's `h1` and the outline cannot be
+ * flattened by a caller who passed the wrong level to a Block.
+ */
+function renderRegion(region) {
+    if (region.block === 'activity')
+        return _jsx(ActivityFeed01, { ...region.props, headingLevel: "h2" });
+    if (region.block === 'table')
+        return _jsx(DataTable01, { ...region.props, headingLevel: "h2" });
+    if (region.block === 'members')
+        return _jsx(MemberList01, { ...region.props, headingLevel: "h2" });
+    return _jsx(Compare01, { ...region.props, headingLevel: "h2" });
+}
+/**
+ * A whole document screen: the document read in full with its body, and one or
+ * more regions beside it.
+ *
+ * **This is a Page authored beside `DocsShell`, and neither of that Page's two
+ * rules is relaxed.** `DocsShell` states that a section is a label and not a
+ * control, and that a group with no index is a label and not a route. Both are
+ * statements about a documentation site's navigation tree, where a section is a
+ * topic a reader may reach in any order. This workspace never asks that question:
+ * its status is a state of a region of one document and belongs to the Block that
+ * draws the region, and its route is the document's own contents. So the two are
+ * separate Items, no consumer of `DocsShell` is affected, and this Page owns the
+ * document's `h1` because a route renders it for a document and nothing frames it.
+ *
+ * **One Page draws all seven screens, because the difference between the six
+ * document variants and the research workspace is content rather than
+ * structure.** The record is the same thing in every one of them: an authored
+ * document with a title, a body and a set of things attached to it. What separates
+ * them is which region is open beside the body, which is the caller's content, so
+ * a version list, a comment thread, a source list, an output list and an evidence
+ * matrix are regions of one Page rather than six Items. The Page is the
+ * arrangement that places the document and one or more of those regions, and it
+ * ships none of their words.
+ *
+ * **It composes settled Items and mints no document, version, comment or source
+ * type.** The document read in full is `RecordDetail01`, and the body is `Prose`.
+ * A version list is `ActivityFeed01` or a `table` region; a comment thread is a
+ * `members` region or a `table`; a source list and an output list are `table`
+ * regions with the caller's per-row destination; the evidence comparison matrix is
+ * `Compare01` as a `comparison` region. Nothing here declares a shape named after
+ * a product's record, because a document is a record and every attached thing is
+ * the caller's own rows.
+ *
+ * **The editor, the fetch, the retention, the share, the export and the permission
+ * are the consumer's.** The Page owns no editor, so an annotation anchored to a
+ * passage, a version created, a comment resolved and a document sent are all
+ * behaviour and all the caller's. It fetches nothing, so it holds no document, no
+ * version history and no source; it owns no retention, no archive and no recovery,
+ * which are properties of the caller's store; and it owns no permission, because
+ * who may read or comment is the caller's store. Every figure, word and node is a
+ * prop.
+ *
+ * It is a client Component because the Blocks it composes hold state: a table
+ * holds its selection and a member list attaches a handler. That is a property of
+ * this composition and not of the data, and the caller still owns every row, every
+ * callback and every word.
+ */
+export function DocumentPage({ document, regions, className }) {
+    const { body, ...record } = document;
+    const list = regions ?? [];
+    return (_jsx(Section, { "data-slot": "document-page", className: cn(className), children: _jsxs("article", { "data-slot": "document-page-article", className: "flex flex-col gap-12", children: [_jsx(RecordDetail01, { ...record, headingLevel: "h1", children: body === undefined ? null : _jsx(Prose, { children: body }) }), list.length === 0 ? null : (_jsx("div", { "data-slot": "document-page-regions", className: "flex flex-col gap-12", children: list.map((region) => (_jsx(Fragment, { children: renderRegion(region) }, region.key))) }))] }) }));
+}
+export default DocumentPage;

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

@@ -0,0 +1,3 @@
+export { DocumentPage, default } from './document-page.js';
+export type { DocumentPageProps, DocumentPageDocument, DocumentPageRegion, } from './document-page.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pages/document-page/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACvD,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAA"}

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

@@ -0,0 +1 @@
+export { DocumentPage, default } from './document-page.js';

package/dist/pages/index.d.ts

@@ -25,6 +25,8 @@ export { BlogPostPage } from './blog-post-page/index.js';
 export type { BlogPostPageProps, BlogPostTag, BlogPostNeighbour, BlogPostTrailLabels } from './blog-post-page/index.js';
 export { DocsShell } from './docs-shell/index.js';
 export type { DocsShellProps, DocsNavEntry, DocsNavPage, DocsNavGroup, DocsNavDivider, DocsPagerLabels, } from './docs-shell/index.js';
+export { DocumentPage } from './document-page/index.js';
+export type { DocumentPageProps, DocumentPageDocument, DocumentPageRegion, } from './document-page/index.js';
 export { AboutPage } from './about-page/index.js';
 export { CareersPage } from './careers-page/index.js';
 export { ChangelogPage } from './changelog-page/index.js';

package/dist/pages/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC9G,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,YAAY,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAA;AAOrB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC9G,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,YAAY,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAA;AAQrB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAA;AAOxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA"}

package/dist/pages/index.js

@@ -18,6 +18,12 @@ export { AuthPage } from './auth-page/index.js';
 export { NotFoundPage } from './not-found-page/index.js';
 export { BlogPostPage } from './blog-post-page/index.js';
 export { DocsShell } from './docs-shell/index.js';
+/*
+ * The document and research workspace. A Page authored beside `DocsShell`, so
+ * neither of that Page's two rules is relaxed: a section stays a label and not a
+ * control, and a group with no index stays a label and not a route. It composes
+ * settled Items and mints no document, version, comment or source type. */
+export { DocumentPage } from './document-page/index.js';
 /*
  * the ten screens the 2026-09 expansion added.
  * Derived by the maintainer rather than authored: each entry is read out of the Item own

package/dist/styles.css

@@ -428,9 +428,6 @@
   .my-1 {
     margin-block: var(--spacing-1);
   }
-  .my-6 {
-    margin-block: var(--spacing-6);
-  }
   .-ms-px {
     margin-inline-start: -1px;
   }
@@ -482,6 +479,9 @@
   .mt-auto {
     margin-top: auto;
   }
+  .mb-0 {
+    margin-bottom: var(--spacing-0);
+  }
   .mb-1 {
     margin-bottom: var(--spacing-1);
   }
@@ -1121,6 +1121,9 @@
   .grid-cols-\[minmax\(0\,1fr\)_auto\] {
     grid-template-columns: minmax(0,1fr) auto;
   }
+  .grid-cols-\[minmax\(0\,2fr\)_minmax\(0\,3fr\)\] {
+    grid-template-columns: minmax(0,2fr) minmax(0,3fr);
+  }
   .flex-col {
     flex-direction: column;
   }
@@ -1253,6 +1256,16 @@
   .gap-y-8 {
     row-gap: var(--spacing-8);
   }
+  :where(.divide-y > :not(:last-child)) {
+    --tw-divide-y-reverse: 0;
+    border-bottom-style: var(--tw-border-style);
+    border-top-style: var(--tw-border-style);
+    border-top-width: calc(1px * var(--tw-divide-y-reverse));
+    border-bottom-width: calc(1px * calc(1 - var(--tw-divide-y-reverse)));
+  }
+  :where(.divide-border > :not(:last-child)) {
+    border-color: var(--border);
+  }
   .self-center {
     align-self: center;
   }
@@ -1872,6 +1885,9 @@
   .px-8 {
     padding-inline: var(--spacing-8);
   }
+  .py-0 {
+    padding-block: var(--spacing-0);
+  }
   .py-0\.5 {
     padding-block: var(--spacing-0\.5);
   }
@@ -2004,12 +2020,18 @@
   .text-center {
     text-align: center;
   }
+  .text-end {
+    text-align: end;
+  }
   .text-left {
     text-align: left;
   }
   .text-right {
     text-align: right;
   }
+  .text-start {
+    text-align: start;
+  }
   .align-bottom {
     vertical-align: bottom;
   }
@@ -3855,6 +3877,10 @@
   .\[\&_ul\]\:pl-6 ul {
     padding-left: var(--spacing-6);
   }
+  .\[\&\+\&\]\:border-t + .\[\&\+\&\]\:border-t {
+    border-top-style: var(--tw-border-style);
+    border-top-width: 1px;
+  }
   .\[\&\:\:-webkit-search-cancel-button\]\:appearance-none::-webkit-search-cancel-button {
     appearance: none;
   }
@@ -4600,6 +4626,11 @@
   syntax: "*";
   inherits: false;
 }
+@property --tw-divide-y-reverse {
+  syntax: "*";
+  inherits: false;
+  initial-value: 0;
+}
 @property --tw-border-style {
   syntax: "*";
   inherits: false;
@@ -4887,6 +4918,7 @@
       --tw-rotate-z: initial;
       --tw-skew-x: initial;
       --tw-skew-y: initial;
+      --tw-divide-y-reverse: 0;
       --tw-border-style: solid;
       --tw-gradient-position: initial;
       --tw-gradient-from: #0000;