@acvl/mobile-components 0.0.0-stage → 0.0.2

package/README.md

@@ -1,3 +1,148 @@
-# Temporary Holding Version
+# @acvl/mobile-components
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+La librería de componentes de las apps móviles de ACV (Expo / React Native): tms, wms y suma. Es el
+equivalente de [`@acvl/frontend-components`](https://github.com/ACV-Logistics/acv-frontend-components)
+para las apps: lo que se ve igual en todas vive aquí, y cada app pone sólo lo suyo (su API, su
+dominio).
+
+El punto de partida es la app de tms, la más reciente. Su diseño es para quien usa la app de pie y
+con prisa: **letra grande** (nada por debajo de `tipografia.etiqueta`), nada importante recortado a
+un renglón, y todo listo para la letra del teléfono al 180%.
+
+## Qué trae
+
+| Área            | Qué                                                                                                                                                                              |
+| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Tema**        | `ProveedorDeTema`, `usePreferenciaDeTema`, `PALETA_CLARA`/`PALETA_OSCURA`, `usePaleta`, `crearEstilos`, `useEsOscuro`, `tipografia`, `renglon`, `Text`, `TextInput`              |
+| **Componentes** | `BotonGrande`, `Chip` (con su tono `morado`), `EstadoVacio`, `IconoDeRenglon`, `Nota`, `OpcionesExcluyentes`, `Pestanas`, `Rotulo`, `RotuloDeSeccion` (con su `accion`), `Tarjeta`, `TarjetaDeDatos`, `Logo`, `LogoCompleto`, `ContenidoDePantalla` |
+| **Navegación**  | `useOpcionesDelEncabezado` (el header de las pestañas), `BarraDePestanas`, `CabeceraEmpujada`, `AccionesDelEncabezado` (con `insignia`), `BotonDeAvatar`                                          |
+| **Diálogos**    | `mostrarDialogo`, `confirmar`, `avisar` y su `HostDeDialogos`                                                                                                                    |
+| **Formularios** | `CampoDeTexto`, `CampoDeFecha`, `CampoDeFechaHora`, `CampoInterruptor`, `CampoDeOpciones`, `CampoDeTelefono`, `CampoDeSeleccion` (del servidor o de una lista fija), `CampoDeVarias`, `SelectorDeOpcion`, `SelectorDeVarias`, `Campo` (el marco de un campo propio), sus `…Controlado` de react-hook-form, `TextoDeAccesoControlado` (el login), `useGuardado`, `soloLoQueCambio`, `mensajeDeError`, `setErrors`, `useBusqueda` |
+| **Listas y fichas** | `ListaPaginada` (con `Pagina` y `renglonesDe`), `CabeceraDeLista`, `Buscador`, `TarjetaDeLista`, `TarjetaDeslizable`, `HojaDeFiltros` y sus opciones (`OrdenDeLista` nombra los sentidos de cada campo), `SeccionDeFicha`, `RenglonDeLiga`, `FilaConContador`, `RenglonDeContacto`, `RenglonDeDireccion` (abre el mapa del teléfono), `RenglonDeHoja`, `EstadoDeHoja` |
+| **Fotos**       | `Foto`, `ProveedorDeFotos`, `TiraDeFotos`, `VisorDeFoto`                                                                                                                         |
+| **Pantallas**   | `PantallaDeAcceso` (el login), `PantallaDeFicha`, `PantallaDeHistorial` (la bitácora de un registro, con `TarjetaDeEvento`), `EsperaDeEdicion`/`FormularioDeEdicion`, `PantallaDePerfil`, `PantallaDeError`                                                                                |
+
+Y tres entradas aparte, para no obligar a cada app a instalar lo que no usa:
+
+| Entrada                            | Qué                                                                                                                                  | Pide                                                                                          |
+| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------- |
+| `@acvl/mobile-components/camara`   | `tomarFoto` (con `alTomar` para guardar la original), `elegirDeGaleria`, `pedirPermisoDeCamara`, `reducirFoto`, y `CampoDeFotos` / `FotosControladas`, las fotos de un formulario | `expo-image-picker`, `expo-image-manipulator` |
+| `@acvl/mobile-components/fotos`    | Todo lo de `camara`, más `elegirDocumentos` y `elegirAdjunto` (cámara, galería o un documento) | `expo-image-picker`, `expo-image-manipulator`, `expo-document-picker`, `expo-file-system` |
+| `@acvl/mobile-components/hoja`     | `HojaInferior`, `useMasDeLaFicha` (la sección «Más» de una ficha: renglones con contador que abren su hoja), `HojaDeLista` (una lista con buscador, scroll infinito y sus acciones, que sube sobre la ficha) | `@gorhom/bottom-sheet`                                                                        |
+
+Cada componente lleva su documentación en el código: por qué es como es, y qué se probó antes.
+
+## Instalar
+
+```sh
+npm install @acvl/mobile-components
+```
+
+Lo que la librería usa lo pone la app (`peerDependencies`): `react-native-paper`, `expo-router`,
+`react-native-reanimated`, `react-native-safe-area-context`, `react-native-keyboard-controller`,
+`react-native-gesture-handler`, `@expo/vector-icons`, `@react-native-community/datetimepicker`,
+`react-hook-form`, `dayjs`, `expo-haptics`, `expo-status-bar` y `expo-system-ui`. Sirve desde el
+SDK 54 de Expo.
+
+### Las fotos del servidor
+
+Si las fotos del servidor piden la sesión, la app dice cómo bajarlas en el layout raíz: en Android
+el `Image` no manda las `headers`, así que se bajan con `fetch` y se pinta el archivo.
+
+```tsx
+<ProveedorDeFotos bajar={(ruta) => bajarConMiToken(ruta) /* → la uri local */}>
+```
+
+Sin proveedor, la `ruta` de una foto se pinta tal cual, como URL pública.
+
+### La tipografía de Android
+
+Android va con Inter (iOS se queda con San Francisco; ver `src/tema/fuentes.ts`). Los archivos
+vienen en el paquete y cada app los registra en su `app.json`:
+
+```json
+["expo-font", {
+    "android": {
+        "fonts": [{
+            "fontFamily": "Inter",
+            "fontDefinitions": [
+                { "path": "./node_modules/@acvl/mobile-components/assets/fonts/Inter_400Regular.ttf", "weight": 400 },
+                { "path": "./node_modules/@acvl/mobile-components/assets/fonts/Inter_500Medium.ttf", "weight": 500 },
+                { "path": "./node_modules/@acvl/mobile-components/assets/fonts/Inter_600SemiBold.ttf", "weight": 600 },
+                { "path": "./node_modules/@acvl/mobile-components/assets/fonts/Inter_700Bold.ttf", "weight": 700 },
+                { "path": "./node_modules/@acvl/mobile-components/assets/fonts/Inter_800ExtraBold.ttf", "weight": 800 },
+                { "path": "./node_modules/@acvl/mobile-components/assets/fonts/Inter_900Black.ttf", "weight": 900 }
+            ]
+        }]
+    }
+}]
+```
+
+Cambiar esa lista obliga a reconstruir el binario.
+
+## Armar una app
+
+El layout raíz monta el tema y los diálogos, y exporta la pantalla de error:
+
+```tsx
+import { HostDeDialogos, PantallaDeError, ProveedorDeTema } from "@acvl/mobile-components";
+import * as SecureStore from "expo-secure-store";
+
+const almacenDelTema = {
+    leer: () => SecureStore.getItemAsync("TEMA"),
+    guardar: (tema) => SecureStore.setItemAsync("TEMA", tema),
+};
+
+export const ErrorBoundary = (props) => (
+    <PantallaDeError {...props} onError={(error) => Sentry.captureException(error)} />
+);
+
+export default function RootLayout() {
+    return (
+        <ProveedorDeTema almacen={almacenDelTema}>
+            <Stack screenOptions={{ headerShown: false }} />
+            <HostDeDialogos />
+        </ProveedorDeTema>
+    );
+}
+```
+
+Las pestañas toman el header y la barra de la casa:
+
+```tsx
+const encabezado = useOpcionesDelEncabezado({
+    eyebrow: "Operador",
+    derecha: <BotonDeAvatar iniciales="JP" onPress={() => router.push("/perfil")} />,
+});
+
+<Tabs screenOptions={encabezado} tabBar={(props) => <BarraDePestanas {...props} iconos={{ index: "assignment" }} />}>
+```
+
+Y una pantalla toma sus colores de la paleta, nunca hexadecimales:
+
+```tsx
+const useStyles = crearEstilos((c) => ({
+    tarjeta: { backgroundColor: c.superficie, borderRadius: 14, padding: 14 },
+    titulo: { ...renglon(tipografia.subtitulo), fontWeight: "800", color: c.texto },
+}));
+```
+
+## Desarrollar
+
+```sh
+npm install
+npm run typecheck
+npm test          # la lógica pura: diálogos, errores del servidor
+npm run build     # bob: lib/module y lib/typescript
+npm run format
+```
+
+Para ver un cambio en una app sin publicar, la app de tms tiene `npm run start:lib`: Metro sirve
+`src/` de este checkout (`../../acv-mobile-components`) en lugar del paquete de `node_modules`.
+Tiene que estar junto a la app, en la misma carpeta que `acv-tms`.
+
+## Publicar
+
+Igual que la del portal: cada push a `main` corre el typecheck y las pruebas, sube el _patch_ si la
+versión ya está en npm, publica y hace commit y tag del bump. Un bump a mano (un _minor_) se respeta.
+Necesita el secret `NPM_TOKEN` en el repo.

package/assets/fonts/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/lib/module/camara/CampoDeFotos.js

@@ -0,0 +1,124 @@
+"use strict";
+
+import React from "react";
+import { Controller } from "react-hook-form";
+import { View } from "react-native";
+import BotonGrande from "../componentes/BotonGrande";
+import TiraDeFotos from "../componentes/TiraDeFotos";
+import { Campo } from "../formularios/campos";
+import { crearEstilos } from "../tema";
+import { elegirDeGaleria, tomarFoto } from "./elegir";
+
+/** El lado de cada miniatura: cabe un renglón de tres en un teléfono angosto. */
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const LADO = 96;
+
+/**
+ * Fotos que se capturan con un formulario y suben al guardarlo (la evidencia de un alta, el cierre
+ * de una revisión): sus miniaturas, cada una con su «×» y abriendo el visor, y debajo **Tomar foto**
+ * y **De la galería**. Lo que se guarda es la lista de `ArchivoElegido` ya reducidos; subirlos es
+ * de quien guarda.
+ *
+ * Las que suben al momento, sin esperar a un formulario (las de una ficha que ya existe), no van
+ * aquí: ésas son una `TiraDeFotos` con sus botones.
+ */
+export function CampoDeFotos({
+  etiqueta,
+  ayuda,
+  error,
+  valor,
+  onCambiar,
+  permiso,
+  varias = true,
+  alTomar,
+  disabled
+}) {
+  const styles = useStyles();
+  // Reducir una foto tarda (se decodifica completa): el botón gira mientras tanto.
+  const [eligiendo, setEligiendo] = React.useState(null);
+  const agregar = async de => {
+    setEligiendo(de);
+    try {
+      const nuevas = de === "camara" ? await tomarFoto(permiso, {
+        alTomar
+      }) : await elegirDeGaleria({
+        varias
+      });
+      if (nuevas.length) onCambiar(varias ? [...valor, ...nuevas] : nuevas.slice(0, 1));
+    } finally {
+      setEligiendo(null);
+    }
+  };
+  const fotos = valor.map((f, i) => ({
+    llave: `${f.uri}-${i}`,
+    esFoto: f.esFoto,
+    miniatura: {
+      uri: f.uri
+    },
+    nombre: f.nombre,
+    onQuitar: disabled ? undefined : () => onCambiar(valor.filter((_, j) => j !== i))
+  }));
+  return /*#__PURE__*/_jsx(Campo, {
+    etiqueta: etiqueta,
+    ayuda: ayuda,
+    error: error,
+    children: /*#__PURE__*/_jsxs(View, {
+      style: styles.contenido,
+      children: [/*#__PURE__*/_jsx(TiraDeFotos, {
+        fotos: fotos,
+        lado: LADO,
+        cuadricula: true
+      }), /*#__PURE__*/_jsxs(View, {
+        style: styles.botones,
+        children: [/*#__PURE__*/_jsx(BotonGrande, {
+          icono: "camera-outline",
+          modo: "contorno",
+          cargando: eligiendo === "camara",
+          disabled: disabled || eligiendo !== null,
+          onPress: () => void agregar("camara"),
+          children: "Tomar foto"
+        }), /*#__PURE__*/_jsx(BotonGrande, {
+          icono: "image-outline",
+          modo: "contorno",
+          cargando: eligiendo === "galeria",
+          disabled: disabled || eligiendo !== null,
+          onPress: () => void agregar("galeria"),
+          children: "De la galer\xEDa"
+        })]
+      })]
+    })
+  });
+}
+
+/** `CampoDeFotos` atado a react-hook-form: el valor es la lista de `ArchivoElegido`. */
+export function FotosControladas({
+  control,
+  name,
+  ...props
+}) {
+  return /*#__PURE__*/_jsx(Controller, {
+    name: name,
+    control: control,
+    render: ({
+      field: {
+        value,
+        onChange
+      },
+      fieldState
+    }) => /*#__PURE__*/_jsx(CampoDeFotos, {
+      ...props,
+      valor: value ?? [],
+      onCambiar: onChange,
+      error: fieldState.error?.message
+    })
+  });
+}
+const useStyles = crearEstilos(() => ({
+  contenido: {
+    gap: 12
+  },
+  botones: {
+    gap: 8
+  }
+}));
+//# sourceMappingURL=CampoDeFotos.js.map

package/lib/module/camara/CampoDeFotos.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","Controller","View","BotonGrande","TiraDeFotos","Campo","crearEstilos","elegirDeGaleria","tomarFoto","jsx","_jsx","jsxs","_jsxs","LADO","CampoDeFotos","etiqueta","ayuda","error","valor","onCambiar","permiso","varias","alTomar","disabled","styles","useStyles","eligiendo","setEligiendo","useState","agregar","de","nuevas","length","slice","fotos","map","f","i","llave","uri","esFoto","miniatura","nombre","onQuitar","undefined","filter","_","j","children","style","contenido","lado","cuadricula","botones","icono","modo","cargando","onPress","FotosControladas","control","name","props","render","field","value","onChange","fieldState","message","gap"],"sourceRoot":"../../../src","sources":["camara/CampoDeFotos.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/camara/elegir.js

@@ -0,0 +1,104 @@
+"use strict";
+
+// Tomar una foto o elegirla de la galería para subirla. Contesta lo elegido ya listo para el
+// `FormData` (reducido a 1920 px); qué se hace con él —subirlo en el momento, guardarlo para una
+// cola— es de quien llama. Los documentos (un PDF) están en `fotos/`, que pide expo-document-picker.
+import * as ImagePicker from "expo-image-picker";
+import { avisar } from "../dialogos/dialogos";
+import { reducirFoto } from "./reducir";
+
+/** Lo elegido: dónde está en el teléfono, su nombre, su tipo y si es una foto. */
+
+/** Para qué se pide la cámara, dicho a quien la usa. */
+
+/**
+ * Lo que se hace con la foto **original** de la cámara antes de reducirla: guardarla en la galería
+ * del teléfono, por ejemplo, como respaldo de quien la tomó si la subida falla. Lo que falle aquí
+ * no detiene la foto.
+ */
+
+/**
+ * El permiso de la cámara. Si ya se negó para siempre, se dice dónde activarlo; si nunca se ha
+ * pedido, primero la explicación de la app (si hay) y luego el diálogo del sistema.
+ */
+export async function pedirPermisoDeCamara({
+  para,
+  explicacion
+}) {
+  const actual = await ImagePicker.getCameraPermissionsAsync();
+  if (actual.granted) return true;
+  if (!actual.canAskAgain) {
+    await avisar({
+      titulo: "Sin permiso de cámara",
+      mensaje: `Para ${para}, activa la cámara para la app en los ajustes del teléfono.`,
+      icono: "camera-off-outline"
+    });
+    return false;
+  }
+  if (explicacion) {
+    await avisar({
+      titulo: "La cámara",
+      mensaje: explicacion,
+      icono: "camera-outline",
+      cancelable: false
+    });
+  }
+  return (await ImagePicker.requestCameraPermissionsAsync()).granted;
+}
+
+/**
+ * Las imágenes elegidas, reducidas a 1920 px en JPEG (`reducirFoto`). Una por una y no con
+ * `Promise.all`: cada foto se decodifica completa en memoria, y veinte a la vez desde la galería
+ * pueden tumbar la app en un Android modesto.
+ */
+export async function deFotos(assets) {
+  const elegidos = [];
+  for (const asset of assets) {
+    const reducida = await reducirFoto(asset);
+    elegidos.push({
+      uri: reducida.uri,
+      nombre: reducida.fileName ?? "foto.jpg",
+      tipo: reducida.mimeType ?? "image/jpeg",
+      esFoto: true
+    });
+  }
+  return elegidos;
+}
+
+/** Una foto con la cámara, con su permiso. Vacío si no hubo permiso o se canceló. */
+export async function tomarFoto(permiso, {
+  alTomar
+} = {}) {
+  if (!(await pedirPermisoDeCamara(permiso))) return [];
+  const resultado = await ImagePicker.launchCameraAsync({
+    mediaTypes: ["images"],
+    quality: 1
+  });
+  if (resultado.canceled) return [];
+  if (alTomar) {
+    for (const original of resultado.assets) {
+      try {
+        await alTomar(original);
+      } catch (error) {
+        console.warn("No se pudo guardar la original de la foto.", error);
+      }
+    }
+  }
+  return deFotos(resultado.assets);
+}
+
+/**
+ * De la galería. En Android el selector de fotos del sistema no pide permiso de almacenamiento,
+ * así que no hay explicación previa que dar.
+ */
+export async function elegirDeGaleria({
+  varias = false
+} = {}) {
+  const resultado = await ImagePicker.launchImageLibraryAsync({
+    mediaTypes: ["images"],
+    allowsMultipleSelection: varias,
+    quality: 1
+  });
+  return resultado.canceled ? [] : deFotos(resultado.assets);
+}
+//# sourceMappingURL=elegir.js.map

package/lib/module/camara/elegir.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ImagePicker","avisar","reducirFoto","pedirPermisoDeCamara","para","explicacion","actual","getCameraPermissionsAsync","granted","canAskAgain","titulo","mensaje","icono","cancelable","requestCameraPermissionsAsync","deFotos","assets","elegidos","asset","reducida","push","uri","nombre","fileName","tipo","mimeType","esFoto","tomarFoto","permiso","alTomar","resultado","launchCameraAsync","mediaTypes","quality","canceled","original","error","console","warn","elegirDeGaleria","varias","launchImageLibraryAsync","allowsMultipleSelection"],"sourceRoot":"../../../src","sources":["camara/elegir.ts"],"mappings":";;AAAA;AACA;AACA;AACA,OAAO,KAAKA,WAAW,MAAM,mBAAmB;AAChD,SAASC,MAAM,QAAQ,sBAAsB;AAC7C,SAASC,WAAW,QAAQ,WAAW;;AAEvC;;AAQA;;AAWA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA,OAAO,eAAeC,oBAAoBA,CAAC;EACvCC,IAAI;EACJC;AACa,CAAC,EAAoB;EAClC,MAAMC,MAAM,GAAG,MAAMN,WAAW,CAACO,yBAAyB,CAAC,CAAC;EAC5D,IAAID,MAAM,CAACE,OAAO,EAAE,OAAO,IAAI;EAC/B,IAAI,CAACF,MAAM,CAACG,WAAW,EAAE;IACrB,MAAMR,MAAM,CAAC;MACTS,MAAM,EAAE,uBAAuB;MAC/BC,OAAO,EAAE,QAAQP,IAAI,6DAA6D;MAClFQ,KAAK,EAAE;IACX,CAAC,CAAC;IACF,OAAO,KAAK;EAChB;EACA,IAAIP,WAAW,EAAE;IACb,MAAMJ,MAAM,CAAC;MACTS,MAAM,EAAE,WAAW;MACnBC,OAAO,EAAEN,WAAW;MACpBO,KAAK,EAAE,gBAAgB;MACvBC,UAAU,EAAE;IAChB,CAAC,CAAC;EACN;EACA,OAAO,CAAC,MAAMb,WAAW,CAACc,6BAA6B,CAAC,CAAC,EAAEN,OAAO;AACtE;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeO,OAAOA,CAACC,MAAsC,EAA6B;EAC7F,MAAMC,QAA0B,GAAG,EAAE;EACrC,KAAK,MAAMC,KAAK,IAAIF,MAAM,EAAE;IACxB,MAAMG,QAAQ,GAAG,MAAMjB,WAAW,CAACgB,KAAK,CAAC;IACzCD,QAAQ,CAACG,IAAI,CAAC;MACVC,GAAG,EAAEF,QAAQ,CAACE,GAAG;MACjBC,MAAM,EAAEH,QAAQ,CAACI,QAAQ,IAAI,UAAU;MACvCC,IAAI,EAAEL,QAAQ,CAACM,QAAQ,IAAI,YAAY;MACvCC,MAAM,EAAE;IACZ,CAAC,CAAC;EACN;EACA,OAAOT,QAAQ;AACnB;;AAEA;AACA,OAAO,eAAeU,SAASA,CAC3BC,OAAwB,EACxB;EAAEC;AAAmC,CAAC,GAAG,CAAC,CAAC,EAClB;EACzB,IAAI,EAAE,MAAM1B,oBAAoB,CAACyB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE;EACrD,MAAME,SAAS,GAAG,MAAM9B,WAAW,CAAC+B,iBAAiB,CAAC;IAAEC,UAAU,EAAE,CAAC,QAAQ,CAAC;IAAEC,OAAO,EAAE;EAAE,CAAC,CAAC;EAC7F,IAAIH,SAAS,CAACI,QAAQ,EAAE,OAAO,EAAE;EACjC,IAAIL,OAAO,EAAE;IACT,KAAK,MAAMM,QAAQ,IAAIL,SAAS,CAACd,MAAM,EAAE;MACrC,IAAI;QACA,MAAMa,OAAO,CAACM,QAAQ,CAAC;MAC3B,CAAC,CAAC,OAAOC,KAAK,EAAE;QACZC,OAAO,CAACC,IAAI,CAAC,4CAA4C,EAAEF,KAAK,CAAC;MACrE;IACJ;EACJ;EACA,OAAOrB,OAAO,CAACe,SAAS,CAACd,MAAM,CAAC;AACpC;;AAEA;AACA;AACA;AACA;AACA,OAAO,eAAeuB,eAAeA,CAAC;EAAEC,MAAM,GAAG;AAAM,CAAC,GAAG,CAAC,CAAC,EAA6B;EACtF,MAAMV,SAAS,GAAG,MAAM9B,WAAW,CAACyC,uBAAuB,CAAC;IACxDT,UAAU,EAAE,CAAC,QAAQ,CAAC;IACtBU,uBAAuB,EAAEF,MAAM;IAC/BP,OAAO,EAAE;EACb,CAAC,CAAC;EACF,OAAOH,SAAS,CAACI,QAAQ,GAAG,EAAE,GAAGnB,OAAO,CAACe,SAAS,CAACd,MAAM,CAAC;AAC9D","ignoreList":[]}

package/lib/module/camara/index.js

@@ -0,0 +1,10 @@
+"use strict";
+
+// `@acvl/mobile-components/camara`: tomar fotos o elegirlas de la galería, y el campo de fotos de un
+// formulario. Va aparte de la entrada principal porque usa expo-image-picker y
+// expo-image-manipulator, que sólo instala la app que sube fotos; y aparte de `fotos` porque ésa
+// además elige documentos, con expo-document-picker.
+export { CampoDeFotos, FotosControladas } from "./CampoDeFotos";
+export { deFotos, elegirDeGaleria, pedirPermisoDeCamara, tomarFoto } from "./elegir";
+export { LADO_MAXIMO, reducirFoto, reducirImagenAdjunta } from "./reducir";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["CampoDeFotos","FotosControladas","deFotos","elegirDeGaleria","pedirPermisoDeCamara","tomarFoto","LADO_MAXIMO","reducirFoto","reducirImagenAdjunta"],"sourceRoot":"../../../src","sources":["camara/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA,SAASA,YAAY,EAAEC,gBAAgB,QAAQ,gBAAgB;AAC/D,SACIC,OAAO,EACPC,eAAe,EACfC,oBAAoB,EACpBC,SAAS,QAIN,UAAU;AACjB,SAASC,WAAW,EAAEC,WAAW,EAAEC,oBAAoB,QAAQ,WAAW","ignoreList":[]}

package/lib/module/camara/reducir.js

@@ -0,0 +1,93 @@
+"use strict";
+
+// Achicar las fotos en el teléfono antes de subirlas.
+import { ImageManipulator, SaveFormat } from "expo-image-manipulator";
+import { Image } from "react-native";
+
+/**
+ * Lado más largo con el que se sube una foto. Es el mismo con el que el backend la guarda
+ * (`MAX_DIMENSION` en `core/shared/fields.py`): arriba de eso los píxeles viajan para que el
+ * servidor los tire.
+ */
+export const LADO_MAXIMO = 1920;
+
+/** Calidad JPEG de la copia reducida; el backend recodifica a 82 al guardarla. */
+const CALIDAD = 0.8;
+
+/**
+ * La foto con su lado más largo en `LADO_MAXIMO` y codificada en JPEG.
+ *
+ * Una foto de la cámara (12 MP o más) pesa de 2 a 5 MB, y se sube con la señal que haya en el
+ * camino o en el patio: reducida pesa unos cientos de KB, sale antes y no se pasa del tope
+ * de tamaño del servidor. El servidor no pierde nada, porque de todos modos la guarda a 1920 px.
+ *
+ * Falla en blando: si no se puede reducir, se guarda la original —pesa más, pero es mejor que
+ * perder la foto que se acaba de tomar—.
+ */
+export async function reducirFoto(asset) {
+  const {
+    width,
+    height
+  } = asset;
+  const cabe = width > 0 && height > 0 && Math.max(width, height) <= LADO_MAXIMO;
+  if (cabe && asset.mimeType === "image/jpeg") return asset;
+  try {
+    const contexto = ImageManipulator.manipulate(asset.uri);
+    if (!cabe) {
+      // Se da un solo lado y el otro sale de la proporción.
+      contexto.resize(width >= height ? {
+        width: LADO_MAXIMO
+      } : {
+        height: LADO_MAXIMO
+      });
+    }
+    const imagen = await contexto.renderAsync();
+    const reducida = await imagen.saveAsync({
+      compress: CALIDAD,
+      format: SaveFormat.JPEG
+    });
+    const base = (asset.fileName ?? reducida.uri.split("/").pop() ?? "foto").replace(/\.[^.]+$/, "");
+    return {
+      ...asset,
+      uri: reducida.uri,
+      width: reducida.width,
+      height: reducida.height,
+      fileName: `${base}.jpg`,
+      mimeType: "image/jpeg",
+      fileSize: undefined
+    };
+  } catch (error) {
+    console.warn("No se pudo reducir la foto; se sube la original.", error);
+    return asset;
+  }
+}
+
+/**
+ * Lo mismo para una imagen adjuntada como archivo (`DocumentPicker`), que no trae sus medidas: se
+ * leen del archivo y se reduce como una foto. Si no se pueden leer, se guarda la original.
+ */
+export async function reducirImagenAdjunta(archivo) {
+  try {
+    const {
+      width,
+      height
+    } = await Image.getSize(archivo.uri);
+    const reducida = await reducirFoto({
+      uri: archivo.uri,
+      width,
+      height,
+      fileName: archivo.nombre,
+      mimeType: archivo.tipo,
+      type: "image"
+    });
+    return {
+      uri: reducida.uri,
+      nombre: reducida.fileName ?? archivo.nombre,
+      tipo: reducida.mimeType ?? archivo.tipo
+    };
+  } catch (error) {
+    console.warn("No se pudieron leer las medidas de la imagen; se sube la original.", error);
+    return archivo;
+  }
+}
+//# sourceMappingURL=reducir.js.map

package/lib/module/camara/reducir.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ImageManipulator","SaveFormat","Image","LADO_MAXIMO","CALIDAD","reducirFoto","asset","width","height","cabe","Math","max","mimeType","contexto","manipulate","uri","resize","imagen","renderAsync","reducida","saveAsync","compress","format","JPEG","base","fileName","split","pop","replace","fileSize","undefined","error","console","warn","reducirImagenAdjunta","archivo","getSize","nombre","tipo","type"],"sourceRoot":"../../../src","sources":["camara/reducir.ts"],"mappings":"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","ignoreList":[]}