orn-ui 0.2.9 → 0.3.0

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

@@ -1,8 +1,19 @@
 import React from 'react';
-import { type ViewProps, type ViewStyle } from 'react-native';
+import { type StyleProp, type ViewProps, type ViewStyle } from 'react-native';
 export interface CardProps extends ViewProps {
+    /** Content of the card, inside its padding, background and border. */
     children: React.ReactNode;
-    style?: ViewStyle;
+    style?: StyleProp<ViewStyle>;
 }
+/**
+ * Card
+ * Surface container: groups related content.
+ *
+ * Gestalt, common region: everything inside the same background and border
+ * reads as a group, even when other elements are nearby. Figure and ground:
+ * in light the shadow sets it apart; in dark (where the shadow isn't visible)
+ * a thin border does. The inner padding (`spacing.lg`) must be larger than the
+ * spacing between the elements inside, so the content reads as one block.
+ */
 export declare const Card: React.MemoExoticComponent<({ children, style, ...props }: CardProps) => React.JSX.Element>;
 //# sourceMappingURL=Card.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/atoms/Card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAQ,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGpE,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAWD,eAAO,MAAM,IAAI,4DAAwC,SAAS,uBAOhE,CAAC"}
+{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/atoms/Card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAQ,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGpF,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,sEAAsE;IACtE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B;AAmBD;;;;;;;;;GASG;AAEH,eAAO,MAAM,IAAI,4DAAwC,SAAS,uBAOhE,CAAC"}

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

@@ -1,11 +1,36 @@
 import React from 'react';
 export interface CheckboxProps {
+    /** Whether the box is checked (controlled). */
     value: boolean;
+    /** Called with the new value when the row is pressed. */
     onValueChange: (value: boolean) => void;
+    /** Text next to the box; the whole row is touchable. Also the accessible name. */
     label?: string;
+    /**
+     * Fill and border color when checked. The check turns black or white for contrast. @default
+     * colors.primary
+     */
     color?: string;
+    /** Dims the box and the label and ignores presses. */
     disabled?: boolean;
+    /** Effectively required without `label`: it is all a screen reader announces. */
+    accessibilityLabel?: string;
     testID?: string;
 }
-export declare const Checkbox: React.MemoExoticComponent<({ value, onValueChange, label, color, disabled, testID }: CheckboxProps) => React.JSX.Element>;
+/**
+ * Checkbox
+ * Box + optional label; the whole row is touchable.
+ *
+ * Gestalt:
+ * - Proximity: the box and its label sit `spacing.md` apart, less than the
+ *   spacing between rows, so each label reads with its box.
+ * - Common region: the whole row is the touch area, not just the box, and it
+ *   is at least 44pt tall (Fitts).
+ * - Figure and ground: when checked, the box fills with the accent and the
+ *   check turns black or white depending on that fill (also with a custom `color`).
+ *
+ * `disabled` dims the box and the label (not just the box). The check
+ * animation is skipped with Reduce Motion.
+ */
+export declare const Checkbox: React.MemoExoticComponent<({ value, onValueChange, label, color, disabled, accessibilityLabel, testID }: CheckboxProps) => React.JSX.Element>;
 //# sourceMappingURL=Checkbox.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Checkbox.d.ts","sourceRoot":"","sources":["../../../src/atoms/Checkbox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkC,MAAM,OAAO,CAAC;AAMvD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAgBD,eAAO,MAAM,QAAQ,uFAAmE,aAAa,uBA+CnG,CAAC"}
+{"version":3,"file":"Checkbox.d.ts","sourceRoot":"","sources":["../../../src/atoms/Checkbox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkC,MAAM,OAAO,CAAC;AAQvD,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,KAAK,EAAE,OAAO,CAAC;IACf,yDAAyD;IACzD,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAmBD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,2GAAuF,aAAa,uBAsDvH,CAAC"}

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

@@ -1,8 +1,25 @@
 import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
+import type { Tokens } from '../theme/tokens';
 export interface DividerProps {
+    /** `vertical` separates items in a row and stretches to the row's height. @default 'horizontal' */
+    orientation?: 'horizontal' | 'vertical';
+    /** Space on each side of the line, from the spacing scale. Unset, the line adds no margin. */
+    spacing?: keyof Tokens['spacing'];
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }
-export declare const Divider: React.MemoExoticComponent<({ style, testID }: DividerProps) => React.JSX.Element>;
+/**
+ * Divider
+ * 1pt line in `colors.border`.
+ *
+ * Gestalt: separates groups when proximity alone isn't enough (dense lists,
+ * rows spanning the whole screen). If spacing already separates the groups,
+ * prefer spacing: one line too many fragments what should read together.
+ * `spacing` takes its room from the token scale so the separation is the
+ * same across the whole app, instead of a different margin on each screen.
+ *
+ * It is decorative: it doesn't enter the accessibility tree.
+ */
+export declare const Divider: React.MemoExoticComponent<({ orientation, spacing, style, testID }: DividerProps) => React.JSX.Element>;
 //# sourceMappingURL=Divider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Divider.d.ts","sourceRoot":"","sources":["../../../src/atoms/Divider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAQ,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGpE,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,OAAO,gDAA4B,YAAY,uBAG1D,CAAC"}
+{"version":3,"file":"Divider.d.ts","sourceRoot":"","sources":["../../../src/atoms/Divider.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,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,mGAAmG;IACnG,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO,sEAAiE,YAAY,uBAgB/F,CAAC"}

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

@@ -1,12 +1,39 @@
 import React from 'react';
-import { type ViewStyle } from 'react-native';
+import { type StyleProp, type ViewStyle } from 'react-native';
 import type { IconName } from '../icons/types';
+import { type ButtonVariant } from './Button';
+export interface EmptyStateAction {
+    label: string;
+    onPress: () => void;
+    /** @default 'primary' */
+    variant?: ButtonVariant;
+}
 export interface EmptyStateProps {
+    /** Main line. @default labels.noResultsTitle */
     title?: string;
+    /** Supporting line under the title. @default labels.noResultsDescription */
     description?: string;
+    /** Built-in or custom icon name. Ignored when `icon` is passed. @default 'search' */
     iconName?: IconName;
+    /** Any node in place of the icon (an Image, an illustration). */
     icon?: React.ReactNode;
-    style?: ViewStyle;
+    /** The next step, shown as a button under the text (e.g. "Add client"). */
+    action?: EmptyStateAction;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
 }
-export declare const EmptyState: React.MemoExoticComponent<({ title, description, iconName, icon, style }: EmptyStateProps) => React.JSX.Element>;
+/**
+ * EmptyState
+ * Centered icon + title + description for a list or screen with no data.
+ *
+ * Gestalt, proximity: title and description sit close together (`spacing.xs`)
+ * and the icon one step further (`spacing.md`), so they read as a message
+ * with its image and not as three loose pieces. Similarity: the title in
+ * `text` and the description in `textLight` mark the hierarchy. The action,
+ * if any, is set further apart (`spacing.lg`): it is the next step, not part
+ * of the message.
+ * The message is a single accessibility node (title and description together;
+ * the icon is decorative) and the button a separate, focusable one.
+ */
+export declare const EmptyState: React.MemoExoticComponent<({ title, description, iconName, icon, action, style, testID }: EmptyStateProps) => React.JSX.Element>;
 //# sourceMappingURL=EmptyState.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"EmptyState.d.ts","sourceRoot":"","sources":["../../../src/atoms/EmptyState.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAyBD,eAAO,MAAM,UAAU,4EACsC,eAAe,uBAmB3E,CAAC"}
+{"version":3,"file":"EmptyState.d.ts","sourceRoot":"","sources":["../../../src/atoms/EmptyState.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;AAC/C,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,yBAAyB;IACzB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,iEAAiE;IACjE,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAkCD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,4FACsD,eAAe,uBA6B3F,CAAC"}

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

@@ -2,21 +2,41 @@ import React from 'react';
 import { type GestureResponderEvent, type StyleProp, type ViewStyle } from 'react-native';
 import type { IconName } from '../icons/types';
 export interface FabProps {
+    /** Called when the button is pressed. */
     onPress: (e: GestureResponderEvent) => void;
+    /** Built-in or custom icon name. Ignored when `icon` is passed. @default 'plus' */
     iconName?: IconName;
+    /** Any node in place of the icon. */
     icon?: React.ReactNode;
+    /** Diameter in pt. @default 60 */
     size?: number;
+    /** Distance from the bottom edge, on top of the safe area. @default tokens.spacing.xl (20) */
     bottom?: number;
+    /** Distance from the right edge, on top of the safe area. @default tokens.spacing.xl (20) */
     right?: number;
+    /**
+     * Adds the safe-area insets to `bottom`/`right`, so the button clears the
+     * home indicator. Pass false above a NavigationBar or tab bar, which
+     * already covers that edge. @default true
+     */
+    safeArea?: boolean;
+    /** Fill color. The icon switches to black or white for contrast. @default theme.colors.primary */
     color?: string;
     style?: StyleProp<ViewStyle>;
+    /** Required: the button has no visible text. */
     accessibilityLabel: string;
+    testID?: string;
 }
 /**
  * Fab
- * Botón flotante circular. `bottom`/`right` en vez del `tabBarHeight`
- * obligatorio de la versión original — el consumidor decide su propio
- * offset (con o sin tab bar).
+ * Circular floating button for the screen's main action.
+ * `bottom`/`right` instead of the required `tabBarHeight` of the original
+ * version — the consumer decides its own offset (with or without a tab bar).
+ *
+ * Gestalt, figure/ground: it is the only thing that floats (`lg` shadow) and
+ * carries the accent, so it stands apart from the content passing beneath it
+ * (Von Restorff: one per screen). Fitts: large and in the thumb's corner,
+ * above the safe area so it doesn't compete with the home gesture.
  */
-export declare const Fab: React.MemoExoticComponent<({ onPress, iconName, icon, size, bottom, right, color, style, accessibilityLabel }: FabProps) => React.JSX.Element>;
+export declare const Fab: React.MemoExoticComponent<({ onPress, iconName, icon, size, bottom, right, safeArea, color, style, accessibilityLabel, testID, }: FabProps) => React.JSX.Element>;
 //# sourceMappingURL=Fab.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Fab.d.ts","sourceRoot":"","sources":["../../../src/atoms/Fab.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAG1F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAWD;;;;;GAKG;AACH,eAAO,MAAM,GAAG,iHAC+F,QAAQ,uBAyBtH,CAAC"}
+{"version":3,"file":"Fab.d.ts","sourceRoot":"","sources":["../../../src/atoms/Fab.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI1F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,MAAM,WAAW,QAAQ;IACvB,yCAAyC;IACzC,OAAO,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC5C,mFAAmF;IACnF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,qCAAqC;IACrC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kGAAkG;IAClG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,gDAAgD;IAChD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAgBD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG,oIAaX,QAAQ,uBAkCZ,CAAC"}

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

@@ -2,36 +2,42 @@ import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 export type GradientDirection = 'vertical' | 'horizontal' | 'diagonal' | 'diagonal-reverse';
 export interface GradientProps {
-    /** Paradas del degradado. Uno solo pinta plano; ninguno no pinta nada. */
+    /** Gradient stops. A single color paints flat; none paints nothing. */
     colors: string[];
     /**
-     * 'vertical' va de arriba a abajo, 'horizontal' de izquierda a derecha,
-     * 'diagonal' de arriba-izquierda a abajo-derecha y 'diagonal-reverse' de
-     * arriba-derecha a abajo-izquierda.
+     * 'vertical' runs top to bottom, 'horizontal' left to right, 'diagonal'
+     * top-left to bottom-right and 'diagonal-reverse' top-right to bottom-left.
      * @default 'vertical'
      */
     direction?: GradientDirection;
     /**
-     * Bandas por tramo (un tramo = un par de colores consecutivos). Más bandas
-     * = transición más suave y más vistas en el árbol.
-     * @default 24
+     * Bands per segment (a segment = a pair of consecutive colors). More bands
+     * = a smoother transition and more views in the tree.
+     * @default 48
      */
     steps?: number;
-    /** Contenido por encima del degradado. */
+    /** Content rendered on top of the gradient. */
     children?: React.ReactNode;
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }
 /**
  * Gradient
- * Degradado lineal sin dependencias: React Native no trae uno en el rango
- * soportado (Expo SDK 54–57) y `experimental_backgroundImage` no está en toda
- * esa ventana, así que se compone con bandas.
+ * Dependency-free linear gradient: React Native doesn't ship one in the
+ * supported range (Expo SDK 54–57) and `experimental_backgroundImage` isn't
+ * available across that whole window, so it is composed from bands.
  *
- * Cada tramo pinta el color inicial y encima N bandas del final con opacidad
- * de 0 a 1. El compositor mezcla alpha linealmente: el resultado es la
- * interpolación sRGB entre paradas sin parsear el color, y por eso vale
- * cualquier formato que acepte RN (hex, `rgba()`, nombre).
+ * Each segment paints the start color and, on top, layers of the end color
+ * that accumulate (see `layerOpacities`). The compositor blends alpha linearly:
+ * the result is the sRGB interpolation between stops without parsing the
+ * color, which is why any format RN accepts works (hex, `rgba()`, name). The
+ * layers run to the end of the plane so no thin lines are left between
+ * bands, and the diagonals rotate a square the size of the measured diagonal
+ * to cover any rectangle, not just squares.
+ *
+ * Gestalt, figure and ground: content on top must contrast with ALL the
+ * stops, not just the first — white text that reads well over the blue at
+ * the start can get lost over the light blue at the end.
  */
 export declare const Gradient: React.MemoExoticComponent<({ colors, direction, steps, children, style, testID }: GradientProps) => React.JSX.Element>;
 //# sourceMappingURL=Gradient.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Gradient.d.ts","sourceRoot":"","sources":["../../../src/atoms/Gradient.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAoB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEhF,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAE5F,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAaD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,oFACkE,aAAa,uBA+CnG,CAAC"}
+{"version":3,"file":"Gradient.d.ts","sourceRoot":"","sources":["../../../src/atoms/Gradient.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkC,MAAM,OAAO,CAAC;AACvD,OAAO,EAA4C,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAExG,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAE5F,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAsCD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,QAAQ,oFACkE,aAAa,uBAmEnG,CAAC"}

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

@@ -2,22 +2,36 @@ import React from 'react';
 import { type GestureResponderEvent, type StyleProp, type ViewStyle } from 'react-native';
 import type { IconName } from '../icons/types';
 export interface IconButtonProps {
+    /** Icon from the library's set. Ignored when `icon` is passed. */
     iconName?: IconName;
+    /** Custom node in place of the icon. Takes precedence over `iconName`. */
     icon?: React.ReactNode;
+    /** Called on press. Not called while `disabled`. */
     onPress?: (e: GestureResponderEvent) => void;
+    /** Icon size in pt. The touch area is padded up to 44pt with `hitSlop`. @default 24 */
     size?: number;
+    /** Icon color. Defaults to `colors.text`. */
     color?: string;
+    /** Dims the button by half and ignores presses. */
     disabled?: boolean;
     style?: StyleProp<ViewStyle>;
+    /** Required: the button has no visible text, so this is all a screen reader announces. */
     accessibilityLabel: string;
     testID?: string;
 }
 /**
  * IconButton
- * Botón de solo ícono con área táctil mínima de 44x44 garantizada por el
- * padding (icon 24 + padding 8*2 = 40; sube a 44 con size>=24 default RN).
- * `accessibilityLabel` es obligatorio: sin texto visible, es la única forma
- * de que un lector de pantalla anuncie qué hace el botón.
+ * Icon-only button. `accessibilityLabel` is required: with no visible text,
+ * it is the only way for a screen reader to announce what it does.
+ *
+ * Fitts: the visible area is icon + `spacing.sm` per side (24 + 16 = 40pt
+ * with the default size, 32pt with `size={16}`). `hitSlop` makes up the
+ * rest up to 44pt without enlarging the layout, so a row of icons keeps its
+ * rhythm and each one is still easy to tap.
+ *
+ * Gestalt, figure and ground: it has no background of its own, the icon is
+ * the figure over whatever is behind it; that is why the default color is
+ * `colors.text` (guaranteed AA contrast) and `disabled` dims it by half.
  */
 export declare const IconButton: React.MemoExoticComponent<({ iconName, icon, onPress, size, color, disabled, style, accessibilityLabel, testID }: IconButtonProps) => React.JSX.Element>;
 //# sourceMappingURL=IconButton.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"IconButton.d.ts","sourceRoot":"","sources":["../../../src/atoms/IconButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAG1F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAUD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,oHACwE,eAAe,uBAgB7G,CAAC"}
+{"version":3,"file":"IconButton.d.ts","sourceRoot":"","sources":["../../../src/atoms/IconButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAG1F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,oDAAoD;IACpD,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC7C,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,0FAA0F;IAC1F,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAaD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,oHACwE,eAAe,uBAqB7G,CAAC"}

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

@@ -1,16 +1,25 @@
 import React from 'react';
-import { Image as RNImage, type ImageErrorEventData, type ImageResizeMode, type ImageSourcePropType, type NativeSyntheticEvent, type StyleProp, type ViewStyle } from 'react-native';
+import { type ImageProps as RNImageProps, type ImageResizeMode, type ImageSourcePropType, type StyleProp, type ViewStyle } from 'react-native';
+/**
+ * The event RN's Image passes to `onError`. Taken from its own prop type:
+ * react-native 0.88 (Expo SDK 58) renamed the exported name
+ * (`ImageErrorEventData` -> `ImageErrorEvent`).
+ */
+type ImageErrorEvent = Parameters<NonNullable<RNImageProps['onError']>>[0];
 export interface ImageProps {
+    /** Image to load (same as React Native's `source`). */
     source: ImageSourcePropType;
+    /** Width of the image slot, in pt. */
     width?: number;
+    /** Height of the image slot, in pt. */
     height?: number;
-    /** @default 'cover' */
+    /** How the image fits its slot (same as React Native). @default 'cover' */
     resizeMode?: ImageResizeMode;
     /** Corner radius, same pattern as Avatar/Card. @default 0 */
     radius?: number;
     /** What to show while loading. `false` to show nothing. @default true (small spinner) */
     loading?: React.ReactNode | boolean;
-    /** What to show if loading fails. @default a gray placeholder, no content */
+    /** What to show if loading fails. @default placeholder with a warning icon */
     fallback?: React.ReactNode;
     /**
      * 'high' triggers Image.prefetch() on mount, before <Image> starts
@@ -20,26 +29,39 @@ export interface ImageProps {
      */
     priority?: 'low' | 'normal' | 'high';
     style?: StyleProp<ViewStyle>;
+    /** Called when loading finishes, successfully or not (same as RN). */
     onLoadEnd?: () => void;
-    onError?: (error: NativeSyntheticEvent<ImageErrorEventData>) => void;
+    /** Describes the image for screen readers. Without it the image is decorative. */
+    accessibilityLabel?: string;
+    /** Called when loading fails; the `fallback` is shown. */
+    onError?: (error: ImageErrorEvent) => void;
     testID?: string;
 }
 /**
  * Image
- * Wrapper cero-dependencias sobre <Image> de RN: agrega estado de carga y
- * error (con los mismos placeholders que el resto de la librería), y expone
- * `priority="high"` para adelantar la descarga vía Image.prefetch(). El
- * cache real (disco/memoria) lo maneja el motor de imágenes nativo de RN —
- * esto no lo reimplementa, solo no lo deja apagado por accidente: en iOS
- * fuerza `cache="force-cache"` (usa el disco aunque el header HTTP no lo
- * pida); en Android el cache de disco de la imagen nativa ya está siempre
- * activo, no hay knob equivalente que tocar.
+ * Zero-dependency wrapper over RN's <Image>: adds loading and error state
+ * (with the same placeholders as the rest of the library), and exposes
+ * `priority="high"` to start the download early via Image.prefetch(). The
+ * actual cache (disk/memory) is handled by RN's native image engine — this
+ * doesn't reimplement it, it just keeps it from being accidentally turned off:
+ * on iOS it forces `cache="force-cache"` (uses the disk even when the HTTP
+ * header doesn't ask for it); on Android the native image's disk cache is
+ * always on, there is no equivalent knob to touch.
+ *
+ * Gestalt, closure: the container takes its final size from the first frame
+ * (`skeleton` background), so the layout doesn't jump when the image arrives
+ * and the eye completes the shape it will fill. If loading fails, the same
+ * slot shows a warning icon: the state is visible, not a silent gray.
+ *
+ * Success is detected with `onLoad`, not `onLoadEnd`: RN also calls
+ * `onLoadEnd` on failure, and using it for "loaded" overwrote the error.
  */
-export declare const Image: React.MemoExoticComponent<({ source, width, height, resizeMode, radius, loading, fallback, priority, style, onLoadEnd, onError, testID, }: ImageProps) => React.JSX.Element>;
+export declare const Image: React.MemoExoticComponent<({ source, width, height, resizeMode, radius, loading, fallback, priority, style, onLoadEnd, onError, testID, accessibilityLabel, }: ImageProps) => React.JSX.Element>;
 /**
- * Precarga una URL antes de montar el componente (p.ej. al recibir la
- * respuesta de un listado, antes de navegar al detalle). Re-exporta
- * Image.prefetch de RN — no hay nada zero-dep que agregarle encima.
+ * Preloads a URL before mounting the component (e.g. on receiving a list
+ * response, before navigating to the detail). Re-exports RN's
+ * Image.prefetch — there is nothing zero-dep to add on top.
  */
-export declare const prefetchImage: typeof RNImage.prefetch;
+export declare const prefetchImage: (url: string) => Promise<boolean>;
+export {};
 //# sourceMappingURL=Image.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Image.d.ts","sourceRoot":"","sources":["../../../src/atoms/Image.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiD,MAAM,OAAO,CAAC;AACtE,OAAO,EACL,KAAK,IAAI,OAAO,EAIhB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yFAAyF;IACzF,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,OAAO,CAAC;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,KAAK,IAAI,CAAC;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAYD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,6IAcb,UAAU,uBAoDd,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,aAAa,yBAAmB,CAAC"}
+{"version":3,"file":"Image.d.ts","sourceRoot":"","sources":["../../../src/atoms/Image.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiD,MAAM,OAAO,CAAC;AACtE,OAAO,EAKL,KAAK,UAAU,IAAI,YAAY,EAC/B,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAMtB;;;;GAIG;AACH,KAAK,eAAe,GAAG,UAAU,CAAC,WAAW,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3E,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,MAAM,EAAE,mBAAmB,CAAC;IAC5B,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yFAAyF;IACzF,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,OAAO,CAAC;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAeD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,KAAK,iKAeb,UAAU,uBAuEd,CAAC;AAGF;;;;GAIG;AACH,eAAO,MAAM,aAAa,mCAAmB,CAAC"}

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

@@ -1,24 +1,74 @@
-import React from 'react';
-import { type StyleProp, type TextInputProps, type ViewStyle } from 'react-native';
+import React, { type ComponentRef } from 'react';
+import { TextInput, type StyleProp, type TextInputProps, type ViewStyle } from 'react-native';
 import type { IconName } from '../icons/types';
+import { type InputRules } from './inputValidation';
+export type { InputRules, InputRuleValue } from './inputValidation';
+/** The TextInput instance, plus `validate()` to check the field on demand (e.g. on submit). */
+export type InputHandle = ComponentRef<typeof TextInput> & {
+    /** Runs the rules, shows the error (if any) and returns it. */
+    validate: () => string | undefined;
+};
 export interface InputProps extends Omit<TextInputProps, 'style'> {
+    /** Text above the field; also its accessible name (falls back to `placeholder`). */
     label?: string;
-    /** Shows an asterisk next to the label. Purely visual, doesn't validate anything. */
+    /** Shows an asterisk next to the label, and an empty value fails validation (`labels.requiredError`). */
     required?: boolean;
+    /** Error shown under the field. Takes precedence over the built-in validation. */
     error?: string;
+    /** Built-in validation: length limits, a pattern and/or a custom check. */
+    rules?: InputRules;
+    /**
+     * When the rules run: on leaving the field, on every change, or only through
+     * `ref.validate()`. Once an error shows, it re-checks on every change so it
+     * clears as soon as the value is fixed. @default 'blur'
+     */
+    validateOn?: 'blur' | 'change' | 'submit';
+    /** Called with the error (or undefined) every time the rules run. */
+    onValidate?: (error: string | undefined) => void;
+    /** Style of the outer wrapper (label, field and error). */
     containerStyle?: StyleProp<ViewStyle>;
     style?: TextInputProps['style'];
+    /** Icon shown inside the field, to the left of the text. */
     leftIconName?: IconName;
+    /** Icon button inside the field, on the right. Ignored with `isPassword` or `isLoading`. */
     rightIconName?: IconName;
+    /** Called when the `rightIconName` button is pressed. Without it the button is disabled. */
     onRightIconPress?: () => void;
+    /** Accessible name of the `rightIconName` button. @default labels.clear */
+    rightIconAccessibilityLabel?: string;
+    /** Hides the text and adds an eye button to show or hide it. @default false */
     isPassword?: boolean;
+    /** Shows a small spinner on the right, in place of the right icon. @default false */
     isLoading?: boolean;
 }
 /**
  * Input
- * El borde anima color entre border/primary/error con Animated (no
- * useNativeDriver: los navegadores de color en RN sin Fabric solo son
- * confiables en el hilo de JS; el costo es despreciable, se anima un borde).
+ * The border animates its color between border/primary/error with Animated
+ * (no useNativeDriver: color drivers in RN without Fabric are only reliable
+ * on the JS thread; the cost is negligible, it animates one border).
+ *
+ * Gestalt:
+ * - Proximity: label (`spacing.sm` above) and error (`spacing.xs` below) sit
+ *   right next to the field and the next field is `spacing.lg` away: each
+ *   label and its error read with their field, not with the neighbor.
+ * - Common region: left icon, text and right action share the same border
+ *   and background, so they read as a single control.
+ * - Focal point: the border turns `primary` on focus and `error` on error;
+ *   the error is also written out (not just color).
+ *
+ * Accessibility: the accessible name includes "required" when applicable, the
+ * error is announced as a hint, and the eye and right-action buttons have a
+ * 44pt touch area and texts from `labels` (translatable).
+ *
+ * Keyboard: on focus it registers with the root UIProvider's host, which
+ * lifts the app just enough for the whole field (label, field and error) to
+ * sit above the keyboard — without depending on Screen or a ScrollView. What
+ * you type is always visible.
+ *
+ * Validation: `required` and `rules` run when leaving the field (`validateOn`),
+ * the error appears in writing, is announced to the screen reader and, once
+ * visible, is revalidated on every change so it disappears as soon as it is
+ * fixed. An `error` passed by hand overrides the internal validation.
  */
-export declare const Input: React.MemoExoticComponent<({ label, required, error, containerStyle, leftIconName, rightIconName, onRightIconPress, isPassword, isLoading, style, onFocus, onBlur, testID, ...props }: InputProps) => React.JSX.Element>;
+export declare const Input: React.NamedExoticComponent<InputProps & React.RefAttributes<InputHandle>>;
 //# sourceMappingURL=Input.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../src/atoms/Input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiC,MAAM,OAAO,CAAC;AACtD,OAAO,EAOL,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AA+BD;;;;;GAKG;AACH,eAAO,MAAM,KAAK,yLAgBb,UAAU,uBAkFd,CAAC"}
+{"version":3,"file":"Input.d.ts","sourceRoot":"","sources":["../../../src/atoms/Input.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAsE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AACrH,OAAO,EAKL,SAAS,EAGT,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAExE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEpE,+FAA+F;AAC/F,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,SAAS,CAAC,GAAG;IACzD,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACpC,CAAC;AAEF,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC;IAC/D,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yGAAyG;IACzG,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,qEAAqE;IACrE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACjD,2DAA2D;IAC3D,cAAc,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAChC,4DAA4D;IAC5D,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,2EAA2E;IAC3E,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,+EAA+E;IAC/E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,KAAK,2EAsJjB,CAAC"}

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

@@ -1,17 +1,29 @@
 import React from 'react';
 import { type StyleProp, type TextStyle, type ViewStyle } from 'react-native';
 export interface KeyValueRowProps {
+    /** Left side. A string or number gets the default label style; any other node renders as is. */
     label: React.ReactNode;
+    /** Right side. A string or number gets the default value style (tabular digits); any other node renders as is. */
     value: React.ReactNode;
     style?: StyleProp<ViewStyle>;
+    /** Only applies when `label` is a string or number. */
     labelStyle?: StyleProp<TextStyle>;
+    /** Only applies when `value` is a string or number. */
     valueStyle?: StyleProp<TextStyle>;
+    testID?: string;
 }
 /**
  * KeyValueRow
- * Fila label (izquierda) / value (derecha). Si label/value son string o
- * number, se renderizan con el estilo default; si ya vienen envueltos en un
- * componente de texto propio, se respetan tal cual.
+ * Label (left) / value (right) row. If label/value are a string or number,
+ * they render with the default style; if they already come wrapped in a
+ * custom component, they are kept as is.
+ *
+ * Gestalt, alignment and similarity: labels share color and weight and values
+ * align to the right edge with tabular digits, so a stack of rows reads as
+ * two columns — what on the left, how much on the right.
+ * With a text label and value, the row is a single accessibility node
+ * ("Subtotal, $300.00"); if either is a custom node (a Badge, a button) it
+ * isn't merged, so as not to hide what that node announces or lets you tap.
  */
-export declare const KeyValueRow: React.MemoExoticComponent<({ label, value, style, labelStyle, valueStyle }: KeyValueRowProps) => React.JSX.Element>;
+export declare const KeyValueRow: React.MemoExoticComponent<({ label, value, style, labelStyle, valueStyle, testID }: KeyValueRowProps) => React.JSX.Element>;
 //# sourceMappingURL=KeyValueRow.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"KeyValueRow.d.ts","sourceRoot":"","sources":["../../../src/atoms/KeyValueRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI1F,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CACnC;AAQD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,8EAA0D,gBAAgB,uBAqBhG,CAAC"}
+{"version":3,"file":"KeyValueRow.d.ts","sourceRoot":"","sources":["../../../src/atoms/KeyValueRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI1F,MAAM,WAAW,gBAAgB;IAC/B,gGAAgG;IAChG,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,kHAAkH;IAClH,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,uDAAuD;IACvD,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAClC,uDAAuD;IACvD,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAqCD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,sFACoC,gBAAgB,uBAuB3E,CAAC"}

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

@@ -1,16 +1,23 @@
 import React from 'react';
 import { type PressableProps, type StyleProp, type ViewStyle } from 'react-native';
-export interface PressableScaleProps extends Omit<PressableProps, 'style'> {
+export interface PressableScaleProps extends Omit<PressableProps, 'style' | 'children'> {
     /** Target scale when pressed. @default 0.96 */
     scaleTo?: number;
     style?: StyleProp<ViewStyle>;
+    /** Pressable content. */
     children: React.ReactNode;
 }
 /**
  * PressableScale
- * Feedback táctil de "achicarse" al presionar, con Animated.spring de RN
- * (useNativeDriver: true — corre en el hilo nativo, sin coste de JS por frame).
- * No depende de reanimated: la librería entera es cero-dependencias.
+ * Tactile "shrink" feedback on press, with RN's Animated.spring
+ * (useNativeDriver: true — runs on the native thread, no JS cost per frame).
+ * Doesn't depend on reanimated: the whole library is zero-dependency.
+ *
+ * Gestalt, figure/ground: as it sinks, the pressed element separates for an
+ * instant from the rest and confirms what was touched (Doherty: immediate
+ * response). Announces itself as a button by default (`accessibilityRole` can
+ * be changed) and, when disabled, exposes `disabled` to the screen reader.
+ * With Reduce Motion it doesn't scale.
  */
-export declare const PressableScale: React.MemoExoticComponent<({ scaleTo, style, children, onPressIn, onPressOut, disabled, ...props }: PressableScaleProps) => React.JSX.Element>;
+export declare const PressableScale: React.MemoExoticComponent<({ scaleTo, style, children, onPressIn, onPressOut, disabled, accessibilityRole, accessibilityState, ...props }: PressableScaleProps) => React.JSX.Element>;
 //# sourceMappingURL=PressableScale.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PressableScale.d.ts","sourceRoot":"","sources":["../../../src/atoms/PressableScale.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuB,MAAM,OAAO,CAAC;AAC5C,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC;IACxE,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAID;;;;;GAKG;AACH,eAAO,MAAM,cAAc,sGACwD,mBAAmB,uBAkCrG,CAAC"}
+{"version":3,"file":"PressableScale.d.ts","sourceRoot":"","sources":["../../../src/atoms/PressableScale.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuB,MAAM,OAAO,CAAC;AAC5C,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAGtB,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,UAAU,CAAC;IACrF,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,yBAAyB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAOD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,6IAWtB,mBAAmB,uBAqCvB,CAAC"}