@nanisoft/prism-ui 0.5.1 → 0.7.0

package/dist/blocks/status-ledger-01/status-ledger.d.ts

@@ -0,0 +1,131 @@
+import { type HeadingLevel } from '../../components/ui/section';
+/**
+ * The four tiers a StatusLedger01 row can be in.
+ *
+ * Four, and the fifth is refused deliberately. All four NaniSoft sites publish a
+ * ledger of the same kind - what a product can do today, what is designed, what
+ * is planned, and what is only a direction - and between them they use eight
+ * different words for those four states: `live`, `available` and `complete` all
+ * mean the same thing; `approved`, `specified` and `designed` all mean the next
+ * one; `planned` means the one after; and `direction` means a research direction
+ * that is explicitly not a capability. Eight words for four states is four tiers
+ * with a per-product vocabulary, and the vocabulary belongs in the row's
+ * `statusLabel`, not in the type.
+ *
+ * A fifth tier would be the one that splits a state that does not need splitting -
+ * `deprecated` over `retired`, or a `live` that is not `complete`. Each such tier
+ * is a colour a reader must learn and a word a maintainer must keep true, and a
+ * ladder with more rungs than states is how a status column stops being readable.
+ * The four below are the states; the words are the caller's.
+ */
+export declare const STATUS_TIERS: readonly ["live", "designed", "planned", "direction"];
+/**
+ * One of the four tiers a StatusLedger01 row is in.
+ */
+export type StatusTier = (typeof STATUS_TIERS)[number];
+/**
+ * One row of the ledger: a thing, the state it is in, the words for that state,
+ * and an optional list of what it does.
+ *
+ * `statusLabel` is required and separate from `status` because the tier is a
+ * colour and the words are a claim. A consumer that passed the tier alone would
+ * ship four identical-looking rows to a reader who cannot see colour at all, and
+ * a consumer that passed only the words would have no tier to draw.
+ */
+export type StatusRow = {
+    /**
+     * The name of the thing: a use case, a capability, a stage, a direction. It is
+     * the anchor of the row, so it is the first thing a reader reads.
+     */
+    name: string;
+    /**
+     * Which of the four tiers the thing is in. This is what the dot is drawn from;
+     * it is not the text a reader sees. See `STATUS_TIERS`.
+     */
+    status: StatusTier;
+    /**
+     * The words for the tier, in the product's own vocabulary. Required, and
+     * deliberately not derived from `status`: a site that says "Flagship -
+     * available today" and a site that says "Live" are both describing the same
+     * tier, and neither word is Prism's to choose.
+     */
+    statusLabel: string;
+    /**
+     * The detail line under the name, when the row needs one sentence about what
+     * the thing does.
+     */
+    detail?: string;
+    /**
+     * The bullets the row lists, when the row needs more than one line. A list
+     * rather than a paragraph, because a row that lists four things and describes
+     * them in prose is a paragraph with a bullet glyph.
+     */
+    bullets?: readonly string[];
+};
+/**
+ * The props a StatusLedger01 takes.
+ *
+ * Every string is a prop and the Block ships none: no status word, no tier, no
+ * row and no bullet. A ledger that hardcoded "available" would make every
+ * consumer publish a claim about their own roadmap that they may not be able to
+ * keep.
+ */
+export type StatusLedger01Props = {
+    /** Optional label above the section title. See the No-Default-Eyebrow Rule. */
+    eyebrow?: string;
+    /** The section title. Omit it for a ledger composed under its own heading. */
+    title?: string;
+    /** One or two sentences under the title. */
+    description?: string;
+    /**
+     * The rows, in the order a reader should meet them. Order is the caller's
+     * because it is a claim about what matters first, and a ledger that sorted
+     * itself would be making that claim on the caller's behalf.
+     */
+    rows: readonly StatusRow[];
+    /**
+     * The line under the ledger, for the sentence that qualifies it: what is not
+     * here, or where to read more.
+     */
+    caption?: string;
+    /** Heading level for the section title. See `HeadingLevel`. */
+    headingLevel?: HeadingLevel;
+};
+/**
+ * A ledger of things and the state each is in: a hairline row per entry, a mark
+ * for the tier, and the words for the state beside the name.
+ *
+ * All four NaniSoft sites publish this section, and three of them publish it as a
+ * ledger of rows while the fourth publishes the same shape as a list of products;
+ * the ledger appears twice in the fourth site as well, once for use cases and
+ * once for research directions. Five ledgers across four sites, each one written
+ * by hand, each one re-deciding the same four things: which tier words to use,
+ * how the tier is drawn, whether the tier is announced, and whether the row
+ * carries a detail line or a bullet list.
+ *
+ * **The tier is four and the words are the caller's.** The `status` prop takes
+ * one of four tiers and the `statusLabel` prop takes the words. That split is the
+ * whole design: the tier is a colour, and colour is not information a reader can
+ * act on; the words are the information, and the words belong to the product. A
+ * Block that rendered the tier's own name would force one vocabulary on five
+ * products that between them already use eight, and a Block that took only the
+ * words would have nothing to draw.
+ *
+ * The mark is a ring around a fill rather than a filled dot, which is the
+ * contested shape this Block ships and the reason is a measurement: a filled
+ * pastel dot fails contrast against a light card, and a dot that fails contrast
+ * is a dot that does not exist for the reader it was meant to reassure. The ring
+ * is in the brand ink, the fill is the tier's own semantic token, and the whole
+ * mark is `aria-hidden`, so the row's `statusLabel` is the state a screen reader
+ * hears and a reader who cannot see the dot at all still gets the same fact.
+ *
+ * A row is a `li` inside an `ol`, so the ledger is a list in the document's
+ * outline rather than a grid of divs, and the detail line and the bullet list are
+ * the two shapes a row takes. A row with neither is a name and a state and is a
+ * valid row: most ledgers are mostly those.
+ *
+ * It is a server Component: no hook, no state, no client code and no router.
+ */
+export declare function StatusLedger01({ eyebrow, title, description, rows, caption, headingLevel, }: StatusLedger01Props): import("react").JSX.Element;
+export default StatusLedger01;
+//# sourceMappingURL=status-ledger.d.ts.map

