@nanisoft/prism-ui 0.10.2 → 0.13.0

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

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Card, CardDescription, CardHeader, CardTitle } from '../../components/ui/card';
-import { Section, SectionHeading } from '../../components/ui/section';
+import { Card, CardDescription, CardHeader, CardTitle } from '../../components/ui/card.js';
+import { Section, SectionHeading, childLevel } from '../../components/ui/section.js';
 /**
  * A grid of short feature blurbs.
  *
@@ -11,14 +11,45 @@ import { Section, SectionHeading } from '../../components/ui/section';
  * 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.
+ *
+ * **The section heading is aligned left, and that is this Block joining the other
+ * eight rather than inventing an answer.** `SectionHeading` states its own rule:
+ * `center` is right for a band that is only a heading, and `left` is right for a
+ * section with content under it, because a centred title above a left-aligned
+ * grid reads as two unrelated pieces. A grid of cards is content under its
+ * heading, so the rule says left. `NoteGrid01`, `StackGrid01`, `StatusLedger01`,
+ * `ProductGrid01`, `LogoStrip01`, `Stats01`, `ProcessRail01` and `ProcessFlow01`
+ * all pass `align="left"` for that reason, and this one did not, so it was one of
+ * only two Blocks in the package that centred a heading over content.
+ *
+ * The cost was not visible in this repository, which previews one Block at a time
+ * and so never put a centred title next to a left-aligned one. It was visible in
+ * the consumer: the Nexus landing is composed from seven of these Blocks and put
+ * two centred section titles among five left ones, and the page's own rhythm read
+ * as an accident rather than as a decision. A page's composition is the consumer's,
+ * but a Block that is the only one of its kind answering a shared question is not a
+ * composition the consumer can correct without restyling a catalogue item, which
+ * the no-override-path rule does not allow.
+ *
+ * `Hero01` is the deliberate exception and keeps its own `align`, and `Cta01` draws
+ * no section heading at all: a centred hero is a band that is only a heading, the
+ * two-column form puts its figure beside the copy rather than under it, and the
+ * closing band is a title and two actions on a filled panel with nothing underneath.
+ * `test/section-heading-align.test.tsx` holds the whole list, which is the
+ * assertion, so a Block that opens with a heading and content under it cannot be
+ * added answering this question a second way.
  */
 export function FeatureGrid01(props) {
     const { eyebrow, title, description, numbered = false, headingLevel = 'h2' } = props;
+    // A card title is a heading one step below the section that introduces the set,
+    // derived rather than written, so a Block embedded one level deeper carries its
+    // five headings with it instead of announcing five siblings of the section.
+    const Title = childLevel(headingLevel);
     // 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))) })] }));
+    return (_jsxs(Section, { children: [title ? (_jsx(SectionHeading, { as: headingLevel, align: "left", 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: _jsx(Title, { children: feature.title }) }), _jsx(CardDescription, { children: feature.body })] }) }, feature.title))) })] }));
 }
 export default FeatureGrid01;

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

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

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

@@ -1 +1 @@
-export { FeatureGrid01, default } from './feature-grid';
+export { FeatureGrid01, default } from './feature-grid.js';

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

@@ -1,24 +1,44 @@
 import type { ReactNode } from 'react';
