themelia-ui 2.0.1 → 3.0.0

package/dist/base/spinner.js

@@ -1,3 +1,2 @@
-import "../core.css";
-import { t as e } from "../spinner-Bv-2R-7S.js";
+import { t as e } from "../spinner-CUAVFecI.js";
 export { e as Spinner };

package/dist/base/structure.js

@@ -1,3 +1,2 @@
-import "../core.css";
 import { a as e, i as t, n, o as r, r as i, t as a } from "../structure-D0WGQAP3.js";
 export { i as AdaptiveGrid, a as Bleed, t as Grid, e as GridCell, n as Split, r as Stack };

package/dist/base/table.js

@@ -1,4 +1,3 @@
 "use client";
-import "../core.css";
-import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c, u as l } from "../table-BXL7IP5P.js";
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c, u as l } from "../table-BC4qqsUb.js";
 export { c as Table, i as TableBody, o as TableCaption, n as TableCell, e as TableEmpty, a as TableFooter, s as TableHead, t as TableHeader, r as TableRow, l as defaultTableStrings };

package/dist/base/text-inputs.js

@@ -1,4 +1,3 @@
 "use client";
-import "../core.css";
-import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, r as c, s as l, t as u, u as d } from "../text-inputs-BBpgIQEI.js";
+import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, r as c, s as l, t as u, u as d } from "../text-inputs-DF_lD7pA.js";
 export { l as FieldShell, a as Input, c as NativeSelect, e as PasswordInput, i as SearchInput, u as SlugField, t as Textarea, n as defaultInputStrings, s as defaultPasswordInputStrings, r as defaultSearchInputStrings, o as slugify, d as useFieldValue };

package/dist/base/timeline.js

@@ -1,4 +1,3 @@
 "use client";
-import "../core.css";
-import { n as e, r as t, t as n } from "../timeline-ptWoY2GY.js";
+import { n as e, r as t, t as n } from "../timeline-BdaGRyj-.js";
 export { n as Stepper, t as Timeline, e as defaultStepperStrings };

package/dist/base/toaster.js

@@ -1,4 +1,3 @@
 "use client";
-import "../core.css";
-import { a as e, i as t, n, r, t as i } from "../toaster-DOBJDiXt.js";
+import { a as e, i as t, n, r, t as i } from "../toaster-bBMgXm8z.js";
 export { i as Toaster, r as createToastStore, n as defaultToasterStrings, t as dismissToast, e as toast };

package/dist/base/toggle.js

@@ -1,5 +1,3 @@
-import "../core.css";
-import "../css/toggle.css";
 import { t as e } from "../cx--CBrhWH0.js";
 import { jsx as t } from "react/jsx-runtime";
 import { Toggle as n } from "@base-ui/react/toggle";

package/dist/base/toolbar.js

@@ -1,4 +1,3 @@
 "use client";
-import "../core.css";
-import { a as e, i as t, n, o as r, r as i, t as a } from "../toolbar-3GLSD7Fi.js";
+import { a as e, i as t, n, o as r, r as i, t as a } from "../toolbar-DWRywF0R.js";
 export { a as Toolbar, n as ToolbarButton, i as ToolbarGroup, t as ToolbarInput, e as ToolbarLink, r as ToolbarSeparator };

package/dist/base/tooltip.js

@@ -1,4 +1,3 @@
 "use client";
-import "../core.css";
-import { i as e, n as t, r as n, t as r } from "../tooltip-DksScngC.js";
+import { i as e, n as t, r as n, t as r } from "../tooltip-t1VQQ2tZ.js";
 export { r as Tooltip, t as TooltipContent, n as TooltipProvider, e as TooltipTrigger };

package/dist/base/typography.js

@@ -1,3 +1,2 @@
-import "../core.css";
 import { a as e, i as t, o as n, r, t as i } from "../typography-BkxEiwQ1.js";
 export { t as DisplayLabel, e as Heading, i as RichText, n as Text, r as TextLink };

package/dist/base/upload.js

@@ -1,4 +1,3 @@
 "use client";
