@webority-technologies/mobile 0.0.15 → 0.0.21

package/lib/typescript/commonjs/index.d.ts

@@ -20,7 +20,7 @@ export type { LoggerType, RemoteLogger } from './logger';
 export { VersionCheck, useVersionCheck } from './versionCheck';
 export type { UpdateInfo, UpdateType, VersionData, VersionComparison, VersionCheckResult, VersionCheckType, ParsedVersion, Platform } from './versionCheck';
 export { ThemeProvider, useTheme, useThemeMode, setTheme, setColorMode, getColorMode, getTheme, resetTheme, subscribeTheme, mergeTheme, lightTheme, darkTheme } from './theme';
-export type { Theme, ThemeOverrides, ThemeProviderProps, ColorMode, ColorPalette, ColorSchemePreference, RadiusScale, ShadowDefinition, ShadowScale, SpacingScale, TypographyScale, MotionScale, DeepPartial } from './theme';
+export type { Theme, ThemeOverrides, ThemeProviderProps, IconRegistry, IconRenderer, ColorMode, ColorPalette, ColorSchemePreference, RadiusScale, ShadowDefinition, ShadowScale, SpacingScale, TypographyScale, MotionScale, DeepPartial } from './theme';
 export { useToggle, useDebounce, usePressAnimation } from './hooks';
 export type { UseToggleResult, UsePressAnimationOptions, UsePressAnimationResult } from './hooks';
 export { ScreenDimensions, Breakpoints, Responsive, isScreenSize, isTablet, Spacing, Padding, Margin, triggerHaptic, setHapticImplementation, shadowStyle, compressImage } from './utils';

package/lib/typescript/commonjs/theme/index.d.ts

@@ -14,5 +14,5 @@ export type { FontWeightKey } from './textStyle';
 export { createAnimatedValue, setNativeValue } from './animatedValue';
 export { Gradient, isGradientAvailable } from './Gradient';
 export type { GradientProps } from './Gradient';
-export type { ColorMode, ColorPalette, GradientDefinition, GradientScale, RadiusScale, ShadowDefinition, ShadowScale, SpacingScale, Theme, ThemeOverrides, TypographyScale, MotionScale, DeepPartial } from './types';
+export type { ColorMode, ColorPalette, GradientDefinition, GradientScale, IconRegistry, IconRenderer, RadiusScale, ShadowDefinition, ShadowScale, SpacingScale, Theme, ThemeOverrides, TypographyScale, MotionScale, DeepPartial } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,3 +1,4 @@
+import type React from 'react';
 import type { TextStyle, ViewStyle } from 'react-native';
 export type ColorMode = 'light' | 'dark';
 /**
@@ -59,6 +60,14 @@ export interface ColorPalette {
         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;
@@ -217,6 +226,12 @@ export interface SearchBarSizeTokens {
     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;
@@ -265,12 +280,34 @@ export interface DialogTokens {
     iconWrapperSize: number;
     iconWrapperBorderRadius: number;
     actionButtonMinHeight: number;
+    /** When true, fires a selection haptic on action-button press. Library default: false. */
+    actionHaptic?: boolean;
 }
 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. */
