@nanisoft/prism-ui 0.5.1 → 0.6.0

package/dist/blocks/cta-01/cta.d.ts

@@ -1,12 +1,67 @@
+import type { ReactNode } from 'react';
 import { type HeadingLevel } from '../../components/ui/section';
+/**
+ * One closing action.
+ *
+ * The destination is required rather than optional, and that is the whole point
+ * of the type: `href` was already declared and never rendered, so the type said
+ * the control could navigate while the markup produced a `<button>` with no
+ * handler. An action with no handler navigates nothing, so there is no arm of
+ * this union that omits the destination and no optional one either. A caller
+ * whose control is not a link at all uses `Cta01`'s `actionSlot`.
+ */
+export type Cta01Action = {
+    label: string;
+    /** Where the action goes. Rendered as a native anchor's `href`. */
+    href: string;
+    /**
+     * Opens the destination in a new browsing context, which defaults the link
+     * relationship to `noopener noreferrer`. Declared rather than inferred: Prism
+     * does not parse the destination, and a cross-origin URL is not by itself a
+     * reason to open a tab.
+     */
+    newTab?: boolean;
+    variant?: 'default' | 'secondary' | 'outline';
+};
 export type Cta01Props = {
     title: string;
     description?: string;
-    action?: {
-        label: string;
-        href?: string;
-        variant?: 'default' | 'secondary' | 'outline';
-    };
+    /**
+     * The one action this band carries. Omit it for a closing statement that asks
+     * for nothing, and use `actionSlot` for a control that is not a call to
+     * action.
+     */
+    action?: Cta01Action;
+    /**
+     * A slot for a control the block does not own, such as a client router's link
+     * or a menu. This is what a call to action with no destination becomes: a slot
+     * the consumer fills, rather than a control the block renders and cannot make
+     * work.
+     */
+    actionSlot?: ReactNode;
+    /**
+     * The second action, rendered beside the first at outline weight. It is a prop
+     * rather than a second `action` array because `action` is the one this Block
+     * styles as the closing ask and a second action in the same weight is two
+     * closing asks; a reader who has to choose between two equally-weighted
+     * buttons has been given a menu where a page wanted a decision.
+     *
+     * Three of the four NaniSoft sites render two actions in their closing band
+     * and all four do, and all four wrote the pair by hand, so each one re-decided
+     * the gap, the order and the weight between them.
+     */
+    secondaryAction?: Cta01Action;
+    /**
+     * The line under the actions: the footnote, the caveat, the sentence that
+     * qualifies the ask. Three of the four sites render one, and each wrote it by
+     * hand.
+     *
+     * A `ReactNode` rather than a string because the honest line is sometimes not
+     * one sentence: three of the four carry a link inside it, and a string prop
+     * would force a caller to compose a paragraph to say "this is in development,
+     * here is where to watch it".
+     */
+    note?: ReactNode;
     /** Heading level for the headline. See `HeadingLevel`. */
     headingLevel?: HeadingLevel;
 };
