@geomak/ui 7.18.5 → 7.19.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { C as COLORS, S as SemanticColorKey, a as SemanticSharedKey, V as VarColorKey, b as VarDensityKey, c as VarMotionKey, d as VarRadiusKey, e as VarShadowKey, f as VarTypoKey, g as VarZIndexKey, P as palette, s as semanticTokens, v as vars } from './index-BktppxXp.cjs';
+export { C as COLORS, S as SemanticColorKey, a as SemanticSharedKey, V as VarColorKey, b as VarDensityKey, c as VarMotionKey, d as VarRadiusKey, e as VarShadowKey, f as VarTypoKey, g as VarZIndexKey, P as palette, s as semanticTokens, v as vars } from './index-B8P5qbWt.cjs';
 export { CreateIconOptions, Icon, IconComponent, IconProps, createIcon } from './icons/index.cjs';
 import * as react from 'react';
 import react__default from 'react';
@@ -7,7 +7,7 @@ import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 
 type ClassValue = string | number | false | null | undefined;
 /**
- * Join class names, dropping falsy values — a tiny `clsx` for the design system.
+ * Join class names, dropping falsy values, a tiny `clsx` for the design system.
  * Replaces the repeated `[a, b].filter(Boolean).join(' ')` idiom with a clearer,
  * allocation-light call.
  *
@@ -30,8 +30,8 @@ interface PortalProps {
     target?: HTMLElement | (() => HTMLElement | null) | null;
 }
 /**
- * SSR-safe DOM relocator. Renders `children` at a detached DOM node — by
- * default `document.body` — so that any `position: fixed` descendant resolves
+ * SSR-safe DOM relocator. Renders `children` at a detached DOM node, by
+ * default `document.body`, so that any `position: fixed` descendant resolves
  * against the real viewport, never against a transformed, filtered, or
  * contained ancestor.
  *
@@ -40,7 +40,7 @@ interface PortalProps {
  * Per the CSS spec, **any ancestor with `transform`, `filter`, `perspective`,
  * `will-change`, or `contain: layout|paint|strict` creates a new containing
  * block for `position: fixed` descendants**. The fixed element then resolves
- * its coordinates against that ancestor, not the viewport — silently breaking
+ * its coordinates against that ancestor, not the viewport, silently breaking
  * full-screen overlays, toast viewports, mobile drawers, and loading screens
  * whenever a consumer wraps the component in:
  *
@@ -57,7 +57,7 @@ interface PortalProps {
  * ## When to use it
  *
  * Wrap any element that uses `position: fixed` to anchor itself to the
- * viewport — full-screen overlays, toast viewports, drawers, loading screens,
+ * viewport, full-screen overlays, toast viewports, drawers, loading screens,
  * command palettes, lightboxes.
  *
  * If you're already using a Radix primitive, prefer its built-in `*.Portal`
@@ -65,12 +65,12 @@ interface PortalProps {
  *
  * ## When NOT to use it
  *
- * - For inline elements that already flow naturally with the document — Portal
+ * - For inline elements that already flow naturally with the document, Portal
  *   is for **fixed/absolute escape**, not general layout.
- * - For SSR-critical content that must appear before hydration — Portal renders
+ * - For SSR-critical content that must appear before hydration, Portal renders
  *   `null` on the server and the first client render.
  * - For accessibility-critical content that depends on DOM proximity (form
- *   labels, ARIA `aria-controls` targets) — escaping the tree can break focus
+ *   labels, ARIA `aria-controls` targets), escaping the tree can break focus
  *   order and assistive-tech navigation.
  *
  * ## SSR / hydration
@@ -78,7 +78,7 @@ interface PortalProps {
  * `document.body` isn't available during SSR or the first client render.
  * `Portal` renders `null` until `useEffect` resolves the target post-mount,
  * then re-renders with the portal in place. Content that needs to appear
- * immediately on mount paints one frame later — acceptable for overlays
+ * immediately on mount paints one frame later, acceptable for overlays
  * (the trigger interaction is what kicks them off anyway).
  *
  * @example Full-screen loading overlay
@@ -113,7 +113,7 @@ type BoxRadius = 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'full';
 type BoxShadow = 'none' | 'sm' | 'md' | 'lg' | 'xl';
 interface BoxProps {
     as?: keyof react__default.JSX.IntrinsicElements;
-    /** Padding shorthand — applies to all sides. */
+    /** Padding shorthand, applies to all sides. */
     p?: Spacing;
     /** Horizontal padding (left + right). */
     px?: Spacing;
@@ -139,14 +139,14 @@ interface BoxProps {
     width?: string | number;
     /** Height via Tailwind class or CSS value. */
     height?: string | number;
-    /** Click handler — accepts any element-typed handler. */
+    /** Click handler, accepts any element-typed handler. */
     onClick?: react__default.MouseEventHandler<HTMLElement>;
     className?: string;
     style?: react__default.CSSProperties;
     children?: react__default.ReactNode;
 }
 /**
- * A polymorphic layout primitive — a `<div>` (by default) styled via prop
+ * A polymorphic layout primitive, a `<div>` (by default) styled via prop
  * shortcuts to the design system's tokenised spacing, surface, border,
  * radius, and shadow scales. Use it when you'd otherwise reach for a
  * className-only `<div>` with `p-4 bg-surface border border-border rounded-lg`.
@@ -182,7 +182,7 @@ interface FlexProps extends BoxProps {
     align?: FlexAlign;
     justify?: FlexJustify;
     wrap?: FlexWrap;
-    /** Gap between children — uses the same spacing token scale as Box. */
+    /** Gap between children, uses the same spacing token scale as Box. */
     gap?: Spacing;
     inline?: boolean;
 }
