@nanisoft/prism-ui 0.5.0 → 0.6.0

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

@@ -0,0 +1,78 @@
+import type { LucideIcon } from 'lucide-react';
+import { type HeadingLevel } from '../../components/ui/section';
+/**
+ * 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;
+};
+/** 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;
+    /**
+     * 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(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

@@ -0,0 +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;;;;;;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

@@ -0,0 +1,24 @@
+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';
+/**
+ * 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 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

@@ -0,0 +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

@@ -0,0 +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;AACvD,YAAY,EACV,WAAW,EACX,OAAO,EACP,kBAAkB,EAClB,WAAW,GACZ,MAAM,gBAAgB,CAAA"}

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

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

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

@@ -0,0 +1,59 @@
+import { type HeadingLevel } from '../../components/ui/section';
+export type HeroAction = {
+    label: string;
+    href?: string;
+    variant?: 'default' | 'outline' | 'secondary' | 'ghost';
+};
+export type Hero01Props = {
+    /**
+     * Optional label above the headline. Intentionally has no default: an earlier
+     * version shipped a hardcoded "Now in open beta" pill, which meant every
+     * consumer who installed this block inherited a status badge making a claim
+     * about their product. Pass one if you mean it.
+     */
+    eyebrow?: string;
+    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
+     * inside catalog previews, so the surrounding document already owns the `h1`.
+     * A page that uses this block as its top-level heading opts in with
+     * `headingLevel="h1"`; a document that already names this section in its own
+     * heading passes one level deeper. See `HeadingLevel`.
+     */
+    headingLevel?: HeadingLevel;
+};
+/**
+ * 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

@@ -0,0 +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;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

@@ -0,0 +1,24 @@
+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';
+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.
+                        _jsxs(Button, { size: "lg", variant: action.variant ?? (index === 0 ? 'default' : 'outline'), className: "group", children: [action.label, index === 0 ? (_jsx(ArrowRight, { className: "motion-safe:transition-transform size-4 group-hover:translate-x-0.5" })) : null] }, index))) })) : null] })] }));
+}
+export default Hero01;

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

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

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

@@ -0,0 +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"}

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

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

package/dist/blocks/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Every Prism Block.
+ *
+ * A Block is a pre-composed, product-agnostic section: it accepts data and
+ * 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';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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;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

@@ -0,0 +1,26 @@
+/**
+ * Every Prism Block.
+ *
+ * A Block is a pre-composed, product-agnostic section: it accepts data and
+ * 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';

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';

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

@@ -0,0 +1,84 @@
+import { type HeadingLevel } from '../../components/ui/section';
+/**
+ * One item of the strip, as a string.
+ *
+ * A string rather than a node, because the strip is a run of short words and a
+ * node would let a caller put a paragraph in a slot whose whole job is to be
+ * scannable in one glance. A caller with more than a few words about one item
+ * wants a `NoteGrid01` row or a `StatusLedger01` row, not a longer strip.
+ */
+export type LogoStripItem = string;
+/**
+ * The props a LogoStrip01 takes.
+ *
+ * Every string is a prop and the Block ships none. There is no default list of
+ * technologies, no default list of customers and no default list of words: a
+ * strip that hardcoded any of them would hand every consumer a claim about who
+ * uses their product.
+ */
+export type LogoStrip01Props = {
+    /**
+     * The items, in the order a reader should meet them. Order is the caller's
+     * because it is a claim about which item matters first.
+     */
+    items: readonly LogoStripItem[];
+    /**
+     * The strip's accessible name, for a strip that is not inside a region the
+     * reader can already name. It is rendered as the list's name and as no visible
+     * text, because the items are the visible content and a heading above them would
+     * be a heading about a heading.
+     *
+     * It is required because it is a word a reader hears. A Block that ships no copy
+     * ships no reader-facing copy either, so "Highlights" is not this Block's to
+     * choose: on one site the strip is a list of data sources and on another it is a
+     * list of capabilities, and the word that says which is the caller's.
+     */
+    label: string;
+    /** Optional label above the section title. See the No-Default-Eyebrow Rule. */
+    eyebrow?: string;
+    /** The section title. Omit it for a strip composed under its own heading. */
+    title?: string;
+    /** One or two sentences under the title. */
+    description?: string;
+    /** Heading level for the section title. See `HeadingLevel`. */
+    headingLevel?: HeadingLevel;
+    /**
+     * Layout only, exactly as on every Component. Changing a Prism-owned visual
+     * property from here is prohibited.
+     */
+    className?: string;
+};
+/**
+ * A single line of short items: the transition band between a hero and the
+ * section that follows it.
+ *
+ * All four NaniSoft sites compose this band, immediately after the hero and
+ * before the first numbered section, and each one wrote it as the same thing: a
+ * row of three to six short phrases, separated by a middot, in muted text, with
+ * no heading at all. Four hand-written strips, four sets of site CSS, and one
+ * question each of them answered differently - whether the strip is a list, a
+ * paragraph with separators, or a decorative row of spans.
+ *
+ * It is a `ul`, so a screen reader hears how many items there are before it
+ * hears the first one. That is the whole answer to the question: a strip whose
+ * items are spans in a `div` is announced as one run of text with no count, and a
+ * reader deciding whether to keep listening has nothing to weigh.
+ *
+ * **The strip does not move.** A band of items that slides is an entrance
+ * animation, and this system has none: motion is state feedback only, shortened
+ * rather than removed under reduced motion. What the four sites actually wanted
+ * from their strips was a second, quieter statement of what the product is, and
+ * repetition of the type does that without anything moving. A strip of more than
+ * about eight items wraps onto three lines on a phone and stops being a band, so
+ * a longer set belongs in a `StackGrid01`.
+ *
+ * The items are `text-balance` so a two-word item does not break across lines
+ * where a one-word item beside it does not. There is no separator glyph between
+ * them: a middot is punctuation a screen reader reads and a sighted reader parses
+ * as content, and the gap already separates two words from two words.
+ *
+ * It is a server Component: no hook, no state, no keyframes and no client code.
+ */
+export declare function LogoStrip01({ items, label, eyebrow, title, description, headingLevel, className, }: LogoStrip01Props): import("react").JSX.Element | null;
+export default LogoStrip01;
+//# sourceMappingURL=logo-strip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logo-strip.d.ts","sourceRoot":"","sources":["../../../src/blocks/logo-strip-01/logo-strip.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAGxF;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAA;AAElC;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,KAAK,EAAE,SAAS,aAAa,EAAE,CAAA;IAC/B;;;;;;;;;;OAUG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,KAAK,EACL,OAAO,EACP,KAAK,EACL,WAAW,EACX,YAAmB,EACnB,SAAS,GACV,EAAE,gBAAgB,sCA+BlB;AAED,eAAe,WAAW,CAAA"}

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

