@nanisoft/prism-ui 0.5.0 → 0.6.0

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

@@ -0,0 +1,51 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ProductMark } from '../../components/ui/product-mark';
+import { Section, SectionHeading } from '../../components/ui/section';
+/**
+ * A set of products as a stack of hairline rows: a two-part mark, a name, one
+ * tagline and a destination per row.
+ *
+ * All four NaniSoft sites publish this section, and each one drew it by hand with
+ * the same three parts in the same order: a colour mark for the product, the
+ * product's name, and one line about what it is, on a hairline row with the whole
+ * row a link. Each site also resolved the mark's ink in JavaScript from the live
+ * mode, which is the part that is a second source of truth: four copies of the
+ * rule that a pastel is a fill and the name is an ink, and four copies of the
+ * arithmetic that a filled dot fails contrast on a light card.
+ *
+ * **The mark is two parts, and it is `ProductMark`.** The ring is `brand-ink` and
+ * the core is the product's own `primary`, with the name in the brand ink beside
+ * it. That split is the contested shape this Block ships, and it is settled by a
+ * measurement rather than by taste: a pastel brand value is a fill and never text,
+ * so the core may be `primary` and the name may not, and a *filled* mark on a
+ * light card measures under the threshold a mark has to clear, so the mark is a
+ * hairline ring around the fill rather than a disc of it. A product row that drew
+ * a single filled dot with the name in the same value would be wrong in both
+ * directions at once, and nothing in the rendered result would say which.
+ *
+ * The pack is carried through `ProductMark` rather than set here, so the mark's
+ * own `data-pack` boundary lands on the mark and the product's hue follows from
+ * the pack the caller passed rather than from whichever pack the page is wearing.
+ * That is the half of the pack-boundary law a hand-written mark gets wrong: it
+ * resolves a colour once, at mount, from one element's computed style, and it
+ * keeps showing the old pack's values when a boundary lands above it.
+ *
+ * The row is a link, not a click handler. The whole row is an `a` with the
+ * product's `href`, so a status bar shows the destination, a context menu copies
+ * it, and middle-click opens it in a new tab. The mark is `aria-hidden` inside
+ * it, so the link is announced once, by name, rather than as a shape and a word.
+ *
+ * A row carries one line of tagline. A second line is a second paragraph and
+ * belongs above the grid in `description`, where it applies to the set rather
+ * than to one member of it.
+ *
+ * It is a server Component: no hook, no state, no client code and no mode. The
+ * mark resolves its colour through the cascade, so a page that renders this in a
+ * server file needs nothing from the provider mounted.
+ */
+export function ProductGrid01({ eyebrow, title, description, products, caption, headingLevel = 'h2', }) {
+    if (products.length === 0)
+        return null;
+    return (_jsxs(Section, { children: [title ? (_jsx(SectionHeading, { as: headingLevel, align: "left", eyebrow: eyebrow, title: title, description: description, className: "mb-12" })) : null, _jsx("ul", { "data-slot": "product-grid", className: "flex flex-col", children: products.map((product) => (_jsx("li", { "data-slot": "product-grid-row", className: "border-b first:border-t", children: _jsxs("a", { href: product.href, rel: product.newTab ? 'noopener noreferrer' : undefined, target: product.newTab ? '_blank' : undefined, className: "hover:bg-accent/50 focus-visible:ring-ring flex flex-col gap-1 px-2 py-4 transition-colors duration-fast ease-out sm:flex-row sm:items-baseline sm:gap-6 focus-visible:ring-[3px] focus-visible:outline-none", children: [_jsx("span", { className: "flex shrink-0 items-center sm:w-64", children: _jsx(ProductMark, { id: product.id, name: product.name, pack: product.pack, size: "md" }) }), _jsx("span", { className: "text-muted-foreground text-pretty text-sm", children: product.tagline })] }) }, product.id))) }), caption ? _jsx("p", { className: "text-muted-foreground mt-6 text-pretty text-sm", children: caption }) : null] }));
+}
+export default ProductGrid01;

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

@@ -0,0 +1,3 @@
+export { SettingsPanel01, default } from './settings-panel';
+export type { SettingsPanel01Props, SettingsPanelField, SettingsPanelOption, SettingsPanelSection, } from './settings-panel';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/blocks/settings-panel-01/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC3D,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,kBAAkB,CAAA"}

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

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

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

