orn-ui 0.2.9 → 0.3.0

package/src/atoms/inputValidation.ts

@@ -0,0 +1,59 @@
+import type { Labels } from '../theme/labels';
+
+/** A rule's value, optionally with its own message instead of the default label. */
+export type InputRuleValue<T> = T | { value: T; message: string };
+
+export interface InputRules {
+  /** Fewer characters than this is an error. Message: `labels.minLengthError`. */
+  minLength?: InputRuleValue<number>;
+  /** More characters than this is an error. Message: `labels.maxLengthError`. */
+  maxLength?: InputRuleValue<number>;
+  /** The value must match. Message: `labels.patternError`. */
+  pattern?: InputRuleValue<RegExp>;
+  /**
+   * Custom check, run last. Return an error message, or `false` for
+   * `labels.patternError`; anything else means valid.
+   */
+  validate?: (value: string) => string | boolean | null | undefined;
+}
+
+function unpack<T>(rule: InputRuleValue<T>): { value: T; message?: string } {
+  return typeof rule === 'object' && rule !== null && 'value' in rule && 'message' in rule
+    ? (rule as { value: T; message: string })
+    : { value: rule as T };
+}
+
+/**
+ * Error for the value, or undefined if it is valid. Order: required, min
+ * length, max length, pattern, custom validation — a single error is shown,
+ * the first one. An empty optional field is valid: the other rules don't run on nothing.
+ */
+export function validateInputValue(
+  value: string,
+  { required, rules }: { required?: boolean; rules?: InputRules },
+  labels: Labels
+): string | undefined {
+  if (value.trim() === '') return required ? labels.requiredError : undefined;
+  if (!rules) return undefined;
+
+  if (rules.minLength !== undefined) {
+    const { value: n, message } = unpack(rules.minLength);
+    if (value.length < n) return message ?? labels.minLengthError.replace('{n}', String(n));
+  }
+  if (rules.maxLength !== undefined) {
+    const { value: n, message } = unpack(rules.maxLength);
+    if (value.length > n) return message ?? labels.maxLengthError.replace('{n}', String(n));
+  }
+  if (rules.pattern !== undefined) {
+    const { value: re, message } = unpack(rules.pattern);
+    // A RegExp with the `g` flag keeps lastIndex between calls: reset it.
+    re.lastIndex = 0;
+    if (!re.test(value)) return message ?? labels.patternError;
+  }
+  if (rules.validate) {
+    const result = rules.validate(value);
+    if (typeof result === 'string' && result !== '') return result;
+    if (result === false) return labels.patternError;
+  }
+  return undefined;
+}

package/src/icons/Icon.tsx