package/dist/blocks/status-ledger-01/status-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-ledger.d.ts","sourceRoot":"","sources":["../../../src/blocks/status-ledger-01/status-ledger.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAGxF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,YAAY,uDAAwD,CAAA;AAEjF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAqBtD;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,MAAM,EAAE,UAAU,CAAA;IAClB;;;;;OAKG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC5B,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,IAAI,EAAE,SAAS,SAAS,EAAE,CAAA;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,KAAK,EACL,WAAW,EACX,IAAI,EACJ,OAAO,EACP,YAAmB,GACpB,EAAE,mBAAmB,+BAsDrB;AAED,eAAe,cAAc,CAAA"}

package/dist/blocks/status-ledger-01/status-ledger.js

@@ -0,0 +1,80 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Section, SectionHeading } from '../../components/ui/section';
+import { cn } from '../../lib/utils';
+/**
+ * The four tiers a StatusLedger01 row can be in.
+ *
+ * Four, and the fifth is refused deliberately. All four NaniSoft sites publish a
+ * ledger of the same kind - what a product can do today, what is designed, what
+ * is planned, and what is only a direction - and between them they use eight
+ * different words for those four states: `live`, `available` and `complete` all
+ * mean the same thing; `approved`, `specified` and `designed` all mean the next
+ * one; `planned` means the one after; and `direction` means a research direction
+ * that is explicitly not a capability. Eight words for four states is four tiers
+ * with a per-product vocabulary, and the vocabulary belongs in the row's
+ * `statusLabel`, not in the type.
+ *
+ * A fifth tier would be the one that splits a state that does not need splitting -
+ * `deprecated` over `retired`, or a `live` that is not `complete`. Each such tier
+ * is a colour a reader must learn and a word a maintainer must keep true, and a
+ * ladder with more rungs than states is how a status column stops being readable.
+ * The four below are the states; the words are the caller's.
+ */
+export const STATUS_TIERS = ['live', 'designed', 'planned', 'direction'];
+/**
+ * The dot each tier draws, and the ring around it.
+ *
+ * The dot is `aria-hidden` and the row's words carry the state, so a tier is
+ * never colour alone: a reader who cannot separate success from warning still
+ * reads the label. The ring is `border-brand-ink` rather than `border-border`
+ * because the mark is a signal, and a signal that reads as a hairline on a card
+ * is not a signal. This is the mark the four sites draw by hand, and the reason
+ * it is a ring around a fill rather than a filled dot is a measurement: a filled
+ * pastel dot fails contrast against a light card, while a hairline ring in the
+ * brand ink does not.
+ */
+const TIER_DOT = {
+    live: 'bg-success border-success',
+    designed: 'bg-warning border-warning',
+    planned: 'border-muted-foreground',
+    direction: 'border-border',
+};
+/**
+ * A ledger of things and the state each is in: a hairline row per entry, a mark
+ * for the tier, and the words for the state beside the name.
+ *
+ * All four NaniSoft sites publish this section, and three of them publish it as a
+ * ledger of rows while the fourth publishes the same shape as a list of products;
+ * the ledger appears twice in the fourth site as well, once for use cases and
+ * once for research directions. Five ledgers across four sites, each one written
+ * by hand, each one re-deciding the same four things: which tier words to use,
+ * how the tier is drawn, whether the tier is announced, and whether the row
+ * carries a detail line or a bullet list.
+ *
+ * **The tier is four and the words are the caller's.** The `status` prop takes
+ * one of four tiers and the `statusLabel` prop takes the words. That split is the
+ * whole design: the tier is a colour, and colour is not information a reader can
+ * act on; the words are the information, and the words belong to the product. A
+ * Block that rendered the tier's own name would force one vocabulary on five
+ * products that between them already use eight, and a Block that took only the
+ * words would have nothing to draw.
+ *
+ * The mark is a ring around a fill rather than a filled dot, which is the
+ * contested shape this Block ships and the reason is a measurement: a filled
+ * pastel dot fails contrast against a light card, and a dot that fails contrast
+ * is a dot that does not exist for the reader it was meant to reassure. The ring
+ * is in the brand ink, the fill is the tier's own semantic token, and the whole
+ * mark is `aria-hidden`, so the row's `statusLabel` is the state a screen reader
+ * hears and a reader who cannot see the dot at all still gets the same fact.
+ *
+ * A row is a `li` inside an `ol`, so the ledger is a list in the document's
+ * outline rather than a grid of divs, and the detail line and the bullet list are
+ * the two shapes a row takes. A row with neither is a name and a state and is a
+ * valid row: most ledgers are mostly those.
+ *
+ * It is a server Component: no hook, no state, no client code and no router.
+ */
+export function StatusLedger01({ eyebrow, title, description, rows, caption, headingLevel = 'h2', }) {
+    return (_jsxs(Section, { children: [title ? (_jsx(SectionHeading, { as: headingLevel, align: "left", eyebrow: eyebrow, title: title, description: description, className: "mb-12" })) : null, _jsx("ol", { "data-slot": "status-ledger", className: "flex flex-col", children: rows.map((row) => (_jsxs("li", { "data-slot": "status-ledger-row", "data-status": row.status, className: "border-border flex flex-col gap-2 border-b py-5 first:border-t sm:flex-row sm:items-baseline sm:gap-6", children: [_jsxs("div", { className: "flex shrink-0 items-center gap-3 sm:w-64", children: [_jsx("span", { "aria-hidden": true, "data-tier": row.status, className: cn('border-brand-ink inline-block size-3 shrink-0 rounded-full border', TIER_DOT[row.status]) }), _jsx("span", { className: "text-sm font-semibold", children: row.name })] }), _jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-2", children: [_jsx("span", { className: "text-muted-foreground font-mono text-xs", children: row.statusLabel }), row.detail ? (_jsx("span", { className: "text-muted-foreground text-pretty text-sm", children: row.detail })) : null, row.bullets && row.bullets.length > 0 ? (_jsx("ul", { className: "text-muted-foreground mt-1 flex list-disc flex-col gap-1 pl-5 text-sm", children: row.bullets.map((bullet) => (_jsx("li", { children: bullet }, bullet))) })) : null] })] }, row.name))) }), caption ? _jsx("p", { className: "text-muted-foreground mt-6 text-pretty text-sm", children: caption }) : null] }));
+}
+export default StatusLedger01;

package/dist/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,aAAa,yCAA0C,CAAA;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD,eAAO,MAAM,oBAAoB,sHAQvB,CAAA;AACV,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAErE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,WAAW,CAAA;IACjB,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,QAAQ,GAAG,YAAY,CAAA;CAChC;AAED,eAAO,MAAM,OAAO,EAAE,SAAS,WAAW,EAiezC,CAAA;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,KAAK,GAAE,SAAS,WAAW,EAAY,GAAG,WAAW,EAAE,CAEnF;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAE1D,CAAA"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,aAAa,yCAA0C,CAAA;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD,eAAO,MAAM,oBAAoB,sHAQvB,CAAA;AACV,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAErE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,WAAW,CAAA;IACjB,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,QAAQ,GAAG,YAAY,CAAA;CAChC;AAED,eAAO,MAAM,OAAO,EAAE,SAAS,WAAW,EAqqBzC,CAAA;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,KAAK,GAAE,SAAS,WAAW,EAAY,GAAG,WAAW,EAAE,CAEnF;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAE1D,CAAA"}

package/dist/catalog.js

@@ -28,6 +28,16 @@ export const catalog = [
         exports: ['Button'],
         status: 'stable',
     },
+    {
+        name: 'CtaLink',
+        slug: 'cta-link',
+        kind: 'component',
+        category: 'Call to action',
+        description: 'The call to action that goes somewhere: a native link carrying the weight of a button.',
+        source: 'src/components/ui/cta-link.tsx',
+        exports: ['CtaLink'],
+        status: 'stable',
+    },
     {
         name: 'Badge',
         slug: 'badge',
@@ -192,6 +202,56 @@ export const catalog = [
         exports: ['Kbd'],
         status: 'stable',
     },
+    {
+        name: 'Diagram',
+        slug: 'diagram',
+        kind: 'component',
+        category: 'Data display',
+        description: 'Named things and the labelled relations between them, drawn as inline vector markup whose every stroke and fill is a token.',
+        source: 'src/components/ui/diagram.tsx',
+        exports: ['Diagram'],
+        status: 'stable',
+    },
+    {
+        name: 'ProductMark',
+        slug: 'product-mark',
+        kind: 'component',
+        category: 'Data display',
+        description: "A product's two-part colour mark: a brand-ink ring around the pack's own fill, beside the product's name in the brand ink.",
+        source: 'src/components/ui/product-mark.tsx',
+        exports: ['ProductMark'],
+        status: 'stable',
+    },
+    {
+        name: 'Prose',
+        slug: 'prose',
+        kind: 'component',
+        category: 'Typography',
+        description: 'Consumer-authored body copy held to the reading measure and to the block rhythm, so a document does not restate either.',
+        source: 'src/components/ui/prose.tsx',
+        exports: ['Prose'],
+        status: 'stable',
+    },
+    {
+        name: 'FactList',
+        slug: 'fact-list',
+        kind: 'component',
+        category: 'Data display',
+        description: 'A short list of named facts as a definition list, where a value may be a link and the term column stays aligned down its length.',
+        source: 'src/components/ui/fact-list.tsx',
+        exports: ['FactList'],
+        status: 'stable',
+    },
+    {
+        name: 'ProductSwitcher',
+        slug: 'product-switcher',
+        kind: 'component',
+        category: 'Layout',
+        description: 'A switch between the members of a set of products, each drawn with its own ProductMark and the current one marked aria-current.',
+        source: 'src/components/ui/product-switcher.tsx',
+        exports: ['ProductSwitcher'],
+        status: 'stable',
+    },
     {
         name: 'Select',
         slug: 'select',
@@ -454,6 +514,96 @@ export const catalog = [
         exports: ['AppShell01'],
         status: 'stable',
     },
+    {
+        name: 'ProcessRail01',
+        slug: 'process-rail-01',
+        kind: 'block',
+        category: null,
+        description: 'A process drawn as a rail: two, three or four steps on one line, each with an ordinal, a name and one caption.',
+        source: 'src/blocks/process-rail-01/index.tsx',
+        exports: ['ProcessRail01'],
+        status: 'stable',
+    },
+    {
+        name: 'StatusLedger01',
+        slug: 'status-ledger-01',
+        kind: 'block',
+        category: null,
+        description: 'A ledger of things and the state each is in: a name, one of four status tiers and the words for that tier.',
+        source: 'src/blocks/status-ledger-01/index.tsx',
+        exports: ['StatusLedger01'],
+        status: 'stable',
+    },
+    {
+        name: 'ProductGrid01',
+        slug: 'product-grid-01',
+        kind: 'block',
+        category: null,
+        description: 'A set of products as hairline rows: a two-part ProductMark, a name, one tagline and a destination per row.',
+        source: 'src/blocks/product-grid-01/index.tsx',
+        exports: ['ProductGrid01'],
+        status: 'stable',
+    },
+    {
+        name: 'StackGrid01',
+        slug: 'stack-grid-01',
+        kind: 'block',
+        category: null,
+        description: 'A survey of what a product is assembled from, and a second grid of what it built itself.',
+        source: 'src/blocks/stack-grid-01/index.tsx',
+        exports: ['StackGrid01'],
+        status: 'stable',
+    },
+    {
+        name: 'LogoStrip01',
+        slug: 'logo-strip-01',
+        kind: 'block',
+        category: null,
+        description: 'A single line of short phrases: the transition band between a hero and the section that follows it.',
+        source: 'src/blocks/logo-strip-01/index.tsx',
+        exports: ['LogoStrip01'],
+        status: 'stable',
+    },
+    {
+        name: 'NoteGrid01',
+        slug: 'note-grid-01',
+        kind: 'block',
+        category: null,
+        description: 'A grid of short points: a title and a sentence or two, with no tile and no icon.',
+        source: 'src/blocks/note-grid-01/index.tsx',
+        exports: ['NoteGrid01'],
+        status: 'stable',
+    },
+    {
+        name: 'InstrumentPanel01',
+        slug: 'instrument-panel-01',
+        kind: 'block',
+        category: null,
+        description: 'A bordered panel with a titled bar, a state dot with the words beside it, and a slot for the instrument.',
+        source: 'src/blocks/instrument-panel-01/index.tsx',
+        exports: ['InstrumentPanel01'],
+        status: 'stable',
+    },
+    {
+        name: 'SiteHeader',
+        slug: 'site-header',
+        kind: 'block',
+        category: null,
+        description: 'The bar at the top of a product site: a brand lockup, an optional product switcher, the site navigation and a slot for application controls.',
+        source: 'src/blocks/site-header/index.tsx',
+        exports: ['SiteHeader'],
+        status: 'stable',
+    },
+    {
+        name: 'SiteFooter',
+        slug: 'site-footer',
+        kind: 'block',
+        category: null,
+        description: 'The block at the foot of a product site: a brand lockup, grouped destinations, the links that leave the site and a slot for the legal line.',
+        source: 'src/blocks/site-footer/index.tsx',
+        exports: ['SiteFooter'],
+        status: 'stable',
+    },
     {
         name: 'MarketingPage',
         slug: 'marketing-page',
@@ -494,6 +644,36 @@ export const catalog = [
         exports: ['AuthPage'],
         status: 'stable',
     },
+    {
+        name: 'NotFoundPage',
+        slug: 'not-found-page',
+        kind: 'page',
+        category: null,
+        description: 'A complete not-found screen: the status code as the heading of the page, one sentence about what happened, and the ways out.',
+        source: 'src/pages/not-found-page/index.tsx',
+        exports: ['NotFoundPage'],
+        status: 'stable',
+    },
+    {
+        name: 'BlogPostPage',
+        slug: 'blog-post-page',
+        kind: 'page',
+        category: null,
+        description: 'A complete blog post screen: title, standfirst, byline with both the display and the machine date, the body at the measure and the trail to the neighbouring posts.',
+        source: 'src/pages/blog-post-page/index.tsx',
+        exports: ['BlogPostPage'],
+        status: 'stable',
+    },
+    {
+        name: 'DocsShell',
+        slug: 'docs-shell',
+        kind: 'page',
+        category: null,
+        description: 'A documentation screen: a navigation rail whose shape arrives as data, the document at the measure, a contents rail, and a pager derived from the navigation rather than passed.',
+        source: 'src/pages/docs-shell/index.tsx',
+        exports: ['DocsShell'],
+        status: 'stable',
+    },
 ];
 /** Returns the catalogue ordered for display and keyed for lookup. */
 export function buildCatalog(items = catalog) {

package/dist/components/index.d.ts

@@ -8,6 +8,7 @@
  * `components/card-header` subpath.
  */
 export { Button } from './ui/button';
+export { CtaLink } from './ui/cta-link';
 export { Badge } from './ui/badge';
 export { Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter, } from './ui/card';
 export { Section, SectionHeading } from './ui/section';
@@ -24,6 +25,16 @@ export { Table, TableHeader, TableBody, TableFooter, TableRow, TableHead, TableC
 export { Heading, Text } from './ui/typography';
 export type { HeadingElement } from './ui/typography';
 export { Kbd } from './ui/kbd';
+export { Diagram } from './ui/diagram';
+export type { DiagramProps, DiagramNode, DiagramRelation } from './ui/diagram';
+export { ProductMark } from './ui/product-mark';
+export type { ProductMarkProps, ProductMarkSize } from './ui/product-mark';
+export { Prose } from './ui/prose';
+export type { ProseProps, ProseSize } from './ui/prose';
+export { FactList } from './ui/fact-list';
+export type { FactListProps, Fact } from './ui/fact-list';
+export { ProductSwitcher } from './ui/product-switcher';
+export type { ProductSwitcherProps, SwitcherProduct } from './ui/product-switcher';
 export { Select, SelectTrigger, SelectValue, SelectContent, SelectItem, SelectGroup, SelectLabel, SelectSeparator, } from './ui/select';
 export type { SelectProps, SelectTriggerProps, SelectValueProps } from './ui/select';
 export { Checkbox } from './ui/checkbox';

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

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

package/dist/components/index.js

@@ -8,6 +8,7 @@
  * `components/card-header` subpath.
  */
 export { Button } from './ui/button';
+export { CtaLink } from './ui/cta-link';
 export { Badge } from './ui/badge';
 export { Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter, } from './ui/card';
 export { Section, SectionHeading } from './ui/section';
@@ -22,6 +23,11 @@ export { Separator } from './ui/separator';
 export { Table, TableHeader, TableBody, TableFooter, TableRow, TableHead, TableCell, TableCaption, } from './ui/table';
 export { Heading, Text } from './ui/typography';
 export { Kbd } from './ui/kbd';
+export { Diagram } from './ui/diagram';
+export { ProductMark } from './ui/product-mark';
+export { Prose } from './ui/prose';
+export { FactList } from './ui/fact-list';
+export { ProductSwitcher } from './ui/product-switcher';
 export { Select, SelectTrigger, SelectValue, SelectContent, SelectItem, SelectGroup, SelectLabel, SelectSeparator, } from './ui/select';
 export { Checkbox } from './ui/checkbox';
 export { RadioGroup, RadioGroupItem } from './ui/radio-group';

package/dist/components/ui/card.d.ts

@@ -7,10 +7,35 @@ import type { ComponentProps } from 'react';
  * subpaths.
  */
 declare function Card({ className, ...props }: ComponentProps<'div'>): import("react").JSX.Element;
+/**
+ * The head of a card: the row above the card's content.
+ *
+ * A part rather than an Item, and it stays inside this module: `CardHeader` is not
+ * a second catalogue entry, and DESIGN.md's authoring contract says compound parts
+ * ship from their parent module and do not form a second vocabulary.
+ */
 declare function CardHeader({ className, ...props }: ComponentProps<'div'>): import("react").JSX.Element;
+/**
+ * The card's title: the one line that names the group of related content.
+ *
+ * Renders a `div` rather than a heading, because a card's title is not always the
+ * heading of the region it sits in: four cards in a grid are four titles under one
+ * section heading, and four `h3`s under one `h2` is right while four `h2`s is
+ * four sections. Pass Prism's `Heading` inside it when the card is the only thing
+ * in its region and the outline should say so.
+ */
 declare function CardTitle({ className, ...props }: ComponentProps<'div'>): import("react").JSX.Element;
+/**
+ * The supporting line under a card's title: one sentence about what the card
+ * holds.
+ */
 declare function CardDescription({ className, ...props }: ComponentProps<'div'>): import("react").JSX.Element;
+/** The card's body: the content the title and description introduce. */
 declare function CardContent({ className, ...props }: ComponentProps<'div'>): import("react").JSX.Element;
+/**
+ * The foot of a card: the actions that belong to the card rather than to the
+ * page.
+ */
 declare function CardFooter({ className, ...props }: ComponentProps<'div'>): import("react").JSX.Element;
 export { Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter };
 //# sourceMappingURL=card.d.ts.map

package/dist/components/ui/card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../../src/components/ui/card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAI3C;;;;;;GAMG;AACH,iBAAS,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,+BAW3D;AAED,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,+BAWjE;AAED,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,+BAQhE;AAED,iBAAS,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,+BAQtE;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,+BAElE;AAED,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,+BAQjE;AAED,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,CAAA"}
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../../src/components/ui/card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAI3C;;;;;;GAMG;AACH,iBAAS,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,+BAW3D;AAED;;;;;;GAMG;AACH,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,+BAWjE;AAED;;;;;;;;GAQG;AACH,iBAAS,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,+BAQhE;AAED;;;GAGG;AACH,iBAAS,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,+BAQtE;AAED,wEAAwE;AACxE,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,+BAElE;AAED;;;GAGG;AACH,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,+BAQjE;AAED,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,CAAA"}

package/dist/components/ui/card.js

@@ -10,18 +10,43 @@ import { cn } from '../../lib/utils';
 function Card({ className, ...props }) {
     return (_jsx("div", { "data-slot": "card", className: cn('bg-card text-card-foreground flex flex-col gap-6 rounded-xl border py-6 shadow-sm', className), ...props }));
 }
+/**
+ * The head of a card: the row above the card's content.
+ *
+ * A part rather than an Item, and it stays inside this module: `CardHeader` is not
+ * a second catalogue entry, and DESIGN.md's authoring contract says compound parts
+ * ship from their parent module and do not form a second vocabulary.
+ */
 function CardHeader({ className, ...props }) {
     return (_jsx("div", { "data-slot": "card-header", className: cn('@container/card-header grid auto-rows-min items-start gap-1.5 px-6', className), ...props }));
 }
+/**
+ * The card's title: the one line that names the group of related content.
+ *
+ * Renders a `div` rather than a heading, because a card's title is not always the
+ * heading of the region it sits in: four cards in a grid are four titles under one
+ * section heading, and four `h3`s under one `h2` is right while four `h2`s is
+ * four sections. Pass Prism's `Heading` inside it when the card is the only thing
+ * in its region and the outline should say so.
+ */
 function CardTitle({ className, ...props }) {
     return (_jsx("div", { "data-slot": "card-title", className: cn('font-semibold leading-none', className), ...props }));
 }
+/**
+ * The supporting line under a card's title: one sentence about what the card
+ * holds.
+ */
 function CardDescription({ className, ...props }) {
     return (_jsx("div", { "data-slot": "card-description", className: cn('text-muted-foreground text-sm', className), ...props }));
 }
+/** The card's body: the content the title and description introduce. */
 function CardContent({ className, ...props }) {
     return _jsx("div", { "data-slot": "card-content", className: cn('px-6', className), ...props });
 }
+/**
+ * The foot of a card: the actions that belong to the card rather than to the
+ * page.
+ */
 function CardFooter({ className, ...props }) {
     return (_jsx("div", { "data-slot": "card-footer", className: cn('flex items-center px-6', className), ...props }));
 }

package/dist/components/ui/cta-link.d.ts

@@ -0,0 +1,45 @@
+import { type VariantProps } from 'class-variance-authority';
+import type { ComponentProps } from 'react';
+declare const ctaLinkVariants: (props?: ({
+    variant?: "default" | "outline" | "secondary" | "ghost" | null | undefined;
+    size?: "default" | "sm" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type CtaLinkProps = Omit<ComponentProps<'a'>, 'href' | 'target'> & VariantProps<typeof ctaLinkVariants> & {
+    /**
+     * The destination. Required, because an anchor without one is not a link: a
+     * screen reader announces no destination, the middle-click and open-in-new-tab
+     * affordances go quiet, and the control is a button that cannot act.
+     */
+    href: string;
+    /**
+     * Opens the destination in a new browsing context. This is the only way to
+     * ask for one: `target` is not accepted, so the safe relationship below
+     * cannot be opted out of by accident.
+     *
+     * Prism does not decide what counts as external. A destination on another
+     * origin is not automatically a new tab, and a destination on this origin is
+     * not automatically the same tab, so the caller declares it.
+     */
+    newTab?: boolean;
+};
+/**
+ * The call to action that goes somewhere.
+ *
+ * Renders a native `<a>`, so assistive technology announces a link and the
+ * browser's own link affordances all work: a status bar showing the destination,
+ * a context menu to copy it, middle-click to open a new tab. `Button` cannot
+ * offer any of that, and a call to action that is a button is announced as a
+ * command that does nothing.
+ *
+ * It is a Component in its own right rather than a mode of `Button`, which is the
+ * answer `BreadcrumbLink` and `PaginationLink` already give twice in this
+ * package. The two carry the same visual weight as the button they replace, so
+ * the only difference on screen is that this one has a destination.
+ *
+ * When `newTab` is set, `rel` defaults to `noopener noreferrer`, so the opened
+ * document cannot reach back through `window.opener` or read the referrer. A
+ * consumer that needs a different relationship passes `rel` and it wins.
+ */
+declare function CtaLink({ className, variant, size, href, newTab, rel, ...props }: CtaLinkProps): import("react").JSX.Element;
+export { CtaLink };
+//# sourceMappingURL=cta-link.d.ts.map

package/dist/components/ui/cta-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cta-link.d.ts","sourceRoot":"","sources":["../../../src/components/ui/cta-link.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AA0B3C,QAAA,MAAM,eAAe;;;8EAsCpB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,GACrE,YAAY,CAAC,OAAO,eAAe,CAAC,GAAG;IACrC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,iBAAS,OAAO,CAAC,EACf,SAAS,EACT,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,MAAc,EACd,GAAG,EACH,GAAG,KAAK,EACT,EAAE,YAAY,+BAWd;AAED,OAAO,EAAE,OAAO,EAAE,CAAA"}