orn-ui 0.2.10 → 0.3.0

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

@@ -2,16 +2,30 @@ import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 import type { IconName } from '../icons/types';
 export interface InfoRowProps {
+    /** Icon that identifies the kind of data at a glance (decorative for screen readers). */
     icon: IconName;
+    /** What the value is ("Email", "Address"). */
     label: string;
+    /** The data itself. Empty, `null` or `undefined` shows `placeholder`. */
     value: string | null | undefined;
+    /** Text shown, in italics, when there is no value ("No phone number"). */
     placeholder: string;
     style?: StyleProp<ViewStyle>;
+    testID?: string;
 }
 /**
  * InfoRow
- * Ícono circular a la izquierda + label/valor apilado a la derecha. Muestra
- * `placeholder` en itálica si no hay valor. Pensado para modales de detalle.
+ * Circular icon on the left + stacked label/value on the right. Shows
+ * `placeholder` in italics when there is no value. Meant for detail modals.
+ *
+ * Gestalt, proximity: label and value sit 2pt apart and the icon a token
+ * further, so each row reads as one fact; stack rows with a larger gap.
+ * Similarity: every label shares the small muted style and every value the
+ * strong one, so a list of rows scans by column. A missing value changes
+ * style (muted italics) so it can't be mistaken for data.
+ *
+ * Accessibility: the row is a single element ("Email, jane@example.com");
+ * the icon is decorative.
  */
-export declare const InfoRow: React.MemoExoticComponent<({ icon, label, value, placeholder, style }: InfoRowProps) => React.JSX.Element>;
+export declare const InfoRow: React.MemoExoticComponent<({ icon, label, value, placeholder, style, testID }: InfoRowProps) => React.JSX.Element>;
 //# sourceMappingURL=InfoRow.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"InfoRow.d.ts","sourceRoot":"","sources":["../../../src/molecules/InfoRow.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;AAG/C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B;AAWD;;;;GAIG;AACH,eAAO,MAAM,OAAO,yEAAqD,YAAY,uBAoBnF,CAAC"}
