orn-ui 0.2.9 → 0.3.0

package/lib/typescript/organisms/chart/math.d.ts

@@ -1,130 +1,130 @@
 /**
- * Geometría y escalas de Chart: todo lo que se puede probar sin montar un
- * árbol vive acá, sin React y sin dependencias. marks.tsx sólo traduce estos
- * números a estilos, y Chart.tsx sólo decide qué marca dibujar.
+ * Chart geometry and scales: everything that can be tested without mounting a
+ * tree lives here, without React and without dependencies. marks.tsx only
+ * translates these numbers into styles, and Chart.tsx only decides which mark to draw.
  *
- * Convenciones:
- * - Coordenadas de React Native: origen arriba-izquierda, `y` crece hacia abajo.
- * - Ángulos en grados, 0° a las 12 en punto, creciendo en sentido horario —
- *   que es como se lee una torta y como gira `transform: rotate` en RN.
+ * Conventions:
+ * - React Native coordinates: origin at the top-left, `y` grows downward.
+ * - Angles in degrees, 0° at 12 o'clock, increasing clockwise —
+ *   which is how a pie is read and how `transform: rotate` turns in RN.
  */
 export interface Point {
     x: number;
     y: number;
 }
-/** Fila de datos: una categoría del eje x y un número por serie. */
+/** Data row: an x-axis category and one number per series. */
 export type ChartRow = Record<string, string | number | null | undefined>;
-/** Lee una celda como número, o null si no lo es (hueco en la serie). */
+/** Reads a cell as a number, or null if it isn't one (a gap in the series). */
 export declare function toNumber(value: unknown): number | null;
 export declare function clamp(value: number, min: number, max: number): number;
 /**
- * El 1, 2, 5 o 10 (por su potencia de diez) más cercano por encima de `rough`.
- * Es lo que hace que los ticks caigan en números que alguien diría en voz
- * alta — 0, 250, 500 — y no en 0, 237, 474.
+ * The 1, 2, 5 or 10 (times its power of ten) closest above `rough`.
+ * It is what makes ticks land on numbers someone would say out loud —
+ * 0, 250, 500 — and not on 0, 237, 474.
  */
 export declare function niceStep(rough: number): number;
 export interface Ticks {
-    /** Extremo inferior redondeado hacia afuera. */
+    /** Lower end, rounded outward. */
     min: number;
-    /** Extremo superior redondeado hacia afuera. */
+    /** Upper end, rounded outward. */
     max: number;
     step: number;
     values: number[];
 }
 /**
- * Dominio redondeado a valores legibles más la lista de ticks. `count` es una
- * intención, no una promesa: redondear hacia afuera puede dar uno más o uno
- * menos, y eso es preferible a un eje con números arbitrarios.
+ * Domain rounded to legible values plus the list of ticks. `count` is an
+ * intent, not a promise: rounding outward may give one more or one fewer,
+ * and that is preferable to an axis with arbitrary numbers.
  */
 export declare function niceScale(min: number, max: number, count?: number): Ticks;
 /**
- * Ticks de un dominio que el consumidor fijó a mano. No redondea nada: si
- * alguien pide 0–100, el eje dice 0–100. Es lo contrario de `niceScale`, y es
- * lo que necesita un chart en vivo — un eje que se reacomoda en cada tick hace
- * saltar la línea aunque el dato no se haya movido.
+ * Ticks for a domain the consumer set by hand. It rounds nothing: if someone
+ * asks for 0–100, the axis says 0–100. It is the opposite of `niceScale`, and
+ * it is what a live chart needs — an axis that rearranges itself on every tick
+ * makes the line jump even though the data hasn't moved.
  */
 export declare function exactTicks(min: number, max: number, count?: number): Ticks;
 /**
- * Une dos dominios quedándose con el más ancho. Es el modo 'sticky': el eje
- * crece cuando llega un valor que no entraba y no se vuelve a achicar, así
- * que lo que se ve moverse es el dato y no la escala.
+ * Merges two domains keeping the widest. It is the 'sticky' mode: the axis
+ * grows when a value arrives that didn't fit and never shrinks back, so what
+ * you see moving is the data and not the scale.
  */
 export declare function growExtent(previous: [number, number] | null, next: [number, number]): [number, number];
