@nanisoft/prism-ui 0.16.0 → 1.0.0

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;
   }
@@ -3324,12 +3346,21 @@
     }
   }
   @media (width >= 64rem) {
+    .lg\:absolute {
+      position: absolute;
+    }
     .lg\:sticky {
       position: sticky;
     }
+    .lg\:inset-x-0 {
+      inset-inline: var(--spacing-0);
+    }
     .lg\:top-20 {
       top: var(--spacing-20);
     }
+    .lg\:bottom-0 {
+      bottom: var(--spacing-0);
+    }
     .lg\:order-1 {
       order: 1;
     }
@@ -3372,6 +3403,9 @@
     .lg\:hidden {
       display: none;
     }
+    .lg\:h-8 {
+      height: var(--spacing-8);
+    }
     .lg\:max-h-\[calc\(100svh-7rem\)\] {
       max-height: calc(100svh - 7rem);
     }
@@ -3461,6 +3495,18 @@
       border-left-style: var(--tw-border-style);
       border-left-width: 1px;
     }
+    .lg\:bg-gradient-to-t {
+      --tw-gradient-position: to top in oklab;
+      background-image: linear-gradient(var(--tw-gradient-stops));
+    }
+    .lg\:from-background {
+      --tw-gradient-from: var(--background);
+      --tw-gradient-stops: var(--tw-gradient-via-stops, var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-to) var(--tw-gradient-to-position));
+    }
+    .lg\:to-transparent {
+      --tw-gradient-to: transparent;
+      --tw-gradient-stops: var(--tw-gradient-via-stops, var(--tw-gradient-position), var(--tw-gradient-from) var(--tw-gradient-from-position), var(--tw-gradient-to) var(--tw-gradient-to-position));
+    }
     .lg\:p-6 {
       padding: var(--spacing-6);
     }
@@ -3831,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;
   }
@@ -4576,6 +4626,11 @@
   syntax: "*";
   inherits: false;
 }
+@property --tw-divide-y-reverse {
+  syntax: "*";
+  inherits: false;
+  initial-value: 0;
+}
 @property --tw-border-style {
   syntax: "*";
   inherits: false;
@@ -4863,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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanisoft/prism-ui",
-  "version": "0.16.0",
+  "version": "1.0.0",
   "type": "module",
   "description": "Prism's React component, block and page library.",
   "license": "MIT",
@@ -64,6 +64,10 @@
       "types": "./dist/catalog.d.ts",
       "default": "./dist/catalog.js"
     },
+    "./spec": {
+      "types": "./dist/lib/spec.d.ts",
+      "default": "./dist/lib/spec.js"
+    },
     "./styles.css": "./dist/styles.css",
     "./gates": {
       "default": "./gates/index.mjs"
@@ -124,7 +128,7 @@
     "sync": "node scripts/sync-registry.mjs",
     "validate": "node scripts/validate-registry.mjs",
     "build": "node scripts/build.mjs && pnpm sync && pnpm validate && node scripts/check-catalogue.mjs && shadcn build && node scripts/check-surface.mjs && node scripts/check-focus-indicators.mjs && node scripts/check-item-docs.mjs && node scripts/check-block-copy.mjs && node scripts/check-item-category.mjs && node scripts/check-block-imports.mjs",
-    "check": "node scripts/validate-registry.mjs && node scripts/check-catalogue.mjs && node scripts/check-surface.mjs && node scripts/check-focus-indicators.mjs && node scripts/check-breakpoint-variants.mjs && node scripts/check-container-namespace.mjs && node scripts/check-pack-boundary.mjs && node scripts/check-vector-ink.mjs && node scripts/check-client-budget.mjs && node scripts/check-theme-resolution.mjs && node scripts/check-boot-budget.mjs && node scripts/check-item-docs.mjs && node scripts/check-block-copy.mjs && node scripts/check-item-category.mjs && node scripts/check-block-imports.mjs && node scripts/check-gate-kit.mjs && node scripts/check-typeface.mjs && node scripts/check-variant-ink.mjs",
+    "check": "node scripts/validate-registry.mjs && node scripts/check-catalogue.mjs && node scripts/check-surface.mjs && node scripts/check-focus-indicators.mjs && node scripts/check-breakpoint-variants.mjs && node scripts/check-container-namespace.mjs && node scripts/check-pack-boundary.mjs && node scripts/check-vector-ink.mjs && node scripts/check-client-budget.mjs && node scripts/check-theme-resolution.mjs && node scripts/check-boot-budget.mjs && node scripts/check-item-docs.mjs && node scripts/check-block-copy.mjs && node scripts/check-item-category.mjs && node scripts/check-block-imports.mjs && node scripts/check-spec-unions.mjs && node scripts/check-gate-kit.mjs && node scripts/check-typeface.mjs && node scripts/check-variant-ink.mjs",
     "check:gate-kit": "node scripts/check-gate-kit.mjs",
     "check:vector-ink": "node scripts/check-vector-ink.mjs",
     "check:client-budget": "node scripts/check-client-budget.mjs",
@@ -139,6 +143,7 @@
     "check:block-copy": "node scripts/check-block-copy.mjs",
     "check:item-category": "node scripts/check-item-category.mjs",
     "check:block-imports": "node scripts/check-block-imports.mjs",
+    "check:spec-unions": "node scripts/check-spec-unions.mjs",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
     "check:typeface": "node scripts/check-typeface.mjs",