@webority-technologies/mobile-ui 0.0.1

package/lib/typescript/module/theme/types.d.ts

@@ -0,0 +1,913 @@
+import type React from 'react';
+import type { TextStyle, ViewStyle } from 'react-native';
+export type ColorMode = 'light' | 'dark';
+/**
+ * A linear gradient definition used by Button, Card and consumer components.
+ * `colors` must have at least 2 entries. `start`/`end` follow the
+ * react-native-linear-gradient convention: { x: 0..1, y: 0..1 }.
+ */
+export interface GradientDefinition {
+    colors: string[];
+    locations?: number[];
+    start?: {
+        x: number;
+        y: number;
+    };
+    end?: {
+        x: number;
+        y: number;
+    };
+}
+export interface GradientScale {
+    /** Brand-primary gradient — used by `Button gradient` and `Card gradient="primary"`. */
+    primary?: GradientDefinition;
+    /** Secondary brand gradient. */
+    secondary?: GradientDefinition;
+    /** Backdrop / banner gradient (for hero sections). */
+    surface?: GradientDefinition;
+    /** Free-form named gradients. Consumer extends as needed. */
+    [key: string]: GradientDefinition | undefined;
+}
+export interface ColorPalette {
+    primary: string;
+    primaryHover: string;
+    primaryPressed: string;
+    primaryMuted: string;
+    secondary: string;
+    secondaryHover: string;
+    success: string;
+    warning: string;
+    error: string;
+    info: string;
+    /**
+     * Foreground (text/icon) colour to render ON a solid fill of each semantic
+     * tone. Solid Button / Badge / Chip / Banner backgrounds read these instead
+     * of assuming `text.inverse` (white) — white-on-pale (notably `warning`
+     * amber) fails contrast. Library defaults keep the historical white for
+     * primary/success/error/info, use dark ink for `warning`, and `text.primary`
+     * for the surface-like `secondary` tone. Override per-brand to match your
+     * palette's luminance.
+     */
+    onPrimary: string;
+    onSecondary: string;
+    onSuccess: string;
+    onWarning: string;
+    onError: string;
+    onInfo: string;
+    text: {
+        primary: string;
+        secondary: string;
+        tertiary: string;
+        inverse: string;
+        disabled: string;
+        link: string;
+    };
+    background: {
+        primary: string;
+        secondary: string;
+        tertiary: string;
+        elevated: string;
+        overlay: string;
+        inverse: string;
+    };
+    border: {
+        primary: string;
+        secondary: string;
+        focus: string;
+        error: string;
+        /**
+         * Global outline thickness shared by every input-style control —
+         * Input, SearchBar, Select, OTPInput, Checkbox, Radio, outlined Card,
+         * outline Chip, Avatar border, outline Button, etc. Library default: 1.5.
+         * Component-specific tokens (e.g. `theme.components.input.borderWidth`)
+         * still win when set.
+         */
+        width: number;
+    };
+    surface: {
+        pressed: string;
+        hovered: string;
+        selected: string;
+        disabled: string;
+    };
+    skeleton: {
+        background: string;
+        highlight: string;
+    };
+    /**
+     * Fixed hue set Avatar hashes a user's name against to pick an initials
+     * background — same index always resolves to the same colour for a given
+     * name. Light/dark themes each tune the 8 hues for contrast against their
+     * own surface; the hues themselves stay recognisably paired across modes.
+     */
+    avatarPalette: readonly string[];
+}
+export interface FontFamilyScale {
+    /** Font family for normal-weight text. Falls back to platform system font when undefined. */
+    regular?: string;
+    medium?: string;
+    semibold?: string;
+    bold?: string;
+}
+export interface TypographyScale {
+    fontSize: {
+        xs: number;
+        sm: number;
+        base: number;
+        lg: number;
+        xl: number;
+        '2xl': number;
+        '3xl': number;
+        '4xl': number;
+    };
+    fontWeight: {
+        normal: TextStyle['fontWeight'];
+        medium: TextStyle['fontWeight'];
+        semibold: TextStyle['fontWeight'];
+        bold: TextStyle['fontWeight'];
+    };
+    /**
+     * Optional brand font families. When set, library text components prefer
+     * `fontFamily.<weight>` over `fontWeight.<weight>` to match the consumer
+     * app's typeface. Each key is independently optional — leave undefined to
+     * fall back to the system font for that weight.
+     */
+    fontFamily?: FontFamilyScale;
+    lineHeight: {
+        tight: number;
+        normal: number;
+        relaxed: number;
+    };
+    letterSpacing: {
+        tight: number;
+        normal: number;
+        wide: number;
+    };
+}
+export interface SpacingScale {
+    none: 0;
+    xxs: number;
+    xs: number;
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+    '2xl': number;
+    '3xl': number;
+    '4xl': number;
+}
+export interface RadiusScale {
+    none: 0;
+    xs: number;
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+    '2xl': number;
+    full: 9999;
+}
+export interface ShadowDefinition {
+    shadowColor: string;
+    shadowOffset: {
+        width: number;
+        height: number;
+    };
+    shadowOpacity: number;
+    shadowRadius: number;
+    elevation: number;
+}
+export interface ShadowScale {
+    none: ViewStyle;
+    xs: ShadowDefinition;
+    sm: ShadowDefinition;
+    md: ShadowDefinition;
+    lg: ShadowDefinition;
+    xl: ShadowDefinition;
+    '2xl': ShadowDefinition;
+}
+export interface MotionScale {
+    duration: {
+        instant: number;
+        fast: number;
+        normal: number;
+        slow: number;
+        slower: number;
+    };
+    easing: {
+        standard: readonly [number, number, number, number];
+        accelerate: readonly [number, number, number, number];
+        decelerate: readonly [number, number, number, number];
+        sharp: readonly [number, number, number, number];
+    };
+    spring: {
+        gentle: {
+            damping: number;
+            stiffness: number;
+            mass: number;
+        };
+        bouncy: {
+            damping: number;
+            stiffness: number;
+            mass: number;
+        };
+        snappy: {
+            damping: number;
+            stiffness: number;
+            mass: number;
+        };
+    };
+}
+/**
+ * Per-component size tokens. Each component that exposes a `size` prop
+ * resolves dimensions via `theme.components.<name>[size]`. Library ships
+ * sensible defaults; consumer overrides win via `mergeTheme`.
+ *
+ * Keep entries here as components gain themable per-size dimensions —
+ * this is the single home for "X is X tall, has Y radius, uses Z font size".
+ */
+export type ComponentSizeKey = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+export interface ButtonSizeTokens {
+    paddingHorizontal: number;
+    paddingVertical: number;
+    minHeight: number;
+    fontSize: number;
+    borderRadius: number;
+}
+export interface InputSizeTokens {
+    paddingHorizontal: number;
+    paddingVertical: number;
+    minHeight: number;
+    multilineMinHeight: number;
+    fontSize: number;
+    borderRadius: number;
+    iconSize: number;
+}
+export interface SearchBarSizeTokens {
+    height: number;
+    paddingHorizontal: number;
+    fontSize: number;
+    iconSize: number;
+    gap: number;
+    /**
+     * Corner radius for the SearchBar box. Defaults to `theme.radius.full` so
+     * SearchBar reads as a pill out of the box; brands wanting the same shape
+     * as Input / Select can drop this to the matching `field.borderRadius`.
+     */
+    borderRadius?: number;
+}
+export interface EmptyStateSizeTokens {
+    iconSize: number;
+    /** Resolves against the active theme's typography.fontSize scale, e.g. "lg", "xl", "2xl". */
+    titleFontSize: keyof TypographyScale['fontSize'];
+    descriptionFontSize: keyof TypographyScale['fontSize'];
+    /** Resolves against the active theme's spacing scale. */
+    paddingVertical: keyof SpacingScale;
+}
+export interface ListItemSizeTokens {
+    /** Resolves against the active theme's spacing scale. */
+    paddingVertical: keyof SpacingScale;
+    titleFontSize: keyof TypographyScale['fontSize'];
+    subtitleFontSize: keyof TypographyScale['fontSize'];
+    minHeight: number;
+}
+export interface BadgeSizeTokens {
+    fontSize: number;
+    minWidth: number;
+    height: number;
+    paddingHorizontal: number;
+    dotSize: number;
+}
+export interface ChipSizeTokens {
+    paddingHorizontal: number;
+    paddingVertical: number;
+    fontSize: number;
+    minHeight: number;
+    closeSize: number;
+    closeFontSize: number;
+    gap: number;
+}
+export interface SwitchSizeTokens {
+    trackWidth: number;
+    trackHeight: number;
+    thumbSize: number;
+    padding: number;
+}
+export interface OTPInputSizeTokens {
+    cell: number;
+    fontSize: number;
+    borderRadius: number;
+    gap: number;
+}
+export interface DialogTokens {
+    iconWrapperSize: number;
+    iconWrapperBorderRadius: number;
+    actionButtonMinHeight: number;
+}
+export interface ToastTokens {
+    iconCircleSize: number;
+    iconCircleBorderRadius: number;
+    iconGlyphFontSize: number;
+    tintBarWidth: number;
+    /** Default auto-dismiss duration (ms) when toast.duration is unset. 0 = persistent. Library default: 3000. */
+    defaultDurationMs?: number;
+    /** Enable swipe-to-dismiss pan responder. Library default: true. */
+    enableSwipeDismiss?: boolean;
+    /** Horizontal swipe distance to dismiss. Library default: 80. */
+    swipeDismissThreshold?: number;
+    /** Horizontal swipe velocity to dismiss. Library default: 0.5. */
+    swipeVelocityThreshold?: number;
+    /** Vertical translate per stacked toast. Library default: 8. */
+    stackOffset?: number;
+    /** Scale decrement per stack index. Library default: 0.04. */
+    stackScaleStep?: number;
+    /** Lower bound for stack scale. Library default: 0.9. */
+    stackMinScale?: number;
+    /** Enter-spring damping. Library default: 18. */
+    enterSpringDamping?: number;
+    /** Enter-spring stiffness. Library default: 180. */
+    enterSpringStiffness?: number;
+    /** Enter-spring mass. Library default: 1. */
+    enterSpringMass?: number;
+}
+export interface FormFieldTokens {
+    /** Width of the inline label column when `layout="inline"`. Accepts CSS-like string ("35%") or number. */
+    inlineLabelWidth: number | `${number}%`;
+}
+export interface BadgeTokens extends Partial<Record<'sm' | 'md', BadgeSizeTokens>> {
+    borderWidth?: number;
+    anchorOffset?: number;
+}
+export interface CheckboxSizeTokens {
+    boxSize: number;
+}
+export interface CheckboxTokens extends Partial<Record<ComponentSizeKey, CheckboxSizeTokens>> {
+    labelGap?: number;
+}
+export type ChipTokens = Partial<Record<ComponentSizeKey, ChipSizeTokens>>;
+export type ListItemTokens = Partial<Record<ComponentSizeKey, ListItemSizeTokens>>;
+export interface RadioSizeTokens {
+    outer: number;
+    inner: number;
+}
+export interface RadioTokens extends Partial<Record<ComponentSizeKey, RadioSizeTokens>> {
+    labelGap?: number;
+}
+export interface NumberInputTokens {
+    /** Milliseconds before long-press auto-repeat kicks in. Library default: 500. */
+    longPressDelayMs?: number;
+    /** Milliseconds between auto-repeated step ticks while long-pressed. Library default: 80. */
+    longPressIntervalMs?: number;
+}
+export interface OTPInputTokens extends Partial<Record<ComponentSizeKey, OTPInputSizeTokens>> {
+    /** When true, the row shakes horizontally on first error transition. Library default: false. */
+    shakeOnError?: boolean;
+}
+export interface ProgressBarTokens {
+    /** Duration in ms of the indeterminate-loop animation cycle. Library default: 1500. */
+    indeterminateLoopDuration?: number;
+    /** Width of the moving bar in indeterminate mode (% string or number). Library default: '30%'. */
+    indeterminateWidth?: number | `${number}%`;
+    /** Duration in ms of the determinate progress tween. Library default: 400. */
+    determinateAnimationDuration?: number;
+}
+export interface RatingTokens {
+    /** When true, the tapped star plays a pulse-scale animation. Library default: false. */
+    pulseOnPress?: boolean;
+    /** Peak scale of the pulse animation. Library default: 1.2. */
+    pulseScale?: number;
+}
+/**
+ * Per-size dimensions for the unified field box (FieldBase). Every
+ * input-like control (Input, Select, SearchBar, NumberInput, OTPInput cell,
+ * PickerTrigger) inherits these defaults so heights, radii, padding and
+ * font sizes stay aligned across the library. Component-specific tokens
+ * (e.g. `theme.components.input[size]`) still win when set.
+ */
+export interface FieldSizeTokens {
+    paddingHorizontal: number;
+    paddingVertical: number;
+    minHeight: number;
+    fontSize: number;
+    borderRadius: number;
+    iconSize: number;
+}
+/**
+ * One of the four field-box sides. Used everywhere the library accepts
+ * per-side overrides for border width / colour.
+ */
+export type FieldSide = 'top' | 'right' | 'bottom' | 'left';
+/**
+ * Shorthand-or-longhand value. A bare `T` means "apply to all four sides";
+ * an object form lets a consumer set specific sides while the others fall
+ * through to whatever the resolver decided. Mirrors how React Native's
+ * `borderWidth` + `borderXWidth` (and CSS `border` + `border-X`) compose.
+ */
+export type FieldPerSide<T> = T | Partial<Record<FieldSide, T>>;
+/** Border colour value: a single colour string or a per-side colour map. */
+export type FieldBorderColor = FieldPerSide<string>;
+/** Border width value: a single width or a per-side width map. */
+export type FieldBorderWidth = FieldPerSide<number>;
+/**
+ * State-aware fill + border colours for a field variant. Resolution order
+ * inside FieldBase: variant token → library default. Idle distinguishes
+ * empty vs filled so consumers can tint the resting field differently once
+ * the user has typed. When focused/error/disabled fills are omitted, the
+ * box animates from the current idle fill to itself (no fill change).
+ *
+ * Border colour + width are `FieldPerSide` values — pass a bare string /
+ * number to set all four sides (the common case), or an object like
+ * `{ bottom: '#1A73E8' }` to draw only one side. Sides not specified in the
+ * object fall through to the shorthand default.
+ */
+export interface FieldVariantTokens {
+    backgroundIdleEmpty: string;
+    backgroundIdleFilled?: string;
+    backgroundFocused?: string;
+    backgroundError?: string;
+    backgroundDisabled: string;
+    borderIdle: FieldBorderColor;
+    borderFocused: FieldBorderColor;
+    borderError: FieldBorderColor;
+    borderDisabled: FieldBorderColor;
+    borderWidth: FieldBorderWidth;
+}
+export interface FieldTokens extends Partial<Record<'sm' | 'md' | 'lg', FieldSizeTokens>> {
+    /** Default `variant` when caller doesn't pass one. Library default: 'outlined'. */
+    defaultVariant?: 'outlined' | 'filled' | 'underline';
+    /** State-aware fill + border colours per variant. */
+    outlined?: Partial<FieldVariantTokens>;
+    filled?: Partial<FieldVariantTokens>;
+    /** Bottom-border-only variant — Material-style underline inputs. */
+    underline?: Partial<FieldVariantTokens>;
+    /** Text colour for the editable / displayed value. Defaults to `colors.text.primary`. */
+    textColor?: string;
+    /** Text colour when the field is disabled. Defaults to `colors.text.disabled`. */
+    disabledTextColor?: string;
+    /** Placeholder text colour. Defaults to `colors.text.tertiary`. */
+    placeholderColor?: string;
+    /** Font weight for the value text. Defaults to `typography.fontWeight.medium`. */
+    fontWeight?: TextStyle['fontWeight'];
+    /**
+     * Marker appended (after a space) to a field's label when `required` is set.
+     * Shared by the whole field family — Input, Select, FormField, PickerTrigger
+     * and the pickers built on it. Defaults to `'*'`.
+     */
+    requiredMarker?: string;
+    /** Colour of the required marker. Defaults to `colors.error`. */
+    requiredMarkerColor?: string;
+}
+export interface InputFillTokens {
+    /** Background colour while idle and the field is empty (no value). */
+    idleEmpty?: string;
+    /** Background colour while idle and the field has a value. Falls back to `idleEmpty` if undefined. */
+    idleFilled?: string;
+    /** Background colour while focused. Falls back to the current idle fill if undefined. */
+    focus?: string;
+    /** Background colour while in error state. Falls back to the current idle fill if undefined. */
+    error?: string;
+    /** Background colour while disabled. Falls back to `colors.surface.disabled`. */
+    disabled?: string;
+}
+export interface InputComponentTokens extends Partial<Record<ComponentSizeKey, InputSizeTokens>> {
+    /** Default `variant` when caller doesn't pass one. Library default: 'outlined'. */
+    defaultVariant?: 'outlined' | 'filled' | 'underline';
+    /** Default `labelMode` when caller doesn't pass one. Library default: 'float'. */
+    defaultLabelMode?: 'float' | 'top';
+    /** Corner radius in pixels for the field wrapper. Library default: size-driven (sm=10, md=12, lg=14). */
+    borderRadius?: number;
+    /**
+     * When true, the label switches to `colors.border.focus` while the field is
+     * focused. Library default is false — the label stays its resting colour on
+     * focus and only the border tints. Error state always uses `colors.error`
+     * regardless of this flag.
+     */
+    tintLabelOnFocus?: boolean;
+    /**
+     * When true, the field shakes horizontally and fires an error haptic the
+     * moment an error first appears. Library default is false — the border and
+     * message turn red without any motion. Opt in for a more Material-Design
+     * feel.
+     */
+    shakeOnError?: boolean;
+    /**
+     * State-aware fill colours per variant. When omitted, the library falls
+     * back to `colors.background.primary` for outlined idle, `colors.background.secondary`
+     * for filled idle, `colors.surface.disabled` when disabled, and keeps focus/error
+     * the same as idle. The component interpolates between these the same way
+     * it animates the border, so transitions are smooth.
+     */
+    fillColors?: {
+        outlined?: InputFillTokens;
+        filled?: InputFillTokens;
+        underline?: InputFillTokens;
+    };
+}
+export interface BottomSheetTokens {
+    /** Colour of the grab-handle rendered above the sheet content. Library default: `colors.border.primary`. */
+    handleColor?: string;
+}
+export interface ChoiceGroupTokens {
+    /** Corner radius of the default card template. Library default: `radius.md`. */
+    borderRadius?: number;
+    /** Opacity of the option colour used as the selected card's fill (0–1). Library default: 0.12. */
+    selectedFillOpacity?: number;
+}
+export interface FilePickerTokens {
+    /** Corner radius of the trigger card and file tiles. Library default: `radius.md`. */
+    borderRadius?: number;
+    /** Square size of card-variant thumbnails in px. Library default: 84. */
+    thumbnailSize?: number;
+    /** Colour of the dashed trigger border. Library default: `colors.primary`. */
+    dashedBorderColor?: string;
+}
+export interface InlineSelectTokens {
+    /** Trigger text + chevron colour. Library default: `colors.primary`. */
+    color?: string;
+}
+export interface SelectTokens {
+    /** Colour of the grab-handle rendered above the bottom-sheet picker. Library default: `colors.border.primary`. */
+    handleColor?: string;
+    /** Default `variant` when caller doesn't pass one. Falls through to `components.field.defaultVariant`, then 'outlined'. */
+    defaultVariant?: 'outlined' | 'filled' | 'underline';
+    /** Corner radius in pixels for the trigger field. Library default: size-driven (sm=10, md=12, lg=14). */
+    borderRadius?: number;
+    /**
+     * State-aware fill colours per variant for the trigger field. Mirrors
+     * `components.input.fillColors`; when omitted the library falls back to the
+     * same defaults FieldBase uses for each variant.
+     */
+    fillColors?: {
+        outlined?: InputFillTokens;
+        filled?: InputFillTokens;
+        underline?: InputFillTokens;
+    };
+}
+export interface BottomNavigationTokens {
+    /** Pixel size of tab icons. Library default: 24. */
+    iconSize?: number;
+    /** Height of the pill background drawn behind the active tab when `variant="pill"`. Library default: 36. */
+    pillHeight?: number;
+    /** Maximum width of the pill background. Library default: 120. */
+    pillMaxWidth?: number;
+    /** Horizontal inset of the pill from the edges of its tab cell. Library default: 16. */
+    pillInset?: number;
+    /** Thickness of the underline indicator when `variant="underline"`. Library default: 3. */
+    underlineHeight?: number;
+}
+export interface DatePickerTokens {
+    /** Pixel offset for the month-slide animation. Default: 32. */
+    monthSlideDistance?: number;
+    /** Outgoing month-slide animation duration (ms). Default: theme.motion.duration.fast or 140. */
+    monthSlideOutDuration?: number;
+    /** Incoming month-slide animation duration (ms). Default: theme.motion.duration.fast or 160. */
+    monthSlideInDuration?: number;
+    /** Day/year/decade view-transition fade+scale duration (ms). Default: theme.motion.duration.normal or 200. */
+    viewTransitionDuration?: number;
+    /** Header press-in scale animation duration (ms). Default: 80. */
+    headerPressDuration?: number;
+    /** Header release scale animation duration (ms). Default: 100. */
+    headerReleaseDuration?: number;
+    /** Width/height of the nav (prev/next) buttons. Default: 36. */
+    navButtonSize?: number;
+    /** Font size of the nav chevron text. Default: 22. */
+    navTextFontSize?: number;
+    /** Line height of the nav chevron text. Default: 24. */
+    navTextLineHeight?: number;
+    /** Padding around each day cell. Default: 2. */
+    dayCellPadding?: number;
+    /** Border radius of the inner day pill. Default: theme.radius.full. */
+    dayInnerBorderRadius?: number;
+    /** Padding around each year/decade cell. Default: 4. */
+    yearCellPadding?: number;
+    /** Border radius of the inner year/decade pill. Default: theme.radius.lg. */
+    yearInnerBorderRadius?: number;
+    /** Margin above the decade range subtitle text. Default: 2. */
+    decadeRangeMarginTop?: number;
+    /** Min height for the footer cancel/confirm buttons. Default: 40. */
+    footerButtonMinHeight?: number;
+}
+export interface DateRangePickerTokens {
+    /** Pixel offset for the month-slide animation. Default: 32. */
+    monthSlideDistance?: number;
+    /** Outgoing month-slide animation duration (ms). Default: theme.motion.duration.fast or 140. */
+    monthSlideOutDuration?: number;
+    /** Incoming month-slide animation duration (ms). Default: theme.motion.duration.fast or 160. */
+    monthSlideInDuration?: number;
+    /** Width/height of the nav (prev/next) buttons. Default: 36. */
+    navButtonSize?: number;
+    /** Font size of the nav chevron text. Default: 22. */
+    navTextFontSize?: number;
+    /** Line height of the nav chevron text. Default: 24. */
+    navTextLineHeight?: number;
+    /** Min height for the footer cancel/confirm buttons. Default: 40. */
+    footerButtonMinHeight?: number;
+}
+export interface TimePickerTokens {
+    /** Debounce window between scroll-haptic ticks (ms). Default: 35. */
+    hapticDebounceMs?: number;
+    /** Width of the bottom-sheet drag handle. Default: 36. */
+    handleWidth?: number;
+    /** Height of the bottom-sheet drag handle. Default: 4. */
+    handleHeight?: number;
+}
+export interface AvatarTokens {
+    /** Border width applied to the avatar wrapper. Library default: 0. */
+    borderWidth?: number;
+    /** Border colour applied to the avatar wrapper. Falls back to `colors.border.primary`. */
+    borderColor?: string;
+    /** Border width of the status indicator's ring. Library default: 2. */
+    statusBorderWidth?: number;
+    /** Border colour of the status indicator's ring. Falls back to `colors.background.elevated`. */
+    statusBorderColor?: string;
+    /**
+     * Initials font size as a fraction of avatar dimension. Library default: 0.4
+     * (i.e. md avatar at 48px → 19px initials). Increase for larger initials.
+     */
+    fontSizeRatio?: number;
+    /**
+     * Absolute initials font size in pixels. Wins over `fontSizeRatio` when set.
+     * Use only when the design needs a fixed size regardless of avatar dimension.
+     */
+    fontSize?: number;
+    /**
+     * Font weight key for the initials text. Library default: 'semibold'.
+     */
+    fontWeight?: keyof TypographyScale['fontWeight'];
+}
+export interface AccordionTokens {
+    /** Vertical padding inside the `card` variant container. Library default: 4. */
+    cardPaddingVertical?: number;
+}
+export interface AppBarTokens {
+    /** Min-width of the left/right side action slots. Library default: 48. */
+    sideSlotMinWidth?: number;
+    /** Translate-Y distance (px, negative) the large title travels when collapsing. Library default: -20. */
+    collapseTranslateDistance?: number;
+    /** Margin between title and subtitle. */
+    subtitleMarginTop?: number;
+    /** Width/height of each action button (square). */
+    actionButtonSize?: number;
+    /** Top/right inset of the right-action badge bubble. */
+    badgeOffset?: number;
+    /** Min-width of the right-action badge bubble. */
+    badgeMinWidth?: number;
+    /** Height of the right-action badge bubble. */
+    badgeHeight?: number;
+    /** Horizontal padding inside the right-action badge bubble. */
+    badgePaddingHorizontal?: number;
+    /** Font size of the badge count text. */
+    badgeFontSize?: number;
+    /** Line height of the badge count text. */
+    badgeLineHeight?: number;
+}
+export interface BannerTokens {
+    tintBarWidth?: number;
+    iconCircleSize?: number;
+    iconCircleRadius?: number;
+    iconGlyphFontSize?: number;
+    iconGlyphLineHeight?: number;
+    closeButtonSize?: number;
+    closeButtonRadius?: number;
+    closeGlyphFontSize?: number;
+    closeButtonMarginLeft?: number;
+    containerPaddingLeft?: number;
+    iconGap?: number;
+    textBlockPaddingRight?: number;
+    actionsRowMarginTop?: number;
+    actionsRowGap?: number;
+    actionButtonPaddingHorizontal?: number;
+    actionButtonPaddingVertical?: number;
+    actionButtonRadius?: number;
+}
+export interface DrawerTokens {
+    /** Pixel velocity above which a fling closes the drawer. Library default: 1000. */
+    closeVelocityThreshold?: number;
+    /** Pixel drag distance before the gesture is recognised. Library default: 10. */
+    dragActivationOffset?: number;
+}
+export interface FloatingActionButtonTokens {
+    /** Horizontal inset from screen edge for bottomLeft/bottomRight positions. Library default: 24. */
+    edgeOffset?: number;
+    /** Default `bottomOffset` when the prop is not passed. Library default: 24. */
+    bottomOffset?: number;
+    /** Vertical gap between stacked secondary actions in the group. Library default: 16. */
+    secondaryGap?: number;
+    /** Per-item stagger delay in ms when opening/closing the group. Library default: 50. */
+    staggerMs?: number;
+}
+export interface ImageGalleryTokens {
+    /** Maximum pinch-zoom scale. Library default: 4. */
+    maxScale?: number;
+    /** Minimum pinch-zoom scale (1 = fit). Library default: 1. */
+    minScale?: number;
+    /** Scale applied on double-tap at rest. Library default: 2. */
+    doubleTapScale?: number;
+}
+export interface ModalTokens {
+    /** Initial scale value for the centred presentation enter animation. Library default: 0.9. */
+    scaleStartValue?: number;
+}
+export interface SegmentedControlSizeTokens {
+    height?: number;
+    fontSize?: number;
+    paddingHorizontal?: number;
+}
+export interface SegmentedControlTokens extends Partial<Record<'sm' | 'md', SegmentedControlSizeTokens>> {
+    /** Padding between the track edge and the selected indicator. Library default: 2. */
+    trackPadding?: number;
+}
+export interface SliderSizeTokens {
+    trackHeight?: number;
+    thumbDiameter?: number;
+}
+export interface SliderTokens extends Partial<Record<ComponentSizeKey, SliderSizeTokens>> {
+    /** When true, the thumb plays a scale-up animation while pressed. Library default: false. */
+    thumbPressAnimation?: boolean;
+    /** Peak scale of the thumb press animation. Library default: 1.15. */
+    thumbPressScale?: number;
+    /** Duration in ms of the bubble-label fade. Library default: 120. */
+    labelShowDuration?: number;
+    /** Final opacity of the bubble label when visible. Library default: 1. */
+    labelOpacity?: number;
+}
+export interface StepperTokens {
+    /** Diameter of each step circle. Library default: 24. */
+    circleSize?: number;
+    /** Diameter of the surrounding pulse ring. Library default: 32. */
+    pulseSize?: number;
+    /** Duration in ms of one pulse cycle. Library default: 1100. */
+    pulseDuration?: number;
+    /** When true, the active step animates a continuous pulse ring. Library default: false. */
+    pulseAnimation?: boolean;
+}
+export interface SwipeableTokens {
+    /** Pixel distance after which a partial-swipe action commits on release. Library default: 64. */
+    threshold?: number;
+    /** Pixel distance after which a full-swipe (delete) gesture fires. Library default: 240. */
+    fullSwipeThreshold?: number;
+    /** Pixel drag offset before the horizontal gesture activates. Library default: 10. */
+    dragActivationOffset?: number;
+    /** Rubber-band resistance factor when swiping past the action area. Library default: 0.25. */
+    rubberBandFactor?: number;
+    /** Vertical pixel offset before the gesture is rejected (lets vertical scroll win). Library default: 15. */
+    failOffsetY?: number;
+    /** Spring damping for snap-back animation. */
+    springDamping?: number;
+    /** Spring stiffness for snap-back animation. */
+    springStiffness?: number;
+    /** Spring mass for snap-back animation. */
+    springMass?: number;
+}
+export interface TabsTokens {
+    /** Horizontal padding of each tab. Library default: theme.spacing.lg. */
+    tabPaddingHorizontal?: number;
+    /** Vertical padding of each tab. Library default: theme.spacing.md. */
+    tabPaddingVertical?: number;
+    /** Gap between leading icon and label. Library default: 6. */
+    tabIconSpacing?: number;
+    /** Underline indicator thickness (underline variant). Library default: 2. */
+    underlineHeight?: number;
+    /** Vertical inset of pill indicator from row edges (pills variant). Library default: 4. */
+    pillInset?: number;
+    /** Opacity applied to disabled tabs. Library default: 0.45. */
+    disabledOpacity?: number;
+    /** Gap between label and inline badge. Library default: 6. */
+    badgeGap?: number;
+}
+export interface TooltipTokens {
+    /** Gap between trigger and tooltip card. Library default: 8. */
+    gap?: number;
+    /** Minimum padding from screen edges. Library default: 8. */
+    screenPadding?: number;
+    /** Auto-hide delay for `trigger='press'`. Library default: 4000. */
+    pressAutoHideMs?: number;
+    /** Half the arrow base width. Library default: 4. */
+    arrowHalfWidth?: number;
+    /** Arrow height (pointing dimension). Library default: 6. */
+    arrowHeight?: number;
+    /** Min distance of arrow tip from card corner. Library default: 12. */
+    arrowCornerPadding?: number;
+    /** Default `maxWidth` when prop is unset. Library default: 240. */
+    maxWidth?: number;
+    /** Message Text lineHeight. Library default: 18. */
+    lineHeight?: number;
+    /** Opt-in scale-from-0.85 entry/exit animation. Library default: false (opacity-only). */
+    enableScaleAnimation?: boolean;
+    /** Duration of fade/scale exit. Library default: 150. */
+    exitDurationMs?: number;
+}
+export interface ComponentTokens {
+    accordion?: AccordionTokens;
+    appBar?: AppBarTokens;
+    avatar?: AvatarTokens;
+    banner?: BannerTokens;
+    button?: Partial<Record<ComponentSizeKey, ButtonSizeTokens>>;
+    badge?: BadgeTokens;
+    bottomNavigation?: BottomNavigationTokens;
+    bottomSheet?: BottomSheetTokens;
+    checkbox?: CheckboxTokens;
+    chip?: ChipTokens;
+    choiceGroup?: ChoiceGroupTokens;
+    datePicker?: DatePickerTokens;
+    dateRangePicker?: DateRangePickerTokens;
+    dialog?: DialogTokens;
+    drawer?: DrawerTokens;
+    emptyState?: Partial<Record<ComponentSizeKey, EmptyStateSizeTokens>>;
+    /**
+     * Shared dimensions + state colours for every input-like control. Acts as
+     * the single source of truth for height / radius / padding / fill / border
+     * across Input, Select, SearchBar, NumberInput, OTPInput cells and
+     * PickerTrigger. Per-component tokens still override when set.
+     */
+    field?: FieldTokens;
+    filePicker?: FilePickerTokens;
+    floatingActionButton?: FloatingActionButtonTokens;
+    formField?: FormFieldTokens;
+    imageGallery?: ImageGalleryTokens;
+    inlineSelect?: InlineSelectTokens;
+    input?: InputComponentTokens;
+    listItem?: ListItemTokens;
+    modal?: ModalTokens;
+    numberInput?: NumberInputTokens;
+    otpInput?: OTPInputTokens;
+    progressBar?: ProgressBarTokens;
+    radio?: RadioTokens;
+    rating?: RatingTokens;
+    searchBar?: Partial<Record<ComponentSizeKey, SearchBarSizeTokens>> & {
+        cancelButtonWidth?: number;
+        /**
+         * Default `variant` when caller doesn't pass one. Library default:
+         * `'filled'` (pill-shaped, borderless). Set this to `'outlined'` to make
+         * SearchBar pick up the same fill / border / focus treatment as Input,
+         * Select, OTPInput etc. — useful when a brand has unified its inputs.
+         * Falls through to `components.field.defaultVariant` when undefined.
+         */
+        defaultVariant?: 'outlined' | 'filled';
+    };
+    segmentedControl?: SegmentedControlTokens;
+    select?: SelectTokens;
+    slider?: SliderTokens;
+    stepper?: StepperTokens;
+    swipeable?: SwipeableTokens;
+    switch?: Partial<Record<ComponentSizeKey, SwitchSizeTokens>> & {
+        thumbColor?: string;
+    };
+    tabs?: TabsTokens;
+    timePicker?: TimePickerTokens;
+    toast?: ToastTokens;
+    tooltip?: TooltipTokens;
+}
+/**
+ * Renderer signature for theme-level icons. Each registry entry receives a
+ * pixel `size` and a `color` and returns whatever JSX the consumer wants —
+ * an SVG, a vector-icons glyph, an Image, an emoji-wrapped Text, anything.
+ */
+export type IconRenderer = (props: {
+    size: number;
+    color: string;
+}) => React.ReactNode;
+/**
+ * Theme-level icon registry. Library components read from this when they
+ * need to render an icon internally (Input password toggle, SearchBar
+ * magnifier/clear, ImageGallery close, etc.). Consumers provide the
+ * implementations — the library ships with no icon dependency.
+ *
+ * Slots default to `undefined` — if a slot is missing the library renders
+ * a small text/SVG fallback (or nothing, depending on the call site).
+ */
+export interface IconRegistry {
+    /** Magnifier icon — SearchBar leading slot when no `leftIcon` prop. */
+    search?: IconRenderer;
+    /** Close/dismiss icon — SearchBar clear, ImageGallery close, etc. */
+    close?: IconRenderer;
+    /** Show-password icon — Input password toggle (visible state). */
+    eye?: IconRenderer;
+    /** Hide-password icon — Input password toggle (masked state). */
+    eyeOff?: IconRenderer;
+    /** Paperclip/attachment icon — FilePicker trigger. Text-only trigger when unset. */
+    attachment?: IconRenderer;
+}
+export interface Theme {
+    mode: ColorMode;
+    colors: ColorPalette;
+    typography: TypographyScale;
+    spacing: SpacingScale;
+    radius: RadiusScale;
+    shadows: ShadowScale;
+    motion: MotionScale;
+    components: ComponentTokens;
+    /** Theme-level icon registry — see {@link IconRegistry}. */
+    icons?: IconRegistry;
+    /**
+     * Optional brand gradient palette. Empty by default — consumers register
+     * their own via theme overrides. Components that accept gradient inputs
+     * (Button, Card) read from here when consumers pass a string token, OR
+     * accept a `GradientDefinition` literal directly.
+     */
+    gradients: GradientScale;
+}
+export type DeepPartial<T> = T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+export type ThemeOverrides = DeepPartial<Theme>;
+//# sourceMappingURL=types.d.ts.map