orn-ui 0.2.9 → 0.3.0

package/lib/module/theme/createStyles.js

@@ -2,33 +2,37 @@
 
 import { StyleSheet } from 'react-native';
 import { useTheme } from './UIProvider';
+
 /**
  * createStyles(factory)
- * Devuelve un hook useStyles() que memoiza el StyleSheet resultante por
- * theme (WeakMap<Theme, Styles>), no por instancia de componente. Todas las
- * filas de una lista comparten el mismo objeto de estilos: sin esto, N filas
- * ⇒ N StyleSheet.create() por render, que es lo que hacía cada componente
- * de la app original con `useMemo(() => createStyles(colors), [colors])`.
+ * Returns a useStyles() hook that memoizes the resulting StyleSheet per
+ * theme (WeakMap<Theme, Styles>), not per component instance. All rows of a
+ * list share the same styles object: without this, N rows ⇒ N
+ * StyleSheet.create() per render, which is what every component of the
+ * original app did with `useMemo(() => createStyles(colors), [colors])`.
  *
- * La cache vive en el closure del factory (una WeakMap por llamada a
- * createStyles, es decir, una por componente), así que temas de distintos
- * <UIProvider> en el mismo árbol no colisionan entre sí.
+ * The cache lives in the factory's closure (one WeakMap per createStyles
+ * call, i.e. one per component), so themes from different <UIProvider>s in
+ * the same tree don't collide with each other.
  *
- * El tipo de `factory` sigue el patrón oficial de RN para StyleSheet
- * tipados (`T extends StyleSheet.NamedStyles<T> | StyleSheet.NamedStyles<any>`):
- * es lo que le da contexto a TS para inferir literales ('row', 'center', ...)
- * en vez de ensancharlos a `string` dentro del objeto devuelto.
+ * The `factory` type follows RN's pattern for typed StyleSheets
+ * (`T extends NamedStyles<T> | NamedStyles<any>`): it is what gives TS the
+ * context to infer literals ('row', 'center', ...) instead of widening them
+ * to `string` inside the returned object. `NamedStyles` is declared here:
+ * react-native 0.88's generated types (Expo SDK 58) no longer export
+ * `StyleSheet.NamedStyles`.
  */
