@nanisoft/prism-ui 0.10.1 → 0.13.0

package/dist/blocks/app-shell-01/app-shell.js

@@ -2,10 +2,10 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { Menu } from 'lucide-react';
 import { Fragment, useState } from 'react';
-import { Breadcrumb, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, } from '../../components/ui/breadcrumb';
-import { Button } from '../../components/ui/button';
-import { Dialog, DialogContent, DialogTitle } from '../../components/ui/dialog';
-import { Separator } from '../../components/ui/separator';
+import { Breadcrumb, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, } from '../../components/ui/breadcrumb.js';
+import { Button } from '../../components/ui/button.js';
+import { Dialog, DialogContent, DialogTitle } from '../../components/ui/dialog.js';
+import { Separator } from '../../components/ui/separator.js';
 /**
  * An application shell.
  *

package/dist/blocks/app-shell-01/index.d.ts

@@ -1,3 +1,3 @@
-export { AppShell01, default } from './app-shell';
-export type { AppShell01Props, AppShellCrumb } from './app-shell';
+export { AppShell01, default } from './app-shell.js';
+export type { AppShell01Props, AppShellCrumb } from './app-shell.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/blocks/app-shell-01/index.js

@@ -1 +1 @@
-export { AppShell01, default } from './app-shell';
+export { AppShell01, default } from './app-shell.js';

package/dist/blocks/auth-form-01/auth-form.d.ts

@@ -1,4 +1,5 @@
 import type { FormEvent, ReactNode } from 'react';
+import type { HeadingLevel } from '../../components/ui/section.js';
 export type AuthFormField = {
     id: string;
     label: string;
@@ -22,6 +23,15 @@ export type AuthFormRemember = {
 };
 export type AuthForm01Props = {
     title: string;
+    /**
+     * Heading level for the card's title. See `HeadingLevel`.
+     *
+     * This Block draws no Section heading of its own, so the card title is the one
+     * heading it renders and takes the level directly rather than a step below one.
+     * It is a prop for the same reason every Block's is: the surrounding document
+     * decides where this lands in the outline, not the Block.
+     */
+    headingLevel?: HeadingLevel;
     description?: string;
     /** The credential fields, in order. */
     fields: AuthFormField[];
@@ -47,6 +57,6 @@ export type AuthForm01Props = {
  * the submit handler come from the consumer, and the error line is a prop so
  * the consumer's validation decides when it appears. Every string is a prop.
  */
-export declare function AuthForm01({ title, description, fields, error, remember, submitLabel, pendingLabel, pending, onSubmit, footer, }: AuthForm01Props): import("react").JSX.Element;
+export declare function AuthForm01({ title, description, fields, error, remember, submitLabel, pendingLabel, pending, onSubmit, footer, headingLevel, }: AuthForm01Props): import("react").JSX.Element;
 export default AuthForm01;
 //# sourceMappingURL=auth-form.d.ts.map

package/dist/blocks/auth-form-01/auth-form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-form.d.ts","sourceRoot":"","sources":["../../../src/blocks/auth-form-01/auth-form.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAqBjD,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAA;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uCAAuC;IACvC,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,eAAe,CAAC,KAAK,IAAI,CAAA;IACtD,oEAAoE;IACpE,MAAM,CAAC,EAAE,SAAS,CAAA;CACnB,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,WAAW,EACX,MAAM,EACN,KAAK,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,OAAe,EACf,QAAQ,EACR,MAAM,GACP,EAAE,eAAe,+BAmEjB;AAED,eAAe,UAAU,CAAA"}
+{"version":3,"file":"auth-form.d.ts","sourceRoot":"","sources":["../../../src/blocks/auth-form-01/auth-form.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAoBjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE/D,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAA;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uCAAuC;IACvC,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,eAAe,CAAC,KAAK,IAAI,CAAA;IACtD,oEAAoE;IACpE,MAAM,CAAC,EAAE,SAAS,CAAA;CACnB,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,WAAW,EACX,MAAM,EACN,KAAK,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,OAAe,EACf,QAAQ,EACR,MAAM,EACN,YAAmB,GACpB,EAAE,eAAe,+BAwEjB;AAED,eAAe,UAAU,CAAA"}

package/dist/blocks/auth-form-01/auth-form.js

@@ -1,12 +1,12 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { CircleAlert } from 'lucide-react';
-import { Alert, AlertDescription } from '../../components/ui/alert';
-import { Button } from '../../components/ui/button';
-import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, } from '../../components/ui/card';
-import { Checkbox } from '../../components/ui/checkbox';
-import { Field, FieldDescription, FieldGroup, FieldLabel, } from '../../components/ui/field';
-import { Input } from '../../components/ui/input';
+import { Alert, AlertDescription } from '../../components/ui/alert.js';
+import { Button } from '../../components/ui/button.js';
+import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, } from '../../components/ui/card.js';
+import { Checkbox } from '../../components/ui/checkbox.js';
+import { Field, FieldDescription, FieldGroup, FieldLabel, } from '../../components/ui/field.js';
+import { Input } from '../../components/ui/input.js';
 /**
  * A sign-in card.
  *
@@ -15,8 +15,11 @@ import { Input } from '../../components/ui/input';
  * the submit handler come from the consumer, and the error line is a prop so
  * the consumer's validation decides when it appears. Every string is a prop.
  */