+{"version":3,"file":"InfoRow.d.ts","sourceRoot":"","sources":["../../../src/molecules/InfoRow.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;AAG/C,MAAM,WAAW,YAAY;IAC3B,yFAAyF;IACzF,IAAI,EAAE,QAAQ,CAAC;IACf,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuBD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO,iFAA6D,YAAY,uBAqB3F,CAAC"}

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

@@ -2,12 +2,21 @@ import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 import type { IconName } from '../icons/types';
 export interface OptionCardProps {
+    /** Name of the option. It is also the start of its accessible name. */
     label: string;
-    /** Secondary line: the detail that decides the choice ("arrives in 3 days"). */
+    /**
+     * Secondary line: the detail that decides the choice ("arrives in 3 days").
+     * Screen readers read it right after the label, not as a hint, because
+     * hints can be turned off and this detail is part of the choice.
+     */
     description?: string;
+    /** Icon that helps recognize the option. Avoid `check`: it reads as "selected". */
     iconName?: IconName;
+    /** Whether this is the chosen option of its group. */
     isSelected: boolean;
+    /** Called on press; the group decides which option is selected. */
     onPress: () => void;
+    /** Dims the card and ignores presses. @default false */
     disabled?: boolean;
     /** 'vertical': icon on top, text centered below. 'horizontal': in a row. @default 'horizontal' */
     layout?: 'vertical' | 'horizontal';
@@ -16,10 +25,16 @@ export interface OptionCardProps {
 }
 /**
  * OptionCard
- * Opción excluyente con ícono y label que resalta cuando `isSelected`. Es un
- * radio con cara de tarjeta, así que se anuncia como tal: envolver el grupo en
- * una View con `accessibilityRole="radiogroup"` para que el lector de pantalla
- * lea "1 de 3".
+ * Mutually exclusive option with an icon and label that highlights when
+ * `isSelected`. It is a radio with a card's face, so it announces itself as
+ * one: wrap the group in a View with `accessibilityRole="radiogroup"` so the
+ * screen reader reads "1 of 3".
+ *
+ * Gestalt, similarity: every card in a group shares shape, size and type, so
+ * they read as alternatives of one question. Von Restorff / figure-ground: the
+ * selected one is the only filled card with an accent border and no shadow —
+ * it stands out without the others losing legibility (their labels keep the
+ * `text` color). The thicker selected border doesn't move the content.
  */
 export declare const OptionCard: React.MemoExoticComponent<({ label, description, iconName, isSelected, onPress, disabled, layout, style, testID, }: OptionCardProps) => React.JSX.Element>;
 //# sourceMappingURL=OptionCard.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"OptionCard.d.ts","sourceRoot":"","sources":["../../../src/molecules/OptionCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAK1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kGAAkG;IAClG,MAAM,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACnC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiCD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,sHAWlB,eAAe,uBA8CnB,CAAC"}
+{"version":3,"file":"OptionCard.d.ts","sourceRoot":"","sources":["../../../src/molecules/OptionCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAK1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,sDAAsD;IACtD,UAAU,EAAE,OAAO,CAAC;IACpB,mEAAmE;IACnE,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kGAAkG;IAClG,MAAM,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACnC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAsDD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,sHAWlB,eAAe,uBA6CnB,CAAC"}

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

@@ -2,21 +2,37 @@ import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 export interface SegmentedControlOption<T extends string = string> {
     value: T;
+    /** Visible text. Kept to one line (ellipsized); screen readers get it whole. */
     label: string;
+    /** Disables only this segment. */
     disabled?: boolean;
 }
 export interface SegmentedControlProps<T extends string = string> {
+    /** The choices, all visible at once. Two to four read best (Hick); more belong in a Select. */
     options: SegmentedControlOption<T>[];
+    /** The selected option's value. */
     value: T;
+    /** Called with the new value; not called when pressing the segment already selected. */
     onChange: (value: T) => void;
+    /** Disables the whole control. @default false */
     disabled?: boolean;
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }
 /**
  * SegmentedControl
- * Elige una opción entre pocas, todas visibles. No conoce ningún estado
- * global: recibe `value` y avisa por `onChange`.
+ * Picks one option among a few, all visible. It knows no global state:
+ * it receives `value` and reports through `onChange`.
+ *
+ * Gestalt, common region: one track holds every segment, so they read as a
+ * single question. Similarity: equal widths and one line each, so no option
+ * looks more important. Figure-ground: the selected segment is raised (surface
+ * + shadow) above the sunken track; in dark, where shadows vanish, it takes
+ * the soft accent fill. Fitts: every segment reaches 44pt.
+ *
+ * Continuity: the selection is one indicator that slides from the old segment
+ * to the new one, so the eye follows the change instead of seeing one fill
+ * vanish and another appear. With Reduce Motion it jumps.
  */
 declare function SegmentedControlInner<T extends string>({ options, value, onChange, disabled, style, testID, }: SegmentedControlProps<T>): React.JSX.Element;
 export declare const SegmentedControl: typeof SegmentedControlInner;

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

@@ -1 +1 @@
-{"version":3,"file":"SegmentedControl.d.ts","sourceRoot":"","sources":["../../../src/molecules/SegmentedControl.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAgC,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI5F,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC/D,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC9D,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAqBD;;;;GAIG;AACH,iBAAS,qBAAqB,CAAC,CAAC,SAAS,MAAM,EAAE,EAC/C,OAAO,EACP,KAAK,EACL,QAAQ,EACR,QAAgB,EAChB,KAAK,EACL,MAAM,GACP,EAAE,qBAAqB,CAAC,CAAC,CAAC,qBA4B1B;AAID,eAAO,MAAM,gBAAgB,EAAkC,OAAO,qBAAqB,CAAC"}
+{"version":3,"file":"SegmentedControl.d.ts","sourceRoot":"","sources":["../../../src/molecules/SegmentedControl.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4C,MAAM,OAAO,CAAC;AACjE,OAAO,EAQL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAKtB,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC/D,KAAK,EAAE,CAAC,CAAC;IACT,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC9D,+FAA+F;IAC/F,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;IACrC,mCAAmC;IACnC,KAAK,EAAE,CAAC,CAAC;IACT,wFAAwF;IACxF,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAmDD;;;;;;;;;;;;;;GAcG;AACH,iBAAS,qBAAqB,CAAC,CAAC,SAAS,MAAM,EAAE,EAC/C,OAAO,EACP,KAAK,EACL,QAAQ,EACR,QAAgB,EAChB,KAAK,EACL,MAAM,GACP,EAAE,qBAAqB,CAAC,CAAC,CAAC,qBA2F1B;AAID,eAAO,MAAM,gBAAgB,EAAkC,OAAO,qBAAqB,CAAC"}

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

@@ -2,9 +2,13 @@ import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 export type StepperSize = 'sm' | 'md' | 'lg';
 export interface StepperProps {
+    /** Current value, as text (it may be mid-typing, e.g. "" or "1."). */
     value: string;
+    /** Receives the cleaned-up text while typing, and the clamped value on blur. */
     onChangeText: (text: string) => void;
+    /** "+" pressed (or swipe up with a screen reader). Do the arithmetic here. */
     onIncrement: () => void;
+    /** "-" pressed (or swipe down with a screen reader). */
     onDecrement: () => void;
     /** Scale of the control: height, buttons, icon and typography. @default 'md' */
     size?: StepperSize;
@@ -25,23 +29,35 @@ export interface StepperProps {
     /** Accepts a decimal separator, normalizing comma to dot. @default false */
     allowDecimals?: boolean;
     style?: StyleProp<ViewStyle>;
+    /** Accessible name of the numeric field. @default labels.quantity */
+    accessibilityLabel?: string;
+    /** Accessible name of the "+" button. @default labels.increment */
     incrementAccessibilityLabel?: string;
+    /** Accessible name of the "-" button. @default labels.decrement */
     decrementAccessibilityLabel?: string;
     testID?: string;
 }
-/** Deja sólo lo que puede formar parte del número permitido por el rango. */
+/** Keeps only what can be part of a number allowed by the range. */
 export declare function sanitizeNumeric(text: string, { allowDecimals, allowNegative }?: {
     allowDecimals?: boolean | undefined;
     allowNegative?: boolean | undefined;
 }): string;
 /**
  * Stepper
- * Botón "-" + input numérico editable + botón "+". `size` controla sólo la
- * escala y `block` sólo el ancho, así que los dos ejes se combinan libremente.
+ * "-" button + editable numeric input + "+" button. `size` controls only the
+ * scale and `block` only the width, so both axes combine freely.
  *
- * El componente no hace la aritmética de los botones —eso vive en
- * `onIncrement`/`onDecrement`—, pero sí limpia lo que se tipea y avisa cuándo
- * el valor llegó a un extremo del rango deshabilitando el botón que lo pasaría.
+ * The component doesn't do the buttons' arithmetic —that lives in
+ * `onIncrement`/`onDecrement`—, but it does clean up what is typed and signals
+ * when the value hit an end of the range by disabling the button that would pass it.
+ *
+ * Gestalt, common region: the three parts share one border, so they read as a
+ * single control; the field is set apart by its fill (it can be typed into).
+ * Fitts: every button reaches 44pt, `sm` through hitSlop.
+ *
+ * Accessibility: the field is an adjustable element — VoiceOver/TalkBack users
+ * swipe up/down to step the value — and every name comes from `labels`. Like
+ * Input, it stays visible above the keyboard while typing.
  */
-export declare const Stepper: React.MemoExoticComponent<({ value, onChangeText, onIncrement, onDecrement, size, block, editable, min, max, allowDecimals, style, incrementAccessibilityLabel, decrementAccessibilityLabel, testID, }: StepperProps) => React.JSX.Element>;
+export declare const Stepper: React.MemoExoticComponent<({ value, onChangeText, onIncrement, onDecrement, size, block, editable, min, max, allowDecimals, style, accessibilityLabel, incrementAccessibilityLabel, decrementAccessibilityLabel, testID, }: StepperProps) => React.JSX.Element>;
 //# sourceMappingURL=Stepper.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Stepper.d.ts","sourceRoot":"","sources":["../../../src/molecules/Stepper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyB,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAqC,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAKjG,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,gFAAgF;IAChF,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,yFAAyF;IACzF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAgCD,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAqB,EAAE,aAAqB,EAAE;;;CAAK,GAAG,MAAM,CAO3G;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,0MAgBf,YAAY,uBAuFhB,CAAC"}
+{"version":3,"file":"Stepper.d.ts","sourceRoot":"","sources":["../../../src/molecules/Stepper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoD,MAAM,OAAO,CAAC;AACzE,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAMtB,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,8EAA8E;IAC9E,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,wDAAwD;IACxD,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,gFAAgF;IAChF,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,yFAAyF;IACzF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,mEAAmE;IACnE,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAwCD,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,aAAqB,EAAE,aAAqB,EAAE;;;CAAK,GAAG,MAAM,CAO3G;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,OAAO,8NAiBf,YAAY,uBA4GhB,CAAC"}

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

@@ -1,15 +1,18 @@
 import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 export interface StepItem {
+    /** Short name of the step ("Payment"). */
     label: string;
+    /** Optional second line with a detail ("Card or cash"). */
     description?: string;
 }
 export type StepStatus = 'completed' | 'current' | 'pending';
 export interface StepsProps {
+    /** The sequence, in order. */
     steps: StepItem[];
     /** Index of the current step (0-based). Earlier steps become 'completed'. */
     current: number;
-    /** @default 'horizontal' */
+    /** Lays the steps out in a row or in a column. @default 'horizontal' */
     orientation?: 'horizontal' | 'vertical';
     /**
      * What the circle of an already-completed step shows: a check, or its number.
@@ -19,11 +22,22 @@ export interface StepsProps {
     /** If provided, each step is tappable and reports its index. */
     onStepPress?: (index: number) => void;
     style?: StyleProp<ViewStyle>;
+    /** Root testID; each step gets `<testID>-<index>`. */
+    testID?: string;
 }
 /**
  * Steps
- * Indicador de progreso multi-paso. Base visual de `Wizard`, pero utilizable
- * suelto para mostrar el avance de un flujo que se navega de otra forma.
+ * Multi-step progress indicator. The visual base of `Wizard`, but usable on
+ * its own to show progress through a flow that is navigated some other way.
+ *
+ * Gestalt, continuity: a connector line runs through the circles, so the steps
+ * read as one path; the stretch already walked is filled with the accent.
+ * Similarity: every step is the same circle + label, and the state only
+ * changes fill and color (done = filled, current = outlined accent, pending =
+ * grey). Von Restorff: the current step is the only accent-colored label.
+ *
+ * Accessibility: each step announces "Step 2 of 3: Payment, current", with
+ * every word from `labels`.
  */
-export declare const Steps: React.MemoExoticComponent<({ steps, current, orientation, completedIndicator, onStepPress, style }: StepsProps) => React.JSX.Element>;
+export declare const Steps: React.MemoExoticComponent<({ steps, current, orientation, completedIndicator, onStepPress, style, testID, }: StepsProps) => React.JSX.Element>;
 //# sourceMappingURL=Steps.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Steps.d.ts","sourceRoot":"","sources":["../../../src/molecules/Steps.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAA4C,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAKxG,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACxC,gEAAgE;IAChE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B;AAsDD;;;;GAIG;AACH,eAAO,MAAM,KAAK,sGACmF,UAAU,uBAsI9G,CAAC"}
+{"version":3,"file":"Steps.d.ts","sourceRoot":"","sources":["../../../src/molecules/Steps.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+D,MAAM,OAAO,CAAC;AACpF,OAAO,EAML,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAMtB,MAAM,WAAW,QAAQ;IACvB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACxC,gEAAgE;IAChE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA0ED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,KAAK,+GASb,UAAU,uBAqKd,CAAC"}

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

@@ -1,8 +1,11 @@
 import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 export interface SymmetricGridProps<T> {
+    /** Items to lay out, in reading order. */
     data: T[];
+    /** Renders one cell; it gets the full cell width. */
     renderItem: (item: T, index: number) => React.ReactElement;
+    /** Stable key per item. */
     keyExtractor: (item: T, index: number) => string;
     /** Columns per row. @default 2 */
     columns?: number;
@@ -14,13 +17,20 @@ export interface SymmetricGridProps<T> {
      */
     balanceLastRow?: boolean;
     style?: StyleProp<ViewStyle>;
+    testID?: string;
 }
 /**
  * SymmetricGrid
- * Ley de Prägnanz (buena forma): agrupa en filas parejas de N columnas.
- * La última fila, cuando queda incompleta, se centra por defecto en vez de
- * quedar pegada a un borde — eso es lo que la lee como "fila corta" y no
- * como un layout roto con un hueco a un lado.
+ * Law of Prägnanz (good form): groups items into even rows of N columns.
+ * The last row, when incomplete, is centered by default instead of sticking
+ * to one edge — that is what makes it read as a "short row" and not as a
+ * broken layout with a gap on one side.
+ *
+ * Gestalt, similarity: every cell has exactly the same width, also in the
+ * centered short row, so items read as peers. The horizontal gap is padding
+ * inside each cell (and a negative margin on the row), not flex `gap`: a
+ * `100 / columns %` width plus a gap made every row wider than the grid and
+ * pushed the right column out of the container.
  */
-export declare function SymmetricGrid<T>({ data, renderItem, keyExtractor, columns, gap, balanceLastRow, style, }: SymmetricGridProps<T>): React.JSX.Element;
+export declare function SymmetricGrid<T>({ data, renderItem, keyExtractor, columns, gap, balanceLastRow, style, testID, }: SymmetricGridProps<T>): React.JSX.Element;
 //# sourceMappingURL=SymmetricGrid.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SymmetricGrid.d.ts","sourceRoot":"","sources":["../../../src/molecules/SymmetricGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,EAAQ,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGpE,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,YAAY,CAAC;IAC3D,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B;AAgBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,EAC/B,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,OAAW,EACX,GAAG,EACH,cAAqB,EACrB,KAAK,GACN,EAAE,kBAAkB,CAAC,CAAC,CAAC,qBAgCvB"}
+{"version":3,"file":"SymmetricGrid.d.ts","sourceRoot":"","sources":["../../../src/molecules/SymmetricGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,EAAQ,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAIpE,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,0CAA0C;IAC1C,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,qDAAqD;IACrD,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,YAAY,CAAC;IAC3D,2BAA2B;IAC3B,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAeD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,EAC/B,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,OAAW,EACX,GAAG,EACH,cAAqB,EACrB,KAAK,EACL,MAAM,GACP,EAAE,kBAAkB,CAAC,CAAC,CAAC,qBAqCvB"}

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

@@ -2,28 +2,54 @@ import React from 'react';
 import { type ButtonVariant } from '../atoms/Button';
 export type AlertType = 'success' | 'error' | 'warning' | 'info' | 'question';
 export interface AlertButton {
+    /** Button label. */
     text: string;
+    /** Called on press; without it the button calls `onClose`. */
     onPress?: () => void;
+    /** 'cancel' renders outline, 'destructive' renders in the error color. */
     style?: 'cancel' | 'default' | 'destructive';
+    /** Explicit Button variant; wins over `style`. */
     variant?: ButtonVariant;
 }
 export interface AlertProps {
+    /** Shows or hides the dialog. */
     visible: boolean;
+    /** Short heading; screen readers announce it as a header. */
     title: string;
+    /** Optional explanation under the title. */
     message?: string;
+    /** Icon and color of the dialog. @default 'info' */
     type?: AlertType;
+    /** Tap on the backdrop, Android back, VoiceOver escape. Without it the backdrop does nothing. */
     onClose?: () => void;
+    /** Custom buttons; three or more stack vertically. */
     buttons?: AlertButton[];
+    /** Shorthand: label of the confirm button. @default labels.confirm */
     confirmText?: string;
+    /** Shorthand: label of the cancel button (shown with `onCancel` or `cancelText`). @default labels.cancel */
     cancelText?: string;
+    /** Shorthand: confirm action. */
     onConfirm?: () => void;
+    /** Shorthand: cancel action (falls back to `onClose`). */
     onCancel?: () => void;
+    /** The confirm button uses the destructive color (delete, discard). @default false */
+    destructive?: boolean;
+    /** Draws the dialog inside its parent instead of over the screen (docs, previews). @default false */
     inline?: boolean;
 }
 /**
  * Alert
- * Componente declarativo de diálogo. Para uso imperativo (mostrar desde
- * un handler sin levantar estado propio), usar AlertProvider + useAlert().
+ * Declarative dialog component. For imperative use (showing it from a
+ * handler without lifting your own state), use AlertProvider + useAlert().
+ *
+ * Gestalt, figure-ground: the overlay dims everything behind, so the dialog
+ * is the only figure. Proximity: icon, title and message sit together and the
+ * buttons a larger step below, as the answer block. Von Restorff: only the
+ * main action is filled (or red when `destructive`); cancel is outline.
+ * Hick: two buttons side by side; three or more stack so each reads alone.
+ *
+ * Accessibility: the title is a header, the dialog is modal for VoiceOver and
+ * the escape gesture (two-finger Z) calls `onClose`.
  */
 export declare const Alert: React.MemoExoticComponent<(props: AlertProps) => React.JSX.Element | null>;
 //# sourceMappingURL=Alert.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Alert.d.ts","sourceRoot":"","sources":["../../../src/organisms/Alert.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AAIpC,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAI7D,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC;IAC7C,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAiDD;;;;GAIG;AACH,eAAO,MAAM,KAAK,oCAAgB,UAAU,8BA8E1C,CAAC"}
+{"version":3,"file":"Alert.d.ts","sourceRoot":"","sources":["../../../src/organisms/Alert.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AAKpC,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAI7D,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC;IAC7C,kDAAkD;IAClD,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,sDAAsD;IACtD,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4GAA4G;IAC5G,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,sFAAsF;IACtF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qGAAqG;IACrG,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAgFD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,KAAK,oCAAgB,UAAU,8BA2F1C,CAAC"}

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

@@ -8,30 +8,30 @@ export interface AlertOptions {
     cancelText?: string;
 }
 export interface ConfirmOptions extends AlertOptions {
-    /** Botón de confirmar en rojo/destructivo (para "eliminar", etc). */
+    /** Shows the confirm button as destructive/red (for "delete", etc.). */
     destructive?: boolean;
 }
 interface AlertContextValue {
-    /** Muestra un alert de un solo botón. Resuelve cuando se cierra. */
+    /** Shows a single-button alert. Resolves when it closes. */
     alert: (options: AlertOptions) => Promise<void>;
-    /** Muestra confirmar/cancelar. Resuelve true si se confirmó, false si se canceló. */
+    /** Shows confirm/cancel. Resolves true if confirmed, false if cancelled. */
     confirm: (options: ConfirmOptions) => Promise<boolean>;
     hide: () => void;
 }
 /**
- * Abre un alert desde fuera del árbol de React —un servicio, un interceptor—
- * sin pasar por el hook. Sin <AlertProvider> montado resuelve de inmediato, así
- * que un `await` nunca queda colgado.
+ * Opens an alert from outside the React tree —a service, an interceptor—
+ * without going through the hook. Without a mounted <AlertProvider> it
+ * resolves immediately, so an `await` never hangs.
  */
 export declare function showAlert(options: AlertOptions): Promise<void>;
-/** Igual que showAlert, pero resuelve true/false. Sin provider, false. */
+/** Same as showAlert, but resolves true/false. Without a provider, false. */
 export declare function showConfirm(options: ConfirmOptions): Promise<boolean>;
 export declare function hideAlert(): void;
 /**
  * AlertProvider
- * Monta un único <Alert> controlado imperativamente. Colocar una vez cerca
- * de la raíz (dentro de UIProvider). Los handlers async pueden hacer
- * `const ok = await confirm({ title: 'Eliminar', destructive: true })`.
+ * Mounts a single imperatively controlled <Alert>. Place it once near the
+ * root (inside UIProvider). Async handlers can do
+ * `const ok = await confirm({ title: 'Delete', destructive: true })`.
  */
 export declare function AlertProvider({ children }: {
     children: React.ReactNode;

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

@@ -1 +1 @@
-{"version":3,"file":"AlertProvider.d.ts","sourceRoot":"","sources":["../../../src/organisms/AlertProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuF,MAAM,OAAO,CAAC;AAC5G,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAGlE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,UAAU,iBAAiB;IACzB,oEAAoE;IACpE,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,qFAAqF;IACrF,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAKD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAErE;AAED,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAYD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,qBAuFxE;AAED,wBAAgB,QAAQ,IAAI,iBAAiB,CAM5C"}
+{"version":3,"file":"AlertProvider.d.ts","sourceRoot":"","sources":["../../../src/organisms/AlertProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuF,MAAM,OAAO,CAAC;AAC5G,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAGlE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,wEAAwE;IACxE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,UAAU,iBAAiB;IACzB,4DAA4D;IAC5D,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,4EAA4E;IAC5E,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAKD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAErE;AAED,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAYD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,qBAuFxE;AAED,wBAAgB,QAAQ,IAAI,iBAAiB,CAM5C"}

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

@@ -2,8 +2,11 @@ import React from 'react';
 import { type ViewStyle } from 'react-native';
 export type FooterPlacement = 'fixed' | 'scroll' | 'hide-with-keyboard';
 export interface BottomSheetProps {
+    /** Shows or hides the sheet (it slides in and out). */
     visible: boolean;
+    /** Called by the backdrop, the close button, the drag and Android back. */
     onClose: () => void;
+    /** Sheet content. */
     children: React.ReactNode;
     /** With a title, the header appears, with its close button. */
     title?: string;
@@ -21,17 +24,29 @@ export interface BottomSheetProps {
     draggable?: boolean;
     /** Fraction of the screen (0-1) or pixels. @default 0.9 */
     maxHeight?: number;
+    /** Accessible name of the close button and backdrop. @default labels.close */
     closeAccessibilityLabel?: string;
+    /** Style of the sheet itself (background, radius). */
     containerStyle?: ViewStyle;
+    /** Style of the content area (padding). */
     contentStyle?: ViewStyle;
+    /** Draws the sheet inside its parent instead of over the screen (docs, previews). @default false */
+    inline?: boolean;
     testID?: string;
 }
 /**
  * BottomSheet
- * Hoja que entra desde abajo, con arrastre para cerrar (PanResponder, no un
- * gesture-handler externo: la librería es cero dependencias). Header, footer y
- * scroll son opcionales, así que cubre tanto la hoja desnuda como el formulario
- * completo.
+ * Sheet that slides in from the bottom, with drag to close (PanResponder, not
+ * an external gesture-handler: the library is zero-dependency). Header, footer
+ * and scroll are optional, so it covers both the bare sheet and the full
+ * form.
+ *
+ * Gestalt, figure-ground: the backdrop dims the screen, so the sheet is the
+ * only figure. Common region: header, content and footer share one panel;
+ * the footer's top border separates the actions from the content. Continuity:
+ * it slides from the edge it lives on and the drag follows the finger back
+ * down; a short flick closes it too. Fitts: content sits in the thumb zone.
+ * Reduce Motion: it appears and leaves without sliding.
  */
-export declare const BottomSheet: React.MemoExoticComponent<({ visible, onClose, children, title, footer, footerPlacement, scrollable, draggable, maxHeight, closeAccessibilityLabel, containerStyle, contentStyle, testID, }: BottomSheetProps) => React.JSX.Element | null>;
+export declare const BottomSheet: React.MemoExoticComponent<({ visible, onClose, children, title, footer, footerPlacement, scrollable, draggable, maxHeight, closeAccessibilityLabel, containerStyle, contentStyle, inline, testID, }: BottomSheetProps) => React.JSX.Element | null>;
 //# sourceMappingURL=BottomSheet.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"BottomSheet.d.ts","sourceRoot":"","sources":["../../../src/organisms/BottomSheet.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4C,MAAM,OAAO,CAAC;AACjE,OAAO,EAWL,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAUtB,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,oBAAoB,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAmCD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,+LAenB,gBAAgB,8BAyJpB,CAAC"}
+{"version":3,"file":"BottomSheet.d.ts","sourceRoot":"","sources":["../../../src/organisms/BottomSheet.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4C,MAAM,OAAO,CAAC;AACjE,OAAO,EAUL,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAmBtB,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,oBAAoB,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,qBAAqB;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,sDAAsD;IACtD,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,2CAA2C;IAC3C,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,oGAAoG;IACpG,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4CD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,uMAgBnB,gBAAgB,8BAgMpB,CAAC"}