@@ -0,0 +1,40 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Section, SectionHeading } from '../../components/ui/section';
+import { cn } from '../../lib/utils';
+/**
+ * A single line of short items: the transition band between a hero and the
+ * section that follows it.
+ *
+ * All four NaniSoft sites compose this band, immediately after the hero and
+ * before the first numbered section, and each one wrote it as the same thing: a
+ * row of three to six short phrases, separated by a middot, in muted text, with
+ * no heading at all. Four hand-written strips, four sets of site CSS, and one
+ * question each of them answered differently - whether the strip is a list, a
+ * paragraph with separators, or a decorative row of spans.
+ *
+ * It is a `ul`, so a screen reader hears how many items there are before it
+ * hears the first one. That is the whole answer to the question: a strip whose
+ * items are spans in a `div` is announced as one run of text with no count, and a
+ * reader deciding whether to keep listening has nothing to weigh.
+ *
+ * **The strip does not move.** A band of items that slides is an entrance
+ * animation, and this system has none: motion is state feedback only, shortened
+ * rather than removed under reduced motion. What the four sites actually wanted
+ * from their strips was a second, quieter statement of what the product is, and
+ * repetition of the type does that without anything moving. A strip of more than
+ * about eight items wraps onto three lines on a phone and stops being a band, so
+ * a longer set belongs in a `StackGrid01`.
+ *
+ * The items are `text-balance` so a two-word item does not break across lines
+ * where a one-word item beside it does not. There is no separator glyph between
+ * them: a middot is punctuation a screen reader reads and a sighted reader parses
+ * as content, and the gap already separates two words from two words.
+ *
+ * It is a server Component: no hook, no state, no keyframes and no client code.
+ */
+export function LogoStrip01({ items, label, eyebrow, title, description, headingLevel = 'h2', className, }) {
+    if (items.length === 0)
+        return null;
+    return (_jsxs(Section, { className: "py-10 sm:py-14", children: [title ? (_jsx(SectionHeading, { as: headingLevel, align: "left", eyebrow: eyebrow, title: title, description: description, className: "mb-10" })) : null, _jsx("ul", { "data-slot": "logo-strip", "aria-label": items.length > 1 ? label : undefined, className: cn('text-muted-foreground flex flex-wrap items-center justify-center gap-x-4 gap-y-2 text-center text-sm', className), children: items.map((item) => (_jsx("li", { "data-slot": "logo-strip-item", className: "text-balance", children: item }, item))) })] }));
+}
+export default LogoStrip01;

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blocks/note-grid-01/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACjD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA"}

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

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