app-studio 0.8.5 → 0.8.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,5 +1,5 @@
1
1
  import * as react from 'react';
2
- import react__default, { ReactNode, CSSProperties, HTMLAttributes, RefObject } from 'react';
2
+ import react__default, { ReactNode, CSSProperties, HTMLAttributes, HTMLAttributeReferrerPolicy, JSX, RefObject } from 'react';
3
3
  import { C as ColorSingleton, a as ColorPalette, A as AnimationProps, S as Shadow, V as ViewStyleProps, I as ImageStyleProps, T as TextStyleProps } from '../viewAnimation-B4BIoOwQ.mjs';
4
4
  export { b as AnalyticsConfig, c as AnalyticsContext, d as AnalyticsProvider, e as Animation, B as BlurAnimationOptions, f as ColorConfig, R as RotateAnimationOptions, g as ScaleAnimationOptions, h as Shadows, i as SlideAnimationOptions, j as Typography, k as ViewAnimationConfig, l as ViewAnimationFillMode, m as ViewAnimationOptions, n as ViewAnimationRange, o as ViewAnimationTimingFunction, p as animateOnView, q as blurInOnView, r as blurOutOnView, s as createViewAnimation, t as defaultColors, u as defaultDarkColors, v as defaultDarkPalette, w as defaultLightColors, x as defaultLightPalette, y as fadeInOnView, z as fadeOutOnView, D as flipXOnView, E as flipYOnView, F as getWindowInitialProps, G as hasColorToken, H as isBrowser, J as isDev, K as isMobile, L as isProd, M as isSSR, N as replaceColorTokens, O as revealOnView, P as rotateInOnView, Q as scaleDownOnView, U as scaleUpOnView, W as slideDownOnView, X as slideLeftOnView, Y as slideRightOnView, Z as slideUpOnView, _ as useAnalytics, $ as viewAnimationPresets } from '../viewAnimation-B4BIoOwQ.mjs';
5
5
 