-export function AuthForm01({ title, description, fields, error, remember, submitLabel, pendingLabel, pending = false, onSubmit, footer, }) {
-    return (_jsx("form", { onSubmit: onSubmit, className: "w-full", children: _jsxs(Card, { children: [_jsxs(CardHeader, { children: [_jsx(CardTitle, { children: title }), description ? _jsx(CardDescription, { children: description }) : null] }), _jsxs(CardContent, { className: "flex flex-col gap-4", children: [error ? (_jsxs(Alert, { variant: "destructive", children: [_jsx(CircleAlert, {}), _jsx(AlertDescription, { children: error })] })) : null, _jsx(FieldGroup, { children: fields.map((field) => (_jsxs(Field, { children: [_jsx(FieldLabel, { htmlFor: field.id, children: field.label }), _jsx(Input, { id: field.id, type: field.type ?? 'text', placeholder: field.placeholder, autoComplete: field.autoComplete, value: field.value, defaultValue: field.defaultValue, onChange: field.onChange
+export function AuthForm01({ title, description, fields, error, remember, submitLabel, pendingLabel, pending = false, onSubmit, footer, headingLevel = 'h2', }) {
+    // This Block draws no section heading, so the card title is the one heading it
+    // renders and takes the level directly rather than a step below one.
+    const Title = headingLevel;
+    return (_jsx("form", { onSubmit: onSubmit, className: "w-full", children: _jsxs(Card, { children: [_jsxs(CardHeader, { children: [_jsx(CardTitle, { children: _jsx(Title, { children: title }) }), description ? _jsx(CardDescription, { children: description }) : null] }), _jsxs(CardContent, { className: "flex flex-col gap-4", children: [error ? (_jsxs(Alert, { variant: "destructive", children: [_jsx(CircleAlert, {}), _jsx(AlertDescription, { children: error })] })) : null, _jsx(FieldGroup, { children: fields.map((field) => (_jsxs(Field, { children: [_jsx(FieldLabel, { htmlFor: field.id, children: field.label }), _jsx(Input, { id: field.id, type: field.type ?? 'text', placeholder: field.placeholder, autoComplete: field.autoComplete, value: field.value, defaultValue: field.defaultValue, onChange: field.onChange
                                             ? (event) => field.onChange?.(event.target.value)
                                             : undefined, required: field.required, disabled: field.disabled, "aria-invalid": error ? true : undefined }), field.description ? (_jsx(FieldDescription, { children: field.description })) : null] }, field.id))) }), remember ? (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Checkbox, { id: remember.id, checked: remember.checked, defaultChecked: remember.defaultChecked, onCheckedChange: remember.onCheckedChange, disabled: remember.disabled }), _jsx(FieldLabel, { htmlFor: remember.id, children: remember.label })] })) : null] }), _jsxs(CardFooter, { className: "flex-col gap-3", children: [_jsx(Button, { type: "submit", className: "w-full", disabled: pending, children: pending ? (pendingLabel ?? submitLabel) : submitLabel }), footer] })] }) }));
 }

package/dist/blocks/auth-form-01/index.d.ts

@@ -1,3 +1,3 @@
-export { AuthForm01, default } from './auth-form';
-export type { AuthForm01Props, AuthFormField, AuthFormRemember } from './auth-form';
+export { AuthForm01, default } from './auth-form.js';
+export type { AuthForm01Props, AuthFormField, AuthFormRemember } from './auth-form.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/blocks/auth-form-01/index.js

@@ -1 +1 @@
-export { AuthForm01, default } from './auth-form';
+export { AuthForm01, default } from './auth-form.js';

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

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import { type HeadingLevel } from '../../components/ui/section';
+import { type HeadingLevel } from '../../components/ui/section.js';
 /**
  * One closing action.
  *
@@ -24,23 +24,28 @@ export type Cta01Action = {
     /**
      * Which weight this action draws at, when the caller does not say.
      *
-     * **A panel wants `default` or `secondary`, never `outline`.** This Block draws
-     * its band as a filled `bg-primary` surface and sets the band's ink to
-     * `--primary-foreground`, so every ink inside it is inherited from that panel
-     * rather than from the page. An `outline` action sets its own fill
-     * (`bg-background`) and, before this was settled, left its ink inherited, which
-     * put `--background` behind `--primary-foreground`. In the lavender pack's dark
-     * mode that is `#19171b` behind `#210c33`, or 1.01:1: a focusable, announced,
-     * unreadable button.
+     * **A filled panel wants `secondary` or `outline`, and never `default`.** The
+     * property that decides it is not the ink but the fill: this Block draws its
+     * band as a filled `bg-primary` surface, and `default` fills with `--primary`,
+     * so a `default` action on this band is the band's own colour against the
+     * band's own colour. Its label is legible, because `primary-foreground` on
+     * `primary` is a gated pair, and the control has no edge, which is a different
+     * defect and the reason this sentence is about the fill rather than the text.
      *
-     * Both defaults below are self-contained, which is the property that matters:
-     * `default` pairs `--primary` with `--primary-foreground` and `secondary`
-     * pairs `--secondary` with `--secondary-foreground`, and a pair the Block
-     * chooses cannot be changed by whatever surface the Block is placed on. The
-     * `outline` variant is fixed too, in `cta-link.tsx`, because a variant that
-     * sets a fill should set the matching ink rather than inherit whatever it lands
-     * on. It is kept in the type because a caller may want it once the ink is
-     * explicit, and dropping it would be a smaller answer than the defect.
+     * `secondary` and `outline` are the two that answer, and what makes them
+     * answer is that each states its own ink rather than inheriting one. That is
+     * the part that was broken and is now settled: `outline` carried `bg-background`
+     * with no `text-` of its own, so inside this band it was `--background` behind
+     * the inherited `--primary-foreground`, which in lavender's dark mode measured
+     * 1.01:1 and in the base pack's light mode 1.00:1, a focusable, announced,
+     * unreadable button. The variant is fixed in `cta-link.tsx`, where a variant
+     * that sets a fill now states the matching ink, and
+     * `packages/ui/scripts/check-variant-ink.mjs` is the gate that holds it there.
+     *
+     * So a panel may take all three, and the settled defaults are the two that
+     * carry a fill distinct from the band. Which of the two a given action wants is
+     * the caller's: `secondary` for the one ask, `outline` for the alternative
+     * beside it.
      */
     variant?: 'default' | 'secondary' | 'outline';
 };
@@ -73,10 +78,10 @@ export type Cta01Props = {
      *
      * Its default weight is `outline`, which is the settled answer for the pair:
      * the primary action is filled and this one is not, so the two read as one
-     * decision and one alternative rather than as two competing asks. What `outline`
-     * may not do is inherit its ink from the filled band behind it, and that is
-     * now a property of the variant rather than of where a caller puts it. See
-     * `Cta01Action`'s `variant` for the measurement.
+     * decision and one alternative rather than as two competing asks. It is safe on
+     * the filled band because the variant carries its own ink rather than
+     * inheriting the band's, which is a property of the variant and no longer of
+     * where a caller puts it. See `Cta01Action`'s `variant` for the measurement.
      */
     secondaryAction?: Cta01Action;
     /**

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":"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;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,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;;;;;;;;;;;;;;;;;OAiBG;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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,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;;;;;;;;;;;;;;;;;OAiBG;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,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ArrowRight } from 'lucide-react';
-import { CtaLink } from '../../components/ui/cta-link';
-import { Section } from '../../components/ui/section';
+import { CtaLink } from '../../components/ui/cta-link.js';
+import { Section } from '../../components/ui/section.js';
 /**
  * A closing call to action on a filled primary surface.
  *

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

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

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

@@ -1 +1 @@
-export { Cta01, default } from './cta';
+export { Cta01, default } from './cta.js';

package/dist/blocks/data-table-01/data-table.js

@@ -2,13 +2,13 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ChevronDown, ListFilter, MoreHorizontal, Search } from 'lucide-react';
 import { useState } from 'react';
-import { Button } from '../../components/ui/button';
-import { Checkbox } from '../../components/ui/checkbox';
-import { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, } from '../../components/ui/dropdown-menu';
-import { Input } from '../../components/ui/input';
-import { Pagination, PaginationContent, PaginationItem } from '../../components/ui/pagination';
-import { Popover, PopoverContent, PopoverTrigger } from '../../components/ui/popover';
-import { Table, TableBody, TableCaption, TableCell, TableHead, TableHeader, TableRow, } from '../../components/ui/table';
+import { Button } from '../../components/ui/button.js';
+import { Checkbox } from '../../components/ui/checkbox.js';
+import { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, } from '../../components/ui/dropdown-menu.js';
+import { Input } from '../../components/ui/input.js';
+import { Pagination, PaginationContent, PaginationItem } from '../../components/ui/pagination.js';
+import { Popover, PopoverContent, PopoverTrigger } from '../../components/ui/popover.js';
+import { Table, TableBody, TableCaption, TableCell, TableHead, TableHeader, TableRow, } from '../../components/ui/table.js';
 /** The page numbers to show, with `ellipsis` where a run is held back. */
 function pageWindow(page, pageCount) {
     if (pageCount <= 7) {

package/dist/blocks/data-table-01/index.d.ts

@@ -1,3 +1,3 @@
-export { DataTable01, default } from './data-table';
-export type { DataTable01Props, DataTable01Labels, DataTableColumn, DataTableFilter, DataTableFilterOption, DataTableRow, DataTableRowAction, } from './data-table';
+export { DataTable01, default } from './data-table.js';
+export type { DataTable01Props, DataTable01Labels, DataTableColumn, DataTableFilter, DataTableFilterOption, DataTableRow, DataTableRowAction, } from './data-table.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/blocks/data-table-01/index.js

@@ -1 +1 @@
-export { DataTable01, default } from './data-table';
+export { DataTable01, default } from './data-table.js';

package/dist/blocks/empty-state-01/empty-state.d.ts

@@ -0,0 +1,143 @@
+import type { ReactNode } from 'react';
+/**
+ * The three reasons a region has nothing in it.
+ *
+ * **Three, and the set is closed because the three want different words and
+ * different actions, so a consumer who cannot say which one they have writes
+ * "No data".** That is the whole failure this Block exists to prevent, and it is
+ * a failure rather than a style preference because the three are answers to three
+ * different questions and the reader acts on each one differently:
+ *
+ * - `first-run` - nothing has ever existed here. The reader is not blocked, they
+ *   are at the beginning, and the action is to *make the first one*. A sentence
+ *   that says nothing is available and an action that creates is the whole state.
+ * - `no-match` - things exist and the reader's own filter removed all of them.
+ *   The reader is not at the beginning and nothing is missing; the action is to
+ *   *widen or clear the filter*, and offering to create something here invents
+ *   work the reader does not need.
+ * - `not-permitted` - things exist and this reader may not see them. The action
+ *   is to *ask for access or change context*, and a create action here is a lie
+ *   about what the reader can do, which is worse than no action at all.
+ *
+ * A fourth such as `error` or `loading` is deliberately absent: those are states
+ * the surrounding surface already owns, and a region that is erroring has an
+ * `Alert` and a region that is loading has a `Spinner`. A Block that drew them
+ * would give a consumer two places to put the same fact.
+ *
+ * @see EMPTY_REASONS
+ */
+export declare const EMPTY_REASONS: readonly ["first-run", "no-match", "not-permitted"];
+/**
+ * One of the three reasons a region has nothing in it.
+ *
+ * The reason is a machine value and never reader-facing text. The words are the
+ * consumer's: two products call the same state "Nothing here yet" and "Your
+ * account is new", and neither sentence is Prism's to publish.
+ */
+export type EmptyReason = (typeof EMPTY_REASONS)[number];
+/**
+ * The props an EmptyState01 takes.
+ *
+ * Every string is a prop and the Block ships none: no headline, no sentence, no
+ * action label and no reason word. A Block that rendered "No data" would put a
+ * sentence about a product that is not its own into four consumer sites, and the
+ * corpus publishes it as the design system's own voice.
+ */
+export type EmptyState01Props = {
+    /**
+     * Which of the three situations this is. Required rather than defaulted,
+     * because the default would be the one that hides the bug: a Block that
+     * defaulted to `first-run` would render a create action beside a permission
+     * boundary, and a Block that defaulted to `no-match` would tell every reader
+     * their own filter removed something on their first visit. Making the caller
+     * name the reason is what stops either from happening quietly.
+     */
+    reason: EmptyReason;
+    /**
+     * The headline: what is not here, in the reader's own words. Required, because
+     * the Block's only job is to carry a sentence and a reason together, and a
+     * region with a frame and no words is a box a reader has to interpret.
+     */
+    title: string;
+    /**
+     * The sentence under the headline, for the part the headline cannot fit: what
+     * to do about it, or what the reader should know before they act. Omit it when
+     * the headline is the whole message.
+     */
+    body?: string;
+    /**
+     * The label of the one action, in the product's own words.
+     *
+     * Optional, and its absence is a legitimate state rather than a gap: a region
+     * a reader cannot act on - a permission boundary, an archived-only view, a
+     * feature that is switched off for their plan - has no next step, and inventing
+     * one is how an empty state ends up offering a reader a button that cannot
+     * help them. `reason` does not require it either, because the same rule applies
+     * across the three: the action exists when the reader has something to do.
+     */
+    actionLabel?: string;
+    /**
+     * The handler for `actionLabel`. Required whenever `actionLabel` is passed, and
+     * the Block throws without it rather than rendering a button that does nothing:
+     * a disabled-looking control with no `disabled` is a control that lies.
+     */
+    onAction?: () => void;
+    /**
+     * The mark above the words, as a slot.
+     *
+     * A slot and not an icon the Block picks, because the mark that means "nothing
+     * here yet" and the mark that means "you cannot see this" are different marks,
+     * and a Block that chose one would give four products an icon that is wrong for
+     * one of the three reasons. It is `aria-hidden` wherever a consumer puts it: the
+     * reason is carried by the words, and an icon a screen reader reads is a second
+     * announcement of the same sentence.
+     */
+    icon?: ReactNode;
+    /**
+     * Layout only, exactly as on every Component and Block. Changing a Prism-owned
+     * visual property from here is prohibited.
+     */
+    className?: string;
+};
+/**
+ * The state a region shows when it has nothing in it: a framed mark, a headline,
+ * a sentence and at most one action.
+ *
+ * **The design decision is the `reason` prop, and it is the reason this is a Block
+ * rather than a Component.** An empty state looks like one thing, which is why it
+ * has been written by hand in every product that has one, and it is actually three
+ * things that need different words and different actions. A component with a
+ * `title` and a `body` and an `action` cannot express the difference, so every
+ * consumer re-decides it in their own words and at least one of them gets it
+ * wrong: a permission boundary that offers "Create your first project", or a
+ * first-run state that says "No results found". Naming the reason forces the
+ * decision into the open and gives the Block something to enforce.
+ *
+ * **A Block and not a Component because it is a composition of five decisions
+ * rather than one control.** A mark, a headline, a sentence, an action and a
+ * region-sized frame: each of those has been re-decided by hand in every product
+ * that has an empty state, and `DESIGN.md` records the resolution of the retired
+ * `empty` Component as exactly this shape. It ships no copy, takes no data and
+ * fetches nothing.
+ *
+ * **The region keeps its size.** The frame is a `min-h-*` and a dashed border
+ * rather than a fixed height, and it is drawn with `size-*` on the mark, because
+ * an empty state is what a region looks like *before* its content arrives. A
+ * region that is one line tall while it is empty and forty lines tall once it is
+ * full moves everything below it twice, and the reader's eye has to find the
+ * thing twice. This is the same layout shift the `Spinner` records as its own
+ * honest cost, and the reason a `first-run` frame wants a floor under it.
+ *
+ * **The action is one, and it is not required.** An empty state offering three
+ * actions is a form, and a form in a region that has nothing in it is a form with
+ * nothing to submit. One action is the next step; the rest belong in the
+ * surrounding surface, where the reader can see them without this region
+ * competing.
+ *
+ * It is a server Component. It holds no state and imports no client code, so a
+ * consumer that passes a client action inside it pays for the action and not for
+ * the frame.
+ */
+export declare function EmptyState01({ reason, title, body, actionLabel, onAction, icon, className, }: EmptyState01Props): import("react").JSX.Element;
+export default EmptyState01;
+//# sourceMappingURL=empty-state.d.ts.map

package/dist/blocks/empty-state-01/empty-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty-state.d.ts","sourceRoot":"","sources":["../../../src/blocks/empty-state-01/empty-state.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,aAAa,qDAAsD,CAAA;AAEhF;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAuBxD;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;;;;;OAOG;IACH,MAAM,EAAE,WAAW,CAAA;IACnB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,KAAK,EACL,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,SAAS,GACV,EAAE,iBAAiB,+BAoEnB;AAED,eAAe,YAAY,CAAA"}

package/dist/blocks/empty-state-01/empty-state.js

@@ -0,0 +1,104 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button } from '../../components/ui/button.js';
+import { cn } from '../../lib/utils.js';
+/**
+ * The three reasons a region has nothing in it.
+ *
+ * **Three, and the set is closed because the three want different words and
+ * different actions, so a consumer who cannot say which one they have writes
+ * "No data".** That is the whole failure this Block exists to prevent, and it is
+ * a failure rather than a style preference because the three are answers to three
+ * different questions and the reader acts on each one differently:
+ *
+ * - `first-run` - nothing has ever existed here. The reader is not blocked, they
+ *   are at the beginning, and the action is to *make the first one*. A sentence
+ *   that says nothing is available and an action that creates is the whole state.
+ * - `no-match` - things exist and the reader's own filter removed all of them.
+ *   The reader is not at the beginning and nothing is missing; the action is to
+ *   *widen or clear the filter*, and offering to create something here invents
+ *   work the reader does not need.
+ * - `not-permitted` - things exist and this reader may not see them. The action
+ *   is to *ask for access or change context*, and a create action here is a lie
+ *   about what the reader can do, which is worse than no action at all.
+ *
+ * A fourth such as `error` or `loading` is deliberately absent: those are states
+ * the surrounding surface already owns, and a region that is erroring has an
+ * `Alert` and a region that is loading has a `Spinner`. A Block that drew them
+ * would give a consumer two places to put the same fact.
+ *
+ * @see EMPTY_REASONS
+ */
+export const EMPTY_REASONS = ['first-run', 'no-match', 'not-permitted'];
+/**
+ * The one thing that differs between the three frames.
+ *
+ * **The frame is shared and the difference is an ink, and that is a decision
+ * about honesty rather than about looks.** All three get the same dashed edge and
+ * the same floor under them, because all three mean *there is nothing here to
+ * read*. What they must not share is a claim about why, and a tint or a border
+ * hue would be one: a region drawn in a warning colour tells the reader their
+ * filter, or their permissions, is a problem, and in the second case it is not.
+ *
+ * So only `not-permitted` carries an ink, and it is `muted-foreground` rather
+ * than a destructive tone. A permission boundary is not a failure, and painting
+ * it red teaches a reader to ignore red for the things that are urgent. The
+ * distinction the reader actually needs is *you cannot see this* against *this is
+ * broken*, and the words carry it; the frame says only that the region is empty,
+ * which is true of all three.
+ */
+const REASON_INK = {
+    'not-permitted': 'text-muted-foreground',
+};
+/**
+ * The state a region shows when it has nothing in it: a framed mark, a headline,
+ * a sentence and at most one action.
+ *
+ * **The design decision is the `reason` prop, and it is the reason this is a Block
+ * rather than a Component.** An empty state looks like one thing, which is why it
+ * has been written by hand in every product that has one, and it is actually three
+ * things that need different words and different actions. A component with a
+ * `title` and a `body` and an `action` cannot express the difference, so every
+ * consumer re-decides it in their own words and at least one of them gets it
+ * wrong: a permission boundary that offers "Create your first project", or a
+ * first-run state that says "No results found". Naming the reason forces the
+ * decision into the open and gives the Block something to enforce.
+ *
+ * **A Block and not a Component because it is a composition of five decisions
+ * rather than one control.** A mark, a headline, a sentence, an action and a
+ * region-sized frame: each of those has been re-decided by hand in every product
+ * that has an empty state, and `DESIGN.md` records the resolution of the retired
+ * `empty` Component as exactly this shape. It ships no copy, takes no data and
+ * fetches nothing.
+ *
+ * **The region keeps its size.** The frame is a `min-h-*` and a dashed border
+ * rather than a fixed height, and it is drawn with `size-*` on the mark, because
+ * an empty state is what a region looks like *before* its content arrives. A
+ * region that is one line tall while it is empty and forty lines tall once it is
+ * full moves everything below it twice, and the reader's eye has to find the
+ * thing twice. This is the same layout shift the `Spinner` records as its own
+ * honest cost, and the reason a `first-run` frame wants a floor under it.
+ *
+ * **The action is one, and it is not required.** An empty state offering three
+ * actions is a form, and a form in a region that has nothing in it is a form with
+ * nothing to submit. One action is the next step; the rest belong in the
+ * surrounding surface, where the reader can see them without this region
+ * competing.
+ *
+ * It is a server Component. It holds no state and imports no client code, so a
+ * consumer that passes a client action inside it pays for the action and not for
+ * the frame.
+ */
+export function EmptyState01({ reason, title, body, actionLabel, onAction, icon, className, }) {
+    if (actionLabel !== undefined && onAction === undefined) {
+        throw new Error(`EmptyState01: an actionLabel of '${actionLabel}' was passed with no onAction, so the button ` +
+            'would read as available and do nothing. Pass the handler, or drop the label and leave the ' +
+            'region without a next step.');
+    }
+    return (_jsxs("div", { "data-slot": "empty-state", "data-reason": reason, className: cn(
+        // Centred and given a floor under it, because this is the whole of the
+        // region rather than a note beside content. `min-h-64` is roughly six
+        // lines, which is what a full page of rows costs; a shorter empty state
+        // makes the region jump when its content arrives.
+        'border-border bg-card flex min-h-64 flex-col items-center justify-center gap-3 rounded-xl border border-dashed p-8 text-center', REASON_INK[reason], className), children: [icon === undefined ? null : (_jsx("div", { "data-slot": "empty-state-icon", "aria-hidden": true, className: "text-muted-foreground flex-none", children: icon })), _jsx("p", { "data-slot": "empty-state-title", className: "text-base font-semibold text-balance", children: title }), body === undefined ? null : (_jsx("p", { "data-slot": "empty-state-body", className: "text-muted-foreground max-w-measure-narrow text-pretty text-sm", children: body })), actionLabel === undefined ? null : (_jsx(Button, { "data-slot": "empty-state-action", type: "button", className: "mt-2", onClick: onAction, children: actionLabel }))] }));
+}
+export default EmptyState01;

package/dist/blocks/empty-state-01/index.d.ts

@@ -0,0 +1,3 @@
+export { EmptyState01, EMPTY_REASONS, default } from './empty-state.js';
+export type { EmptyState01Props, EmptyReason } from './empty-state.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/blocks/empty-state-01/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blocks/empty-state-01/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACpE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}

package/dist/blocks/empty-state-01/index.js

@@ -0,0 +1 @@
+export { EmptyState01, EMPTY_REASONS, default } from './empty-state.js';

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

@@ -1,5 +1,5 @@
 import type { LucideIcon } from 'lucide-react';
-import { type HeadingLevel } from '../../components/ui/section';
+import { type HeadingLevel } from '../../components/ui/section.js';
 /**
  * One feature in an icon-bearing grid.
  *
@@ -72,6 +72,33 @@ export type FeatureGrid01Props = FeatureGrid01CommonProps & ({
  * 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 declare function FeatureGrid01(props: FeatureGrid01Props): import("react").JSX.Element;
 export default FeatureGrid01;

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;;;;;;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"}
+{"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,EAAuC,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAEpG;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,+BAiDtD;AAED,eAAe,aAAa,CAAA"}