@jfrader/ui 0.6.0 → 0.7.0

package/dist/types/components/next/emotion-registry.d.ts

@@ -1,14 +1,12 @@
 import { type ReactNode } from 'react';
 export interface EmotionRegistryProps {
-    /** Emotion cache key: the class name prefix and the `data-emotion` attribute value. */
+    /** Sets the Emotion class name prefix and `data-emotion` cache key. Defaults to `'css'`. */
     cacheKey?: string;
     children?: ReactNode;
 }
 /**
- * Emotion SSR registry for the App Router: one shared cache and a flush that only
- * sends the styles inserted since the last pass, so the server and client trees
- * match on hydration. Without it, Emotion inserts <style> nodes inline during SSR
- * and the hydration diff mismatches.
+ * Shares one Emotion cache and emits new styles on each App Router server render pass.
+ * Without it, Emotion inserts inline `<style>` nodes during SSR that cause hydration mismatches.
  */
 export declare function EmotionRegistry({ cacheKey, children }: EmotionRegistryProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export declare namespace EmotionRegistry {

package/dist/types/components/now-playing/now-playing.d.ts

@@ -66,8 +66,8 @@ export interface NowPlayingProps extends Omit<ComponentPropsWithRef<'section'>,
     labels?: Partial<NowPlayingLabels>;
     locale?: Intl.LocalesArgument;
     /**
-     * Seconds per arrow step. Slider requires the duration to be a whole number of steps, so a
-     * step that does not divide it is rounded to the nearest one that does (180s with 7 → 180/26).
+     * Seconds per arrow step. Duration must be a whole number of steps.
+     * A step that does not divide it is rounded to the nearest one that does (180s with 7 → 180/26).
      * Defaults to the largest step of at most one second that divides the duration.
      */
     seekStep?: number;

package/dist/types/components/password-field/password-field.d.ts

@@ -24,7 +24,7 @@ export interface PasswordFieldProps extends Omit<ComponentPropsWithRef<'input'>,
     error?: ReactNode;
     size?: PasswordFieldSize;
     messages?: Partial<PasswordFieldMessages>;
-    /** Replaces the built-in eye; rendered decoratively inside the toggle. */
+    /** Replaces the eye icon inside the toggle; hidden from assistive technology. */
     revealIcon?: (revealed: boolean) => ReactNode;
     slotProps?: PasswordFieldSlotProps;
 }

package/dist/types/components/progress/progress.d.ts

@@ -11,7 +11,7 @@ export interface ProgressProps extends Omit<ComponentPropsWithRef<'div'>, 'child
     max?: number;
     /** Accessible name, rendered visually hidden. */
     label?: ReactNode;
-    /** Human-readable value for assistive tech (aria-valuetext). */
+    /** Value text for assistive technology (aria-valuetext). */
     getValueLabel?: (value: number, max: number) => string;
     slotProps?: {
         indicator?: ProgressPartProps;

package/dist/types/components/select/select.d.ts

@@ -11,7 +11,7 @@ export interface SelectProps {
     onOpenChange?: (open: boolean) => void;
     placement?: Placement;
     disabled?: boolean;
-    /** Renders a hidden input so the value takes part in native form submission. */
+    /** Adds a hidden input to submit the value with a native form. */
     name?: string;
     children?: ReactNode;
 }

package/dist/types/components/sheet-stack/sheet-stack.d.ts

@@ -3,33 +3,36 @@ import { type SxProps } from '../../styling/sx';
 export type SheetStackVariant = 'auto' | 'sheet' | 'dialog';
 export type SheetStackHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
 export interface SheetStackProps {
-    /** Open sheet keys, bottom first. */
+    /** Controls the open panel keys, bottom first. */
     value?: readonly string[];
+    /** Sets the initial uncontrolled stack, bottom first. Defaults to `[]`. */
     defaultValue?: readonly string[];
+    /** Requests a changed ordered stack. Controlled panels change only when `value` updates. */
     onValueChange?: (value: string[]) => void;
-    /** `auto` lays out as a sheet below `breakpoint` and as a centered dialog at or above it. */
+    /** Sets the layout. Defaults to `'auto'`: a sheet below `breakpoint`, a centered dialog at or above it. */
     variant?: SheetStackVariant;
-    /** Layer inline size in CSS px where `auto` switches to the dialog layout. */
+    /** Sets the layer width in CSS pixels where `'auto'` switches to a dialog. Defaults to the `sheetStackBreakpoint` token. */
     breakpoint?: number;
-    /** Draws the layer inside the nearest positioned ancestor; modality stays document-wide. */
+    /** Draws inside the nearest positioned ancestor. Modality stays document-wide, without a page scroll lock. Defaults to `false`. */
     contained?: boolean;
     children: ReactNode;
 }
 export interface SheetStackTriggerProps extends ComponentPropsWithRef<'button'>, SxProps {
-    /** Key of the sheet this trigger pushes. */
+    /** Opens this panel key. An open key removes the panels above it. */
     value: string;
 }
 export interface SheetStackContentProps extends Omit<ComponentPropsWithRef<'div'>, 'onCancel'>, SxProps {
-    /** Stable key, unique within the stack. */
+    /** Identifies this panel. Keep the key stable and unique within the stack. */
     value: string;
-    /** False refuses Escape, backdrop and drag dismissal; Back and Close still work. */
+    /** Allows Escape, backdrop, and drag dismissal. Defaults to `true`. When `false`, Back and Close still work. */
     dismissible?: boolean;
-    /** Dismissal request (Escape, backdrop, drag) on this sheet while on top; `preventDefault()` vetoes it. */
+    /** Receives Escape, backdrop, or drag dismissal requests while this panel is on top. Call `preventDefault()` to keep it open. */
     onCancel?: (event: Event) => void;
-    /** Set false to keep structured content out of the sheet's accessible description. */
+    /** Includes `Description` in the accessible description. Defaults to `true`. Use `false` for structured content. */
     withDescription?: boolean;
 }
 export interface SheetStackTitleProps extends ComponentPropsWithRef<'h2'>, SxProps {
+    /** Sets the heading level. Defaults to `2`. */
     level?: SheetStackHeadingLevel;
 }
 export interface SheetStackDescriptionProps extends ComponentPropsWithRef<'p'>, SxProps {
@@ -37,26 +40,26 @@ export interface SheetStackDescriptionProps extends ComponentPropsWithRef<'p'>,
 export interface SheetStackFooterProps extends ComponentPropsWithRef<'div'>, SxProps {
 }
 export interface SheetStackBackProps extends Omit<ComponentPropsWithRef<'button'>, 'aria-label'>, SxProps {
-    /** Localized accessible name, e.g. "Back to Settings". */
+    /** Names the Back button for assistive technology. Supply a localized name, such as "Back to Settings". */
     label: string;
 }
 export interface SheetStackCloseProps extends Omit<ComponentPropsWithRef<'button'>, 'aria-label'>, SxProps {
-    /** Localized accessible name, e.g. "Close all". */
+    /** Names the Close button for assistive technology. Supply a localized name, such as "Close all". */
     label: string;
 }
 export interface SheetStackActions {
     /** The open keys, bottom first. */
     value: readonly string[];
-    /** Opens `key` on top; an open key truncates the stack back to it. */
+    /** Requests opening `key` on top. An open key removes the panels above it. */
     push: (key: string) => void;
-    /** Closes the top sheet. */
+    /** Requests closing the top panel. Does nothing on an empty stack. */
     pop: () => void;
-    /** Truncates the stack back to the open `key`. */
+    /** Requests removing the panels above an open `key`. A closed key is ignored with a development warning. */
     popTo: (key: string) => void;
-    /** Closes every sheet. */
+    /** Requests closing every panel. Does nothing on an empty stack. */
     close: () => void;
 }
-/** The stack's state and actions; throws outside `<SheetStack>`. */
+/** Returns the stack's state and actions. Throws outside `<SheetStack>`. */
 export declare function useSheetStack(): SheetStackActions;
 declare function SheetStackRoot({ value: valueProp, defaultValue, onValueChange, variant, breakpoint, contained, children, }: SheetStackProps): import("@emotion/react/jsx-runtime").JSX.Element;
 declare function SheetStackTrigger({ ref, value, onClick, className, sx, ...rest }: SheetStackTriggerProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/components/signature-pad/signature-pad.d.ts

@@ -94,10 +94,10 @@ export declare class SignatureExportError extends Error {
 export declare function signatureToPng(strokes: SignatureStroke[], options?: SignatureExportOptions): Promise<Blob>;
 /** The same midpoint-quadratic segments and round caps used by Canvas, with fixed print ink. */
 export declare function signatureToSvg(strokes: SignatureStroke[], options?: SignatureExportOptions): string;
-/** Pointer-only handwriting. Consuming forms must offer typed-name or upload alternatives.
+/** Draw a signature with a pointer. Forms must offer typed-name or upload alternatives.
  * Canvas shortcuts: Mod+Z undo, Shift+Mod+Z/Mod+Y redo, Delete clear, Escape cancel/stop.
  * Samples use 600×260 coordinates; pressure changes round line widths, not speed-based taper.
- * This artifact does not establish identity, consent, or legal validity. */
+ * The drawing does not establish identity, consent or legal validity. */
 export declare function SignaturePad({ ref, apiRef, value: valueProp, defaultValue, onValueChange, color: colorProp, defaultColor, onColorChange, width: widthProp, defaultWidth, onWidthChange, label, description, error, signer, hint, disabled, readOnly, required, replay: showReplay, download, fileName, historyLimit, messages, icons, exportOptions, slotProps, className, sx, dir, style, onPointerDown, onPointerMove, onPointerUp, onPointerCancel, onLostPointerCapture, onKeyDown, 'aria-labelledby': labelledBy, 'aria-describedby': describedBy, ...rest }: SignaturePadProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export declare namespace SignaturePad {
     var displayName: string;

package/dist/types/components/split-button/split-button.d.ts

@@ -9,7 +9,7 @@ export interface SplitButtonProps extends Omit<ComponentPropsWithRef<'div'>, 'ro
     variant?: ButtonVariant;
     tone?: ButtonTone;
     size?: ButtonSize;
-    /** Disables Action, Trigger and items, and asks once for an open menu to close. */
+    /** Disables Action, Trigger and items. Requests closure once if the menu is open. */
     disabled?: boolean;
     open?: boolean;
     defaultOpen?: boolean;
@@ -20,13 +20,12 @@ export interface SplitButtonProps extends Omit<ComponentPropsWithRef<'div'>, 'ro
 }
 export interface SplitButtonActionProps extends Omit<ButtonProps, 'render'> {
     /**
-     * Labels the Action may show. They share one grid cell so the Action keeps the width of the
-     * longest one while its label changes; a label swap fades in.
+     * Labels Action may show. Reserves the width of the longest label; changed labels fade in.
      */
     reserveLabels?: readonly string[];
 }
 type SplitButtonTriggerBaseProps = Omit<ButtonProps, 'render' | 'variant' | 'tone' | 'size' | 'loading' | 'startIcon' | 'endIcon' | 'aria-haspopup' | 'aria-expanded' | 'aria-controls'>;
-/** The Trigger has no visible text: it needs a localized `aria-label` or `aria-labelledby`. */
+/** Trigger has no text. Supply a translated `aria-label` or `aria-labelledby`. */
 export type SplitButtonTriggerProps = SplitButtonTriggerBaseProps & ({
     'aria-label': string;
 } | {

package/dist/types/components/swipe-actions/swipe-actions.d.ts

@@ -13,8 +13,7 @@ export interface SwipeAction {
     tone?: 'neutral' | 'accent' | 'danger';
     disabled?: boolean;
     onSelect: () => void;
-    /** Caller intent that this command keeps its row. Every command closes the rail and the row
-     * never deletes data itself, so this is metadata for the caller's `onSelect`. */
+    /** Caller metadata indicating the row should stay. Commands close the rail but never delete data. */
     keepRow?: boolean;
 }
 type Slot = {

package/dist/types/components/tag-input/tag-input.d.ts

@@ -29,8 +29,7 @@ export interface TagInputSlotProps extends FieldSlotProps<TagInputPartProps> {
 }
 export interface TagInputProps extends Omit<ComponentPropsWithRef<'input'>, 'size' | 'value' | 'defaultValue' | 'type' | 'children'>, SxProps {
     /**
-     * Committed tokens in order. Entries must be unique, nonempty and already normalized; the
-     * component renders them as given and never rewrites a provided list.
+     * Tokens in order. Entries must be unique, nonempty and normalized. The list renders as supplied.
      */
     value?: readonly string[];
     defaultValue?: readonly string[];
@@ -51,7 +50,7 @@ export interface TagInputProps extends Omit<ComponentPropsWithRef<'input'>, 'siz
     normalize?: (draft: string) => string;
     /** Returns a rejection message, or `null` to accept the token. */
     validateToken?: (token: string) => string | null;
-    /** Additions stop at this count; an initial or controlled list longer than it is kept. */
+    /** Maximum token count for additions. Initial and controlled lists beyond this count are kept. */
     maxTokens?: number;
     /** Locale for duplicate comparison and default number formatting. */
     locale?: Intl.LocalesArgument;

package/dist/types/components/theme-root/theme-root.d.ts

@@ -4,17 +4,16 @@ import { type SxProps } from '../../styling/sx';
 import { type ThemeName } from '../../styling/theme-scope';
 export type { ThemeName };
 export interface ThemeRootProps extends ComponentPropsWithRef<'div'>, SxProps {
-    /** The named palette the scope wears; `tokens` are declared over it. */
+    /** Base palette for this scope. `tokens` overrides its values. */
     theme?: ThemeName;
     /**
-     * Token overrides for this scope (`createTheme()` builds them from an accent), declared as inline
-     * custom properties on the root. Omitted: a root naming the enclosing root's theme keeps that
-     * root's tokens; a root naming another theme drops them.
+     * Token overrides, applied as inline custom properties. Use `createTheme()` to derive them from
+     * an accent. Omit to inherit the enclosing root's tokens when the themes match; otherwise none carry over.
      */
     tokens?: ThemeTokens;
     /**
-     * Where overlays inside this root portal to. Omitted: the enclosing ThemeRoot's container, else
-     * the default (`body`). `null`: overlays wait until the host element is set.
+     * Container for this root's overlays. Omit to inherit the enclosing container or use `body`.
+     * With `null`, overlays wait until the host element is set.
      */
     portalContainer?: HTMLElement | null;
     children?: ReactNode;

package/dist/types/components/theme-switch/theme-switch.d.ts

@@ -23,9 +23,9 @@ export interface ThemeSwitchProps extends Omit<SwitchProps, 'value' | 'defaultVa
         darkIcon?: SwitchPartProps;
     };
 }
-/** Composes Switch: Space toggles dark appearance; the accessible name stays stable.
- * The consumer applies the requested theme. The ref reaches Switch's native input.
- * The decorative icon frame is a hidden label for the input, so clicking the glyph toggles too.
+/** Requests light or dark appearance; the app applies the theme.
+ * Space and clicking the icon toggle Switch. Keep its accessible name the same in both states.
+ * The ref points to Switch's input. The icon frame is a hidden label for that input.
  */
 export declare function ThemeSwitch({ value: valueProp, defaultValue, onValueChange, label, iconOnly, lightIcon, darkIcon, transition, loading, className, sx, slotProps, onChange, onClick, dir, id: idProp, ...rest }: ThemeSwitchProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export declare namespace ThemeSwitch {

package/dist/types/components/time-picker/time-picker.d.ts

@@ -27,7 +27,7 @@ export interface TimePickerProps extends Omit<ComponentPropsWithRef<'button'>, '
     minuteStep?: TimePickerMinuteStep;
     min?: string;
     max?: string;
-    /** Supply a locale for deterministic server rendering. */
+    /** Supply a locale so server and client text match. */
     locale?: string;
     hourCycle?: TimePickerHourCycle;
     label?: ReactNode;
@@ -36,7 +36,7 @@ export interface TimePickerProps extends Omit<ComponentPropsWithRef<'button'>, '
     placeholder?: ReactNode;
     size?: TimePickerSize;
     readOnly?: boolean;
-    /** Semantic only: the hidden form field does not enforce native required validation. */
+    /** Announces required state; the hidden form field does not enforce browser validation. */
     required?: boolean;
     icon?: ReactNode;
     slotProps?: TimePickerSlotProps;

package/dist/types/components/timeline/timeline.d.ts

@@ -11,10 +11,10 @@ export interface TimelineEvent {
     at: string | number | Date;
     /** Who acted; shown as text next to the title. */
     actor?: string;
-    /** Literal outcome ("Deploy failed"), so tone is never the only cue. */
+    /** Outcome text, such as "Deploy failed", to show state alongside tone. */
     title: ReactNode;
     meta?: ReactNode;
-    /** Content (including 0; not false, null or '') makes the title a disclosure button for this panel. */
+    /** Panel content. Makes the title a disclosure button; 0 counts as content, false/null/'' do not. */
     detail?: ReactNode;
     /** Actor portrait URL; takes precedence over `icon`. */
     avatar?: string;
@@ -47,12 +47,12 @@ export interface TimelineProps extends Omit<ComponentPropsWithRef<'div'>, 'defau
     defaultValue?: readonly string[];
     /** Requested open ids after a disclosure interaction. */
     onValueChange?: (ids: string[]) => void;
-    /** Formatting locale; pass one explicitly for matching server and client output. */
+    /** Formatting locale. Supply one so server and client output match. */
     locale?: Intl.LocalesArgument;
     /** IANA zone used for day grouping and every displayed date. */
     timeZone?: string;
     headingLevel?: TimelineHeadingLevel;
-    /** Bounds the timeline in its own scroller; without it the timeline grows in page flow. */
+    /** Height limit for the timeline's scroller. Without it, the timeline grows with the page. */
     maxHeight?: CSSProperties['maxHeight'];
     /** Scroll to an event newer than any shown before. Never moves focus. */
     scrollToNew?: boolean;

package/dist/types/components/toast/toast.d.ts

@@ -10,7 +10,7 @@ export interface ToastOptions {
     title?: ReactNode;
     description?: ReactNode;
     tone?: ToastTone;
-    /** Milliseconds before auto-dismiss; `null` persists until dismissed. Defaults to the provider's. */
+    /** Milliseconds before dismissal. `null` keeps the toast open; omitted uses the provider's delay. */
     duration?: number | null;
     action?: ToastAction;
     /** Decorative spinner; an omitted duration persists while loading. */
@@ -18,9 +18,9 @@ export interface ToastOptions {
 }
 export interface ToastProviderProps {
     children?: ReactNode;
-    /** Maximum toasts kept; adding past it removes the oldest immediately. */
+    /** Maximum toasts kept. Adding beyond this count removes the oldest immediately. */
     max?: number;
-    /** Default delay, captured at enqueue time; changes do not retime existing toasts. */
+    /** Default delay when a toast is added. Changes do not affect existing toasts. */
     duration?: number;
     /** Accessible label for each toast's close button. */
     dismissLabel?: string;

package/dist/types/components/tree-view/tree-view.d.ts

@@ -38,9 +38,10 @@ export interface TreeViewProps extends Omit<ComponentPropsWithRef<'div'>, 'child
     locale?: Intl.LocalesArgument;
     slotProps?: TreeViewSlotProps;
 }
-/** Single-select APG tree with real roving focus. Right opens/enters and Left closes/parents,
- * including RTL. Up/Down clamp; Home/End jump; Enter/Space select; typeahead resets after 500ms.
- * Lazy results are cached per instance; remount with a new key to replace the dataset cache. */
+/** APG tree with one selection and roving focus.
+ * Right expands or enters; Left collapses or moves to the parent, including in RTL.
+ * Up/Down stop at the ends; Home/End jump; Enter/Space select. Typeahead resets after 500ms.
+ * Loaded children are cached per instance. Remount with a new key to replace the cache. */
 export declare function TreeView({ nodes, value, defaultValue, onValueChange, open, defaultOpen, onOpenChange, loadChildren, onLoadError, label, messages: messageProps, empty, treeRef, locale, slotProps, ref, className, sx, onKeyDown, onClick, onBlur, 'aria-label': ariaLabel, 'aria-labelledby': labelledBy, 'aria-describedby': describedBy, ...rest }: TreeViewProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export declare namespace TreeView {
     var displayName: string;

package/dist/types/components/typewriter-terminal/index.d.ts

@@ -0,0 +1,2 @@
+export { TypewriterTerminal } from './typewriter-terminal';
+export type { TypewriterTerminalProps, TypewriterTerminalLabels, TypewriterTerminalSlotProps, TerminalStep, TerminalOutput, TerminalLine, TerminalProgress, TerminalTask, TerminalTone, } from './typewriter-terminal';

package/dist/types/components/typewriter-terminal/typewriter-terminal.d.ts

@@ -0,0 +1,87 @@
+import { type ComponentPropsWithRef, type ComponentPropsWithoutRef, type JSX, type ReactNode } from 'react';
+import { type Interpolation, type Theme } from '../../styling/css';
+import { type SxProps } from '../../styling/sx';
+export type TerminalTone = 'neutral' | 'muted' | 'success' | 'warning' | 'danger' | 'accent';
+export interface TerminalLine {
+    text: string;
+    tone?: TerminalTone;
+    delayMs?: number;
+    href?: string;
+}
+export interface TerminalProgress {
+    kind: 'progress';
+    label: string;
+    durationMs?: number;
+}
+export interface TerminalTask {
+    kind: 'task';
+    label: string;
+    durationMs?: number;
+    doneLabel?: string;
+}
+export type TerminalOutput = string | TerminalLine | TerminalProgress | TerminalTask;
+export interface TerminalStep {
+    command: string;
+    output?: readonly TerminalOutput[];
+    cwd?: string;
+    pauseMs?: number;
+}
+export interface TypewriterTerminalLabels {
+    play: string;
+    pause: string;
+    replay: string;
+    copy: string;
+    seek: string;
+    copied: string;
+    copyError: string;
+    playing: string;
+    paused: string;
+    replayed: string;
+    step: (step: number, command: string) => string;
+    tones: Record<TerminalTone, string>;
+    completed: string;
+}
+type Slot<E extends keyof JSX.IntrinsicElements> = ComponentPropsWithoutRef<E> & {
+    css?: Interpolation<Theme>;
+};
+export interface TypewriterTerminalSlotProps {
+    header?: Slot<'header'>;
+    screen?: Slot<'div'>;
+    transcript?: Slot<'ol'>;
+    controls?: Slot<'div'>;
+    scrubber?: Slot<'input'>;
+    playButton?: Slot<'button'>;
+    replayButton?: Slot<'button'>;
+    copyButton?: Slot<'button'>;
+    caption?: Slot<'figcaption'>;
+    status?: Slot<'div'>;
+}
+export interface TypewriterTerminalProps extends Omit<ComponentPropsWithRef<'figure'>, 'children' | 'onChange'>, SxProps {
+    steps: readonly TerminalStep[];
+    title?: string;
+    cwd?: string;
+    symbol?: string;
+    value?: number;
+    defaultValue?: number;
+    onValueChange?: (value: number) => void;
+    paused?: boolean;
+    defaultPaused?: boolean;
+    onPausedChange?: (paused: boolean) => void;
+    speed?: number;
+    loop?: boolean;
+    rows?: number;
+    copyable?: boolean;
+    caption?: ReactNode;
+    label?: string;
+    labels?: Partial<Omit<TypewriterTerminalLabels, 'tones'>> & {
+        tones?: Partial<Record<TerminalTone, string>>;
+    };
+    locale?: Intl.LocalesArgument;
+    slotProps?: TypewriterTerminalSlotProps;
+}
+/** Scripted playback only. Native buttons; slider arrows/Page keys jump command boundaries. */
+export declare function TypewriterTerminal({ ref, steps, title, cwd, symbol, value, defaultValue, onValueChange, paused, defaultPaused, onPausedChange, speed, loop, rows, copyable, caption, label, labels: labelsProp, locale, slotProps, className, sx, style, 'aria-labelledby': labelledBy, 'aria-describedby': describedBy, ...rest }: TypewriterTerminalProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare namespace TypewriterTerminal {
+    var displayName: string;
+}
+export {};

package/dist/types/components/usage-meter/usage-meter.d.ts

@@ -41,7 +41,7 @@ export interface UsageMeterProps extends Omit<ComponentPropsWithRef<'div'>, 'chi
     locale?: Intl.LocalesArgument;
     numberFormatOptions?: Intl.NumberFormatOptions;
     unitLabel?: ReactNode;
-    /** English defaults; translation callbacks also localize relational value copy. */
+    /** Defaults to English. Use the value-label callbacks to translate comparison text too. */
     labels?: Partial<UsageMeterLabels>;
     getValueLabel?: (summary: UsageMeterSummary) => string;
     getItemLabel?: (item: UsageMeterItem, summary: UsageMeterSummary) => string;
@@ -64,9 +64,9 @@ export interface UsageMeterProps extends Omit<ComponentPropsWithRef<'div'>, 'chi
         item?: UsageMeterPartProps<'button'>;
     };
 }
-/** Finite allowance, not task progress. The meter is not focusable; legend arrows/Home/End
- * move focus, Enter/Space toggle a pin, and Escape clears it. Numeric ARIA saturates at the
- * allowance while visible text and aria-valuetext retain actual overuse. */
+/** Shows usage against an allowance, not task progress. The meter cannot receive focus.
+ * Legend arrows/Home/End move focus; Enter/Space toggle a pin; Escape clears it.
+ * Numeric ARIA stops at the allowance. Displayed text and aria-valuetext include overuse. */
 export declare function UsageMeter({ ref, label, segments, limit, warnAt, size, locale, numberFormatOptions, unitLabel, labels: labelsProp, getValueLabel, getItemLabel, interactive, value, defaultValue, onValueChange, announceChanges, statusIcon, slotProps, className, sx, 'aria-labelledby': labelledBy, 'aria-describedby': describedBy, 'aria-label': ariaLabel, ...rest }: UsageMeterProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export declare namespace UsageMeter {
     var displayName: string;

package/dist/types/components/usage-meter/usage-model.d.ts

@@ -25,6 +25,6 @@ interface SummarizeOptions {
     /** Formats amounts instead of `formats.amount` (consumer unit formatters). */
     formatAmount?: (amount: number) => string;
 }
-/** Summarizes `total` against `limit`; nonpositive or nonfinite limits are `unavailable`. */
+/** Compares `total` with `limit`. Limits at or below 0, or nonfinite limits, are `unavailable`. */
 export declare function summarizeUsage(total: number, limit: number, { warnAt, formats, unavailable, formatAmount }: SummarizeOptions): UsageMeterSummary;
 export {};

package/dist/types/components/user-menu/user-menu.d.ts

@@ -13,7 +13,7 @@ export type UserMenuItemTone = MenuItemTone;
 export interface UserMenuUser {
     name: string;
     email: string;
-    /** Plan or role label shown next to the email; `0` renders. */
+    /** Plan or role shown next to the email. `0` renders. */
     plan?: ReactNode;
     avatarSrc?: string;
 }
@@ -59,14 +59,13 @@ export type UserMenuContentProps = UserMenuContentBaseProps & ({
 export interface UserMenuIdentityProps extends ComponentPropsWithRef<'div'>, SxProps {
 }
 export interface UserMenuItemProps extends Omit<ComponentPropsWithRef<'button'>, 'onSelect'>, SxProps {
-    /** Called once when the item is activated. The menu then closes unless a click handler called
-     * `event.preventDefault()`. */
+    /** Called once on activation. The menu closes unless a click handler called `event.preventDefault()`. */
     onSelect?: () => void;
     disabled?: boolean;
     tone?: UserMenuItemTone;
     /** Decorative icon before the label. */
     icon?: ReactNode;
-    /** Shortcut hint keys, shown as decoration only; no shortcut is registered. */
+    /** Displays shortcut keys without registering a shortcut. */
     keys?: readonly string[];
 }
 export interface UserMenuGroupSlotProps {

package/dist/types/index.d.ts

@@ -29,14 +29,17 @@ export * from './components/date-range-picker';
 export * from './components/dialog';
 export * from './components/divider';
 export * from './components/drawer';
+export * from './components/emblem';
 export * from './components/empty-state';
 export * from './components/expandable-card';
 export * from './components/expanding-search';
 export * from './components/file-dropzone';
 export * from './components/filter-toolbar';
 export * from './components/flex';
+export * from './components/game-card';
 export * from './components/hold-to-confirm';
 export * from './components/image-compare';
+export * from './components/in-view-title';
 export * from './components/inline-edit';
 export * from './components/hover-card';
 export * from './components/json-viewer';
@@ -91,6 +94,7 @@ export * from './components/toast-stack';
 export * from './components/toggle-group';
 export * from './components/tooltip';
 export * from './components/tree-view';
+export * from './components/typewriter-terminal';
 export * from './components/usage-meter';
 export * from './components/user-menu';
 export { styled } from './styling/styled';

package/dist/types/styling/motion-timings.d.ts

@@ -0,0 +1,5 @@
+export declare const motionDurationMs: {
+    readonly fast: number;
+    readonly base: number;
+    readonly slow: number;
+};

package/dist/types/styling/sx.d.ts

@@ -1,7 +1,7 @@
 import type { ReactNode } from 'react';
 import { type Interpolation, type Theme } from './css';
 export interface SxProps {
-    /** Consumer style overrides, identical to `css` and applied after it (`sx` is the MUI-style spelling). */
+    /** Style overrides. Accepts the same values as `css` and applies after it. */
     sx?: Interpolation<Theme>;
 }
 interface ClassNameProps {

package/dist/types/styling/theme.d.ts

@@ -37,6 +37,9 @@ export declare const theme: {
         readonly signatureInkBlack: "var(--ui-color-signature-ink-black)";
         readonly signatureInkBlue: "var(--ui-color-signature-ink-blue)";
         readonly signatureInkViolet: "var(--ui-color-signature-ink-violet)";
+        readonly cardFace: "var(--ui-color-card-face)";
+        readonly cardInk: "var(--ui-color-card-ink)";
+        readonly cardRed: "var(--ui-color-card-red)";
         readonly scrim: "var(--ui-color-scrim)";
         readonly syntaxKeyword: "var(--ui-color-syntax-keyword)";
         readonly syntaxString: "var(--ui-color-syntax-string)";
@@ -103,6 +106,13 @@ export declare const theme: {
         readonly easeStandard: "var(--ui-motion-ease-standard)";
     };
     readonly size: {
+        readonly emblemSm: "var(--ui-size-emblem-sm)";
+        readonly emblemMd: "var(--ui-size-emblem-md)";
+        readonly emblemLg: "var(--ui-size-emblem-lg)";
+        readonly emblemXl: "var(--ui-size-emblem-xl)";
+        readonly gameCardSm: "var(--ui-size-game-card-sm)";
+        readonly gameCardMd: "var(--ui-size-game-card-md)";
+        readonly gameCardLg: "var(--ui-size-game-card-lg)";
         readonly sheetStackBreakpoint: "var(--ui-size-sheet-stack-breakpoint)";
         readonly sheetStackSheetPeek: "var(--ui-size-sheet-stack-sheet-peek)";
         readonly sheetStackDialogPeek: "var(--ui-size-sheet-stack-dialog-peek)";

package/dist/types/utils/initials.d.ts

@@ -0,0 +1,2 @@
+/** First grapheme of up to `max` words of `name`, joined and uppercased for the current locale. */
+export declare function getInitials(name: string, max: number): string;