+
 export function createStyles(factory) {
   const cache = new WeakMap();
   return function useStyles() {
     const theme = useTheme();
     let styles = cache.get(theme);
     if (!styles) {
-      // El cast es seguro: StyleSheet.create<T>(...) con el mismo T del
-      // factory siempre devuelve T; TS no puede probarlo por sí solo dentro
-      // de un cuerpo genérico (T podría "instanciarse" con un subtipo no
-      // relacionado desde su punto de vista, aunque en runtime es el mismo).
+      // The cast is safe: StyleSheet.create<T>(...) with the factory's same T
+      // always returns T; TS can't prove it on its own inside a generic body
+      // (T could be "instantiated" with an unrelated subtype from its point
+      // of view, even though at runtime it is the same).
       styles = StyleSheet.create(factory(theme));
       cache.set(theme, styles);
     }

package/lib/module/theme/createStyles.js.map

@@ -1 +1 @@
-{"version":3,"names":["StyleSheet","useTheme","createStyles","factory","cache","WeakMap","useStyles","theme","styles","get","create","set"],"sourceRoot":"../../../src","sources":["theme/createStyles.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,cAAc;AACzC,SAASC,QAAQ,QAAQ,cAAc;AAGvC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAC1BC,OAAwD,EAC/C;EACT,MAAMC,KAAK,GAAG,IAAIC,OAAO,CAAW,CAAC;EAErC,OAAO,SAASC,SAASA,CAAA,EAAM;IAC7B,MAAMC,KAAK,GAAGN,QAAQ,CAAC,CAAC;IACxB,IAAIO,MAAM,GAAGJ,KAAK,CAACK,GAAG,CAACF,KAAK,CAAC;IAC7B,IAAI,CAACC,MAAM,EAAE;MACX;MACA;MACA;MACA;MACAA,MAAM,GAAGR,UAAU,CAACU,MAAM,CAACP,OAAO,CAACI,KAAK,CAAC,CAAM;MAC/CH,KAAK,CAACO,GAAG,CAACJ,KAAK,EAAEC,MAAM,CAAC;IAC1B;IACA,OAAOA,MAAM;EACf,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["StyleSheet","useTheme","createStyles","factory","cache","WeakMap","useStyles","theme","styles","get","create","set"],"sourceRoot":"../../../src","sources":["theme/createStyles.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAyD,cAAc;AAC1F,SAASC,QAAQ,QAAQ,cAAc;;AAGvC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,OAAO,SAASC,YAAYA,CAC1BC,OAA6C,EACpC;EACT,MAAMC,KAAK,GAAG,IAAIC,OAAO,CAAW,CAAC;EAErC,OAAO,SAASC,SAASA,CAAA,EAAM;IAC7B,MAAMC,KAAK,GAAGN,QAAQ,CAAC,CAAC;IACxB,IAAIO,MAAM,GAAGJ,KAAK,CAACK,GAAG,CAACF,KAAK,CAAC;IAC7B,IAAI,CAACC,MAAM,EAAE;MACX;MACA;MACA;MACA;MACAA,MAAM,GAAGR,UAAU,CAACU,MAAM,CAACP,OAAO,CAACI,KAAK,CAAC,CAAM;MAC/CH,KAAK,CAACO,GAAG,CAACJ,KAAK,EAAEC,MAAM,CAAC;IAC1B;IACA,OAAOA,MAAM;EACf,CAAC;AACH","ignoreList":[]}

package/lib/module/theme/createTheme.js

@@ -21,7 +21,7 @@ function mergeDeep(base, patch) {
 }
 const capitalize = name => name.charAt(0).toUpperCase() + name.slice(1);
 
-/** Expande cada hex de `brand` a los cuatro roles del acento en un esquema. */
+/** Expands each `brand` hex into the accent's four roles in a scheme. */
 function brandColors(brand, scheme, palette) {
   if (!brand) return {};
   const accents = typeof brand === 'string' ? {
@@ -40,12 +40,12 @@ function brandColors(brand, scheme, palette) {
 }
 
 /**
- * Construye el par de themes light/dark que consume <UIProvider theme={...}>.
- * Nunca muta los defaults: cada llamada produce objetos nuevos, seguros de
- * compartir entre providers distintos (tests, multi-brand en el mismo árbol).
+ * Builds the light/dark theme pair consumed by <UIProvider theme={...}>.
+ * Never mutates the defaults: each call produces new objects, safe to share
+ * between different providers (tests, multi-brand in the same tree).
  *
- * `brand` se aplica antes que `colors`, así que un rol escrito a mano siempre
- * gana sobre el derivado.
+ * `brand` is applied before `colors`, so a hand-written role always wins
+ * over the derived one.
  */
 export function createTheme(overrides) {
   const tokens = mergeDeep(defaultTokens, overrides?.tokens);

package/lib/module/theme/index.js

@@ -1,6 +1,6 @@
 "use strict";
 
-export { spacing, radius, fontSize, fontWeight, lineHeight, duration, shadow, tokens } from './tokens';
+export { spacing, radius, fontSize, fontWeight, lineHeight, letterSpacing, duration, shadow, tokens } from './tokens';
 export { lightPalette, darkPalette } from './palettes';
 export { createTheme, defaultTheme } from './createTheme';
 export { deriveAccent, contrast, luminance, AA_CONTRAST } from './colors';

package/lib/module/theme/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["spacing","radius","fontSize","fontWeight","lineHeight","duration","shadow","tokens","lightPalette","darkPalette","createTheme","defaultTheme","deriveAccent","contrast","luminance","AA_CONTRAST","defaultLabels","zeroInsets","createStyles","UIProvider","useTheme","useColors","useThemeMode","useIcons","useInsets","useLabels","useAllowFontScaling"],"sourceRoot":"../../../src","sources":["theme/index.ts"],"mappings":";;AAAA,SAASA,OAAO,EAAEC,MAAM,EAAEC,QAAQ,EAAEC,UAAU,EAAEC,UAAU,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,MAAM,QAAQ,UAAU;AAEtG,SAASC,YAAY,EAAEC,WAAW,QAAQ,YAAY;AAEtD,SAASC,WAAW,EAAEC,YAAY,QAAQ,eAAe;AAEzD,SAASC,YAAY,EAAEC,QAAQ,EAAEC,SAAS,EAAEC,WAAW,QAAQ,UAAU;AAEzE,SAASC,aAAa,QAAQ,UAAU;AAExC,SAASC,UAAU,QAAQ,UAAU;AAErC,SAASC,YAAY,QAAQ,gBAAgB;AAC7C,SACEC,UAAU,EACVC,QAAQ,EACRC,SAAS,EACTC,YAAY,EACZC,QAAQ,EACRC,SAAS,EACTC,SAAS,EACTC,mBAAmB,QACd,cAAc","ignoreList":[]}
+{"version":3,"names":["spacing","radius","fontSize","fontWeight","lineHeight","letterSpacing","duration","shadow","tokens","lightPalette","darkPalette","createTheme","defaultTheme","deriveAccent","contrast","luminance","AA_CONTRAST","defaultLabels","zeroInsets","createStyles","UIProvider","useTheme","useColors","useThemeMode","useIcons","useInsets","useLabels","useAllowFontScaling"],"sourceRoot":"../../../src","sources":["theme/index.ts"],"mappings":";;AAAA,SAASA,OAAO,EAAEC,MAAM,EAAEC,QAAQ,EAAEC,UAAU,EAAEC,UAAU,EAAEC,aAAa,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,MAAM,QAAQ,UAAU;AAErH,SAASC,YAAY,EAAEC,WAAW,QAAQ,YAAY;AAEtD,SAASC,WAAW,EAAEC,YAAY,QAAQ,eAAe;AAEzD,SAASC,YAAY,EAAEC,QAAQ,EAAEC,SAAS,EAAEC,WAAW,QAAQ,UAAU;AAEzE,SAASC,aAAa,QAAQ,UAAU;AAExC,SAASC,UAAU,QAAQ,UAAU;AAErC,SAASC,YAAY,QAAQ,gBAAgB;AAC7C,SACEC,UAAU,EACVC,QAAQ,EACRC,SAAS,EACTC,YAAY,EACZC,QAAQ,EACRC,SAAS,EACTC,SAAS,EACTC,mBAAmB,QACd,cAAc","ignoreList":[]}

package/lib/module/theme/insets.js

@@ -1,6 +1,6 @@
 "use strict";
 
-/** Estructuralmente igual a EdgeInsets de react-native-safe-area-context, sin depender del paquete. */
+/** Structurally identical to react-native-safe-area-context's EdgeInsets, without depending on the package. */
 
 export const zeroInsets = {
   top: 0,

package/lib/module/theme/labels.js

@@ -13,6 +13,34 @@ export const defaultLabels = {
   months: ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'],
   weekdaysShort: ['S', 'M', 'T', 'W', 'T', 'F', 'S'],
   selectDate: 'Select date',
-  clear: 'Clear'
+  clear: 'Clear',
+  showPassword: 'Show password',
+  hidePassword: 'Hide password',
+  required: 'required',
+  requiredError: 'This field is required',
+  minLengthError: 'Enter at least {n} characters',
+  maxLengthError: 'Enter at most {n} characters',
+  patternError: 'Invalid format',
+  quantity: 'Quantity',
+  increment: 'Increment',
+  decrement: 'Decrement',
+  stepOf: 'Step {n} of {total}: {label}',
+  stepCompleted: 'completed',
+  stepCurrent: 'current',
+  stepPending: 'pending',
+  previousMonth: 'Previous month',
+  nextMonth: 'Next month',
+  moveUp: 'Move up',
+  moveDown: 'Move down',
+  scan: 'Scan',
+  slideOf: 'Slide {n} of {total}',
+  pauseSlides: 'Pause automatic slides',
+  resumeSlides: 'Resume automatic slides',
+  themeSystem: 'Auto',
+  themeLight: 'Light',
+  themeDark: 'Dark',
+  back: 'Back',
+  next: 'Next',
+  finish: 'Finish'
 };
 //# sourceMappingURL=labels.js.map

package/lib/module/theme/labels.js.map

@@ -1 +1 @@
-{"version":3,"names":["defaultLabels","close","cancel","confirm","loading","loadingMore","noResultsTitle","noResultsDescription","search","selectPlaceholder","months","weekdaysShort","selectDate","clear"],"sourceRoot":"../../../src","sources":["theme/labels.ts"],"mappings":";;AAkBA,OAAO,MAAMA,aAAqB,GAAG;EACnCC,KAAK,EAAE,OAAO;EACdC,MAAM,EAAE,QAAQ;EAChBC,OAAO,EAAE,IAAI;EACbC,OAAO,EAAE,YAAY;EACrBC,WAAW,EAAE,iBAAiB;EAC9BC,cAAc,EAAE,kBAAkB;EAClCC,oBAAoB,EAAE,6BAA6B;EACnDC,MAAM,EAAE,WAAW;EACnBC,iBAAiB,EAAE,WAAW;EAC9BC,MAAM,EAAE,CACN,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EACtD,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CACjE;EACDC,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;EAClDC,UAAU,EAAE,aAAa;EACzBC,KAAK,EAAE;AACT,CAAC","ignoreList":[]}
+{"version":3,"names":["defaultLabels","close","cancel","confirm","loading","loadingMore","noResultsTitle","noResultsDescription","search","selectPlaceholder","months","weekdaysShort","selectDate","clear","showPassword","hidePassword","required","requiredError","minLengthError","maxLengthError","patternError","quantity","increment","decrement","stepOf","stepCompleted","stepCurrent","stepPending","previousMonth","nextMonth","moveUp","moveDown","scan","slideOf","pauseSlides","resumeSlides","themeSystem","themeLight","themeDark","back","next","finish"],"sourceRoot":"../../../src","sources":["theme/labels.ts"],"mappings":";;AAyEA,OAAO,MAAMA,aAAqB,GAAG;EACnCC,KAAK,EAAE,OAAO;EACdC,MAAM,EAAE,QAAQ;EAChBC,OAAO,EAAE,IAAI;EACbC,OAAO,EAAE,YAAY;EACrBC,WAAW,EAAE,iBAAiB;EAC9BC,cAAc,EAAE,kBAAkB;EAClCC,oBAAoB,EAAE,6BAA6B;EACnDC,MAAM,EAAE,WAAW;EACnBC,iBAAiB,EAAE,WAAW;EAC9BC,MAAM,EAAE,CACN,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EACtD,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CACjE;EACDC,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;EAClDC,UAAU,EAAE,aAAa;EACzBC,KAAK,EAAE,OAAO;EACdC,YAAY,EAAE,eAAe;EAC7BC,YAAY,EAAE,eAAe;EAC7BC,QAAQ,EAAE,UAAU;EACpBC,aAAa,EAAE,wBAAwB;EACvCC,cAAc,EAAE,+BAA+B;EAC/CC,cAAc,EAAE,8BAA8B;EAC9CC,YAAY,EAAE,gBAAgB;EAC9BC,QAAQ,EAAE,UAAU;EACpBC,SAAS,EAAE,WAAW;EACtBC,SAAS,EAAE,WAAW;EACtBC,MAAM,EAAE,8BAA8B;EACtCC,aAAa,EAAE,WAAW;EAC1BC,WAAW,EAAE,SAAS;EACtBC,WAAW,EAAE,SAAS;EACtBC,aAAa,EAAE,gBAAgB;EAC/BC,SAAS,EAAE,YAAY;EACvBC,MAAM,EAAE,SAAS;EACjBC,QAAQ,EAAE,WAAW;EACrBC,IAAI,EAAE,MAAM;EACZC,OAAO,EAAE,sBAAsB;EAC/BC,WAAW,EAAE,wBAAwB;EACrCC,YAAY,EAAE,yBAAyB;EACvCC,WAAW,EAAE,MAAM;EACnBC,UAAU,EAAE,OAAO;EACnBC,SAAS,EAAE,MAAM;EACjBC,IAAI,EAAE,MAAM;EACZC,IAAI,EAAE,MAAM;EACZC,MAAM,EAAE;AACV,CAAC","ignoreList":[]}

package/lib/module/theme/palettes.js

@@ -1,23 +1,23 @@
 "use strict";
 
 /**
- * Cada color es `string`, no un literal (`as const`): light y dark tienen
- * valores distintos para la misma clave, y createTheme() debe poder
- * aceptar cualquier hex/rgba en los overrides — literal typing lo impediría.
+ * Each color is a `string`, not a literal (`as const`): light and dark have
+ * different values for the same key, and createTheme() must be able to
+ * accept any hex/rgba in the overrides — literal typing would prevent it.
  *
- * Cada acento viene en cuatro roles, y no son intercambiables:
+ * Each accent comes in four roles, and they are not interchangeable:
  *
- *   `primary`      relleno sólido (fondo de botón, día seleccionado, FAB).
- *   `onPrimary`    texto/ícono *encima* de ese relleno.
- *   `primarySoft`  fondo teñido para estados seleccionados y pills.
- *   `primaryText`  texto/ícono del acento sobre `surface`, `background`
- *                  o sobre su propio `primarySoft`.
+ *   `primary`      solid fill (button background, selected day, FAB).
+ *   `onPrimary`    text/icon *on top of* that fill.
+ *   `primarySoft`  tinted background for selected states and pills.
+ *   `primaryText`  accent text/icon over `surface`, `background`
+ *                  or over its own `primarySoft`.
  *
- * El motivo es el contraste: un acento que se lee bien como relleno no se
- * lee como texto. Antes los componentes usaban `colors.primary` para las dos
- * cosas y lo teñían concatenando alpha al hex (`colors.primary + '15'`), lo
- * que en dark daba 2.6:1 sobre la superficie — muy por debajo del 4.5:1 de
- * WCAG AA. Todos los pares de esta paleta pasan AA en ambos esquemas.
+ * The reason is contrast: an accent that reads well as a fill doesn't read
+ * as text. Components used to use `colors.primary` for both things and tinted
+ * it by appending alpha to the hex (`colors.primary + '15'`), which in dark
+ * gave 2.6:1 over the surface — well below WCAG AA's 4.5:1. Every pair in
+ * this palette passes AA in both schemes.
  */
 
 const neutral = {
@@ -38,9 +38,9 @@ export const lightPalette = {
   onSuccess: '#00320f',
   successSoft: '#e3f6e9',
   successText: '#116a30',
-  // El rojo va con texto blanco, que es lo que la gente espera de un botón
-  // destructivo. #ff3b30 no llega a 4.5:1 con blanco y obligaba a texto casi
-  // negro sobre rojo; este tono sí, y sigue leyéndose como rojo de alerta.
+  // Red goes with white text, which is what people expect from a destructive
+  // button. #ff3b30 doesn't reach 4.5:1 with white and forced near-black text
+  // over red; this shade does, and still reads as an alert red.
   error: '#dc2626',
   onError: '#ffffff',
   errorSoft: '#fdeaea',
@@ -51,19 +51,20 @@ export const lightPalette = {
   warningText: '#8a4b00',
   background: '#f8f9fa',
   surface: '#ffffff',
+  surfaceRaised: '#ffffff',
   text: '#333333',
   textLight: '#666666',
   border: '#e5e7eb',
   inputBackground: '#f5f7fa',
   overlay: 'rgba(0,0,0,0.5)',
   scrim: 'rgba(248,249,250,0.8)',
-  skeleton: '#eceef1'
+  skeleton: '#e3e5e8'
 };
 
 /**
- * Los acentos de dark NO son los de light: sobre `#1e1e1e` hay que subir la
- * luminosidad del acento y bajar la del texto que va encima (por eso
- * `onPrimary` es azul oscuro acá y blanco en light).
+ * The dark accents are NOT the light ones: over `#1e1e1e` the accent's
+ * lightness has to go up and that of the text on top has to go down (which
+ * is why `onPrimary` is dark blue here and white in light).
  */
 export const darkPalette = {
   ...neutral,
@@ -89,12 +90,13 @@ export const darkPalette = {
   warningText: '#f5c97e',
   background: '#121212',
   surface: '#1e1e1e',
+  surfaceRaised: '#303036',
   text: '#ecedee',
   textLight: '#9ba1a6',
-  border: '#2a2a2e',
+  border: '#3a3a40',
   inputBackground: '#232326',
   overlay: 'rgba(0,0,0,0.6)',
   scrim: 'rgba(18,18,18,0.8)',
-  skeleton: '#26262a'
+  skeleton: '#44444b'
 };
 //# sourceMappingURL=palettes.js.map

package/lib/module/theme/palettes.js.map

@@ -1 +1 @@
-{"version":3,"names":["neutral","white","black","lightPalette","primary","onPrimary","primarySoft","primaryText","secondary","onSecondary","secondarySoft","secondaryText","success","onSuccess","successSoft","successText","error","onError","errorSoft","errorText","warning","onWarning","warningSoft","warningText","background","surface","text","textLight","border","inputBackground","overlay","scrim","skeleton","darkPalette"],"sourceRoot":"../../../src","sources":["theme/palettes.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA0CA,MAAMA,OAAO,GAAG;EACdC,KAAK,EAAE,SAAS;EAChBC,KAAK,EAAE;AACT,CAAC;AAED,OAAO,MAAMC,YAAyB,GAAG;EACvC,GAAGH,OAAO;EAEVI,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,WAAW,EAAE,SAAS;EAEtBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,aAAa,EAAE,SAAS;EACxBC,aAAa,EAAE,SAAS;EAExBC,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,WAAW,EAAE,SAAS;EAEtB;EACA;EACA;EACAC,KAAK,EAAE,SAAS;EAChBC,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,SAAS,EAAE,SAAS;EAEpBC,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,WAAW,EAAE,SAAS;EAEtBC,UAAU,EAAE,SAAS;EACrBC,OAAO,EAAE,SAAS;EAClBC,IAAI,EAAE,SAAS;EACfC,SAAS,EAAE,SAAS;EACpBC,MAAM,EAAE,SAAS;EACjBC,eAAe,EAAE,SAAS;EAC1BC,OAAO,EAAE,iBAAiB;EAC1BC,KAAK,EAAE,uBAAuB;EAC9BC,QAAQ,EAAE;AACZ,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,WAAwB,GAAG;EACtC,GAAGjC,OAAO;EAEVI,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,WAAW,EAAE,SAAS;EAEtBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,aAAa,EAAE,SAAS;EACxBC,aAAa,EAAE,SAAS;EAExBC,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,WAAW,EAAE,SAAS;EAEtBC,KAAK,EAAE,SAAS;EAChBC,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,SAAS,EAAE,SAAS;EAEpBC,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,WAAW,EAAE,SAAS;EAEtBC,UAAU,EAAE,SAAS;EACrBC,OAAO,EAAE,SAAS;EAClBC,IAAI,EAAE,SAAS;EACfC,SAAS,EAAE,SAAS;EACpBC,MAAM,EAAE,SAAS;EACjBC,eAAe,EAAE,SAAS;EAC1BC,OAAO,EAAE,iBAAiB;EAC1BC,KAAK,EAAE,oBAAoB;EAC3BC,QAAQ,EAAE;AACZ,CAAC","ignoreList":[]}
+{"version":3,"names":["neutral","white","black","lightPalette","primary","onPrimary","primarySoft","primaryText","secondary","onSecondary","secondarySoft","secondaryText","success","onSuccess","successSoft","successText","error","onError","errorSoft","errorText","warning","onWarning","warningSoft","warningText","background","surface","surfaceRaised","text","textLight","border","inputBackground","overlay","scrim","skeleton","darkPalette"],"sourceRoot":"../../../src","sources":["theme/palettes.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAgDA,MAAMA,OAAO,GAAG;EACdC,KAAK,EAAE,SAAS;EAChBC,KAAK,EAAE;AACT,CAAC;AAED,OAAO,MAAMC,YAAyB,GAAG;EACvC,GAAGH,OAAO;EAEVI,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,WAAW,EAAE,SAAS;EAEtBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,aAAa,EAAE,SAAS;EACxBC,aAAa,EAAE,SAAS;EAExBC,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,WAAW,EAAE,SAAS;EAEtB;EACA;EACA;EACAC,KAAK,EAAE,SAAS;EAChBC,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,SAAS,EAAE,SAAS;EAEpBC,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,WAAW,EAAE,SAAS;EAEtBC,UAAU,EAAE,SAAS;EACrBC,OAAO,EAAE,SAAS;EAClBC,aAAa,EAAE,SAAS;EACxBC,IAAI,EAAE,SAAS;EACfC,SAAS,EAAE,SAAS;EACpBC,MAAM,EAAE,SAAS;EACjBC,eAAe,EAAE,SAAS;EAC1BC,OAAO,EAAE,iBAAiB;EAC1BC,KAAK,EAAE,uBAAuB;EAC9BC,QAAQ,EAAE;AACZ,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,WAAwB,GAAG;EACtC,GAAGlC,OAAO;EAEVI,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,WAAW,EAAE,SAAS;EAEtBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,aAAa,EAAE,SAAS;EACxBC,aAAa,EAAE,SAAS;EAExBC,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,WAAW,EAAE,SAAS;EAEtBC,KAAK,EAAE,SAAS;EAChBC,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,SAAS,EAAE,SAAS;EAEpBC,OAAO,EAAE,SAAS;EAClBC,SAAS,EAAE,SAAS;EACpBC,WAAW,EAAE,SAAS;EACtBC,WAAW,EAAE,SAAS;EAEtBC,UAAU,EAAE,SAAS;EACrBC,OAAO,EAAE,SAAS;EAClBC,aAAa,EAAE,SAAS;EACxBC,IAAI,EAAE,SAAS;EACfC,SAAS,EAAE,SAAS;EACpBC,MAAM,EAAE,SAAS;EACjBC,eAAe,EAAE,SAAS;EAC1BC,OAAO,EAAE,iBAAiB;EAC1BC,KAAK,EAAE,oBAAoB;EAC3BC,QAAQ,EAAE;AACZ,CAAC","ignoreList":[]}

package/lib/module/theme/tokens.js

@@ -2,14 +2,14 @@
 
 import { Platform } from 'react-native';
 
-// Las escalas numéricas se tipan explícitamente como `number` (no `as const`):
-// createTheme() debe poder sobreescribir cualquier valor con otro número
-// arbitrario: con literal typing, un override de `radius.md` a `999` fallaría
-// porque el tipo inferido sería el literal `8`, no `number`.
+// Numeric scales are typed explicitly as `number` (not `as const`):
+// createTheme() must be able to override any value with any other number:
+// with literal typing, overriding `radius.md` to `999` would fail because
+// the inferred type would be the literal `8`, not `number`.
 
 /**
- * Escala de espaciado. Usar siempre estos valores en vez de números mágicos
- * para que el ritmo vertical/horizontal sea consistente entre componentes.
+ * Spacing scale. Always use these values instead of magic numbers so the
+ * vertical/horizontal rhythm is consistent across components.
  */
 export const spacing = {
   xxs: 2,
@@ -40,8 +40,8 @@ export const fontSize = {
   xxl: 24
 };
 
-// fontWeight sí necesita literales: TextStyle.fontWeight de RN exige un union
-// de strings específicos ('400' | '500' | ...), no `string` arbitrario.
+// fontWeight does need literals: RN's TextStyle.fontWeight requires a union
+// of specific strings ('400' | '500' | ...), not an arbitrary `string`.
 export const fontWeight = {
   regular: '400',
   medium: '500',
@@ -51,19 +51,32 @@ export const fontWeight = {
 export const lineHeight = {
   sm: 16,
   md: 20,
-  lg: 24
+  lg: 24,
+  xl: 30
 };
 
-/** Duraciones en ms para Animated.timing/spring. */
+/**
+ * Tracking (letterSpacing) in points. `tight` offsets the extra room that
+ * large sizes bring by default (titles); `normal` is the system's;
+ * `wide` spaces out small caps.
+ */
+export const letterSpacing = {
+  tight: -0.5,
+  normal: 0,
+  /** Short, small, uppercase labels (Badge): a little room makes them legible. */
+  wide: 0.3
+};
+
+/** Durations in ms for Animated.timing/spring. */
 export const duration = {
   fast: 150,
   base: 200,
   slow: 250
 };
 /**
- * Sombras cross-platform: shadow* para iOS, elevation para Android.
- * `shadowColor` se deja en negro fijo — el color de sombra por tema es un
- * detalle demasiado fino para justificar la complejidad de resolverlo aquí.
+ * Cross-platform shadows: shadow* for iOS, elevation for Android.
+ * `shadowColor` is left fixed at black — a per-theme shadow color is too
+ * fine a detail to justify the complexity of resolving it here.
  */
 export const shadow = {
   none: Platform.select({
@@ -111,6 +124,7 @@ export const tokens = {
   fontSize,
   fontWeight,
   lineHeight,
+  letterSpacing,
   duration,
   shadow
 };

package/lib/module/theme/tokens.js.map

@@ -1 +1 @@
-{"version":3,"names":["Platform","spacing","xxs","xs","sm","md","lg","xl","xxl","xxxl","radius","none","full","fontSize","fontWeight","regular","medium","semibold","bold","lineHeight","duration","fast","base","slow","shadow","select","android","elevation","default","shadowOpacity","shadowColor","shadowOffset","width","height","shadowRadius","tokens"],"sourceRoot":"../../../src","sources":["theme/tokens.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAwB,cAAc;;AAEvD;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA,OAAO,MAAMC,OAAkF,GAAG;EAChGC,GAAG,EAAE,CAAC;EACNC,EAAE,EAAE,CAAC;EACLC,EAAE,EAAE,CAAC;EACLC,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,GAAG,EAAE,EAAE;EACPC,IAAI,EAAE;AACR,CAAC;AAED,OAAO,MAAMC,MAAkF,GAAG;EAChGC,IAAI,EAAE,CAAC;EACPR,EAAE,EAAE,CAAC;EACLC,EAAE,EAAE,CAAC;EACLC,EAAE,EAAE,CAAC;EACLC,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,GAAG,EAAE,EAAE;EACPI,IAAI,EAAE;AACR,CAAC;AAED,OAAO,MAAMC,QAAkE,GAAG;EAChFV,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,GAAG,EAAE;AACP,CAAC;;AAED;AACA;AACA,OAAO,MAAMM,UAAU,GAAG;EACxBC,OAAO,EAAE,KAAK;EACdC,MAAM,EAAE,KAAK;EACbC,QAAQ,EAAE,KAAK;EACfC,IAAI,EAAE;AACR,CAAU;AAEV,OAAO,MAAMC,UAA8C,GAAG;EAC5Df,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE;AACN,CAAC;;AAED;AACA,OAAO,MAAMc,QAAkD,GAAG;EAChEC,IAAI,EAAE,GAAG;EACTC,IAAI,EAAE,GAAG;EACTC,IAAI,EAAE;AACR,CAAC;AAOD;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,MAAwD,GAAG;EACtEb,IAAI,EAAEX,QAAQ,CAACyB,MAAM,CAAC;IACpBC,OAAO,EAAE;MAAEC,SAAS,EAAE;IAAE,CAAC;IACzBC,OAAO,EAAE;MAAEC,aAAa,EAAE;IAAE;EAC9B,CAAC,CAAgB;EACjBzB,EAAE,EAAE;IACF0B,WAAW,EAAE,MAAM;IACnBC,YAAY,EAAE;MAAEC,KAAK,EAAE,CAAC;MAAEC,MAAM,EAAE;IAAE,CAAC;IACrCJ,aAAa,EAAE,IAAI;IACnBK,YAAY,EAAE,CAAC;IACfP,SAAS,EAAE;EACb,CAAC;EACDtB,EAAE,EAAE;IACFyB,WAAW,EAAE,MAAM;IACnBC,YAAY,EAAE;MAAEC,KAAK,EAAE,CAAC;MAAEC,MAAM,EAAE;IAAE,CAAC;IACrCJ,aAAa,EAAE,GAAG;IAClBK,YAAY,EAAE,CAAC;IACfP,SAAS,EAAE;EACb,CAAC;EACDrB,EAAE,EAAE;IACFwB,WAAW,EAAE,MAAM;IACnBC,YAAY,EAAE;MAAEC,KAAK,EAAE,CAAC;MAAEC,MAAM,EAAE;IAAE,CAAC;IACrCJ,aAAa,EAAE,IAAI;IACnBK,YAAY,EAAE,EAAE;IAChBP,SAAS,EAAE;EACb;AACF,CAAC;AAED,OAAO,MAAMQ,MAAM,GAAG;EACpBlC,OAAO;EACPS,MAAM;EACNG,QAAQ;EACRC,UAAU;EACVK,UAAU;EACVC,QAAQ;EACRI;AACF,CAAC","ignoreList":[]}
+{"version":3,"names":["Platform","spacing","xxs","xs","sm","md","lg","xl","xxl","xxxl","radius","none","full","fontSize","fontWeight","regular","medium","semibold","bold","lineHeight","letterSpacing","tight","normal","wide","duration","fast","base","slow","shadow","select","android","elevation","default","shadowOpacity","shadowColor","shadowOffset","width","height","shadowRadius","tokens"],"sourceRoot":"../../../src","sources":["theme/tokens.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAwB,cAAc;;AAEvD;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA,OAAO,MAAMC,OAAkF,GAAG;EAChGC,GAAG,EAAE,CAAC;EACNC,EAAE,EAAE,CAAC;EACLC,EAAE,EAAE,CAAC;EACLC,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,GAAG,EAAE,EAAE;EACPC,IAAI,EAAE;AACR,CAAC;AAED,OAAO,MAAMC,MAAkF,GAAG;EAChGC,IAAI,EAAE,CAAC;EACPR,EAAE,EAAE,CAAC;EACLC,EAAE,EAAE,CAAC;EACLC,EAAE,EAAE,CAAC;EACLC,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,GAAG,EAAE,EAAE;EACPI,IAAI,EAAE;AACR,CAAC;AAED,OAAO,MAAMC,QAAkE,GAAG;EAChFV,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,GAAG,EAAE;AACP,CAAC;;AAED;AACA;AACA,OAAO,MAAMM,UAAU,GAAG;EACxBC,OAAO,EAAE,KAAK;EACdC,MAAM,EAAE,KAAK;EACbC,QAAQ,EAAE,KAAK;EACfC,IAAI,EAAE;AACR,CAAU;AAEV,OAAO,MAAMC,UAAqD,GAAG;EACnEf,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE,EAAE;EACNC,EAAE,EAAE;AACN,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMa,aAA0D,GAAG;EACxEC,KAAK,EAAE,CAAC,GAAG;EACXC,MAAM,EAAE,CAAC;EACT;EACAC,IAAI,EAAE;AACR,CAAC;;AAED;AACA,OAAO,MAAMC,QAAkD,GAAG;EAChEC,IAAI,EAAE,GAAG;EACTC,IAAI,EAAE,GAAG;EACTC,IAAI,EAAE;AACR,CAAC;AAOD;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,MAAwD,GAAG;EACtEjB,IAAI,EAAEX,QAAQ,CAAC6B,MAAM,CAAC;IACpBC,OAAO,EAAE;MAAEC,SAAS,EAAE;IAAE,CAAC;IACzBC,OAAO,EAAE;MAAEC,aAAa,EAAE;IAAE;EAC9B,CAAC,CAAgB;EACjB7B,EAAE,EAAE;IACF8B,WAAW,EAAE,MAAM;IACnBC,YAAY,EAAE;MAAEC,KAAK,EAAE,CAAC;MAAEC,MAAM,EAAE;IAAE,CAAC;IACrCJ,aAAa,EAAE,IAAI;IACnBK,YAAY,EAAE,CAAC;IACfP,SAAS,EAAE;EACb,CAAC;EACD1B,EAAE,EAAE;IACF6B,WAAW,EAAE,MAAM;IACnBC,YAAY,EAAE;MAAEC,KAAK,EAAE,CAAC;MAAEC,MAAM,EAAE;IAAE,CAAC;IACrCJ,aAAa,EAAE,GAAG;IAClBK,YAAY,EAAE,CAAC;IACfP,SAAS,EAAE;EACb,CAAC;EACDzB,EAAE,EAAE;IACF4B,WAAW,EAAE,MAAM;IACnBC,YAAY,EAAE;MAAEC,KAAK,EAAE,CAAC;MAAEC,MAAM,EAAE;IAAE,CAAC;IACrCJ,aAAa,EAAE,IAAI;IACnBK,YAAY,EAAE,EAAE;IAChBP,SAAS,EAAE;EACb;AACF,CAAC;AAED,OAAO,MAAMQ,MAAM,GAAG;EACpBtC,OAAO;EACPS,MAAM;EACNG,QAAQ;EACRC,UAAU;EACVK,UAAU;EACVC,aAAa;EACbI,QAAQ;EACRI;AACF,CAAC","ignoreList":[]}

package/lib/module/theme/useKeyboardField.js

@@ -0,0 +1,33 @@
+"use strict";
+
+import { useMemo, useRef } from 'react';
+import { useKeyboardHost } from './KeyboardAvoidance';
+
+/**
+ * Registers a text field with the nearest keyboard host (a Screen's content or
+ * the root UIProvider) so it stays visible above the keyboard. `boxRef` is the
+ * block that has to be seen whole: label, field and error.
+ *
+ * Call `focus()` from the TextInput's onFocus (and again when the block grows,
+ * e.g. an error shows up while typing) and `blur()` from onBlur. Inside a
+ * container that already handles the keyboard there is no host and both are
+ * no-ops.
+ */
+export function useKeyboardField(boxRef) {
+  const host = useKeyboardHost();
+  const field = useRef({
+    measure: () => new Promise(resolve => {
+      const node = boxRef.current;
+      if (!node) return resolve(null);
+      node.measureInWindow((_x, y, _w, height) => resolve({
+        y,
+        height
+      }));
+    })
+  }).current;
+  return useMemo(() => ({
+    focus: () => host?.focus(field),
+    blur: () => host?.blur(field)
+  }), [host, field]);
+}
+//# sourceMappingURL=useKeyboardField.js.map

package/lib/module/theme/useKeyboardField.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useMemo","useRef","useKeyboardHost","useKeyboardField","boxRef","host","field","measure","Promise","resolve","node","current","measureInWindow","_x","y","_w","height","focus","blur"],"sourceRoot":"../../../src","sources":["theme/useKeyboardField.ts"],"mappings":";;AAAA,SAASA,OAAO,EAAEC,MAAM,QAA2C,OAAO;AAE1E,SAASC,eAAe,QAA4B,qBAAqB;;AAEzE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAACC,MAAmD,EAAE;EACpF,MAAMC,IAAI,GAAGH,eAAe,CAAC,CAAC;EAC9B,MAAMI,KAAK,GAAGL,MAAM,CAAgB;IAClCM,OAAO,EAAEA,CAAA,KACP,IAAIC,OAAO,CAAEC,OAAO,IAAK;MACvB,MAAMC,IAAI,GAAGN,MAAM,CAACO,OAAO;MAC3B,IAAI,CAACD,IAAI,EAAE,OAAOD,OAAO,CAAC,IAAI,CAAC;MAC/BC,IAAI,CAACE,eAAe,CAAC,CAACC,EAAE,EAAEC,CAAC,EAAEC,EAAE,EAAEC,MAAM,KAAKP,OAAO,CAAC;QAAEK,CAAC;QAAEE;MAAO,CAAC,CAAC,CAAC;IACrE,CAAC;EACL,CAAC,CAAC,CAACL,OAAO;EAEV,OAAOX,OAAO,CACZ,OAAO;IACLiB,KAAK,EAAEA,CAAA,KAAMZ,IAAI,EAAEY,KAAK,CAACX,KAAK,CAAC;IAC/BY,IAAI,EAAEA,CAAA,KAAMb,IAAI,EAAEa,IAAI,CAACZ,KAAK;EAC9B,CAAC,CAAC,EACF,CAACD,IAAI,EAAEC,KAAK,CACd,CAAC;AACH","ignoreList":[]}

package/lib/module/theme/useReduceMotion.js

@@ -0,0 +1,28 @@
+"use strict";
+
+import { useEffect, useState } from 'react';
+import { AccessibilityInfo } from 'react-native';
+
+/**
+ * Follows the system "reduce motion" setting: when it is on, animations jump
+ * to their final state instead of being disabled, so callbacks and unmounting
+ * still happen the same way.
+ */
+export function useReduceMotion() {
+  const [reduceMotion, setReduceMotion] = useState(false);
+  useEffect(() => {
+    let alive = true;
+    // The state is only updated if the setting is on: the initial value is
+    // already `false` and a setState from false to false would cost a render per mount.
+    AccessibilityInfo.isReduceMotionEnabled().then(enabled => {
+      if (alive && enabled) setReduceMotion(true);
+    });
+    const sub = AccessibilityInfo.addEventListener('reduceMotionChanged', setReduceMotion);
+    return () => {
+      alive = false;
+      sub.remove();
+    };
+  }, []);
+  return reduceMotion;
+}
+//# sourceMappingURL=useReduceMotion.js.map

package/lib/module/theme/useReduceMotion.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useState","AccessibilityInfo","useReduceMotion","reduceMotion","setReduceMotion","alive","isReduceMotionEnabled","then","enabled","sub","addEventListener","remove"],"sourceRoot":"../../../src","sources":["theme/useReduceMotion.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,QAAQ,QAAQ,OAAO;AAC3C,SAASC,iBAAiB,QAAQ,cAAc;;AAEhD;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAAA,EAAY;EACzC,MAAM,CAACC,YAAY,EAAEC,eAAe,CAAC,GAAGJ,QAAQ,CAAC,KAAK,CAAC;EAEvDD,SAAS,CAAC,MAAM;IACd,IAAIM,KAAK,GAAG,IAAI;IAChB;IACA;IACAJ,iBAAiB,CAACK,qBAAqB,CAAC,CAAC,CAACC,IAAI,CAAEC,OAAO,IAAK;MAC1D,IAAIH,KAAK,IAAIG,OAAO,EAAEJ,eAAe,CAAC,IAAI,CAAC;IAC7C,CAAC,CAAC;IACF,MAAMK,GAAG,GAAGR,iBAAiB,CAACS,gBAAgB,CAAC,qBAAqB,EAAEN,eAAe,CAAC;IACtF,OAAO,MAAM;MACXC,KAAK,GAAG,KAAK;MACbI,GAAG,CAACE,MAAM,CAAC,CAAC;IACd,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOR,YAAY;AACrB","ignoreList":[]}

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

@@ -1,15 +1,45 @@
 import React from 'react';
-import { type StyleProp, type ViewStyle } from 'react-native';
+import { type ImageSourcePropType, type StyleProp, type ViewStyle } from 'react-native';
+import type { IconName } from '../icons/types';
 export interface AvatarProps {
+    /** Diameter in pt. @default 44 */
     size?: number;
+    /** Photo. If it fails to load, falls back to the initials of `name` (or the icon). */
+    source?: ImageSourcePropType;
+    /** Person's name: produces the initials and the accessible name. */
+    name?: string;
+    /** Icon shown when there is no photo or name. @default 'user' */
+    iconName?: IconName;
+    /** Fill of the circle. @default colors.primarySoft */
     backgroundColor?: string;
-    children: React.ReactNode;
+    /** Color of the initials and icon. @default colors.primaryText */
+    color?: string;
+    /** Custom content; takes precedence over source/name/iconName. */
+    children?: React.ReactNode;
+    /** Accessible name. Without it (and without `name`) the avatar is decorative. @default name */
+    accessibilityLabel?: string;
     style?: StyleProp<ViewStyle>;
+    testID?: string;
 }
+/** "Ada Lovelace" → "AL", "ada" → "A", "  " → "". Handles characters outside the BMP. */
+export declare function initialsOf(name: string): string;
 /**
  * Avatar
- * Círculo con ícono/iniciales adentro. Usado a la izquierda de filas de
- * lista o como header de detalle (junto a AvatarHeader).
+ * Circle with a photo, initials or an icon. Used on the left of list rows
+ * or as a detail header (alongside AvatarHeader).
+ *
+ * Priority: `children` → `source` (if it loads) → initials of `name` →
+ * `iconName` → `user` icon. A broken photo doesn't leave an empty circle: it
+ * falls back to the initials.
+ *
+ * Gestalt:
+ * - Similarity: all avatars in a list share shape and size, so a column of
+ *   people scans as a series even when it mixes photos, initials and icons.
+ * - Closure: the circle clips the photo (overflow hidden); initials and the
+ *   icon scale with `size` so the content always stays inside.
+ *
+ * Accessibility: with `name` (or `accessibilityLabel`) it announces itself as
+ * an image with that name; with neither it is decorative.
  */
-export declare const Avatar: React.MemoExoticComponent<({ size, backgroundColor, children, style }: AvatarProps) => React.JSX.Element>;
+export declare const Avatar: React.MemoExoticComponent<({ size, source, name, iconName, backgroundColor, color, children, accessibilityLabel, style, testID, }: AvatarProps) => React.JSX.Element>;
 //# sourceMappingURL=Avatar.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../../../src/atoms/Avatar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAoB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGhF,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B;AAMD;;;;GAIG;AACH,eAAO,MAAM,MAAM,yEAA0D,WAAW,uBAkBtF,CAAC"}
+{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../../../src/atoms/Avatar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyB,MAAM,OAAO,CAAC;AAC9C,OAAO,EAKL,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,+FAA+F;IAC/F,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,MAAM,qIAYd,WAAW,uBAmDf,CAAC"}

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

@@ -2,18 +2,29 @@ import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 export type BadgeVariant = 'success' | 'error' | 'warning' | 'info' | 'neutral';
 export interface BadgeProps {
+    /** Text of the pill, on a single line (truncated with "…"). */
     label: string;
+    /** Semantic color set: success, error, warning, info or neutral. @default 'neutral' */
     variant?: BadgeVariant;
     /** Manual override, takes precedence over `variant`. */
     backgroundColor?: string;
+    /** Manual text color, takes precedence over `variant`. */
     textColor?: string;
     style?: StyleProp<ViewStyle>;
 }
 /**
  * Badge
- * Pill de estado. `variant` cubre los casos comunes (éxito/error/advertencia/
- * info/neutral); `backgroundColor`/`textColor` quedan para casos que no
- * encajan en el set semántico.
+ * Status pill. `variant` covers the common cases (success/error/warning/
+ * info/neutral); `backgroundColor`/`textColor` are for cases that don't
+ * fit the semantic set.
+ *
+ * Gestalt, similarity: all badges share shape, size and typography; only
+ * the color changes, and it changes by meaning (green = ok, red = error…),
+ * so a column of statuses scans at a glance. The meaning also goes in the
+ * text: never rely on color alone (color blindness).
+ * Every `*Soft`/`*Text` pair in the theme meets WCAG AA in light and dark;
+ * with custom colors, contrast is up to whoever passes them.
+ * A single line: a long label is truncated with "…" instead of deforming the pill.
  */
 export declare const Badge: React.MemoExoticComponent<({ label, variant, backgroundColor, textColor, style }: BadgeProps) => React.JSX.Element>;
 //# sourceMappingURL=Badge.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../../src/atoms/Badge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI1E,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAEhF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B;AAYD;;;;;GAKG;AACH,eAAO,MAAM,KAAK,oFAA4E,UAAU,uBAuBtG,CAAC"}
+{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../../src/atoms/Badge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AACpC,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI1E,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAEhF,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B;AAYD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,KAAK,oFAA4E,UAAU,uBAuBtG,CAAC"}

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

@@ -4,27 +4,58 @@ import type { IconName } from '../icons/types';
 export type ButtonVariant = 'primary' | 'secondary' | 'outline' | 'ghost' | 'link' | 'destructive';
 export type ButtonSize = 'sm' | 'md' | 'lg';
 export interface ButtonProps {
+    /** Visible label. Also the accessible name unless `accessibilityLabel` is set. */
     title: string;
+    /** Called on press. Not called while `disabled` or `loading`. */
     onPress: (e: GestureResponderEvent) => void;
+    /**
+     * Semantic style: `primary` is the filled focal action; the others step the visual weight down.
+     * @default 'primary'
+     */
     variant?: ButtonVariant;
+    /** Density: padding and font size. `sm` gets extra touch area through `hitSlop`. @default 'md' */
     size?: ButtonSize;
+    /** Shows a spinner over the hidden label (the width doesn't change) and blocks presses. @default false */
     loading?: boolean;
+    /** Paints the disabled colors and ignores presses. @default false */
     disabled?: boolean;
     style?: StyleProp<ViewStyle>;
+    /** Extra style for the label text. */
     textStyle?: StyleProp<TextStyle>;
+    /** Custom node to the left of the label. Takes precedence over `leftIconName`. */
     leftIcon?: React.ReactNode;
+    /** Custom node to the right of the label. Takes precedence over `rightIconName`. */
     rightIcon?: React.ReactNode;
+    /** Icon from the library's set to the left of the label, sized to match `size`. */
     leftIconName?: IconName;
+    /** Icon from the library's set to the right of the label, sized to match `size`. */
     rightIconName?: IconName;
+    /** Color of `leftIconName`/`rightIconName`. Defaults to the label color of the variant. */
     iconColor?: string;
     testID?: string;
+    /** What screen readers announce. @default title */
     accessibilityLabel?: string;
 }
 /**
  * Button
- * Único componente de botón de la librería. `variant` decide el estilo
- * semántico, `size` la densidad. El feedback de "presionado" anima solo
- * `transform` (Animated.spring, useNativeDriver) — nunca opacity ni layout.
+ * The library's only button component. `variant` sets the semantic style,
+ * `size` the density. The "pressed" feedback animates only `transform`
+ * (Animated.spring, useNativeDriver) — never opacity or layout — and is
+ * skipped when Reduce Motion is on.
+ *
+ * Gestalt:
+ * - Focal point (Von Restorff): `primary` is the only one filled with the
+ *   accent and a shadow; there should be one per screen or group. The other
+ *   variants step the visual weight down (secondary → outline → ghost → link).
+ * - Similarity: all variants share shape, radius and typography, so a row of
+ *   buttons reads as a single group of actions; only what conveys the
+ *   hierarchy changes (fill, border, color).
+ * - Proximity: icon and label sit `spacing.sm` apart, much less than the
+ *   padding, so they read as a single label.
+ *
+ * Fitts: `sm` and `link` are less than 44pt tall and make up for it with `hitSlop`.
+ * While `loading`, the label is invisible but keeps its space: the button
+ * doesn't change width (no layout jumps).
  */
 export declare const Button: React.MemoExoticComponent<({ title, onPress, variant, size, loading, disabled, style, textStyle, leftIcon, rightIcon, leftIconName, rightIconName, iconColor, testID, accessibilityLabel, }: ButtonProps) => React.JSX.Element>;
 //# sourceMappingURL=Button.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/atoms/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuB,MAAM,OAAO,CAAC;AAC5C,OAAO,EAKL,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC;AACnG,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAgDD;;;;;GAKG;AACH,eAAO,MAAM,MAAM,+LAiBd,WAAW,uBA8Ef,CAAC"}
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/atoms/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuB,MAAM,OAAO,CAAC;AAC5C,OAAO,EAOL,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAKtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC;AACnG,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,OAAO,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC5C;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,kGAAkG;IAClG,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,0GAA0G;IAC1G,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,sCAAsC;IACtC,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACjC,kFAAkF;IAClF,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,oFAAoF;IACpF,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,mFAAmF;IACnF,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,oFAAoF;IACpF,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAsED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,MAAM,+LAiBd,WAAW,uBA8Ff,CAAC"}