@@ -98,6 +98,8 @@ interface CssProps extends CSSProperties {
98
98
  _focusVisible?: CSSProperties | string;
99
99
  _focusWithin?: CSSProperties | string;
100
100
  _placeholder?: CSSProperties | string;
101
+ _odd?: CSSProperties | string;
102
+ _even?: CSSProperties | string;
101
103
  _groupHover?: CSSProperties | string;
102
104
  _groupFocus?: CSSProperties | string;
103
105
  _groupActive?: CSSProperties | string;
@@ -125,6 +127,68 @@ interface CssProps extends CSSProperties {
125
127
  webkitUserDrag?: CSSProperties['userSelect'];
126
128
  }
127
129
  interface ElementProps extends CssProps, Omit<ViewStyleProps, keyof HTMLAttributes<HTMLElement> | 'children' | 'style' | 'pointerEvents'>, Omit<HTMLAttributes<HTMLElement>, 'color' | 'style' | 'content' | 'translate'> {
130
+ src?: string;
131
+ alt?: string;
132
+ controls?: boolean;
133
+ muted?: boolean;
134
+ autoPlay?: boolean;
135
+ loop?: boolean;
136
+ poster?: string;
137
+ playsInline?: boolean;
138
+ preload?: 'none' | 'metadata' | 'auto' | '';
139
+ crossOrigin?: 'anonymous' | 'use-credentials' | '';
140
+ srcSet?: string;
141
+ sizes?: string;
142
+ loading?: 'eager' | 'lazy';
143
+ referrerPolicy?: HTMLAttributeReferrerPolicy;
144
+ decoding?: 'async' | 'auto' | 'sync';
145
+ name?: string;
146
+ value?: string | number | readonly string[];
147
+ defaultValue?: string | number | readonly string[];
148
+ multiple?: boolean;
149
+ disabled?: boolean;
150
+ readOnly?: boolean;
151
+ required?: boolean;
152
+ autoComplete?: string;
153
+ autoFocus?: boolean;
154
+ placeholder?: string;
155
+ pattern?: string;
156
+ min?: number | string;
157
+ max?: number | string;
158
+ minLength?: number;
159
+ maxLength?: number;
160
+ step?: number | string;
161
+ form?: string;
162
+ formAction?: string;
163
+ formEncType?: string;
164
+ formMethod?: 'get' | 'post' | 'dialog';
165
+ formNoValidate?: boolean;
166
+ formTarget?: string;
167
+ rows?: number;
168
+ cols?: number;
169
+ /** HTML textarea wrap attribute. Browsers accept 'hard' | 'soft' | 'off' but
170
+ * the DOM type widens to plain `string`, so we mirror that here. */
171
+ wrap?: string;
172
+ list?: string;
173
+ accept?: string;
174
+ capture?: boolean | 'user' | 'environment';
175
+ colSpan?: number;
176
+ rowSpan?: number;
177
+ headers?: string;
178
+ scope?: string;
179
+ href?: string;
180
+ target?: string;
181
+ rel?: string;
182
+ hrefLang?: string;
183
+ download?: string | boolean;
184
+ xmlns?: string;
185
+ viewBox?: string;
186
+ preserveAspectRatio?: string;
187
+ open?: boolean;
188
+ scoped?: boolean;
189
+ reversed?: boolean;
190
+ start?: number;
191
+ htmlFor?: string;
128
192
  on?: Record<string, CssProps>;
129
193
  media?: Record<string, CssProps>;
130
194
  only?: string[];
@@ -138,6 +202,22 @@ interface ElementProps extends CssProps, Omit<ViewStyleProps, keyof HTMLAttribut
138
202
  style?: CSSProperties;
139
203
  widthHeight?: number | string;
140
204
  children?: React.ReactNode;
205
+ srcDoc?: string;
206
+ sandbox?: string;
207
+ to?: string;
208
+ keys?: any[];
209
+ sx?: any;
210
+ itemStyle?: any;
211
+ paddingX?: number | string;
212
+ paddingY?: number | string;
213
+ marginX?: number | string;
214
+ marginY?: number | string;
215
+ hoverBackgroundColor?: string;
216
+ hover?: boolean | Record<string, any>;
217
+ hoverStyle?: Record<string, any>;
218
+ checked?: boolean;
219
+ defaultChecked?: boolean;
220
+ transition?: string;
141
221
  before?: React.ReactNode;
142
222
  after?: React.ReactNode;
143
223
  /**
@@ -172,6 +252,8 @@ interface ElementProps extends CssProps, Omit<ViewStyleProps, keyof HTMLAttribut
172
252
  _focusVisible?: CssProps | string;
173
253
  _focusWithin?: CssProps | string;
174
254
  _placeholder?: CssProps | string;
255
+ _odd?: CssProps | string;
256
+ _even?: CssProps | string;
175
257
  _groupHover?: CssProps | string;
176
258
  _groupFocus?: CssProps | string;
177
259
  _groupActive?: CssProps | string;
@@ -197,7 +279,7 @@ interface ElementProps extends CssProps, Omit<ViewStyleProps, keyof HTMLAttribut
197
279
  _mozFocusInner?: CssProps | string;
198
280
  }
199
281
 
200
- declare const Element$1: react__default.MemoExoticComponent<react__default.ForwardRefExoticComponent<ElementProps & react__default.RefAttributes<HTMLElement>>>;
282
+ declare const Element$1: react__default.NamedExoticComponent<ElementProps & react__default.RefAttributes<HTMLElement>>;
201
283
 
202
284
  interface ViewProps extends Omit<ViewStyleProps, keyof ElementProps>, ElementProps {
203
285
  onPress?: (..._args: any) => void;
@@ -237,6 +319,25 @@ interface TextProps extends Omit<TextStyleProps, keyof ElementProps>, Omit<Eleme
237
319
  isSub?: boolean;
238
320
  isSup?: boolean;
239
321
  maxLines?: number;
322
+ /**
323
+ * Shorthand for fontWeight; accepts numeric (100-900) or named weights
324
+ * ("normal", "bold", "semibold", etc.). Convenience alias for the
325
+ * underlying fontWeight CSS property.
326
+ */
327
+ weight?: string | number;
328
+ /**
329
+ * Optional style variant identifier. Free-form string used by component
330
+ * wrappers and design systems to dispatch typography presets.
331
+ */
332
+ variant?: string;
333
+ /**
334
+ * Shorthand for fontSize; accepts numeric or named sizes (e.g. 'sm', 14, '14px').
335
+ */
336
+ size?: string | number;
337
+ /**
338
+ * Shorthand for letterSpacing; accepts numeric or named tracking values.
339
+ */
340
+ spacing?: string | number;
240
341
  }
241
342
 
242
343
  interface CommonProps extends ElementProps, Omit<ViewStyleProps, keyof ElementProps> {
@@ -418,7 +519,7 @@ interface WindowSizeProviderProps {
418
519
  declare const WindowSizeProvider: ({ children, targetWindow, }: WindowSizeProviderProps) => react__default.JSX.Element;
419
520
 
420
521
  declare function useActive<T extends HTMLElement = HTMLElement>(): [
421
- React.RefObject<T>,
522
+ React.RefObject<T | null>,
422
523
  boolean
423
524
  ];
424
525
 
@@ -426,7 +527,7 @@ interface UseClickOutsideOptions {
426
527
  /** Optional target window to use (for iframe support). Defaults to global window. */
427
528
  targetWindow?: Window;
428
529
  }
429
- declare function useClickOutside<T extends HTMLElement = HTMLElement>(options?: UseClickOutsideOptions): [React.RefObject<T>, boolean];
530
+ declare function useClickOutside<T extends HTMLElement = HTMLElement>(options?: UseClickOutsideOptions): [React.RefObject<T | null>, boolean];
430
531
 
431
532
  interface RelativePlacement {
432
533
  vertical: 'top' | 'bottom';
@@ -452,7 +553,7 @@ interface UseElementPositionOptions {
452
553
  }
453
554
  interface UseElementPositionReturn {
454
555
  /** React ref to attach to the target HTML element. */
455
- ref: React.RefObject<HTMLElement>;
556
+ ref: React.RefObject<HTMLElement | null>;
456
557
  /**
457
558
  * The calculated viewport relation data, or null if not yet calculated
458
559
  * or element not found.
@@ -468,12 +569,12 @@ interface UseElementPositionReturn {
468
569
  declare function useElementPosition<T extends HTMLElement = HTMLElement>(options?: UseElementPositionOptions): UseElementPositionReturn;
469
570
 
470
571
  declare function useFocus<T extends HTMLElement = HTMLElement>(): [
471
- React.RefObject<T>,
572
+ React.RefObject<T | null>,
472
573
  boolean
473
574
  ];
474
575
 
475
576
  declare function useHover<T extends HTMLElement = HTMLElement>(): [
476
- React.RefObject<T>,
577
+ React.RefObject<T | null>,
477
578
  boolean
478
579
  ];
479
580
 
@@ -485,7 +586,7 @@ interface UseOnScreenOptions extends IntersectionObserverInit {
485
586
  /** Optional target window to use (for iframe support). Defaults to global window. */
486
587
  targetWindow?: Window;
487
588
  }
488
- declare function useOnScreen<T extends HTMLElement = HTMLElement>(options?: UseOnScreenOptions): [React.RefObject<T>, boolean];
589
+ declare function useOnScreen<T extends HTMLElement = HTMLElement>(options?: UseOnScreenOptions): [React.RefObject<T | null>, boolean];
489
590
 
490
591
  /**
491
592
  * Optimized hook for components that only need breakpoint information.
@@ -563,7 +664,7 @@ interface ScrollPosition {
563
664
  elementProgress?: number;
564
665
  }
565
666
  interface UseScrollOptions {
566
- container?: RefObject<HTMLElement>;
667
+ container?: RefObject<HTMLElement | null>;
567
668
  offset?: [number, number];
568
669
  throttleMs?: number;
569
670
  disabled?: boolean;
@@ -584,11 +685,11 @@ interface UseInfiniteScrollOptions {
584
685
  debounceMs?: number;
585
686
  }
586
687
  declare const useScroll: ({ container, offset, throttleMs, disabled, }?: UseScrollOptions) => ScrollPosition;
587
- declare const useScrollAnimation: (ref: RefObject<HTMLElement>, options?: UseScrollAnimationOptions) => {
688
+ declare const useScrollAnimation: (ref: RefObject<HTMLElement | null>, options?: UseScrollAnimationOptions) => {
588
689
  isInView: boolean;
589
690
  progress: number;
590
691
  };
591
- declare const useSmoothScroll: (targetWindow?: Window) => (element: HTMLElement | null, offset?: any) => void;
692
+ declare const useSmoothScroll: (targetWindow?: Window) => (element: HTMLElement | null, offset?: number) => void;
592
693
  declare const useInfiniteScroll: (callback: () => void, options?: UseInfiniteScrollOptions) => {
593
694
  sentinelRef: react.Dispatch<react.SetStateAction<HTMLDivElement | null>>;
594
695
  };
@@ -605,7 +706,7 @@ interface InViewOptions extends IntersectionObserverInit {
605
706
  targetWindow?: Window;
606
707
  }
607
708
  declare function useInView(options?: InViewOptions): {
608
- ref: react.RefObject<HTMLElement>;
709
+ ref: react.RefObject<HTMLElement | null>;
609
710
  inView: boolean;
610
711
  };
611
712
 
@@ -650,4 +751,4 @@ declare function useIframe(iframeRef: React.RefObject<HTMLIFrameElement>): {
650
751
  isLoaded: boolean;
651
752
  };
652
753
 
653
- export { AnimationUtils, type BreakpointConfig, BreakpointContext, Button, type ButtonProps, Center, ColorPalette, ColorSingleton, type Colors, type CssProps, type DeviceConfig, type DeviceType, Div, Element$1 as Element, type ElementPosition, type ElementProps, Form, type FormProps, Horizontal, HorizontalResponsive, Image, ImageBackground, type ImageProps, Input, type InputProps, type QueryConfig, type RelativePlacement, type ResponsiveConfig, ResponsiveContext, ResponsiveProvider, type ResponsiveProviderProps, SafeArea, type ScreenConfig, type ScreenOrientation, Scroll, type ScrollPosition, Shadow, Skeleton, Span, StyleRegistry, Text, type TextProps, type Theme, ThemeContext, ThemeProvider, type UseClickOutsideOptions, type UseElementPositionOptions, type UseElementPositionReturn, type UseInfiniteScrollOptions, type UseOnScreenOptions, type UseScrollAnimationOptions, type UseScrollOptions, UtilityClassManager, Vertical, VerticalResponsive, View, type ViewProps, type WindowDimensions, WindowDimensionsContext, WindowSizeContext, WindowSizeProvider, type WindowSizeProviderProps, createStyleRegistry, debounce, deepMerge, defaultThemeMain, extractUtilityClasses, propertyShorthand, useActive, useBreakpoint, useBreakpointContext, useClickOutside, useElementPosition, useFocus, useHover, useIframe, useIframeStyles, useInView, useInfiniteScroll, useKeyPress, useMount, useOnScreen, useResponsive, useResponsiveContext, useScroll, useScrollAnimation, useScrollDirection, useServerInsertedHTML, useSmoothScroll, useStyleRegistry, useTheme, useWindowDimensions, useWindowDimensionsContext, useWindowSize, utilityClassManager };
754
+ export { AnimationProps, AnimationUtils, type BreakpointConfig, BreakpointContext, Button, type ButtonProps, Center, ColorPalette, ColorSingleton, type Colors, type CssProps, type DeviceConfig, type DeviceType, Div, Element$1 as Element, type ElementPosition, type ElementProps, Form, type FormProps, Horizontal, HorizontalResponsive, Image, ImageBackground, type ImageProps, Input, type InputProps, type QueryConfig, type RelativePlacement, type ResponsiveConfig, ResponsiveContext, ResponsiveProvider, type ResponsiveProviderProps, SafeArea, type ScreenConfig, type ScreenOrientation, Scroll, type ScrollPosition, Shadow, Skeleton, Span, StyleRegistry, Text, type TextProps, type Theme, ThemeContext, ThemeProvider, type UseClickOutsideOptions, type UseElementPositionOptions, type UseElementPositionReturn, type UseInfiniteScrollOptions, type UseOnScreenOptions, type UseScrollAnimationOptions, type UseScrollOptions, UtilityClassManager, Vertical, VerticalResponsive, View, type ViewProps, type WindowDimensions, WindowDimensionsContext, WindowSizeContext, WindowSizeProvider, type WindowSizeProviderProps, createStyleRegistry, debounce, deepMerge, defaultThemeMain, extractUtilityClasses, propertyShorthand, useActive, useBreakpoint, useBreakpointContext, useClickOutside, useElementPosition, useFocus, useHover, useIframe, useIframeStyles, useInView, useInfiniteScroll, useKeyPress, useMount, useOnScreen, useResponsive, useResponsiveContext, useScroll, useScrollAnimation, useScrollDirection, useServerInsertedHTML, useSmoothScroll, useStyleRegistry, useTheme, useWindowDimensions, useWindowDimensionsContext, useWindowSize, utilityClassManager };
@@ -1,5 +1,5 @@
1
1
  import * as react from 'react';
2
- import react__default, { ReactNode, CSSProperties, HTMLAttributes, RefObject } from 'react';
2
+ import react__default, { ReactNode, CSSProperties, HTMLAttributes, HTMLAttributeReferrerPolicy, JSX, RefObject } from 'react';
3
3
  import { C as ColorSingleton, a as ColorPalette, A as AnimationProps, S as Shadow, V as ViewStyleProps, I as ImageStyleProps, T as TextStyleProps } from '../viewAnimation-B4BIoOwQ.js';
4
4
  export { b as AnalyticsConfig, c as AnalyticsContext, d as AnalyticsProvider, e as Animation, B as BlurAnimationOptions, f as ColorConfig, R as RotateAnimationOptions, g as ScaleAnimationOptions, h as Shadows, i as SlideAnimationOptions, j as Typography, k as ViewAnimationConfig, l as ViewAnimationFillMode, m as ViewAnimationOptions, n as ViewAnimationRange, o as ViewAnimationTimingFunction, p as animateOnView, q as blurInOnView, r as blurOutOnView, s as createViewAnimation, t as defaultColors, u as defaultDarkColors, v as defaultDarkPalette, w as defaultLightColors, x as defaultLightPalette, y as fadeInOnView, z as fadeOutOnView, D as flipXOnView, E as flipYOnView, F as getWindowInitialProps, G as hasColorToken, H as isBrowser, J as isDev, K as isMobile, L as isProd, M as isSSR, N as replaceColorTokens, O as revealOnView, P as rotateInOnView, Q as scaleDownOnView, U as scaleUpOnView, W as slideDownOnView, X as slideLeftOnView, Y as slideRightOnView, Z as slideUpOnView, _ as useAnalytics, $ as viewAnimationPresets } from '../viewAnimation-B4BIoOwQ.js';
5
5
 
@@ -98,6 +98,8 @@ interface CssProps extends CSSProperties {
98
98
  _focusVisible?: CSSProperties | string;
99
99
  _focusWithin?: CSSProperties | string;
100
100
  _placeholder?: CSSProperties | string;
101
+ _odd?: CSSProperties | string;
102
+ _even?: CSSProperties | string;
101
103
  _groupHover?: CSSProperties | string;
102
104
  _groupFocus?: CSSProperties | string;
103
105
  _groupActive?: CSSProperties | string;
@@ -125,6 +127,68 @@ interface CssProps extends CSSProperties {
125
127
  webkitUserDrag?: CSSProperties['userSelect'];
126
128
  }
127
129
  interface ElementProps extends CssProps, Omit<ViewStyleProps, keyof HTMLAttributes<HTMLElement> | 'children' | 'style' | 'pointerEvents'>, Omit<HTMLAttributes<HTMLElement>, 'color' | 'style' | 'content' | 'translate'> {
130
+ src?: string;
131
+ alt?: string;
132
+ controls?: boolean;
133
+ muted?: boolean;
134
+ autoPlay?: boolean;
135
+ loop?: boolean;
136
+ poster?: string;
137
+ playsInline?: boolean;
138
+ preload?: 'none' | 'metadata' | 'auto' | '';
139
+ crossOrigin?: 'anonymous' | 'use-credentials' | '';
140
+ srcSet?: string;
141
+ sizes?: string;
142
+ loading?: 'eager' | 'lazy';
143
+ referrerPolicy?: HTMLAttributeReferrerPolicy;
144
+ decoding?: 'async' | 'auto' | 'sync';
145
+ name?: string;
146
+ value?: string | number | readonly string[];
147
+ defaultValue?: string | number | readonly string[];
148
+ multiple?: boolean;
149
+ disabled?: boolean;
150
+ readOnly?: boolean;
151
+ required?: boolean;
152
+ autoComplete?: string;
153
+ autoFocus?: boolean;
154
+ placeholder?: string;
155
+ pattern?: string;
156
+ min?: number | string;
157
+ max?: number | string;
158
+ minLength?: number;
159
+ maxLength?: number;
160
+ step?: number | string;
161
+ form?: string;
162
+ formAction?: string;
163
+ formEncType?: string;
164
+ formMethod?: 'get' | 'post' | 'dialog';
165
+ formNoValidate?: boolean;
166
+ formTarget?: string;
167
+ rows?: number;
168
+ cols?: number;
169
+ /** HTML textarea wrap attribute. Browsers accept 'hard' | 'soft' | 'off' but
170
+ * the DOM type widens to plain `string`, so we mirror that here. */
171
+ wrap?: string;
172
+ list?: string;
173
+ accept?: string;
174
+ capture?: boolean | 'user' | 'environment';
175
+ colSpan?: number;
176
+ rowSpan?: number;
177
+ headers?: string;
178
+ scope?: string;
179
+ href?: string;
180
+ target?: string;
181
+ rel?: string;
182
+ hrefLang?: string;
183
+ download?: string | boolean;
184
+ xmlns?: string;
185
+ viewBox?: string;
186
+ preserveAspectRatio?: string;
187
+ open?: boolean;
188
+ scoped?: boolean;
189
+ reversed?: boolean;
190
+ start?: number;
191
+ htmlFor?: string;
128
192
  on?: Record<string, CssProps>;
129
193
  media?: Record<string, CssProps>;
130
194
  only?: string[];
@@ -138,6 +202,22 @@ interface ElementProps extends CssProps, Omit<ViewStyleProps, keyof HTMLAttribut
138
202
  style?: CSSProperties;
139
203
  widthHeight?: number | string;
140
204
  children?: React.ReactNode;
205
+ srcDoc?: string;
206
+ sandbox?: string;
207
+ to?: string;
208
+ keys?: any[];
209
+ sx?: any;
210
+ itemStyle?: any;
211
+ paddingX?: number | string;
212
+ paddingY?: number | string;
213
+ marginX?: number | string;
214
+ marginY?: number | string;
215
+ hoverBackgroundColor?: string;
216
+ hover?: boolean | Record<string, any>;
217
+ hoverStyle?: Record<string, any>;
218
+ checked?: boolean;
219
+ defaultChecked?: boolean;
220
+ transition?: string;
141
221
  before?: React.ReactNode;
142
222
  after?: React.ReactNode;
143
223
  /**
@@ -172,6 +252,8 @@ interface ElementProps extends CssProps, Omit<ViewStyleProps, keyof HTMLAttribut
172
252
  _focusVisible?: CssProps | string;
173
253
  _focusWithin?: CssProps | string;
174
254
  _placeholder?: CssProps | string;
255
+ _odd?: CssProps | string;
256
+ _even?: CssProps | string;
175
257
  _groupHover?: CssProps | string;
176
258
  _groupFocus?: CssProps | string;
177
259
  _groupActive?: CssProps | string;
@@ -197,7 +279,7 @@ interface ElementProps extends CssProps, Omit<ViewStyleProps, keyof HTMLAttribut
197
279
  _mozFocusInner?: CssProps | string;
198
280
  }
199
281
 
200
- declare const Element$1: react__default.MemoExoticComponent<react__default.ForwardRefExoticComponent<ElementProps & react__default.RefAttributes<HTMLElement>>>;
282
+ declare const Element$1: react__default.NamedExoticComponent<ElementProps & react__default.RefAttributes<HTMLElement>>;
201
283
 
202
284
  interface ViewProps extends Omit<ViewStyleProps, keyof ElementProps>, ElementProps {
203
285
  onPress?: (..._args: any) => void;
@@ -237,6 +319,25 @@ interface TextProps extends Omit<TextStyleProps, keyof ElementProps>, Omit<Eleme
237
319
  isSub?: boolean;
238
320
  isSup?: boolean;
239
321
  maxLines?: number;
322
+ /**
323
+ * Shorthand for fontWeight; accepts numeric (100-900) or named weights
324
+ * ("normal", "bold", "semibold", etc.). Convenience alias for the
325
+ * underlying fontWeight CSS property.
326
+ */
327
+ weight?: string | number;
328
+ /**
329
+ * Optional style variant identifier. Free-form string used by component
330
+ * wrappers and design systems to dispatch typography presets.
331
+ */
332
+ variant?: string;
333
+ /**
334
+ * Shorthand for fontSize; accepts numeric or named sizes (e.g. 'sm', 14, '14px').
335
+ */
336
+ size?: string | number;
337
+ /**
338
+ * Shorthand for letterSpacing; accepts numeric or named tracking values.
339
+ */
340
+ spacing?: string | number;
240
341
  }
241
342
 
242
343
  interface CommonProps extends ElementProps, Omit<ViewStyleProps, keyof ElementProps> {
@@ -418,7 +519,7 @@ interface WindowSizeProviderProps {
418
519
  declare const WindowSizeProvider: ({ children, targetWindow, }: WindowSizeProviderProps) => react__default.JSX.Element;
419
520
 
420
521
  declare function useActive<T extends HTMLElement = HTMLElement>(): [
421
- React.RefObject<T>,
522
+ React.RefObject<T | null>,
422
523
  boolean
423
524
  ];
424
525
 
@@ -426,7 +527,7 @@ interface UseClickOutsideOptions {
426
527
  /** Optional target window to use (for iframe support). Defaults to global window. */
427
528
  targetWindow?: Window;
428
529
  }
429
- declare function useClickOutside<T extends HTMLElement = HTMLElement>(options?: UseClickOutsideOptions): [React.RefObject<T>, boolean];
530
+ declare function useClickOutside<T extends HTMLElement = HTMLElement>(options?: UseClickOutsideOptions): [React.RefObject<T | null>, boolean];
430
531
 
431
532
  interface RelativePlacement {
432
533
  vertical: 'top' | 'bottom';
@@ -452,7 +553,7 @@ interface UseElementPositionOptions {
452
553
  }
453
554
  interface UseElementPositionReturn {
454
555
  /** React ref to attach to the target HTML element. */
455
- ref: React.RefObject<HTMLElement>;
556
+ ref: React.RefObject<HTMLElement | null>;
456
557
  /**
457
558
  * The calculated viewport relation data, or null if not yet calculated
458
559
  * or element not found.
@@ -468,12 +569,12 @@ interface UseElementPositionReturn {
468
569
  declare function useElementPosition<T extends HTMLElement = HTMLElement>(options?: UseElementPositionOptions): UseElementPositionReturn;
469
570
 
470
571
  declare function useFocus<T extends HTMLElement = HTMLElement>(): [
471
- React.RefObject<T>,
572
+ React.RefObject<T | null>,
472
573
  boolean
473
574
  ];
474
575
 
475
576
  declare function useHover<T extends HTMLElement = HTMLElement>(): [
476
- React.RefObject<T>,
577
+ React.RefObject<T | null>,
477
578
  boolean
478
579
  ];
479
580
 
@@ -485,7 +586,7 @@ interface UseOnScreenOptions extends IntersectionObserverInit {
485
586
  /** Optional target window to use (for iframe support). Defaults to global window. */
486
587
  targetWindow?: Window;
487
588
  }
488
- declare function useOnScreen<T extends HTMLElement = HTMLElement>(options?: UseOnScreenOptions): [React.RefObject<T>, boolean];
589
+ declare function useOnScreen<T extends HTMLElement = HTMLElement>(options?: UseOnScreenOptions): [React.RefObject<T | null>, boolean];
489
590
 
490
591
  /**
491
592
  * Optimized hook for components that only need breakpoint information.
@@ -563,7 +664,7 @@ interface ScrollPosition {
563
664
  elementProgress?: number;
564
665
  }
565
666
  interface UseScrollOptions {
566
- container?: RefObject<HTMLElement>;
667
+ container?: RefObject<HTMLElement | null>;
567
668
  offset?: [number, number];
568
669
  throttleMs?: number;
569
670
  disabled?: boolean;
@@ -584,11 +685,11 @@ interface UseInfiniteScrollOptions {
584
685
  debounceMs?: number;
585
686
  }
586
687
  declare const useScroll: ({ container, offset, throttleMs, disabled, }?: UseScrollOptions) => ScrollPosition;
587
- declare const useScrollAnimation: (ref: RefObject<HTMLElement>, options?: UseScrollAnimationOptions) => {
688
+ declare const useScrollAnimation: (ref: RefObject<HTMLElement | null>, options?: UseScrollAnimationOptions) => {
588
689
  isInView: boolean;
589
690
  progress: number;
590
691
  };
591
- declare const useSmoothScroll: (targetWindow?: Window) => (element: HTMLElement | null, offset?: any) => void;
692
+ declare const useSmoothScroll: (targetWindow?: Window) => (element: HTMLElement | null, offset?: number) => void;
592
693
  declare const useInfiniteScroll: (callback: () => void, options?: UseInfiniteScrollOptions) => {
593
694
  sentinelRef: react.Dispatch<react.SetStateAction<HTMLDivElement | null>>;
594
695
  };
@@ -605,7 +706,7 @@ interface InViewOptions extends IntersectionObserverInit {
605
706
  targetWindow?: Window;
606
707
  }
607
708
  declare function useInView(options?: InViewOptions): {
608
- ref: react.RefObject<HTMLElement>;
709
+ ref: react.RefObject<HTMLElement | null>;
609
710
  inView: boolean;
610
711
  };
611
712
 
@@ -650,4 +751,4 @@ declare function useIframe(iframeRef: React.RefObject<HTMLIFrameElement>): {
650
751
  isLoaded: boolean;
651
752
  };
652
753
 
653
- export { AnimationUtils, type BreakpointConfig, BreakpointContext, Button, type ButtonProps, Center, ColorPalette, ColorSingleton, type Colors, type CssProps, type DeviceConfig, type DeviceType, Div, Element$1 as Element, type ElementPosition, type ElementProps, Form, type FormProps, Horizontal, HorizontalResponsive, Image, ImageBackground, type ImageProps, Input, type InputProps, type QueryConfig, type RelativePlacement, type ResponsiveConfig, ResponsiveContext, ResponsiveProvider, type ResponsiveProviderProps, SafeArea, type ScreenConfig, type ScreenOrientation, Scroll, type ScrollPosition, Shadow, Skeleton, Span, StyleRegistry, Text, type TextProps, type Theme, ThemeContext, ThemeProvider, type UseClickOutsideOptions, type UseElementPositionOptions, type UseElementPositionReturn, type UseInfiniteScrollOptions, type UseOnScreenOptions, type UseScrollAnimationOptions, type UseScrollOptions, UtilityClassManager, Vertical, VerticalResponsive, View, type ViewProps, type WindowDimensions, WindowDimensionsContext, WindowSizeContext, WindowSizeProvider, type WindowSizeProviderProps, createStyleRegistry, debounce, deepMerge, defaultThemeMain, extractUtilityClasses, propertyShorthand, useActive, useBreakpoint, useBreakpointContext, useClickOutside, useElementPosition, useFocus, useHover, useIframe, useIframeStyles, useInView, useInfiniteScroll, useKeyPress, useMount, useOnScreen, useResponsive, useResponsiveContext, useScroll, useScrollAnimation, useScrollDirection, useServerInsertedHTML, useSmoothScroll, useStyleRegistry, useTheme, useWindowDimensions, useWindowDimensionsContext, useWindowSize, utilityClassManager };
754
+ export { AnimationProps, AnimationUtils, type BreakpointConfig, BreakpointContext, Button, type ButtonProps, Center, ColorPalette, ColorSingleton, type Colors, type CssProps, type DeviceConfig, type DeviceType, Div, Element$1 as Element, type ElementPosition, type ElementProps, Form, type FormProps, Horizontal, HorizontalResponsive, Image, ImageBackground, type ImageProps, Input, type InputProps, type QueryConfig, type RelativePlacement, type ResponsiveConfig, ResponsiveContext, ResponsiveProvider, type ResponsiveProviderProps, SafeArea, type ScreenConfig, type ScreenOrientation, Scroll, type ScrollPosition, Shadow, Skeleton, Span, StyleRegistry, Text, type TextProps, type Theme, ThemeContext, ThemeProvider, type UseClickOutsideOptions, type UseElementPositionOptions, type UseElementPositionReturn, type UseInfiniteScrollOptions, type UseOnScreenOptions, type UseScrollAnimationOptions, type UseScrollOptions, UtilityClassManager, Vertical, VerticalResponsive, View, type ViewProps, type WindowDimensions, WindowDimensionsContext, WindowSizeContext, WindowSizeProvider, type WindowSizeProviderProps, createStyleRegistry, debounce, deepMerge, defaultThemeMain, extractUtilityClasses, propertyShorthand, useActive, useBreakpoint, useBreakpointContext, useClickOutside, useElementPosition, useFocus, useHover, useIframe, useIframeStyles, useInView, useInfiniteScroll, useKeyPress, useMount, useOnScreen, useResponsive, useResponsiveContext, useScroll, useScrollAnimation, useScrollDirection, useServerInsertedHTML, useSmoothScroll, useStyleRegistry, useTheme, useWindowDimensions, useWindowDimensionsContext, useWindowSize, utilityClassManager };
package/dist/web/index.js CHANGED
@@ -4951,7 +4951,7 @@ var WindowSizeProvider = ({
4951
4951
  width: win?.innerWidth || 0,
4952
4952
  height: win?.innerHeight || 0
4953
4953
  });
4954
- const timeoutRef = useRef4();
4954
+ const timeoutRef = useRef4(void 0);
4955
4955
  useEffect4(() => {
4956
4956
  if (!win) return;
4957
4957
  const handleResize = () => {
@@ -5327,7 +5327,7 @@ var useScroll = ({
5327
5327
  elementProgress: 0
5328
5328
  });
5329
5329
  const lastUpdateRef = useRef12(0);
5330
- const frameRef = useRef12();
5330
+ const frameRef = useRef12(void 0);
5331
5331
  const ticking = useRef12(false);
5332
5332
  const getContext = useCallback5(() => {
5333
5333
  const targetEl = container?.current ?? null;
@@ -5488,7 +5488,7 @@ var useSmoothScroll = (targetWindow) => {
5488
5488
  var useInfiniteScroll = (callback, options = DEFAULT_INFINITE_SCROLL_OPTIONS) => {
5489
5489
  const [sentinel, setSentinel] = useState12(null);
5490
5490
  const callbackRef = useRef12(callback);
5491
- const timeoutRef = useRef12();
5491
+ const timeoutRef = useRef12(void 0);
5492
5492
  useEffect13(() => {
5493
5493
  callbackRef.current = callback;
5494
5494
  }, [callback]);
@@ -5535,7 +5535,7 @@ var useScrollDirection = (threshold = 5, targetWindow) => {
5535
5535
  const [scrollDirection, setScrollDirection] = useState12("up");
5536
5536
  const lastScrollY = useRef12(0);
5537
5537
  const lastDirection = useRef12("up");
5538
- const animationFrame = useRef12();
5538
+ const animationFrame = useRef12(void 0);
5539
5539
  const ticking = useRef12(false);
5540
5540
  const updateDirection = useCallback5(() => {
5541
5541
  const win = targetWindow || (typeof window !== "undefined" ? window : null);