@@ -0,0 +1,71 @@
+import { type FormEvent, type ReactNode } from 'react';
+export type SettingsPanelOption = {
+    label: string;
+    value: string;
+};
+type SettingsPanelFieldBase = {
+    id: string;
+    label: string;
+    description?: string;
+    disabled?: boolean;
+};
+export type SettingsPanelField = (SettingsPanelFieldBase & {
+    kind: 'text';
+    type?: 'text' | 'email' | 'url';
+    placeholder?: string;
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+}) | (SettingsPanelFieldBase & {
+    kind: 'textarea';
+    placeholder?: string;
+    rows?: number;
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+}) | (SettingsPanelFieldBase & {
+    kind: 'switch';
+    checked?: boolean;
+    defaultChecked?: boolean;
+    onCheckedChange?: (checked: boolean) => void;
+}) | (SettingsPanelFieldBase & {
+    kind: 'select';
+    placeholder?: string;
+    options: SettingsPanelOption[];
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+});
+export type SettingsPanelSection = {
+    id: string;
+    title: string;
+    description?: string;
+    fields: SettingsPanelField[];
+};
+export type SettingsPanel01Props = {
+    title: string;
+    description?: string;
+    /** The settings groups, each rendered with a heading and its own fields. */
+    sections: SettingsPanelSection[];
+    /** The submit button label. Omit to render no footer. */
+    submitLabel?: string;
+    onSubmit?: (event: FormEvent<HTMLFormElement>) => void;
+    /** A secondary control, such as Cancel. */
+    secondaryAction?: {
+        label: string;
+        onClick?: () => void;
+    };
+    /** Extra content in the footer, e.g. a status note. */
+    footer?: ReactNode;
+};
+/**
+ * A settings form grouped into sections.
+ *
+ * A field is a small object describing one control: a text input, a textarea,
+ * a select or a switch, with its label, description and value handlers. The
+ * block renders the card, the groups and the footer; it owns no values and no
+ * copy, so a consumer wires it to whatever form state or mutation they use.
+ */
+export declare function SettingsPanel01({ title, description, sections, submitLabel, onSubmit, secondaryAction, footer, }: SettingsPanel01Props): import("react").JSX.Element;
+export default SettingsPanel01;
+//# sourceMappingURL=settings-panel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings-panel.d.ts","sourceRoot":"","sources":["../../../src/blocks/settings-panel-01/settings-panel.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AA6BhE,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAElE,KAAK,sBAAsB,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAC1B,CAAC,sBAAsB,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAA;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC,CAAC,GACF,CAAC,sBAAsB,GAAG;IACxB,IAAI,EAAE,UAAU,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC,CAAC,GACF,CAAC,sBAAsB,GAAG;IACxB,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CAC7C,CAAC,GACF,CAAC,sBAAsB,GAAG;IACxB,IAAI,EAAE,QAAQ,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACxC,CAAC,CAAA;AAEN,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,kBAAkB,EAAE,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4EAA4E;IAC5E,QAAQ,EAAE,oBAAoB,EAAE,CAAA;IAChC,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,eAAe,CAAC,KAAK,IAAI,CAAA;IACtD,2CAA2C;IAC3C,eAAe,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,CAAA;IACzD,uDAAuD;IACvD,MAAM,CAAC,EAAE,SAAS,CAAA;CACnB,CAAA;AAyFD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,WAAW,EACX,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,eAAe,EACf,MAAM,GACP,EAAE,oBAAoB,+BAmDtB;AAED,eAAe,eAAe,CAAA"}

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

