orn-ui 0.2.9 → 0.3.0

package/lib/typescript/organisms/NavigationBar.d.ts

@@ -5,28 +5,47 @@ export interface NavigationBarItem {
     key: string;
     label: string;
     iconName?: IconName;
-    /** Contador sobre el ícono. `true` pinta sólo el punto. */
+    /** Counter over the icon, also read by screen readers. `true` shows only the dot. */
     badge?: number | string | true;
 }
 export interface NavigationBarProps {
+    /** The destinations: key, label, and optionally an icon and a badge. */
     items: NavigationBarItem[];
+    /** Key of the selected item (controlled). */
     activeKey: string;
+    /** Called with the key of the pressed item. */
     onChange: (key: string) => void;
     /** Screen edge where the bar lives. @default 'bottom' */
     position?: 'bottom' | 'top';
-    /** @default true */
+    /** Shows the label under each icon. @default true */
     showLabels?: boolean;
     /** Adds the safe area inset for the edge where the bar lives. @default true */
     safeArea?: boolean;
+    /**
+     * Hides a bottom bar while the keyboard is open, like native tab bars, so
+     * it doesn't sit between the field and the keyboard. Only Android needs it:
+     * on iOS the keyboard already covers the bar. @default true
+     */
+    hideOnKeyboard?: boolean;
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }
 /**
  * NavigationBar
- * Barra de navegación por pestañas con la misma apariencia y las mismas
- * transiciones en iOS y Android: el indicador se desliza hasta la pestaña
- * activa y su contenido crece y toma el color de acento con un cross-fade.
- * No navega por su cuenta — reporta la pestaña tocada y el consumidor decide.
+ * Tab navigation bar with the same look and the same transitions on iOS and
+ * Android: the indicator slides to the active tab and its content grows and
+ * takes the accent color with a cross-fade.
+ * It doesn't navigate on its own — it reports the tapped tab and the consumer decides.
+ *
+ * Design:
+ * - Jakob's law: the tab bar people know from every app, at the bottom by
+ *   default, icon over label.
+ * - Similarity + Von Restorff: every tab looks the same except the active
+ *   one, which alone gets the accent and the indicator.
+ * - Continuity: the indicator slides from tab to tab instead of jumping
+ *   (in place with Reduce Motion).
+ * - Fitts's law: the whole column is the target, not just the icon.
+ * - Hick's law: meant for 3–5 destinations.
  */
-export declare const NavigationBar: React.MemoExoticComponent<({ items, activeKey, onChange, position, showLabels, safeArea, style, testID, }: NavigationBarProps) => React.JSX.Element>;
+export declare const NavigationBar: React.MemoExoticComponent<({ items, activeKey, onChange, position, showLabels, safeArea, hideOnKeyboard, style, testID, }: NavigationBarProps) => React.JSX.Element | null>;
 //# sourceMappingURL=NavigationBar.d.ts.map