@@ -17,7 +72,12 @@ export type Cta01Props = {
  * pitch ("Start with one block, keep the tokens") and a hardcoded "Browse the
  * catalog" button, both of which described the library rather than whatever
  * product installed the block.
+ *
+ * The action renders a `CtaLink`, so it is a native anchor announced as a link
+ * rather than a button announced as a command, and its destination is a required
+ * prop. The only rendered change from the button this replaces is the element and
+ * the `href` it now carries.
  */
-export declare function Cta01({ title, description, action, headingLevel }: Cta01Props): import("react").JSX.Element;
+export declare function Cta01({ title, description, action, actionSlot, secondaryAction, note, headingLevel, }: Cta01Props): import("react").JSX.Element;
 export default Cta01;
 //# sourceMappingURL=cta.d.ts.map

package/dist/blocks/cta-01/cta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cta.d.ts","sourceRoot":"","sources":["../../../src/blocks/cta-01/cta.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAExE,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAA;KAAE,CAAA;IACxF,0DAA0D;IAC1D,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAmB,EAAE,EAAE,UAAU,+BAsCpF;AAED,eAAe,KAAK,CAAA"}
+{"version":3,"file":"cta.d.ts","sourceRoot":"","sources":["../../../src/blocks/cta-01/cta.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAExE;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAA;CAC9C,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,WAAW,CAAA;IAC7B;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,WAAW,EACX,MAAM,EACN,UAAU,EACV,eAAe,EACf,IAAI,EACJ,YAAmB,GACpB,EAAE,UAAU,+BAyDZ;AAED,eAAe,KAAK,CAAA"}

package/dist/blocks/cta-01/cta.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ArrowRight } from 'lucide-react';
-import { Button } from '../../components/ui/button';
+import { CtaLink } from '../../components/ui/cta-link';
 import { Section } from '../../components/ui/section';
 /**
  * A closing call to action on a filled primary surface.
@@ -9,8 +9,13 @@ import { Section } from '../../components/ui/section';
  * pitch ("Start with one block, keep the tokens") and a hardcoded "Browse the
  * catalog" button, both of which described the library rather than whatever
  * product installed the block.
+ *
+ * The action renders a `CtaLink`, so it is a native anchor announced as a link
+ * rather than a button announced as a command, and its destination is a required
+ * prop. The only rendered change from the button this replaces is the element and
+ * the `href` it now carries.
  */
-export function Cta01({ title, description, action, headingLevel = 'h2' }) {
+export function Cta01({ title, description, action, actionSlot, secondaryAction, note, headingLevel = 'h2', }) {
     /*
      * The same mechanism `SectionHeading` uses for its own `as` prop, which this
      * block cannot borrow: its copy sits on a filled `bg-primary` surface, where
@@ -19,6 +24,6 @@ export function Cta01({ title, description, action, headingLevel = 'h2' }) {
      * rather than the heading level being the reason the markup stays hardcoded.
      */
     const Heading = headingLevel;
-    return (_jsx(Section, { className: "py-20", children: _jsxs("div", { className: "bg-primary text-primary-foreground relative overflow-hidden rounded-2xl px-8 py-16 text-center", children: [_jsx("div", { "aria-hidden": true, className: "from-primary-foreground/15 pointer-events-none absolute inset-0 bg-gradient-to-tr to-transparent" }), _jsxs("div", { className: "relative flex flex-col items-center gap-6", children: [_jsx(Heading, { className: "max-w-2xl text-3xl font-semibold tracking-tight text-balance sm:text-4xl", children: title }), description ? (_jsx("p", { className: "max-w-xl text-lg text-pretty opacity-90", children: description })) : null, action ? (_jsxs(Button, { size: "lg", variant: action.variant ?? 'secondary', className: "group", children: [action.label, _jsx(ArrowRight, { className: "motion-safe:transition-transform size-4 group-hover:translate-x-0.5" })] })) : null] })] }) }));
+    return (_jsx(Section, { className: "py-20", children: _jsxs("div", { className: "bg-primary text-primary-foreground relative overflow-hidden rounded-2xl px-8 py-16 text-center", children: [_jsx("div", { "aria-hidden": true, className: "from-primary-foreground/15 pointer-events-none absolute inset-0 bg-gradient-to-tr to-transparent" }), _jsxs("div", { className: "relative flex flex-col items-center gap-6", children: [_jsx(Heading, { className: "max-w-2xl text-3xl font-semibold tracking-tight text-balance sm:text-4xl", children: title }), description ? (_jsx("p", { className: "max-w-xl text-lg text-pretty opacity-90", children: description })) : null, action ? (_jsxs("div", { className: "flex flex-col items-center gap-3 sm:flex-row", children: [_jsxs(CtaLink, { size: "lg", variant: action.variant ?? 'secondary', href: action.href, newTab: action.newTab, className: "group", children: [action.label, _jsx(ArrowRight, { className: "motion-safe:transition-transform size-4 group-hover:translate-x-0.5" })] }), secondaryAction ? (_jsx(CtaLink, { size: "lg", variant: secondaryAction.variant ?? 'outline', href: secondaryAction.href, newTab: secondaryAction.newTab, children: secondaryAction.label })) : null] })) : actionSlot ? (actionSlot) : null, note ? (_jsx("p", { className: "max-w-2xl text-pretty text-sm opacity-80", children: note })) : null] })] }) }));
 }
 export default Cta01;

package/dist/blocks/cta-01/index.d.ts

@@ -1,2 +1,3 @@
 export { Cta01, default } from './cta';
+export type { Cta01Action, Cta01Props } from './cta';
 //# sourceMappingURL=index.d.ts.map

package/dist/blocks/cta-01/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blocks/cta-01/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blocks/cta-01/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AACtC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA"}

package/dist/blocks/feature-grid-01/feature-grid.d.ts

@@ -1,27 +1,78 @@
 import type { LucideIcon } from 'lucide-react';
 import { type HeadingLevel } from '../../components/ui/section';
-export type Feature = {
+/**
+ * One feature in an icon-bearing grid.
+ *
+ * The icon is required, not optional, because this tile is always rendered: an
+ * optional icon here would compile and then paint an empty accent tile, which is
+ * the safe-at-render condition an optional prop turns unsafe.
+ */
+export type IconFeature = {
     icon: LucideIcon;
     title: string;
     body: string;
 };
-export type FeatureGrid01Props = {
+/** One feature in a bare grid, which renders no tile and so asks for no icon. */
+export type BareFeature = {
+    title: string;
+    body: string;
+};
+/**
+ * A feature, in whichever of the two shapes the grid's `variant` admits.
+ *
+ * The requirement is expressed as a union discriminated on `variant` rather than
+ * as `icon?: LucideIcon` on one type, because only a union lets the type system
+ * see the exception. A single type cannot require an icon in one variant and not
+ * in the other: it can only be required in both, which makes the bare variant
+ * impossible, or optional in both, which makes the icon variant's empty tile
+ * possible. The discriminator is the same `variant` value the Block branches on
+ * at render, so the two cannot disagree.
+ */
+export type Feature = IconFeature | BareFeature;
+type FeatureGrid01CommonProps = {
     eyebrow?: string;
     title?: string;
     description?: string;
-    features: Feature[];
-    /** `icon` tiles read well at 2-up; `bare` leans on the type alone. */
-    variant?: 'icon' | 'bare';
+    /**
+     * Puts the feature's position in the grid on the card, zero-padded to two
+     * digits, above the title.
+     *
+     * The ordinal is rendered from the card's position rather than taken from the
+     * feature, because a list that carries its own numbers is a list whose numbers
+     * can disagree with its order after a sort, a filter or an insertion. All four
+     * NaniSoft sites render one: three of them as `01` in the mono face on every
+     * card, and the fourth on a set of pillars as well as on the grid.
+     *
+     * It is off by default. A number on a card is a claim that the set is a
+     * sequence, and a grid of features is usually a set.
+     */
+    numbered?: boolean;
     /** Heading level for the section title. See `HeadingLevel`. */
     headingLevel?: HeadingLevel;
 };
+/**
+ * The `icon` arm is the one an omitted `variant` selects, so the default and
+ * the required icon live on the same arm: a consumer who writes nothing about
+ * the variant gets the tiles and the icons they imply.
+ */
+export type FeatureGrid01Props = FeatureGrid01CommonProps & ({
+    variant?: 'icon';
+    features: IconFeature[];
+} | {
+    variant: 'bare';
+    features: BareFeature[];
+});
 /**
  * A grid of short feature blurbs.
  *
  * The feature list is a prop. It previously hardcoded the catalog's own selling
  * points under the heading "Why this catalog", so an installed block argued for
  * the library inside the consumer's product.
+ *
+ * The `icon` variant renders a tile per feature and requires an icon per feature.
+ * The `bare` variant renders no tile and requires no icon, and the type says so
+ * rather than the renderer finding out.
  */
-export declare function FeatureGrid01({ eyebrow, title, description, features, variant, headingLevel, }: FeatureGrid01Props): import("react").JSX.Element;
+export declare function FeatureGrid01(props: FeatureGrid01Props): import("react").JSX.Element;
 export default FeatureGrid01;
 //# sourceMappingURL=feature-grid.d.ts.map

package/dist/blocks/feature-grid-01/feature-grid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature-grid.d.ts","sourceRoot":"","sources":["../../../src/blocks/feature-grid-01/feature-grid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAG9C,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAExF,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,KAAK,EACL,WAAW,EACX,QAAQ,EACR,OAAgB,EAChB,YAAmB,GACpB,EAAE,kBAAkB,+BA8BpB;AAED,eAAe,aAAa,CAAA"}
+{"version":3,"file":"feature-grid.d.ts","sourceRoot":"","sources":["../../../src/blocks/feature-grid-01/feature-grid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAG9C,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAExF;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,WAAW,CAAA;AAE/C,KAAK,wBAAwB,GAAG;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,wBAAwB,GACvD,CACI;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,WAAW,EAAE,CAAA;CAAE,GAC7C;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,WAAW,EAAE,CAAA;CAAE,CAC/C,CAAA;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,+BA0CtD;AAED,eAAe,aAAa,CAAA"}

package/dist/blocks/feature-grid-01/feature-grid.js

@@ -7,8 +7,18 @@ import { Section, SectionHeading } from '../../components/ui/section';
  * The feature list is a prop. It previously hardcoded the catalog's own selling
  * points under the heading "Why this catalog", so an installed block argued for
  * the library inside the consumer's product.
+ *
+ * The `icon` variant renders a tile per feature and requires an icon per feature.
+ * The `bare` variant renders no tile and requires no icon, and the type says so
+ * rather than the renderer finding out.
  */
-export function FeatureGrid01({ eyebrow, title, description, features, variant = 'icon', headingLevel = 'h2', }) {
-    return (_jsxs(Section, { children: [title ? (_jsx(SectionHeading, { as: headingLevel, eyebrow: eyebrow, title: title, description: description, className: "mb-12" })) : null, _jsx("div", { className: "grid gap-6 sm:grid-cols-2", children: features.map((feature) => (_jsx(Card, { className: "gap-4 py-6", children: _jsxs(CardHeader, { children: [variant === 'icon' ? (_jsx("span", { className: "bg-accent text-accent-foreground mb-2 flex size-10 items-center justify-center rounded-lg", children: _jsx(feature.icon, { className: "size-5" }) })) : null, _jsx(CardTitle, { children: feature.title }), _jsx(CardDescription, { children: feature.body })] }) }, feature.title))) })] }));
+export function FeatureGrid01(props) {
+    const { eyebrow, title, description, numbered = false, headingLevel = 'h2' } = props;
+    // Read off `props` rather than destructured, so the two stay one value: taking
+    // `variant` and `features` apart is what would let the arm the type checked
+    // and the arm the renderer followed come to be two different ones.
+    const variant = props.variant ?? 'icon';
+    const { features } = props;
+    return (_jsxs(Section, { children: [title ? (_jsx(SectionHeading, { as: headingLevel, eyebrow: eyebrow, title: title, description: description, className: "mb-12" })) : null, _jsx("div", { className: "grid gap-6 sm:grid-cols-2", children: features.map((feature, index) => (_jsx(Card, { className: "gap-4 py-6", children: _jsxs(CardHeader, { children: [numbered ? (_jsx("span", { className: "text-muted-foreground font-mono text-xs", children: String(index + 1).padStart(2, '0') })) : null, variant === 'icon' && 'icon' in feature ? (_jsx("span", { className: "bg-accent text-accent-foreground mb-2 flex size-10 items-center justify-center rounded-lg", children: _jsx(feature.icon, { className: "size-5" }) })) : null, _jsx(CardTitle, { children: feature.title }), _jsx(CardDescription, { children: feature.body })] }) }, feature.title))) })] }));
 }
 export default FeatureGrid01;

package/dist/blocks/feature-grid-01/index.d.ts

@@ -1,2 +1,3 @@
 export { FeatureGrid01, default } from './feature-grid';
+export type { BareFeature, Feature, FeatureGrid01Props, IconFeature, } from './feature-grid';
 //# sourceMappingURL=index.d.ts.map

package/dist/blocks/feature-grid-01/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blocks/feature-grid-01/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blocks/feature-grid-01/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AACvD,YAAY,EACV,WAAW,EACX,OAAO,EACP,kBAAkB,EAClB,WAAW,GACZ,MAAM,gBAAgB,CAAA"}

package/dist/blocks/hero-01/hero.d.ts

@@ -15,6 +15,24 @@ export type Hero01Props = {
     title: string;
     description?: string;
     actions?: HeroAction[];
+    /**
+     * Whether the copy is centered in the band or set flush to the left edge of
+     * the container.
+     *
+     * This is the hero's own alignment and not `SectionHeading`'s, because the two
+     * are not the same decision: a left-aligned hero is nearly always the left half
+     * of a two-column band with a panel or an instrument beside it, and that column
+     * is narrower than the container, so the alignment has to be the hero's before
+     * the container can be anything. Three of the four NaniSoft sites compose a
+     * left-aligned hero, each beside a panel, and each wrote the alignment by hand
+     * because this Block was the centered form only.
+     *
+     * It has no visual effect on its own, which is the point: it aligns the copy
+     * inside whatever width it is given.
+     *
+     * @defaultValue 'center'
+     */
+    align?: 'center' | 'left';
     /**
      * Heading level for the title. Defaults to `h2` because a block is composed,
      * not a page: it installs into a consumer's layout and renders
@@ -25,6 +43,17 @@ export type Hero01Props = {
      */
     headingLevel?: HeadingLevel;
 };
-export declare function Hero01({ eyebrow, title, description, actions, headingLevel, }: Hero01Props): import("react").JSX.Element;
+/**
+ * A centered marketing hero with an optional eyebrow, a headline, a supporting
+ * line and up to two actions.
+ *
+ * The copy and the actions are props, and the Block ships none of either. It
+ * previously shipped nothing of its own here and the remaining thing worth saying
+ * is the alignment: `align` is this Block's own prop rather than a pass-through of
+ * `SectionHeading`'s, because a left-aligned hero is nearly always one column of a
+ * two-column band and that column is narrower than the container, so the alignment
+ * has to be decided before the container is anything.
+ */
+export declare function Hero01({ eyebrow, title, description, actions, align, headingLevel, }: Hero01Props): import("react").JSX.Element;
 export default Hero01;
 //# sourceMappingURL=hero.d.ts.map

package/dist/blocks/hero-01/hero.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hero.d.ts","sourceRoot":"","sources":["../../../src/blocks/hero-01/hero.tsx"],"names":[],"mappings":"AAGA,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAExF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAA;CACxD,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;IACtB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B,CAAA;AAED,wBAAgB,MAAM,CAAC,EACrB,OAAO,EACP,KAAK,EACL,WAAW,EACX,OAAY,EACZ,YAAmB,GACpB,EAAE,WAAW,+BA2Cb;AAED,eAAe,MAAM,CAAA"}
+{"version":3,"file":"hero.d.ts","sourceRoot":"","sources":["../../../src/blocks/hero-01/hero.tsx"],"names":[],"mappings":"AAGA,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAGxF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAA;CACxD,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;IACtB;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;IACzB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,EACrB,OAAO,EACP,KAAK,EACL,WAAW,EACX,OAAY,EACZ,KAAgB,EAChB,YAAmB,GACpB,EAAE,WAAW,+BAkDb;AAED,eAAe,MAAM,CAAA"}

package/dist/blocks/hero-01/hero.js

@@ -2,8 +2,20 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ArrowRight } from 'lucide-react';
 import { Button } from '../../components/ui/button';
 import { Section, SectionHeading } from '../../components/ui/section';
-export function Hero01({ eyebrow, title, description, actions = [], headingLevel = 'h2', }) {
-    return (_jsxs(Section, { className: "relative overflow-hidden", children: [_jsx("div", { "aria-hidden": true, className: "from-primary/5 pointer-events-none absolute inset-0 -z-10 bg-gradient-to-b to-transparent" }), _jsxs("div", { className: "flex flex-col items-center gap-10 text-center", children: [eyebrow ? (_jsx("span", { className: "bg-muted text-muted-foreground rounded-full px-3 py-1 text-xs font-medium", children: eyebrow })) : null, _jsx(SectionHeading, { as: headingLevel, title: title, description: description }), actions.length ? (_jsx("div", { className: "flex flex-col gap-3 sm:flex-row", children: actions.map((action, index) => (
+import { cn } from '../../lib/utils';
+/**
+ * A centered marketing hero with an optional eyebrow, a headline, a supporting
+ * line and up to two actions.
+ *
+ * The copy and the actions are props, and the Block ships none of either. It
+ * previously shipped nothing of its own here and the remaining thing worth saying
+ * is the alignment: `align` is this Block's own prop rather than a pass-through of
+ * `SectionHeading`'s, because a left-aligned hero is nearly always one column of a
+ * two-column band and that column is narrower than the container, so the alignment
+ * has to be decided before the container is anything.
+ */
+export function Hero01({ eyebrow, title, description, actions = [], align = 'center', headingLevel = 'h2', }) {
+    return (_jsxs(Section, { className: "relative overflow-hidden", children: [_jsx("div", { "aria-hidden": true, className: "from-primary/5 pointer-events-none absolute inset-0 -z-10 bg-gradient-to-b to-transparent" }), _jsxs("div", { "data-slot": "hero-01-copy", className: cn('flex flex-col gap-10', align === 'center' ? 'items-center text-center' : 'items-start text-left'), children: [eyebrow ? (_jsx("span", { className: "bg-muted text-muted-foreground rounded-full px-3 py-1 text-xs font-medium", children: eyebrow })) : null, _jsx(SectionHeading, { as: headingLevel, align: align, title: title, description: description }), actions.length ? (_jsx("div", { className: "flex flex-col gap-3 sm:flex-row", children: actions.map((action, index) => (
                         // Positional, for the same reason as `pricing-01`'s feature list:
                         // the label is display content, and two actions may share one.
                         // Safe here because the list is static and never reordered.

package/dist/blocks/index.d.ts

@@ -15,4 +15,14 @@ export { DataTable01 } from './data-table-01';
 export { SettingsPanel01 } from './settings-panel-01';
 export { AuthForm01 } from './auth-form-01';
 export { AppShell01 } from './app-shell-01';
+export { ProcessRail01 } from './process-rail-01';
+export { StatusLedger01, STATUS_TIERS } from './status-ledger-01';
+export type { StatusTier } from './status-ledger-01';
+export { ProductGrid01 } from './product-grid-01';
+export { StackGrid01 } from './stack-grid-01';
+export { LogoStrip01 } from './logo-strip-01';
+export { NoteGrid01 } from './note-grid-01';
+export { InstrumentPanel01 } from './instrument-panel-01';
+export { SiteHeader } from './site-header';
+export { SiteFooter } from './site-footer';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/blocks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/blocks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA"}

package/dist/blocks/index.js

@@ -15,3 +15,12 @@ export { DataTable01 } from './data-table-01';
 export { SettingsPanel01 } from './settings-panel-01';
 export { AuthForm01 } from './auth-form-01';
 export { AppShell01 } from './app-shell-01';
+export { ProcessRail01 } from './process-rail-01';
+export { StatusLedger01, STATUS_TIERS } from './status-ledger-01';
+export { ProductGrid01 } from './product-grid-01';
+export { StackGrid01 } from './stack-grid-01';
+export { LogoStrip01 } from './logo-strip-01';
+export { NoteGrid01 } from './note-grid-01';
+export { InstrumentPanel01 } from './instrument-panel-01';
+export { SiteHeader } from './site-header';
+export { SiteFooter } from './site-footer';

package/dist/blocks/instrument-panel-01/index.d.ts

@@ -0,0 +1,3 @@
+export { InstrumentPanel01, default } from './instrument-panel';
+export type { InstrumentPanel01Props, PanelState } from './instrument-panel';
+//# sourceMappingURL=index.d.ts.map

package/dist/blocks/instrument-panel-01/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blocks/instrument-panel-01/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC/D,YAAY,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/blocks/instrument-panel-01/index.js

@@ -0,0 +1 @@
+export { InstrumentPanel01, default } from './instrument-panel';

package/dist/blocks/instrument-panel-01/instrument-panel.d.ts

@@ -0,0 +1,114 @@
+import type { ReactNode } from 'react';
+/**
+ * The state a panel's title bar claims about what is inside it.
+ *
+ * Three, and none of them is a fifth: `neutral` says nothing, `live` says the
+ * content is updating now, and `paused` says it is not. A fourth state such as
+ * `error` or `stale` is a claim about a specific system's health, and a panel
+ * that shipped one would be making a claim about every consumer's data on their
+ * behalf.
+ */
+export type PanelState = 'neutral' | 'live' | 'paused';
+/**
+ * The props an InstrumentPanel01 takes.
+ *
+ * The content is a slot and the frame is the Block. A panel that took a prop per
+ * kind of instrument would be four panels, and an instrument - a graph, a chart,
+ * a table, a canvas, a piece of application-owned markup - is the one thing in
+ * this system that Prism cannot draw, because drawing it is the application's job
+ * and its data is the application's own.
+ */
+export type InstrumentPanel01Props = {
+    /**
+     * What the panel shows, in one phrase: "the estate, as one graph", "the loop,
+     * live". It is the panel's title and the only visible text the Block adds, so
+     * it is required.
+     */
+    label: string;
+    /**
+     * The state the title bar claims about the content. `neutral` renders a quiet
+     * dot and no words; `live` and `paused` require `stateLabel` with them, because
+     * the words are what a reader is told and the dot is only what a reader sees.
+     *
+     * @defaultValue 'neutral'
+     */
+    state?: PanelState;
+    /**
+     * The words for the state, in the product's own vocabulary. Required whenever
+     * `state` is `live` or `paused`: "live view", "paused", "snapshotting" and
+     * "verified" are four different claims about four different systems, and none
+     * of them is Prism's to choose.
+     */
+    stateLabel?: string;
+    /**
+     * A slot on the right of the title bar, for a control the panel does not own: a
+     * range selector, a pause button, a link to the full view. A slot rather than a
+     * prop, because every one of those is application state.
+     */
+    actions?: ReactNode;
+    /**
+     * The instrument. Any node the consumer composes: a graph, a chart, a table, a
+     * canvas, a placeholder in a static export. The Block draws the frame and the
+     * bar and nothing else.
+     */
+    children: ReactNode;
+    /**
+     * The line under the instrument, for what a reader needs to know before
+     * trusting it: where the data came from, how fresh it is, what is not shown.
+     */
+    footnote?: ReactNode;
+    /**
+     * A caption for the panel as a whole, published as the frame's accessible name
+     * and as no visible text. It is how a reader navigating by figure knows which
+     * figure they have landed on.
+     */
+    caption?: string;
+    /**
+     * Layout only, exactly as on every Component. Changing a Prism-owned visual
+     * property from here is prohibited.
+     */
+    className?: string;
+};
+/**
+ * A bordered instrument panel with a titled bar: the frame a live view of
+ * something is shown in, beside the copy that explains it.
+ *
+ * Three of the four NaniSoft sites compose this as the right half of their hero,
+ * and each one wrote the same four things by hand: a bordered panel, a bar across
+ * the top with a small state dot on the left, the name of the view in the middle
+ * and something on the right, the instrument below, and a footnote under it. Each
+ * also gave the panel a definite height, because an instrument whose height is
+ * whatever its content is makes the hero beside it jump while it loads.
+ *
+ * **The panel owns the frame, never the instrument.** What goes inside is
+ * whatever the consumer composed, and that is not a limitation: an instrument is
+ * the one thing in this system Prism cannot draw, because it is a view of the
+ * consumer's data and every consumer's data is a different drawing. A panel that
+ * took a prop per instrument kind would be four panels and would still not cover
+ * the fifth consumer to write their own.
+ *
+ * The state dot is `aria-hidden` and the words beside it are not. All three sites
+ * that draw a dot write the state in words next to it, and that is the rule here:
+ * a dot is a shape, and a reader who cannot see `success` has learned nothing from
+ * it. `stateLabel` is therefore required whenever the state is `live` or `paused`,
+ * and the Block throws without it rather than shipping a state a reader can only
+ * see.
+ *
+ * The bar is a `Section`-width row rather than a page-width one, because a panel
+ * is a column and a column that runs the page's width is not a column. The frame
+ * carries `shadow-sm`, the resting surface step, and no more: a panel is a card
+ * with an instrument in it, and the only element in this system that means
+ * *lifted* is the one with a border in the pack's primary hue, which this is not.
+ *
+ * The three states are `neutral`, `live` and `paused`, and there is no fourth. A
+ * state such as `error` or `stale` is a claim about a specific system's health,
+ * and a panel that shipped one would be making that claim about every consumer's
+ * data.
+ *
+ * It is a server Component. It holds no state and imports no client code, so a
+ * consumer that puts a client instrument inside it pays for the instrument and not
+ * for the frame.
+ */
+export declare function InstrumentPanel01({ label, state, stateLabel, actions, children, footnote, caption, className, }: InstrumentPanel01Props): import("react").JSX.Element;
+export default InstrumentPanel01;
+//# sourceMappingURL=instrument-panel.d.ts.map

package/dist/blocks/instrument-panel-01/instrument-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrument-panel.d.ts","sourceRoot":"","sources":["../../../src/blocks/instrument-panel-01/instrument-panel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;AAiBtD;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,UAAU,CAAA;IAClB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB;;;;OAIG;IACH,QAAQ,EAAE,SAAS,CAAA;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,KAAiB,EACjB,UAAU,EACV,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,SAAS,GACV,EAAE,sBAAsB,+BA2CxB;AAED,eAAe,iBAAiB,CAAA"}

package/dist/blocks/instrument-panel-01/instrument-panel.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '../../lib/utils';
+/**
+ * The dot each state draws.
+ *
+ * All three are `aria-hidden`, and the state is announced in words beside them
+ * rather than by the colour: a live dot is a shape a reader who cannot see
+ * `success` has not been told anything, and the three sites that draw one all
+ * write the words next to it. That is the rule this reproduces, and it is why
+ * `stateLabel` is required whenever `state` is set to anything but `neutral`.
+ */
+const STATE_DOT = {
+    neutral: 'bg-muted-foreground',
+    live: 'bg-success',
+    paused: 'bg-warning',
+};
+/**
+ * A bordered instrument panel with a titled bar: the frame a live view of
+ * something is shown in, beside the copy that explains it.
+ *
+ * Three of the four NaniSoft sites compose this as the right half of their hero,
+ * and each one wrote the same four things by hand: a bordered panel, a bar across
+ * the top with a small state dot on the left, the name of the view in the middle
+ * and something on the right, the instrument below, and a footnote under it. Each
+ * also gave the panel a definite height, because an instrument whose height is
+ * whatever its content is makes the hero beside it jump while it loads.
+ *
+ * **The panel owns the frame, never the instrument.** What goes inside is
+ * whatever the consumer composed, and that is not a limitation: an instrument is
+ * the one thing in this system Prism cannot draw, because it is a view of the
+ * consumer's data and every consumer's data is a different drawing. A panel that
+ * took a prop per instrument kind would be four panels and would still not cover
+ * the fifth consumer to write their own.
+ *
+ * The state dot is `aria-hidden` and the words beside it are not. All three sites
+ * that draw a dot write the state in words next to it, and that is the rule here:
+ * a dot is a shape, and a reader who cannot see `success` has learned nothing from
+ * it. `stateLabel` is therefore required whenever the state is `live` or `paused`,
+ * and the Block throws without it rather than shipping a state a reader can only
+ * see.
+ *
+ * The bar is a `Section`-width row rather than a page-width one, because a panel
+ * is a column and a column that runs the page's width is not a column. The frame
+ * carries `shadow-sm`, the resting surface step, and no more: a panel is a card
+ * with an instrument in it, and the only element in this system that means
+ * *lifted* is the one with a border in the pack's primary hue, which this is not.
+ *
+ * The three states are `neutral`, `live` and `paused`, and there is no fourth. A
+ * state such as `error` or `stale` is a claim about a specific system's health,
+ * and a panel that shipped one would be making that claim about every consumer's
+ * data.
+ *
+ * It is a server Component. It holds no state and imports no client code, so a
+ * consumer that puts a client instrument inside it pays for the instrument and not
+ * for the frame.
+ */
+export function InstrumentPanel01({ label, state = 'neutral', stateLabel, actions, children, footnote, caption, className, }) {
+    if (state !== 'neutral' && !stateLabel) {
+        throw new Error(`InstrumentPanel01: the panel state is '${state}' and no stateLabel was passed, so the state would ` +
+            'be a dot a reader can only see. Pass the words you mean, or use the neutral state.');
+    }
+    return (_jsxs("figure", { "data-slot": "instrument-panel", "data-state": state, "aria-label": caption, className: cn('bg-card flex w-full flex-col gap-0 rounded-xl border shadow-sm', className), children: [_jsxs("div", { "data-slot": "instrument-panel-bar", className: "border-border text-muted-foreground flex items-center gap-3 border-b px-4 py-2 text-xs", children: [_jsx("span", { "aria-hidden": true, "data-state": state, className: cn('inline-block size-2 shrink-0 rounded-full', STATE_DOT[state]) }), _jsx("span", { className: "truncate font-medium", children: label }), stateLabel ? _jsx("span", { className: "truncate", children: stateLabel }) : null, actions ? _jsx("span", { className: "ms-auto flex shrink-0 items-center gap-2", children: actions }) : null] }), _jsx("div", { "data-slot": "instrument-panel-body", className: "min-h-0 flex-1 px-4 py-3", children: children }), footnote ? (_jsx("figcaption", { "data-slot": "instrument-panel-footnote", className: "text-muted-foreground border-border border-t px-4 py-2 text-xs", children: footnote })) : null] }));
+}
+export default InstrumentPanel01;

package/dist/blocks/logo-strip-01/index.d.ts

@@ -0,0 +1,3 @@
+export { LogoStrip01, default } from './logo-strip';
+export type { LogoStrip01Props, LogoStripItem } from './logo-strip';
+//# sourceMappingURL=index.d.ts.map

package/dist/blocks/logo-strip-01/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blocks/logo-strip-01/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACnD,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/blocks/logo-strip-01/index.js

@@ -0,0 +1 @@
+export { LogoStrip01, default } from './logo-strip';