@@ -0,0 +1,38 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment } from 'react';
+import { Button } from '../../components/ui/button';
+import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, } from '../../components/ui/card';
+import { Field, FieldDescription, FieldGroup, FieldLabel, } from '../../components/ui/field';
+import { Input } from '../../components/ui/input';
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue, } from '../../components/ui/select';
+import { Separator } from '../../components/ui/separator';
+import { Switch } from '../../components/ui/switch';
+import { Textarea } from '../../components/ui/textarea';
+function SettingsField({ field }) {
+    if (field.kind === 'switch') {
+        return (_jsxs(Field, { className: "flex-row items-center justify-between gap-4", children: [_jsxs("div", { className: "flex flex-col gap-0.5", children: [_jsx(FieldLabel, { htmlFor: field.id, children: field.label }), field.description ? (_jsx(FieldDescription, { children: field.description })) : null] }), _jsx(Switch, { id: field.id, checked: field.checked, defaultChecked: field.defaultChecked, onCheckedChange: field.onCheckedChange, disabled: field.disabled })] }));
+    }
+    if (field.kind === 'select') {
+        return (_jsxs(Field, { children: [_jsx(FieldLabel, { htmlFor: field.id, children: field.label }), _jsxs(Select, { value: field.value, defaultValue: field.defaultValue, onValueChange: field.onValueChange
+                        ? (value) => field.onValueChange?.(value ?? '')
+                        : undefined, disabled: field.disabled, items: Object.fromEntries(field.options.map((option) => [option.value, option.label])), children: [_jsx(SelectTrigger, { id: field.id, className: "w-full", children: _jsx(SelectValue, { placeholder: field.placeholder }) }), _jsx(SelectContent, { children: field.options.map((option) => (_jsx(SelectItem, { value: option.value, children: option.label }, option.value))) })] }), field.description ? _jsx(FieldDescription, { children: field.description }) : null] }));
+    }
+    if (field.kind === 'textarea') {
+        return (_jsxs(Field, { children: [_jsx(FieldLabel, { htmlFor: field.id, children: field.label }), _jsx(Textarea, { id: field.id, rows: field.rows, placeholder: field.placeholder, value: field.value, defaultValue: field.defaultValue, onChange: field.onChange ? (event) => field.onChange?.(event.target.value) : undefined, disabled: field.disabled }), field.description ? _jsx(FieldDescription, { children: field.description }) : null] }));
+    }
+    return (_jsxs(Field, { children: [_jsx(FieldLabel, { htmlFor: field.id, children: field.label }), _jsx(Input, { id: field.id, type: field.type ?? 'text', placeholder: field.placeholder, value: field.value, defaultValue: field.defaultValue, onChange: field.onChange ? (event) => field.onChange?.(event.target.value) : undefined, disabled: field.disabled }), field.description ? _jsx(FieldDescription, { children: field.description }) : null] }));
+}
+/**
+ * A settings form grouped into sections.
+ *
+ * A field is a small object describing one control: a text input, a textarea,
+ * a select or a switch, with its label, description and value handlers. The
+ * block renders the card, the groups and the footer; it owns no values and no
+ * copy, so a consumer wires it to whatever form state or mutation they use.
+ */
+export function SettingsPanel01({ title, description, sections, submitLabel, onSubmit, secondaryAction, footer, }) {
+    const hasFooter = Boolean(submitLabel || secondaryAction || 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] }), _jsx(CardContent, { className: "flex flex-col", children: sections.map((section, index) => (_jsxs(Fragment, { children: [index > 0 ? _jsx(Separator, { className: "my-6" }) : null, _jsxs("section", { className: "flex flex-col gap-4", "aria-labelledby": `${section.id}-heading`, children: [_jsxs("div", { className: "flex flex-col gap-1", children: [_jsx("h3", { id: `${section.id}-heading`, className: "text-lg font-semibold tracking-tight", children: section.title }), section.description ? (_jsx("p", { className: "text-muted-foreground text-sm", children: section.description })) : null] }), _jsx(FieldGroup, { children: section.fields.map((field) => (_jsx(SettingsField, { field: field }, field.id))) })] })] }, section.id))) }), hasFooter ? (_jsxs(CardFooter, { className: "justify-end gap-2", children: [footer, secondaryAction ? (_jsx(Button, { type: "button", variant: "outline", onClick: secondaryAction.onClick, children: secondaryAction.label })) : null, submitLabel ? _jsx(Button, { type: "submit", children: submitLabel }) : null] })) : null] }) }));
+}
+export default SettingsPanel01;

package/dist/blocks/site-footer/index.d.ts

@@ -0,0 +1,3 @@
+export { SiteFooter, default } from './site-footer';
+export type { SiteFooterProps, SiteFooterColumn, SiteFooterLink, SiteFooterSocial } from './site-footer';
+//# sourceMappingURL=index.d.ts.map

package/dist/blocks/site-footer/index.d.ts.map

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

package/dist/blocks/site-footer/index.js

@@ -0,0 +1 @@
+export { SiteFooter, default } from './site-footer';

