@jfrader/ui 0.5.1 → 0.7.0

package/dist/types/components/link-unfurl/link-unfurl.d.ts

@@ -0,0 +1,104 @@
+import { type ComponentPropsWithoutRef, type ComponentPropsWithRef, type ReactNode } from 'react';
+import { type Interpolation, type Theme } from '../../styling/css';
+import { type SxProps } from '../../styling/sx';
+export type LinkUnfurlPreviewStatus = 'pending' | 'ready' | 'none' | 'error';
+export interface LinkUnfurlPreview {
+    /** Identifies the link from the `onPreviewRequest` context. */
+    linkId: string;
+    /** Identifies the request being answered. Other request ids are ignored. */
+    requestId: string;
+    url: string;
+    status: LinkUnfurlPreviewStatus;
+    site?: string;
+    title?: string;
+    description?: ReactNode;
+    /** Shows a preview image. Describe it with `alt`, or use `''` if it adds no information. */
+    image?: {
+        src: string;
+        alt: string;
+    };
+    /** Decorative site icon URL. */
+    favicon?: string;
+    /** Shown instead of `labels.noPreview` when the status is `error`. */
+    error?: string;
+}
+export interface LinkUnfurlPreviewRequestContext {
+    linkId: string;
+    requestId: string;
+    signal: AbortSignal;
+}
+export interface LinkUnfurlSuggestion {
+    url: string;
+    label: string;
+}
+export interface LinkUnfurlMessage {
+    text: string;
+    previews: LinkUnfurlPreview[];
+}
+export interface LinkUnfurlLabels {
+    send: string;
+    expand: string;
+    collapse: string;
+    remove: string;
+    retry: string;
+    pending: string;
+    noPreview: string;
+    sent: string;
+    error: string;
+    /** Keyboard description read with the field. */
+    hint: string;
+}
+interface SlotStyle {
+    className?: string;
+    css?: Interpolation<Theme>;
+}
+type PartProps<E extends 'div' | 'a' | 'img' | 'p' | 'button'> = Omit<ComponentPropsWithoutRef<E>, 'children' | 'id' | 'className' | 'dangerouslySetInnerHTML'> & SlotStyle;
+export interface LinkUnfurlSlotProps {
+    field?: Omit<ComponentPropsWithRef<'textarea'>, 'children' | 'id' | 'value' | 'defaultValue' | 'readOnly' | 'className' | 'dangerouslySetInnerHTML'> & SlotStyle;
+    lane?: PartProps<'div'>;
+    /** Styles the preview item. Animation and drag handlers are reserved for its layout animation. */
+    chip?: Omit<PartProps<'div'>, 'onAnimationStart' | 'onDrag' | 'onDragStart' | 'onDragEnd'>;
+    card?: Omit<PartProps<'div'>, 'hidden' | 'inert'>;
+    title?: Omit<PartProps<'a'>, 'href'>;
+    image?: Omit<PartProps<'img'>, 'src' | 'alt'>;
+    controls?: PartProps<'div'>;
+    send?: Omit<PartProps<'button'>, 'type' | 'disabled'>;
+    status?: Omit<PartProps<'div'>, 'role' | 'aria-live' | 'aria-atomic'>;
+    error?: Omit<PartProps<'p'>, 'role'>;
+}
+export interface LinkUnfurlProps extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'defaultValue' | 'onChange'>, SxProps {
+    /** Labels the message field. */
+    label: string;
+    /** Controls the draft text. */
+    value?: string;
+    /** Sets the initial uncontrolled text. Defaults to `''`. */
+    defaultValue?: string;
+    /** Requests new draft text. Controlled text changes only when `value` updates. */
+    onValueChange?: (text: string) => void;
+    /** Supplies preview records matching the current link and request ids. Defaults to `[]`. */
+    previews?: LinkUnfurlPreview[];
+    /** Requests metadata after user actions. Fetch in your app and use the supplied abort signal. */
+    onPreviewRequest?: (url: string, context: LinkUnfurlPreviewRequestContext) => void;
+    /** Controls which link ids have open previews, independently of `value`. */
+    expanded?: string[];
+    /** Sets the initially open link ids. Defaults to `[]`. */
+    defaultExpanded?: string[];
+    /** Requests open link ids. Controlled previews change only when `expanded` updates. */
+    onExpandedChange?: (ids: string[]) => void;
+    /** Adds buttons that insert URLs at the selection. Defaults to `[]`. */
+    suggestions?: LinkUnfurlSuggestion[];
+    /** Enables sending. A returned promise keeps the composer pending until it settles. */
+    onSend?: (message: LinkUnfurlMessage) => void | Promise<unknown>;
+    /** Replaces the default English labels and keyboard hint. */
+    labels?: Partial<LinkUnfurlLabels>;
+    /** Locale for the joined status announcements. */
+    locale?: Intl.LocalesArgument;
+    /** Sets animation behavior. Defaults to `'auto'`, respecting reduced motion. `'none'` disables animation. */
+    motion?: 'auto' | 'none';
+    slotProps?: LinkUnfurlSlotProps;
+}
+export declare function LinkUnfurl({ ref, label, value: valueProp, defaultValue, onValueChange, previews, onPreviewRequest, expanded: expandedProp, defaultExpanded, onExpandedChange, suggestions, onSend, labels: labelsProp, locale, motion: motionMode, slotProps, className, sx, ...rest }: LinkUnfurlProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare namespace LinkUnfurl {
+    var displayName: string;
+}
+export {};

package/dist/types/components/locale-switcher/index.d.ts

@@ -0,0 +1,2 @@
+export { LocaleSwitcher } from './locale-switcher';
+export type { LocaleSwitcherLinkProps, LocaleSwitcherOption, LocaleSwitcherProps, LocaleSwitcherSize, LocaleSwitcherSlotProps, LocaleSwitcherVariant, } from './locale-switcher';

package/dist/types/components/locale-switcher/locale-switcher.d.ts

@@ -0,0 +1,64 @@
+import { type ComponentPropsWithoutRef, type ComponentPropsWithRef, type ReactNode } from 'react';
+import { type Placement } from '@floating-ui/react';
+import { type Interpolation, type Theme } from '../../styling/css';
+import { type SxProps } from '../../styling/sx';
+export type LocaleSwitcherVariant = 'menu' | 'swap' | 'inline' | 'segmented';
+export type LocaleSwitcherSize = 'sm' | 'md' | 'lg';
+/** Spread these props onto the link returned by an option's `render` callback. */
+export interface LocaleSwitcherLinkProps extends Omit<ComponentPropsWithRef<'a'>, 'href' | 'children'> {
+    href: string;
+    children: ReactNode;
+    'data-ui': string;
+}
+export interface LocaleSwitcherOption {
+    value: string;
+    /** Labels the language with its native name, such as "Español" or "English". */
+    label: ReactNode;
+    /** Names the option for assistive technology when `label` is a short code, such as "ES". */
+    ariaLabel?: string;
+    /** Sets the label and linked page's BCP 47 language tag through `lang` and `hreflang`. */
+    lang?: string;
+    href: string;
+    /** Replaces the native `<a>` with a router link. Spread every supplied prop onto it. */
+    render?: (props: LocaleSwitcherLinkProps) => ReactNode;
+}
+type SlotStyle = {
+    className?: string;
+    css?: Interpolation<Theme>;
+};
+export interface LocaleSwitcherSlotProps {
+    /** Menu variant's trigger button. */
+    trigger?: Omit<ComponentPropsWithoutRef<'button'>, 'children' | 'className' | 'aria-labelledby'> & SlotStyle;
+    /** Menu variant's popup. */
+    content?: Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'className'> & SlotStyle;
+    /** Styles every option: menu items, the swap link, inline links, and the current label. */
+    option?: SlotStyle;
+}
+export interface LocaleSwitcherProps extends Omit<ComponentPropsWithRef<'nav'>, 'children'>, SxProps {
+    options: readonly LocaleSwitcherOption[];
+    /** Identifies the current language option. */
+    value: string;
+    /** Sets the link layout. Defaults to `'menu'`. */
+    variant?: LocaleSwitcherVariant;
+    /** Sets the text and menu trigger size. Defaults to `'md'`. */
+    size?: LocaleSwitcherSize;
+    /** Names the menu trigger's action, such as "Change language". Read before the current label. */
+    triggerLabel?: string;
+    /** Names the navigation landmark in the inline and segmented variants. */
+    label?: string;
+    /** Shows a decorative icon before the menu's current label. Defaults to a globe. `null` removes it. */
+    icon?: ReactNode;
+    /** Controls whether the menu is open. */
+    open?: boolean;
+    /** Sets the menu's initial uncontrolled open state. */
+    defaultOpen?: boolean;
+    /** Requests a menu open-state change. */
+    onOpenChange?: (open: boolean) => void;
+    placement?: Placement;
+    slotProps?: LocaleSwitcherSlotProps;
+}
+export declare function LocaleSwitcher({ ref, options, value, variant, size, triggerLabel, label, icon, open, defaultOpen, onOpenChange, placement, slotProps, className, sx, ...rest }: LocaleSwitcherProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare namespace LocaleSwitcher {
+    var displayName: string;
+}
+export {};

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

@@ -9,7 +9,7 @@ export interface Mention {
     readonly start: number;
     readonly end: number;
 }
-/** Ranges are immutable UTF-16 half-open offsets, matching native textarea selection. */
+/** Immutable UTF-16 `[start,end)` offsets, matching textarea selection. */
 export interface MentionValue {
     readonly text: string;
     readonly mentions: readonly Mention[];
@@ -73,13 +73,13 @@ export interface MentionInputProps extends Omit<ComponentPropsWithRef<'textarea'
     slotProps?: Partial<Record<Part, FieldPartProps>>;
 }
 export declare function mentionText(kind: MentionKind, label: string): string;
-/** Invalid metadata is omitted; plain text is always preserved. The caller owns storage escaping. */
+/** Omits invalid metadata and keeps plain text. The caller handles storage escaping. */
 export declare function serializeMentions(value: MentionValue, format?: (mention: Mention) => string): string;
-/** Native multiline textbox in a combobox semantic wrapper with virtual focus.
- * Enter/Tab commit; Space edits;
- * Shift+Tab leaves, Home/End edit, Escape dismisses. Pair input/mirror metric overrides.
- * Native text undo is best-effort across engines; stale metadata is deliberately dropped.
- * Intended for message-sized documents, not rich-text editing. */
+/** Write a message and mention people with @ or channels with #.
+ * The textarea keeps multiline semantics and DOM focus inside a combobox wrapper.
+ * Enter/Tab insert a result; Space edits; Shift+Tab leaves; Home/End move the caret; Escape dismisses.
+ * Pair input/mirror metric overrides. Native text undo depends on the browser; stale metadata is dropped.
+ * Use for message-sized documents, not rich-text editing. */
 export declare function MentionInput({ ref, actionsRef, value: valueProp, defaultValue, onValueChange, open: openProp, defaultOpen, onOpenChange, people, channels, onMentionAdd, onSubmit, submitOnEnter, label, description, error, size, minRows, maxRows, maxSuggestions, placement, locale, messages, renderSuggestion, slotProps, className, sx, id, dir, required, disabled, readOnly, onChange, onInput, onKeyDown, onSelect, onFocus, onBlur, onScroll, onCompositionStart, onCompositionEnd, 'aria-labelledby': labelledBy, 'aria-describedby': describedBy, 'aria-invalid': invalid, ...rest }: MentionInputProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export declare namespace MentionInput {
     var displayName: string;

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

@@ -1,4 +1,4 @@
-import { type ComponentPropsWithRef, type CSSProperties, type HTMLProps, type MutableRefObject, type ReactNode } from 'react';
+import { type ComponentPropsWithRef, type CSSProperties, type HTMLAttributes, type HTMLProps, type MutableRefObject, type ReactNode, type RefCallback } from 'react';
 import { type Placement, type UseInteractionsReturn } from '@floating-ui/react';
 import { type Interpolation, type SerializedStyles, type Theme } from '../../styling/css';
 import { type SxProps } from '../../styling/sx';
@@ -54,12 +54,21 @@ export interface MenuPartIdentity {
     marker: string;
     styles?: Interpolation<Theme>;
 }
-/** Item behavior a family may change: the part name in usage errors, the item role and whether
- * selection closes the menu. */
+/** Props a menu item's `render` callback spreads onto the element it returns. */
+export interface MenuItemRenderProps extends HTMLAttributes<HTMLElement> {
+    ref: RefCallback<HTMLElement> | null;
+    'data-ui': string;
+}
+/** Item behavior a family may change: the part name in usage errors, the item role, whether
+ * selection closes the menu, `busy` (an item that stays focusable and navigable but ignores
+ * activation, exposed as aria-busy and aria-disabled) and `render`, which replaces the native
+ * button (e.g. with an <a href>). */
 export interface MenuItemPartBehavior {
     part?: string;
-    itemRole?: 'menuitem' | 'menuitemcheckbox';
+    itemRole?: 'menuitem' | 'menuitemcheckbox' | 'menuitemradio';
     closeOnSelect?: boolean;
+    busy?: boolean;
+    render?: (props: MenuItemRenderProps) => ReactNode;
 }
 export declare function useMenuContext(family: string, part: string): MenuContextValue;
 /**
@@ -67,12 +76,18 @@ export declare function useMenuContext(family: string, part: string): MenuContex
  * `preventDefault()` vetoes the internal request (open, toggle, navigation).
  */
 export declare function consumerHandlersFirst(props: HTMLProps<Element>, getProps: (userProps: HTMLProps<Element>) => Record<string, unknown>): Record<string, unknown>;
+export declare const joinIds: (...ids: Array<string | undefined>) => string | undefined;
 /** Own styles of a menu item, for families that layer their own item styles on top. */
 export declare const menuItemStyles: SerializedStyles[];
 /** Own styles of a menu separator. */
 export declare const menuSeparatorStyles: SerializedStyles;
 /** Command tones for families whose items carry one (SplitButton, ContextMenu). */
 export declare const menuItemToneStyles: Record<MenuItemTone, SerializedStyles>;
+/**
+ * Returns focus to a closed overlay's trigger, unless the trigger left the document or became
+ * inert (its owner is being removed) or something else already holds focus.
+ */
+export declare function restoreTriggerFocus(trigger: HTMLElement | null): void;
 /** The shared menu controller (state, positioning, navigation, dismissal, focus return). */
 export declare function MenuController(props: MenuControllerProps): import("@emotion/react/jsx-runtime").JSX.Element;
 declare function MenuRoot(props: MenuProps): import("@emotion/react/jsx-runtime").JSX.Element;
@@ -81,8 +96,17 @@ declare function MenuTrigger(props: MenuTriggerProps): import("@emotion/react/js
 export declare function MenuContentPart({ family, marker, styles, ref, style, children, className, sx, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, defaultLabelledBy, ...rest }: MenuContentProps & MenuPartIdentity & {
     defaultLabelledBy?: string;
 }): import("@emotion/react/jsx-runtime").JSX.Element | null;
+/**
+ * The menu's item collection: items rendered inside register with its list navigation and
+ * typeahead, and layers opened inside nest under the menu. Families that build their own surface
+ * around the menu element (UserMenu) render it inside the element carrying the floating props.
+ */
+export declare function MenuCollection({ family, children }: {
+    family: string;
+    children?: ReactNode;
+}): import("@emotion/react/jsx-runtime").JSX.Element;
 declare function MenuContent(props: MenuContentProps): import("@emotion/react/jsx-runtime").JSX.Element;
-export declare function MenuItemPart({ family, marker, styles, ref, onSelect, disabled, part, itemRole, closeOnSelect, onClick, className, sx, ...rest }: MenuItemProps & MenuPartIdentity & MenuItemPartBehavior): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare function MenuItemPart({ family, marker, styles, ref, onSelect, disabled, part, itemRole, closeOnSelect, busy, render, onClick, onKeyDown, className, sx, ...rest }: MenuItemProps & MenuPartIdentity & MenuItemPartBehavior): import("@emotion/react/jsx-runtime").JSX.Element;
 declare function MenuItem(props: MenuItemProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export declare function MenuSeparatorPart({ marker, styles, ref, className, sx, ...props }: MenuSeparatorProps & Omit<MenuPartIdentity, 'family'>): import("@emotion/react/jsx-runtime").JSX.Element;
 declare function MenuSeparator(props: MenuSeparatorProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/components/metric-card/metric-card.d.ts

@@ -16,7 +16,7 @@ export interface MetricCardProps extends Omit<ComponentPropsWithRef<'div'>, 'chi
     description?: ReactNode;
     headingLevel?: CardHeadingLevel;
     variant?: CardVariant;
-    /** Pin the locale for matching server and client output. */
+    /** Set locale to match server and client output. */
     locale?: Intl.LocalesArgument;
     /** Percent values are fractions; currency formatting requires a currency code. Invalid options throw. */
     formatOptions?: Intl.NumberFormatOptions;
@@ -30,7 +30,7 @@ export interface MetricCardProps extends Omit<ComponentPropsWithRef<'div'>, 'chi
     missingValueLabel?: string;
     slotProps?: MetricCardSlotProps;
 }
-/** Read-only heading and numeric summary; Tab skips it. No live region or animated value copies. */
+/** Show a heading and number. Read-only; Tab skips it. No live region or value animation. */
 export declare function MetricCard({ ref, label, value, description, headingLevel, variant, locale, formatOptions, unitLabel, delta, deltaFormatOptions, deltaTone, deltaDescription, loading, missingValueLabel, slotProps, className, sx, role, 'aria-labelledby': labelledBy, 'aria-describedby': describedBy, 'aria-busy': busy, ...rest }: MetricCardProps): import("@emotion/react/jsx-runtime").JSX.Element;
 export declare namespace MetricCard {
     var displayName: string;

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

@@ -16,7 +16,7 @@ export interface NavigationItemProps extends AnchorHTMLAttributes<HTMLElement>,
     /** Marks the current page (aria-current="page"). */
     active?: boolean;
     disabled?: boolean;
-    /** Decorative leading icon, hidden from assistive tech. */
+    /** Leading icon, hidden from assistive technology. */
     icon?: ReactNode;
 }
 declare function NavigationRoot({ ref, label, className, sx, ...rest }: NavigationProps): import("@emotion/react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,14 @@
+import { type ReactNode } from 'react';
+export interface EmotionRegistryProps {
+    /** Sets the Emotion class name prefix and `data-emotion` cache key. Defaults to `'css'`. */
+    cacheKey?: string;
+    children?: ReactNode;
+}
+/**
+ * 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 {
+    var displayName: string;
+}

package/dist/types/components/next/index.d.ts

@@ -0,0 +1,2 @@
+export { EmotionRegistry } from './emotion-registry';
+export type { EmotionRegistryProps } from './emotion-registry';

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

@@ -0,0 +1,21 @@
+import { type EmotionCache } from '@emotion/cache';
+export interface PendingStyle {
+    name: string;
+    isGlobal: boolean;
+}
+export interface CollectedStyles {
+    globals: {
+        name: string;
+        styles: string;
+    }[];
+    names: string[];
+    styles: string;
+}
+export interface EmotionRegistryCache {
+    cache: EmotionCache;
+    /** Returns the styles inserted since the previous call and forgets them. */
+    flush: () => PendingStyle[];
+}
+export declare function createEmotionRegistry(key: string): EmotionRegistryCache;
+/** Splits flushed styles into one payload per global and one shared payload for scoped rules. */
+export declare function collectStyles(pending: readonly PendingStyle[], inserted: EmotionCache['inserted']): CollectedStyles;

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

@@ -0,0 +1 @@
+export { NowPlaying, NowPlayingLevels, type NowPlayingProps, type NowPlayingTrack, type NowPlayingLabels, type NowPlayingSlotProps, type NowPlayingLevelsProps, } from './now-playing';

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

@@ -0,0 +1,88 @@
+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';
+import { type SliderProps } from '../slider';
+export interface NowPlayingTrack {
+    id: string;
+    title: string;
+    artist: string;
+    duration: number | null;
+    artwork?: string;
+    artworkAlt?: string;
+}
+type Part<T extends 'div' | 'span' | 'img'> = ComponentPropsWithRef<T> & {
+    css?: Interpolation<Theme>;
+};
+export interface NowPlayingSlotProps {
+    mini?: Part<'div'>;
+    full?: Part<'div'>;
+    artwork?: Part<'img'>;
+    title?: Part<'span'>;
+    artist?: Part<'span'>;
+    expand?: Omit<ButtonProps, 'sx' | 'render'>;
+    collapse?: Omit<ButtonProps, 'sx' | 'render'>;
+    seek?: Omit<Extract<SliderProps, {
+        type?: 'single';
+    }>, 'sx' | 'type' | 'value' | 'defaultValue' | 'onValueChange' | 'label' | 'dir' | 'min' | 'max' | 'step' | 'largeStep' | 'locale' | 'formatValue' | 'formatOptions' | 'showValue'>;
+    waveform?: Part<'div'>;
+    controls?: Part<'div'>;
+    status?: Part<'span'>;
+    error?: Part<'div'>;
+}
+export interface NowPlayingLabels {
+    play: string;
+    pause: string;
+    previous: string;
+    next: string;
+    expand: string;
+    collapse: string;
+    seek: string;
+    empty: string;
+    unavailable: string;
+    busy: string;
+    playing: string;
+    paused: string;
+    position: (elapsed: string, duration: string) => string;
+}
+export interface NowPlayingProps extends Omit<ComponentPropsWithRef<'section'>, 'defaultValue' | 'children' | 'onChange'>, SxProps {
+    tracks: readonly NowPlayingTrack[];
+    value?: number;
+    defaultValue?: number;
+    onValueChange?: (index: number) => void;
+    playing?: boolean;
+    defaultPlaying?: boolean;
+    onPlayingChange?: (playing: boolean) => void;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    position?: number;
+    defaultPosition?: number;
+    onPositionChange?: (seconds: number) => void;
+    busy?: boolean;
+    error?: ReactNode;
+    waveform?: readonly number[];
+    label?: string;
+    labels?: Partial<NowPlayingLabels>;
+    locale?: Intl.LocalesArgument;
+    /**
+     * 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;
+    seekLargeStep?: number;
+    slotProps?: NowPlayingSlotProps;
+}
+export interface NowPlayingLevelsProps extends ComponentPropsWithRef<'span'>, SxProps {
+    playing?: boolean;
+}
+export declare function NowPlayingLevels({ ref, playing: playingProp, className, sx, ...rest }: NowPlayingLevelsProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare namespace NowPlayingLevels {
+    var displayName: string;
+}
+declare function NowPlayingRoot({ ref, tracks, value, defaultValue, onValueChange, playing, defaultPlaying, onPlayingChange, open, defaultOpen, onOpenChange, position, defaultPosition, onPositionChange, busy, error, waveform, label, labels: labelsProp, locale, seekStep, seekLargeStep, slotProps, className, sx, onKeyDown, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, 'aria-describedby': ariaDescribedBy, ...rest }: NowPlayingProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const NowPlaying: typeof NowPlayingRoot & {
+    Levels: typeof NowPlayingLevels;
+};
+export {};

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

@@ -0,0 +1,2 @@
+export { PhotoGrid } from './photo-grid';
+export type { PhotoGridProps, PhotoGridPhoto, PhotoGridLabels, PhotoGridSlotProps } from './photo-grid';

package/dist/types/components/photo-grid/photo-grid.d.ts

@@ -0,0 +1,82 @@
+import { type ComponentPropsWithRef, type ReactNode } from 'react';
+import { type Interpolation, type Theme } from '../../styling/css';
+import { type SxProps } from '../../styling/sx';
+export interface PhotoGridPhoto {
+    id: string;
+    src: string;
+    srcSet?: string;
+    sizes?: string;
+    alt: string;
+    width: number;
+    height: number;
+    title: string;
+    detail?: ReactNode;
+}
+type Slot<Tag extends keyof React.JSX.IntrinsicElements> = Omit<ComponentPropsWithRef<Tag>, 'children'> & {
+    css?: Interpolation<Theme>;
+};
+type ActionSlot = Omit<Slot<'button'>, 'type' | 'disabled' | 'aria-pressed'>;
+export interface PhotoGridSlotProps {
+    header?: Slot<'header'>;
+    title?: Slot<'h2'>;
+    density?: Slot<'div'>;
+    list?: Slot<'ul'>;
+    item?: Slot<'li'>;
+    photo?: ActionSlot;
+    favorite?: ActionSlot;
+    viewer?: Omit<Slot<'dialog'>, 'open'>;
+    stage?: Slot<'div'>;
+    filmstrip?: Omit<Slot<'input'>, 'type' | 'value' | 'defaultValue' | 'min' | 'max' | 'step' | 'disabled'>;
+    controls?: Slot<'div'>;
+    status?: Slot<'div'>;
+}
+export interface PhotoGridLabels {
+    larger: string;
+    smaller: string;
+    density: string;
+    empty: string;
+    unavailable: string;
+    imageUnavailable: string;
+    close: string;
+    previous: string;
+    next: string;
+    filmstrip: string;
+    zoomIn: string;
+    zoomOut: string;
+    resetZoom: string;
+    panLeft: string;
+    panRight: string;
+    panUp: string;
+    panDown: string;
+    favorite: (title: string, favorite: boolean) => string;
+    openPhoto: (title: string, alt: string, favorite: boolean) => string;
+    position: (position: string, total: string, title: string) => string;
+    columns: (columns: string) => string;
+}
+export interface PhotoGridProps extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'defaultValue'>, SxProps {
+    photos: readonly PhotoGridPhoto[];
+    title: string;
+    /** Preferred columns. Narrow containers reduce effective columns without changing this axis. */
+    densitySteps?: readonly number[];
+    density?: number;
+    defaultDensity?: number;
+    onDensityChange?: (columns: number) => void;
+    favorites?: readonly string[];
+    defaultFavorites?: readonly string[];
+    onFavoritesChange?: (ids: string[]) => void;
+    onFavoriteChange?: (id: string, favorite: boolean) => void;
+    value?: string | null;
+    defaultValue?: string | null;
+    onValueChange?: (id: string | null) => void;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    labels?: Partial<PhotoGridLabels>;
+    locale?: Intl.LocalesArgument;
+    slotProps?: PhotoGridSlotProps;
+}
+export declare function PhotoGrid({ ref, photos, title, densitySteps, density: densityProp, defaultDensity, onDensityChange, favorites: favoritesProp, defaultFavorites, onFavoritesChange, onFavoriteChange, value: valueProp, defaultValue, onValueChange, open: openProp, defaultOpen, onOpenChange, labels: labelOverrides, locale, slotProps, className, sx, onKeyDown, ...rest }: PhotoGridProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare namespace PhotoGrid {
+    var displayName: string;
+}
+export {};

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

@@ -0,0 +1,2 @@
+export { SheetStack, useSheetStack } from './sheet-stack';
+export type { SheetStackActions, SheetStackBackProps, SheetStackCloseProps, SheetStackContentProps, SheetStackDescriptionProps, SheetStackFooterProps, SheetStackHeadingLevel, SheetStackProps, SheetStackTitleProps, SheetStackTriggerProps, SheetStackVariant, } from './sheet-stack';

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

@@ -0,0 +1,81 @@
+import { type ComponentPropsWithRef, type ReactNode } from 'react';
+import { type SxProps } from '../../styling/sx';
+export type SheetStackVariant = 'auto' | 'sheet' | 'dialog';
+export type SheetStackHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+export interface SheetStackProps {
+    /** 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;
+    /** Sets the layout. Defaults to `'auto'`: a sheet below `breakpoint`, a centered dialog at or above it. */
+    variant?: SheetStackVariant;
+    /** Sets the layer width in CSS pixels where `'auto'` switches to a dialog. Defaults to the `sheetStackBreakpoint` token. */
+    breakpoint?: number;
+    /** 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 {
+    /** Opens this panel key. An open key removes the panels above it. */
+    value: string;
+}
+export interface SheetStackContentProps extends Omit<ComponentPropsWithRef<'div'>, 'onCancel'>, SxProps {
+    /** Identifies this panel. Keep the key stable and unique within the stack. */
+    value: string;
+    /** Allows Escape, backdrop, and drag dismissal. Defaults to `true`. When `false`, Back and Close still work. */
+    dismissible?: boolean;
+    /** Receives Escape, backdrop, or drag dismissal requests while this panel is on top. Call `preventDefault()` to keep it open. */
+    onCancel?: (event: Event) => void;
+    /** 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 {
+}
+export interface SheetStackFooterProps extends ComponentPropsWithRef<'div'>, SxProps {
+}
+export interface SheetStackBackProps extends Omit<ComponentPropsWithRef<'button'>, 'aria-label'>, SxProps {
+    /** 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 {
+    /** 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[];
+    /** Requests opening `key` on top. An open key removes the panels above it. */
+    push: (key: string) => void;
+    /** Requests closing the top panel. Does nothing on an empty stack. */
+    pop: () => void;
+    /** Requests removing the panels above an open `key`. A closed key is ignored with a development warning. */
+    popTo: (key: string) => void;
+    /** Requests closing every panel. Does nothing on an empty stack. */
+    close: () => void;
+}
+/** 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;
+declare function SheetStackContent({ ref, value, className, sx, ...props }: SheetStackContentProps): import("react").ReactPortal | null;
+declare function SheetStackTitle({ ref, level, className, sx, children, ...props }: SheetStackTitleProps): import("@emotion/react/jsx-runtime").JSX.Element | null;
+declare function SheetStackDescription({ ref, className, sx, children, ...props }: SheetStackDescriptionProps): import("@emotion/react/jsx-runtime").JSX.Element | null;
+declare function SheetStackFooter({ ref, className, sx, ...props }: SheetStackFooterProps): import("@emotion/react/jsx-runtime").JSX.Element;
+declare function SheetStackBack({ ref, label, onClick, className, sx, children, ...rest }: SheetStackBackProps): import("@emotion/react/jsx-runtime").JSX.Element;
+declare function SheetStackClose({ ref, label, onClick, className, sx, children, ...rest }: SheetStackCloseProps): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const SheetStack: typeof SheetStackRoot & {
+    Trigger: typeof SheetStackTrigger;
+    Content: typeof SheetStackContent;
+    Title: typeof SheetStackTitle;
+    Description: typeof SheetStackDescription;
+    Footer: typeof SheetStackFooter;
+    Back: typeof SheetStackBack;
+    Close: typeof SheetStackClose;
+};
+export {};