orn-ui 0.2.9 → 0.3.0

package/lib/typescript/atoms/ShinyText.d.ts

@@ -14,11 +14,11 @@ export interface ShinyTextProps {
     spread?: number;
     /** When false it renders plain text in `shineColor`. @default true */
     animated?: boolean;
-    /** Resting color of the characters. @default theme.colors.textLight */
+    /** Resting color of the characters. Keep it readable on its own (WCAG AA): the shine is decorative. @default theme.colors.textLight */
     color?: string;
     /** Color of the band that travels across. @default theme.colors.primary */
     shineColor?: string;
-    /** @default 'left' */
+    /** Horizontal alignment of the line. @default 'left' */
     align?: 'left' | 'center' | 'right';
     /** Typography only: `color` and `shineColor` win over any color set here. */
     style?: StyleProp<TextStyle>;
@@ -26,23 +26,23 @@ export interface ShinyTextProps {
 }
 /**
  * ShinyText
- * Una banda de luz recorre el texto de izquierda a derecha. Sin
- * `background-clip: text` ni máscaras —que React Native no tiene en el rango
- * soportado— el brillo se compone letra por letra: cada una lleva su color de
- * reposo y encima, superpuesta, la misma letra en el color del brillo con la
- * opacidad animada. La banda es una ventana de interpolación que se desplaza:
- * lo que cambia por frame es sólo `opacity`, o sea que la animación entera
- * corre en el hilo nativo y JS no participa de ningún frame.
+ * A band of light sweeps across the text from left to right. Without
+ * `background-clip: text` or masks —which React Native lacks in the supported
+ * range— the shine is composed letter by letter: each one carries its resting
+ * color and, overlaid on top, the same letter in the shine color with animated
+ * opacity. The band is a moving interpolation window: the only thing that
+ * changes per frame is `opacity`, which means the whole animation runs on the
+ * native thread and JS takes part in no frame.
  *
- * Gestalt, destino común: las letras se encienden en secuencia y con el mismo
- * ritmo, así que se leen como una sola cosa que se mueve —una palabra
- * iluminándose— y no como N letras parpadeando por su cuenta. Por eso el ancho
- * de banda es relativo al texto y no una cantidad fija de píxeles: un título
- * largo y uno corto tardan lo mismo y se perciben igual.
+ * Gestalt, common fate: the letters light up in sequence and at the same
+ * rhythm, so they read as one moving thing —a word lighting up— and not as N
+ * letters blinking on their own. That is why the band width is relative to
+ * the text and not a fixed number of pixels: a long title and a short one take
+ * the same time and are perceived the same.
  *
- * Con "reducir movimiento" activo, o con `animated={false}`, el texto se
- * renderiza plano en `shineColor` —legible, un solo nodo y seleccionable—
- * porque el efecto es decorativo y nada de lo que comunica está en el brillo.
+ * With "reduce motion" on, or with `animated={false}`, the text renders flat
+ * in `shineColor` —legible, a single node and selectable— because the effect
+ * is decorative and nothing it communicates lives in the shine.
  */
 export declare const ShinyText: React.MemoExoticComponent<({ text, duration, delay, spread, animated, color, shineColor, align, style, testID, }: ShinyTextProps) => React.JSX.Element>;
 //# sourceMappingURL=ShinyText.d.ts.map

package/lib/typescript/atoms/ShinyText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShinyText.d.ts","sourceRoot":"","sources":["../../../src/atoms/ShinyText.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2C,MAAM,OAAO,CAAC;AAChE,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,SAAS,EAEf,MAAM,cAAc,CAAC;AAKtB,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAyDD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,SAAS,oHAYjB,cAAc,uBAkGlB,CAAC"}
+{"version":3,"file":"ShinyText.d.ts","sourceRoot":"","sources":["../../../src/atoms/ShinyText.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2C,MAAM,OAAO,CAAC;AAChE,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,SAAS,EAEf,MAAM,cAAc,CAAC;AAKtB,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uIAAuI;IACvI,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAyDD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,SAAS,oHAYjB,cAAc,uBAkGlB,CAAC"}

package/lib/typescript/atoms/Skeleton.d.ts

@@ -2,11 +2,11 @@ import React from 'react';
 import { type DimensionValue, type StyleProp, type ViewStyle } from 'react-native';
 export type SkeletonVariant = 'rect' | 'text' | 'circle';
 export interface SkeletonProps {
-    /** @default '100%' ('circle' also uses this as the diameter) */
+    /** Width of the placeholder. @default '100%' ('circle' also uses this as the diameter) */
     width?: DimensionValue;
-    /** @default 16 ('text' uses the line height; 'circle', the width) */
+    /** Height of the placeholder. @default 16 ('text' uses Body's line height; 'circle', the width) */
     height?: DimensionValue;
-    /** @default 'rect' */
+    /** Shape: a block, a line of text or a circle. @default 'rect' */
     variant?: SkeletonVariant;
     /** Override of the theme's radius. */
     radius?: number;
@@ -14,16 +14,21 @@ export interface SkeletonProps {
     lines?: number;
     /** Width of the last line, so the paragraph doesn't end as a solid block. @default '60%' */
     lastLineWidth?: DimensionValue;
-    /** @default true */
+    /** Pulses while waiting. Off when the system's Reduce Motion is on. @default true */
     animated?: boolean;
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }
 /**
  * Skeleton
- * Placeholder que late mientras llega el contenido real. Reserva el espacio
- * exacto de lo que reemplaza, así la pantalla no salta cuando aparecen los
- * datos — que es justamente lo que un Spinner centrado no puede hacer.
+ * Placeholder that pulses while the real content arrives. It reserves the
+ * exact space of what it replaces, so the screen doesn't jump when the data
+ * shows up — which is precisely what a centered Spinner can't do.
+ *
+ * Gestalt, similarity: the silhouette repeats the shape and size of the
+ * content (a circle for avatars, Body-height lines for text), so the eye
+ * already groups the screen before the data arrives. Respects Reduce Motion:
+ * no pulse, a static block.
  */
 export declare const Skeleton: React.MemoExoticComponent<({ width, height, variant, radius, lines, lastLineWidth, animated, style, testID, }: SkeletonProps) => React.JSX.Element>;
 //# sourceMappingURL=Skeleton.d.ts.map

package/lib/typescript/atoms/Skeleton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Skeleton.d.ts","sourceRoot":"","sources":["../../../src/atoms/Skeleton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkC,MAAM,OAAO,CAAC;AACvD,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,qEAAqE;IACrE,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,sBAAsB;IACtB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,oBAAoB;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAOD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,iHAWhB,aAAa,uBAyDjB,CAAC"}
+{"version":3,"file":"Skeleton.d.ts","sourceRoot":"","sources":["../../../src/atoms/Skeleton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuD,MAAM,OAAO,CAAC;AAC5E,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAQtB,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,0FAA0F;IAC1F,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,mGAAmG;IACnG,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,kEAAkE;IAClE,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAYD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,iHAWhB,aAAa,uBA+DjB,CAAC"}

package/lib/typescript/atoms/Spinner.d.ts

@@ -1,8 +1,11 @@
 import React from 'react';
 export type SpinnerVariant = 'native' | 'dots' | 'ring';
 export interface SpinnerProps {
+    /** Indicator size; also scales the `dots` and `ring` variants. @default 'large' */
     size?: 'small' | 'large';
+    /** Indicator color. @default colors.primary */
     color?: string;
+    /** Message under the indicator. Also what screen readers announce. */
     text?: string;
     /** @default true. When false, doesn't take up flex:1 (useful inline, inside a button/row). */
     fullscreen?: boolean;
@@ -14,7 +17,32 @@ export interface SpinnerProps {
     variant?: SpinnerVariant;
     /** Fully custom indicator. Takes precedence over `variant`. */
     indicator?: React.ReactNode;
+    /**
+     * Shown above the indicator — typically the app logo on a splash or
+     * first-load screen (an `<Image>`, an `<Avatar>`, any node).
+     */
+    logo?: React.ReactNode;
+    /** What screen readers announce. @default text ?? labels.loading */
+    accessibilityLabel?: string;
     testID?: string;
 }
-export declare const Spinner: React.MemoExoticComponent<({ size, color, text, fullscreen, variant, indicator, testID }: SpinnerProps) => React.JSX.Element>;
+/**
+ * Spinner
+ * Indeterminate loading indicator, with optional text below.
+ *
+ * Gestalt:
+ * - Common fate: the three `dots` pulse in sequence, at the same rhythm, and
+ *   read as a single indicator moving forward.
+ * - Proximity: the text sits `spacing.md` from the indicator, so it reads as
+ *   its explanation and not as loose text on the screen. The `logo` sits
+ *   further away (`spacing.xl`): it is the screen's brand, not part of the indicator.
+ * - Focal point: with `logo`, the logo is the first thing seen and the
+ *   indicator stays as a secondary signal that the app is loading.
+ *
+ * Accessibility: it is announced as a busy `progressbar`, with `text` (or
+ * `labels.loading`) as its name. The animation doesn't stop with Reduce
+ * Motion: it is the signal that something is happening, like the system's
+ * ActivityIndicator.
+ */
+export declare const Spinner: React.MemoExoticComponent<({ size, color, text, fullscreen, variant, indicator, logo, accessibilityLabel, testID, }: SpinnerProps) => React.JSX.Element>;
 //# sourceMappingURL=Spinner.d.ts.map

package/lib/typescript/atoms/Spinner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Spinner.d.ts","sourceRoot":"","sources":["../../../src/atoms/Spinner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkC,MAAM,OAAO,CAAC;AAKvD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA6ED,eAAO,MAAM,OAAO,4FAC0E,YAAY,uBAyBzG,CAAC"}
+{"version":3,"file":"Spinner.d.ts","sourceRoot":"","sources":["../../../src/atoms/Spinner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkC,MAAM,OAAO,CAAC;AAKvD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,mFAAmF;IACnF,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B;;;OAGG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4FD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,OAAO,uHAWf,YAAY,uBAmChB,CAAC"}

package/lib/typescript/atoms/Text.d.ts

@@ -6,8 +6,54 @@ export interface TypographyProps extends TextProps {
     color?: string;
     align?: 'left' | 'center' | 'right';
 }
+/**
+ * Screen or section title: the highest step of the typographic hierarchy.
+ *
+ * Gestalt, focal point (Von Restorff): it is the only text in its block with
+ * size `xxl` and weight `bold`, so it breaks the series of Body/Caption and is
+ * the first thing read. That is why there should be only one per block: two
+ * Titles together cancel each other out. The `tight` tracking offsets the room
+ * the large size opens between letters so the word reads as a single shape
+ * (Prägnanz), and `lineHeight.xl` keeps the block compact when the title wraps.
+ *
+ * Accessibility: it is announced with `accessibilityRole="header"`, so
+ * VoiceOver/TalkBack can jump from title to title. It can be overridden by
+ * passing a different `accessibilityRole`.
+ */
 export declare const Title: React.MemoExoticComponent<({ children, style, color, align, ...props }: TypographyProps) => React.JSX.Element>;
+/**
+ * Second step of the hierarchy: heads a group within the screen or
+ * accompanies a Title with a short piece of data.
+ *
+ * Gestalt, similarity: it shares its color with Body but steps up size (`lg`)
+ * and weight (`semibold`), so it is perceived as part of the same family and,
+ * at the same time, as the label of the block that follows. Proximity: it
+ * should sit closer to the content it heads than to the previous block. It is
+ * not an accessibility heading: if it marks a navigable section, use Title (or
+ * pass `accessibilityRole="header"`).
+ * `lineHeight.lg` (1.5×) keeps the text legible when it spans several lines.
+ */
 export declare const Subtitle: React.MemoExoticComponent<({ children, style, color, align, ...props }: TypographyProps) => React.JSX.Element>;
+/**
+ * Running text: the default style for paragraphs, descriptions and values.
+ *
+ * Gestalt, similarity: all reading content shares size (`md`), regular weight
+ * and the `text` color, so it is perceived as a single level and the steps
+ * above (Title, Subtitle) and below (Caption) stand out by contrast.
+ * `lineHeight.md` (≈1.43×) gives the room between lines to read long
+ * paragraphs. If `color` is passed, the color/background pair must meet WCAG
+ * AA (4.5:1); the theme colors already guarantee it.
+ */
 export declare const Body: React.MemoExoticComponent<({ children, style, color, align, ...props }: TypographyProps) => React.JSX.Element>;
+/**
+ * Secondary text: hints, metadata, dates, help below a field.
+ *
+ * Gestalt, figure and ground: size `sm` and color `textLight` bring it one
+ * step below Body, so it reads as context and doesn't compete with the
+ * content. Proximity: it sits right next to the element it explains.
+ * `textLight` meets WCAG AA over `surface` and `background` in light and dark
+ * (palettes tests); don't lighten it further. `lineHeight.sm` (≈1.33×) keeps
+ * the lines together when the hint spans several.
+ */
 export declare const Caption: React.MemoExoticComponent<({ children, style, color, align, ...props }: TypographyProps) => React.JSX.Element>;
 //# sourceMappingURL=Text.d.ts.map

package/lib/typescript/atoms/Text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Text.d.ts","sourceRoot":"","sources":["../../../src/atoms/Text.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAkB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9F,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CACrC;AA4CD,eAAO,MAAM,KAAK,0EAlB8D,eAAe,uBAkB9C,CAAC;AAClD,eAAO,MAAM,QAAQ,0EAnB2D,eAAe,uBAmBxC,CAAC;AACxD,eAAO,MAAM,IAAI,0EApB+D,eAAe,uBAoBhD,CAAC;AAChD,eAAO,MAAM,OAAO,0EArB4D,eAAe,uBAqBrC,CAAC"}
+{"version":3,"file":"Text.d.ts","sourceRoot":"","sources":["../../../src/atoms/Text.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CACrC;AAoDD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,KAAK,0EAjC8D,eAAe,uBAiCpC,CAAC;AAC5D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,QAAQ,0EA9C2D,eAAe,uBA8CxC,CAAC;AACxD;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,0EAzD+D,eAAe,uBAyDhD,CAAC;AAChD;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO,0EApE4D,eAAe,uBAoErC,CAAC"}

package/lib/typescript/atoms/Transition.d.ts

@@ -1,7 +1,9 @@
 import React from 'react';
 import { Animated, type StyleProp, type ViewStyle } from 'react-native';
+import { useReduceMotion } from '../theme/useReduceMotion';
 export type TransitionPreset = 'fade' | 'scale' | 'pop' | 'slide-up' | 'slide-down' | 'slide-left' | 'slide-right';
 export interface TransitionProps {
+    /** Content that enters and exits. */
     children: React.ReactNode;
     /** Enters when true, exits (and unmounts) when false. @default true */
     visible?: boolean;
@@ -11,7 +13,7 @@ export interface TransitionProps {
     duration?: number;
     /** ms before starting. A per-index delay staggers a list. @default 0 */
     delay?: number;
-    /** Pixels traveled by the slide presets. @default 24 */
+    /** Pixels traveled by the slide presets. @default tokens.spacing.xxl (24) */
     distance?: number;
     /** Spring instead of timing (implicit in 'pop'). */
     spring?: boolean;
@@ -24,28 +26,30 @@ export interface TransitionProps {
      * whoever passes it decides when and how it advances (a PanResponder, for example).
      */
     value?: Animated.Value;
+    /** Called when the enter animation finishes. Not called when driven by `value`. */
     onEntered?: () => void;
+    /** Called when the exit animation finishes, before unmounting. Not called when driven by `value`. */
     onExited?: () => void;
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }
-/**
- * Sigue el ajuste de "reducir movimiento" del sistema: con él activo las
- * animaciones saltan al estado final en vez de desactivarse, así que los
- * callbacks y el desmontaje siguen ocurriendo igual.
- */
-export declare function useReduceMotion(): boolean;
+export { useReduceMotion };
 /**
  * Transition
- * Envuelve cualquier árbol y lo anima al entrar y al salir. Todos los presets
- * se reducen a `opacity` y `transform` sobre un único Animated.Value, que es
- * lo que `useNativeDriver` sabe mandar al hilo nativo: la animación corre ahí
- * y el hilo de JS no participa de ningún frame — por eso no hay presets de
- * alto, ancho o color, que obligarían a volver a JS en cada frame.
+ * Wraps any tree and animates it on enter and exit. Every preset boils down
+ * to `opacity` and `transform` over a single Animated.Value, which is what
+ * `useNativeDriver` knows how to send to the native thread: the animation runs
+ * there and the JS thread takes part in no frame — that is why there are no
+ * height, width or color presets, which would force a return to JS every frame.
+ *
+ * The node stays mounted until the exit animation finishes, and the behavior
+ * is identical on iOS and Android: there is no per-platform branch. While
+ * exiting (or hidden with `keepMounted`) it stops receiving touches and leaves
+ * the accessibility tree: what is invisible isn't read.
  *
- * El nodo se mantiene montado hasta que termina la animación de salida, y el
- * comportamiento es idéntico en iOS y Android: no hay ninguna rama por
- * plataforma.
+ * Gestalt, common fate: what enters or exits together is perceived as a group;
+ * with a per-index `delay` the list enters in reading order (continuity).
+ * Respects Reduce Motion: jumps to the final state, callbacks still fire.
  */
 export declare const Transition: React.MemoExoticComponent<({ children, visible, preset, duration, delay, distance, spring, appear, keepMounted, value, onEntered, onExited, style, testID, }: TransitionProps) => React.JSX.Element | null>;
 //# sourceMappingURL=Transition.d.ts.map

package/lib/typescript/atoms/Transition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Transition.d.ts","sourceRoot":"","sources":["../../../src/atoms/Transition.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqD,MAAM,OAAO,CAAC;AAC1E,OAAO,EAAqB,QAAQ,EAAU,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGnG,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,OAAO,GACP,KAAK,GACL,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,aAAa,CAAC;AAElB,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAAC;IAC/C,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAkBzC;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,gKAgBlB,eAAe,8BA0FnB,CAAC"}
+{"version":3,"file":"Transition.d.ts","sourceRoot":"","sources":["../../../src/atoms/Transition.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqD,MAAM,OAAO,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAU,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEhF,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,OAAO,GACP,KAAK,GACL,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,aAAa,CAAC;AAElB,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAAC;IAC/C,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC;IACvB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,qGAAqG;IACrG,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,UAAU,gKAgBlB,eAAe,8BA+FnB,CAAC"}

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

@@ -5,7 +5,7 @@ export type { ButtonProps, ButtonVariant, ButtonSize } from './Button';
 export { IconButton } from './IconButton';
 export type { IconButtonProps } from './IconButton';
 export { Input } from './Input';
-export type { InputProps } from './Input';
+export type { InputProps, InputHandle, InputRules, InputRuleValue } from './Input';
 export { Checkbox } from './Checkbox';
 export type { CheckboxProps } from './Checkbox';
 export { Badge } from './Badge';
@@ -16,7 +16,7 @@ export { Divider } from './Divider';
 export type { DividerProps } from './Divider';
 export { Gradient } from './Gradient';
 export type { GradientProps, GradientDirection } from './Gradient';
-export { Avatar } from './Avatar';
+export { Avatar, initialsOf } from './Avatar';
 export type { AvatarProps } from './Avatar';
 export { Image, prefetchImage } from './Image';
 export type { ImageProps } from './Image';
@@ -29,7 +29,7 @@ export type { TransitionProps, TransitionPreset } from './Transition';
 export { ShinyText } from './ShinyText';
 export type { ShinyTextProps } from './ShinyText';
 export { EmptyState } from './EmptyState';
-export type { EmptyStateProps } from './EmptyState';
+export type { EmptyStateProps, EmptyStateAction } from './EmptyState';
 export { KeyValueRow } from './KeyValueRow';
 export type { KeyValueRowProps } from './KeyValueRow';
 export { Fab } from './Fab';

package/lib/typescript/atoms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/atoms/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,YAAY,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/atoms/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,YAAY,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/typescript/atoms/inputValidation.d.ts

@@ -0,0 +1,29 @@
+import type { Labels } from '../theme/labels';
+/** A rule's value, optionally with its own message instead of the default label. */
+export type InputRuleValue<T> = T | {
+    value: T;
+    message: string;
+};
+export interface InputRules {
+    /** Fewer characters than this is an error. Message: `labels.minLengthError`. */
+    minLength?: InputRuleValue<number>;
+    /** More characters than this is an error. Message: `labels.maxLengthError`. */
+    maxLength?: InputRuleValue<number>;
+    /** The value must match. Message: `labels.patternError`. */
+    pattern?: InputRuleValue<RegExp>;
+    /**
+     * Custom check, run last. Return an error message, or `false` for
+     * `labels.patternError`; anything else means valid.
+     */
+    validate?: (value: string) => string | boolean | null | undefined;
+}
+/**
+ * Error for the value, or undefined if it is valid. Order: required, min
+ * length, max length, pattern, custom validation — a single error is shown,
+ * the first one. An empty optional field is valid: the other rules don't run on nothing.
+ */
+export declare function validateInputValue(value: string, { required, rules }: {
+    required?: boolean;
+    rules?: InputRules;
+}, labels: Labels): string | undefined;
+//# sourceMappingURL=inputValidation.d.ts.map

package/lib/typescript/atoms/inputValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputValidation.d.ts","sourceRoot":"","sources":["../../../src/atoms/inputValidation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,oFAAoF;AACpF,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,gFAAgF;IAChF,SAAS,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACnC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACnC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;CACnE;AAQD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAAE,EAC/D,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,SAAS,CAwBpB"}

package/lib/typescript/icons/Icon.d.ts

@@ -9,10 +9,10 @@ export interface IconProps {
 }
 /**
  * Icon
- * Resuelve el glifo vía el renderer activo (UIProvider.icons, default zero-dep
- * si no se configuró ninguno). Uso interno de la librería — los componentes
- * públicos exponen `icon?: ReactNode` además de esto, para que el consumidor
- * pueda inyectar cualquier ícono sin pasar por el sistema de nombres.
+ * Resolves the glyph through the active renderer (UIProvider.icons, the
+ * zero-dep default if none was configured). Internal use by the library —
+ * public components expose `icon?: ReactNode` in addition to this, so the
+ * consumer can inject any icon without going through the name system.
  */
 export declare const Icon: React.MemoExoticComponent<({ name, size, color, style }: IconProps) => React.JSX.Element>;
 //# sourceMappingURL=Icon.d.ts.map

package/lib/typescript/icons/defaultIcons.d.ts

@@ -1,5 +1,22 @@
 import React from 'react';
-import type { IconName, IconRenderProps } from './types';
-/** Renderer default. Se usa cuando <UIProvider icons={...}> no pasa uno propio. */
+import type { BuiltInIconName, IconName, IconRenderProps } from './types';
+/**
+ * Default glyphs drawn with RN primitives (View + border + transform).
+ * Zero dependencies, zero fonts, zero async loading. They cover what the
+ * library needs internally (checkbox, Select chevrons, password toggle in
+ * Input, etc) plus a basic set for apps (menu, home, user…).
+ * For a complete set, the consumer injects their own via
+ * <UIProvider icons={...}> or the `icon` prop.
+ */
+/**
+ * Color of the inner glyph of a filled icon (alert, warning): black or
+ * white depending on the fill's luminance. A fixed white disappeared over
+ * dark mode's light fills (figure and ground). Non-hex colors (rgb(),
+ * names) fall back to white, the common case over saturated accents.
+ */
+export declare function onColor(fill: string): string;
+/** All included glyphs, in catalog order. */
+export declare const BUILT_IN_ICON_NAMES: readonly BuiltInIconName[];
+/** Default renderer. Used when <UIProvider icons={...}> doesn't pass its own. */
 export declare function renderDefaultIcon(name: IconName, props: IconRenderProps): React.ReactNode;
 //# sourceMappingURL=defaultIcons.d.ts.map

package/lib/typescript/icons/defaultIcons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaultIcons.d.ts","sourceRoot":"","sources":["../../../src/icons/defaultIcons.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AA6PzD,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,GAAG,KAAK,CAAC,SAAS,CAmCzF"}
+{"version":3,"file":"defaultIcons.d.ts","sourceRoot":"","sources":["../../../src/icons/defaultIcons.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1E;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAc5C;AAkmBD,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,EAAE,SAAS,eAAe,EAIzD,CAAC;AAEF,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,GAAG,KAAK,CAAC,SAAS,CA+DzF"}

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

@@ -1,5 +1,5 @@
 export { Icon } from './Icon';
 export type { IconProps } from './Icon';
-export { renderDefaultIcon } from './defaultIcons';
-export type { IconName, IconRenderer, IconRenderProps } from './types';
+export { renderDefaultIcon, BUILT_IN_ICON_NAMES } from './defaultIcons';
+export type { BuiltInIconName, IconName, IconRenderer, IconRenderProps } from './types';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/icons/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/icons/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/icons/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACxE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/lib/typescript/icons/types.d.ts

@@ -1,10 +1,20 @@
 import type { ReactNode } from 'react';
-/** Glifos que los componentes de la librería necesitan internamente. */
-export type IconName = 'check' | 'close' | 'chevron-down' | 'chevron-up' | 'chevron-left' | 'chevron-right' | 'eye' | 'eye-off' | 'search' | 'plus' | 'minus' | 'alert' | 'info' | 'warning' | 'question';
+/**
+ * Included glyphs (drawn with RN primitives, zero dependencies): the ones
+ * the library uses internally plus a basic set for apps.
+ */
+export type BuiltInIconName = 'check' | 'close' | 'chevron-down' | 'chevron-up' | 'chevron-left' | 'chevron-right' | 'eye' | 'eye-off' | 'search' | 'scan' | 'plus' | 'minus' | 'alert' | 'info' | 'warning' | 'question' | 'menu' | 'more' | 'home' | 'settings' | 'user' | 'trash' | 'edit' | 'share' | 'heart' | 'star';
+/**
+ * Icon name accepted by `iconName`, `leftIconName`, etc. Autocompletes the
+ * included ones and also accepts any string, for those who plug in their own
+ * set with `<UIProvider icons={...}>` (e.g. `iconName="calendar"`). A name
+ * the active renderer doesn't know draws nothing (and warns in development).
+ */
+export type IconName = BuiltInIconName | (string & {});
 export interface IconRenderProps {
     size: number;
     color: string;
 }
-/** Renderer inyectable: reemplaza los glifos default por los de cualquier set de iconos. */
+/** Injectable renderer: replaces the default glyphs with those of any icon set. */
 export type IconRenderer = (name: IconName, props: IconRenderProps) => ReactNode;
 //# sourceMappingURL=types.d.ts.map

package/lib/typescript/icons/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/icons/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,wEAAwE;AACxE,MAAM,MAAM,QAAQ,GAChB,OAAO,GACP,OAAO,GACP,cAAc,GACd,YAAY,GACZ,cAAc,GACd,eAAe,GACf,KAAK,GACL,SAAS,GACT,QAAQ,GACR,MAAM,GACN,OAAO,GACP,OAAO,GACP,MAAM,GACN,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4FAA4F;AAC5F,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,KAAK,SAAS,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/icons/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,OAAO,GACP,cAAc,GACd,YAAY,GACZ,cAAc,GACd,eAAe,GACf,KAAK,GACL,SAAS,GACT,QAAQ,GACR,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,GACP,MAAM,GACN,SAAS,GACT,UAAU,GACV,MAAM,GACN,MAAM,GACN,MAAM,GACN,UAAU,GACV,MAAM,GACN,OAAO,GACP,MAAM,GACN,OAAO,GACP,OAAO,GACP,MAAM,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,eAAe,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mFAAmF;AACnF,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,KAAK,SAAS,CAAC"}

package/lib/typescript/molecules/AvatarHeader.d.ts

@@ -4,17 +4,36 @@ import type { IconName } from '../icons/types';
 export interface AvatarHeaderProps {
     /** Icon to show inside the circle. If omitted, `initials` is used instead. */
     iconName?: IconName;
+    /** Icon color. Keep AA contrast against `primarySoft`, the circle's fill. @default colors.primary */
     iconColor?: string;
-    /** Short text (e.g. 2 letters) shown when `iconName` isn't provided. */
+    /** Short text (e.g. 2 letters) shown when `iconName` isn't provided. Without either, a `user` icon. */
     initials?: string;
+    /** Main heading of the screen or modal; announced as a header. */
     title: string;
+    /** Supporting line under the title. A string gets the muted style; a node renders as is. */
     subtitle?: React.ReactNode;
+    /**
+     * Third and last line, the least important detail ("Joined March 2023").
+     * Three lines is the limit: beyond that the header stops being scannable.
+     */
+    caption?: string;
     style?: StyleProp<ViewStyle>;
+    testID?: string;
 }
 /**
  * AvatarHeader
- * Círculo 80x80 con ícono o iniciales + título/subtítulo centrado. Header
- * típico de modales de detalle (cliente, producto, etc).
+ * 80x80 circle with an icon or initials + centered title/subtitle. Typical
+ * header of detail modals (client, product, etc).
+ *
+ * Gestalt, symmetry and focal point: everything sits on one centered axis and
+ * the circle is the single large shape, so the eye lands there first and then
+ * drops to the title. Proximity: title and subtitle are closer to each other
+ * than to the circle, reading as one name + its detail. Hierarchy by size:
+ * title, subtitle, caption — at most three lines of text. Long text wraps
+ * centered, so the axis holds. No outer margin: the parent sets the spacing.
+ *
+ * Accessibility: the title is a header; the circle is decorative (the
+ * initials would only repeat the title).
  */
-export declare const AvatarHeader: React.MemoExoticComponent<({ iconName, iconColor, initials, title, subtitle, style }: AvatarHeaderProps) => React.JSX.Element>;
+export declare const AvatarHeader: React.MemoExoticComponent<({ iconName, iconColor, initials, title, subtitle, caption, style, testID }: AvatarHeaderProps) => React.JSX.Element>;
 //# sourceMappingURL=AvatarHeader.d.ts.map

package/lib/typescript/molecules/AvatarHeader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AvatarHeader.d.ts","sourceRoot":"","sources":["../../../src/molecules/AvatarHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B;AAkBD;;;;GAIG;AACH,eAAO,MAAM,YAAY,wFAAoE,iBAAiB,uBA4B5G,CAAC"}
+{"version":3,"file":"AvatarHeader.d.ts","sourceRoot":"","sources":["../../../src/molecules/AvatarHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,qGAAqG;IACrG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uGAAuG;IACvG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA6CD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,yGACsD,iBAAiB,uBAmC/F,CAAC"}

package/lib/typescript/molecules/FormActions.d.ts

@@ -2,20 +2,37 @@ import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 import type { IconName } from '../icons/types';
 export interface FormActionsProps {
-    /** If omitted, only the secondary button is shown. */
+    /** Label of the main action ("Save"). The primary button shows only with both this and `onPrimaryPress`. */
     primaryLabel?: string;
+    /** Main action. */
     onPrimaryPress?: () => void;
+    /** Blocks the main action, e.g. while the form is invalid. @default false */
     primaryDisabled?: boolean;
+    /**
+     * The main action is running: shows a spinner and ignores presses, so it
+     * can't be sent twice. The secondary button stays usable. @default false
+     */
     primaryLoading?: boolean;
+    /** Icon before the primary label. */
     primaryLeftIconName?: IconName;
+    /** Label of the ghost button. @default labels.close */
     secondaryLabel?: string;
+    /** Close / cancel action. */
     onSecondaryPress: () => void;
     style?: StyleProp<ViewStyle>;
+    /** Root testID; the buttons get `<testID>-primary` and `<testID>-secondary`. */
+    testID?: string;
 }
 /**
  * FormActions
- * Par de botones: uno primario (guardar/editar) y uno ghost (cerrar/cancelar).
- * Uso típico: al final de un form, o en el footer de un Modal.
+ * Pair of buttons: a primary one (save/edit) and a ghost one (close/cancel).
+ * Typical use: at the end of a form, or in a Modal's footer.
+ *
+ * Gestalt, proximity: both buttons sit close together and apart from the
+ * fields, so they read as the form's closing actions. Von Restorff: only the
+ * primary is filled; the secondary is ghost, so the main path is obvious and
+ * the two never compete (Hick: one clear choice). Fitts: full width, primary
+ * first, closest to the content it acts on.
  */
-export declare const FormActions: React.MemoExoticComponent<({ primaryLabel, onPrimaryPress, primaryDisabled, primaryLoading, primaryLeftIconName, secondaryLabel, onSecondaryPress, style, }: FormActionsProps) => React.JSX.Element>;
+export declare const FormActions: React.MemoExoticComponent<({ primaryLabel, onPrimaryPress, primaryDisabled, primaryLoading, primaryLeftIconName, secondaryLabel, onSecondaryPress, style, testID, }: FormActionsProps) => React.JSX.Element>;
 //# sourceMappingURL=FormActions.d.ts.map

package/lib/typescript/molecules/FormActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormActions.d.ts","sourceRoot":"","sources":["../../../src/molecules/FormActions.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAQ,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,QAAQ,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,+JAUnB,gBAAgB,uBAiBpB,CAAC"}
+{"version":3,"file":"FormActions.d.ts","sourceRoot":"","sources":["../../../src/molecules/FormActions.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAQ,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,MAAM,WAAW,gBAAgB;IAC/B,4GAA4G;IAC5G,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB;IACnB,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qCAAqC;IACrC,mBAAmB,CAAC,EAAE,QAAQ,CAAC;IAC/B,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,uKAWnB,gBAAgB,uBAwBpB,CAAC"}