-import "../core.css";
-import { _ as e, a as t, c as n, d as r, f as i, g as a, h as o, i as s, l as c, m as l, n as u, o as d, p as f, r as p, s as m, t as h, u as g, v as _, y as v } from "../upload-wTBh4QQx.js";
+import { _ as e, a as t, c as n, d as r, f as i, g as a, h as o, i as s, l as c, m as l, n as u, o as d, p as f, r as p, s as m, t as h, u as g, v as _, y as v } from "../upload-B38YZeFJ.js";
 export { t as AvatarUpload, c as Dropzone, h as FilePickerInput, m as FileUpload, d as ImageUpload, u as MediaGallery, v as PreviewImage, p as UploadProgressList, s as UploadTray, r as defaultAvatarUploadStrings, i as defaultDropzoneStrings, f as defaultFilePickerStrings, _ as defaultFileUploadStrings, l as defaultImageUploadStrings, o as defaultMediaGalleryStrings, a as defaultUploadProgressListStrings, e as defaultUploadTrayStrings, g as useFileDropTarget, n as validateFileSelection };

package/dist/base/value-inputs.js

@@ -1,4 +1,3 @@
 "use client";
-import "../core.css";
-import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, p as c, r as l, s as u, t as d, u as f } from "../value-inputs-DnQKmVqW.js";
+import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, p as c, r as l, s as u, t as d, u as f } from "../value-inputs-Q4ymjXlV.js";
 export { l as COUNTRY_PREFIX_MAP, s as ColorInput, i as DEFAULT_COUNTRY_PREFIXES, d as DateTimeInput, o as PhoneInput, t as Slider, a as SliderField, u as TagsInput, f as defaultColorInputStrings, n as defaultPhoneInputStrings, r as defaultSliderStrings, c as defaultTagsInputStrings, e as normalizeCountryPrefix };

package/dist/{batch-action-bar-CAIjntVw.js → batch-action-bar-BZYNKXdV.js}

@@ -1,7 +1,6 @@
-import "./css/batch-action-bar.css";
 import { t as e } from "./cx--CBrhWH0.js";
 import { o as t } from "./typography-BkxEiwQ1.js";