@@ -257,13 +257,13 @@ type AvatarStatus = 'online' | 'offline' | 'away' | 'busy';
 interface AvatarProps {
     /** Image URL. If missing or fails to load, `fallback` renders instead. */
     src?: string;
-    /** Alt text — required when `src` is provided for screen readers. */
+    /** Alt text, required when `src` is provided for screen readers. */
     alt?: string;
     /**
      * Fallback rendered when the image is unavailable. Pass either:
-     * - a string (e.g. user initials like "JD") — rendered with semi-bold weight
+     * - a string (e.g. user initials like "JD"), rendered with semi-bold weight
      * - any ReactNode (icon, emoji)
-     * - omit entirely — a generic "person" silhouette is used
+     * - omit entirely, a generic "person" silhouette is used
      */
     fallback?: react__default.ReactNode;
     /** Size preset. Default `'md'`. */
@@ -288,7 +288,7 @@ interface AvatarProps {
  * 2. Two-character initials extracted from `alt` if `alt` is provided
  * 3. A generic "person" silhouette SVG
  *
- * **Status dot** is an optional presence indicator in the bottom-right —
+ * **Status dot** is an optional presence indicator in the bottom-right -
  * online (green), away (amber), busy (red), offline (grey).
  *
  * @example Basic with image
@@ -389,7 +389,7 @@ interface IconButtonProps {
  * Square icon-only button.
  *
  * Uses `React.forwardRef` so it works as a Radix `asChild` trigger (Popover,
- * PopConfirm, Tooltip, etc.) — those need a DOM ref to anchor floating content.
+ * PopConfirm, Tooltip, etc.), those need a DOM ref to anchor floating content.
  *
  * @example
  * <IconButton icon={<Icon.Search />} onClick={doSearch} />
@@ -402,16 +402,16 @@ interface ButtonProps extends Omit<react__default.ButtonHTMLAttributes<HTMLButto
     content?: react__default.ReactNode;
     /** Visual style variant */
     variant?: 'primary' | 'secondary' | 'outline' | 'ghost' | 'danger' | 'warning' | 'success' | 'info';
-    /** Size — controls height, padding, and font size */
+    /** Size, controls height, padding, and font size */
     size?: 'sm' | 'md' | 'lg';
     /** HTML button type */
     buttonType?: 'button' | 'submit' | 'reset';
     /** Show a loading spinner and disable the control. */
     loading?: boolean;
-    /** Leading icon — rendered before content */
+    /** Leading icon, rendered before content */
     icon?: react__default.ReactNode;
     /**
-     * @deprecated Pass `variant` instead. Kept for API compat — currently no-op.
+     * @deprecated Pass `variant` instead. Kept for API compat, currently no-op.
      * Will be removed in the next major version.
      */
     type?: string;
@@ -419,7 +419,7 @@ interface ButtonProps extends Omit<react__default.ButtonHTMLAttributes<HTMLButto
 /**
  * Primary action button with variant + size system.
  *
- * Width is never hardcoded — set `style={{ width }}` or let the parent grid/flex control it.
+ * Width is never hardcoded, set `style={{ width }}` or let the parent grid/flex control it.
  * Uses `React.forwardRef` so it works as a Radix `asChild` trigger (Popover, Tooltip, etc.).
  *
  * @example
@@ -492,7 +492,7 @@ interface ModalProps {
      */
     size?: ModalSize;
     /**
-     * Explicit max-width escape hatch — a number (px) or any CSS length
+     * Explicit max-width escape hatch, a number (px) or any CSS length
      * (e.g. `'48rem'`). Overrides `size` when set.
      *
      * Height is always content-driven (max 90 dvh): modals grow with their
@@ -534,7 +534,7 @@ interface DrawerProps {
     open?: boolean;
     onClose?: () => void;
     hasFooter?: boolean;
-    /** 'left' | 'right' — which edge the panel slides from */
+    /** 'left' | 'right', which edge the panel slides from */
     placement?: 'left' | 'right';
     /**
      * Named width scale (default `'md'`): sm 280 · md 320 · lg 480 · xl 640 ·
@@ -542,7 +542,7 @@ interface DrawerProps {
      */
     size?: DrawerSize;
     /**
-     * Explicit width escape hatch — a number (px) or any CSS length
+     * Explicit width escape hatch, a number (px) or any CSS length
      * (e.g. `'30rem'`). Overrides `size` when set.
      */
     width?: number | string;
@@ -632,8 +632,8 @@ interface TabsProps {
  *
  * The active tab is marked by a thin cobalt indicator that *slides* between
  * tabs (the design system's "one rare accent" rule, not a full-fill pill).
- * Three variants — `underline` (signature), `segmented` (lifted-pill track),
- * `enclosed` (folder tabs) — plus horizontal/vertical orientation, icons,
+ * Three variants, `underline` (signature), `segmented` (lifted-pill track),
+ * `enclosed` (folder tabs), plus horizontal/vertical orientation, icons,
  * count badges, closeable + add-tab, and overflow scrolling with chevrons that
  * appear only when the strip actually overflows.
  *
@@ -691,7 +691,7 @@ interface TabsPanelProps {
     value: string;
     /**
      * Keep the panel mounted when inactive (preserves scroll / form state).
-     * Default `false` — panels mount lazily on first activation.
+     * Default `false`, panels mount lazily on first activation.
      */
     keepMounted?: boolean;
     /** Extra classes merged onto the panel. */
@@ -767,8 +767,8 @@ interface AccordionProps {
     collapsible?: boolean;
     /**
      * Visual style:
-     * - `'separated'` (default) — each item is its own bordered card with gaps.
-     * - `'contained'` — one bordered surface with divider lines between items.
+     * - `'separated'` (default), each item is its own bordered card with gaps.
+     * - `'contained'`, one bordered surface with divider lines between items.
      */
     variant?: AccordionVariant;
     /** Extra classes merged onto the root. */
@@ -779,7 +779,7 @@ interface AccordionProps {
  * Vertically stacked, collapsible panels built on `@radix-ui/react-accordion`.
  * Radix handles open/close state, keyboard navigation (↑/↓/Home/End), and ARIA;
  * the content height animates via the shared `accordion-down` / `accordion-up`
- * keyframes (reduced-motion safe — the height var simply snaps).
+ * keyframes (reduced-motion safe, the height var simply snaps).
  *
  * @example
  * ```tsx
@@ -788,7 +788,7 @@ interface AccordionProps {
  *     Everything in the Pro plan, plus priority support.
  *   </Accordion.Item>
  *   <Accordion.Item value="b" title="Can I cancel anytime?">
- *     Yes — cancel from billing settings, no questions asked.
+ *     Yes, cancel from billing settings, no questions asked.
  *   </Accordion.Item>
  * </Accordion>
  * ```
@@ -800,7 +800,7 @@ declare namespace Accordion {
 interface AccordionItemProps {
     /** Unique value identifying this panel (used for open state). */
     value: string;
-    /** Header content — the always-visible trigger label. */
+    /** Header content, the always-visible trigger label. */
     title: react__default.ReactNode;
     /** Optional leading icon shown before the title. */
     icon?: react__default.ReactNode;
@@ -871,7 +871,7 @@ interface BadgeProps {
     /** Optional leading icon (label mode). */
     icon?: react__default.ReactNode;
     /**
-     * Indicator mode — a numeric counter. With `children` it overlays the
+     * Indicator mode, a numeric counter. With `children` it overlays the
      * top-right corner of the wrapped element; without, it renders inline.
      */
     count?: number;
@@ -887,9 +887,9 @@ interface BadgeProps {
 /**
  * A small status / count indicator. Three uses:
  *
- * 1. **Label pill** — `<Badge tone="success">Active</Badge>`.
- * 2. **Inline count** — `<Badge count={5} tone="error" />`.
- * 3. **Overlay** — wrap an element to anchor a count/dot to its top-right:
+ * 1. **Label pill**, `<Badge tone="success">Active</Badge>`.
+ * 2. **Inline count**, `<Badge count={5} tone="error" />`.
+ * 3. **Overlay**, wrap an element to anchor a count/dot to its top-right:
  *    `<Badge count={3} tone="error"><IconButton … /></Badge>`.
  *
  * @example
@@ -900,7 +900,7 @@ declare function Badge({ children, tone, variant, size, icon, count, max, dot, s
 
 type BannerTone = 'info' | 'success' | 'warning' | 'danger';
 interface BannerProps {
-    /** Semantic tone — drives the tint, icon colour, and default icon. */
+    /** Semantic tone, drives the tint, icon colour, and default icon. */
     tone: BannerTone;
     /** Banner body. */
     children: react__default.ReactNode;
@@ -924,7 +924,7 @@ interface BannerProps {
  * </Banner>
  *
  * <Banner tone="danger" onDismiss={() => setShown(false)}>
- *   Sync failed — changes were not saved.
+ *   Sync failed, changes were not saved.
  * </Banner>
  * ```
  */
@@ -957,7 +957,7 @@ interface StepperProps {
     className?: string;
 }
 /**
- * A configurable steps indicator for multi-step flows — wizards, onboarding,
+ * A configurable steps indicator for multi-step flows, wizards, onboarding,
  * async pipelines. Completed steps show a check, the active step is highlighted
  * (or a spinner via `status="loading"` for async work, or an error mark), and
  * the connectors fill up to the current step. Horizontal or vertical, with an
@@ -999,7 +999,7 @@ interface TimelineProps {
     className?: string;
 }
 /**
- * A vertical timeline of ordered events — order tracking (Order placed →
+ * A vertical timeline of ordered events, order tracking (Order placed →
  * Packed → Shipped → Out for delivery → Delivered), audit trails, activity
  * feeds, anything sequential. Completed events show a check on the accent rail;
  * the current event pulses; upcoming events are muted.
@@ -1023,7 +1023,7 @@ interface KbdProps {
     /** A single key's label when `keys` is not used. */
     children?: react__default.ReactNode;
     /**
-     * A key combination — each entry renders as its own key cap, joined by
+     * A key combination, each entry renders as its own key cap, joined by
      * `separator`. e.g. `['Ctrl', 'K']` → `Ctrl + K`.
      */
     keys?: string[];
@@ -1035,7 +1035,7 @@ interface KbdProps {
     style?: react__default.CSSProperties;
 }
 /**
- * Renders keyboard keys as styled caps — a single key via `children`, or a
+ * Renders keyboard keys as styled caps, a single key via `children`, or a
  * combination via `keys` (each rendered as its own cap, joined by `separator`).
  *
  * @example
@@ -1100,9 +1100,9 @@ declare function CardMedia({ children, className }: CardMediaProps): react_jsx_r
 interface CardHeaderProps {
     title?: react__default.ReactNode;
     subtitle?: react__default.ReactNode;
-    /** Trailing slot — actions, menu, badge. */
+    /** Trailing slot, actions, menu, badge. */
     action?: react__default.ReactNode;
-    /** Leading slot — avatar / icon. */
+    /** Leading slot, avatar / icon. */
     avatar?: react__default.ReactNode;
     children?: react__default.ReactNode;
     className?: string;
@@ -1123,12 +1123,12 @@ declare function CardFooter({ children, noDivider, className }: CardFooterProps)
 
 type CardCarouselVariant = 'flat' | 'rotating';
 interface CardCarouselProps {
-    /** The slides — typically `Card`s. */
+    /** The slides, typically `Card`s. */
     children: react__default.ReactNode;
     /**
      * Layout style. Default `'flat'`.
-     * - `'flat'` — a horizontal scroll-snap row (trackpad / touch / wheel).
-     * - `'rotating'` — a coverflow stack: the active card sits centre-stage,
+     * - `'flat'`, a horizontal scroll-snap row (trackpad / touch / wheel).
+     * - `'rotating'`, a coverflow stack: the active card sits centre-stage,
      *   prominent, with its neighbours scaled back and faded behind it.
      */
     variant?: CardCarouselVariant;
@@ -1148,9 +1148,9 @@ interface CardCarouselProps {
 /**
  * A carousel for cards, in two flavours via `variant`:
  *
- * - **`flat`** (default) — a native scroll-snap row driven by trackpad / touch /
+ * - **`flat`** (default), a native scroll-snap row driven by trackpad / touch /
  *   wheel, with optional arrows and dots. Arrows disable at the ends.
- * - **`rotating`** — a coverflow stack. The active card is centre-stage and
+ * - **`rotating`**, a coverflow stack. The active card is centre-stage and
  *   prominent; neighbours are scaled back and faded behind it. Stepping animates
  *   the stack with a Framer Motion spring (transform + opacity only, so it stays
  *   smooth). Click a side card, use the arrows/dots, or press ←/→.
@@ -1166,7 +1166,7 @@ declare function CardCarousel(props: CardCarouselProps): react_jsx_runtime.JSX.E
 
 interface ChatMessage {
     id: string | number;
-    /** Author id — compared to `currentUserId` to decide own vs. incoming. */
+    /** Author id, compared to `currentUserId` to decide own vs. incoming. */
     authorId: string | number;
     /** Display name (shown above the first bubble of an incoming group). */
     authorName?: string;
@@ -1174,18 +1174,18 @@ interface ChatMessage {
     avatar?: string;
     /** Message body. */
     text: string;
-    /** Timestamp — Date or ISO string. */
+    /** Timestamp, Date or ISO string. */
     timestamp?: Date | string;
     /** Delivery status for own messages. */
     status?: 'sent' | 'delivered' | 'read';
 }
 interface ChatProps {
     messages: ChatMessage[];
-    /** The viewer's id — their messages align right with the accent bubble. */
+    /** The viewer's id, their messages align right with the accent bubble. */
     currentUserId: string | number;
     /** Fires when the composer sends a non-empty trimmed message. */
     onSend?: (text: string) => void;
-    /** Names currently typing — shows an animated indicator at the bottom. */
+    /** Names currently typing, shows an animated indicator at the bottom. */
     typingNames?: string[];
     /** Header: title, subtitle, avatar, trailing actions. Omit for no header. */
     title?: react__default.ReactNode;
@@ -1202,7 +1202,7 @@ interface ChatProps {
     loading?: boolean;
     /** Shown when there are no messages. */
     emptyState?: react__default.ReactNode;
-    /** Overall height — the message list scrolls within it. Default `480`. */
+    /** Overall height, the message list scrolls within it. Default `480`. */
     height?: number | string;
     className?: string;
     style?: react__default.CSSProperties;
@@ -1267,7 +1267,7 @@ interface StatisticProps {
 }
 /**
  * A single metric: caption, value (with optional prefix/suffix and icon), and an
- * optional trend delta whose colour follows direction — flipped for metrics
+ * optional trend delta whose colour follows direction, flipped for metrics
  * where a rise is bad via `positiveIsGood: false`.
  *
  * @example
@@ -1288,7 +1288,7 @@ interface FABAction {
 interface FABProps {
     /** Main button icon. */
     icon: react__default.ReactNode;
-    /** Accessible label for the main button (required — it's icon-only). */
+    /** Accessible label for the main button (required, it's icon-only). */
     label: string;
     /** Click handler. Ignored when `actions` is provided (the button toggles the dial). */
     onClick?: react__default.MouseEventHandler;
@@ -1302,7 +1302,7 @@ interface FABProps {
     tone?: FABTone;
     /**
      * `position: fixed` to the viewport (default) or `absolute` to the nearest
-     * positioned ancestor — set `false` to anchor inside a `relative` container.
+     * positioned ancestor, set `false` to anchor inside a `relative` container.
      */
     fixed?: boolean;
     className?: string;
@@ -1380,7 +1380,7 @@ interface LogoutTimerProps {
     onWarning?: () => void;
     /** Activity events that reset the idle timer. */
     events?: string[];
-    /** Master switch — when false the timer is fully disabled. Default `true`. */
+    /** Master switch, when false the timer is fully disabled. Default `true`. */
     enabled?: boolean;
     /** Warning dialog heading. Default `'Still there?'`. */
     title?: react__default.ReactNode;
@@ -1395,7 +1395,7 @@ interface LogoutTimerProps {
  * Inactivity / session-timeout guard. After `timeout` ms with no user activity
  * it raises a warning dialog that counts down for `countdown` ms; if the user
  * doesn't respond, `onLogout` fires. "Stay signed in" extends the session;
- * "Sign out now" logs out immediately. Activity resets the idle timer — but not
+ * "Sign out now" logs out immediately. Activity resets the idle timer, but not
  * while the warning is up, so the user must make a choice.
  *
  * Mount it once near the app root, alongside (or just inside) your
@@ -1416,13 +1416,13 @@ type SchedulerView = 'month' | 'week';
 interface SchedulerEvent {
     id: string | number;
     title: string;
-    /** Start time — Date or ISO string. */
+    /** Start time, Date or ISO string. */
     start: Date | string;
     /** End time. Defaults to start + 1h. */
     end?: Date | string;
     /** Any CSS colour for the event chip. Defaults to the accent token. */
     color?: string;
-    /** All-day event — pinned to the day header strip rather than a time slot. */
+    /** All-day event, pinned to the day header strip rather than a time slot. */
     allDay?: boolean;
 }
 interface SchedulerRange {
@@ -1448,7 +1448,7 @@ interface SchedulerProps {
     dayHours?: [number, number];
     /** Pixel height of one hour row in the week view. Default `48`. */
     hourHeight?: number;
-    /** Click an empty day cell (month) or time slot (week) — for creating events. */
+    /** Click an empty day cell (month) or time slot (week), for creating events. */
     onSelectSlot?: (date: Date) => void;
     /** Click an event chip. */
     onSelectEvent?: (event: SchedulerEvent) => void;
@@ -1460,7 +1460,7 @@ interface SchedulerProps {
     style?: react__default.CSSProperties;
 }
 /**
- * An event scheduler with month and week views — the agenda-style calendar for
+ * An event scheduler with month and week views, the agenda-style calendar for
  * dashboards and ops tools (think Google Calendar's month/week). Supply events
  * directly via `events`, or hand it an async `loadEvents(range, view)` and it
  * manages the loading / empty states as the user pages around.
@@ -1493,7 +1493,7 @@ interface CartLineItem {
 }
 interface CartSummaryRow {
     label: react__default.ReactNode;
-    /** Signed amount — negative for discounts. */
+    /** Signed amount, negative for discounts. */
     value: number;
     /** Render in muted/normal style instead of emphasised. */
     muted?: boolean;
@@ -1523,7 +1523,7 @@ interface CartProps {
  * remove, plus a summary that totals the subtotal with any extra rows
  * (shipping, tax, discount) and an optional checkout button.
  *
- * Stateless and controlled — you own the items array and react to
+ * Stateless and controlled, you own the items array and react to
  * `onQuantityChange` / `onRemove`.
  *
  * @example
@@ -1539,7 +1539,7 @@ interface CartProps {
  */
 declare function Cart({ items, onQuantityChange, onRemove, summaryRows, formatPrice, checkoutLabel, onCheckout, emptyState, className, style, }: CartProps): react_jsx_runtime.JSX.Element;
 
-/** Shape accepted by `addToCart` — quantity is optional (defaults to 1). */
+/** Shape accepted by `addToCart`, quantity is optional (defaults to 1). */
 type CartItemInput = Omit<CartLineItem, 'quantity'> & {
     quantity?: number;
 };
@@ -1561,7 +1561,7 @@ interface CartContextValue {
     isInCart: (id: CartLineItem['id']) => boolean;
     /** Total number of units across all lines (sum of quantities). */
     getItemCount: () => number;
-    /** Subtotal — sum of `price × quantity` across all lines. */
+    /** Subtotal, sum of `price × quantity` across all lines. */
     getCartTotal: () => number;
 }
 interface CartProviderProps {
@@ -1573,7 +1573,7 @@ interface CartProviderProps {
 }
 /**
  * Provides a robust, app-wide cart API. Wrap any subtree and call
- * {@link useCart} from anywhere inside to add, remove, and total items —
+ * {@link useCart} from anywhere inside to add, remove, and total items -
  * the cart panel, a product grid, and a topbar badge all stay in sync off the
  * same store.
  *
@@ -1600,7 +1600,7 @@ declare function CartProvider({ children, initialItems, onChange }: CartProvider
 declare function useCart(): CartContextValue;
 
 interface CartButtonProps {
-    /** Click handler — typically opens the cart drawer / navigates to checkout. */
+    /** Click handler, typically opens the cart drawer / navigates to checkout. */
     onClick?: react__default.MouseEventHandler<HTMLButtonElement>;
     /** Icon-button style. Default `'bordered'`. */
     variant?: 'primary' | 'bordered';
@@ -1640,7 +1640,7 @@ interface EmptyCartProps {
     style?: react__default.CSSProperties;
 }
 /**
- * The empty state for a shopping cart — a configurable illustration with a
+ * The empty state for a shopping cart, a configurable illustration with a
  * title, optional description, and an optional call-to-action.
  *
  * Pass a custom `illustration` to match your brand, or override `title` /
@@ -1664,7 +1664,7 @@ declare function EmptyCart({ illustration, title, description, action, className
  *
  * Centralises the things every input must agree on:
  * - the **size scale** (sm / md / lg) → control height + text size + padding
- * - the **refined focus treatment** — a crisp 1px accent border plus a soft
+ * - the **refined focus treatment**, a crisp 1px accent border plus a soft
  *   3px low-opacity halo (NOT a heavy solid ring band)
  * - the **resting / hover / error / disabled** border + background states
  * - a **`<Field>` wrapper** handling label, error region, layout
@@ -1688,7 +1688,7 @@ interface FieldShellOptions {
     sized?: boolean;
 }
 /**
- * Compose the className for an input's outer "shell" — the bordered, rounded
+ * Compose the className for an input's outer "shell", the bordered, rounded
  * box that carries the focus ring. Apply to the `<input>` directly, or to a
  * wrapper `<div>` that contains an input plus adornments (pass
  * `focusWithin: true` in that case).
@@ -1724,7 +1724,7 @@ interface FieldLabelProps {
     className?: string;
 }
 /**
- * The label row shared by every input — label text + required asterisk +
+ * The label row shared by every input, label text + required asterisk +
  * optional `helperText` info icon. Components that render their own label
  * outside `<Field>` (Dropdown, DatePicker, Switch, SegmentedControl) use this
  * so the affordance is pixel-identical everywhere.
@@ -1734,9 +1734,9 @@ interface FieldLabelProps {
 declare function FieldLabel({ label, htmlFor, required, helperText, horizontal, align, style, width, className, }: FieldLabelProps): react_jsx_runtime.JSX.Element | null;
 interface FieldProps {
     label?: react__default.ReactNode;
-    /** `id` of the control — links the `<label htmlFor>`. */
+    /** `id` of the control, links the `<label htmlFor>`. */
     htmlFor?: string;
-    /** `id` for the error region — pair with `aria-describedby` on the control. */
+    /** `id` for the error region, pair with `aria-describedby` on the control. */
     errorId?: string;
     errorMessage?: react__default.ReactNode;
     /** Orientation of label vs control. Default `'vertical'`. */
@@ -1771,7 +1771,7 @@ interface FieldProps {
  * The error message always sits under the **control only** (never spanning
  * the label in horizontal layout). Label uses full-contrast foreground +
  * medium weight so it reads as the anchor, while the input's placeholder is
- * muted — establishing hierarchy without making the label tiny.
+ * muted, establishing hierarchy without making the label tiny.
  */
 declare function Field({ label, htmlFor, errorId, errorMessage, layout, required, helperText, labelAlign, labelStyle, labelWidth, className, children, }: FieldProps): react_jsx_runtime.JSX.Element;
 
@@ -1820,7 +1820,7 @@ interface CreditCardFormProps {
 /**
  * Unified credit-card form built on the oxygen-ui {@link useForm} Form API.
  *
- * One component owns all four fields and their cross-field rules — card number
+ * One component owns all four fields and their cross-field rules, card number
  * (brand detection + grouping + Luhn), expiry (`MM/YY`, real month, not past),
  * CVV (brand-aware length), and cardholder name. It is deliberately NOT shipped
  * as separate inputs: a CVV or expiry field has no meaning outside a card form.
@@ -1858,7 +1858,7 @@ interface CheckoutProps {
  * {@link useCart} store, so it must be rendered inside a `<CartProvider>`.
  *
  * The pay button is disabled whenever the cart is empty (via the form's
- * `submitDisabled`) — the card fields stay editable, but payment can't be
+ * `submitDisabled`), the card fields stay editable, but payment can't be
  * submitted with nothing to buy. Stacks to a single column below `lg`.
  *
  * @example
@@ -1916,7 +1916,7 @@ declare function useNotification(): {
 type LoadingSpinnerSize = 'xs' | 'sm' | 'md' | 'lg';
 interface LoadingSpinnerProps {
     /**
-     * Text revealed letter-by-letter beneath the spinner. Optional — pass
+     * Text revealed letter-by-letter beneath the spinner. Optional, pass
      * `undefined` for a pure spinner with no caption (e.g. inline mode).
      */
     prompt?: string;
@@ -1939,7 +1939,7 @@ interface LoadingSpinnerProps {
      */
     textColor?: string;
     /**
-     * Backdrop opacity (0 – 1) for the fullscreen overlay. Defaults to 0.8 —
+     * Backdrop opacity (0 – 1) for the fullscreen overlay. Defaults to 0.8 -
      * close enough to opaque to block UI underneath while still hinting at the
      * previous state. Ignored when `inline` is true.
      */
@@ -1965,7 +1965,7 @@ interface LoadingSpinnerProps {
  *
  * **Accessibility**: `role="status"` + `aria-label`/`aria-live` make the
  * indicator announce-able to screen readers. `prefers-reduced-motion`
- * collapses the letter stagger to instant reveal — the spinner rings keep
+ * collapses the letter stagger to instant reveal, the spinner rings keep
  * rotating since a continuous spinner is informative, not decorative.
  *
  * @example Fullscreen overlay (page load)
@@ -2005,7 +2005,7 @@ interface FadingBaseProps {
  * The component mounts on `isMounted=true` and unmounts after the 300ms
  * fade-out completes on `isMounted=false`.
  *
- * Uses CSS `dark:` class for the glass effect — no ThemeContext dependency.
+ * Uses CSS `dark:` class for the glass effect, no ThemeContext dependency.
  *
  * @example
  * <FadingBase isMounted={isPageVisible}>
@@ -2087,12 +2087,12 @@ declare function List({ items, onItemClick, activeKey, density, className, style
 
 interface ScalableContainerProps {
     /**
-     * Resting width. Optional — when omitted, the resting size is left to your
+     * Resting width. Optional, when omitted, the resting size is left to your
      * own `className` / parent layout (so the container can sit in a fluid grid
      * sized by `w-[…]` classes). Only set this if you want an inline width.
      */
     width?: react__default.CSSProperties['width'];
-    /** Resting height. Optional — see {@link ScalableContainerProps.width}. */
+    /** Resting height. Optional, see {@link ScalableContainerProps.width}. */
     height?: react__default.CSSProperties['height'];
     /**
      * Width when expanded. Default `'100%'`. Use `'100%'` to span the full row
@@ -2121,38 +2121,38 @@ interface ScalableContainerProps {
     collapseIcon?: react__default.ReactNode;
     /**
      * Position of the toggle button inside the container.
-     * Default `'top-right'` — matches the OS-window convention.
+     * Default `'top-right'`, matches the OS-window convention.
      */
     togglePosition?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
-    /** @deprecated No longer used — set `targetWidth`/`targetHeight` instead. */
+    /** @deprecated No longer used, set `targetWidth`/`targetHeight` instead. */
     expandContainerRef?: react__default.RefObject<HTMLElement | null>;
-    /** @deprecated No longer used — set `targetWidth`/`targetHeight` instead. */
+    /** @deprecated No longer used, set `targetWidth`/`targetHeight` instead. */
     expandRatio?: number;
     /** Extra classes merged onto the container root. */
     className?: string;
 }
 /**
  * Container that grows to a target size on click and collapses back. Reads like
- * an OS window resize — subtle elevation lift, smooth size transition.
+ * an OS window resize, subtle elevation lift, smooth size transition.
  *
  * **Resting size comes from your layout, not from props.** Leave `width`/`height`
  * unset and size the container with your own `className` (e.g. a fluid grid:
  * `w-full lg:w-[calc(50%-6px)]`). Only when expanded does the container write an
  * inline `width`/`height` (= `targetWidth`/`targetHeight`) and go `flex: none`,
- * so it grows to that size and simply **pushes its neighbours along the flow** —
+ * so it grows to that size and simply **pushes its neighbours along the flow** -
  * they keep their own dimensions and reflow (wrap / move down). On collapse the
  * inline sizing is removed and your className layout takes back over. No sibling
  * styles are ever touched.
  *
  * For neighbours to reflow *below* the expanded one, the parent must be able to
- * wrap — a `flex flex-wrap` row is the simplest; with `targetWidth="100%"` the
+ * wrap, a `flex flex-wrap` row is the simplest; with `targetWidth="100%"` the
  * expanded item takes a full row and everything after it moves down.
  *
  * @example
  * ```tsx
  * <div className="flex flex-wrap gap-3">
  *   <ScalableContainer
- *     className="w-full lg:w-[calc(50%-6px)]"   // resting size — your grid
+ *     className="w-full lg:w-[calc(50%-6px)]"   // resting size, your grid
  *     height={300}                              // resting height
  *     targetWidth="100%" targetHeight={580}     // expanded size
  *   >
@@ -2171,7 +2171,7 @@ interface GridCardItem {
     /** Image URL or JSX element */
     cover?: string | react__default.ReactNode;
     enabled?: boolean;
-    /** Arbitrary route or payload — passed back to onOpen */
+    /** Arbitrary route or payload, passed back to onOpen */
     to?: string;
     [key: string]: any;
 }
@@ -2188,7 +2188,7 @@ interface GridCardProps {
 /**
  * Application card tile (grid layout).
  *
- * Decoupled from React Router — navigation is delegated to the `onOpen` prop.
+ * Decoupled from React Router, navigation is delegated to the `onOpen` prop.
  *
  * @example
  * <GridCard
@@ -2239,7 +2239,7 @@ interface CatalogCarouselProps {
 /**
  * Three-card carousel (previous → active (scaled) → next).
  *
- * Decoupled from ThemeContext — uses CSS `dark:` classes.
+ * Decoupled from ThemeContext, uses CSS `dark:` classes.
  */
 declare function CatalogCarousel({ items, buttonText, onOpen, className }: CatalogCarouselProps): react_jsx_runtime.JSX.Element;
 
@@ -2277,7 +2277,7 @@ interface ContextMenuActionItem {
     onClick?: () => void;
     /** Optional sub-menu items. */
     children?: ContextMenuActionItem[];
-    /** Render as disabled — still visible but not activatable. */
+    /** Render as disabled, still visible but not activatable. */
     disabled?: boolean;
 }
 interface ContextMenuProps {
@@ -2286,7 +2286,7 @@ interface ContextMenuProps {
     /**
      * The element that should respond to right-click. The entire React
      * subtree underneath becomes the trigger area. Wrap an existing
-     * component / div / image — anything you can right-click on.
+     * component / div / image, anything you can right-click on.
      */
     children: react__default.ReactNode;
     /** Extra classes merged onto the menu content panel. */
@@ -2300,7 +2300,7 @@ interface ContextMenuProps {
  * navigation (↑↓ to move, → to open sub-menu, ← to close, Enter to activate,
  * Esc to dismiss), focus management, and portal-based stacking.
  *
- * @example Basic — flat menu
+ * @example Basic, flat menu
  * ```tsx
  * <ContextMenu
  *   items={[
@@ -2330,7 +2330,7 @@ interface ContextMenuProps {
  * ```
  */
 declare function ContextMenu({ items, children, className }: ContextMenuProps): react_jsx_runtime.JSX.Element;
-/** @deprecated The Radix rewrite positions the menu automatically — no coordinates needed. */
+/** @deprecated The Radix rewrite positions the menu automatically, no coordinates needed. */
 interface ContextMenuPosition {
     x: number;
     y: number;
@@ -2343,17 +2343,17 @@ interface WizardStep {
     description: react__default.ReactNode;
     /**
      * Tooltip placement relative to the highlighted element.
-     * - `'right'`  (default) — to the right of the highlight
-     * - `'left'`             — to the left of the highlight
-     * - `'top'`              — above the highlight
-     * - `'bottom'`           — below the highlight
+     * - `'right'`  (default), to the right of the highlight
+     * - `'left'`            , to the left of the highlight
+     * - `'top'`             , above the highlight
+     * - `'bottom'`          , below the highlight
      */
     placement?: 'right' | 'left' | 'top' | 'bottom';
     /** Optional heading for the step's tooltip. */
     title?: react__default.ReactNode;
 }
 interface WizardProps {
-    /** The wrapped subtree — refs in `steps` point into this tree. */
+    /** The wrapped subtree, refs in `steps` point into this tree. */
     children: react__default.ReactNode;
     /** Ordered list of steps to walk the user through. */
     steps: WizardStep[];
@@ -2391,7 +2391,7 @@ interface WizardProps {
  *   portaled outline rectangle that tracks the target's bbox via
  *   `ResizeObserver` + scroll/resize listeners. The consumer's DOM is never
  *   mutated, so unmounting Wizard mid-tour leaves no orphan classes.
- * - Focus trap inside the tooltip — Tab and Shift+Tab cycle through the
+ * - Focus trap inside the tooltip, Tab and Shift+Tab cycle through the
  *   tooltip's buttons. Esc dismisses (when `dismissible`).
  * - Backdrop blocks click-through on the rest of the page so the user can't
  *   stumble into unrelated UI mid-tour. The highlighted target itself stays
@@ -2399,7 +2399,7 @@ interface WizardProps {
  * - Position recalculates on scroll / resize / target size changes via
  *   `ResizeObserver`.
  * - All `dark-cornflower-blue` / `prussian-blue` / `bg-white` swapped for
- *   semantic tokens — both light and dark modes work out of the box.
+ *   semantic tokens, both light and dark modes work out of the box.
  *
  * @example
  * ```tsx
@@ -2423,11 +2423,11 @@ declare function Wizard({ children, steps, storageKey, dismissible, onComplete,
 /**
  * Column descriptor for the Table.
  *
- * The generic `T` is the shape of a row — `keyBind` must be one of T's
+ * The generic `T` is the shape of a row, `keyBind` must be one of T's
  * string-keyed properties, and `component(cellValue, row)` receives the
  * matching value with full type inference. When used without a generic
  * (`TableColumn[]`), `T` falls back to `Record<string, any>` for backwards
- * compatibility — narrower typing is preferred whenever possible:
+ * compatibility, narrower typing is preferred whenever possible:
  *
  * ```ts
  * type Vessel = { id: number; name: string; status: 'At Sea' | 'In Port' }
@@ -2444,7 +2444,7 @@ interface TableColumn<T extends Record<string, any> = Record<string, any>> {
     keyBind: keyof T & string;
     /** Custom cell renderer. Receives the cell value and the full row. */
     component?: (cellValue: T[keyof T], row: T) => react__default.ReactNode;
-    /** Explicit column width (CSS length or px number). Optional — defaults to auto. */
+    /** Explicit column width (CSS length or px number). Optional, defaults to auto. */
     width?: string | number;
     /** Text alignment for both header and cells. Defaults to `'center'`. */
     align?: 'left' | 'center' | 'right';
@@ -2484,11 +2484,11 @@ interface SearchOptions<T extends Record<string, any> = Record<string, any>> {
     matchMode?: 'contains' | 'startsWith' | 'equals';
     /** Case-sensitive matching. Default `false`. */
     caseSensitive?: boolean;
-    /** Debounce the filter (ms) — useful for large lists. Default `0`. */
+    /** Debounce the filter (ms), useful for large lists. Default `0`. */
     debounceMs?: number;
     /** Input placeholder. */
     placeholder?: string;
-    /** Full custom matcher — overrides keys / matchMode / caseSensitive. */
+    /** Full custom matcher, overrides keys / matchMode / caseSensitive. */
     predicate?: (row: T, term: string) => boolean;
 }
 interface PaginationOptions {
@@ -2526,7 +2526,7 @@ interface TableProps<T extends Record<string, any> = Record<string, any>> {
     /**
      * Returns a stable key for each row, used for React reconciliation AND
      * for tracking expanded state when `expandRow.enabled` is true.
-     * Defaults to the row index — fine for static lists, but pass an
+     * Defaults to the row index, fine for static lists, but pass an
      * explicit getter (e.g. `(row) => row.id`) if rows can be reordered or
      * filtered while expand state should persist.
      */
@@ -2603,13 +2603,13 @@ interface TableProps<T extends Record<string, any> = Record<string, any>> {
 declare function Table<T extends Record<string, any> = Record<string, any>>({ columns, rows, getRowKey, pagination, expandRow, hasSearch, search, defaultSort, onSortChange, onCellEdit, footer, header, loading, loadingRowCount, className, style, }: TableProps<T>): react_jsx_runtime.JSX.Element;
 
 interface VirtualListProps<T> {
-    /** The full dataset — only the visible window is mounted. */
+    /** The full dataset, only the visible window is mounted. */
     items: T[];
     /** Fixed row height in px. (Variable heights aren't supported in this lean build.) */
     rowHeight: number;
     /** Render one item. Wrapped in a row of exactly `rowHeight`. */
     renderItem: (item: T, index: number) => react__default.ReactNode;
-    /** Viewport height — number (px) or any CSS length. Default `400`. */
+    /** Viewport height, number (px) or any CSS length. Default `400`. */
     height?: number | string;
     /** Stable key per item. Defaults to the index. */
     getKey?: (item: T, index: number) => react__default.Key;
@@ -2619,7 +2619,7 @@ interface VirtualListProps<T> {
     searchable?: boolean;
     /** Object keys to search (default: searches `String(item)`). */
     searchKeys?: (keyof T)[];
-    /** Custom matcher — overrides `searchKeys`. */
+    /** Custom matcher, overrides `searchKeys`. */
     filter?: (item: T, term: string) => boolean;
     searchPlaceholder?: string;
     /** Shown when there are no items (or none match the search). */
@@ -2631,7 +2631,7 @@ interface VirtualListProps<T> {
 /**
  * A windowed (virtualized) list: renders only the rows in view (plus overscan),
  * so 100k items scroll as cheaply as 20. Fixed `rowHeight`, no dependencies.
- * Set `searchable` for a built-in filter — the canonical "virtualized search".
+ * Set `searchable` for a built-in filter, the canonical "virtualized search".
  *
  * @example
  * <VirtualList
@@ -2649,10 +2649,10 @@ declare function VirtualList<T>({ items, rowHeight, renderItem, height, getKey,
 /**
  * Shared file-source contract for content components (PdfViewer, Spreadsheet).
  *
- * Three independent, equal ways to supply content — no preference baked in:
- *  1. PROGRAMMATIC  — `ArrayBuffer | Uint8Array` built in-browser (no network)
- *  2. BACKEND       — `string | URL` fetched/streamed from a server
- *  3. LOCAL         — `File | Blob` from a file input / drag-drop (no network)
+ * Three independent, equal ways to supply content, no preference baked in:
+ *  1. PROGRAMMATIC , `ArrayBuffer | Uint8Array` built in-browser (no network)
+ *  2. BACKEND      , `string | URL` fetched/streamed from a server
+ *  3. LOCAL        , `File | Blob` from a file input / drag-drop (no network)
  */
 type FileSource = string | URL | File | Blob | ArrayBuffer | Uint8Array;
 interface RemoteSourceOptions {
@@ -2780,7 +2780,7 @@ interface DataGridProps {
  * Virtualized (both axes) data grid primitive. Renders only the cells inside
  * the viewport plus an overscan margin, so it stays smooth at tens of thousands
  * of rows. The header and the row-number gutter are pinned by positioning them
- * at the live scroll offset (`top: scrollTop` / `left: scrollLeft`) — the same
+ * at the live scroll offset (`top: scrollTop` / `left: scrollLeft`), the same
  * translate-window technique as {@link VirtualList}, extended to two axes.
  *
  * Stateless w.r.t. data: it renders the `rows` it's given and emits
@@ -2791,7 +2791,7 @@ declare function DataGrid({ columns, rows, rowHeight, headerHeight, height, widt
 
 interface Cell {
     value: CellValue;
-    /** Reserved for a future formula engine — parsed/stored but not evaluated. */
+    /** Reserved for a future formula engine, parsed/stored but not evaluated. */
     formula?: string;
 }
 interface SheetData {
@@ -2803,7 +2803,7 @@ type GridSource = SheetData[] | File | Blob | string | URL;
 interface SpreadsheetProps {
     source: GridSource;
     remote?: RemoteSourceOptions;
-    /** Value editing only — no formulas. Default false. */
+    /** Value editing only, no formulas. Default false. */
     editable?: boolean;
     onCellEdit?: (e: {
         sheet: string;
@@ -2834,7 +2834,7 @@ interface SpreadsheetProps {
 }
 /**
  * Multi-sheet spreadsheet built on {@link DataGrid}. Accepts data three ways
- * — in-memory `SheetData[]` (no network), a `File`/`Blob` (no network), or a
+ *, in-memory `SheetData[]` (no network), a `File`/`Blob` (no network), or a
  * URL (the only mode that fetches). `.xlsx` is parsed with SheetJS, loaded
  * lazily on first use. Value editing emits `onCellEdit` + `onChange`; there is
  * no formula engine (the `Cell.formula` slot is reserved, not evaluated).
@@ -2859,7 +2859,7 @@ interface ThemeSwitchProps {
  * Theme (dark-mode) toggle switch powered by Radix Switch.
  *
  * The thumb color indicates mode: green = light, slate = dark.
- * Layout (position, margin) is the parent's responsibility — this component
+ * Layout (position, margin) is the parent's responsibility, this component
  * renders inline with no external margins.
  *
  * @example
@@ -2868,15 +2868,15 @@ interface ThemeSwitchProps {
 declare function ThemeSwitch({ checked, onChange, label, className }: ThemeSwitchProps): react_jsx_runtime.JSX.Element;
 
 interface TopBarProps {
-    /** Brand area — logo, wordmark, or app name. Rendered on the leading edge. */
+    /** Brand area, logo, wordmark, or app name. Rendered on the leading edge. */
     brand?: react__default.ReactNode;
     /**
-     * Centre content — primary navigation links, breadcrumb, or page title.
+     * Centre content, primary navigation links, breadcrumb, or page title.
      * On mobile (< md breakpoint) this moves below the brand row.
      */
     center?: react__default.ReactNode;
     /**
-     * Trailing actions — theme toggle, user avatar, notification bell, etc.
+     * Trailing actions, theme toggle, user avatar, notification bell, etc.
      * Rendered on the trailing edge.
      */
     actions?: react__default.ReactNode;
@@ -2892,7 +2892,7 @@ interface TopBarProps {
  * App-shell top navigation bar.
  *
  * Three named slots: brand (leading), center, actions (trailing).
- * All slots are optional — omit what you don't need.
+ * All slots are optional, omit what you don't need.
  *
  * The component is sticky by default (`sticky top-0`) with `z-[100]`.
  * Height is exposed as `--topbar-height` CSS variable on the element so
@@ -2934,7 +2934,7 @@ interface SidebarItem {
 }
 interface SidebarSection {
     key: string;
-    /** Section title — visible only when expanded */
+    /** Section title, visible only when expanded */
     title?: string;
     items: SidebarItem[];
 }
@@ -3127,7 +3127,7 @@ interface SecureLayoutProps {
      * role / permission / `canAccess` gates apply.
      */
     isAuthenticated?: boolean;
-    /** A JWT. Used only to check expiry (`exp`) client-side — never trust this
+    /** A JWT. Used only to check expiry (`exp`) client-side, never trust this
      *  for real authorization; the server must verify the signature. */
     token?: string;
     /** The user's roles (RBAC). */
@@ -3159,21 +3159,21 @@ interface SecureLayoutProps {
     /** Shown when access is denied. Defaults to a simple "Access denied" panel;
      *  pass `null` to render nothing (e.g. when `onDeny` redirects away). */
     fallback?: react__default.ReactNode;
-    /** Fired once when access is granted — e.g. to hydrate app state or redirect
+    /** Fired once when access is granted, e.g. to hydrate app state or redirect
      *  to a landing route after a successful token check. */
     onGranted?: () => void;
-    /** Fired once when access is denied — e.g. to redirect to login / logout. */
+    /** Fired once when access is denied, e.g. to redirect to login / logout. */
     onDeny?: () => void;
     className?: string;
 }
 /**
- * A layout wrapper that gates its children behind an access check —
+ * A layout wrapper that gates its children behind an access check -
  * authentication, RBAC (roles), PBAC (permissions), JWT expiry, and/or a
  * custom (optionally async) predicate. While the check runs it shows a
  * loading fallback; on success it fades the content in; on failure it renders
  * a fallback and calls `onDeny`.
  *
- * This is a UI guard, not a security boundary — it controls what renders.
+ * This is a UI guard, not a security boundary, it controls what renders.
  * Real authorization must be enforced by your API/server.
  *
  * @example Full RBAC + PBAC gate
@@ -3192,7 +3192,7 @@ interface SecureLayoutProps {
  *   }}
  *   onGranted={() => navigate('/dashboard')}
  *   onDeny={() => navigate('/logout')}
- *   fallback={null}                    // redirecting — don't flash a panel
+ *   fallback={null}                    // redirecting, don't flash a panel
  * >
  *   <AppRoutes />
  * </SecureLayout>
@@ -3280,7 +3280,7 @@ interface ThemeMotion {
 }
 /**
  * Partial theme override configuration.
- * Every field is optional — only the keys you provide are overridden.
+ * Every field is optional, only the keys you provide are overridden.
  */
 interface ThemeConfig {
     colors?: ThemeColors;
@@ -3299,15 +3299,15 @@ interface ThemeProviderProps {
     /**
      * Additional token overrides applied only when the wrapper element carries
      * the `.dark` class (i.e. when `colorScheme="dark"` or when a parent sets `.dark`).
-     * Injected via a scoped `<style>` tag — no inline-style limitations.
+     * Injected via a scoped `<style>` tag, no inline-style limitations.
      */
     darkTheme?: ThemeConfig;
     /**
      * Managed color scheme.
-     * - `'light'`  — removes `.dark` class from the wrapper
-     * - `'dark'`   — adds `.dark` class to the wrapper
-     * - `'system'` — follows `prefers-color-scheme` media query
-     * - `'auto'`   — do nothing; inherit from an ancestor (default)
+     * - `'light'` , removes `.dark` class from the wrapper
+     * - `'dark'`  , adds `.dark` class to the wrapper
+     * - `'system'`, follows `prefers-color-scheme` media query
+     * - `'auto'`  , do nothing; inherit from an ancestor (default)
      */
     colorScheme?: 'light' | 'dark' | 'system' | 'auto';
     children: react__default.ReactNode;
@@ -3393,7 +3393,7 @@ interface SkeletonCircleProps extends SkeletonBaseProps {
     size?: number;
 }
 /**
- * Circular loading placeholder — avatars, icons, status indicators.
+ * Circular loading placeholder, avatars, icons, status indicators.
  *
  * @example
  * <SkeletonCircle size={48} />
@@ -3407,7 +3407,7 @@ interface SkeletonCardProps extends SkeletonBaseProps {
     lines?: number;
 }
 /**
- * Composite card skeleton — avatar + heading + body text + action strip.
+ * Composite card skeleton, avatar + heading + body text + action strip.
  * Use as a drop-in while real card data loads.
  *
  * @example
@@ -3420,7 +3420,7 @@ declare function SkeletonCard({ hasAvatar, lines, className, style }: SkeletonCa
 interface TextInputProps {
     /** Controlled string value. */
     value?: string;
-    /** Native change handler — read `e.target.value`. */
+    /** Native change handler, read `e.target.value`. */
     onChange?: react__default.ChangeEventHandler<HTMLInputElement>;
     /** Disable interaction and dim the field. */
     disabled?: boolean;
@@ -3440,11 +3440,11 @@ interface TextInputProps {
     style?: react__default.CSSProperties;
     /** Label/input orientation. Defaults to `'vertical'`. */
     layout?: 'horizontal' | 'vertical';
-    /** Size preset — controls height, padding, and font. Default `'md'`. */
+    /** Size preset, controls height, padding, and font. Default `'md'`. */
     size?: FieldSize;
     /** Native blur handler. */
     onBlur?: react__default.FocusEventHandler<HTMLInputElement>;
-    /** Validation message — shown under the input; also flags it red + `aria-invalid`. */
+    /** Validation message, shown under the input; also flags it red + `aria-invalid`. */
     errorMessage?: react__default.ReactNode;
     /** Contextual help revealed via an info icon + tooltip beside the label. */
     helperText?: react__default.ReactNode;
@@ -3460,7 +3460,7 @@ interface TextInputProps {
     id?: string;
 }
 /**
- * Single-line text input. Full-width by default (responsive) — constrain it
+ * Single-line text input. Full-width by default (responsive), constrain it
  * with the parent layout or `style={{ maxWidth }}`. Supports an optional
  * leading `prefix` and trailing `suffix` adornment (icon, unit, etc.).
  *
@@ -3507,7 +3507,7 @@ interface NumberInputProps {
     layout?: 'horizontal' | 'vertical';
     /** Size preset. Default `'md'`. */
     size?: FieldSize;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
     /** Contextual help revealed via an info icon + tooltip beside the label. */
     helperText?: react__default.ReactNode;
@@ -3527,7 +3527,7 @@ interface NumberInputProps {
     min?: number;
     /** Maximum allowed value. */
     max?: number;
-    /** Render read-only — visible but not editable. */
+    /** Render read-only, visible but not editable. */
     readOnly?: boolean;
     /** Optional precision for floating-point steps (number of decimal places to round to). */
     precision?: number;
@@ -3541,7 +3541,7 @@ interface NumberInputProps {
  *   `<span onClick>` which keyboard-only users could not reach.
  * - Floating-point drift on decimal steps (`0.1 + 0.2 = 0.30000000000000004`)
  *   is rounded out via a `precision` prop or auto-inferred from the step.
- * - Empty input resolves to `undefined` instead of `NaN` — works with form
+ * - Empty input resolves to `undefined` instead of `NaN`, works with form
  *   libraries (RHF, Formik) that treat empty as "no value".
  * - The decrement chevron actually points down (the previous SVG was the up
  *   chevron rotated, with the up chevron itself wrongly using the same path).
@@ -3587,11 +3587,11 @@ interface PasswordProps {
     style?: react__default.CSSProperties;
     /** Label/input orientation. Defaults to `'vertical'`. */
     layout?: 'horizontal' | 'vertical';
-    /** Size preset — controls height, padding, and font. Default `'md'`. */
+    /** Size preset, controls height, padding, and font. Default `'md'`. */
     size?: FieldSize;
-    /** Blur handler — useful for touched/validation timing. */
+    /** Blur handler, useful for touched/validation timing. */
     onBlur?: react__default.FocusEventHandler<HTMLInputElement>;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
     /** Contextual help revealed via an info icon + tooltip beside the label. */
     helperText?: react__default.ReactNode;
@@ -3626,7 +3626,7 @@ interface PasswordStrengthResult {
     /** Human label for the score (`''` when empty). */
     label: string;
 }
-/** The default requirement set — also drives the optional checklist. */
+/** The default requirement set, also drives the optional checklist. */
 declare const defaultPasswordRules: PasswordRule[];
 /**
  * Lightweight, dependency-free password scorer (0–4). Rewards length and
@@ -3655,7 +3655,7 @@ interface PasswordStrengthProps {
 }
 /**
  * Password strength meter + (optional) requirement checklist + (optional)
- * confirm-password matcher. Controlled — feed it the current password `value`
+ * confirm-password matcher. Controlled, feed it the current password `value`
  * (and `confirmValue` for the matcher). Scoring is a dependency-free heuristic;
  * override with `scorer`.
  *
@@ -3693,7 +3693,7 @@ interface RadioTileProps {
     label?: react__default.ReactNode;
     /** Widest-breakpoint column count. Default `2`. */
     columns?: 1 | 2 | 3;
-    /** Size preset — controls padding + text. Default `'md'`. */
+    /** Size preset, controls padding + text. Default `'md'`. */
     size?: FieldSize;
     /** Disable the whole group. */
     disabled?: boolean;
@@ -3701,12 +3701,12 @@ interface RadioTileProps {
     required?: boolean;
     /** Contextual help revealed via an info icon beside the label. */
     helperText?: react__default.ReactNode;
-    /** Validation message — shown under the group; flags it red + `aria-invalid`. */
+    /** Validation message, shown under the group; flags it red + `aria-invalid`. */
     errorMessage?: react__default.ReactNode;
     className?: string;
 }
 /**
- * A single-select group of rich, card-style options — icon, title, description,
+ * A single-select group of rich, card-style options, icon, title, description,
  * and an optional corner badge. Built on `@radix-ui/react-radio-group`, so it
  * keeps real radio semantics (roving arrow-key focus, `role="radiogroup"`,
  * native form serialisation via `name`). The selected tile gets an accent
@@ -3788,7 +3788,7 @@ interface CheckboxProps {
     name?: string;
     /** `id` for the control and the `<label htmlFor>` link. */
     htmlFor?: string;
-    /** Validation message — shown under the control; also flags the box red + `aria-invalid`. */
+    /** Validation message, shown under the control; also flags the box red + `aria-invalid`. */
     errorMessage?: react__default.ReactNode;
     /** Contextual help revealed via an info icon + tooltip beside the label. */
     helperText?: react__default.ReactNode;
@@ -3819,7 +3819,7 @@ interface CheckboxProps {
  * Radix handles keyboard activation, focus ring, and `role="checkbox"` ARIA;
  * the check mark pops in with a spring on first check. Supports a secondary
  * `description`, `helperText` tooltip, left/right label placement, and the
- * shared error treatment — so it lines up with every other input in a form.
+ * shared error treatment, so it lines up with every other input in a form.
  *
  * Emits `{ target: { checked, id, name } }` for drop-in use with existing
  * change handlers.
@@ -3870,7 +3870,7 @@ interface RadioGroupProps {
      * `'right'` (default) → dot then label; `'left'` → label then dot.
      */
     labelPosition?: 'left' | 'right';
-    /** Size preset — controls the dot + text size. Default `'md'`. */
+    /** Size preset, controls the dot + text size. Default `'md'`. */
     size?: FieldSize;
     /** Disable interaction and dim the control. */
     disabled?: boolean;
@@ -3880,7 +3880,7 @@ interface RadioGroupProps {
     helperText?: react__default.ReactNode;
     /** Extra classes merged onto the field root element. */
     className?: string;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
 }
 /**
@@ -3926,7 +3926,7 @@ interface SwitchInputProps {
     uncheckedIcon?: react__default.ReactNode;
     /**
      * Central field label, positioned per `layout` (above in vertical, beside
-     * in horizontal) — the same affordance every other input uses.
+     * in horizontal), the same affordance every other input uses.
      */
     label?: react__default.ReactNode;
     /** Label/control orientation. Default `'horizontal'`. */
@@ -3945,7 +3945,7 @@ interface SwitchInputProps {
     required?: boolean;
     /** Disable interaction and dim the control. */
     disabled?: boolean;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
 }
 /**
@@ -3973,7 +3973,7 @@ interface DropdownItem {
     icon?: react__default.ReactNode;
 }
 /**
- * Item key type — DOM-friendly subset of `React.Key` (no bigint, since UI
+ * Item key type, DOM-friendly subset of `React.Key` (no bigint, since UI
  * keys are always strings or numbers in practice).
  */
 type DropdownKey = string | number;
@@ -4001,7 +4001,7 @@ interface DropdownProps {
             name?: string;
         };
     }) => void;
-    /** Blur handler — useful for touched/validation timing. */
+    /** Blur handler, useful for touched/validation timing. */
     onBlur?: react__default.FocusEventHandler;
     /** Disable interaction and dim the control. */
     disabled?: boolean;
@@ -4011,7 +4011,7 @@ interface DropdownProps {
     helperText?: react__default.ReactNode;
     /** Show a required asterisk after the label. */
     required?: boolean;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
     /** Inline style applied to the control shell. */
     style?: react__default.CSSProperties;
@@ -4073,12 +4073,12 @@ interface AutoCompleteProps {
     /** Label/input orientation. Defaults to `'vertical'`. */
     layout?: 'horizontal' | 'vertical';
     /**
-     * Static list — when provided, the component does its own substring
+     * Static list, when provided, the component does its own substring
      * filtering on `label` and `key`. Mutually exclusive with `onSearch`.
      */
     items?: AutoCompleteItem[];
     /**
-     * Async resolver — when provided, `items` is ignored and `onSearch(term)`
+     * Async resolver, when provided, `items` is ignored and `onSearch(term)`
      * is called (debounced) every time the user pauses typing. Its returned
      * promise drives the option list. The component manages an internal
      * `loading` state and shows an `xs` LoadingSpinner where the search icon
@@ -4094,13 +4094,13 @@ interface AutoCompleteProps {
     onItemClick?: (value: string) => void;
     /** Custom "empty" message */
     emptyText?: string;
-    /** Custom "loading" message — shown in async mode while a query is in flight. */
+    /** Custom "loading" message, shown in async mode while a query is in flight. */
     loadingText?: string;
     /** Size preset. Default `'md'`. */
     size?: FieldSize;
     /** Override the leading search icon (hidden while loading). */
     icon?: react__default.ReactNode;
-    /** Validation message — turns the field red and links via aria-describedby. */
+    /** Validation message, turns the field red and links via aria-describedby. */
     errorMessage?: react__default.ReactNode;
     /** Contextual help revealed via an info icon + tooltip beside the label. */
     helperText?: react__default.ReactNode;
@@ -4115,9 +4115,9 @@ interface AutoCompleteProps {
  * Search-as-you-type autocomplete powered by Radix Popover. Supports two
  * modes:
  *
- * - **Static**: pass `items` — the component substring-filters locally.
+ * - **Static**: pass `items`, the component substring-filters locally.
  *   Best for small fixed lists (≤ 200 entries).
- * - **Async**: pass `onSearch(term) => Promise<Item[]>` — the component
+ * - **Async**: pass `onSearch(term) => Promise<Item[]>`, the component
  *   debounces input and drives the option list from the resolver. Shows
  *   an `xs` LoadingSpinner while the query is in flight.
  *
@@ -4155,7 +4155,7 @@ interface TreeSelectNode {
     icon?: react__default.ReactNode;
     /** Nested children. If present, this node is treated as a parent (branch). */
     children?: TreeSelectNode[];
-    /** Render the node disabled — visible but not selectable. */
+    /** Render the node disabled, visible but not selectable. */
     disabled?: boolean;
 }
 interface TreeSelectProps {
@@ -4189,7 +4189,7 @@ interface TreeSelectProps {
     required?: boolean;
     /** Disable interaction and dim the control. */
     disabled?: boolean;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
     /** Inline style applied to the control shell. */
     style?: react__default.CSSProperties;
@@ -4211,12 +4211,12 @@ interface TreeSelectProps {
  * parent.
  *
  * **Keyboard model** (focus is on the trigger or any item):
- * - `Enter` / `Space` / `↓` / `↑` on the trigger — open the popover
- * - `↓` / `↑` — move active item through the visible (un-collapsed) list
- * - `→` — expand a branch (or move into it if already expanded)
- * - `←` — collapse a branch (or move to its parent if already collapsed)
- * - `Enter` / `Space` — select the active item (if selectable)
- * - `Esc` — close the popover, return focus to the trigger
+ * - `Enter` / `Space` / `↓` / `↑` on the trigger, open the popover
+ * - `↓` / `↑`, move active item through the visible (un-collapsed) list
+ * - `→`, expand a branch (or move into it if already expanded)
+ * - `←`, collapse a branch (or move to its parent if already collapsed)
+ * - `Enter` / `Space`, select the active item (if selectable)
+ * - `Esc`, close the popover, return focus to the trigger
  *
  * @example
  * ```tsx
@@ -4264,11 +4264,11 @@ interface FileInputProps {
     accept?: string;
     /** Primary call-to-action copy. Default `'Click to upload or drag and drop'`. */
     prompt?: react__default.ReactNode;
-    /** Secondary hint under the prompt — typically the accepted types / max size. */
+    /** Secondary hint under the prompt, typically the accepted types / max size. */
     hint?: react__default.ReactNode;
     /** Maximum file size in bytes. Files above this are rejected with an error. */
     maxSize?: number;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
     /** Contextual help revealed via an info icon + tooltip beside the label. */
     helperText?: react__default.ReactNode;
@@ -4324,7 +4324,7 @@ interface DatePickerProps {
     required?: boolean;
     /** Disable interaction and dim the control. */
     disabled?: boolean;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
     /** Earliest selectable date. Dates before this render disabled. */
     min?: Date;
@@ -4355,12 +4355,12 @@ type TemporalPickerProps = DatePickerProps;
  * proper row/column context.
  *
  * **Keyboard model** (focus is anywhere inside the grid):
- * - `←` `→` — previous / next day
- * - `↑` `↓` — previous / next week
- * - `PageUp` / `PageDown` — previous / next month
- * - `Home` / `End` — first / last day of the current week
- * - `Enter` / `Space` — select the focused day
- * - `Esc` — close the popover
+ * - `←` `→`, previous / next day
+ * - `↑` `↓`, previous / next week
+ * - `PageUp` / `PageDown`, previous / next month
+ * - `Home` / `End`, first / last day of the current week
+ * - `Enter` / `Space`, select the focused day
+ * - `Esc`, close the popover
  *
  * @example Required date
  * ```tsx
@@ -4389,7 +4389,7 @@ interface TextAreaProps {
     value?: string;
     /** Fires when the value changes. */
     onChange?: react__default.ChangeEventHandler<HTMLTextAreaElement>;
-    /** Blur handler — useful for touched/validation timing. */
+    /** Blur handler, useful for touched/validation timing. */
     onBlur?: react__default.FocusEventHandler<HTMLTextAreaElement>;
     /** Disable interaction and dim the control. */
     disabled?: boolean;
@@ -4403,7 +4403,7 @@ interface TextAreaProps {
     name?: string;
     /** Label/control orientation. Default `'vertical'`. */
     layout?: 'horizontal' | 'vertical';
-    /** Size preset — controls text size + padding. Default `'md'`. */
+    /** Size preset, controls text size + padding. Default `'md'`. */
     size?: FieldSize;
     /** Visible rows when not auto-growing. Default `4`. */
     rows?: number;
@@ -4420,7 +4420,7 @@ interface TextAreaProps {
     showCount?: boolean;
     /** CSS `resize` behaviour. Default `'vertical'` (or `'none'` when autoGrow). */
     resize?: 'none' | 'vertical' | 'horizontal' | 'both';
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
     /** Contextual help revealed via an info icon + tooltip beside the label. */
     helperText?: react__default.ReactNode;
@@ -4484,7 +4484,7 @@ interface SegmentedControlProps {
     name?: string;
     /** Show a required asterisk after the label. */
     required?: boolean;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
     /** Accessible label for the control. */
     'aria-label'?: string;
@@ -4552,11 +4552,11 @@ interface SliderProps {
     marks?: SliderMark[];
     /** Show a value tooltip above the thumb while dragging. */
     tooltip?: boolean;
-    /** Size preset — controls height, padding, and font. Default 'md'. */
+    /** Size preset, controls height, padding, and font. Default 'md'. */
     size?: FieldSize;
     /** Disable interaction and dim the control. */
     disabled?: boolean;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
     /** Contextual help revealed via an info icon + tooltip beside the label. */
     helperText?: react__default.ReactNode;
@@ -4609,11 +4609,11 @@ interface TagsInputProps {
     placeholder?: string;
     /** Label/control orientation: 'horizontal' or 'vertical'. */
     layout?: 'horizontal' | 'vertical';
-    /** Size preset — controls height, padding, and font. Default 'md'. */
+    /** Size preset, controls height, padding, and font. Default 'md'. */
     size?: FieldSize;
     /** Disable interaction and dim the control. */
     disabled?: boolean;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
     /** Contextual help revealed via an info icon + tooltip beside the label. */
     helperText?: react__default.ReactNode;
@@ -4666,11 +4666,11 @@ interface OtpInputProps {
     mode?: 'numeric' | 'alphanumeric';
     /** Render boxes as masked dots (for PIN entry). */
     masked?: boolean;
-    /** Size preset — controls height, padding, and font. Default 'md'. */
+    /** Size preset, controls height, padding, and font. Default 'md'. */
     size?: FieldSize;
     /** Disable interaction and dim the control. */
     disabled?: boolean;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
     /** Show a required asterisk after the label. */
     required?: boolean;
@@ -4712,13 +4712,13 @@ interface RatingProps {
     clearable?: boolean;
     /** Field label, placed above (vertical) or beside (horizontal) the control. */
     label?: react__default.ReactNode;
-    /** Size preset — controls height, padding, and font. Default 'md'. */
+    /** Size preset, controls height, padding, and font. Default 'md'. */
     size?: FieldSize;
     /** Disable interaction and dim the control. */
     disabled?: boolean;
     /** Override the icon. Receives a `filled` flag. Default is a star. */
     icon?: (filled: boolean) => react__default.ReactNode;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
     /** Native form field name (used for FormData serialisation). */
     name?: string;
@@ -4763,7 +4763,7 @@ interface TimePickerProps {
     placeholder?: string;
     /** Label/control orientation: 'horizontal' or 'vertical'. */
     layout?: 'horizontal' | 'vertical';
-    /** Size preset — controls height, padding, and font. Default 'md'. */
+    /** Size preset, controls height, padding, and font. Default 'md'. */
     size?: FieldSize;
     /** Display in 12-hour format with AM/PM (value stays 24h `"HH:mm"`). */
     use12Hours?: boolean;
@@ -4773,7 +4773,7 @@ interface TimePickerProps {
     minuteStep?: number;
     /** Disable interaction and dim the control. */
     disabled?: boolean;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
     /** Contextual help revealed via an info icon + tooltip beside the label. */
     helperText?: react__default.ReactNode;
@@ -4818,7 +4818,7 @@ interface DateRangePickerProps {
     placeholder?: string;
     /** Label/control orientation: 'horizontal' or 'vertical'. */
     layout?: 'horizontal' | 'vertical';
-    /** Size preset — controls height, padding, and font. Default 'md'. */
+    /** Size preset, controls height, padding, and font. Default 'md'. */
     size?: FieldSize;
     /** Earliest selectable date. */
     min?: Date;
@@ -4832,7 +4832,7 @@ interface DateRangePickerProps {
     format?: (d: Date) => string;
     /** Disable interaction and dim the control. */
     disabled?: boolean;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
     /** Contextual help revealed via an info icon + tooltip beside the label. */
     helperText?: react__default.ReactNode;
@@ -4875,7 +4875,7 @@ interface ColorPickerProps {
     name?: string;
     /** Label/control orientation: 'horizontal' or 'vertical'. */
     layout?: 'horizontal' | 'vertical';
-    /** Size preset — controls height, padding, and font. Default 'md'. */
+    /** Size preset, controls height, padding, and font. Default 'md'. */
     size?: FieldSize;
     /** Preset swatches shown in the popover. Defaults to a balanced 12-color set. */
     swatches?: string[];
@@ -4883,7 +4883,7 @@ interface ColorPickerProps {
     allowCustom?: boolean;
     /** Disable interaction and dim the control. */
     disabled?: boolean;
-    /** Validation message — shown under the control; also flags it red and sets aria-invalid. */
+    /** Validation message, shown under the control; also flags it red and sets aria-invalid. */
     errorMessage?: react__default.ReactNode;
     /** Contextual help revealed via an info icon + tooltip beside the label. */
     helperText?: react__default.ReactNode;
@@ -4910,7 +4910,7 @@ declare function ColorPicker({ value, onChange, label, htmlFor, name, layout, si
  * Native, dependency-free validation. A field carries one rule or an array of
  * rules; rules run in order and the first failure wins. Rules are plain data
  * (required / pattern / min / max / length) plus an escape hatch `validate`
- * for anything custom — including async checks (uniqueness, server lookups) and
+ * for anything custom, including async checks (uniqueness, server lookups) and
  * third-party schemas: `validate: (v) => zodSchema.safeParse(v).success ? undefined : 'msg'`.
  */
 type FormValues = Record<string, unknown>;
@@ -4971,7 +4971,7 @@ interface FormStoreOptions {
     rules?: RulesMap;
     /**
      * When a field revalidates. `'onSubmit'` is always implied. Default
-     * `['onChange', 'onBlur', 'onSubmit']` — error appears once a field is
+     * `['onChange', 'onBlur', 'onSubmit']`, error appears once a field is
      * touched and updates live as the user types.
      */
     validateOn?: ValidateTrigger[];
@@ -4981,7 +4981,7 @@ type ErrorMap = Record<string, string | undefined>;
 interface FieldSnapshot {
     value: unknown;
     error: string | undefined;
-    /** touched OR the form was submitted — i.e. "should the error be shown". */
+    /** touched OR the form was submitted, i.e. "should the error be shown". */
     showError: boolean;
 }
 /**
@@ -5040,18 +5040,18 @@ declare class FormStore {
     arrayAppend: (name: string, item?: unknown) => void;
     arrayRemove: (name: string, index: number) => void;
     arrayMove: (name: string, from: number, to: number) => void;
-    /** Drop any errors/touched flags under `name.` — used when an array shifts. */
+    /** Drop any errors/touched flags under `name.`, used when an array shifts. */
     private clearBranch;
 }
 
 /**
  * How a control reports changes, so one binder can drive any of our inputs:
- * - `value`   — `onChange(value)` directly (RadioGroup, Slider, Rating,
+ * - `value`  , `onChange(value)` directly (RadioGroup, Slider, Rating,
  *               SegmentedControl, TagsInput, OtpInput, DatePicker, ColorPicker…)
- * - `native`  — `onChange(e)` reading `e.target.value` (TextInput, Password,
+ * - `native` , `onChange(e)` reading `e.target.value` (TextInput, Password,
  *               TextArea, NumberInput, SearchInput)
- * - `checked` — `onChange({target:{checked}})` (Switch, Checkbox)
- * - `target`  — `onChange({target:{value}})` (Dropdown, TreeSelect)
+ * - `checked`, `onChange({target:{checked}})` (Switch, Checkbox)
+ * - `target` , `onChange({target:{value}})` (Dropdown, TreeSelect)
  */
 type FieldKind = 'value' | 'native' | 'checked' | 'target';
 interface FieldBindings {
@@ -5067,7 +5067,7 @@ interface FieldBindings {
 }
 
 interface UseFormReturn {
-    /** The underlying store — pass to `<Form form={...}>` and for imperative use. */
+    /** The underlying store, pass to `<Form form={...}>` and for imperative use. */
     store: FormStore;
     values: FormValues;
     errors: ErrorMap;
@@ -5106,7 +5106,7 @@ interface UseFormReturn {
  * `useFormField` / `<FormField>` instead of reading everything here.
  *
  * Validation lives at the form level (rules map or per-field `rules` arg), and
- * the inputs only *receive* their error — they never validate themselves.
+ * the inputs only *receive* their error, they never validate themselves.
  *
  * @example
  * ```tsx
@@ -5123,7 +5123,7 @@ interface FormProps extends Omit<react__default.FormHTMLAttributes<HTMLFormEleme
     /** The instance from `useForm()`. */
     form: UseFormReturn;
     /**
-     * SPA submit handler — called with the validated values once all rules
+     * SPA submit handler, called with the validated values once all rules
      * pass. Receiving this puts the form in client mode (`preventDefault`).
      */
     onFinish?: (values: FormValues) => void | Promise<void>;
@@ -5140,7 +5140,7 @@ interface FormProps extends Omit<react__default.FormHTMLAttributes<HTMLFormEleme
 }
 /**
  * Form wrapper. Owns submission: on submit it marks the form submitted, runs
- * every field's rules, and only then dispatches — to `onFinish(values)` in SPA
+ * every field's rules, and only then dispatches, to `onFinish(values)` in SPA
  * mode or to `action` (function or native URL) for SSR. Renders a real
  * `<form noValidate>` so our inputs' `name`s serialise into `FormData` while we
  * still show our own validation messages.
@@ -5155,13 +5155,13 @@ declare function Form({ form, onFinish, onFinishFailed, action, children, ...res
 interface UseFormFieldOptions {
     /** How the control reports changes. Default `'value'`. */
     kind?: FieldKind;
-    /** Rules for this field — registered on the form (and cleaned up on unmount). */
+    /** Rules for this field, registered on the form (and cleaned up on unmount). */
     rules?: FieldRules;
 }
 /**
  * Subscribe a single field to the enclosing `<Form>`. Unlike reading bindings
  * off `useForm()`, this isolates re-renders to just this field via a memoized
- * per-field snapshot — the right choice for large or dynamic forms. Registering
+ * per-field snapshot, the right choice for large or dynamic forms. Registering
  * `rules` here also unregisters them on unmount, which is what makes field
  * arrays validate correctly as rows come and go.
  *
@@ -5188,7 +5188,7 @@ interface FormFieldProps extends UseFormFieldOptions {
 declare function FormField({ name, kind, rules, children }: FormFieldProps): react_jsx_runtime.JSX.Element;
 
 interface FieldArrayItem {
-    /** Stable React key — survives reorders and removals. */
+    /** Stable React key, survives reorders and removals. */
     key: number;
     /** Dotted base path for this row, e.g. `"contacts.2"`. */
     name: string;
@@ -5234,7 +5234,7 @@ type SetValue<T> = (value: T | ((prev: T) => T)) => void;
  * (the native `storage` event) and **across hook instances in the same tab**
  * (a custom event), so two components on the same key stay consistent.
  *
- * @returns `[value, setValue, remove]` — `setValue` accepts a value or an
+ * @returns `[value, setValue, remove]`, `setValue` accepts a value or an
  * updater, like `useState`; `remove` deletes the key and resets to initial.
  *
  * @example
@@ -5298,7 +5298,7 @@ interface JwtResult<T> {
  * re-renders exactly when the token crosses its `exp`, so `isExpired` / `isValid`
  * flip on their own without polling.
  *
- * Decodes only — it never verifies the signature. Treat the result as a UI hint;
+ * Decodes only, it never verifies the signature. Treat the result as a UI hint;
  * real authorization belongs on the server. Pairs with `SecureLayout`.
  *
  * @example
@@ -5366,7 +5366,7 @@ interface JumbotronProps {
     title: react__default.ReactNode;
     /** Supporting paragraph under the title. */
     description?: react__default.ReactNode;
-    /** Call-to-action row — typically one or two `Button`s. */
+    /** Call-to-action row, typically one or two `Button`s. */
     actions?: react__default.ReactNode;
     /** Media (image / screenshot / illustration). Shown beside the copy in
      *  `split`, below it in `centered`. */
@@ -5380,7 +5380,7 @@ interface JumbotronProps {
 }
 /**
  * A landing-page hero ("jumbotron"): an eyebrow, a large headline, a supporting
- * line, and call-to-action buttons — optionally paired with media. `centered`
+ * line, and call-to-action buttons, optionally paired with media. `centered`
  * stacks everything centred; `split` puts the copy next to the media and stacks
  * on small screens. Pair with FeatureGrid / PricingPlans / Testimonials to
  * compose a full page.
@@ -5421,7 +5421,7 @@ interface FeatureGridProps {
     style?: react__default.CSSProperties;
 }
 /**
- * A responsive grid of product features — icon, title, blurb — with an optional
+ * A responsive grid of product features, icon, title, blurb, with an optional
  * section header. Collapses to a single column on mobile.
  *
  * @example
@@ -5501,7 +5501,7 @@ interface TestimonialsProps {
     style?: react__default.CSSProperties;
 }
 /**
- * A wall of customer testimonials — quote, star rating, and author with avatar.
+ * A wall of customer testimonials, quote, star rating, and author with avatar.
  * Responsive grid (single column on mobile); use `columns={1}` for one centred
  * featured quote.
  *
@@ -5626,7 +5626,7 @@ interface BlogPost {
     date?: react__default.ReactNode;
     /** Read time, e.g. `'4 min read'`. */
     readTime?: react__default.ReactNode;
-    /** Link target — renders the card as an anchor. */
+    /** Link target, renders the card as an anchor. */
     href?: string;
     onClick?: () => void;
 }
@@ -5642,7 +5642,7 @@ interface BlogProps {
     style?: react__default.CSSProperties;
 }
 /**
- * A grid of article cards — cover image, tag, title, excerpt, and a byline of
+ * A grid of article cards, cover image, tag, title, excerpt, and a byline of
  * author / date / read-time. Cards link out via `href` or fire `onClick`.
  *
  * @example
@@ -5654,7 +5654,7 @@ declare function Blog({ posts, eyebrow, title, description, columns, centeredHea
 
 type SocialPlatform = 'x' | 'twitter' | 'github' | 'linkedin' | 'youtube' | 'instagram' | 'facebook' | 'mastodon' | 'email' | 'website';
 interface SocialLink {
-    /** Known platform — supplies the icon + default label. */
+    /** Known platform, supplies the icon + default label. */
     platform?: SocialPlatform;
     href: string;
     /** Accessible label / tooltip. Falls back to the platform name. */
@@ -5751,7 +5751,7 @@ interface LeadCaptureProps {
     style?: react__default.CSSProperties;
 }
 /**
- * A footer call-to-action band with an inline email-capture form — title,
+ * A footer call-to-action band with an inline email-capture form, title,
  * supporting copy, an email field, and a submit button. Shows a confirmation in
  * place of the form once submitted.
  *
@@ -5767,7 +5767,7 @@ declare function LeadCapture({ title, description, placeholder, inputLabel, butt
 
 /**
  * Zero-dependency credit-card helpers: brand detection, Luhn checksum, and
- * display formatting. Pure functions — no React, no deps — so they're unit
+ * display formatting. Pure functions, no React, no deps, so they're unit
  * testable and reusable.
  */
 interface CardBrand {
@@ -5794,7 +5794,7 @@ declare const CARD_BRANDS: CardBrand[];
 declare const onlyDigits: (s: string) => string;
 /** Detect the card brand from a (possibly partial) number. `null` if unknown. */
 declare function detectBrand(value: string): CardBrand | null;
-/** Luhn (mod-10) checksum — the standard card-number integrity check. */
+/** Luhn (mod-10) checksum, the standard card-number integrity check. */
 declare function luhnValid(value: string): boolean;
 /** Format a card number with brand-aware grouping (e.g. `4242 4242 4242 4242`). */
 declare function formatCardNumber(value: string): string;