package/lib/typescript/organisms/NavigationBar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NavigationBar.d.ts","sourceRoot":"","sources":["../../../src/organisms/NavigationBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4C,MAAM,OAAO,CAAC;AACjE,OAAO,EAOL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC5B,oBAAoB;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiDD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,6GAUrB,kBAAkB,uBA6HtB,CAAC"}
+{"version":3,"file":"NavigationBar.d.ts","sourceRoot":"","sources":["../../../src/organisms/NavigationBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4C,MAAM,OAAO,CAAC;AACjE,OAAO,EASL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAKtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC5B,qDAAqD;IACrD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAwDD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa,6HAWrB,kBAAkB,8BAiJtB,CAAC"}

package/lib/typescript/organisms/OptionWheel.d.ts

@@ -8,8 +8,11 @@ export interface OptionWheelOption<T> {
 }
 export type OptionWheelVariant = 'window' | 'spotlight';
 export interface OptionWheelProps<T> {
+    /** The range, in order. Each option has a label, its value, and may be disabled. */
     options: OptionWheelOption<T>[];
+    /** Value of the option in the centre row (controlled). */
     selectedValue: T | undefined;
+    /** Called with the value of the option the wheel settles on. */
     onSelect: (value: T) => void;
     /** Title above the wheel. */
     label?: string;
@@ -48,31 +51,32 @@ export interface OptionWheelProps<T> {
     curveRadius?: number;
     /** Which side the wheel's centre is on. @default 'left' */
     curveFrom?: 'left' | 'right';
+    /** Dims the wheel and stops it from turning. @default false */
     disabled?: boolean;
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }
 /**
  * OptionWheel
- * Selector de rueda: las opciones pasan por una ventana fija y la que queda en
- * el centro es la elegida. El scroll hace snap a la altura de fila, así que
- * soltar el dedo en cualquier lado siempre deja una opción centrada y no media.
+ * Wheel picker: the options pass through a fixed window and the one left in
+ * the center is the selected one. The scroll snaps to the row height, so
+ * lifting the finger anywhere always leaves one option centered, never half.
  *
- * Gestalt, figura y fondo: lo que marca la selección no es un estilo sobre la
- * fila —que viajaría con ella— sino una ventana quieta encima de la lista. La
- * figura se queda, el fondo se mueve, y por eso la rueda se lee sin leer: el
- * lugar señala, no el color. Y destino común: todas las filas se achican y se
- * inclinan con la misma ley respecto del centro, de modo que se perciben como
- * una superficie rígida que gira y no como N filas animándose por su cuenta.
+ * Gestalt, figure and ground: what marks the selection isn't a style on the
+ * row —which would travel with it— but a still window on top of the list. The
+ * figure stays, the ground moves, and that is why the wheel reads without
+ * reading: the place signals, not the color. And common fate: all rows shrink
+ * and tilt by the same law relative to the center, so they are perceived as a
+ * rigid surface that turns and not as N rows animating on their own.
  *
- * La escala, la opacidad y la inclinación salen de interpolar el
- * `contentOffset` del scroll, no del estado de React: se calculan en el hilo
- * nativo (`useNativeDriver`) y el hilo de JS sólo participa cuando la rueda ya
- * frenó, para avisar qué quedó elegido. Con "reducir movimiento" activo se
- * apaga la inclinación y queda el tamaño, que es información, no decoración.
+ * Scale, opacity and tilt come from interpolating the scroll's
+ * `contentOffset`, not from React state: they are computed on the native
+ * thread (`useNativeDriver`) and the JS thread only takes part once the wheel
+ * has stopped, to report what was selected. With "reduce motion" on, the tilt
+ * is turned off and the size stays, since it is information, not decoration.
  *
- * `disabled` en una opción no puede impedir que el snap la centre, así que la
- * rueda la centra y se corre sola a la habilitada más cercana.
+ * `disabled` on an option can't keep the snap from centering it, so the
+ * wheel centers it and moves on its own to the nearest enabled one.
  */
 export declare function OptionWheel<T extends string | number>({ options, selectedValue, onSelect, label, accessibilityLabel, visibleCount, itemHeight, unit, perspective, variant, textColor, curveRadius, curveFrom, disabled, style, testID, }: OptionWheelProps<T>): React.JSX.Element;
 //# sourceMappingURL=OptionWheel.d.ts.map

package/lib/typescript/organisms/OptionWheel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OptionWheel.d.ts","sourceRoot":"","sources":["../../../src/organisms/OptionWheel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkD,MAAM,OAAO,CAAC;AACvE,OAAO,EAQL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAKtB,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAExD,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IAChC,aAAa,EAAE,CAAC,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA+GD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,EACrD,OAAO,EACP,aAAa,EACb,QAAQ,EACR,KAAK,EACL,kBAAkB,EAClB,YAAoC,EACpC,UAAgC,EAChC,IAAI,EACJ,WAAkB,EAClB,OAAkB,EAClB,SAAS,EACT,WAAW,EACX,SAAkB,EAClB,QAAgB,EAChB,KAAK,EACL,MAAM,GACP,EAAE,gBAAgB,CAAC,CAAC,CAAC,qBAgQrB"}
+{"version":3,"file":"OptionWheel.d.ts","sourceRoot":"","sources":["../../../src/organisms/OptionWheel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqE,MAAM,OAAO,CAAC;AAC1F,OAAO,EAQL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAKtB,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAExD,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,oFAAoF;IACpF,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IAChC,0DAA0D;IAC1D,aAAa,EAAE,CAAC,GAAG,SAAS,CAAC;IAC7B,gEAAgE;IAChE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA+GD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,EACrD,OAAO,EACP,aAAa,EACb,QAAQ,EACR,KAAK,EACL,kBAAkB,EAClB,YAAoC,EACpC,UAAgC,EAChC,IAAI,EACJ,WAAkB,EAClB,OAAkB,EAClB,SAAS,EACT,WAAW,EACX,SAAkB,EAClB,QAAgB,EAChB,KAAK,EACL,MAAM,GACP,EAAE,gBAAgB,CAAC,CAAC,CAAC,qBAgQrB"}

package/lib/typescript/organisms/ReorderableList.d.ts

@@ -1,10 +1,13 @@
 import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 export interface ReorderableListProps<T> {
+    /** Items, in their current order. */
     data: T[];
+    /** Stable key per item. */
     keyExtractor: (item: T, index: number) => string;
     /** Fixed height of each row: needed to calculate the target index without measuring layout async. */
     itemHeight: number;
+    /** Renders each row; the third argument is true while that row is being dragged. */
     renderItem: (item: T, index: number, dragging: boolean) => React.ReactElement;
     /** Called on release, with the array already reordered. Does not mutate `data`. */
     onReorder: (data: T[]) => void;
@@ -17,25 +20,31 @@ export interface ReorderableListProps<T> {
     onDragStart?: (index: number) => void;
     /** Ends the drag — on release or cancellation. Always runs if `onDragStart` ran. */
     onDragEnd?: () => void;
+    /** Turns off dragging. @default false */
     disabled?: boolean;
     style?: StyleProp<ViewStyle>;
 }
-/** Reordena moviendo el ítem de `from` a `to`, sin mutar `data`. Exportada aparte por ser testeable sin simular gestos. */
+/** Reorders by moving the item from `from` to `to`, without mutating `data`. Exported separately so it can be tested without simulating gestures. */
 export declare function move<T>(data: T[], from: number, to: number): T[];
 /**
  * ReorderableList
- * Ley de destino común (common fate): al arrastrar una fila, las filas que
- * tiene que atravesar se desplazan juntas en el mismo sentido — eso es lo
- * que comunica "van a intercambiar lugar" antes de soltar el dedo, no un
- * simple resaltado del ítem activo.
+ * Law of common fate: when dragging a row, the rows it has to cross shift
+ * together in the same direction — that is what communicates "they are
+ * going to swap places" before the finger lifts, not a simple highlight of
+ * the active item.
  *
- * Sin dependencias de gestos/animación externas (reanimated, gesture-handler):
- * PanResponder + Animated alcanzan porque el cálculo de índice destino
- * necesita el valor de arrastre en JS en cada movimiento (no algo que
- * useNativeDriver pueda resolver solo).
+ * No external gesture/animation dependencies (reanimated, gesture-handler):
+ * PanResponder + Animated are enough because computing the target index
+ * needs the drag value in JS on every move (not something useNativeDriver
+ * can resolve on its own).
  *
- * Dentro de un scroll vertical hay que cablear `onDragStart`/`onDragEnd` a
- * `scrollEnabled`, o en iOS el arrastre no llega a empezar:
+ * Inside a vertical scroll you have to wire `onDragStart`/`onDragEnd` to
+ * `scrollEnabled`, or on iOS the drag never gets to start:
+ *
+ * Screen readers can't drag: each row is one accessible element with two
+ * actions, "Move up" and "Move down" (`labels.moveUp` / `labels.moveDown`),
+ * that call `onReorder` the same way a drop does. The row's content is read
+ * as its label, so keep interactive controls out of reorderable rows.
  *
  * ```tsx
  * const [dragging, setDragging] = useState(false);

package/lib/typescript/organisms/ReorderableList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReorderableList.d.ts","sourceRoot":"","sources":["../../../src/organisms/ReorderableList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2B,MAAM,OAAO,CAAC;AAChD,OAAO,EAAgC,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAG5F,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,qGAAqG;IACrG,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,KAAK,CAAC,YAAY,CAAC;IAC9E,mFAAmF;IACnF,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAC/B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B;AAED,2HAA2H;AAC3H,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,EAAE,CAKhE;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,EACjC,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,QAAgB,EAChB,KAAK,GACN,EAAE,oBAAoB,CAAC,CAAC,CAAC,qBAiHzB"}
+{"version":3,"file":"ReorderableList.d.ts","sourceRoot":"","sources":["../../../src/organisms/ReorderableList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2B,MAAM,OAAO,CAAC;AAChD,OAAO,EAAgC,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI5F,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,qCAAqC;IACrC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,2BAA2B;IAC3B,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,qGAAqG;IACrG,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,KAAK,CAAC,YAAY,CAAC;IAC9E,mFAAmF;IACnF,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAC/B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B;AAED,qJAAqJ;AACrJ,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,EAAE,CAKhE;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,EACjC,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,QAAgB,EAChB,KAAK,GACN,EAAE,oBAAoB,CAAC,CAAC,CAAC,qBA6HzB"}

package/lib/typescript/organisms/Screen.d.ts

@@ -2,26 +2,45 @@ import React from 'react';
 import { type ViewStyle } from 'react-native';
 export type ScreenEdge = 'top' | 'bottom';
 export interface ScreenProps {
+    /** Content of the screen. */
     children: React.ReactNode;
+    /**
+     * Fixed bar on top (back button, title, actions). It stays in place while
+     * the content scrolls or moves up for the keyboard. The top safe area goes
+     * above it.
+     */
+    header?: React.ReactNode;
     style?: ViewStyle;
+    /** Wraps the content in a ScrollView. @default true */
     scrollable?: boolean;
+    /** Style of the ScrollView's content container. Only applies when `scrollable`. */
     contentContainerStyle?: ViewStyle;
     /** Which safe area insets to apply. @default ['top', 'bottom'] */
     edges?: ScreenEdge[];
     /**
-     * Compensates for the keyboard: on iOS with scroll the ScrollView itself does it, in
-     * other cases a KeyboardAvoidingView does. Set to false when
-     * the content already brings its own scroller that handles the keyboard (Wizard,
-     * List, SearchList): the two compensations add up and the focused field
-     * ends up pushed off screen.
+     * Keeps the focused Input above the keyboard by moving only the content
+     * (the `header` and a tab bar outside the Screen stay put). On iOS with
+     * scroll, the ScrollView scrolls to it instead. Set to false when the
+     * content brings its own keyboard handling.
      * @default true
      */
     keyboardAvoiding?: boolean;
 }
 /**
  * Screen
- * Contenedor raíz de pantalla: fondo del theme, safe area (via insets del
- * UIProvider), teclado y scroll opcional resueltos de forma consistente.
+ * Root screen container: theme background, safe area (via the UIProvider's
+ * insets), keyboard and optional scroll handled consistently.
+ *
+ * Keyboard: with the UIProvider handling it (default), Screen shifts only its
+ * content — clipped below the `header` — to keep the focused Input above the
+ * keyboard. The header stays fixed and a tab bar outside the Screen stays
+ * behind the keyboard, as in a native app. On iOS with scroll, the ScrollView
+ * already brings the field into view (automaticallyAdjustKeyboardInsets) and
+ * nothing is added. Without a host (`keyboardAvoidance={false}` on the
+ * provider) the usual KeyboardAvoidingView remains.
+ *
+ * Gestalt, common region: the header shares the screen's background and stays
+ * fixed; only the content moves, so navigation isn't lost.
  */
-export declare const Screen: React.MemoExoticComponent<({ children, style, scrollable, contentContainerStyle, edges, keyboardAvoiding, }: ScreenProps) => React.JSX.Element>;
+export declare const Screen: React.MemoExoticComponent<({ children, header, style, scrollable, contentContainerStyle, edges, keyboardAvoiding, }: ScreenProps) => React.JSX.Element>;
 //# sourceMappingURL=Screen.d.ts.map

package/lib/typescript/organisms/Screen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Screen.d.ts","sourceRoot":"","sources":["../../../src/organisms/Screen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAoD,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAIhG,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qBAAqB,CAAC,EAAE,SAAS,CAAC;IAClC,kEAAkE;IAClE,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAQD;;;;GAIG;AACH,eAAO,MAAM,MAAM,+GAOhB,WAAW,uBA8CZ,CAAC"}
+{"version":3,"file":"Screen.d.ts","sourceRoot":"","sources":["../../../src/organisms/Screen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAoD,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAKhG,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mFAAmF;IACnF,qBAAqB,CAAC,EAAE,SAAS,CAAC;IAClC,kEAAkE;IAClE,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AASD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,MAAM,uHAQhB,WAAW,uBA6DZ,CAAC"}

package/lib/typescript/organisms/SearchList.d.ts

@@ -4,15 +4,25 @@ import type { IconName } from '../icons/types';
 export interface SearchListProps<T> {
     /** Optional chrome above the search bar (e.g. back button + title). */
     header?: React.ReactNode;
+    /** Text of the search box (controlled). */
     searchValue: string;
+    /** Called with the new text; the clear button calls it with an empty string. */
     onSearchChange: (text: string) => void;
+    /** Placeholder of the search box. @default labels.search */
     searchPlaceholder?: string;
+    /** Shows a spinner inside the search box. @default false */
     searchIsLoading?: boolean;
+    /** Shows a button next to the search box and is called when it is pressed. */
     onScanPress?: () => void;
+    /** Accessible name of the `onScanPress` button. @default labels.scan */
     scanAccessibilityLabel?: string;
+    /** Extra nodes at the end of the search row. */
     extraActions?: React.ReactNode;
+    /** Items to render. */
     data: T[];
+    /** Stable key per item. */
     keyExtractor: (item: T, index: number) => string;
+    /** Renders each row (same as FlatList's `renderItem`). */
     renderItem: FlatListProps<T>['renderItem'];
     /** Initial load: while true and there's no data, placeholders are shown. */
     isLoading?: boolean;
@@ -20,37 +30,70 @@ export interface SearchListProps<T> {
     loadingMode?: 'replace' | 'overlay';
     /** Reload with data already on screen (pull-to-refresh). @default false */
     isRefreshing?: boolean;
+    /** Shows a spinner in the footer while the next page loads. @default false */
     isLoadingMore?: boolean;
     /** Controlled by the consumer: while false, a fullscreen spinner is shown. @default true */
     isReady?: boolean;
+    /**
+     * Text of the spinner shown while `isReady` is false and of the `overlay` loading. @default
+     * labels.loading
+     */
     loadingText?: string;
+    /** Text of the footer spinner shown with `isLoadingMore`. @default labels.loadingMore */
     loadingMoreText?: string;
+    /**
+     * Whether more pages remain. While false, `noMoreText` shows at the end of a non-empty list.
+     * @default false
+     */
     hasMore?: boolean;
+    /** Text shown at the end of the list when `hasMore` is false. */
     noMoreText?: string;
     /** Ghost rows for the initial load. @default 6 */
     skeletonCount?: number;
     /** Custom placeholder, to match the real shape of the item. */
     renderSkeletonItem?: () => React.ReactElement;
+    /** Called when scrolling gets close to the end. Takes precedence over `onEndReached`. */
     onLoadMore?: () => void;
+    /** Called when scrolling gets close to the end. Ignored when `onLoadMore` is passed. */
     onEndReached?: () => void;
+    /** How close to the end `onEndReached` fires, in visible lengths of the list. @default 0.3 */
     onEndReachedThreshold?: number;
+    /** Enables pull-to-refresh and is called when the user pulls. */
     onRefresh?: () => void;
+    /** Title of the empty state. @default labels.noResultsTitle */
     emptyTitle?: string;
+    /** Supporting line of the empty state. @default labels.noResultsDescription */
     emptyDescription?: string;
+    /** Icon of the empty state. @default 'search' */
     emptyIconName?: IconName;
+    /** Rendered above the items, inside the scroll. */
     ListHeaderComponent?: FlatListProps<T>['ListHeaderComponent'];
+    /** Rendered below the items, before the pagination loader and `noMoreText`. */
     ListFooterComponent?: FlatListProps<T>['ListFooterComponent'];
+    /** Style of the list's content container (also used by the skeleton). */
     contentContainerStyle?: StyleProp<ViewStyle>;
+    /** Style of the outer wrapper. */
     containerStyle?: ViewStyle;
     /** List component to use (FlashList, etc). @default FlatList */
     ListComponent?: React.ComponentType<any>;
+    /** Extra props passed to `ListComponent`; they override the ones set here. */
     listProps?: Record<string, unknown>;
 }
 /**
  * SearchList
- * Buscador + lista + estados de carga/paginación/vacío. El contenido de
- * cada ítem (renderItem) queda a cargo de quien la usa, ya que difiere por
- * completo entre casos de uso.
+ * Search box + list + loading/pagination/empty states. The content of each
+ * item (renderItem) is up to whoever uses it, since it differs completely
+ * between use cases.
+ *
+ * Design:
+ * - Proximity + common region: the search row (box, scan, extra actions)
+ *   sits right on top of the results it filters.
+ * - Doherty threshold: every wait has immediate feedback (placeholders, a
+ *   spinner in the box while searching, a footer loader while paging), and
+ *   "no results" only appears once it is known there is nothing.
+ * - Jakob's law: the clear (×) inside the box, pull-to-refresh, the keyboard
+ *   dismissed when the list is dragged.
+ * - Fitts's law: the scan button is as tall as the box, a 50pt target.
  */
 export declare function SearchList<T>({ header, searchValue, onSearchChange, searchPlaceholder, searchIsLoading, onScanPress, scanAccessibilityLabel, extraActions, data, keyExtractor, renderItem, isLoading, loadingMode, isRefreshing, isLoadingMore, isReady, loadingText, loadingMoreText, hasMore, noMoreText, skeletonCount, renderSkeletonItem, onLoadMore, onEndReached, onEndReachedThreshold, onRefresh, emptyTitle, emptyDescription, emptyIconName, ListHeaderComponent, ListFooterComponent, contentContainerStyle, containerStyle, ListComponent, listProps, }: SearchListProps<T>): React.JSX.Element;
 //# sourceMappingURL=SearchList.d.ts.map

package/lib/typescript/organisms/SearchList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SearchList.d.ts","sourceRoot":"","sources":["../../../src/organisms/SearchList.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"SearchList.d.ts","sourceRoot":"","sources":["../../../src/organisms/SearchList.tsx"],"names":[],"mappings":"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"}

package/lib/typescript/organisms/Select.d.ts

@@ -4,37 +4,57 @@ import type { IconName } from '../icons/types';
 export interface SelectOption<T> {
     label: string;
     value: T;
-    /** Glifo del set de la librería, a la izquierda del label. */
+    /** Glyph from the library's icon set, left of the label. */
     iconName?: IconName;
-    /** Emoji a la izquierda del label. Gana sobre `iconName`. */
+    /** Emoji left of the label. Takes precedence over `iconName`. */
     emoji?: string;
     disabled?: boolean;
 }
 export interface SelectProps<T> {
+    /** Text above the field; also its accessible name. */
     label?: string;
+    /** Shows an asterisk next to the label. @default false */
     required?: boolean;
+    /** Options of the dropdown: label, value and, optionally, icon, emoji or disabled. */
     options: SelectOption<T>[];
+    /** Value of the selected option (controlled). `undefined` shows the placeholder. */
     selectedValue: T | undefined;
+    /** Called with the value of the chosen option; the dropdown then closes. */
     onSelect: (value: T) => void;
+    /** Text while nothing is selected. @default labels.selectPlaceholder */
     placeholder?: string;
+    /** Error shown under the field. */
     error?: string;
+    /** Shows a spinner in place of the chevron and blocks opening. @default false */
     isLoading?: boolean;
+    /** Dims the field and blocks opening. @default false */
     disabled?: boolean;
     /** Adds a search box inside the dropdown. @default false */
     searchable?: boolean;
+    /** Placeholder of the search box (with `searchable`). @default labels.search */
     searchPlaceholder?: string;
     /** Maximum height of the dropdown, if the available space allows it. @default 280 */
     maxHeight?: number;
+    /** Called with `true` when the dropdown opens and `false` when it closes. */
     onOpenChange?: (open: boolean) => void;
+    /** Style of the outer wrapper (label, field and error). */
     containerStyle?: StyleProp<ViewStyle>;
     testID?: string;
 }
 /**
  * Select
- * Dropdown de una sola opción. La lista se mide contra la ventana y se dibuja
- * dentro de un Modal, no en el árbol del campo: así ningún `overflow: hidden`
- * la recorta, no depende del zIndex (poco confiable en Android) y el fondo del
- * Modal resuelve cerrar tocando afuera y con el botón atrás.
+ * Single-option dropdown. The list is measured against the window and drawn
+ * inside a Modal, not in the field's tree: that way no `overflow: hidden`
+ * clips it, it doesn't depend on zIndex (unreliable on Android) and the
+ * Modal's backdrop handles closing by tapping outside and with the back button.
+ *
+ * Design:
+ * - Proximity + continuity: the list opens right against the field, toward
+ *   wherever there is more room, so the eye goes from field to options.
+ * - Von Restorff: the picked option alone has the accent fill and a check.
+ * - Jakob's law: same field as Input and DateField (height, border, label,
+ *   red border with an error); tap outside or Android back closes it.
+ * - Hick's law: past a handful of options, `searchable` narrows the list.
  */
 export declare function Select<T extends string | number>({ label, required, options, selectedValue, onSelect, placeholder, error, isLoading, disabled, searchable, searchPlaceholder, maxHeight, onOpenChange, containerStyle, testID, }: SelectProps<T>): React.JSX.Element;
 //# sourceMappingURL=Select.d.ts.map

package/lib/typescript/organisms/Select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../src/organisms/Select.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AACjF,OAAO,EAWL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3B,aAAa,EAAE,CAAC,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,cAAc,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA6ED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,EAChD,KAAK,EACL,QAAgB,EAChB,OAAO,EACP,aAAa,EACb,QAAQ,EACR,WAAW,EACX,KAAK,EACL,SAAiB,EACjB,QAAgB,EAChB,UAAkB,EAClB,iBAAiB,EACjB,SAAe,EACf,YAAY,EACZ,cAAc,EACd,MAAM,GACP,EAAE,WAAW,CAAC,CAAC,CAAC,qBAyLhB"}
+{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../src/organisms/Select.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+E,MAAM,OAAO,CAAC;AACpG,OAAO,EAUL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAKtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sFAAsF;IACtF,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3B,oFAAoF;IACpF,aAAa,EAAE,CAAC,GAAG,SAAS,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,2DAA2D;IAC3D,cAAc,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAkFD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,EAChD,KAAK,EACL,QAAgB,EAChB,OAAO,EACP,aAAa,EACb,QAAQ,EACR,WAAW,EACX,KAAK,EACL,SAAiB,EACjB,QAAgB,EAChB,UAAkB,EAClB,iBAAiB,EACjB,SAAe,EACf,YAAY,EACZ,cAAc,EACd,MAAM,GACP,EAAE,WAAW,CAAC,CAAC,CAAC,qBAkMhB"}

package/lib/typescript/organisms/Slides.d.ts

@@ -5,65 +5,83 @@ import { type SlidesOrientation } from './useSlides';
 export type { SlidesOrientation } from './useSlides';
 export type SlidesIndicators = 'dots' | 'numbers' | 'none';
 export type SlidesIndicatorPlacement = 'overlay' | 'outside';
-/** Un color sólido, o dos o más para un degradado (ver `Gradient`). */
+/** A solid color, or two or more for a gradient (see `Gradient`). */
 export type SlideBackground = string | string[];
 export interface SlidesProps<T> {
+    /** One item per slide. */
     data: T[];
+    /** Stable key per item. */
     keyExtractor: (item: T, index: number) => string;
-    /** Contenido de la slide: imágenes, botones, lo que sea. Se dibuja sobre `background`. */
+    /** Slide content: images, buttons, anything. Drawn on top of `background`. */
     renderItem: (item: T, index: number) => React.ReactNode;
-    /** Fondo por slide: `'#101014'` pinta plano, `['#004cef', '#00cae1']` degrada. */
+    /** Per-slide background: `'#101014'` paints flat, `['#004cef', '#00cae1']` paints a gradient. */
     background?: (item: T, index: number) => SlideBackground | undefined;
-    /** Dirección del degradado cuando `background` devuelve varios colores. @default 'vertical' */
+    /** Gradient direction when `background` returns several colors. @default 'vertical' */
     gradientDirection?: GradientDirection;
-    /** @default 'horizontal' */
+    /** Direction of the swipe. @default 'horizontal' */
     orientation?: SlidesOrientation;
-    /** Círculos, círculos numerados, o ninguno. @default 'dots' */
+    /** Dots, numbered dots, or none. @default 'dots' */
     indicators?: SlidesIndicators;
     /**
-     * 'overlay' los apoya sobre la slide, en blanco; 'outside' los saca fuera
-     * del área deslizable, con los colores del tema.
+     * 'overlay' places them on the slide, in white; 'outside' moves them out of
+     * the swipeable area, in theme colors.
      * @default 'overlay'
      */
     indicatorPlacement?: SlidesIndicatorPlacement;
-    /** Después de la última vuelve a la primera (y al revés). @default false */
+    /** After the last slide, wraps to the first (and vice versa). @default false */
     loop?: boolean;
-    /** Avanza solo. Se pausa mientras el dedo arrastra. @default false */
+    /** Advances automatically. Pauses while a finger is dragging. @default false */
     autoPlay?: boolean;
-    /** ms entre avances de `autoPlay`. @default 4000 */
+    /** Milliseconds between `autoPlay` advances. @default 4000 */
     interval?: number;
     /**
-     * Botón para frenar el avance automático. Sólo aparece con `autoPlay`, y va
-     * en `true` porque contenido que se mueve solo necesita una forma de
-     * pausarlo (WCAG 2.2.2).
+     * Button that pauses auto-advance. Only shown with `autoPlay`; on by default
+     * because content that moves on its own needs a way to pause it
+     * (WCAG 2.2.2).
      * @default true
      */
     showAutoPlayToggle?: boolean;
-    /** Hueco entre slides, en px. En 0 quedan pegadas. @default 0 */
+    /** Gap between slides, in px. At 0 they touch. @default 0 */
     spacing?: number;
-    /** Índice controlado. Sin él, el componente maneja el suyo desde `defaultIndex`. */
+    /** Controlled index. Without it, the component manages its own from `defaultIndex`. */
     index?: number;
-    /** @default 0 */
+    /** Starting slide when the index is uncontrolled. @default 0 */
     defaultIndex?: number;
+    /** Called with the new index when the active slide changes. */
     onIndexChange?: (index: number) => void;
-    /** Alto del área deslizable. @default 240 */
+    /** Height of the swipeable area. @default 240 */
     height?: number;
-    /** @default true */
+    /**
+     * Lets the user swipe between slides. When false, they change only through the indicators,
+     * `autoPlay` or `index`. @default true
+     */
     swipeEnabled?: boolean;
-    /** Estilos de la caja visible de cada slide — padding, alineación, radio. */
+    /** Styles for each slide's visible box — padding, alignment, radius. */
     slideStyle?: StyleProp<ViewStyle>;
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }
 /**
  * Slides
- * Carrusel con fondo propio (color plano o degradado) y contenido libre:
- * `renderItem` decide si adentro va una imagen, texto o botones. El estado
- * vive en `useSlides`; acá sólo está el árbol.
+ * Carousel with its own background (flat color or gradient) and free-form
+ * content: `renderItem` decides whether an image, text or buttons go inside.
+ * The state lives in `useSlides`; only the tree is here.
+ *
+ * Sliding is a `ScrollView` with `pagingEnabled` instead of hand-made
+ * gestures: it is the only thing that gives native snapping on iOS and
+ * Android without `react-native-gesture-handler`, across the whole supported
+ * range of Expo SDKs.
  *
- * El deslizamiento es un `ScrollView` con `pagingEnabled` en vez de gestos a
- * mano: es lo único que da snap nativo en iOS y Android sin
- * `react-native-gesture-handler`, en todo el rango soportado (Expo SDK 54–57).
+ * Design:
+ * - Jakob's law: native paging swipe and dots under the slide, like the
+ *   system's own onboarding carousels.
+ * - Similarity + Von Restorff: every indicator looks the same except the
+ *   current one.
+ * - Continuity: the slides slide (a jump with Reduce Motion, and autoPlay
+ *   stops); infinite mode clones the edges so the swipe never rewinds.
+ * - Fitts's law: indicators have padding around the dot as touch area.
+ * - Screen readers: each indicator is "Slide n of total" (`labels.slideOf`),
+ *   and autoPlay can be paused from its own button.
  */
 export declare function Slides<T>({ data, keyExtractor, renderItem, background, gradientDirection, orientation, indicators, indicatorPlacement, loop, autoPlay, interval, showAutoPlayToggle, spacing, index, defaultIndex, onIndexChange, height, swipeEnabled, slideStyle, style, testID, }: SlidesProps<T>): React.JSX.Element;
 //# sourceMappingURL=Slides.d.ts.map

package/lib/typescript/organisms/Slides.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Slides.d.ts","sourceRoot":"","sources":["../../../src/organisms/Slides.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkC,MAAM,OAAO,CAAC;AACvD,OAAO,EAQL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,OAAO,EAAY,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAa,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAC3D,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7D,uEAAuE;AACvE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAEhD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,0FAA0F;IAC1F,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IACxD,kFAAkF;IAClF,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAC;IACrE,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,4BAA4B;IAC5B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C,4EAA4E;IAC5E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuHD;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,EACxB,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,iBAA8B,EAC9B,WAA0B,EAC1B,UAAmB,EACnB,kBAA8B,EAC9B,IAAY,EACZ,QAAgB,EAChB,QAA2B,EAC3B,kBAAyB,EACzB,OAAW,EACX,KAAK,EACL,YAAgB,EAChB,aAAa,EACb,MAAuB,EACvB,YAAmB,EACnB,UAAU,EACV,KAAK,EACL,MAAM,GACP,EAAE,WAAW,CAAC,CAAC,CAAC,qBA6LhB"}
+{"version":3,"file":"Slides.d.ts","sourceRoot":"","sources":["../../../src/organisms/Slides.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkC,MAAM,OAAO,CAAC;AACvD,OAAO,EAQL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,OAAO,EAAY,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAa,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAC3D,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7D,qEAAqE;AACrE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAEhD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,0BAA0B;IAC1B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,2BAA2B;IAC3B,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,8EAA8E;IAC9E,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IACxD,iGAAiG;IACjG,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAC;IACrE,uFAAuF;IACvF,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,oDAAoD;IACpD,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,oDAAoD;IACpD,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C,gFAAgF;IAChF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gFAAgF;IAChF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wEAAwE;IACxE,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuHD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,EACxB,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,iBAA8B,EAC9B,WAA0B,EAC1B,UAAmB,EACnB,kBAA8B,EAC9B,IAAY,EACZ,QAAgB,EAChB,QAA2B,EAC3B,kBAAyB,EACzB,OAAW,EACX,KAAK,EACL,YAAgB,EAChB,aAAa,EACb,MAAuB,EACvB,YAAmB,EACnB,UAAU,EACV,KAAK,EACL,MAAM,GACP,EAAE,WAAW,CAAC,CAAC,CAAC,qBA8LhB"}