-import { type HeadingLevel } from '../../components/ui/section';
+import { type HeadingLevel } from '../../components/ui/section.js';
+/**
+ * One action in a hero's action row.
+ *
+ * **The two arms are two elements, and a caller should not be able to reach the
+ * wrong one by accident.** An action that names a destination is an anchor and
+ * navigates; an action that does not is a button, and a Block ships no behaviour,
+ * so that button is inert by design rather than by accident. The arms are a union
+ * rather than one shape with an optional `href` because an optional `href` makes
+ * both mistakes silent:
+ *
+ * - `{ label: 'Start free' }` compiles and renders a primary button that goes
+ *   nowhere. A hero's first action is almost always a link, so this is the likely
+ *   mistake and it looks correct on the page.
+ * - `{ label: 'Start free', href: maybeUrl }` compiles today and renders a button
+ *   whenever `maybeUrl` is `undefined`, which is a runtime branch the type said
+ *   nothing about.
+ *
+ * So the link arm *requires* `href` and the button arm *forbids* it, as
+ * `href?: never`. The second of those is the one worth having: a value that is
+ * sometimes a string and sometimes `undefined` is now a type error rather than a
+ * button, which is the whole of "a caller should not be able to get it wrong
+ * silently".
+ */
 export type HeroAction = {
     label: string;
-    /**
-     * Where the action goes. Required for an action that navigates, which is what
-     * an action in a hero almost always is.
-     *
-     * It was optional here and the Component ignored it, which meant an action
-     * with a destination rendered as a `<button>` that went nowhere: a control
-     * that looks like a link and is not one, and a dead end for a reader who
-     * pressed it. An action now renders as a real anchor whenever it names a
-     * destination, and falls back to a button only when it genuinely is one. A
-     * Block ships no behaviour, so a button here is inert by design rather than by
-     * accident, and the two shapes are told apart by exactly this.
-     */
-    href?: string;
     variant?: 'default' | 'outline' | 'secondary' | 'ghost';
+} & ({
+    /** Where the action goes. Present makes the action an anchor. */
+    href: string;
     /** Opens the destination in a new tab, with the matching `rel`. */
     newTab?: boolean;
-};
+} | {
+    /**
+     * Forbidden, so that "a link whose address happens to be undefined" is a
+     * type error rather than a button. Omit the key entirely to mean a button.
+     */
+    href?: never;
+    newTab?: never;
+});
 export type Hero01Props = {
     /**
      * Optional label above the headline. Intentionally has no default: an earlier

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":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAMtC,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAGxF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAA;IACvD,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;;;;;OAUG;IACH,KAAK,EAAE,SAAS,CAAA;IAChB,wEAAwE;IACxE,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;IACtB;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;IACzB;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,MAAM,CAAC,EACrB,OAAO,EACP,KAAK,EACL,WAAW,EACX,OAAY,EACZ,KAAgB,EAChB,UAAU,EACV,KAAK,EACL,YAAmB,EACnB,SAAS,GACV,EAAE,WAAW,+BA+Fb;AAED,eAAe,MAAM,CAAA"}
+{"version":3,"file":"hero.d.ts","sourceRoot":"","sources":["../../../src/blocks/hero-01/hero.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAMtC,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAGxF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAA;CACxD,GAAG,CACA;IACE,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;IACZ,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,GACD;IACE;;;OAGG;IACH,IAAI,CAAC,EAAE,KAAK,CAAA;IACZ,MAAM,CAAC,EAAE,KAAK,CAAA;CACf,CACJ,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;;;;;OAUG;IACH,KAAK,EAAE,SAAS,CAAA;IAChB,wEAAwE;IACxE,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;IACtB;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;IACzB;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,MAAM,CAAC,EACrB,OAAO,EACP,KAAK,EACL,WAAW,EACX,OAAY,EACZ,KAAgB,EAChB,UAAU,EACV,KAAK,EACL,YAAmB,EACnB,SAAS,GACV,EAAE,WAAW,+BAoGb;AAED,eAAe,MAAM,CAAA"}

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

@@ -1,9 +1,9 @@
 import { jsx as _jsx, Fragment as _Fragment, 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, SectionHeading } from '../../components/ui/section';
-import { cn } from '../../lib/utils';
+import { Button } from '../../components/ui/button.js';
+import { CtaLink } from '../../components/ui/cta-link.js';
+import { Section, SectionHeading } from '../../components/ui/section.js';
+import { cn } from '../../lib/utils.js';
 /**
  * A marketing hero with a headline, a supporting line, up to two actions, and
  * an optional live figure beside them.
@@ -43,11 +43,16 @@ export function Hero01({ eyebrow, title, description, actions = [], align = 'cen
     const twoColumn = split ?? instrument !== undefined;
     const copy = (_jsxs("div", { "data-slot": "hero-01-copy", className: cn('flex flex-col gap-10', twoColumn ? 'items-start text-left' : 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: twoColumn ? 'left' : align, title: title, description: description }), actions.length ? (_jsx("div", { className: "flex flex-col gap-3 sm:flex-row", children: actions.map((action, index) => {
                     const variant = action.variant ?? (index === 0 ? 'default' : 'outline');
-                    // 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.
-                    const content = (_jsxs(_Fragment, { children: [action.label, index === 0 ? (_jsx(ArrowRight, { className: "motion-safe:transition-transform size-4 group-hover:translate-x-0.5" })) : null] }));
-                    return action.href ? (_jsx(CtaLink, { href: action.href, newTab: action.newTab, size: "lg", variant: variant, className: "group", children: content }, index)) : (_jsx(Button, { size: "lg", variant: variant, className: "group", children: content }, index));
+                    // The arrow is a link affordance, so it follows the element and not the
+                    // position. It was `index === 0`, which put a "goes forward" arrow on an
+                    // inert button: the one control in the row that cannot be followed wore
+                    // the mark that says it can. A first action that is genuinely a button
+                    // gets no arrow, and a second action that is a link still gets none,
+                    // because the arrow marks the row's primary destination and only one
+                    // thing is that.
+                    const isLink = action.href !== undefined;
+                    const content = (_jsxs(_Fragment, { children: [action.label, index === 0 && isLink ? (_jsx(ArrowRight, { className: "motion-safe:transition-transform size-4 group-hover:translate-x-0.5" })) : null] }));
+                    return isLink ? (_jsx(CtaLink, { href: action.href, newTab: action.newTab, size: "lg", variant: variant, className: "group", children: content }, index)) : (_jsx(Button, { size: "lg", variant: variant, className: "group", children: content }, index));
                 }) })) : null] }));
     return (_jsxs(Section, { className: cn('relative overflow-hidden', className), 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-band", className: cn(twoColumn
                     ? 'grid items-center gap-10 lg:grid-cols-[5fr_6fr] lg:gap-14'

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

@@ -1,2 +1,3 @@
-export { Hero01, default } from './hero';
+export { Hero01, default } from './hero.js';
+export type { HeroAction, Hero01Props } from './hero.js';
 //# sourceMappingURL=index.d.ts.map

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

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

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

@@ -1 +1 @@
-export { Hero01, default } from './hero';
+export { Hero01, default } from './hero.js';

package/dist/blocks/index.d.ts

@@ -5,24 +5,24 @@
  * content as props and never fetches application data (ticket 07). The `-NN`
  * suffix is the block-family variant ordinal.
  */
-export { Hero01 } from './hero-01';
-export { FeatureGrid01 } from './feature-grid-01';
-export { Stats01 } from './stats-01';
-export { Pricing01 } from './pricing-01';
-export { Cta01 } from './cta-01';
-export { PageHeader01 } from './page-header-01';
-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';
+export { Hero01 } from './hero-01/index.js';
+export { FeatureGrid01 } from './feature-grid-01/index.js';
+export { Stats01 } from './stats-01/index.js';
+export { Pricing01 } from './pricing-01/index.js';
+export { Cta01 } from './cta-01/index.js';
+export { PageHeader01 } from './page-header-01/index.js';
+export { DataTable01 } from './data-table-01/index.js';
+export { SettingsPanel01 } from './settings-panel-01/index.js';
+export { AuthForm01 } from './auth-form-01/index.js';
+export { AppShell01 } from './app-shell-01/index.js';
+export { ProcessRail01 } from './process-rail-01/index.js';
+export { StatusLedger01, STATUS_TIERS } from './status-ledger-01/index.js';
+export type { StatusTier } from './status-ledger-01/index.js';
+export { ProductGrid01 } from './product-grid-01/index.js';
+export { StackGrid01 } from './stack-grid-01/index.js';
+export { LogoStrip01 } from './logo-strip-01/index.js';
+export { NoteGrid01 } from './note-grid-01/index.js';
+export { InstrumentPanel01 } from './instrument-panel-01/index.js';
+export { SiteHeader } from './site-header/index.js';
+export { SiteFooter } from './site-footer/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/blocks/index.js

@@ -5,22 +5,22 @@
  * content as props and never fetches application data (ticket 07). The `-NN`
  * suffix is the block-family variant ordinal.
  */
-export { Hero01 } from './hero-01';
-export { FeatureGrid01 } from './feature-grid-01';
-export { Stats01 } from './stats-01';
-export { Pricing01 } from './pricing-01';
-export { Cta01 } from './cta-01';
-export { PageHeader01 } from './page-header-01';
-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';
+export { Hero01 } from './hero-01/index.js';
+export { FeatureGrid01 } from './feature-grid-01/index.js';
+export { Stats01 } from './stats-01/index.js';
+export { Pricing01 } from './pricing-01/index.js';
+export { Cta01 } from './cta-01/index.js';
+export { PageHeader01 } from './page-header-01/index.js';
+export { DataTable01 } from './data-table-01/index.js';
+export { SettingsPanel01 } from './settings-panel-01/index.js';
+export { AuthForm01 } from './auth-form-01/index.js';
+export { AppShell01 } from './app-shell-01/index.js';
+export { ProcessRail01 } from './process-rail-01/index.js';
+export { StatusLedger01, STATUS_TIERS } from './status-ledger-01/index.js';
+export { ProductGrid01 } from './product-grid-01/index.js';
+export { StackGrid01 } from './stack-grid-01/index.js';
+export { LogoStrip01 } from './logo-strip-01/index.js';
+export { NoteGrid01 } from './note-grid-01/index.js';
+export { InstrumentPanel01 } from './instrument-panel-01/index.js';
+export { SiteHeader } from './site-header/index.js';
+export { SiteFooter } from './site-footer/index.js';

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

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

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

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

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

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { cn } from '../../lib/utils';
+import { cn } from '../../lib/utils.js';
 /**
  * The dot each state draws.
  *

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

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

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

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

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

@@ -1,4 +1,4 @@
-import { type HeadingLevel } from '../../components/ui/section';
+import { type HeadingLevel } from '../../components/ui/section.js';
 /**
  * One item of the strip, as a string.
  *

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

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Section, SectionHeading } from '../../components/ui/section';
-import { cn } from '../../lib/utils';
+import { Section, SectionHeading } from '../../components/ui/section.js';
+import { cn } from '../../lib/utils.js';
 /**
  * A single line of short items: the transition band between a hero and the
  * section that follows it.

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

@@ -1,3 +1,3 @@
-export { NoteGrid01, default } from './note-grid';
-export type { NoteGrid01Props, NoteGrid01Note } from './note-grid';
+export { NoteGrid01, default } from './note-grid.js';
+export type { NoteGrid01Props, NoteGrid01Note } from './note-grid.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/blocks/note-grid-01/index.js

@@ -1 +1 @@
-export { NoteGrid01, default } from './note-grid';
+export { NoteGrid01, default } from './note-grid.js';

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

@@ -1,4 +1,4 @@
-import { type HeadingLevel } from '../../components/ui/section';
+import { type HeadingLevel } from '../../components/ui/section.js';
 /**
  * One note in the grid: a title and one or two sentences under it.
  *

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

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Section, SectionHeading } from '../../components/ui/section';
+import { Section, SectionHeading } from '../../components/ui/section.js';
 /**
  * A grid of short points: a title and a sentence or two, on a hairline above each
  * one, with no tile and no icon.

package/dist/blocks/page-header-01/index.d.ts

@@ -1,3 +1,3 @@
-export { PageHeader01, default } from './page-header';
-export type { PageHeader01Props, PageHeaderAction, PageHeaderCrumb } from './page-header';
+export { PageHeader01, default } from './page-header.js';
+export type { PageHeader01Props, PageHeaderAction, PageHeaderCrumb } from './page-header.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/blocks/page-header-01/index.js

@@ -1 +1 @@
-export { PageHeader01, default } from './page-header';
+export { PageHeader01, default } from './page-header.js';

package/dist/blocks/page-header-01/page-header.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from 'react';
-import { type HeadingElement } from '../../components/ui/typography';
+import { type HeadingElement } from '../../components/ui/typography.js';
 export type PageHeaderCrumb = {
     label: ReactNode;
     /** Renders a native anchor. Omit on the current, final step. */

package/dist/blocks/page-header-01/page-header.js

@@ -1,9 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Fragment } from 'react';
-import { Breadcrumb, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, } from '../../components/ui/breadcrumb';
-import { Button } from '../../components/ui/button';
-import { Separator } from '../../components/ui/separator';
-import { Heading, Text } from '../../components/ui/typography';
+import { Breadcrumb, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, } from '../../components/ui/breadcrumb.js';
+import { Button } from '../../components/ui/button.js';
+import { Separator } from '../../components/ui/separator.js';
+import { Heading, Text } from '../../components/ui/typography.js';
 /**
  * A page title band.
  *

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

@@ -1,2 +1,2 @@
-export { Pricing01, default } from './pricing';
+export { Pricing01, default } from './pricing.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/blocks/pricing-01/index.js

@@ -1 +1 @@
-export { Pricing01, default } from './pricing';
+export { Pricing01, default } from './pricing.js';

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

@@ -1,4 +1,4 @@
-import { type HeadingLevel } from '../../components/ui/section';
+import { type HeadingLevel } from '../../components/ui/section.js';
 export type Plan = {
     name: string;
     price: string;
@@ -29,6 +29,13 @@ export type Pricing01Props = {
  * plan". A shared library has no plans to sell, so those strings described a
  * business that does not exist here, and every consumer who installed the block
  * inherited them.
+ *
+ * The section heading is aligned left, for the reason `FeatureGrid01` now records
+ * in full and `test/section-heading-align.test.tsx` holds: three cards sit under
+ * it, and a centred title above a left-aligned grid reads as two unrelated pieces.
+ * `Pricing01` and `FeatureGrid01` were the only two Blocks that left the heading
+ * centred over content, and neither had a stated reason for it, so both were
+ * taking the default rather than making a decision.
  */
 export declare function Pricing01({ eyebrow, title, description, plans, headingLevel, }: Pricing01Props): import("react").JSX.Element;
 export default Pricing01;

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

