@jfrader/ui 0.5.1 → 0.7.0

package/dist/types/components/shortcut-recorder/index.d.ts

@@ -0,0 +1,2 @@
+export { ShortcutRecorder, normalizeShortcut, matchesShortcut, formatShortcut, useShortcutPlatform, usePressedShortcutKeys, defaultShortcutMessages, } from './shortcut-recorder';
+export type { ShortcutRecorderProps, ShortcutKeysProps, ShortcutListProps, ShortcutPlatform, ShortcutBinding, ShortcutListGroup, ShortcutMessages, KeyboardEventLike, } from './shortcut-recorder';

package/dist/types/components/shortcut-recorder/shortcut-recorder.d.ts

@@ -0,0 +1,117 @@
+import { type ComponentPropsWithRef, type ReactNode } from 'react';
+import { type SxProps } from '../../styling/sx';
+import { type FieldPartProps } from '../field/field-anatomy';
+export type ShortcutPlatform = 'mac' | 'other';
+export interface ShortcutBinding {
+    shortcut: string;
+    label: string;
+}
+export interface ShortcutListGroup {
+    label: string;
+    items: readonly {
+        label: string;
+        shortcut: string;
+        keywords?: string;
+    }[];
+}
+export interface ShortcutMessages {
+    placeholder: string;
+    recording: string;
+    canceled: string;
+    cleared: string;
+    noShortcut: string;
+    clearLabel: string;
+    cancelLabel: string;
+    confirmLabel: string;
+    reset: (spoken: string) => string;
+    set: (spoken: string) => string;
+    requireModifier: (platform: ShortcutPlatform) => string;
+    conflict: (spoken: string, binding: ShortcutBinding, reserved: boolean) => string;
+    listLabel: string;
+    searchLabel: string;
+    searchPlaceholder: string;
+    empty: string;
+    results: (count: number) => string;
+    keyName: (id: string, platform: ShortcutPlatform) => {
+        label: string;
+        spoken: string;
+    };
+}
+export interface KeyboardEventLike {
+    code: string;
+    key: string;
+    ctrlKey: boolean;
+    altKey: boolean;
+    shiftKey: boolean;
+    metaKey: boolean;
+    repeat?: boolean;
+    isComposing?: boolean;
+    getModifierState?: (key: string) => boolean;
+}
+export declare function normalizeShortcut(shortcut: string, platform: ShortcutPlatform): string | null;
+export declare function matchesShortcut(event: KeyboardEventLike, shortcut: string, platform: ShortcutPlatform): boolean;
+export declare const defaultShortcutMessages: ShortcutMessages;
+export declare function formatShortcut(shortcut: string, platform: ShortcutPlatform, messages?: ShortcutMessages): {
+    text: string;
+    spoken: string;
+};
+export declare function useShortcutPlatform(override?: ShortcutPlatform): ShortcutPlatform;
+export declare function usePressedShortcutKeys(enabled?: boolean): ReadonlySet<string>;
+export interface ShortcutKeysProps extends ComponentPropsWithRef<'span'>, SxProps {
+    shortcut: string;
+    platform?: ShortcutPlatform;
+    pressed?: ReadonlySet<string>;
+    size?: 'sm' | 'md';
+    messages?: ShortcutMessages;
+    locale?: Intl.LocalesArgument;
+    slotProps?: {
+        key?: FieldPartProps;
+    };
+}
+declare function ShortcutKeys({ shortcut, platform: platformProp, pressed, size, messages, locale: _locale, slotProps, className, sx, ...rest }: ShortcutKeysProps): import("@emotion/react/jsx-runtime").JSX.Element;
+type RecorderSlot = 'root' | 'label' | 'control' | 'recorder' | 'actions' | 'reset' | 'clear' | 'message' | 'confirm' | 'cancel' | 'description' | 'error' | 'status' | 'key';
+export interface ShortcutRecorderProps extends Omit<ComponentPropsWithRef<'button'>, 'value' | 'defaultValue'>, SxProps {
+    value?: string | null;
+    defaultValue?: string | null;
+    onValueChange?: (value: string | null, details: {
+        replaced?: ShortcutBinding;
+    }) => void;
+    recording?: boolean;
+    defaultRecording?: boolean;
+    onRecordingChange?: (recording: boolean) => void;
+    resetValue?: string | null;
+    bindings?: readonly ShortcutBinding[];
+    reservedBindings?: readonly ShortcutBinding[];
+    warnReserved?: boolean;
+    requireModifier?: boolean;
+    platform?: ShortcutPlatform;
+    label?: ReactNode;
+    description?: ReactNode;
+    error?: ReactNode;
+    hideLabel?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+    locale?: Intl.LocalesArgument;
+    messages?: ShortcutMessages;
+    readOnly?: boolean;
+    slotProps?: Partial<Record<RecorderSlot, FieldPartProps>>;
+}
+declare function ShortcutRecorderRoot({ ref, value, defaultValue, onValueChange, recording, defaultRecording, onRecordingChange, resetValue, bindings, reservedBindings, warnReserved, requireModifier, platform: platformProp, label, description, error, hideLabel, size, locale, messages, readOnly, disabled, name, dir, slotProps, className, sx, onClick, onKeyDown, onKeyUp, onBlur, onFocus, 'aria-labelledby': labelledBy, 'aria-describedby': describedBy, 'aria-invalid': invalid, id, children: _children, ...rest }: ShortcutRecorderProps): import("@emotion/react/jsx-runtime").JSX.Element;
+type ListSlot = 'root' | 'search' | 'groups' | 'group' | 'heading' | 'item' | 'keys' | 'empty' | 'status';
+export interface ShortcutListProps extends ComponentPropsWithRef<'section'>, SxProps {
+    groups: readonly ShortcutListGroup[];
+    searchable?: boolean;
+    highlightPressed?: boolean;
+    platform?: ShortcutPlatform;
+    locale?: Intl.LocalesArgument;
+    messages?: ShortcutMessages;
+    inputValue?: string;
+    defaultInputValue?: string;
+    onInputChange?: (value: string) => void;
+    slotProps?: Partial<Record<ListSlot, FieldPartProps>>;
+}
+declare function ShortcutList({ groups, searchable, highlightPressed, platform, locale, messages, inputValue, defaultInputValue, onInputChange, slotProps, className, sx, ref, ...rest }: ShortcutListProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const ShortcutRecorder: typeof ShortcutRecorderRoot & {
+    Keys: typeof ShortcutKeys;
+    List: typeof ShortcutList;
+};
+export {};

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/stretch-refresh/index.d.ts

@@ -0,0 +1 @@
+export { StretchRefresh, type StretchRefreshProps, type StretchRefreshSlotProps, type StretchRefreshLabels, } from './stretch-refresh';

package/dist/types/components/stretch-refresh/stretch-refresh.d.ts

@@ -0,0 +1,49 @@
+import { type ComponentPropsWithRef, type ReactNode } from 'react';
+import { type Interpolation, type Theme } from '../../styling/css';
+import { type SxProps } from '../../styling/sx';
+import { type ButtonProps } from '../button';
+type Slot<E extends 'div' | 'header' | 'h2' | 'ul' | 'li'> = Omit<ComponentPropsWithRef<E>, 'children'> & {
+    css?: Interpolation<Theme>;
+};
+export interface StretchRefreshSlotProps<T> {
+    header?: Slot<'header'>;
+    title?: Slot<'h2'>;
+    subtitle?: Slot<'div'>;
+    feed?: Slot<'div'>;
+    list?: Slot<'ul'>;
+    item?: Slot<'li'> | ((item: T, index: number) => Slot<'li'>);
+    indicator?: Omit<Slot<'div'>, 'aria-hidden'>;
+    refreshButton?: Omit<ButtonProps, 'children' | 'type' | 'disabled' | 'loading' | 'render' | 'sx'>;
+    status?: Omit<Slot<'div'>, 'role' | 'aria-atomic'>;
+    empty?: Slot<'div'>;
+}
+export interface StretchRefreshLabels {
+    refresh?: string;
+    refreshing?: string;
+    pull?: string;
+    release?: string;
+    done?: string;
+    error?: string;
+}
+export interface StretchRefreshProps<T> extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'title'>, SxProps {
+    title: ReactNode;
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+    subtitle?: ReactNode;
+    items: readonly T[];
+    getKey: (item: T) => string;
+    renderItem: (item: T, index: number) => ReactNode;
+    onRefresh: () => Promise<string | void>;
+    refreshing?: boolean;
+    defaultRefreshing?: boolean;
+    onRefreshingChange?: (refreshing: boolean) => void;
+    disabled?: boolean;
+    threshold?: number;
+    emptyContent?: ReactNode;
+    labels?: StretchRefreshLabels;
+    slotProps?: StretchRefreshSlotProps<T>;
+}
+export declare function StretchRefresh<T>({ title, headingLevel, subtitle, items, getKey, renderItem, onRefresh, refreshing, defaultRefreshing, onRefreshingChange, disabled, threshold: thresholdProp, emptyContent, labels, slotProps, ref, className, sx, onKeyDown, ...props }: StretchRefreshProps<T>): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare namespace StretchRefresh {
+    var displayName: string;
+}
+export {};

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/index.d.ts

@@ -1,2 +1,3 @@
 export { ThemeRoot } from './theme-root';
 export type { ThemeName, ThemeRootProps } from './theme-root';
+export { createTheme, themeTokenStyle, type CreateThemeOptions, type ThemeTokens } from '../../styling/create-theme';

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

@@ -1,17 +1,24 @@
 import { type ComponentPropsWithRef, type ReactNode } from 'react';
+import { type ThemeTokens } from '../../styling/create-theme';
 import { type SxProps } from '../../styling/sx';
 import { type ThemeName } from '../../styling/theme-scope';
 export type { ThemeName };
 export interface ThemeRootProps extends ComponentPropsWithRef<'div'>, SxProps {
+    /** Base palette for this scope. `tokens` overrides its values. */
     theme?: ThemeName;
     /**
-     * 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.
+     * 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;
+    /**
+     * 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;
 }
-export declare function ThemeRoot({ ref, theme, portalContainer, className, sx, ...rest }: ThemeRootProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare function ThemeRoot({ ref, theme, tokens, portalContainer, className, style, sx, ...rest }: ThemeRootProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export declare namespace ThemeRoot {
     var displayName: string;
 }

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/{comment-thread → thread}/thread-parts.d.ts

@@ -71,12 +71,14 @@ export interface ThreadReactionsProps {
     onToggle: (emoji: string) => void;
     pickerId: string;
     part?: ThreadPartProps;
+    overlay?: boolean;
+    counts?: ReadonlyMap<string, number>;
 }
 /**
  * Picker keyboard: Left/Right (mirrored in RTL) wrap across the emoji, Home/End jump; Escape and
  * a chosen emoji close it and return focus to the add button. Pressing outside leaves it open.
  */
-export declare function ThreadReactions({ ui: owner, reactions, offered, currentUserId, formatters, labels, readOnly, disabled, pickerOpen, onPickerOpenChange, onToggle, pickerId, part, }: ThreadReactionsProps): import("@emotion/react/jsx-runtime").JSX.Element | null;
+export declare function ThreadReactions({ ui: owner, reactions, offered, currentUserId, formatters, labels, readOnly, disabled, pickerOpen, onPickerOpenChange, onToggle, pickerId, part, overlay, counts, }: ThreadReactionsProps): import("@emotion/react/jsx-runtime").JSX.Element | null;
 export interface ThreadComposerProps {
     ui: string;
     draft: string;
@@ -108,7 +110,10 @@ export interface ThreadComposerProps {
     part?: ThreadPartProps;
     /** Distinguishes composers inside one thread (`data-composer`). */
     kind: string;
+    submitOnEnter?: boolean;
+    allowEmpty?: boolean;
+    lockWhilePending?: boolean;
 }
 /** Per-size layout variables read by the parts; the owning root applies them. */
 export declare const threadSizeStyles: Record<ThreadSize, SerializedStyles>;
-export declare function ThreadComposer({ ui: owner, draft, onDraftChange, onSubmit, onCancel, cancelOnEscape, cancelable, label, placeholder, submitLabel, cancelLabel, mentionsLabel, people, locale, disabled, pending, autoFocus, size, author, textareaProps, submitProps, part, kind, }: ThreadComposerProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare function ThreadComposer({ ui: owner, draft, onDraftChange, onSubmit, onCancel, cancelOnEscape, cancelable, label, placeholder, submitLabel, cancelLabel, mentionsLabel, people, locale, disabled, pending, autoFocus, size, author, textareaProps, submitProps, part, kind, submitOnEnter, allowEmpty, lockWhilePending, }: ThreadComposerProps): import("@emotion/react/jsx-runtime").JSX.Element;

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/tooltip/tooltip.d.ts

@@ -1,5 +1,5 @@
 import { type ComponentPropsWithRef, type ReactNode } from 'react';
-import { type Placement } from '@floating-ui/react';
+import { type FloatingRootContext, type Placement, type UseInteractionsReturn } from '@floating-ui/react';
 import { type SxProps } from '../../styling/sx';
 export interface TooltipProps {
     open?: boolean;
@@ -16,6 +16,13 @@ export interface TooltipTriggerProps extends ComponentPropsWithRef<'button'>, Sx
 }
 export interface TooltipContentProps extends ComponentPropsWithRef<'div'>, SxProps {
 }
+export declare const tooltipContentStyle: import("@emotion/react").SerializedStyles;
+/** The tooltip interaction chain, shared with parts whose operative element cannot be a Tooltip.Trigger. */
+export declare function useTooltipInteractions(context: FloatingRootContext, { enabled, openDelay, closeDelay, }?: {
+    enabled?: boolean;
+    openDelay?: number;
+    closeDelay?: number;
+}): UseInteractionsReturn;
 declare function TooltipRoot(props: TooltipProps): import("@emotion/react/jsx-runtime").JSX.Element;
 declare function TooltipTrigger({ ref, 'aria-describedby': ariaDescribedByProp, className, sx, ...rest }: TooltipTriggerProps): import("@emotion/react/jsx-runtime").JSX.Element;
 declare function TooltipContent(props: TooltipContentProps): import("@emotion/react/jsx-runtime").JSX.Element | null;

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

@@ -1,7 +1,8 @@
 import { type ComponentPropsWithRef, type ComponentPropsWithoutRef, type ReactNode } from 'react';
 import { type Interpolation, type Theme } from '../../styling/css';
 import { type SxProps } from '../../styling/sx';
-export type UsageMeterState = 'normal' | 'near-limit' | 'over-limit' | 'unavailable';
+import { type UsageMeterState, type UsageMeterSummary } from './usage-model';
+export type { UsageMeterState, UsageMeterSummary } from './usage-model';
 export type UsageMeterSize = 'sm' | 'md' | 'lg';
 export type UsageMeterSelection = {
     kind: 'segment';
@@ -20,17 +21,6 @@ export type UsageMeterItem = UsageMeterSelection & {
     label: string;
     value: number;
 };
-export interface UsageMeterSummary {
-    total: number;
-    limit: number;
-    free: number;
-    over: number;
-    ratio: number;
-    state: UsageMeterState;
-    formattedTotal: string;
-    formattedLimit: string;
-    formattedPercent: string;
-}
 export interface UsageMeterLabels {
     free: string;
     near: string;
@@ -51,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;
@@ -74,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

@@ -0,0 +1,30 @@
+export type UsageMeterState = 'normal' | 'near-limit' | 'over-limit' | 'unavailable';
+export interface UsageMeterSummary {
+    total: number;
+    limit: number;
+    free: number;
+    over: number;
+    ratio: number;
+    state: UsageMeterState;
+    formattedTotal: string;
+    formattedLimit: string;
+    formattedPercent: string;
+}
+export declare const DEFAULT_WARN_AT = 0.9;
+export interface UsageFormats {
+    amount: Intl.NumberFormat;
+    percent: Intl.NumberFormat;
+    index: Intl.NumberFormat;
+}
+export declare function createUsageFormats(locale: Intl.LocalesArgument, numberFormatOptions?: Intl.NumberFormatOptions): UsageFormats;
+interface SummarizeOptions {
+    warnAt?: number;
+    formats: UsageFormats;
+    /** Text for amounts that cannot be computed. */
+    unavailable: string;
+    /** Formats amounts instead of `formats.amount` (consumer unit formatters). */
+    formatAmount?: (amount: number) => string;
+}
+/** 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/index.d.ts

@@ -0,0 +1,2 @@
+export { UserMenu } from './user-menu';
+export type { UserMenuContentProps, UserMenuGroupSlotProps, UserMenuIdentityProps, UserMenuItemProps, UserMenuItemTone, UserMenuPartProps, UserMenuProps, UserMenuSeparatorProps, UserMenuSignOutProps, UserMenuStatus, UserMenuStatusGroupProps, UserMenuTheme, UserMenuThemeGroupProps, UserMenuTriggerProps, UserMenuUser, UserMenuVariant, } from './user-menu';