-/** Interpolador lineal dominio → rango. Dominio degenerado cae al medio del rango. */
+/** Linear domain → range interpolator. A degenerate domain falls to the middle of the range. */
 export declare function linearScale(domain: [number, number], range: [number, number]): (value: number) => number;
 export interface ExtentOptions {
-    /** Las series se suman en vez de compararse (barras/áreas apiladas). */
+    /** The series are summed instead of compared (stacked bars/areas). */
     stacked?: boolean;
-    /** Fuerza el 0 adentro del dominio: sin él, una barra corta miente. */
+    /** Forces 0 into the domain: without it, a short bar lies. */
     includeZero?: boolean;
 }
-/** Mínimo y máximo de las series pedidas. Sin datos devuelve [0, 1]. */
+/** Minimum and maximum of the requested series. With no data it returns [0, 1]. */
 export declare function extent(rows: ChartRow[], keys: string[], options?: ExtentOptions): [number, number];
 export interface StackBand {
     key: string;
-    /** Borde de la banda más cerca del cero. */
+    /** Edge of the band closest to zero. */
     from: number;
-    /** Borde más lejos del cero. */
+    /** Edge furthest from zero. */
     to: number;
     value: number;
 }
 /**
- * Bandas apiladas de una fila. Los positivos crecen desde 0 hacia arriba y
- * los negativos desde 0 hacia abajo: una serie negativa no le come el alto a
- * las positivas, que es lo que pasa si se apila todo en un solo acumulador.
+ * Stacked bands of a row. Positives grow from 0 upward and negatives from 0
+ * downward: a negative series doesn't eat the positives' height, which is
+ * what happens if everything is stacked in a single accumulator.
  */
 export declare function stackRow(row: ChartRow, keys: string[]): StackBand[];
-/** Punto a `radius` del centro en el ángulo dado (0° arriba, horario). */
+/** Point at `radius` from the center at the given angle (0° up, clockwise). */
 export declare function polar(center: Point, radius: number, angle: number): Point;
-/** Ángulo de un punto respecto del centro, normalizado a [0, 360). */
+/** Angle of a point relative to the center, normalized to [0, 360). */
 export declare function angleOf(center: Point, point: Point): number;
 export interface Arc {
-    /** Índice de la fila que representa. */
+    /** Index of the row it represents. */
     index: number;
     start: number;
     sweep: number;
     value: number;
-    /** Proporción sobre el total, 0–1. */
+    /** Share of the total, 0–1. */
     ratio: number;
 }
 /**
- * Arcos de una torta. Los negativos no existen en una torta (no hay "menos
- * porción"): se descartan en vez de invertirse. Total 0 ⇒ nada que dibujar.
+ * Arcs of a pie. Negatives don't exist in a pie (there is no "less slice"):
+ * they are dropped instead of inverted. Total 0 ⇒ nothing to draw.
  */
 export declare function arcsFor(values: number[]): Arc[];
-/** El arco que contiene ese ángulo, o -1. */
+/** The arc containing that angle, or -1. */
 export declare function arcAt(arcs: Arc[], angle: number): number;
