@nadicodeai/ui 12.1.95 → 12.1.97

package/dist/components/approval-row.js

@@ -3,11 +3,24 @@ import { Item, ItemActions, ItemContent, ItemDescription, ItemMedia, ItemTitle,
 /**
  * One thing waiting for a person's yes: a mark for what is asking, the request
  * in one sentence, what happened underneath it, and the single action that
- * clears it. It is a row and not a card, because an approval is one of a list
- * and the list is read top to bottom; put several in an `ItemGroup`.
+ * clears it.
+ *
+ * It is a row and not a card, because an approval is one of a list and the list
+ * is read top to bottom; put several in an `ItemGroup`.
  *
  * The row says what waits and offers the yes. Who may say it, what it changes
  * and what happens after belong to the product that mounts it.
+ *
+ * @family Data
+ * @when Each request in a list of approvals: a mark for what is asking, the request in one
+ * sentence, what happened, and the one action that clears it.
+ * @instead A record's state is a `StatusBadge`. A notice about a condition is `NoticeBanner`. An
+ * Agent's question inside a conversation belongs to the conversation.
+ * @behaviour An outline `Item` at the small size; several sit in an `ItemGroup`. A `failed`
+ * description is announced.
+ * @words The title is the request as a sentence; the action is its yes as verb and noun: *Approve
+ * payment*.
+ * @access A `listitem`; a failed description is `role="alert"`.
  */
 export function ApprovalRow({ action, description, failed, media, title, ...props }) {
     return (_jsxs(Item, { role: "listitem", size: "sm", variant: "outline", ...props, children: [media ? _jsx(ItemMedia, { children: media }) : null, _jsxs(ItemContent, { className: "min-w-0", children: [_jsx(ItemTitle, { children: title }), description ? (_jsx(ItemDescription, { ...(failed ? { role: "alert" } : {}), whole: failed, children: description })) : null] }), action ? _jsx(ItemActions, { children: action }) : null] }));

package/dist/components/aspect-ratio.d.ts

@@ -1,3 +1,13 @@
+/**
+ * A box that keeps its width-to-height ratio.
+ *
+ * @family Other
+ * @when A picture or a captured screen that must keep its shape while its width changes.
+ * @instead A fixed-size mark is its own component (`AppMark`, `AgentOrb`).
+ * @behaviour The height follows the width at `ratio`; the content fills it.
+ * @words None of its own.
+ * @access A layout container; the content keeps its own alternative text.
+ */
 declare function AspectRatio({ ratio, className, style, ...props }: React.ComponentProps<"div"> & {
     ratio: number;
 }): import("react").JSX.Element;

package/dist/components/aspect-ratio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aspect-ratio.d.ts","sourceRoot":"","sources":["../../src/components/aspect-ratio.tsx"],"names":[],"mappings":"AAEA,iBAAS,WAAW,CAAC,EACnB,KAAK,EACL,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,+BAcjD;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"aspect-ratio.d.ts","sourceRoot":"","sources":["../../src/components/aspect-ratio.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,iBAAS,WAAW,CAAC,EACnB,KAAK,EACL,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,+BAejD;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/components/aspect-ratio.js

@@ -1,7 +1,19 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { cn } from "../lib/utils.js";
+/**
+ * A box that keeps its width-to-height ratio.
+ *
+ * @family Other
+ * @when A picture or a captured screen that must keep its shape while its width changes.
+ * @instead A fixed-size mark is its own component (`AppMark`, `AgentOrb`).
+ * @behaviour The height follows the width at `ratio`; the content fills it.
+ * @words None of its own.
+ * @access A layout container; the content keeps its own alternative text.
+ */
 function AspectRatio({ ratio, className, style, ...props }) {
-    return (_jsx("div", { "data-slot": "aspect-ratio", style: {
+    return (_jsx("div", { "data-slot": "aspect-ratio", 
+        // SAFETY: CSSProperties lists only standard properties; React sets each `--` custom property key here through style.setProperty.
+        style: {
             ...style,
             "--ratio": ratio,
         }, className: cn("relative aspect-(--ratio)", className), ...props }));

package/dist/components/avatar.d.ts

@@ -1,5 +1,20 @@
 import * as React from "react";
 import { Avatar as AvatarPrimitive } from "@base-ui/react/avatar";
+/**
+ * A person or a team: their picture, else their initials.
+ *
+ * @family Status
+ * @when A person or a team: the account at the foot of the sidebar, a member list, who changed
+ * something. The picture stands in for a person's own photo.
+ * @instead An Agent is always its `AgentOrb`, never an avatar. A company is its initials in a 6 px
+ * tile inside `RecordIdentity`.
+ * @behaviour A picture that fails falls back to initials, then to the person glyph while the owner
+ * is unknown; never blank. A group overlaps 8 px with a 2 px ring of the ground. The profile's 80
+ * px upload button is `AvatarUploadButton`.
+ * @words Two uppercase initials from the name, else from the email. The overflow is a count: *+2*.
+ * @access Beside a visible name it is `aria-hidden`. Alone, its alt is the person's name. A group
+ * is labelled: *5 members*.
+ */
 declare function Avatar({ className, size, ...props }: AvatarPrimitive.Root.Props & {
     size?: "default" | "sm" | "lg";
 }): React.JSX.Element;

package/dist/components/avatar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"avatar.d.ts","sourceRoot":"","sources":["../../src/components/avatar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQlE,iBAAS,MAAM,CAAC,EACd,SAAS,EACT,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK,GAAG;IAC9B,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;CAChC,qBAYA;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK,qBAQxE;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,KAAK,qBAW9E;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,qBAczE;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAYxE;AAED,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW7E;AAED,iBAAS,kBAAkB,CAAC,EAC1B,KAAK,EACL,YAAY,EACZ,GAAG,EACH,QAAQ,EACR,IAAY,EACZ,OAAO,GACR,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,qBA0BA;AAED,OAAO,EACL,MAAM,EACN,WAAW,EACX,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,kBAAkB,GACnB,CAAC"}
+{"version":3,"file":"avatar.d.ts","sourceRoot":"","sources":["../../src/components/avatar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQlE;;;;;;;;;;;;;;GAcG;AACH,iBAAS,MAAM,CAAC,EACd,SAAS,EACT,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK,GAAG;IAC9B,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;CAChC,qBAYA;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK,qBAQxE;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,CAAC,QAAQ,CAAC,KAAK,qBAW9E;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,qBAczE;AAED,iBAAS,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAYxE;AAED,iBAAS,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAW7E;AAED,iBAAS,kBAAkB,CAAC,EAC1B,KAAK,EACL,YAAY,EACZ,GAAG,EACH,QAAQ,EACR,IAAY,EACZ,OAAO,GACR,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,qBA0BA;AAED,OAAO,EACL,MAAM,EACN,WAAW,EACX,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,kBAAkB,GACnB,CAAC"}

package/dist/components/avatar.js

@@ -4,6 +4,21 @@ import { CameraIcon } from "lucide-react";
 import { Button } from "./button.js";
 import { WaitingLine } from "./waiting-line.js";
 import { cn } from "../lib/utils.js";
+/**
+ * A person or a team: their picture, else their initials.
+ *
+ * @family Status
+ * @when A person or a team: the account at the foot of the sidebar, a member list, who changed
+ * something. The picture stands in for a person's own photo.
+ * @instead An Agent is always its `AgentOrb`, never an avatar. A company is its initials in a 6 px
+ * tile inside `RecordIdentity`.
+ * @behaviour A picture that fails falls back to initials, then to the person glyph while the owner
+ * is unknown; never blank. A group overlaps 8 px with a 2 px ring of the ground. The profile's 80
+ * px upload button is `AvatarUploadButton`.
+ * @words Two uppercase initials from the name, else from the email. The overflow is a count: *+2*.
+ * @access Beside a visible name it is `aria-hidden`. Alone, its alt is the person's name. A group
+ * is labelled: *5 members*.
+ */
 function Avatar({ className, size = "default", ...props }) {
     return (_jsx(AvatarPrimitive.Root, { "data-slot": "avatar", "data-size": size, className: cn("group/avatar relative flex size-8 shrink-0 rounded-full select-none after:absolute after:inset-0 after:rounded-full after:border after:border-border after:mix-blend-darken data-[size=lg]:size-10 data-[size=sm]:size-6", className), ...props }));
 }

package/dist/components/badge.d.ts

@@ -1,8 +1,18 @@
 import { useRender } from "@base-ui/react/use-render";
 import { type VariantProps } from "class-variance-authority";
 declare const badgeVariants: (props?: ({
-    variant?: "link" | "default" | "outline" | "secondary" | "ghost" | "destructive" | "blue" | "gray" | "green" | "pink" | "purple" | "red" | "teal" | "amber" | null | undefined;
+    variant?: "link" | "default" | "outline" | "secondary" | "ghost" | "destructive" | "pink" | "purple" | "teal" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * Short metadata beside its subject: a role, a plan, "Beta".
+ *
+ * @family Status
+ * @when Short metadata beside its subject: a role ("Owner"), a plan, "Beta". 20 px high, 6 px corners, 12 px label at 500. The category fills (teal, purple, pink) name a kind.
+ * @instead For a state use `StatusBadge`, which picks the tone and its mark: the gray, green, red, amber and blue fills are its alone. For one categorical fact in a row use `Tag`. For a change in a figure, `TrendBadge`.
+ * @behaviour A static label. It becomes a link only through `render` with a real anchor, which then takes the hover. Never a click handler, never nested, never a paragraph.
+ * @words One to three words, sentence case, a noun: "Business plan", not "This is on Business".
+ * @access Read in place as text. A coloured variant still carries its word.
+ */
 declare function Badge({ className, variant, render, ...props }: useRender.ComponentProps<"span"> & VariantProps<typeof badgeVariants>): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
 export { Badge, badgeVariants };
 //# sourceMappingURL=badge.d.ts.map

package/dist/components/badge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../src/components/badge.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIlE,QAAA,MAAM,aAAa;;8EA0BlB,CAAC;AAEF,iBAAS,KAAK,CAAC,EACb,SAAS,EACT,OAAmB,EACnB,MAAM,EACN,GAAG,KAAK,EACT,EAAE,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,8FAevE;AAED,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../src/components/badge.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIlE,QAAA,MAAM,aAAa;;8EAqBlB,CAAC;AAEF;;;;;;;;;GASG;AACH,iBAAS,KAAK,CAAC,EACb,SAAS,EACT,OAAmB,EACnB,MAAM,EACN,GAAG,KAAK,EACT,EAAE,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,8FAevE;AAED,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC"}

package/dist/components/badge.js

@@ -11,11 +11,6 @@ const badgeVariants = cva("group/badge inline-flex min-h-5 w-fit max-w-full shri
             outline: "border-border text-foreground [a]:hover:bg-muted [a]:hover:text-muted-foreground",
             ghost: "hover:bg-muted hover:text-muted-foreground",
             link: "text-(--nc-link) underline-offset-4 hover:underline",
-            gray: "bg-accent text-muted-foreground",
-            green: "bg-success-soft text-success-soft-foreground",
-            red: "bg-destructive-soft text-destructive-soft-foreground",
-            amber: "bg-warning-soft text-warning-soft-foreground",
-            blue: "bg-info-soft text-info-soft-foreground",
             teal: "bg-category-teal text-category-teal-foreground",
             purple: "bg-category-purple text-category-purple-foreground",
             pink: "bg-category-pink text-category-pink-foreground",
@@ -25,6 +20,16 @@ const badgeVariants = cva("group/badge inline-flex min-h-5 w-fit max-w-full shri
         variant: "default",
     },
 });
+/**
+ * Short metadata beside its subject: a role, a plan, "Beta".
+ *
+ * @family Status
+ * @when Short metadata beside its subject: a role ("Owner"), a plan, "Beta". 20 px high, 6 px corners, 12 px label at 500. The category fills (teal, purple, pink) name a kind.
+ * @instead For a state use `StatusBadge`, which picks the tone and its mark: the gray, green, red, amber and blue fills are its alone. For one categorical fact in a row use `Tag`. For a change in a figure, `TrendBadge`.
+ * @behaviour A static label. It becomes a link only through `render` with a real anchor, which then takes the hover. Never a click handler, never nested, never a paragraph.
+ * @words One to three words, sentence case, a noun: "Business plan", not "This is on Business".
+ * @access Read in place as text. A coloured variant still carries its word.
+ */
 function Badge({ className, variant = "default", render, ...props }) {
     return useRender({
         defaultTagName: "span",

package/dist/components/brand-field.d.ts

@@ -7,6 +7,16 @@ import * as React from "react";
  * while the canonical black-and-white paint remains internal to the primitive.
  * It is dark by nature, so it scopes `.dark` and every role and control inside
  * takes its dark value in either theme.
+ *
+ * @family Other
+ * @when A plane of the company's identity on the website or an entry screen, where the brand is the
+ * ground.
+ * @instead A product surface is a `Card` or the page ground. Identity colour as a ground belongs to
+ * the website.
+ * @behaviour Dark by nature: every role and control inside takes its dark value in either theme. No
+ * interaction, state or colour variant.
+ * @words None of its own.
+ * @access A plain container.
  */
 declare function BrandField({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
 export { BrandField };

package/dist/components/brand-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brand-field.d.ts","sourceRoot":"","sources":["../../src/components/brand-field.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;;;;GAQG;AACH,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAQvE;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"brand-field.d.ts","sourceRoot":"","sources":["../../src/components/brand-field.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;;;;;;;;;;;;;;;;;GAkBG;AACH,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAQvE;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/components/brand-field.js

@@ -8,6 +8,16 @@ import { cn } from "../lib/utils.js";
  * while the canonical black-and-white paint remains internal to the primitive.
  * It is dark by nature, so it scopes `.dark` and every role and control inside
  * takes its dark value in either theme.
+ *
+ * @family Other
+ * @when A plane of the company's identity on the website or an entry screen, where the brand is the
+ * ground.
+ * @instead A product surface is a `Card` or the page ground. Identity colour as a ground belongs to
+ * the website.
+ * @behaviour Dark by nature: every role and control inside takes its dark value in either theme. No
+ * interaction, state or colour variant.
+ * @words None of its own.
+ * @access A plain container.
  */
 function BrandField({ className, ...props }) {
     return (_jsx("div", { "data-slot": "brand-field", className: cn(className, "dark bg-nc-identity-ink text-nc-identity-white"), ...props }));

package/dist/components/brand.d.ts

@@ -6,6 +6,20 @@ type BrandLogoProps = Omit<React.ComponentProps<"svg">, "aria-hidden" | "aria-la
 /** The plain n. Use it where the name does not fit. */
 declare function BrandMark({ alt, className, width, height, decoding, ...props }: BrandLogoProps): React.JSX.Element;
 /** The company logo: nadicode in full. Use it wherever the company is named. */
+/**
+ * The company logo: nadicode in full.
+ *
+ * @family Status
+ * @when Wherever the company is named by its logo: the Portal's sidebar, the website's header, a
+ * footer. `BrandMark`, the plain n, where the name does not fit.
+ * @instead A product's own mark (Nadia, Alveare) is that product's. A platform's is `PlatformMark`.
+ * The company named in a sentence is text.
+ * @behaviour The letters take the text colour of what they sit in, so one form serves every ground.
+ * The dot is the logo's own colour, which turns to the brighter cobalt under any dark ancestor.
+ * @words None beyond its name, *nadicode*, written as the glossary defines it.
+ * @access `role="img"` named *nadicode* by default; pass `alt=""` where the name is already beside
+ * it, and it is hidden.
+ */
 declare function BrandWordmark({ alt, className, width, height, decoding, ...props }: BrandLogoProps): React.JSX.Element;
 export { BrandMark, BrandWordmark };
 //# sourceMappingURL=brand.d.ts.map

package/dist/components/brand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../src/components/brand.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,KAAK,cAAc,GAAG,IAAI,CACxB,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAC3B,aAAa,GAAG,YAAY,GAAG,UAAU,GAAG,MAAM,CACnD,GAAG;IACF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;CACpD,CAAC;AAwCF,uDAAuD;AACvD,iBAAS,SAAS,CAAC,EACjB,GAAgB,EAChB,SAAS,EACT,KAAU,EACV,MAAW,EACX,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,cAAc,qBAkBhB;AAED,gFAAgF;AAChF,iBAAS,aAAa,CAAC,EACrB,GAAgB,EAChB,SAAS,EACT,KAAW,EACX,MAAW,EACX,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,cAAc,qBAkBhB;AAED,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../src/components/brand.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,KAAK,cAAc,GAAG,IAAI,CACxB,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAC3B,aAAa,GAAG,YAAY,GAAG,UAAU,GAAG,MAAM,CACnD,GAAG;IACF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;CACpD,CAAC;AAwCF,uDAAuD;AACvD,iBAAS,SAAS,CAAC,EACjB,GAAgB,EAChB,SAAS,EACT,KAAU,EACV,MAAW,EACX,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,cAAc,qBAkBhB;AAED,gFAAgF;AAChF;;;;;;;;;;;;;GAaG;AACH,iBAAS,aAAa,CAAC,EACrB,GAAgB,EAChB,SAAS,EACT,KAAW,EACX,MAAW,EACX,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,cAAc,qBAkBhB;AAED,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC"}

package/dist/components/brand.js

@@ -6,13 +6,13 @@ import { cn } from "../lib/utils.js";
 function accessibilityProps(alt) {
     return alt ? { role: "img", "aria-label": alt } : { "aria-hidden": true };
 }
-const reactSvgAttributeNames = {
-    "stroke-width": "strokeWidth",
-};
+const reactSvgAttributeNames = new Map([
+    ["stroke-width", "strokeWidth"],
+]);
 function renderGeometryNodes(nodes) {
     return nodes.map((node, index) => {
         const attributes = Object.fromEntries(Object.entries(node.attributes).map(([name, value]) => [
-            reactSvgAttributeNames[name] ?? name,
+            reactSvgAttributeNames.get(name) ?? name,
             value,
         ]));
         return React.createElement(node.element, { ...attributes, key: `${node.element}-${index}` }, node.children ? renderGeometryNodes(node.children) : undefined);
@@ -35,6 +35,20 @@ function BrandMark({ alt = "nadicode", className, width = 32, height = 32, decod
     return (_jsx("svg", { "data-slot": "brand-mark", xmlns: "http://www.w3.org/2000/svg", viewBox: geometry.viewBox, width: width, height: height, className: cn("block size-6", className), ...accessibilityProps(alt), ...props, children: renderGeometryNodes(geometry.nodes) }));
 }
 /** The company logo: nadicode in full. Use it wherever the company is named. */
+/**
+ * The company logo: nadicode in full.
+ *
+ * @family Status
+ * @when Wherever the company is named by its logo: the Portal's sidebar, the website's header, a
+ * footer. `BrandMark`, the plain n, where the name does not fit.
+ * @instead A product's own mark (Nadia, Alveare) is that product's. A platform's is `PlatformMark`.
+ * The company named in a sentence is text.
+ * @behaviour The letters take the text colour of what they sit in, so one form serves every ground.
+ * The dot is the logo's own colour, which turns to the brighter cobalt under any dark ancestor.
+ * @words None beyond its name, *nadicode*, written as the glossary defines it.
+ * @access `role="img"` named *nadicode* by default; pass `alt=""` where the name is already beside
+ * it, and it is hidden.
+ */
 function BrandWordmark({ alt = "nadicode", className, width = 137, height = 24, decoding, ...props }) {
     void decoding;
     const geometry = resolved(logoWordmarkGeometry);

package/dist/components/breadcrumb.d.ts

@@ -1,11 +1,29 @@
 import * as React from "react";
 import { useRender } from "@base-ui/react/use-render";
-declare function Breadcrumb({ className, ...props }: React.ComponentProps<"nav">): React.JSX.Element;
+type BreadcrumbProps = Omit<React.ComponentProps<"nav">, "aria-label"> & {
+    /** The path's name in the product's language, such as "Path". */
+    "aria-label": string;
+};
+/**
+ * The top bar's path to the page.
+ *
+ * @family Navigation
+ * @when The top bar of every product page: the sidebar group or the parents, ending at the destination or the object. An object opened from search still shows its parent.
+ * @instead Never a back button in its place. A return link may remember a visit, beside the path, not instead of it. Sibling views are tabs.
+ * @behaviour Ancestors are links in the body colour that turn ink on hover; the current item is ink and not a link. A long path folds its middle into `BreadcrumbEllipsis` and keeps the parent and the current item.
+ * @words The groups' and records' own names, exactly as the sidebar and the record write them. The `aria-label` and the ellipsis's `label` come from the product's catalogue: "Path", "More".
+ * @access A labelled `nav` with an ordered list; the current item has `aria-current="page"`; the chevrons and the ⋯ glyph are hidden, and the folded middle reads its `label`.
+ */
+declare function Breadcrumb({ className, ...props }: BreadcrumbProps): React.JSX.Element;
 declare function BreadcrumbList({ className, ...props }: React.ComponentProps<"ol">): React.JSX.Element;
 declare function BreadcrumbItem({ className, ...props }: React.ComponentProps<"li">): React.JSX.Element;
 declare function BreadcrumbLink({ className, render, ...props }: useRender.ComponentProps<"a">): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
 declare function BreadcrumbPage({ className, ...props }: React.ComponentProps<"span">): React.JSX.Element;
 declare function BreadcrumbSeparator({ children, className, ...props }: React.ComponentProps<"li">): React.JSX.Element;
-declare function BreadcrumbEllipsis({ className, ...props }: React.ComponentProps<"span">): React.JSX.Element;
+declare function BreadcrumbEllipsis({ className, label, ...props }: Omit<React.ComponentProps<"span">, "children"> & {
+    /** What the folded middle reads to a screen reader, such as "More". */
+    label: string;
+}): React.JSX.Element;
+export type { BreadcrumbProps };
 export { Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, BreadcrumbEllipsis, };
 //# sourceMappingURL=breadcrumb.d.ts.map

package/dist/components/breadcrumb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"breadcrumb.d.ts","sourceRoot":"","sources":["../../src/components/breadcrumb.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAKtD,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,qBAIvE;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAW1E;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAQ1E;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,0EAcrF;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,qBAW5E;AAED,iBAAS,mBAAmB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAYzF;AAED,iBAAS,kBAAkB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,qBAahF;AAED,OAAO,EACL,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,CAAC"}
+{"version":3,"file":"breadcrumb.d.ts","sourceRoot":"","sources":["../../src/components/breadcrumb.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAKtD,KAAK,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,GAAG;IACvE,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;;;;GASG;AACH,iBAAS,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,qBAE3D;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAW1E;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAQ1E;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,0EAcrF;AAED,iBAAS,cAAc,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,qBAW5E;AAED,iBAAS,mBAAmB,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAYzF;AAED,iBAAS,kBAAkB,CAAC,EAC1B,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,GAAG;IAClD,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;CACf,qBAWA;AAED,YAAY,EAAE,eAAe,EAAE,CAAC;AAChC,OAAO,EACL,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,CAAC"}

package/dist/components/breadcrumb.js

@@ -3,8 +3,18 @@ import { mergeProps } from "@base-ui/react/merge-props";
 import { useRender } from "@base-ui/react/use-render";
 import { cn } from "../lib/utils.js";
 import { ChevronRightIcon, MoreHorizontalIcon } from "lucide-react";
+/**
+ * The top bar's path to the page.
+ *
+ * @family Navigation
+ * @when The top bar of every product page: the sidebar group or the parents, ending at the destination or the object. An object opened from search still shows its parent.
+ * @instead Never a back button in its place. A return link may remember a visit, beside the path, not instead of it. Sibling views are tabs.
+ * @behaviour Ancestors are links in the body colour that turn ink on hover; the current item is ink and not a link. A long path folds its middle into `BreadcrumbEllipsis` and keeps the parent and the current item.
+ * @words The groups' and records' own names, exactly as the sidebar and the record write them. The `aria-label` and the ellipsis's `label` come from the product's catalogue: "Path", "More".
+ * @access A labelled `nav` with an ordered list; the current item has `aria-current="page"`; the chevrons and the ⋯ glyph are hidden, and the folded middle reads its `label`.
+ */
 function Breadcrumb({ className, ...props }) {
-    return (_jsx("nav", { "aria-label": "breadcrumb", "data-slot": "breadcrumb", className: cn(className), ...props }));
+    return _jsx("nav", { "data-slot": "breadcrumb", className: cn(className), ...props });
 }
 function BreadcrumbList({ className, ...props }) {
     return (_jsx("ol", { "data-slot": "breadcrumb-list", className: cn("flex flex-wrap items-center gap-1.5 text-sm wrap-break-word text-muted-foreground", className), ...props }));
@@ -30,7 +40,7 @@ function BreadcrumbPage({ className, ...props }) {
 function BreadcrumbSeparator({ children, className, ...props }) {
     return (_jsx("li", { "data-slot": "breadcrumb-separator", role: "presentation", "aria-hidden": "true", className: cn("[&>svg]:size-3.5", className), ...props, children: children ?? _jsx(ChevronRightIcon, {}) }));
 }
-function BreadcrumbEllipsis({ className, ...props }) {
-    return (_jsxs("span", { "data-slot": "breadcrumb-ellipsis", role: "presentation", "aria-hidden": "true", className: cn("flex size-5 items-center justify-center [&>svg]:size-4", className), ...props, children: [_jsx(MoreHorizontalIcon, {}), _jsx("span", { className: "sr-only", children: "More" })] }));
+function BreadcrumbEllipsis({ className, label, ...props }) {
+    return (_jsxs("span", { "data-slot": "breadcrumb-ellipsis", className: cn("flex size-5 items-center justify-center [&>svg]:size-4", className), ...props, children: [_jsx(MoreHorizontalIcon, { "aria-hidden": "true" }), _jsx("span", { className: "sr-only", children: label })] }));
 }
 export { Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, BreadcrumbEllipsis, };

package/dist/components/button-group.d.ts

@@ -4,6 +4,27 @@ import { Separator } from "./separator.js";
 declare const buttonGroupVariants: (props?: ({
     orientation?: "horizontal" | "vertical" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * Two or three buttons that share one edge and read as one control.
+ *
+ * @family Actions
+ * @when Two or three buttons that act on one thing and read as one control: an applied filter with
+ * its remove, a pager. A split action (*Download PDF* with its chevron for CSV and Excel) is a
+ * group of a `Button` and a `DropdownMenu` trigger.
+ * @instead Choosing one value of several is a `RadioGroup` drawn as a segmented control, or a
+ * `ToggleGroup`. Unrelated actions stay separate buttons 8 px apart. A destructive command never
+ * sits in a split, neither as the default nor in its menu.
+ * @behaviour One shared edge between members and rounded outer corners only. The focused member
+ * rises above its neighbours so its whole outline shows. Each member keeps its own tab stop. In a
+ * split, the left half runs the default and the chevron opens the menu with the default listed
+ * first and checked.
+ * @words Each member is labelled on its own. The group's name says what it holds: *Status filter*,
+ * *Pages*. A split's default names its variant (*Download PDF*); its chevron names the family:
+ * *More download formats*.
+ * @access `role="group"` with an `aria-label`. An icon member names its action and target: *Remove
+ * filter: Status*. A split's chevron has `aria-haspopup="menu"`, `aria-expanded` and its own
+ * `aria-label`.
+ */
 declare function ButtonGroup({ className, orientation, ...props }: React.ComponentProps<"div"> & VariantProps<typeof buttonGroupVariants>): import("react").JSX.Element;
 declare function ButtonGroupText({ className, render, ...props }: useRender.ComponentProps<"div">): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
 declare function ButtonGroupSeparator({ className, orientation, ...props }: React.ComponentProps<typeof Separator>): import("react").JSX.Element;

package/dist/components/button-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"button-group.d.ts","sourceRoot":"","sources":["../../src/components/button-group.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,QAAA,MAAM,mBAAmB;;8EAexB,CAAC;AAEF,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,WAAW,EACX,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,OAAO,mBAAmB,CAAC,+BAUxE;AAED,iBAAS,eAAe,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,8FAiBxF;AAED,iBAAS,oBAAoB,CAAC,EAC5B,SAAS,EACT,WAAwB,EACxB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,SAAS,CAAC,+BAYxC;AAED,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,eAAe,EAAE,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"button-group.d.ts","sourceRoot":"","sources":["../../src/components/button-group.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,QAAA,MAAM,mBAAmB;;8EAexB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,WAAW,EACX,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,OAAO,mBAAmB,CAAC,+BAUxE;AAED,iBAAS,eAAe,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,8FAiBxF;AAED,iBAAS,oBAAoB,CAAC,EAC5B,SAAS,EACT,WAAwB,EACxB,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,SAAS,CAAC,+BAYxC;AAED,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,eAAe,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/components/button-group.js

@@ -15,6 +15,27 @@ const buttonGroupVariants = cva("flex w-fit items-stretch *:focus-visible:relati
         orientation: "horizontal",
     },
 });
+/**
+ * Two or three buttons that share one edge and read as one control.
+ *
+ * @family Actions
+ * @when Two or three buttons that act on one thing and read as one control: an applied filter with
+ * its remove, a pager. A split action (*Download PDF* with its chevron for CSV and Excel) is a
+ * group of a `Button` and a `DropdownMenu` trigger.
+ * @instead Choosing one value of several is a `RadioGroup` drawn as a segmented control, or a
+ * `ToggleGroup`. Unrelated actions stay separate buttons 8 px apart. A destructive command never
+ * sits in a split, neither as the default nor in its menu.
+ * @behaviour One shared edge between members and rounded outer corners only. The focused member
+ * rises above its neighbours so its whole outline shows. Each member keeps its own tab stop. In a
+ * split, the left half runs the default and the chevron opens the menu with the default listed
+ * first and checked.
+ * @words Each member is labelled on its own. The group's name says what it holds: *Status filter*,
+ * *Pages*. A split's default names its variant (*Download PDF*); its chevron names the family:
+ * *More download formats*.
+ * @access `role="group"` with an `aria-label`. An icon member names its action and target: *Remove
+ * filter: Status*. A split's chevron has `aria-haspopup="menu"`, `aria-expanded` and its own
+ * `aria-label`.
+ */
 function ButtonGroup({ className, orientation, ...props }) {
     return (_jsx("div", { role: "group", "data-slot": "button-group", "data-orientation": orientation, className: cn(buttonGroupVariants({ orientation }), className), ...props }));
 }

package/dist/components/button.d.ts

@@ -11,6 +11,26 @@ declare const buttonClasses: (props?: ({
  * stylesheet: unmerged, the base `border-transparent` hides every outline edge.
  */
 declare function buttonVariants(props?: Parameters<typeof buttonClasses>[0]): string;
+/**
+ * The package's one button: five looks at 36 px, the label naming the result.
+ *
+ * @family Actions
+ * @when A command that changes something or opens a surface. One `default` per surface: the thing
+ * this page or dialog is for.
+ * @instead Going somewhere is a link drawn with `buttonVariants`, and a link inside a sentence is
+ * `TextLink`, blue and underlined. A record's secondary commands go in `ActionMenu`. An on/off
+ * value is a `Switch`.
+ * @behaviour Enter and Space run it. A press settles at 97% scale in 180 ms, except on a trigger
+ * that opens a popup. Disabled is 50% and ignores the pointer, and its reason is written beside it.
+ * On touch the target grows to 44 px while the drawing stays 36. `sm` and `xs` are for a control
+ * nested in dense content, such as a composer or an input group, never for chrome.
+ * @words Sentence case, verb + noun naming the result: *Invite member*, *Remove mailbox*; never OK,
+ * Submit or Confirm. Italian runs about a third longer (*Rimuovi casella*), so a footer leaves room
+ * and a label never wraps.
+ * @access A native `button`, `type="button"` unless it submits. An icon-only button carries an
+ * `aria-label` naming action and target. Focus is the 2 px ink outline at 2 px offset, drawn once
+ * by the base layer, never repainted.
+ */
 declare function Button({ className, variant, size, ...props }: ButtonPrimitive.Props & VariantProps<typeof buttonClasses>): import("react").JSX.Element;
 export { Button, buttonVariants };
 //# sourceMappingURL=button.d.ts.map

package/dist/components/button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../src/components/button.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIlE,QAAA,MAAM,aAAa;;;8EAsClB,CAAC;AAEF;;;;;GAKG;AACH,iBAAS,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAE3E;AAED,iBAAS,MAAM,CAAC,EACd,SAAS,EACT,OAAmB,EACnB,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,eAAe,CAAC,KAAK,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,+BAQ5D;AAED,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../src/components/button.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIlE,QAAA,MAAM,aAAa;;;8EAsClB,CAAC;AAEF;;;;;GAKG;AACH,iBAAS,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAE3E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iBAAS,MAAM,CAAC,EACd,SAAS,EACT,OAAmB,EACnB,IAAgB,EAChB,GAAG,KAAK,EACT,EAAE,eAAe,CAAC,KAAK,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,+BAQ5D;AAED,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC"}

package/dist/components/button.js

@@ -39,6 +39,26 @@ const buttonClasses = cva("group/button inline-flex min-h-touch-target min-w-tou
 function buttonVariants(props) {
     return cn(buttonClasses(props));
 }
+/**
+ * The package's one button: five looks at 36 px, the label naming the result.
+ *
+ * @family Actions
+ * @when A command that changes something or opens a surface. One `default` per surface: the thing
+ * this page or dialog is for.
+ * @instead Going somewhere is a link drawn with `buttonVariants`, and a link inside a sentence is
+ * `TextLink`, blue and underlined. A record's secondary commands go in `ActionMenu`. An on/off
+ * value is a `Switch`.
+ * @behaviour Enter and Space run it. A press settles at 97% scale in 180 ms, except on a trigger
+ * that opens a popup. Disabled is 50% and ignores the pointer, and its reason is written beside it.
+ * On touch the target grows to 44 px while the drawing stays 36. `sm` and `xs` are for a control
+ * nested in dense content, such as a composer or an input group, never for chrome.
+ * @words Sentence case, verb + noun naming the result: *Invite member*, *Remove mailbox*; never OK,
+ * Submit or Confirm. Italian runs about a third longer (*Rimuovi casella*), so a footer leaves room
+ * and a label never wraps.
+ * @access A native `button`, `type="button"` unless it submits. An icon-only button carries an
+ * `aria-label` naming action and target. Focus is the 2 px ink outline at 2 px offset, drawn once
+ * by the base layer, never repainted.
+ */
 function Button({ className, variant = "default", size = "default", ...props }) {
     return (_jsx(ButtonPrimitive, { "data-slot": "button", className: buttonVariants({ variant, size, className }), ...props }));
 }

package/dist/components/calendar.d.ts

@@ -1,6 +1,21 @@
 import * as React from "react";
 import { DayPicker, type DayButton, type Locale } from "react-day-picker";
 import { Button } from "./button.js";
+/**
+ * A month grid for choosing a day or a range of days.
+ *
+ * @family Inputs
+ * @when A date or a window whose day and month matter. A chart or a report's window is one
+ * `DateRangeControl` in its toolbar, which opens this calendar from its *Custom* preset.
+ * @instead A row of range buttons is never drawn; the presets live in one select. A time of day or
+ * a recurring schedule is its own field, not a calendar.
+ * @behaviour The first click starts a range, the second ends it. 28 px days, Monday first in
+ * Italian, ends in ink, today in the muted fill. Arrow keys move by day, Page Up and Down by month.
+ * @words Dates are written in the reader's locale (*7 Oct – 13 Oct*, *7–13 ott*), never the ISO
+ * pair a URL stores.
+ * @access A grid of day buttons, each named with its full date. Focus goes into the grid when it
+ * opens and back to its trigger when it closes, and the chosen range is read out.
+ */
 declare function Calendar({ className, classNames, showOutsideDays, captionLayout, buttonVariant, locale, formatters, components, ...props }: React.ComponentProps<typeof DayPicker> & {
     buttonVariant?: React.ComponentProps<typeof Button>["variant"];
 }): React.JSX.Element;

package/dist/components/calendar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/components/calendar.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAwB,KAAK,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAGhG,OAAO,EAAE,MAAM,EAAkB,MAAM,qBAAqB,CAAC;AAG7D,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,UAAU,EACV,eAAsB,EACtB,aAAuB,EACvB,aAAuB,EACvB,MAAM,EACN,UAAU,EACV,UAAU,EACV,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,SAAS,CAAC,GAAG;IAC1C,aAAa,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC;CAChE,qBA2HA;AAED,iBAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,GAAG,EACH,SAAS,EACT,MAAM,EACN,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,SAAS,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,qBA+BvE;AAED,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/components/calendar.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAwB,KAAK,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAGhG,OAAO,EAAE,MAAM,EAAkB,MAAM,qBAAqB,CAAC;AAG7D;;;;;;;;;;;;;;GAcG;AACH,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,UAAU,EACV,eAAsB,EACtB,aAAuB,EACvB,aAAuB,EACvB,MAAM,EACN,UAAU,EACV,UAAU,EACV,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,SAAS,CAAC,GAAG;IAC1C,aAAa,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC;CAChE,qBA2HA;AAED,iBAAS,iBAAiB,CAAC,EACzB,SAAS,EACT,GAAG,EACH,SAAS,EACT,MAAM,EACN,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,SAAS,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,qBA+BvE;AAED,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/components/calendar.js

@@ -5,6 +5,21 @@ import { DayPicker, getDefaultClassNames } from "react-day-picker";
 import { cn } from "../lib/utils.js";
 import { Button, buttonVariants } from "./button.js";
 import { ChevronLeftIcon, ChevronRightIcon, ChevronDownIcon } from "lucide-react";
+/**
+ * A month grid for choosing a day or a range of days.
+ *
+ * @family Inputs
+ * @when A date or a window whose day and month matter. A chart or a report's window is one
+ * `DateRangeControl` in its toolbar, which opens this calendar from its *Custom* preset.
+ * @instead A row of range buttons is never drawn; the presets live in one select. A time of day or
+ * a recurring schedule is its own field, not a calendar.
+ * @behaviour The first click starts a range, the second ends it. 28 px days, Monday first in
+ * Italian, ends in ink, today in the muted fill. Arrow keys move by day, Page Up and Down by month.
+ * @words Dates are written in the reader's locale (*7 Oct – 13 Oct*, *7–13 ott*), never the ISO
+ * pair a URL stores.
+ * @access A grid of day buttons, each named with its full date. Focus goes into the grid when it
+ * opens and back to its trigger when it closes, and the chosen range is read out.
+ */
 function Calendar({ className, classNames, showOutsideDays = true, captionLayout = "label", buttonVariant = "ghost", locale, formatters, components, ...props }) {
     const defaultClassNames = getDefaultClassNames();
     return (_jsx(DayPicker, { showOutsideDays: showOutsideDays, className: cn("group/calendar bg-background p-2 [--cell-radius:var(--radius-sm)] [--cell-size:var(--spacing-touch-target)] [@media(hover:hover)_and_(pointer:fine)]:[--cell-size:--spacing(7)] in-data-[slot=card-content]:bg-transparent in-data-[slot=popover-content]:bg-transparent", String.raw `rtl:**:[.rdp-button\_next>svg]:rotate-180`, String.raw `rtl:**:[.rdp-button\_previous>svg]:rotate-180`, className), captionLayout: captionLayout, locale: locale, formatters: {

package/dist/components/card-row.d.ts

@@ -2,14 +2,24 @@ import { useRender } from "@base-ui/react/use-render";
 type CardRowColumns = 2 | 3 | 4 | "auto";
 type CardRowFrom = "sm" | "md" | "lg" | "xl";
 /**
- * The row sibling cards sit in. The grid stretches its cells and every direct
- * card child fills the one it lands in, so a shorter card grows to the tallest
- * in the row instead of leaving a ragged bottom edge
- * (`rule/card-row-equal-height`). Below `from` the row is one column, where
- * each card is its own row and stretching means nothing.
+ * The row sibling cards sit in.
+ *
+ * The grid stretches its cells and every direct card child fills the one it
+ * lands in, so a shorter card grows to the tallest in the row instead of
+ * leaving a ragged bottom edge (`rule/card-row-equal-height`). Below `from` the
+ * row is one column, where each card is its own row and stretching means
+ * nothing.
  *
  * Callers pass layout — `columns`, `from`, and a `gap-*` on `className` when
  * the default rhythm is wrong. Appearance stays with `Card`.
+ *
+ * @family Data
+ * @when Two to four sibling cards side by side: the KPIs of an overview, a pair of charts.
+ * @instead A list of records is `Item` or a table. A single card needs no row.
+ * @behaviour One column below `from`, then `columns` columns; `auto` gives each card an equal
+ * share. Each card fills its cell, so the bottom edge is even.
+ * @words None of its own.
+ * @access A layout container; reading order is source order.
  */
 declare function CardRow({ className, columns, from, render, ...props }: useRender.ComponentProps<"div"> & {
     columns?: CardRowColumns;

package/dist/components/card-row.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"card-row.d.ts","sourceRoot":"","sources":["../../src/components/card-row.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAItD,KAAK,cAAc,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;AACzC,KAAK,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAkC7C;;;;;;;;;GASG;AACH,iBAAS,OAAO,CAAC,EACf,SAAS,EACT,OAAW,EACX,IAAW,EACX,MAAM,EACN,GAAG,KAAK,EACT,EAAE,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IACnC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB,8FAgBA;AAED,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,CAAC"}
+{"version":3,"file":"card-row.d.ts","sourceRoot":"","sources":["../../src/components/card-row.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAItD,KAAK,cAAc,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;AACzC,KAAK,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAkC7C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iBAAS,OAAO,CAAC,EACf,SAAS,EACT,OAAW,EACX,IAAW,EACX,MAAM,EACN,GAAG,KAAK,EACT,EAAE,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IACnC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB,8FAgBA;AAED,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,CAAC"}