@@ -284,42 +321,569 @@ export interface CheckboxSizeTokens {
     boxSize: number;
 }
 export interface CheckboxTokens extends Partial<Record<ComponentSizeKey, CheckboxSizeTokens>> {
-    borderWidth?: number;
     labelGap?: number;
+    /** When true, fires a selection haptic on press by default. Library default: false. */
+    pressHaptic?: boolean;
+}
+export interface ChipTokens extends Partial<Record<ComponentSizeKey, ChipSizeTokens>> {
+    /** When true, fires a selection haptic when the chip itself is pressed. Library default: false. */
+    pressHaptic?: boolean;
+    /** When true, fires a selection haptic when the close (×) button is pressed. Library default: false. */
+    closeHaptic?: boolean;
+}
+export interface ListItemTokens extends Partial<Record<ComponentSizeKey, ListItemSizeTokens>> {
+    /** When true, fires a selection haptic on press. Library default: false. */
+    pressHaptic?: boolean;
 }
 export interface RadioSizeTokens {
     outer: number;
     inner: number;
 }
 export interface RadioTokens extends Partial<Record<ComponentSizeKey, RadioSizeTokens>> {
-    borderWidth?: number;
     labelGap?: number;
+    /** When true, fires a selection haptic on press by default. Library default: false. */
+    pressHaptic?: boolean;
+}
+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;
+    /** When true, fires a light impact haptic on every +/- press. Library default: false. */
+    pressHaptic?: boolean;
+}
+export interface OTPInputTokens extends Partial<Record<ComponentSizeKey, OTPInputSizeTokens>> {
+    /** When true, the row shakes horizontally on first error transition. Library default: false. */
+    shakeOnError?: boolean;
+    /** When true, fires an error haptic on first error transition. Library default: false. */
+    errorHaptic?: boolean;
+    /** When true, fires a selection haptic on each value change. Library default: false. */
+    selectionHaptic?: 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;
+    /** When true, fires a selection haptic on each rating change. Library default: false. */
+    pressHaptic?: boolean;
+}
+/**
+ * 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'];
+}
+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';
+    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 SelectTokens {
+    /** Colour of the grab-handle rendered above the bottom-sheet picker. Library default: `colors.border.primary`. */
+    handleColor?: string;
+}
+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 {
+    /** Opt-in haptic feedback on month/year navigation and selection. Default: false. */
+    haptic?: boolean;
+    /** 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 {
+    /** Opt-in haptic feedback on month navigation and selection. Default: false. */
+    haptic?: boolean;
+    /** 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 {
+    /** Opt-in haptic feedback on wheel scroll and confirm/cancel. Default: false. */
+    haptic?: boolean;
+    /** 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 {
+    /** When true, fires a selection haptic on header press. Library default: false. */
+    pressHaptic?: boolean;
+    /** Vertical padding inside the `card` variant container. Library default: 4. */
+    cardPaddingVertical?: number;
+}
+export interface AppBarTokens {
+    /** When true, fires a selection haptic on action-button press. Library default: false. */
+    pressHaptic?: boolean;
+    /** 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 CardTokens {
+    /** When true, fires a selection haptic on interactive card press. Library default: false. */
+    pressHaptic?: boolean;
+}
+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;
+    /** When true, fires a selection haptic on backdrop press. Library default: false. */
+    backdropPressHaptic?: boolean;
+}
+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;
+    /** When true, fires impactLight on press / open / action. Library default: false. */
+    pressHaptic?: boolean;
+}
+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;
+    /** When true, fires haptics on open/close/swipe/double-tap. Library default: false. */
+    pressHaptic?: boolean;
+}
+export interface ModalTokens {
+    /** Initial scale value for the centred presentation enter animation. Library default: 0.9. */
+    scaleStartValue?: number;
+    /** When true, fires a selection haptic on backdrop dismiss. Library default: false. */
+    backdropHaptic?: boolean;
+}
+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;
+    /** When true, fires a selection haptic on segment change. Library default: false. */
+    changeHaptic?: boolean;
+}
+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;
+    /** When true, fires a selection haptic while dragging. Library default: false. */
+    dragHaptic?: boolean;
+    /** When true, fires a selection haptic each time the value crosses a step boundary. Library default: false. */
+    stepHaptic?: boolean;
+    /** When true, fires a selection haptic on track tap. Library default: false. */
+    tapHaptic?: boolean;
+    /** When true, fires a selection haptic on accessibility increment/decrement. Library default: false. */
+    a11yHaptic?: boolean;
+}
+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;
+    /** When true, fires a selection haptic on step press. Library default: false. */
+    pressHaptic?: 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;
+    /** When true, fires a notification haptic on full-swipe commit. Library default: true. */
+    fullSwipeHaptic?: boolean;
+    /** When true, fires a selection haptic on action button press. Library default: true. */
+    actionPressHaptic?: boolean;
+    /** When true, fires a selection haptic on accessibility action. Library default: true. */
+    a11yActionHaptic?: boolean;
+}
+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;
+    /** When true, fires a selection haptic on tab press. Library default: false. */
+    hapticOnPress?: boolean;
+}
+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;
+    card?: CardTokens;
+    checkbox?: CheckboxTokens;
+    chip?: ChipTokens;
+    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;
+    floatingActionButton?: FloatingActionButtonTokens;
+    formField?: FormFieldTokens;
+    imageGallery?: ImageGalleryTokens;
     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';
     };
-    emptyState?: Partial<Record<ComponentSizeKey, EmptyStateSizeTokens>>;
-    listItem?: Partial<Record<ComponentSizeKey, ListItemSizeTokens>>;
-    badge?: BadgeTokens;
-    chip?: Partial<Record<ComponentSizeKey, ChipSizeTokens>>;
-    checkbox?: CheckboxTokens;
-    radio?: RadioTokens;
+    segmentedControl?: SegmentedControlTokens;
+    select?: SelectTokens;
+    slider?: SliderTokens;
+    stepper?: StepperTokens;
+    swipeable?: SwipeableTokens;
     switch?: Partial<Record<ComponentSizeKey, SwitchSizeTokens>> & {
         thumbColor?: string;
     };
-    otpInput?: Partial<Record<ComponentSizeKey, OTPInputSizeTokens>>;
-    dialog?: DialogTokens;
+    tabs?: TabsTokens;
+    timePicker?: TimePickerTokens;
     toast?: ToastTokens;
-    formField?: FormFieldTokens;
+    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;
 }
 export interface Theme {
     mode: ColorMode;
@@ -330,6 +894,8 @@ export interface Theme {
     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