@@ -1 +1 @@
-{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../../src/blocks/pricing-01/pricing.tsx"],"names":[],"mappings":"AAYA,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAExF,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,+DAA+D;IAC/D,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,EACxB,OAAO,EACP,KAAK,EACL,WAAW,EACX,KAAK,EACL,YAAmB,GACpB,EAAE,cAAc,+BAkEhB;AAED,eAAe,SAAS,CAAA"}
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../../src/blocks/pricing-01/pricing.tsx"],"names":[],"mappings":"AAYA,OAAO,EAAuC,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAEpG,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,+DAA+D;IAC/D,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,EACxB,OAAO,EACP,KAAK,EACL,WAAW,EACX,KAAK,EACL,YAAmB,GACpB,EAAE,cAAc,+BAwEhB;AAED,eAAe,SAAS,CAAA"}

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

@@ -1,9 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Check } from 'lucide-react';
-import { Badge } from '../../components/ui/badge';
-import { Button } from '../../components/ui/button';
-import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, } from '../../components/ui/card';
-import { Section, SectionHeading } from '../../components/ui/section';
+import { Badge } from '../../components/ui/badge.js';
+import { Button } from '../../components/ui/button.js';
+import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, } from '../../components/ui/card.js';
+import { Section, SectionHeading, childLevel } from '../../components/ui/section.js';
 /**
  * A three-up plan comparison.
  *
@@ -13,8 +13,18 @@ import { Section, SectionHeading } from '../../components/ui/section';
  * plan". A shared library has no plans to sell, so those strings described a
  * business that does not exist here, and every consumer who installed the block
  * inherited them.
+ *
+ * The section heading is aligned left, for the reason `FeatureGrid01` now records
+ * in full and `test/section-heading-align.test.tsx` holds: three cards sit under
+ * it, and a centred title above a left-aligned grid reads as two unrelated pieces.
+ * `Pricing01` and `FeatureGrid01` were the only two Blocks that left the heading
+ * centred over content, and neither had a stated reason for it, so both were
+ * taking the default rather than making a decision.
  */
 export function Pricing01({ eyebrow, title, description, plans, 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 lg:grid-cols-3", children: plans.map((plan) => (_jsxs(Card, { className: plan.featured ? 'border-primary shadow-md' : undefined, children: [_jsxs(CardHeader, { children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsx(CardTitle, { children: plan.name }), plan.featured && plan.badge ? _jsx(Badge, { children: plan.badge }) : null] }), plan.body ? _jsx(CardDescription, { children: plan.body }) : null, _jsxs("p", { className: "mt-2 text-3xl font-semibold tracking-tight", children: [plan.price, plan.period ? (_jsx("span", { className: "text-muted-foreground text-sm font-normal", children: plan.period })) : null] })] }), _jsx(CardContent, { className: "flex flex-col gap-3", children: plan.features.map((feature, index) => (_jsxs("p", { className: "flex items-start gap-2 text-sm", children: [_jsx(Check, { className: "text-success mt-0.5 size-4 shrink-0" }), feature] }, index))) }), _jsx(CardFooter, { className: "mt-auto", children: _jsx(Button, { className: "w-full", variant: plan.featured ? 'default' : 'outline', children: plan.cta }) })] }, plan.name))) })] }));
+    // A plan name is a heading one step below the section that introduces the set,
+    // so three plans under one `h2` are three `h3`s and not three competing sections.
+    const Title = childLevel(headingLevel);
+    return (_jsxs(Section, { children: [title ? (_jsx(SectionHeading, { as: headingLevel, align: "left", eyebrow: eyebrow, title: title, description: description, className: "mb-12" })) : null, _jsx("div", { className: "grid gap-6 lg:grid-cols-3", children: plans.map((plan) => (_jsxs(Card, { className: plan.featured ? 'border-primary shadow-md' : undefined, children: [_jsxs(CardHeader, { children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsx(CardTitle, { children: _jsx(Title, { children: plan.name }) }), plan.featured && plan.badge ? _jsx(Badge, { children: plan.badge }) : null] }), plan.body ? _jsx(CardDescription, { children: plan.body }) : null, _jsxs("p", { className: "mt-2 text-3xl font-semibold tracking-tight", children: [plan.price, plan.period ? (_jsx("span", { className: "text-muted-foreground text-sm font-normal", children: plan.period })) : null] })] }), _jsx(CardContent, { className: "flex flex-col gap-3", children: plan.features.map((feature, index) => (_jsxs("p", { className: "flex items-start gap-2 text-sm", children: [_jsx(Check, { className: "text-success mt-0.5 size-4 shrink-0" }), feature] }, index))) }), _jsx(CardFooter, { className: "mt-auto", children: _jsx(Button, { className: "w-full", variant: plan.featured ? 'default' : 'outline', children: plan.cta }) })] }, plan.name))) })] }));
 }
 export default Pricing01;