@@ -12,10 +12,10 @@ export interface IconProps {
 
 /**
  * Icon
- * Resuelve el glifo vía el renderer activo (UIProvider.icons, default zero-dep
- * si no se configuró ninguno). Uso interno de la librería — los componentes
- * públicos exponen `icon?: ReactNode` además de esto, para que el consumidor
- * pueda inyectar cualquier ícono sin pasar por el sistema de nombres.
+ * Resolves the glyph through the active renderer (UIProvider.icons, the
+ * zero-dep default if none was configured). Internal use by the library —
+ * public components expose `icon?: ReactNode` in addition to this, so the
+ * consumer can inject any icon without going through the name system.
  */
 export const Icon = memo(({ name, size = 20, color, style }: IconProps) => {
   const colors = useColors();

package/src/icons/defaultIcons.tsx

@@ -1,15 +1,38 @@
 import React, { memo } from 'react';
 import { Text, View } from 'react-native';
-import type { IconName, IconRenderProps } from './types';
+import type { BuiltInIconName, IconName, IconRenderProps } from './types';
 
 /**
- * Glifos default dibujados con primitivas de RN (View + border + transform).
- * Cero dependencias, cero fuentes, cero carga asíncrona. Cubren únicamente
- * lo que la librería necesita internamente (checkbox, chevrons de Select,
- * toggle de password en Input, etc). Para íconos de producto, el consumidor
- * inyecta su propio set vía <UIProvider icons={...}> o la prop `icon`.
+ * Default glyphs drawn with RN primitives (View + border + transform).
+ * Zero dependencies, zero fonts, zero async loading. They cover what the
+ * library needs internally (checkbox, Select chevrons, password toggle in
+ * Input, etc) plus a basic set for apps (menu, home, user…).
+ * For a complete set, the consumer injects their own via
+ * <UIProvider icons={...}> or the `icon` prop.
  */
 
+/**
+ * Color of the inner glyph of a filled icon (alert, warning): black or
+ * white depending on the fill's luminance. A fixed white disappeared over
+ * dark mode's light fills (figure and ground). Non-hex colors (rgb(),
+ * names) fall back to white, the common case over saturated accents.
+ */
+export function onColor(fill: string): string {
+  const hex = fill.trim().replace('#', '');
+  const full = hex.length === 3 ? hex.split('').map((c) => c + c).join('') : hex.slice(0, 6);
+  if (!/^[0-9a-fA-F]{6}$/.test(full)) return '#fff';
+  const channel = (i: number) => {
+    const c = parseInt(full.slice(i, i + 2), 16) / 255;
+    return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+  };
+  const r = channel(0);
+  const g = channel(2);
+  const b = channel(4);
+  const luminance = 0.2126 * r + 0.7152 * g + 0.0722 * b;
+  // Threshold where contrast with black exceeds contrast with white.
+  return luminance > 0.179 ? '#000' : '#fff';
+}
+
 const Chevron = memo(({ size, color, direction }: IconRenderProps & { direction: 'up' | 'down' | 'left' | 'right' }) => {
   const strokeWidth = Math.max(1.5, size / 12);
   const arm = size * 0.32;
@@ -116,13 +139,13 @@ const PlusMinus = memo(({ size, color, minusOnly }: IconRenderProps & { minusOnl
 PlusMinus.displayName = 'PlusMinus';
 
 /**
- * Círculo con un glifo tipográfico adentro (!, i, ?).
+ * Circle with a typographic glyph inside (!, i, ?).
  *
- * Usa <Text> con la fuente del sistema en vez de componer el glifo con
- * Views: sigue siendo cero-dependencias (no carga ninguna fuente), y "i" vs
- * "!" vs "?" quedan inequívocos. Dibujarlos con barras y puntos daba un
- * "info" idéntico a un "!" invertido, que es exactamente lo que un ícono de
- * información no debe comunicar.
+ * Uses <Text> with the system font instead of composing the glyph from
+ * Views: it is still zero-dependency (it loads no font), and "i" vs "!" vs
+ * "?" stay unambiguous. Drawing them with bars and dots gave an "info"
+ * identical to an inverted "!", which is exactly what an information icon
+ * must not convey.
  */
 const Circle = memo(
   ({ size, color, filled, label }: IconRenderProps & { filled?: boolean; label?: string }) => {
@@ -144,7 +167,7 @@ const Circle = memo(
           <Text
             allowFontScaling={false}
             style={{
-              color: filled ? '#fff' : color,
+              color: filled ? onColor(color) : color,
               fontSize: size * 0.62,
               lineHeight: size * 0.74,
               fontWeight: '700',
@@ -207,17 +230,17 @@ Eye.displayName = 'Eye';
 
 const Search = memo(({ size, color }: IconRenderProps) => {
   const strokeWidth = Math.max(1.5, size / 9);
-  // Lente grande (72% del alto) arriba-izquierda y mango corto saliendo de su
-  // borde inferior-derecho sobre la diagonal de 45°. Las proporciones importan
-  // a tamaños chicos (16-20px): con un lente chico y mango largo el glifo se
-  // lee como una coma, no como una lupa.
+  // Large lens (72% of the height) at the top-left and a short handle coming
+  // out of its bottom-right edge along the 45° diagonal. The proportions matter
+  // at small sizes (16-20px): with a small lens and a long handle the glyph
+  // reads as a comma, not a magnifying glass.
   const lensD = size * 0.72;
   const lensR = lensD / 2;
   const handleLen = size * 0.34;
   const diag = Math.SQRT1_2; // cos(45°) === sin(45°)
-  // El mango se centra sobre la diagonal, arrancando justo en el borde del
-  // lente: distancia = radio + mitad del mango, menos un solapamiento de
-  // medio trazo para que no quede un hueco entre borde y mango.
+  // The handle is centered on the diagonal, starting right at the lens's
+  // edge: distance = radius + half the handle, minus a half-stroke overlap
+  // so no gap is left between edge and handle.
   const dist = lensR + handleLen / 2 - strokeWidth / 2;
   const cx = lensR + dist * diag;
   const cy = lensR + dist * diag;
@@ -253,7 +276,379 @@ const Search = memo(({ size, color }: IconRenderProps) => {
 });
 Search.displayName = 'Search';
 
-/** Renderer default. Se usa cuando <UIProvider icons={...}> no pasa uno propio. */
+// ── Basic set for apps ─────────────────────────────────────────────────────
+// Same rules as the rest: only View/Text, stroke proportional to the size
+// (`size / 10`, minimum 1.5) and a square `size` box, so they all line up
+// the same way in a row (Gestalt, similarity).
+
+const stroke = (size: number) => Math.max(1.5, size / 10);
+const box = (size: number) => ({ width: size, height: size, alignItems: 'center' as const, justifyContent: 'center' as const });
+
+const Menu = memo(({ size, color }: IconRenderProps) => {
+  const sw = stroke(size);
+  const bar = { width: size * 0.7, height: sw, borderRadius: sw / 2, backgroundColor: color };
+  return (
+    <View style={[box(size), { gap: size * 0.16 }]}>
+      <View style={bar} />
+      <View style={bar} />
+      <View style={bar} />
+    </View>
+  );
+});
+Menu.displayName = 'Menu';
+
+const Scan = memo(({ size, color }: IconRenderProps) => {
+  const sw = stroke(size);
+  const arm = size * 0.26;
+  const inset = size * 0.1;
+  const corner = (v: 'top' | 'bottom', h: 'left' | 'right') => ({
+    position: 'absolute' as const,
+    [v]: inset,
+    [h]: inset,
+    width: arm,
+    height: arm,
+    borderColor: color,
+    [v === 'top' ? 'borderTopWidth' : 'borderBottomWidth']: sw,
+    [h === 'left' ? 'borderLeftWidth' : 'borderRightWidth']: sw,
+  });
+  return (
+    <View style={box(size)}>
+      {/* Viewfinder: four corner brackets and the scan line across the middle. */}
+      <View style={corner('top', 'left')} />
+      <View style={corner('top', 'right')} />
+      <View style={corner('bottom', 'left')} />
+      <View style={corner('bottom', 'right')} />
+      <View style={{ width: size * 0.6, height: sw, borderRadius: sw / 2, backgroundColor: color }} />
+    </View>
+  );
+});
+Scan.displayName = 'Scan';
+
+const More = memo(({ size, color }: IconRenderProps) => {
+  const d = Math.max(3, size * 0.16);
+  const dot = { width: d, height: d, borderRadius: d / 2, backgroundColor: color };
+  return (
+    <View style={[box(size), { flexDirection: 'row', gap: size * 0.12 }]}>
+      <View style={dot} />
+      <View style={dot} />
+      <View style={dot} />
+    </View>
+  );
+});
+More.displayName = 'More';
+
+const Home = memo(({ size, color }: IconRenderProps) => {
+  const sw = stroke(size);
+  const roof = size * 0.5;
+  return (
+    <View style={box(size)}>
+      {/* Roof: a square with two borders, rotated 45°. */}
+      <View
+        style={{
+          position: 'absolute',
+          top: size * 0.14,
+          width: roof,
+          height: roof,
+          borderTopWidth: sw,
+          borderLeftWidth: sw,
+          borderColor: color,
+          transform: [{ rotate: '45deg' }],
+        }}
+      />
+      {/* Body: walls and floor. */}
+      <View
+        style={{
+          position: 'absolute',
+          bottom: size * 0.12,
+          width: size * 0.56,
+          height: size * 0.4,
+          borderLeftWidth: sw,
+          borderRightWidth: sw,
+          borderBottomWidth: sw,
+          borderColor: color,
+        }}
+      />
+    </View>
+  );
+});
+Home.displayName = 'Home';
+
+const Settings = memo(({ size, color }: IconRenderProps) => {
+  const sw = stroke(size);
+  const ring = size * 0.5;
+  const tooth = { width: size * 0.16, height: size * 0.2, backgroundColor: color, borderRadius: sw / 2 };
+  return (
+    <View style={box(size)}>
+      {[0, 45, 90, 135, 180, 225, 270, 315].map((deg) => (
+        <View key={deg} style={[box(size), { position: 'absolute', transform: [{ rotate: `${deg}deg` }] }]}>
+          <View style={[tooth, { position: 'absolute', top: size * 0.08 }]} />
+        </View>
+      ))}
+      <View style={{ width: ring, height: ring, borderRadius: ring / 2, borderWidth: sw * 1.6, borderColor: color }} />
+    </View>
+  );
+});
+Settings.displayName = 'Settings';
+
+const User = memo(({ size, color }: IconRenderProps) => {
+  const sw = stroke(size);
+  const head = size * 0.38;
+  return (
+    <View style={box(size)}>
+      <View
+        style={{
+          position: 'absolute',
+          top: size * 0.08,
+          width: head,
+          height: head,
+          borderRadius: head / 2,
+          borderWidth: sw,
+          borderColor: color,
+        }}
+      />
+      {/* Shoulders: half an ellipse open at the bottom. */}
+      <View
+        style={{
+          position: 'absolute',
+          bottom: size * 0.08,
+          width: size * 0.74,
+          height: size * 0.34,
+          borderTopLeftRadius: size * 0.37,
+          borderTopRightRadius: size * 0.37,
+          borderTopWidth: sw,
+          borderLeftWidth: sw,
+          borderRightWidth: sw,
+          borderColor: color,
+        }}
+      />
+    </View>
+  );
+});
+User.displayName = 'User';
+
+const Trash = memo(({ size, color }: IconRenderProps) => {
+  const sw = stroke(size);
+  const bodyW = size * 0.52;
+  const bodyH = size * 0.56;
+  return (
+    <View style={box(size)}>
+      {/* Handle and lid. */}
+      <View
+        style={{
+          position: 'absolute',
+          top: size * 0.08,
+          width: size * 0.26,
+          height: size * 0.12,
+          borderTopWidth: sw,
+          borderLeftWidth: sw,
+          borderRightWidth: sw,
+          borderColor: color,
+        }}
+      />
+      <View
+        style={{
+          position: 'absolute',
+          top: size * 0.19,
+          width: size * 0.72,
+          height: sw,
+          borderRadius: sw / 2,
+          backgroundColor: color,
+        }}
+      />
+      {/* Body with two slots. */}
+      <View
+        style={{
+          position: 'absolute',
+          bottom: size * 0.08,
+          width: bodyW,
+          height: bodyH,
+          borderLeftWidth: sw,
+          borderRightWidth: sw,
+          borderBottomWidth: sw,
+          borderBottomLeftRadius: sw * 1.5,
+          borderBottomRightRadius: sw * 1.5,
+          borderColor: color,
+          flexDirection: 'row',
+          justifyContent: 'center',
+          alignItems: 'center',
+          gap: bodyW * 0.22,
+        }}
+      >
+        <View style={{ width: sw * 0.8, height: bodyH * 0.55, backgroundColor: color, borderRadius: sw / 2 }} />
+        <View style={{ width: sw * 0.8, height: bodyH * 0.55, backgroundColor: color, borderRadius: sw / 2 }} />
+      </View>
+    </View>
+  );
+});
+Trash.displayName = 'Trash';
+
+const Edit = memo(({ size, color }: IconRenderProps) => {
+  const sw = stroke(size);
+  return (
+    <View style={box(size)}>
+      {/* Pencil: outlined body, rotated 45°, with the tip pointing down-left. */}
+      <View style={{ alignItems: 'center', transform: [{ rotate: '45deg' }, { translateY: -size * 0.02 }] }}>
+        <View
+          style={{
+            width: size * 0.3,
+            height: size * 0.66,
+            borderWidth: sw,
+            borderColor: color,
+            borderTopLeftRadius: sw,
+            borderTopRightRadius: sw,
+          }}
+        />
+        <View
+          style={{
+            width: 0,
+            height: 0,
+            borderLeftWidth: size * 0.15,
+            borderRightWidth: size * 0.15,
+            borderTopWidth: size * 0.22,
+            borderLeftColor: 'transparent',
+            borderRightColor: 'transparent',
+            borderTopColor: color,
+          }}
+        />
+      </View>
+    </View>
+  );
+});
+Edit.displayName = 'Edit';
+
+const Share = memo(({ size, color }: IconRenderProps) => {
+  const sw = stroke(size);
+  const arm = size * 0.26;
+  return (
+    <View style={box(size)}>
+      {/* Box open at the top. */}
+      <View
+        style={{
+          position: 'absolute',
+          bottom: size * 0.08,
+          width: size * 0.64,
+          height: size * 0.42,
+          borderLeftWidth: sw,
+          borderRightWidth: sw,
+          borderBottomWidth: sw,
+          borderBottomLeftRadius: sw * 1.5,
+          borderBottomRightRadius: sw * 1.5,
+          borderColor: color,
+        }}
+      />
+      {/* Arrow pointing up, coming out of the box. */}
+      <View
+        style={{
+          position: 'absolute',
+          top: size * 0.1,
+          width: sw,
+          height: size * 0.56,
+          backgroundColor: color,
+          borderRadius: sw / 2,
+        }}
+      />
+      <View
+        style={{
+          position: 'absolute',
+          top: size * 0.12,
+          width: arm,
+          height: arm,
+          borderTopWidth: sw,
+          borderLeftWidth: sw,
+          borderColor: color,
+          transform: [{ rotate: '45deg' }],
+        }}
+      />
+    </View>
+  );
+});
+Share.displayName = 'Share';
+
+const Heart = memo(({ size, color }: IconRenderProps) => {
+  // Two circles over a square rotated 45°: the classic shape, filled.
+  const s = size * 0.46;
+  const lobe = { position: 'absolute' as const, width: s, height: s, borderRadius: s / 2, backgroundColor: color };
+  return (
+    <View style={box(size)}>
+      <View style={{ width: s, height: s, transform: [{ translateY: size * 0.05 }, { rotate: '45deg' }] }}>
+        <View style={{ position: 'absolute', width: s, height: s, backgroundColor: color }} />
+        <View style={[lobe, { left: -s / 2 }]} />
+        <View style={[lobe, { top: -s / 2 }]} />
+      </View>
+    </View>
+  );
+});
+Heart.displayName = 'Heart';
+
+/**
+ * Star: typographic glyph (★, U+2605) like Circle's. A five-pointed star
+ * can't be composed well from rectangles; the variation selector U+FE0E
+ * forces the text version (monochrome, in the requested color) instead of
+ * the emoji.
+ */
+const Star = memo(({ size, color }: IconRenderProps) => (
+  <View style={box(size)}>
+    <Text
+      allowFontScaling={false}
+      style={{ color, fontSize: size * 0.95, lineHeight: size, textAlign: 'center', includeFontPadding: false }}
+    >
+      {'\u2605\uFE0E'}
+    </Text>
+  </View>
+));
+Star.displayName = 'Star';
+
+/**
+ * Warning: filled triangle with a "!" (not a circle like `alert`), so that
+ * warning and error aren't told apart by color alone.
+ */
+const WarningTriangle = memo(({ size, color }: IconRenderProps) => {
+  const half = size * 0.5;
+  const height = size * 0.88;
+  return (
+    <View style={box(size)}>
+      <View
+        style={{
+          width: 0,
+          height: 0,
+          borderLeftWidth: half,
+          borderRightWidth: half,
+          borderBottomWidth: height,
+          borderLeftColor: 'transparent',
+          borderRightColor: 'transparent',
+          borderBottomColor: color,
+        }}
+      />
+      <Text
+        allowFontScaling={false}
+        style={{
+          position: 'absolute',
+          bottom: size * 0.06,
+          color: onColor(color),
+          fontSize: size * 0.58,
+          lineHeight: size * 0.66,
+          fontWeight: '700',
+          textAlign: 'center',
+          includeFontPadding: false,
+        }}
+      >
+        !
+      </Text>
+    </View>
+  );
+});
+WarningTriangle.displayName = 'WarningTriangle';
+
+const warned = new Set<string>();
+
+/** All included glyphs, in catalog order. */
+export const BUILT_IN_ICON_NAMES: readonly BuiltInIconName[] = [
+  'check', 'close', 'plus', 'minus', 'search', 'scan', 'menu', 'more', 'home', 'settings', 'user',
+  'trash', 'edit', 'share', 'heart', 'star', 'eye', 'eye-off',
+  'chevron-left', 'chevron-right', 'chevron-up', 'chevron-down', 'alert', 'warning', 'info', 'question',
+];
+
+/** Default renderer. Used when <UIProvider icons={...}> doesn't pass its own. */
 export function renderDefaultIcon(name: IconName, props: IconRenderProps): React.ReactNode {
   switch (name) {
     case 'check':
@@ -274,6 +669,8 @@ export function renderDefaultIcon(name: IconName, props: IconRenderProps): React
       return <Eye {...props} off />;
     case 'search':
       return <Search {...props} />;
+    case 'scan':
+      return <Scan {...props} />;
     case 'plus':
       return <PlusMinus {...props} />;
     case 'minus':
@@ -283,10 +680,36 @@ export function renderDefaultIcon(name: IconName, props: IconRenderProps): React
     case 'info':
       return <Circle {...props} label="i" />;
     case 'warning':
-      return <Circle {...props} filled label="!" />;
+      return <WarningTriangle {...props} />;
     case 'question':
       return <Circle {...props} label="?" />;
+    case 'menu':
+      return <Menu {...props} />;
+    case 'more':
+      return <More {...props} />;
+    case 'home':
+      return <Home {...props} />;
+    case 'settings':
+      return <Settings {...props} />;
+    case 'user':
+      return <User {...props} />;
+    case 'trash':
+      return <Trash {...props} />;
+    case 'edit':
+      return <Edit {...props} />;
+    case 'share':
+      return <Share {...props} />;
+    case 'heart':
+      return <Heart {...props} />;
+    case 'star':
+      return <Star {...props} />;
     default:
+      // A name outside the included set only makes sense with a custom
+      // renderer (<UIProvider icons>). Without one there is no glyph: warn once.
+      if (typeof __DEV__ !== 'undefined' && __DEV__ && !warned.has(name)) {
+        warned.add(name);
+        console.warn(`orn-ui: no built-in icon named "${name}". Pass <UIProvider icons={...}> to render custom names.`);
+      }
       return null;
   }
 }

package/src/icons/index.ts

@@ -1,4 +1,4 @@
 export { Icon } from './Icon';
 export type { IconProps } from './Icon';
-export { renderDefaultIcon } from './defaultIcons';
-export type { IconName, IconRenderer, IconRenderProps } from './types';
+export { renderDefaultIcon, BUILT_IN_ICON_NAMES } from './defaultIcons';
+export type { BuiltInIconName, IconName, IconRenderer, IconRenderProps } from './types';

package/src/icons/types.ts

@@ -1,7 +1,10 @@
 import type { ReactNode } from 'react';
 
-/** Glifos que los componentes de la librería necesitan internamente. */
-export type IconName =
+/**
+ * Included glyphs (drawn with RN primitives, zero dependencies): the ones
+ * the library uses internally plus a basic set for apps.
+ */
+export type BuiltInIconName =
   | 'check'
   | 'close'
   | 'chevron-down'
@@ -11,17 +14,36 @@ export type IconName =
   | 'eye'
   | 'eye-off'
   | 'search'
+  | 'scan'
   | 'plus'
   | 'minus'
   | 'alert'
   | 'info'
   | 'warning'
-  | 'question';
+  | 'question'
+  | 'menu'
+  | 'more'
+  | 'home'
+  | 'settings'
+  | 'user'
+  | 'trash'
+  | 'edit'
+  | 'share'
+  | 'heart'
+  | 'star';
+
+/**
+ * Icon name accepted by `iconName`, `leftIconName`, etc. Autocompletes the
+ * included ones and also accepts any string, for those who plug in their own
+ * set with `<UIProvider icons={...}>` (e.g. `iconName="calendar"`). A name
+ * the active renderer doesn't know draws nothing (and warns in development).
+ */
+export type IconName = BuiltInIconName | (string & {});
 
 export interface IconRenderProps {
   size: number;
   color: string;
 }
 
-/** Renderer inyectable: reemplaza los glifos default por los de cualquier set de iconos. */
+/** Injectable renderer: replaces the default glyphs with those of any icon set. */
 export type IconRenderer = (name: IconName, props: IconRenderProps) => ReactNode;