package/dist/blocks/site-footer/site-footer.d.ts

@@ -0,0 +1,135 @@
+import type { ReactNode } from 'react';
+import { type ProductMarkProps } from '../../components/ui/product-mark';
+/**
+ * One destination in a footer column.
+ *
+ * `href` is required. A footer link with no destination is a label, and a column
+ * of labels in a footer reads as a broken page rather than as an omission.
+ */
+export type SiteFooterLink = {
+    /** The text of the link. */
+    label: string;
+    /** Where the link goes. */
+    href: string;
+    /**
+     * Opens the destination in a new browsing context, which defaults the link
+     * relationship to `noopener noreferrer`. Prism does not decide what counts as
+     * external, so the caller declares it.
+     */
+    newTab?: boolean;
+};
+/**
+ * One column of a footer's destinations: a title and the links under it.
+ *
+ * The title is required, because a column of links with no heading is a list
+ * that gives a reader no clue what the group is, and a footer's whole job is to
+ * be scannable rather than read.
+ */
+export type SiteFooterColumn = {
+    /** The heading of the column, which names the group. */
+    title: string;
+    /** The destinations in the group, in the order a reader should meet them. */
+    links: readonly SiteFooterLink[];
+};
+/**
+ * One link out of the site: a destination with an icon beside its label.
+ *
+ * The icon is a `ReactNode` rather than a component name, because the icon is
+ * the consumer's: it is their brand's mark for a destination, not one of a set
+ * Prism owns. The label is still required, because an icon alone is not a
+ * destination a screen reader can announce.
+ */
+export type SiteFooterSocial = {
+    /** The accessible name of the link, and the text beside the icon. */
+    label: string;
+    /** Where the link goes. */
+    href: string;
+    /**
+     * The mark drawn beside the label. `aria-hidden` is applied to it here, so an
+     * icon is a shape beside a word and never a second reading of the word.
+     */
+    icon?: ReactNode;
+    /**
+     * Opens the destination in a new browsing context, which defaults the link
+     * relationship to `noopener noreferrer`. A destination off the site is
+     * declared by the caller, because Prism does not parse URLs.
+     */
+    newTab?: boolean;
+};
+/**
+ * The props a SiteFooter takes.
+ *
+ * The product is required and nothing else is. A footer with no columns, no
+ * social links and no legal line is a valid footer: it is a brand lockup and
+ * nothing else, and one of the four NaniSoft sites is exactly that.
+ */
+export type SiteFooterProps = {
+    /**
+     * The product this footer belongs to: the id, name and pack its `ProductMark`
+     * is drawn from. The footer renders the mark rather than taking a slot,
+     * because the brand lockup is the one part of a footer that is never
+     * product-specific and every consumer would otherwise reimplement it.
+     */
+    product: Pick<ProductMarkProps, 'id' | 'name' | 'pack'>;
+    /**
+     * The groups of destinations: the sections of this site, its documentation, and
+     * anywhere else the site sends a reader. Omit it for a footer that carries only
+     * the brand lockup.
+     */
+    columns?: readonly SiteFooterColumn[];
+    /**
+     * The links that leave the site. A `ReactNode` icon is drawn beside each label
+     * and hidden from assistive technology, so a screen reader announces the label
+     * once.
+     */
+    social?: readonly SiteFooterSocial[];
+    /**
+     * A slot for the line at the foot of the footer: a copyright, a licence, a
+     * version, a legal link. A slot rather than a prop, because every one of those
+     * is a fact about a specific product and about the year it was published, and a
+     * Block that held a year would be a Block that went stale.
+     */
+    legal?: ReactNode;
+    /**
+     * Layout only, exactly as on every Component. Changing a Prism-owned visual
+     * property from here is prohibited.
+     */
+    className?: string;
+};
+/**
+ * The footer of a product site: a brand lockup, grouped destinations, the links
+ * that leave the site, and an optional slot for the legal line.
+ *
+ * It is a Block and not a Component because it is a region of a page: it
+ * composes a `ProductMark` and two sets of links and owns the block they sit in.
+ * All four NaniSoft sites compose this exact footer in their root layout, and
+ * each one wrote its own column model, its own mark and its own current-page
+ * treatment.
+ *
+ * Every string is a prop and the Block ships none. There is no site name, no
+ * copyright, no year, no "built with" line and no default column: a footer that
+ * hardcoded any of them would hand every consumer a claim about a product that
+ * is not theirs and a year that was not this one.
+ *
+ * The columns are a grid that collapses to one column, and the brand lockup
+ * stays above them at every width. A footer read as three columns on a phone is
+ * three unreadable columns; a footer read as one column is a list a reader can
+ * scan, which is the only job a footer has on a narrow viewport.
+ *
+ * Each column is a `nav` with its own accessible name, taken from the column's
+ * title. A reader who navigates by landmark can therefore reach "Documentation"
+ * rather than arriving at one anonymous list of links.
+ *
+ * The social links open in a new browsing context by default, because a link that
+ * leaves the site and comes back is a reader who has lost the page they were on.
+ * That default is a decision this Block makes, and `newTab={false}` on one link
+ * overrides it: Prism does not decide which destinations are external, so the
+ * per-link prop wins over the default rather than the other way round.
+ *
+ * It is a server Component. It fetches nothing, it holds no state, and it
+ * imports no router: a consumer renders it from a server file and the links are
+ * plain anchors the consumer's own router can intercept.
+ */
+export declare function SiteFooter({ product, columns, social, legal, className, }: SiteFooterProps): import("react").JSX.Element;
+export default SiteFooter;
+//# sourceMappingURL=site-footer.d.ts.map