package/dist/blocks/process-flow-01/index.d.ts

@@ -0,0 +1,3 @@
+export { ProcessFlow01, default } from './process-flow.js';
+export type { ProcessFlow01Props, ProcessStage, FlowColumns } from './process-flow.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/blocks/process-flow-01/index.d.ts.map

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

package/dist/blocks/process-flow-01/index.js

@@ -0,0 +1 @@
+export { ProcessFlow01, default } from './process-flow.js';

package/dist/blocks/process-flow-01/process-flow.d.ts

@@ -0,0 +1,118 @@
+import { type HeadingLevel } from '../../components/ui/section.js';
+/**
+ * One stage of a pipeline, as the flow draws it.
+ *
+ * The same shape as a `ProcessStep`, declared separately rather than imported: a
+ * flow and a rail are different claims and a consumer composing one has no reason
+ * to take the other's type, and sharing the declaration would invite a caller to
+ * widen a rail by reaching for a flow's step.
+ */
+export type ProcessStage = {
+    /** The stage's own name, as a reader would name it in conversation. */
+    name: string;
+    /** One line about what happens at this stage. */
+    description: string;
+};
+/**
+ * How many stages a flow puts on one line.
+ *
+ * The grid tracks, not the stage count. A flow is a sequence that has to wrap, so
+ * the number of stages is the caller's and the number on a line is this Block's:
+ * those are different questions, and a caller that had to state both would state
+ * them in step by hand, which is the thing a Block should not ask.
+ *
+ * Three is the default because three divides the two lengths the sites actually
+ * state, six and nine, and a row of three is the widest that still leaves an ordinal
+ * and a name beside each other without one of them wrapping.
+ */
+export type FlowColumns = 2 | 3 | 4;
+/**
+ * The props a ProcessFlow01 takes.
+ *
+ * Every string is a prop. The Block ships no stage, no ordinal and no label for the
+ * end of the flow: a pipeline that hardcoded a stage name would hand every consumer
+ * a diagram of somebody else's pipeline.
+ */
+export type ProcessFlow01Props = {
+    /** Optional label above the section title. See the No-Default-Eyebrow Rule. */
+    eyebrow?: string;
+    /** The section title. Omit it for a flow composed under its own heading. */
+    title?: string;
+    /** One or two sentences under the title. */
+    description?: string;
+    /**
+     * The label on the last stage, for a flow that ends in a state worth naming:
+     * "merged", "shipping", "verified". Omit it when the last stage needs no label,
+     * which is the honest state for a pipeline that has not finished.
+     */
+    finalLabel?: string;
+    /**
+     * The stages, in the order the pipeline runs.
+     *
+     * An array rather than the tuple `ProcessRail01` uses, and the difference is the
+     * whole of what this Block is for. A rail holds one line, so its length is a
+     * layout claim the type can make and a wider rail would break; a flow wraps, so
+     * its length is content and the type has nothing to say about it. Six stages are
+     * six stages, and the grid carries them.
+     */
+    stages: ProcessStage[];
+    /**
+     * How many stages sit on one line. Defaults to 3.
+     *
+     * A prop because a five-stage pipeline and a nine-stage one do not read alike at
+     * the same width, and a caller who knows their own length knows their own line.
+     */
+    columns?: FlowColumns;
+    /** Heading level for the section title. See `HeadingLevel`. */
+    headingLevel?: HeadingLevel;
+    className?: string;
+};
+/**
+ * A pipeline drawn as a flow: the stages in order, wrapping across lines.
+ *
+ * **The rail's refusal of a fifth stage is left standing.** `ProcessRail01` holds
+ * two, three or four stages and a five-element array is a compile error, and that is
+ * the same decision this Block is built beside rather than against: a rail is a
+ * claim about a sequence on one line, and a rail that quietly dropped a stage to fit
+ * a width would be a diagram of a process that is not the process. A company site
+ * states six stages, and it was drawing them as a grid of short points, where the
+ * six ordinals and the terminal label were lost and a sequence read as a set. That
+ * gap is a gap in the roster, and the honest repair is a second shape rather than a
+ * wider tuple: raising the rail's ceiling to six would make the fourth column
+ * unrepresentable as a type error, which is the property that made the original
+ * decision good.
+ *
+ * **It is one `<ol>`, and that is the part the layout is built around.** A flow that
+ * wrapped into a row per group would be several lists, and a screen reader would
+ * announce it as three lists of two, which is precisely the set-where-a-sequence-was
+ * that this Block exists to avoid. So the stages are one ordered list and the
+ * wrapping is done by the grid, which means the Block never gets to know where a
+ * line broke, and therefore cannot draw something that is only right on the widest
+ * screen.
+ *
+ * **The ordinal is the continuity mechanism, and it is treated as one.** It runs
+ * `01` through to the last stage with no restart, in the mono face, at a size a
+ * reader can scan down a column rather than read one at a time. That is what makes a
+ * wrapped flow legible: a reader who lands on stage four sees `04` and knows it
+ * continues stage three, whatever the column count happens to be at the width they
+ * are using. Nothing else in this Block is load-bearing for the sequence, and
+ * anything that needed to know where the line broke would be.
+ *
+ * **The thread is a line through the stages, not a box around each one.** Each
+ * stage draws a top border and the grid separates them by a single pixel, so a run
+ * of stages on one line reads as one line broken by hairline gaps, and the gap
+ * between two lines is wider. That is the same technique the rail uses, and it is
+ * chosen here for a specific reason: it holds at any column count, including the
+ * one-column layout a phone gets, without the Block knowing anything about it. A
+ * connector drawn between a stage and its successor would need the column count to
+ * be right, and would be wrong at every width the type does not describe.
+ *
+ * A caption of more than about twelve words wraps under a stage and the line stops
+ * reading as a line, so the caption is a line and the detail belongs above the flow
+ * in `description`.
+ *
+ * It is a server Component: no hook, no state and no client code.
+ */
+export declare function ProcessFlow01({ eyebrow, title, description, finalLabel, stages, columns, headingLevel, className, }: ProcessFlow01Props): import("react").JSX.Element;
+export default ProcessFlow01;
+//# sourceMappingURL=process-flow.d.ts.map

package/dist/blocks/process-flow-01/process-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-flow.d.ts","sourceRoot":"","sources":["../../../src/blocks/process-flow-01/process-flow.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAGxF;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAgBnC;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;;;;OAQG;IACH,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,KAAK,EACL,WAAW,EACX,UAAU,EACV,MAAM,EACN,OAAW,EACX,YAAmB,EACnB,SAAS,GACV,EAAE,kBAAkB,+BAgDpB;AAED,eAAe,aAAa,CAAA"}