-import { c as n } from "./buttons-riLAPVQV.js";
+import { c as n } from "./buttons-CqXKWty3.js";
 import { jsx as r, jsxs as i } from "react/jsx-runtime";
 //#region src/components/base/batch-action-bar/batch-action-bar.strings.ts
 var a = {

package/dist/{buttons-riLAPVQV.js → buttons-CqXKWty3.js}

@@ -1,10 +1,9 @@
-import "./css/buttons.css";
 import { t as e } from "./cvm-DtsCA8iZ.js";
 import { t } from "./cx--CBrhWH0.js";
 import { o as n } from "./typography-BkxEiwQ1.js";
 import { t as r } from "./slot-2Jf4M2nC.js";
-import { n as i } from "./ui-provider-gNDv-ZRY.js";
-import { i as a, n as o, t as s } from "./tooltip-DksScngC.js";
+import { n as i } from "./ui-provider-Cmoq6i_D.js";
+import { i as a, n as o, t as s } from "./tooltip-t1VQQ2tZ.js";
 import * as c from "react";
 import { Fragment as l, jsx as u, jsxs as d } from "react/jsx-runtime";
 import { useFormStatus as f } from "react-dom";

package/dist/{cards-CcwLsQQS.js → cards-C6Ulbkw7.js}

@@ -1,14 +1,13 @@
-import "./css/cards.css";
 import { t as e } from "./cvm-DtsCA8iZ.js";
 import { t } from "./cx--CBrhWH0.js";
 import { o as n } from "./typography-BkxEiwQ1.js";
-import { _ as r, h as i } from "./feedback-C8QtkdHc.js";
-import { n as a } from "./ui-provider-gNDv-ZRY.js";
-import { c as o } from "./buttons-riLAPVQV.js";
-import { i as s, n as c, t as l } from "./tooltip-DksScngC.js";
-import { n as u } from "./action-menu-BrMchcyt.js";
+import { _ as r, h as i } from "./feedback-DRerHGuV.js";
+import { n as a } from "./ui-provider-Cmoq6i_D.js";
+import { c as o } from "./buttons-CqXKWty3.js";
+import { i as s, n as c, t as l } from "./tooltip-t1VQQ2tZ.js";
+import { n as u } from "./action-menu-BNLURfMK.js";
 import { o as d } from "./structure-D0WGQAP3.js";
-import { t as f } from "./skeleton-Bxqw8kwa.js";
+import { t as f } from "./skeleton-DGR9df28.js";
 import { ChevronDownIcon as p, ChevronUpIcon as m, InfoIcon as h } from "lucide-react";
 import * as g from "react";
 import { isValidElement as _ } from "react";

package/dist/chart-nomhJ87z.js

@@ -1,4 +1,3 @@
-import "./css/chart.css";
 import { t as e } from "./cx--CBrhWH0.js";
 import * as t from "react";
 import { useId as n } from "react";

package/dist/{choice-inputs-BjZYCdzk.js → choice-inputs-OUDn0kQw.js}

@@ -1,9 +1,8 @@
-import "./css/choice-inputs.css";
 import { t as e } from "./cx--CBrhWH0.js";
 import { o as t } from "./typography-BkxEiwQ1.js";
-import { u as n } from "./ui-provider-gNDv-ZRY.js";
-import { i as r, n as i, t as a } from "./tooltip-DksScngC.js";
-import { d as o } from "./display-Dehpw83R.js";
+import { u as n } from "./ui-provider-Cmoq6i_D.js";
+import { i as r, n as i, t as a } from "./tooltip-t1VQQ2tZ.js";
+import { d as o } from "./display-B3Q17h5z.js";
 import { o as s } from "./structure-D0WGQAP3.js";
 import { t as c } from "./label-DumoMDm6.js";
 import { CheckIcon as l, ChevronDownIcon as u, ChevronUpIcon as d, CircleCheckIcon as f, CircleIcon as p, InfoIcon as m, MinusIcon as h } from "lucide-react";

package/dist/{combobox-exdUS4qj.js → combobox-C8oP92bT.js}

@@ -1,7 +1,6 @@
-import "./css/combobox2.css";
 import { t as e } from "./cx--CBrhWH0.js";
 import { o as t } from "./typography-BkxEiwQ1.js";
-import { u as n } from "./ui-provider-gNDv-ZRY.js";
+import { u as n } from "./ui-provider-Cmoq6i_D.js";
 import { CheckIcon as r, ChevronDownIcon as i, SearchIcon as a, XIcon as o } from "lucide-react";
 import { jsx as s, jsxs as c } from "react/jsx-runtime";
 import { Combobox as l } from "@base-ui/react/combobox";

package/dist/{command-Dv84KSRv.js → command-Bp3B6pUu.js}

@@ -1,8 +1,7 @@
-import "./css/command.css";
 import { t as e } from "./cx--CBrhWH0.js";
-import { o as t, s as n, t as r, u as i } from "./overlay-A5bE-8n5.js";
-import { t as a } from "./dialog-CXugTX8t.js";
-import { n as o, t as s } from "./input-group-xFaO6qrB.js";
+import { o as t, s as n, t as r, u as i } from "./overlay-WQOsLd69.js";
+import { t as a } from "./dialog-CtFCuTUF.js";
+import { n as o, t as s } from "./input-group-BYe0rhoB.js";
 import { CheckIcon as c, SearchIcon as l } from "lucide-react";
 import * as u from "react";
 import { jsx as d, jsxs as f } from "react/jsx-runtime";

package/dist/{comments-CqdhAH1O.js → comments-CAnDlyXO.js}

@@ -1,21 +1,20 @@
-import "./css/comments.css";
 import { t as e } from "./cx--CBrhWH0.js";
 import { a as t, o as n, r, t as i } from "./typography-BkxEiwQ1.js";
-import { p as a } from "./feedback-C8QtkdHc.js";
-import { t as o } from "./ui-provider-gNDv-ZRY.js";
-import { c as s } from "./buttons-riLAPVQV.js";
-import { i as c, n as l, t as u } from "./tooltip-DksScngC.js";
-import { i as d, n as f } from "./action-menu-BrMchcyt.js";
-import { d as p, l as m } from "./display-Dehpw83R.js";
+import { p as a } from "./feedback-DRerHGuV.js";
+import { t as o } from "./ui-provider-Cmoq6i_D.js";
+import { c as s } from "./buttons-CqXKWty3.js";
+import { i as c, n as l, t as u } from "./tooltip-t1VQQ2tZ.js";
+import { i as d, n as f } from "./action-menu-BNLURfMK.js";
+import { d as p, l as m } from "./display-B3Q17h5z.js";
 import { o as h } from "./structure-D0WGQAP3.js";
-import { H as g, I as _, S as v, T as y, h as b, s as x, v as S, w as C } from "./primitives-BnXNg-Kr.js";
-import { t as w } from "./badge-D34FkKLD.js";
-import { a as ee, c as T, r as E } from "./avatar-C30TNJoy.js";
-import { c as D, r as O, t as k } from "./popover-CM1nxkAM.js";
-import { t as te } from "./spinner-Bv-2R-7S.js";
-import { i as ne, t as re } from "./overlays-DX9ux-XL.js";
-import { f as A, i as j, o as ie, s as M, t as ae } from "./mentions-D_b-yVXN.js";
-import { n as oe } from "./rich-text-editor-CgsfAGMo.js";
+import { H as g, I as _, S as v, T as y, h as b, s as x, v as S, w as C } from "./primitives-D0bdDozz.js";
+import { t as w } from "./badge-CxOuTfVr.js";
+import { a as ee, c as T, r as E } from "./avatar-CS7zow2q.js";
+import { c as D, r as O, t as k } from "./popover-DriLnIFc.js";
+import { t as te } from "./spinner-CUAVFecI.js";
+import { i as ne, t as re } from "./overlays-DvVoS3td.js";
+import { f as A, i as j, o as ie, s as M, t as ae } from "./mentions-BbsEHlcH.js";
+import { n as oe } from "./rich-text-editor-BQXFe9oN.js";
 import { AtSignIcon as se, FileIcon as N, FileTextIcon as P, ImageIcon as F, MessageCircleIcon as I, MoreHorizontalIcon as L, PaperclipIcon as ce, PencilIcon as le, PinIcon as ue, SendIcon as de, SmilePlusIcon as R, Trash2Icon as fe, XIcon as pe } from "lucide-react";
 import { Fragment as me, cloneElement as he, createContext as z, useCallback as B, useContext as ge, useEffect as V, useId as _e, useImperativeHandle as ve, useLayoutEffect as ye, useMemo as H, useRef as U, useState as W } from "react";
 import { Fragment as be, jsx as G, jsxs as K } from "react/jsx-runtime";
@@ -705,10 +704,10 @@ function Re(e) {
 	return t.charAt(0).toUpperCase() + t.slice(1);
 }
 function ze(e) {
-	let { format: t, locale: n } = o(), r = S(e);
-	return r ? {
-		iso: r.toISOString(),
-		label: xe(r, `${t} HH:mm`, { locale: n })
+	let { format: t, locale: n, timeFormat: r } = o(), i = S(e);
+	return i ? {
+		iso: i.toISOString(),
+		label: xe(i, `${t} ${r ?? "HH:mm"}`, { locale: n })
 	} : null;
 }
 function Be({ children: t, className: i, buttonRef: a, ...o }) {

package/dist/components/admin/patterns/access/credential-list.d.ts

@@ -12,6 +12,7 @@ export interface Credential {
     disabled?: boolean;
 }
 export interface CredentialListProps extends Omit<ComponentProps<"div">, "children" | "title" | "onCopy"> {
+    /** id, name, value, and `displayValue` for the masked form shown in the row. */
     items: Credential[];
     title?: ReactNode;
     /** Uncontrolled. */
@@ -21,7 +22,7 @@ export interface CredentialListProps extends Omit<ComponentProps<"div">, "childr
     onOpenChange?: (open: boolean) => void;
     /** Omit to hide the add action. */
     onAdd?: () => void;
-    /** Omit to hide the delete entry. The confirmation belongs to the caller. */
+    /** Omit to hide the delete action. The delete confirmation belongs to the caller. */
     onDelete?: (id: string, item: Credential) => void;
     /** Fires after the value reaches the clipboard — for analytics. */
     onCopy?: (id: string, item: Credential) => void;

package/dist/components/admin/patterns/access/role-permissions.d.ts

@@ -14,6 +14,7 @@ export interface RolePermissionsProps extends Omit<ComponentProps<"div">, "child
     roleName: ReactNode;
     description?: ReactNode;
     memberCount?: number;
+    /** Each group names an area and lists its permissions with a granted flag. */
     groups: PermissionGroup[];
     /** Omit to hide the edit action. */
     onEdit?: () => void;

package/dist/components/admin/patterns/access/sensitive-action.d.ts

@@ -3,7 +3,10 @@ import { ContentBlock, IconBadge } from '../../../base/display/index.js';
 export interface SensitiveActionProps extends Omit<ComponentProps<typeof ContentBlock>, "children" | "icon"> {
     /** The control that performs it — usually a destructive Button. */
     action?: ReactNode;
-    /** What will happen, stated before it does. Rendered as a note, not an error. */
+    /**
+     * What will happen, stated before it does. Rendered `role="note"`, not as an error —
+     * nothing has gone wrong yet.
+     */
     confirmation?: ReactNode;
     icon?: ComponentProps<typeof IconBadge>["icon"];
 }

package/dist/components/admin/patterns/commerce/account.d.ts

@@ -58,8 +58,9 @@ export interface InventoryLevelProps extends Omit<ComponentProps<typeof ContentB
     productName: string;
     /** The chosen option, when the product has any. */
     variant?: string;
+    /** Units on hand. Zero reads as out, which is checked before low. */
     stock: number;
-    /** Below this, the level reads as low rather than healthy. */
+    /** At or below this, the level reads as low rather than healthy. */
     reorderLevel: number;
     /** The gauge's upper bound. */
     maxStock: number;

package/dist/components/admin/patterns/commerce/booking.d.ts

@@ -29,6 +29,10 @@ export interface BookingDetail {
 export interface BookingCardProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
     /** A chip, usually — the booking's state. */
     status?: ReactNode;
+    /**
+     * Rendered as a real `<dl>`, so a screen reader pairs each value with its own label. A
+     * `fullWidth` detail spans the row and gets its own ground.
+     */
     details: BookingDetail[];
     actionLabel?: ReactNode;
     onAction?: () => void;

package/dist/components/admin/patterns/commerce/cart.d.ts

@@ -47,9 +47,9 @@ export interface Discount {
     /**
      * What kind of discount it is — "Code", "Automatic", "Volume".
      *
-     * Rendered as a quiet qualifier beside the label, not as a chip. A Badge here was the
-     * first thing tried and it failed contrast at 3.45:1 in the dark theme: a chip is drawn
-     * to sit on a card, and the ledger it lands in has its own tinted ground under it.
+     * Rendered as a quiet qualifier beside the label, not as a chip. A chip is drawn to sit on
+     * a card, and the ledger it would land in has its own tinted ground: a Badge here fails
+     * contrast in the dark theme (3.45:1).
      */
     kind?: ReactNode;
     amount: string;
@@ -61,25 +61,22 @@ export interface DiscountStackProps extends Omit<ComponentProps<typeof ContentBl
     strings?: Partial<DiscountStackStrings>;
 }
 export declare function DiscountStack({ discounts, totalSavings, strings, className, ...props }: DiscountStackProps): import("react").JSX.Element;
-/**
- * CodeEntry — a discount code or a gift card.
- *
- * These were two components, and they were the same component twice: a title, a field, a
- * button, and an applied state. The only real difference is that a gift card holds a
- * BALANCE — money that may outlast this order — where a discount either applies or does
- * not. That is one optional prop, not a second component.
- *
- * `kind` picks the preset: the icon, the default copy, and whether the code is upper-cased
- * on submit. Gift card codes are printed in capitals and nobody types them that way.
- */
+/** Which preset a CodeEntry takes: a discount code or a gift card. */
 export type CodeEntryKind = "discount" | "gift";
 export interface CodeEntryProps extends Omit<ComponentProps<typeof ContentBlock>, "children" | "onSubmit"> {
+    /**
+     * Picks the preset: the icon, the default copy, and whether the code is upper-cased on
+     * submit. Gift card codes are printed in capitals and nobody types them that way.
+     */
     kind?: CodeEntryKind;
     /** The code in force. Present switches the card to its applied state. */
     appliedCode?: string;
     /** What it took off, already formatted. */
     appliedDiscount?: string;
-    /** What is left on the card, already formatted. Gift cards only. */
+    /**
+     * What is left on the card, already formatted — money that may outlast this order, and
+     * the one real difference between the two kinds. Gift cards only.
+     */
     balance?: string;
     /** A rejection message, shown under the field. */
     error?: string;
@@ -88,4 +85,10 @@ export interface CodeEntryProps extends Omit<ComponentProps<typeof ContentBlock>
     onRemove?: () => void;
     strings?: Partial<CodeEntryStrings>;
 }
+/**
+ * A discount code or a gift card. One component for both: a title, a field, a button, and
+ * an applied state. The only real difference is that a gift card holds a BALANCE — money
+ * that may outlast this order — where a discount either applies or does not. That is one
+ * optional prop, not a second component.
+ */
 export declare function CodeEntry({ kind, appliedCode, appliedDiscount, balance, error, loading, onApply, onRemove, strings, className, ...props }: CodeEntryProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/commerce.types.d.ts

@@ -12,8 +12,8 @@ export declare const SHIPMENT_STATUS_TONE: Record<ShipmentStatus, BadgeTone>;
 export type RefundStage = "requested" | "approved" | "processing" | "completed";
 export declare const REFUND_STAGES: readonly RefundStage[];
 /**
- * Card networks and wallets. The brand is named, never painted: trademark colours would
- * need literals `verify composition` forbids. Pass a logo as `icon`.
+ * Card networks and wallets. The brand is named, never painted: the kit draws no trademark
+ * colours. Pass a logo as `icon`.
  */
 export type PaymentBrand = "visa" | "mastercard" | "amex" | "paypal" | "applePay" | "googlePay" | "unknown";
 /** What an address is for. */

package/dist/components/admin/patterns/commerce/inventory-section.d.ts

@@ -24,13 +24,25 @@ export type InventorySectionField = keyof InventorySectionValue;
 /** Which groups to draw. Omit for all of them. */
 export type InventorySectionName = "summary" | "identity" | "tracking" | "location" | "shipping" | "customs" | "tags";
 export interface InventorySectionProps extends Omit<ComponentProps<typeof ContentBlock>, "children" | "onChange"> {
+    /**
+     * The record: sku, barcode, trackQuantity, available, committed, incoming,
+     * lowStockThreshold, inventoryPolicy, binLocation, requiresShipping, weight,
+     * countryOfOrigin, hsCode, tags.
+     */
     value: InventorySectionValue;
-    /** Reports the field, its new value, and what it replaced. Omit for a read-only record. */
+    /**
+     * Reports the field, its new value, and what it replaced — an undo stack that has to
+     * remember that itself is one that gets it wrong once. Omit for a read-only record.
+     */
     onFieldChange?: (change: {
         field: InventorySectionField;
         value: InventorySectionValue[InventorySectionField];
         previousValue: InventorySectionValue[InventorySectionField];
     }) => void;
+    /**
+     * Narrows what is drawn, so one surface serves a simple product, a variant and a location
+     * record without forking. Every section by default.
+     */
     sections?: InventorySectionName[];
     strings?: Partial<InventorySectionStrings>;
 }

package/dist/components/admin/patterns/commerce/loyalty.d.ts

@@ -15,8 +15,12 @@ export interface LoyaltyMovement {
 export interface LoyaltyPointsProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
     /** A number gets locale grouping; a string is taken as already formatted. */
     balance: number | string;
-    /** The tier's name. A caller's word, so there is no English default to leak. */
+    /**
+     * The tier's name. There is no default: it is a caller's word, and an English literal
+     * here is one no strings override could reach.
+     */
     tier?: ReactNode;
+    /** The tier badge's tone. */
     tierTone?: BadgeTone;
     movements?: LoyaltyMovement[];
     onRedeem?: () => void;

package/dist/components/admin/patterns/commerce/order-detail.d.ts

@@ -7,9 +7,12 @@ import { FulfillmentStatus, PaymentStatus } from './commerce.types.js';
 import { OrderLine } from './order-line-item.js';
 export interface OrderHeaderProps extends Omit<ComponentProps<"div">, "children"> {
     orderNumber: string;
-    /** Where the goods are. */
+    /** Where the goods are. Independent of payment. */
     fulfillmentStatus?: FulfillmentStatus;
-    /** Where the money is. */
+    /**
+     * Where the money is. Both statuses, one, or neither reads correctly — an order with
+     * nothing to ship has no fulfillment state to state.
+     */
     paymentStatus?: PaymentStatus;
     /** Already formatted. */
     placedAt?: string;
@@ -17,6 +20,7 @@ export interface OrderHeaderProps extends Omit<ComponentProps<"div">, "children"
     source?: string;
     actions?: ActionDefinition[];
     strings?: Partial<OrderHeaderStrings>;
+    /** Overrides the words for either axis without touching the tones, which stay derived. */
     vocabulary?: Partial<OrderStatusVocabulary>;
 }
 export declare function OrderHeader({ orderNumber, fulfillmentStatus, paymentStatus, placedAt, source, actions, strings, vocabulary, className, ...props }: OrderHeaderProps): import("react").JSX.Element;
@@ -26,12 +30,23 @@ export interface FulfillmentGroupProps extends Omit<ComponentProps<"div">, "chil
     location?: ReactNode;
     /** A standing fact about the group — "Shipping not required". */
     notice?: ReactNode;
-    /** The glyph beside the notice. A component, so the group sizes it. */
+    /**
+     * The glyph beside the notice. A component rather than a node, so the group sizes it:
+     * one passed as a child arrives at lucide's own 24px default — three lines tall against
+     * the text it annotates.
+     */
     noticeIcon?: LucideIcon;
+    /** The rows, as data. */
     items?: OrderLine[];
-    /** Overrides `items` entirely, for a caller who needs the rows themselves. */
+    /**
+     * Replaces `items` wholesale, for a caller who needs control of a row — the same seam
+     * Accordion offers.
+     */
     children?: ReactNode;
-    /** The first renders as a button; the rest collapse into an overflow menu. */
+    /**
+     * The first renders as a button; the rest collapse into an overflow menu. One array, so
+     * the menu cannot duplicate the button.
+     */
     actions?: ActionDefinition[];
     strings?: Partial<FulfillmentGroupStrings>;
     vocabulary?: Partial<OrderStatusVocabulary>;
@@ -40,7 +55,7 @@ export declare function FulfillmentGroup({ status, location, notice, noticeIcon:
 export interface SummaryLine {
     id?: string;
     label: ReactNode;
-    /** A middle column — "3 items", "20%". */
+    /** A middle column — "3 items", "20%" — so counts and rates align down a stack. */
     note?: ReactNode;
     /** Already formatted, including its currency. */
     amount: string;
@@ -48,14 +63,21 @@ export interface SummaryLine {
     deduction?: boolean;
 }
 export interface OrderSummaryProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
-    /** What was ordered — subtotal, discount, shipping, tax. */
+    /**
+     * What was ordered — subtotal, discount, shipping, tax. Goods and payments render as
+     * separate panels, and a line's `note` is a middle column, so counts and rates align down
+     * a stack.
+     */
     goods: SummaryLine[];
     /** The line the eye should land on. */
     total: SummaryLine;
-    /** What has actually moved — paid, refunded, balance. */
+    /** What has actually moved — paid, refunded, balance. A separate panel from the goods. */
     payments?: SummaryLine[];
     paymentStatus?: PaymentStatus;
-    /** A standing caveat about the balance, not an error. */
+    /**
+     * Standing information about the balance, rendered `role="note"` — a caveat, not an
+     * error: nothing has gone wrong yet.
+     */
     alert?: ReactNode;
     strings?: Partial<OrderSummaryStrings>;
     vocabulary?: Partial<OrderStatusVocabulary>;

package/dist/components/admin/patterns/commerce/order-line-item.d.ts

@@ -18,7 +18,10 @@ export interface OrderLine {
     quantity: number;
     /** Already formatted. Passed, never multiplied. */
     total: string;
-    /** Rendered as label/value rows under the title, so every consumer's extras match. */
+    /**
+     * Per-line custom data, rendered as label/value rows under the title and styled once, so
+     * every consumer's extras match.
+     */
     properties?: OrderLineProperty[];
     /** Whatever `properties` cannot express. */
     children?: ReactNode;

package/dist/components/admin/patterns/commerce/order-transactions.d.ts

@@ -17,6 +17,10 @@ export interface Transaction {
     gateway?: string;
 }
 export interface OrderTransactionsProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    /**
+     * `kind` drives the sign; a failed attempt stays in the list, because an order showing
+     * only what worked cannot answer why it was never captured.
+     */
     transactions: Transaction[];
     strings?: Partial<TransactionStrings>;
 }

package/dist/components/admin/patterns/commerce/order.d.ts

@@ -12,14 +12,16 @@ export interface OrderEvent {
 }
 export interface OrderStatusCardProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
     orderNumber: string;
+    /** Drives the chip's tone. There is no tone override. */
     status: OrderStatus;
     /** Oldest first, so "latest complete" and "next" are found by position. */
     events: OrderEvent[];
     /** Already formatted. */
     eta?: string;
     /**
-     * Opens the full event list on first render. Closed by default: the panel above
-     * already summarises it.
+     * Opens the full event list on first render. Closed by default: the panel above already
+     * says what just happened, what is next and when it lands, and the list repeats two of
+     * the three.
      */
     defaultHistoryOpen?: boolean;
     strings?: Partial<OrderStatusStrings>;
@@ -36,6 +38,10 @@ export interface OrderTimelineEvent {
 export interface OrderTimelineProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
     events: OrderTimelineEvent[];
 }
+/**
+ * An order’s events on the shared rail, for a surface that wants the history without
+ * OrderStatusCard’s facts panel around it.
+ */
 export declare function OrderTimeline({ events, className, ...props }: OrderTimelineProps): import("react").JSX.Element;
 export interface PaymentEvent {
     id: string;

package/dist/components/admin/patterns/commerce/seo-listing.d.ts

@@ -3,9 +3,15 @@ import { ContentBlock } from '../../../base/display/index.js';
 import { SeoStrings } from './commerce.strings.js';
 import { SeoScore, SeoScoreInput } from './seo-score.js';
 export interface SeoListingProps extends Omit<ComponentProps<typeof ContentBlock>, "children" | "title"> {
-    /** What the result will read as. */
+    /**
+     * What the result will read as: title, description, permalink, baseUrl, keyword, and
+     * optional limits. Scored on render unless a `score` is supplied.
+     */
     listing: SeoScoreInput;
-    /** A score computed elsewhere (e.g. per keystroke by an editor). Without it, the listing is scored here. */
+    /**
+     * A score computed elsewhere — by an editor scoring as the user types. Without it the
+     * card scores the listing itself.
+     */
     score?: SeoScore;
     onEdit?: () => void;
     strings?: Partial<SeoStrings>;

package/dist/components/admin/patterns/commerce/seo-score.d.ts

@@ -53,4 +53,8 @@ export interface SeoScore {
 export declare function seoPermalinkPath(permalink?: string): string;
 /** The last segment of the path — the part a human reads. */
 export declare function seoPermalinkSlug(permalink?: string): string;
+/**
+ * Plain function, no React. Returns the total, a status, and a per-check breakdown with the
+ * measured lengths.
+ */
 export declare function calculateSeoScore(input: SeoScoreInput): SeoScore;

package/dist/components/admin/patterns/commerce/summary-panel.d.ts

@@ -1,18 +1,33 @@
 import { ComponentProps, ReactNode } from 'react';
 export interface AmountRowProps extends Omit<ComponentProps<"div">, "children"> {
+    /** What the amount is — "Subtotal", "Shipping". */
     label: ReactNode;
     /** Already formatted, including its currency. */
     amount: string;
     /** Marks the row the eye should land on — a total, an amount due. */
     total?: boolean;
-    /** Money coming off the total. Rewrites the sign rather than trusting the caller's, and tints the figure. */
+    /**
+     * Money coming off the total. Rewrites the sign to U+2212 whatever the caller passed,
+     * and tints the figure.
+     */
     deduction?: boolean;
     /** A rate, a qualifier — sits quietly beside the label. */
     note?: ReactNode;
 }
+/**
+ * The ledger row every money surface is built from, inside a `SummaryPanel`. Not
+ * InlineStat: this one knows about money — deductions and totals — and InlineStat displays
+ * any value.
+ */
 export declare function AmountRow({ label, amount, total, deduction, note, className, ...props }: AmountRowProps): import("react").JSX.Element;
 export interface SummaryPanelProps extends ComponentProps<"div"> {
     /** A quieter ground than the card it sits in, so the rows read as a sub-total block. */
     children: ReactNode;
 }
+/**
+ * The money ledger — the shape almost every commerce surface is made of: a tinted block of
+ * label/amount rows, a rule, and one row that matters more than the rest. A cart, a tax
+ * breakdown, an invoice and a subscription all draw it, and each rebuilding it inline is how
+ * one of them ends up emphasising its total differently from the others.
+ */
 export declare function SummaryPanel({ children, className, ...props }: SummaryPanelProps): import("react").JSX.Element;