package/dist/blocks/site-footer/site-footer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-footer.d.ts","sourceRoot":"","sources":["../../../src/blocks/site-footer/site-footer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAGrF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,KAAK,EAAE,SAAS,cAAc,EAAE,CAAA;CACjC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;OAKG;IACH,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,CAAA;IACvD;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;IACrC;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;IACpC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,OAAO,EACP,MAAM,EACN,KAAK,EACL,SAAS,GACV,EAAE,eAAe,+BA8DjB;AAED,eAAe,UAAU,CAAA"}

package/dist/blocks/site-footer/site-footer.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ProductMark } from '../../components/ui/product-mark';
+import { cn } from '../../lib/utils';
+/**
+ * The footer of a product site: a brand lockup, grouped destinations, the links
+ * that leave the site, and an optional slot for the legal line.
+ *
+ * It is a Block and not a Component because it is a region of a page: it
+ * composes a `ProductMark` and two sets of links and owns the block they sit in.
+ * All four NaniSoft sites compose this exact footer in their root layout, and
+ * each one wrote its own column model, its own mark and its own current-page
+ * treatment.
+ *
+ * Every string is a prop and the Block ships none. There is no site name, no
+ * copyright, no year, no "built with" line and no default column: a footer that
+ * hardcoded any of them would hand every consumer a claim about a product that
+ * is not theirs and a year that was not this one.
+ *
+ * The columns are a grid that collapses to one column, and the brand lockup
+ * stays above them at every width. A footer read as three columns on a phone is
+ * three unreadable columns; a footer read as one column is a list a reader can
+ * scan, which is the only job a footer has on a narrow viewport.
+ *
+ * Each column is a `nav` with its own accessible name, taken from the column's
+ * title. A reader who navigates by landmark can therefore reach "Documentation"
+ * rather than arriving at one anonymous list of links.
+ *
+ * The social links open in a new browsing context by default, because a link that
+ * leaves the site and comes back is a reader who has lost the page they were on.
+ * That default is a decision this Block makes, and `newTab={false}` on one link
+ * overrides it: Prism does not decide which destinations are external, so the
+ * per-link prop wins over the default rather than the other way round.
+ *
+ * It is a server Component. It fetches nothing, it holds no state, and it
+ * imports no router: a consumer renders it from a server file and the links are
+ * plain anchors the consumer's own router can intercept.
+ */
+export function SiteFooter({ product, columns, social, legal, className, }) {
+    return (_jsx("footer", { "data-slot": "site-footer", className: cn('border-border bg-background w-full border-t', className), children: _jsxs("div", { className: "mx-auto flex w-full max-w-6xl flex-col gap-10 px-6 py-12 lg:px-8", children: [_jsxs("div", { className: "flex flex-col gap-10 md:flex-row md:justify-between", children: [_jsxs("div", { className: "flex flex-col gap-4", children: [_jsx(ProductMark, { id: product.id, name: product.name, pack: product.pack, size: "lg" }), social && social.length > 0 ? (_jsx("ul", { className: "flex flex-wrap items-center gap-4", children: social.map((link) => (_jsx("li", { children: _jsxs("a", { href: link.href, rel: link.newTab === false ? undefined : 'noopener noreferrer', target: link.newTab === false ? undefined : '_blank', className: "text-muted-foreground hover:text-foreground inline-flex items-center gap-2 rounded-sm text-sm font-medium transition-colors duration-fast ease-out", children: [link.icon ? (_jsx("span", { "aria-hidden": true, className: "inline-flex items-center", children: link.icon })) : null, link.label] }) }, link.href))) })) : null] }), columns && columns.length > 0 ? (_jsx("div", { className: "grid gap-8 sm:grid-cols-2 lg:grid-cols-3", children: columns.map((column) => (_jsxs("nav", { "aria-label": column.title, className: "flex flex-col gap-3", children: [_jsx("h2", { className: "text-sm font-semibold", children: column.title }), _jsx("ul", { className: "flex flex-col gap-2", children: column.links.map((link) => (_jsx("li", { children: _jsx("a", { href: link.href, rel: link.newTab ? 'noopener noreferrer' : undefined, target: link.newTab ? '_blank' : undefined, className: "text-muted-foreground hover:text-foreground rounded-sm text-sm transition-colors duration-fast ease-out", children: link.label }) }, link.href))) })] }, column.title))) })) : null] }), legal ? _jsx("div", { className: "text-muted-foreground text-sm", children: legal }) : null] }) }));
+}
+export default SiteFooter;