-/** Ángulos de los ejes de un radar: el primero arriba, el resto en reparto parejo. */
+/** Angles of a radar's axes: the first at the top, the rest evenly spread. */
 export declare function radarAngles(count: number): number[];
 export interface SegmentBox {
     left: number;
     top: number;
     width: number;
     height: number;
-    /** Grados para `transform: [{ rotate }]`. */
+    /** Degrees for `transform: [{ rotate }]`. */
     rotate: number;
 }
 /**
- * Caja de un segmento a→b: sin SVG, una línea es un rectángulo fino rotado
- * sobre su centro. Ancho = distancia, alto = grosor, rotación = la pendiente.
+ * Box of a segment a→b: without SVG, a line is a thin rectangle rotated
+ * around its center. Width = distance, height = thickness, rotation = the slope.
  */
 export declare function segmentBox(a: Point, b: Point, thickness: number): SegmentBox;
 /**
- * Suaviza una polilínea con Catmull-Rom muestreada en `steps` tramos por vano.
- * La curva pasa por todos los puntos originales (a diferencia de un Bézier de
- * control libre), así que el dato sigue siendo el dato; sólo se agrega camino
- * entre medio, y el resultado se dibuja con los mismos segmentos rectos.
+ * Smooths a polyline with Catmull-Rom sampled in `steps` segments per span.
+ * The curve passes through all the original points (unlike a free-control
+ * Bézier), so the data is still the data; only path is added in between, and
+ * the result is drawn with the same straight segments.
  */
 export declare function smoothPoints(points: Point[], steps?: number): Point[];
 /**
- * `y` de la polilínea en esa `x`, o null si cae fuera. Es lo que convierte una
- * línea en área: cada tira vertical pregunta su alto acá.
+ * The polyline's `y` at that `x`, or null if it falls outside. It is what
+ * turns a line into an area: each vertical strip asks for its height here.
  */
 export declare function sampleY(points: Point[], x: number): number | null;
 /**
- * Formato por defecto de ejes y tooltip: compacto, porque un eje de un chart
- * de 320px no tiene lugar para "1250000". El consumidor lo reemplaza entero
- * con `formatValue`.
+ * Default format for axes and tooltip: compact, because the axis of a 320px
+ * chart has no room for "1250000". The consumer replaces it entirely with
+ * `formatValue`.
  */
 export declare function formatNumber(value: number): string;
 export interface FanStrip {
@@ -133,29 +133,28 @@ export interface FanStrip {
     radius: number;
 }
 /**
- * Descompone un polígono alrededor de un centro en porciones angulares: es lo
- * que permite rellenar un radar con la misma primitiva que dibuja una torta.
+ * Breaks a polygon around a center into angular slices: it is what lets a
+ * radar be filled with the same primitive that draws a pie.
  *
- * El corte va por el lado del polígono (parámetro `t`), no por el ángulo: el
- * radio de una cuerda no es lineal en el ángulo, y cortando por ángulo los
- * vértices quedarían redondeados justo donde el dato manda que haya una punta.
+ * The cut goes along the polygon's side (parameter `t`), not by angle: the
+ * radius of a chord isn't linear in the angle, and cutting by angle would
+ * round off the vertices exactly where the data says there should be a point.
  */
 export declare function fanStrips(center: Point, points: Point[], steps?: number): FanStrip[];
 /**
- * LTTB (Largest-Triangle-Three-Buckets): elige `threshold` puntos de `values`
- * quedándose con la forma de la curva. Devuelve índices, no puntos, para que
- * quien llama pueda conservar la fila entera —todas sus series— y no sólo la
- * que se usó para decidir.
+ * LTTB (Largest-Triangle-Three-Buckets): picks `threshold` points from
+ * `values` while keeping the shape of the curve. Returns indexes, not points,
+ * so the caller can keep the whole row —all its series— and not only the one
+ * used to decide.
  *
- * Por qué no un muestreo cada N: cada N se come los picos, que son justo lo
- * que alguien mira en una serie temporal. LTTB parte el recorrido en baldes y
- * de cada uno se queda con el punto que forma el triángulo más grande con el
- * ya elegido y con el promedio del balde siguiente — o sea, con el que más
- * cambia la silueta. Primero y último se conservan siempre.
+ * Why not sample every N: every N eats the peaks, which are exactly what
+ * someone looks at in a time series. LTTB splits the path into buckets and
+ * from each one keeps the point that forms the largest triangle with the one
+ * already picked and with the average of the next bucket — that is, the one
+ * that changes the silhouette the most. First and last are always kept.
  *
- * `x` es el índice: las categorías de un chart están repartidas parejo sobre
- * el eje, así que la distancia horizontal entre dos puntos es su distancia de
- * índice.
+ * `x` is the index: a chart's categories are spread evenly along the axis, so
+ * the horizontal distance between two points is their index distance.
  */
 export declare function lttbIndices(values: (number | null)[], threshold: number): number[];
 //# sourceMappingURL=math.d.ts.map

package/lib/typescript/organisms/chart/math.d.ts.map

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

package/lib/typescript/organisms/chart/palette.d.ts

@@ -1,6 +1,6 @@
 import type { Theme } from '../../theme/types';
-/** Contraste mínimo de un objeto gráfico contra su fondo (WCAG 1.4.11). */
+/** Minimum contrast of a graphical object against its background (WCAG 1.4.11). */
 export declare const GRAPHIC_CONTRAST = 3;
-/** `count` colores estables para las series: el mismo índice da siempre el mismo color. */
+/** `count` stable colors for the series: the same index always gives the same color. */
 export declare function seriesPalette(theme: Theme, count: number): string[];
 //# sourceMappingURL=palette.d.ts.map

package/lib/typescript/organisms/chart/palette.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../../../src/organisms/chart/palette.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAqFlC,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAMnE"}
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../../../src/organisms/chart/palette.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAqFlC,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAMnE"}

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

@@ -1,8 +1,8 @@
 /**
- * Puente entre el proveedor montado y el código que no es un componente
- * (servicios, capa de API, interceptores). El proveedor se registra al montar y
- * se borra al desmontar, así que fuera del árbol nunca queda una referencia
- * viva a un contexto muerto.
+ * Bridge between the mounted provider and code that isn't a component
+ * (services, API layer, interceptors). The provider registers itself on mount
+ * and clears itself on unmount, so outside the tree there is never a live
+ * reference left to a dead context.
  */
 export interface ImperativeBridge<T> {
     set: (value: T | null) => void;

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

@@ -1,3 +1,4 @@
+import { type ComponentRef } from 'react';
 import type { LayoutChangeEvent, NativeScrollEvent, NativeSyntheticEvent, ScrollView } from 'react-native';
 export type SlidesOrientation = 'horizontal' | 'vertical';
 export interface UseSlidesOptions {
@@ -6,12 +7,12 @@ export interface UseSlidesOptions {
     loop: boolean;
     autoPlay: boolean;
     interval: number;
-    /** Índice controlado; sin él manda el estado interno. */
+    /** Controlled index; without it the internal state rules. */
     index?: number;
     defaultIndex: number;
     onIndexChange?: (index: number) => void;
 }
-/** Una página del scroll. Los clones del modo infinito repiten el `real` de un vecino. */
+/** A page of the scroll. The infinite mode's clones repeat a neighbor's `real`. */
 export interface SlidesPage {
     real: number;
     clone: 'head' | 'tail' | null;
@@ -25,28 +26,19 @@ export interface UseSlidesResult {
         width: number;
         height: number;
     };
-    /** Largo de una página sobre el eje del scroll. En 0 todavía no se midió. */
+    /** Length of a page along the scroll axis. At 0 it hasn't been measured yet. */
     pageSize: number;
-    scrollRef: React.RefObject<ScrollView | null>;
+    scrollRef: React.RefObject<ComponentRef<typeof ScrollView> | null>;
     autoPlayPaused: boolean;
-    /** El sistema pidió reducir movimiento: no hay autoPlay ni transiciones. */
+    /** The system asked to reduce motion: no autoPlay or transitions. */
     motionReduced: boolean;
     goTo: (index: number) => void;
     toggleAutoPlay: () => void;
     onLayout: (event: LayoutChangeEvent) => void;
     onMomentumScrollEnd: (event: NativeSyntheticEvent<NativeScrollEvent>) => void;
-    onScrollBeginDrag: () => void;
-    onScrollEndDrag: () => void;
+    onScrollBeginDrag: (event: NativeSyntheticEvent<NativeScrollEvent>) => void;
+    onScrollEndDrag: (event: NativeSyntheticEvent<NativeScrollEvent>) => void;
 }
 export declare function clampIndex(value: number, total: number): number;
-/**
- * useSlides
- * Todo lo que en `Slides` no se ve: qué página está encuadrada, cuándo mover el
- * scroll, cómo se mapean los clones del modo infinito a índices reales, y el
- * reloj del avance automático.
- *
- * Trabaja sólo con índices, nunca con los ítems: así no necesita el genérico
- * `T` del componente, y el UI resuelve `pages[i].real` contra su propio `data`.
- */
 export declare function useSlides({ total, orientation, loop, autoPlay, interval, index, defaultIndex, onIndexChange, }: UseSlidesOptions): UseSlidesResult;
 //# sourceMappingURL=useSlides.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useSlides.d.ts","sourceRoot":"","sources":["../../../src/organisms/useSlides.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG3G,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,iBAAiB,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,0FAA0F;AAC1F,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC9C,cAAc,EAAE,OAAO,CAAC;IACxB,4EAA4E;IAC5E,aAAa,EAAE,OAAO,CAAC;IACvB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C,mBAAmB,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC9E,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,aAAa,GACd,EAAE,gBAAgB,GAAG,eAAe,CAsJpC"}
+{"version":3,"file":"useSlides.d.ts","sourceRoot":"","sources":["../../../src/organisms/useSlides.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqD,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAC7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG3G,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,iBAAiB,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,mFAAmF;AACnF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;IACnE,cAAc,EAAE,OAAO,CAAC;IACxB,qEAAqE;IACrE,aAAa,EAAE,OAAO,CAAC;IACvB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C,mBAAmB,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC9E,iBAAiB,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC5E,eAAe,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;CAC3E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/D;AAcD,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,aAAa,GACd,EAAE,gBAAgB,GAAG,eAAe,CAsLpC"}

package/lib/typescript/safe-area/SafeAreaUIProvider.d.ts

@@ -1,8 +1,10 @@
-import React from 'react';
-import { type UIProviderProps } from '../theme/UIProvider';
-export interface SafeAreaUIProviderProps extends Omit<UIProviderProps, 'insets'> {
-    insets?: UIProviderProps['insets'];
-    mountSafeAreaProvider?: boolean;
-}
-export declare function SafeAreaUIProvider({ mountSafeAreaProvider, ...props }: SafeAreaUIProviderProps): React.JSX.Element;
+import { UIProvider, type UIProviderProps } from '../theme/UIProvider';
+/**
+ * @deprecated Use `UIProvider` from 'orn-ui': it now measures the safe area
+ * insets itself (react-native-safe-area-context is a required peer). This
+ * alias stays for one minor version so existing imports keep working.
+ */
+export type SafeAreaUIProviderProps = UIProviderProps;
+/** @deprecated Use `UIProvider` from 'orn-ui' — same component. */
+export declare const SafeAreaUIProvider: typeof UIProvider;
 //# sourceMappingURL=SafeAreaUIProvider.d.ts.map

package/lib/typescript/safe-area/SafeAreaUIProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SafeAreaUIProvider.d.ts","sourceRoot":"","sources":["../../../src/safe-area/SafeAreaUIProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAGnD,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC;IAC9E,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IACnC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AA+CD,wBAAgB,kBAAkB,CAAC,EACjC,qBAA4B,EAC5B,GAAG,KAAK,EACT,EAAE,uBAAuB,qBAOzB"}
+{"version":3,"file":"SafeAreaUIProvider.d.ts","sourceRoot":"","sources":["../../../src/safe-area/SafeAreaUIProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,eAAe,CAAC;AAEtD,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,mBAAa,CAAC"}

package/lib/typescript/safe-area/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/safe-area/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/safe-area/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/typescript/theme/KeyboardAvoidance.d.ts

@@ -0,0 +1,62 @@
+import React from 'react';
+/** A focused field the host has to keep in view. */
+export interface KeyboardField {
+    /** The field's box in window coordinates (label, field and error included). */
+    measure: () => Promise<{
+        y: number;
+        height: number;
+    } | null>;
+}
+export interface KeyboardHost {
+    focus: (field: KeyboardField) => void;
+    blur: (field: KeyboardField) => void;
+}
+/** The active host, or null if a container already handles the keyboard (or it is off). */
+export declare function useKeyboardHost(): KeyboardHost | null;
+/**
+ * For containers that already keep the focused field visible on their own:
+ * a Modal or BottomSheet (its own native window, which the root's shift
+ * doesn't move) or a ScrollView with `automaticallyAdjustKeyboardInsets`.
+ * Inside, Inputs ask nothing of the host and the keyboard isn't compensated
+ * twice.
+ */
+export declare function KeyboardHandled({ children }: {
+    children: React.ReactNode;
+}): React.JSX.Element;
+/**
+ * Vertical shift (≤ 0) so the whole field sits above the keyboard, with
+ * `margin` of room, without its top edge going past `topLimit`.
+ * `fieldY` is the position measured with the `current` shift applied.
+ * If the field is already visible, it moves back toward 0: it never rises more than needed.
+ */
+export declare function computeKeyboardOffset({ fieldY, fieldHeight, keyboardTop, current, margin, topLimit, }: {
+    fieldY: number;
+    fieldHeight: number;
+    keyboardTop: number;
+    current: number;
+    margin: number;
+    topLimit: number;
+}): number;
+/**
+ * An area that shifts so the focused Input inside it sits above the
+ * keyboard (transform on the native thread; it returns to 0 on close). It is
+ * Android's `adjustPan`, the same on both platforms.
+ *
+ * - The root UIProvider mounts one around the whole app: the fallback, so
+ *   an Input is visible even when it isn't inside a Screen.
+ * - Screen mounts another around its content, with `clip`: only the content
+ *   moves and the header (`header` prop) and the tab bar stay still, as in a
+ *   native app. The Input registers with the nearest area, so inside a
+ *   Screen the root doesn't move.
+ *
+ * With `clip`, whatever rises is clipped at the area's top edge and the field
+ * never goes above that edge (it stays under the header).
+ */
+export declare function KeyboardPanArea({ margin, topLimit, clip, children, }: {
+    margin: number;
+    /** Top limit in window coordinates. With `clip`, the area's edge is used if it is lower. */
+    topLimit: number;
+    clip?: boolean;
+    children: React.ReactNode;
+}): React.JSX.Element;
+//# sourceMappingURL=KeyboardAvoidance.d.ts.map

package/lib/typescript/theme/KeyboardAvoidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyboardAvoidance.d.ts","sourceRoot":"","sources":["../../../src/theme/KeyboardAvoidance.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmF,MAAM,OAAO,CAAC;AAYxG,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,OAAO,EAAE,MAAM,OAAO,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACtC,IAAI,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CACtC;AAID,2FAA2F;AAC3F,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,qBAE1E;AAKD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,MAAM,EACN,WAAW,EACX,WAAW,EACX,OAAO,EACP,MAAM,EACN,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAOT;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,QAAQ,EACR,IAAY,EACZ,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,qBAoGA"}

package/lib/typescript/theme/NativeOverlay.d.ts

@@ -0,0 +1,43 @@
+import React from 'react';
+import { type ModalProps } from 'react-native';
+/**
+ * NativeOverlay
+ * The native `Modal` every orn-ui overlay (Alert, BottomSheet, Modal, Select)
+ * goes through.
+ *
+ * Why: iOS presents a native modal from the root view controller and only one
+ * at a time. A second `<Modal>` that is not rendered inside the first one is
+ * silently ignored while the first is presented, and also while it is still
+ * being dismissed. In practice an Alert from `showAlert()` over an open
+ * BottomSheet never showed, and neither did one opened right after closing a
+ * sheet. Android opens a window per modal and never had the problem: there
+ * this is a plain `Modal`.
+ *
+ * iOS, when an overlay becomes visible:
+ * - Rendered inside another overlay (nested): plain native modal; iOS presents
+ *   it from that one, which works.
+ * - Another overlay is presented and this one is not inside it: it is drawn
+ *   as a layer inside the topmost presented overlay instead of presenting a
+ *   second native modal. Its React context then comes from that overlay's
+ *   position: a provider that wraps only this overlay doesn't reach it.
+ * - Another overlay is closing (exit animation or native dismissal): it waits
+ *   until that one is gone, then presents.
+ */
+export interface NativeOverlayProps extends Pick<ModalProps, 'transparent' | 'animationType' | 'presentationStyle' | 'statusBarTranslucent' | 'onRequestClose' | 'hardwareAccelerated'> {
+    /**
+     * The overlay is logically hidden but still mounted to play its exit
+     * animation: it stays on screen, but no other overlay may layer into it.
+     */
+    closing?: boolean;
+    /**
+     * A dialog (Alert) always ends up on top: whatever gets layered into it is
+     * drawn beneath its own content, and as a layer it is drawn after any
+     * non-dialog layer of the same host.
+     */
+    dialog?: boolean;
+    children: React.ReactNode;
+}
+export declare function NativeOverlay({ closing, dialog, children, ...modalProps }: NativeOverlayProps): React.JSX.Element | null;
+/** Test-only: clears the registry between tests. */
+export declare function __resetNativeOverlays(): void;
+//# sourceMappingURL=NativeOverlay.d.ts.map

package/lib/typescript/theme/NativeOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeOverlay.d.ts","sourceRoot":"","sources":["../../../src/theme/NativeOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkF,MAAM,OAAO,CAAC;AACvG,OAAO,EAAyB,KAAK,UAAU,EAAkB,MAAM,cAAc,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,kBACf,SAAQ,IAAI,CACV,UAAU,EACV,aAAa,GAAG,eAAe,GAAG,mBAAmB,GAAG,sBAAsB,GAAG,gBAAgB,GAAG,qBAAqB,CAC1H;IACD;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAoHD,wBAAgB,aAAa,CAAC,EAAE,OAAe,EAAE,MAAc,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,EAAE,kBAAkB,4BAqG7G;AAED,oDAAoD;AACpD,wBAAgB,qBAAqB,SAIpC"}

package/lib/typescript/theme/UIProvider.d.ts

@@ -1,17 +1,16 @@
 import React from 'react';
 import { Appearance } from 'react-native';
 import { type Labels } from './labels';
-import { type EdgeInsets } from './insets';
+import type { EdgeInsets } from './insets';
 import type { Theme, ThemePair } from './types';
 import type { IconRenderer } from '../icons/types';
 export type ThemeMode = 'system' | 'light' | 'dark';
 /**
- * Un `<Modal>`/`<BottomSheet>` nativo abre su propia ventana (en Android
- * siempre; en iOS según `presentationStyle`), así que los insets medidos en
- * la raíz de la app pueden no valer ahí adentro. Este boundary es el punto de
- * inyección: el default sólo repite los insets ambientes (comportamiento de
- * siempre, cero deps), pero `SafeAreaUIProvider` lo reemplaza por uno que
- * monta un `<SafeAreaProvider>` nuevo y remide dentro de esa ventana.
+ * A native `<Modal>`/`<BottomSheet>` opens its own window (always on Android;
+ * on iOS depending on `presentationStyle`), so the insets measured at the app
+ * root may not hold in there. The boundary mounts a new `<SafeAreaProvider>`
+ * inside that window and re-measures; until the first measurement arrives it
+ * repeats the ambient insets.
  */
 export interface ModalSafeAreaBoundaryProps {
     children: (insets: EdgeInsets) => React.ReactNode;
@@ -28,26 +27,45 @@ export interface UIProviderProps {
     onModeChange?: (mode: ThemeMode) => void;
     /** Icon renderer. Defaults to the included zero-dep glyphs. */
     icons?: IconRenderer;
-    /** Safe area insets (from useSafeAreaInsets()). Defaults to {0,0,0,0}. */
+    /**
+     * Overrides the measured safe area insets. Leave it out: the provider
+     * measures them itself with react-native-safe-area-context.
+     */
     insets?: EdgeInsets;
     labels?: Partial<Labels>;
-    /** @default false, for parity with the rest of the library (accessibility first). */
+    /**
+     * Lets every orn-ui text follow the system font size (Dynamic Type / Android
+     * font scale). Opt-in: layouts are tuned for the default size, so turn it on
+     * only after checking your screens at large sizes.
+     * @default false
+     */
     allowFontScaling?: boolean;
     /**
-     * Source of insets used by `Modal`/`BottomSheet` for their own native
-     * window. Don't pass this by hand — `SafeAreaUIProvider` wires it up itself.
-     * @default repeats the ambient insets (behavior without safe-area-context)
+     * Mounts a `<SafeAreaProvider>` around the app. Pass `false` only if the app
+     * already mounts one above (e.g. expo-router does): insets are then read
+     * from that one.
+     * @default true
+     */
+    mountSafeAreaProvider?: boolean;
+    /**
+     * Keeps the focused Input visible above the keyboard by moving the whole app
+     * up just enough (like Android's adjustPan, on both platforms), with no
+     * Screen or ScrollView needed. Only the root provider does it. Turn it off if
+     * your app already handles the keyboard its own way.
+     * @default true
      */
-    ModalSafeAreaBoundary?: ModalSafeAreaBoundaryComponent;
+    keyboardAvoidance?: boolean;
 }
 /**
  * UIProvider
- * Único punto de entrada de la librería: resuelve el theme activo (sistema u
- * override manual), e inyecta íconos, insets y textos por defecto a todo el
- * árbol. No persiste el modo — si el consumidor quiere recordar la preferencia
- * entre sesiones, controla `mode`/`onModeChange` y persiste donde prefiera.
+ * The library's single entry point: resolves the active theme (system or
+ * manual override), measures the safe area insets (react-native-safe-area-context,
+ * a required peer) and injects icons, insets and default texts into the whole
+ * tree. It doesn't persist the mode — if the consumer wants to remember the
+ * preference across sessions, it controls `mode`/`onModeChange` and persists
+ * wherever it prefers.
  */
-export declare function UIProvider({ children, theme, defaultMode, mode: controlledMode, onModeChange, icons, insets, labels: labelOverrides, allowFontScaling, ModalSafeAreaBoundary, }: UIProviderProps): React.JSX.Element;
+export declare function UIProvider({ mountSafeAreaProvider, ...props }: UIProviderProps): React.JSX.Element;
 export declare function useTheme(): Theme;
 export declare function useColors(): Theme['colors'];
 export declare function useThemeMode(): {
@@ -58,9 +76,9 @@ export declare function useIcons(): IconRenderer;
 export declare function useInsets(): EdgeInsets;
 export declare function useLabels(): Labels;
 export declare function useAllowFontScaling(): boolean;
-/** Interno: lo consumen `Modal`/`BottomSheet` para remedir insets dentro de su propia ventana nativa. */
+/** Internal: consumed by `Modal`/`BottomSheet` to re-measure insets inside their own native window. */
 export declare function useModalSafeAreaBoundary(): ModalSafeAreaBoundaryComponent;
-/** Re-exportado para que tests/consumidores puedan simular cambios de sistema sin RN real. */
+/** Re-exported so tests/consumers can simulate system changes without real RN. */
 export declare const __testUtils: {
     Appearance: typeof Appearance;
 };