orn-ui 0.2.10 → 0.3.0

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

@@ -4,11 +4,11 @@ import { type ChartRow } from './chart/math';
 export type { ChartRow } from './chart/math';
 export type ChartType = 'bar' | 'line' | 'area' | 'pie' | 'donut' | 'radar';
 export interface ChartSeries {
-    /** Columna de `data` que lee esta serie. */
+    /** Column of `data` this series reads. */
     key: string;
-    /** Lo que dicen la leyenda y el tooltip. Por defecto, `key`. */
+    /** Text shown in the legend and tooltip. Defaults to `key`. */
     label?: string;
-    /** Pisa el color derivado del theme. */
+    /** Overrides the color derived from the theme. */
     color?: string;
 }
 export interface ChartFilterOption {
@@ -16,9 +16,9 @@ export interface ChartFilterOption {
     label: string;
 }
 /**
- * Un filtro de la barra superior. Chart no filtra nada por su cuenta: muestra
- * el control y avisa. Quien tiene los datos decide qué significa "últimos 7
- * días", y eso no se puede adivinar desde acá.
+ * A filter in the top bar. Chart doesn't filter anything on its own: it shows
+ * the control and reports. Whoever has the data decides what "last 7 days"
+ * means, and that can't be guessed from here.
  */
 export interface ChartFilter {
     key: string;
@@ -28,125 +28,135 @@ export interface ChartFilter {
 }
 export interface ChartSelection {
     /**
-     * Identidad de la fila, estable a través de un `window` o un diezmado.
-     * Sale de `selectBy`; sin él es el índice, y entonces no sobrevive a que
-     * los datos corran.
+     * Row identity, stable across a `window` or decimation. Comes from
+     * `selectBy`; without it, it is the index, which does not survive the data
+     * shifting.
      */
     id: string;
     /**
-     * Índice adentro de las filas **dibujadas**, no de `data`: con `window` o
-     * con diezmado no son la misma lista. Para volver al dato está `row`.
+     * Index within the **drawn** rows, not `data`: with `window` or decimation
+     * they are not the same list. Use `row` to get back to the datum.
      */
     index: number;
-    /** La fila entera, sin tener que resolver el índice contra nada. */
+    /** The whole row, without resolving the index against anything. */
     row: ChartRow;
-    /** Valor de `xKey` en esa fila. */
+    /** Value of `xKey` in that row. */
     label: string;
-    /** Serie tocada. En torta es la fila, que ahí es la categoría. */
+    /** Series that was touched. In a pie it is the row, which is the category there. */
     seriesKey: string;
     value: number;
 }
 interface ChartBaseProps {
+    /** Rows: one per category, with the label in `xKey` and one column per series. */
     data: ChartRow[];
     /**
-     * Series a dibujar. En 'pie'/'donut' sólo se usa la primera: las categorías
-     * de una torta son las filas, no las columnas.
+     * Series to draw. 'pie'/'donut' only use the first one: a pie's categories
+     * are the rows, not the columns.
      */
     series: ChartSeries[];
-    /** Columna con la etiqueta de cada fila. @default 'x' */
+    /** Column holding each row's label. @default 'x' */
     xKey?: string;
     /**
-     * Identidad estable de una fila. Sin esto la selección se guarda por índice,
-     * y en una ventana deslizante el índice corre: el punto resaltado pasa a
-     * señalar otro dato sin que nadie lo toque. Con esto el resaltado sigue al
-     * dato, y desaparece solo cuando el dato sale de la ventana.
+     * Stable identity of a row. Without it the selection is stored by index,
+     * and in a sliding window the index shifts: the highlighted point ends up
+     * pointing at another datum without anyone touching it. With it the
+     * highlight follows the datum and disappears only when it leaves the window.
      */
     selectBy?: (row: ChartRow, index: number) => string;
     /**
-     * Dibuja sólo las últimas N filas. Es la ventana deslizante de un chart en
-     * vivo: quien empuja los datos no tiene que recortarlos en cada tick.
+     * Draws only the last N rows. It is the sliding window of a live chart: the
+     * code pushing data doesn't have to trim it on every tick.
      */
     window?: number;
-    /** Alto del área de dibujo, sin contar filtros ni leyenda. @default 220 */
+    /** Height of the plot area, excluding filters and legend. @default 220 */
     height?: number;
     /**
-     * 'toggle' convierte la leyenda en el filtro más barato que tiene un chart:
-     * tocar una serie la apaga. @default 'auto' (toggle con 2+ series, none con una)
+     * 'toggle' turns the legend into the cheapest filter a chart has: tapping a
+     * series hides it. @default 'auto' (toggle with 2+ series, none with one)
      */
     legend?: 'auto' | 'none' | 'static' | 'toggle';
-    /** Series apagadas, controlado. Sin esto, Chart se las acuerda solo. */
+    /** Hidden series (controlled). Without it, Chart tracks them itself. */
     hiddenKeys?: string[];
-    /** @default [] */
+    /** Series hidden at first (uncontrolled). @default [] */
     defaultHiddenKeys?: string[];
+    /** Called when the legend shows or hides a series. */
     onHiddenKeysChange?: (keys: string[]) => void;
-    /** Controles arriba del chart, uno por filtro. */
+    /** Controls above the chart, one per filter. */
     filters?: ChartFilter[];
-    /** Punto resaltado, controlado. `null` es "ninguno". */
+    /** Highlighted point (controlled). `null` means none. */
     selected?: ChartSelection | null;
+    /** Called when a category is tapped, with `null` when it is released. */
     onSelect?: (selection: ChartSelection | null) => void;
-    /** Globo con los valores de la categoría tocada. @default true */
+    /** Bubble with the values of the touched category. @default true */
     tooltip?: boolean;
-    /** @default formato compacto: 1.2k, 3.4M */
+    /** Formats values on the axis, tooltip and slices. @default compact format: 1.2k, 3.4M */
     formatValue?: (value: number) => string;
-    /** @default true */
+    /** Marks grow in on mount and morph on data changes (off with Reduce Motion). @default true */
     animate?: boolean;
-    /** ms de la animación de las marcas. @default tokens.duration.slow * 2 */
+    /** Duration in ms of the marks' animation. @default tokens.duration.slow * 2 */
     duration?: number;
-    /** Texto cuando no queda nada que dibujar. */
+    /** Text shown when there is nothing left to draw. */
     emptyText?: string;
-    /** Obligatorio: un chart no tiene texto que lo describa. */
+    /** Required: a chart has no text that describes it. */
     accessibilityLabel: string;
+    /**
+     * Color behind the chart. The donut hole and the ring around points are
+     * painted with it, so they must match whatever the chart sits on.
+     * @default colors.surfaceRaised (a Chart usually lives in a Card)
+     */
+    surfaceColor?: string;
     style?: StyleProp<ViewStyle>;
     testID?: string;
 }
 interface CartesianProps {
     /**
-     * Fija el eje de valores. Por defecto se recalcula con cada dato, que es lo
-     * correcto para un chart estático y lo peor para uno en vivo: llega un valor
-     * más alto, la escala entera se reacomoda y la línea salta aunque el dato no
-     * se haya movido.
+     * Fixes the value axis. By default it is recomputed with every datum, which
+     * is right for a static chart and worst for a live one: a higher value
+     * arrives, the whole scale shifts and the line jumps even though the data
+     * didn't move.
      *
-     * - `[min, max]` — exacto, sin redondear a números lindos.
-     * - `'sticky'` — arranca del dato y crece cuando algo no entra, pero no se
-     *   vuelve a achicar.
+     * - `[min, max]` — exact, not rounded to nice numbers.
+     * - `'sticky'` — starts from the data and grows when something doesn't fit,
+     *   but never shrinks back.
      */
     domain?: [number, number] | 'sticky';
-    /** Líneas de referencia del eje de valores. @default true */
+    /** Reference lines on the value axis. @default true */
     grid?: boolean;
-    /** Ticks buscados en el eje de valores; el redondeo puede dar uno más o uno menos. @default 4 */
+    /** Target tick count on the value axis; rounding may yield one more or one fewer. @default 4 */
     ticks?: number;
-    /** Etiquetas del eje horizontal. @default true */
+    /** Labels on the horizontal axis. @default true */
     xAxis?: boolean;
-    /** Etiquetas del eje vertical. @default true */
+    /** Labels on the vertical axis. @default true */
     yAxis?: boolean;
 }
 interface BarChartProps extends CartesianProps {
+    /** Kind of chart. Props marked "Only with type" depend on it. */
     type: 'bar';
-    /** 'horizontal' pone las categorías en el eje vertical. @default 'vertical' */
+    /** 'horizontal' puts the categories on the vertical axis. @default 'vertical' */
     orientation?: 'vertical' | 'horizontal';
-    /** Apila las series en vez de ponerlas lado a lado. @default false */
+    /** Stacks the series instead of placing them side by side. @default false */
     stacked?: boolean;
-    /** Radio del extremo libre de cada barra. @default radius.xs */
+    /** Radius of each bar's free end. @default radius.xs */
     barRadius?: number;
 }
 interface LineChartProps extends CartesianProps {
     type: 'line';
     /**
-     * Cuántos puntos dibujar como mucho, eligiéndolos con LTTB. Por defecto sale
-     * del ancho medido: más de un punto cada dos píxeles no se ve y sí se paga.
-     * `false` los dibuja todos.
+     * Maximum number of points to draw, picked with LTTB. Defaults to a value
+     * derived from the measured width: more than one point every two pixels
+     * isn't visible but still costs. `false` draws them all.
      */
     decimate?: number | false;
-    /** Catmull-Rom en vez de tramos rectos. @default false */
+    /** Catmull-Rom curves instead of straight segments. @default false */
     smooth?: boolean;
-    /** @default 2 */
+    /** Line width in pt. @default 2 */
     thickness?: number;
-    /** Punto en cada dato. @default true */
+    /** A dot on each datum. @default true */
     dots?: boolean;
 }
 interface AreaChartProps extends CartesianProps {
     type: 'area';
-    /** Igual que en 'line'. */
+    /** Same as in 'line'. */
     decimate?: number | false;
     smooth?: boolean;
     thickness?: number;
@@ -154,13 +164,13 @@ interface AreaChartProps extends CartesianProps {
     dots?: boolean;
     /** @default false */
     stacked?: boolean;
-    /** Opacidad del relleno bajo la línea. @default 0.22 */
+    /** Opacity of the fill under the line. @default 0.22 */
     fillOpacity?: number;
 }
 interface PieBaseProps {
-    /** Agujero como fracción del radio, 0–0.9. @default 0 en 'pie', 0.6 en 'donut' */
+    /** Hole as a fraction of the radius, 0–0.9. @default 0 for 'pie', 0.6 for 'donut' */
     innerRadius?: number;
-    /** Qué escribir sobre cada porción. @default 'percent' */
+    /** What to write on each slice. @default 'percent' */
     sliceLabels?: 'none' | 'percent' | 'value';
 }
 interface PieChartProps extends PieBaseProps {
@@ -172,13 +182,13 @@ interface DonutChartProps extends PieBaseProps {
 interface RadarChartProps {
     type: 'radar';
     /**
-     * Fija el alcance de los ejes. El radar mide desde el centro, así que el
-     * mínimo es siempre 0 y de `[min, max]` sólo se usa `max`.
+     * Fixes the axes' range. A radar measures from the center, so the minimum is
+     * always 0 and only `max` of `[min, max]` is used.
      */
     domain?: [number, number] | 'sticky';
-    /** Anillos de la telaraña. @default 4 */
+    /** Rings of the web. @default 4 */
     levels?: number;
-    /** Rellena el polígono además de dibujar su contorno. @default true */
+    /** Fills the polygon in addition to drawing its outline. @default true */
     fill?: boolean;
     thickness?: number;
     /** @default true */
@@ -187,19 +197,20 @@ interface RadarChartProps {
 export type ChartProps = ChartBaseProps & (BarChartProps | LineChartProps | AreaChartProps | PieChartProps | DonutChartProps | RadarChartProps);
 /**
  * Chart
- * Barras (verticales, horizontales, agrupadas, apiladas), línea, área, torta,
- * dona y radar en un solo componente, porque lo que cambia entre ellos es la
- * marca que se dibuja y no el resto: datos, escala, ejes, leyenda, tooltip,
- * selección y filtros son los mismos seis mecanismos en todos.
+ * Bars (vertical, horizontal, grouped, stacked), line, area, pie, donut and
+ * radar in a single component, because what changes between them is the mark
+ * being drawn and not the rest: data, scale, axes, legend, tooltip, selection
+ * and filters are the same six mechanisms in all of them.
  *
- * Se dibuja con `View`: React Native no trae lienzo vectorial y la librería no
- * puede agregar uno. Las tres primitivas están en `chart/marks.tsx` y la
- * geometría entera, sin React, en `chart/math.ts`.
+ * It is drawn with `View`: React Native ships no vector canvas and the library
+ * can't add one. The three primitives are in `chart/marks.tsx` and the whole
+ * geometry, without React, in `chart/math.ts`.
  *
- * Gestalt: destino común — al tocar una categoría, todo lo que no es ella baja
- * a {@link DIM_OPACITY} a la vez, así que lo resaltado se lee como un grupo y
- * no como una marca suelta. La leyenda usa similitud: el mismo color que la
- * serie, y por eso puede apagarla sin que haga falta explicar qué apaga.
+ * Gestalt: common fate — when you tap a category, everything that isn't it
+ * drops to {@link DIM_OPACITY} at once, so what is highlighted reads as a group
+ * and not as a loose mark. The legend uses similarity: the same color as the
+ * series, which is why it can turn it off without having to explain what it
+ * turns off.
  */
 export declare function Chart(props: ChartProps): React.JSX.Element;
 export declare namespace Chart {

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

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

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

@@ -2,7 +2,9 @@ import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 import { type DatePickerProps, type DateRange } from './DatePicker';
 export interface DateFieldProps extends Pick<DatePickerProps, 'minDate' | 'maxDate' | 'monthNames' | 'weekdayNames' | 'firstDayOfWeek'> {
+    /** Text above the field; also its accessible name. */
     label?: string;
+    /** Shows an asterisk and says "required" to screen readers. @default false */
     required?: boolean;
     /**
      * 'single' picks one date; 'range' picks an interval with two taps.
@@ -17,8 +19,11 @@ export interface DateFieldProps extends Pick<DatePickerProps, 'minDate' | 'maxDa
     range?: DateRange;
     /** Called in mode="range", both when setting the start and when closing the range. */
     onRangeChange?: (range: DateRange) => void;
+    /** Text while empty. @default labels.selectDate */
     placeholder?: string;
+    /** Error under the field (red border); announced to screen readers. */
     error?: string;
+    /** Dims the field and ignores taps. @default false */
     disabled?: boolean;
     /** Formats the date in the field. @default "Month D, YYYY" */
     format?: (date: Date) => string;
@@ -31,14 +36,23 @@ export interface DateFieldProps extends Pick<DatePickerProps, 'minDate' | 'maxDa
     onClear?: () => void;
     /** Text for that button. @default the `clear` from `useLabels()` */
     clearLabel?: string;
+    /** Style of the outer wrapper (label, field and error). */
     containerStyle?: StyleProp<ViewStyle>;
     testID?: string;
 }
 /**
  * DateField
- * Campo de fecha: se ve como un Input, abre un `DatePicker` en un Modal al
- * tocarlo. Sin picker nativo del sistema, así que se ve y se comporta igual
- * en iOS y Android.
+ * Date field: looks like an Input, opens a `DatePicker` in a Modal when
+ * tapped. No native system picker, so it looks and behaves the same on iOS
+ * and Android.
+ *
+ * Gestalt, similarity (and Jakob's law): same box, border, height and label
+ * as Input, and the same chevron as Select, so in a form it reads as one more
+ * field; only the chevron says it opens something. Proximity: label, field
+ * and error stack tight, as one unit.
+ *
+ * Accessibility: the name includes the label, "required" and the chosen date;
+ * the error is a hint; `expanded` tells whether the calendar is open.
  */
 export declare const DateField: React.MemoExoticComponent<({ label, required, mode, value, onChange, range, onRangeChange, placeholder, error, disabled, format, modalTitle, onClear, clearLabel, containerStyle, monthNames, testID, ...pickerProps }: DateFieldProps) => React.JSX.Element>;
 //# sourceMappingURL=DateField.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"DateField.d.ts","sourceRoot":"","sources":["../../../src/organisms/DateField.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAgC,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI5F,OAAO,EAAc,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGhF,MAAM,WAAW,cACf,SAAQ,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,GAAG,gBAAgB,CAAC;IACvG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC1B,sCAAsC;IACtC,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAChC,sCAAsC;IACtC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,sFAAsF;IACtF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;IAChC,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA2BD;;;;;GAKG;AACH,eAAO,MAAM,SAAS,0NAoBjB,cAAc,uBAkGlB,CAAC"}
+{"version":3,"file":"DateField.d.ts","sourceRoot":"","sources":["../../../src/organisms/DateField.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAgC,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI5F,OAAO,EAAc,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAIhF,MAAM,WAAW,cACf,SAAQ,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,GAAG,gBAAgB,CAAC;IACvG,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC1B,sCAAsC;IACtC,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAChC,sCAAsC;IACtC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,sFAAsF;IACtF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC3C,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;IAChC,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAmCD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,0NAoBjB,cAAc,uBAoGlB,CAAC"}

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

@@ -1,11 +1,11 @@
 import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 export declare const DEFAULT_MONTH_NAMES: string[];
-/** Índice 0 = domingo, para alinear con Date.getDay(). */
+/** Index 0 = Sunday, to line up with Date.getDay(). */
 export declare const DEFAULT_WEEKDAY_NAMES: string[];
 export interface DateRange {
     start: Date;
-    /** Falta mientras el rango está a medio elegir (sólo se tocó el inicio). */
+    /** Missing while the range is half-picked (only the start was tapped). */
     end?: Date;
 }
 export interface DatePickerProps {
@@ -22,7 +22,9 @@ export interface DatePickerProps {
     range?: DateRange;
     /** Called in mode="range", both when setting the start and when closing the range. */
     onRangeChange?: (range: DateRange) => void;
+    /** Earliest selectable day; earlier days are dimmed and the back arrow stops there. */
     minDate?: Date;
+    /** Latest selectable day; later days are dimmed and the forward arrow stops there. */
     maxDate?: Date;
     /** Month shown on open if there's no `value`. @default today */
     defaultMonth?: Date;
@@ -38,16 +40,10 @@ export interface DatePickerProps {
     testID?: string;
 }
 /**
- * Devuelve la grilla del mes: 6 filas de 7 celdas. Las celdas fuera del mes
- * son null, así el layout no salta de alto entre meses (un mes puede
- * necesitar 4, 5 o 6 filas según en qué día caiga el 1).
+ * Returns the month grid: 6 rows of 7 cells. Cells outside the month are
+ * null, so the layout doesn't jump in height between months (a month can
+ * need 4, 5 or 6 rows depending on which day the 1st falls on).
  */
 export declare function buildMonthGrid(year: number, month: number, firstDayOfWeek: 0 | 1): (Date | null)[][];
-/**
- * DatePicker
- * Calendario mensual dibujado con View/Text puros — sin
- * @react-native-community/datetimepicker ni ningún picker nativo, para
- * mantener la librería en cero dependencias y verse igual en iOS y Android.
- */
 export declare const DatePicker: React.MemoExoticComponent<({ mode, value, onChange, range, onRangeChange, minDate, maxDate, defaultMonth, monthNames, weekdayNames, firstDayOfWeek, onVisibleMonthChange, style, testID, }: DatePickerProps) => React.JSX.Element>;
 //# sourceMappingURL=DatePicker.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../src/organisms/DatePicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkE,MAAM,OAAO,CAAC;AACvF,OAAO,EAAgC,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAK5F,eAAO,MAAM,mBAAmB,UAG/B,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,UAAsC,CAAC;AAEzE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,IAAI,CAAC;IACZ,4EAA4E;IAC5E,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC1B,sCAAsC;IACtC,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAChC,sCAAsC;IACtC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,sFAAsF;IACtF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC3C,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,gEAAgE;IAChE,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,yCAAyC;IACzC,cAAc,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACvB,0EAA0E;IAC1E,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI,CAAC;IAC7C,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA0BD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,EAAE,CAapG;AAyGD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,8LAgBlB,eAAe,uBAwJnB,CAAC"}
+{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../src/organisms/DatePicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkE,MAAM,OAAO,CAAC;AACvF,OAAO,EAAgC,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAK5F,eAAO,MAAM,mBAAmB,UAG/B,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,qBAAqB,UAAsC,CAAC;AAEzE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,IAAI,CAAC;IACZ,0EAA0E;IAC1E,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC1B,sCAAsC;IACtC,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAChC,sCAAsC;IACtC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,sFAAsF;IACtF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAC3C,uFAAuF;IACvF,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,sFAAsF;IACtF,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,gEAAgE;IAChE,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,yCAAyC;IACzC,cAAc,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACvB,0EAA0E;IAC1E,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI,CAAC;IAC7C,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA0BD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,EAAE,CAapG;AAkID,eAAO,MAAM,UAAU,8LAgBlB,eAAe,uBAwJnB,CAAC"}

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

@@ -2,41 +2,68 @@ import React from 'react';
 import { type FlatListProps, type ViewStyle } from 'react-native';
 import type { IconName } from '../icons/types';
 export interface ListProps<T> {
+    /** 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;
     /** 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 fullscreen spinner shown while `isReady` is false. @default labels.loading */
     loadingText?: string;
+    /** Text of the footer spinner shown with `isLoadingMore`. @default labels.loadingMore */
     loadingMoreText?: 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 (to load the next page). */
     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. */
     ListFooterComponent?: FlatListProps<T>['ListFooterComponent'];
+    /** Style of the list's content container (also used by the skeleton). */
     contentContainerStyle?: 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>;
 }
 /**
  * List
- * Lista con estados de carga/paginación/vacío resueltos, sin atarse a
- * expo-router ni a FlashList: `ListComponent` permite inyectar cualquiera
- * (por defecto FlatList del propio React Native).
+ * List with loading/pagination/empty states handled, without being tied to
+ * expo-router or FlashList: `ListComponent` lets you inject any of them
+ * (React Native's own FlatList by default).
+ *
+ * Design:
+ * - Continuity (Gestalt): the first load shows placeholders shaped like the
+ *   rows and keeps `ListHeaderComponent` in place, so nothing jumps when the
+ *   data arrives.
+ * - Doherty threshold: every wait has immediate feedback (placeholders,
+ *   pull-to-refresh spinner, footer loader while paging), and "no results"
+ *   only appears once it is known there is nothing.
+ * - Jakob's law: the native pull-to-refresh and infinite scroll people
+ *   already know from other apps.
  */
 export declare function List<T>({ data, keyExtractor, renderItem, isLoading, isRefreshing, isLoadingMore, isReady, loadingText, loadingMoreText, skeletonCount, renderSkeletonItem, onEndReached, onEndReachedThreshold, onRefresh, emptyTitle, emptyDescription, emptyIconName, ListHeaderComponent, ListFooterComponent, contentContainerStyle, containerStyle, ListComponent, listProps, }: ListProps<T>): React.JSX.Element;
 //# sourceMappingURL=List.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"List.d.ts","sourceRoot":"","sources":["../../../src/organisms/List.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsB,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAkC,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAMlG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAE3C,4EAA4E;IAC5E,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,KAAK,CAAC,YAAY,CAAC;IAE9C,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IAEvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,QAAQ,CAAC;IAEzB,mBAAmB,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IAC9D,mBAAmB,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IAE9D,qBAAqB,CAAC,EAAE,SAAS,CAAC;IAClC,cAAc,CAAC,EAAE,SAAS,CAAC;IAE3B,gEAAgE;IAChE,aAAa,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAeD;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,EACtB,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAoB,EACpB,aAAqB,EACrB,OAAc,EACd,WAAW,EACX,eAAe,EACf,aAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,qBAA2B,EAC3B,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,aAAwB,EACxB,SAAS,GACV,EAAE,SAAS,CAAC,CAAC,CAAC,qBA8Fd"}
+{"version":3,"file":"List.d.ts","sourceRoot":"","sources":["../../../src/organisms/List.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsB,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAkC,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAMlG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,uBAAuB;IACvB,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,2BAA2B;IAC3B,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,0DAA0D;IAC1D,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAE3C,4EAA4E;IAC5E,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,KAAK,CAAC,YAAY,CAAC;IAE9C,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,8FAA8F;IAC9F,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IAEvB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,aAAa,CAAC,EAAE,QAAQ,CAAC;IAEzB,mDAAmD;IACnD,mBAAmB,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IAC9D,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;IAE9D,yEAAyE;IACzE,qBAAqB,CAAC,EAAE,SAAS,CAAC;IAClC,kCAAkC;IAClC,cAAc,CAAC,EAAE,SAAS,CAAC;IAE3B,gEAAgE;IAChE,aAAa,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACzC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAwBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,EACtB,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,SAAS,EACT,YAAoB,EACpB,aAAqB,EACrB,OAAc,EACd,WAAW,EACX,eAAe,EACf,aAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,qBAA2B,EAC3B,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,aAAwB,EACxB,SAAS,GACV,EAAE,SAAS,CAAC,CAAC,CAAC,qBA2Gd"}

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

@@ -2,22 +2,49 @@ import React from 'react';
 import { type ModalProps as RNModalProps, type ViewStyle } from 'react-native';
 export type ModalVariant = 'full' | 'overlay' | 'fullScreen';
 export interface ModalProps extends Pick<RNModalProps, 'statusBarTranslucent' | 'onRequestClose' | 'hardwareAccelerated'> {
+    /** Shows or hides the modal. The animated variants play their exit before unmounting. */
     visible: boolean;
+    /**
+     * Shows the close button in the header and is called by it, by a tap on the backdrop (`overlay`) and
+     * by Android's back button.
+     */
     onClose?: () => void;
+    /** Header title, on a single line. */
     title?: string;
+    /** Accessible name of the close button. @default labels.close */
     closeAccessibilityLabel?: string;
+    /** Body of the modal. */
     children: React.ReactNode;
+    /** Fixed area below the content (e.g. actions); it doesn't scroll. */
     footer?: React.ReactNode;
+    /** Style of the card (`overlay`) or the full-screen wrapper. */
     containerStyle?: ViewStyle;
+    /** Style of the content area (the scroll container when `scrollable`). */
     contentStyle?: ViewStyle;
+    /**
+     * 'full' slides up a full page, 'overlay' a centered card over a dimmed backdrop, 'fullScreen' uses
+     * the native full-screen presentation. @default 'full'
+     */
     variant?: ModalVariant;
+    /** Wraps the content in a ScrollView. @default true */
     scrollable?: boolean;
 }
 /**
  * Modal
- * Un solo componente para todos los modales de la app: maneja scroll,
- * teclado, insets y layout según `variant`. Para una hoja desde abajo está
- * BottomSheet, que además trae arrastre para cerrar.
+ * A single component for all of the app's modals: handles scroll, keyboard,
+ * insets and layout according to `variant`. For a sheet from the bottom there
+ * is BottomSheet, which also comes with drag to close.
+ *
+ * Design:
+ * - Figure and ground (Gestalt): `overlay` dims the screen behind a raised
+ *   card, so the task in front is the only figure.
+ * - Common region: header, content and footer share one surface, split by
+ *   hairlines; the footer stays fixed so its actions are always in reach.
+ * - Jakob's law: title on the left, close at the top right, Android back and
+ *   the VoiceOver escape gesture close it, like the system's own sheets.
+ * - Fitts's law: the close button is a 44pt target.
+ * - Screen readers stay inside the modal (`accessibilityViewIsModal`), which
+ *   matters on iOS when it is drawn inside another open overlay.
  */
 export declare const Modal: React.MemoExoticComponent<({ visible, onClose, title, closeAccessibilityLabel, children, footer, containerStyle, contentStyle, variant, scrollable, statusBarTranslucent, onRequestClose, hardwareAccelerated, }: ModalProps) => React.JSX.Element | null>;
 //# sourceMappingURL=Modal.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../src/organisms/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,EAQL,KAAK,UAAU,IAAI,YAAY,EAC/B,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAUtB,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;AAE7D,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,YAAY,EAAE,sBAAsB,GAAG,gBAAgB,GAAG,qBAAqB,CAAC;IAC7F,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAsCD;;;;;GAKG;AACH,eAAO,MAAM,KAAK,oNAeb,UAAU,8BAqJd,CAAC"}
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../src/organisms/Modal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,EAOL,KAAK,UAAU,IAAI,YAAY,EAC/B,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAUtB,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;AAE7D,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,YAAY,EAAE,sBAAsB,GAAG,gBAAgB,GAAG,qBAAqB,CAAC;IAC7F,yFAAyF;IACzF,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,yBAAyB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,sEAAsE;IACtE,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,gEAAgE;IAChE,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA4CD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,KAAK,oNAeb,UAAU,8BAgLd,CAAC"}