package/dist/blocks/site-header/index.d.ts

@@ -0,0 +1,3 @@
+export { SiteHeader, default } from './site-header';
+export type { SiteHeaderProps, SiteHeaderLink } from './site-header';
+//# sourceMappingURL=index.d.ts.map

package/dist/blocks/site-header/index.d.ts.map

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

package/dist/blocks/site-header/index.js

@@ -0,0 +1 @@
+export { SiteHeader, default } from './site-header';

package/dist/blocks/site-header/site-header.d.ts

@@ -0,0 +1,142 @@
+import type { ReactNode } from 'react';
+import { type SwitcherProduct } from '../../components/ui/product-switcher';
+import { type ProductMarkProps } from '../../components/ui/product-mark';
+/**
+ * One destination in the header's own navigation.
+ *
+ * `href` is required and `current` is opt-in. The header marks the current page
+ * with `aria-current="page"` rather than with a colour, so a link's state is
+ * carried by the attribute every assistive technology already reads and a reader
+ * who cannot see the colour still knows where they are.
+ */
+export type SiteHeaderLink = {
+    /** The text of the link. */
+    label: string;
+    /** Where the link goes. */
+    href: string;
+    /**
+     * Marks this link as the page the reader is on. Set it on the one link whose
+     * destination is the current route; leave it off every other link.
+     */
+    current?: boolean;
+    /**
+     * Opens the destination in a new browsing context, which defaults the link
+     * relationship to `noopener noreferrer`. Prism does not decide what counts as
+     * external: a cross-origin destination is not by itself a reason to open a tab.
+     */
+    newTab?: boolean;
+};
+/**
+ * The props a SiteHeader takes.
+ *
+ * There is no product directory in this package, so the product the header is on
+ * is passed as the three facts its mark is drawn from rather than as an id this
+ * package would have to resolve. That is the same answer `ProductMark` gives,
+ * and for the same reason: a consumer that composes a set of its own products
+ * composes the header too.
+ *
+ * The product is the only required field but one. A header with no navigation, no
+ * switcher and no actions is a valid header: it is a brand lockup and nothing
+ * else, and one of the four NaniSoft sites is exactly that.
+ */
+export type SiteHeaderProps = {
+    /**
+     * The product this header belongs to: the id, name and pack its `ProductMark`
+     * is drawn from. The header renders the mark itself rather than a slot, because
+     * a header whose brand lockup is a slot is a header every consumer has to
+     * reimplement, and that is the one part of a site header that is never
+     * product-specific.
+     */
+    product: Pick<ProductMarkProps, 'id' | 'name' | 'pack'>;
+    /**
+     * The set of products to move between, rendered as a `ProductSwitcher` between
+     * the mark and the navigation. Omit it on a site that is the only product, and
+     * pass it on a site that is one of several. A set of one renders one mark, so
+     * pass nothing rather than a switcher with a single member.
+     */
+    products?: readonly SwitcherProduct[];
+    /**
+     * The header's own destinations: the sections of this site. Omit it for a
+     * header that carries only the brand lockup.
+     */
+    nav?: readonly SiteHeaderLink[];
+    /**
+     * The accessible name of the site navigation, which is also the visible word a
+     * screen reader announces before the list.
+     *
+     * It is required rather than defaulted because it is a word a reader hears, and
+     * a Block that ships no copy ships no reader-facing copy either. A header that
+     * defaulted this would put its own name on every consumer's site navigation, and
+     * "Site" is right for a company site and wrong for a product that has a docs
+     * section it wants called something else.
+     */
+    navLabel: string;
+    /**
+     * The accessible name of the product switcher. Required whenever `products` is
+     * passed, for the same reason `navLabel` is: it is a word a reader hears, and a
+     * Block that ships no copy ships none of those either. Omit it and the switcher
+     * takes the site navigation's name, which is right when the two are the same set
+     * of places and wrong when they are not.
+     */
+    productsLabel?: string;
+    /**
+     * A slot for the controls a product owns on the right: an account menu, a sign
+     * in link, a mode toggle, a theme picker. A slot rather than a prop, because
+     * every one of those is application state and none of them is a fact a header
+     * can be told.
+     */
+    actions?: ReactNode;
+    /**
+     * Keeps the header at the top of the viewport as the page scrolls. Off by
+     * default, because a sticky header is a decision about a page rather than about
+     * a header, and a header that is sticky on a page with no scroll costs the
+     * reader a strip of their viewport.
+     */
+    sticky?: boolean;
+    /**
+     * Layout only, exactly as on every Component. Changing a Prism-owned visual
+     * property from here is prohibited.
+     */
+    className?: string;
+};
+/**
+ * The header of a product site: a brand lockup, an optional product switcher, the
+ * site's own navigation and an optional slot for application controls.
+ *
+ * It is a Block and not a Component because it is a region of a page rather than
+ * a control: it composes a `ProductMark`, a `ProductSwitcher` and a set of
+ * links, and it owns the bar they sit in. All four NaniSoft sites compose this
+ * exact bar in their root layout, and each one wrote its own: the mark in one
+ * place, the switcher in a popover in another, the navigation in a third, and
+ * each wrote the focus and current-page wiring separately.
+ *
+ * Every string is a prop and the Block ships none. There is no site name, no
+ * default navigation, no "sign in" and no product list: a header that hardcoded
+ * any of them would hand every consumer a claim about a product that is not
+ * theirs, which is the defect this Block exists to remove.
+ *
+ * The bar is one flex row that wraps. The brand lockup and the actions hold
+ * their ends, the switcher and the navigation sit in the middle and wrap onto a
+ * second line rather than overflowing, so a narrow viewport gets a taller header
+ * and never a clipped one. The brand lockup is the one element that never
+ * wraps: a wordmark broken across two lines is not a wordmark.
+ *
+ * The navigation is a `nav` with an accessible name and the switcher is a second
+ * `nav`, because a reader who navigates by landmark needs two regions rather than
+ * one region with two lists in it. The actions slot is not a region at all: it is
+ * whatever the consumer composed, and wrapping it in a landmark would be a claim
+ * about content this Block does not own.
+ *
+ * The bottom hairline is `border-border`, so the bar separates from the page by
+ * a line rather than by a fill change, which is how every surface in this system
+ * is separated: in the base pack `background` and `card` resolve to the same
+ * value, so a fill is not available as a separator.
+ *
+ * It is a server Component. It fetches nothing, it holds no state, and a page
+ * that renders it in a server file needs nothing from the provider mounted: the
+ * pack it wears is the pack of whatever boundary is above it, which is the
+ * mechanism the whole system uses.
+ */
+export declare function SiteHeader({ product, products, nav, navLabel, productsLabel, actions, sticky, className, }: SiteHeaderProps): import("react").JSX.Element;
+export default SiteHeader;
+//# sourceMappingURL=site-header.d.ts.map

package/dist/blocks/site-header/site-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-header.d.ts","sourceRoot":"","sources":["../../../src/blocks/site-header/site-header.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAGrF;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;;OAMG;IACH,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC,CAAA;IACvD;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IACrC;;;OAGG;IACH,GAAG,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;IAC/B;;;;;;;;;OASG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,QAAQ,EACR,GAAG,EACH,QAAQ,EACR,aAAa,EACb,OAAO,EACP,MAAc,EACd,SAAS,GACV,EAAE,eAAe,+BA+CjB;AAED,eAAe,UAAU,CAAA"}

package/dist/blocks/site-header/site-header.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ProductSwitcher, } from '../../components/ui/product-switcher';
+import { ProductMark } from '../../components/ui/product-mark';
+import { cn } from '../../lib/utils';
+/**
+ * The header of a product site: a brand lockup, an optional product switcher, the
+ * site's own navigation and an optional slot for application controls.
+ *
+ * It is a Block and not a Component because it is a region of a page rather than
+ * a control: it composes a `ProductMark`, a `ProductSwitcher` and a set of
+ * links, and it owns the bar they sit in. All four NaniSoft sites compose this
+ * exact bar in their root layout, and each one wrote its own: the mark in one
+ * place, the switcher in a popover in another, the navigation in a third, and
+ * each wrote the focus and current-page wiring separately.
+ *
+ * Every string is a prop and the Block ships none. There is no site name, no
+ * default navigation, no "sign in" and no product list: a header that hardcoded
+ * any of them would hand every consumer a claim about a product that is not
+ * theirs, which is the defect this Block exists to remove.
+ *
+ * The bar is one flex row that wraps. The brand lockup and the actions hold
+ * their ends, the switcher and the navigation sit in the middle and wrap onto a
+ * second line rather than overflowing, so a narrow viewport gets a taller header
+ * and never a clipped one. The brand lockup is the one element that never
+ * wraps: a wordmark broken across two lines is not a wordmark.
+ *
+ * The navigation is a `nav` with an accessible name and the switcher is a second
+ * `nav`, because a reader who navigates by landmark needs two regions rather than
+ * one region with two lists in it. The actions slot is not a region at all: it is
+ * whatever the consumer composed, and wrapping it in a landmark would be a claim
+ * about content this Block does not own.
+ *
+ * The bottom hairline is `border-border`, so the bar separates from the page by
+ * a line rather than by a fill change, which is how every surface in this system
+ * is separated: in the base pack `background` and `card` resolve to the same
+ * value, so a fill is not available as a separator.
+ *
+ * It is a server Component. It fetches nothing, it holds no state, and a page
+ * that renders it in a server file needs nothing from the provider mounted: the
+ * pack it wears is the pack of whatever boundary is above it, which is the
+ * mechanism the whole system uses.
+ */
+export function SiteHeader({ product, products, nav, navLabel, productsLabel, actions, sticky = false, className, }) {
+    return (_jsx("header", { "data-slot": "site-header", className: cn('border-border bg-background w-full border-b', sticky && 'sticky top-0 z-30', className), children: _jsxs("div", { className: "mx-auto flex w-full max-w-6xl flex-wrap items-center gap-x-6 gap-y-3 px-6 py-3 lg:px-8", children: [_jsx("a", { href: "/", className: "flex shrink-0 items-center rounded-sm", children: _jsx(ProductMark, { id: product.id, name: product.name, pack: product.pack, size: "md" }) }), products && products.length > 0 ? (_jsx(ProductSwitcher, { products: products, currentId: product.id, size: "sm", label: productsLabel ?? navLabel })) : null, nav && nav.length > 0 ? (_jsx("nav", { "aria-label": navLabel, className: "flex flex-wrap items-center gap-x-5 gap-y-2", children: nav.map((link) => (_jsx("a", { href: link.href, "aria-current": link.current ? 'page' : undefined, rel: link.newTab ? 'noopener noreferrer' : undefined, target: link.newTab ? '_blank' : undefined, className: "text-muted-foreground hover:text-foreground rounded-sm text-sm font-medium transition-colors duration-fast ease-out", children: link.label }, link.href))) })) : null, actions ? (_jsx("div", { className: "ms-auto flex items-center gap-3", children: actions })) : null] }) }));
+}
+export default SiteHeader;

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

@@ -0,0 +1,3 @@
+export { StackGrid01, default } from './stack-grid';
+export type { StackGrid01Props, StackPart, StackOwn } from './stack-grid';
+//# sourceMappingURL=index.d.ts.map

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

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

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

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