pixelon 0.9.3 → 0.9.5

package/dist/components/atoms/lumi/PhoneInput/PhoneInput.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import { type PhoneCountry } from './phone-countries';
+import './PhoneInput.scss';
+export interface PhoneInputProps {
+    /** En internacional: «+573001234567». Vacío si no hay dígitos. */
+    value?: string;
+    onChange?: (value: string) => void;
+    onBlur?: () => void;
+    label?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    error?: string;
+    /** Lista de países a ofrecer. Por defecto, el catálogo de pixelon. */
+    countries?: PhoneCountry[];
+    /** ISO2 del país preseleccionado. Por defecto «CO». */
+    defaultCountry?: string;
+    name?: string;
+    id?: string;
+    className?: string;
+    labels?: {
+        /** Título de la hoja. */
+        pickCountry?: string;
+        searchPlaceholder?: string;
+        noResults?: string;
+    };
+}
+export declare const PhoneInput: React.ForwardRefExoticComponent<PhoneInputProps & React.RefAttributes<HTMLInputElement>>;
+export default PhoneInput;

package/dist/components/atoms/lumi/PhoneInput/index.d.ts

@@ -0,0 +1,3 @@
+export { PhoneInput, type PhoneInputProps } from './PhoneInput';
+export { PhoneInput as default } from './PhoneInput';
+export { PHONE_COUNTRIES, DEFAULT_PHONE_COUNTRY, flagOf, splitPhone, type PhoneCountry, } from './phone-countries';

package/dist/components/atoms/lumi/PhoneInput/phone-countries.d.ts

@@ -0,0 +1,19 @@
+export interface PhoneCountry {
+    /** ISO 3166-1 alfa-2, en mayúsculas: «CO». */
+    code: string;
+    name: string;
+    /** Con el «+»: «+57». */
+    dialCode: string;
+    /** Cuántos dígitos tiene un celular ahí (sin indicativo). Si no se sabe, hasta 15. */
+    digits?: number;
+}
+export declare const PHONE_COUNTRIES: PhoneCountry[];
+export declare const DEFAULT_PHONE_COUNTRY = "CO";
+/** «CO» → 🇨🇴. Dos letras ISO → dos indicadores regionales; cualquier otra cosa, vacío. */
+export declare function flagOf(code: string): string;
+/** Separa un valor en internacional («+573001234567») en su país y sus dígitos locales. Sin «+»,
+ *  los dígitos son del país por defecto. El indicativo más largo gana («+1» no se come «+507»). */
+export declare function splitPhone(value: string | undefined, countries: PhoneCountry[], defaultCountry: string): {
+    country: PhoneCountry;
+    digits: string;
+};

package/dist/components/atoms/lumi/SheetSelect/SheetSelect.d.ts

@@ -0,0 +1,32 @@
+import React from 'react';
+import './SheetSelect.scss';
+export interface SheetSelectOption {
+    value: string;
+    label: string;
+    /** Una línea secundaria bajo la etiqueta (p. ej. «Sótanos y parqueaderos de altura limitada»). */
+    hint?: string;
+}
+export interface SheetSelectProps {
+    value?: string | null;
+    onChange?: (value: string) => void;
+    onBlur?: () => void;
+    options: SheetSelectOption[];
+    label?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    error?: string;
+    /** Buscador en la hoja. Siempre, salvo que se apague: aunque la lista sea corta, quien sabe lo
+     *  que busca llega antes escribiendo dos letras que leyendo. */
+    searchable?: boolean;
+    /** Qué decir cuando no hay opciones (p. ej. no se pudieron cargar). */
+    notFoundContent?: string;
+    /** Título de la hoja. Por defecto, la etiqueta del campo. */
+    sheetTitle?: string;
+    searchPlaceholder?: string;
+    name?: string;
+    id?: string;
+    className?: string;
+}
+export declare const SheetSelect: React.ForwardRefExoticComponent<SheetSelectProps & React.RefAttributes<HTMLInputElement>>;
+export default SheetSelect;

package/dist/components/atoms/lumi/SheetSelect/index.d.ts

@@ -0,0 +1,2 @@
+export { SheetSelect, type SheetSelectProps, type SheetSelectOption } from './SheetSelect';
+export { SheetSelect as default } from './SheetSelect';

package/dist/components/molecules/chat/StructuredContent/components/LocationField/types.d.ts

@@ -14,6 +14,8 @@ export interface LocationFieldLabels {
     unavailable?: string;
     noResults?: string;
     confirmHint?: string;
+    /** SPEC-182 — accesibilidad del lápiz que abre el mapa grande para ajustar el punto. */
+    editAria?: string;
 }
 export interface LocationFieldProps {
     value?: LocationValue;

package/dist/components/molecules/chat/StructuredContent/components/MapView/types.d.ts

@@ -82,6 +82,13 @@ export interface MapViewProps {
     /** Uso INTERNO: la instancia que vive dentro de la capa a pantalla completa. Llena el
      *  contenedor, sin bordes ni radio, y no vuelve a ofrecer expandir. */
     fullBleed?: boolean;
+    /** SPEC-182 — `false`: el mapa es solo para mirar. No captura el dedo ni la rueda (el gesto
+     *  pasa a la página), no tiene controles de zoom, el pin no se arrastra y tocarlo no mueve el
+     *  punto. La instancia a pantalla completa NO hereda esto: ahí se ajusta. Default `true`. */
+    interactive?: boolean;
+    /** SPEC-182 — qué icono lleva el botón flotante de arriba a la derecha. `edit` (un lápiz)
+     *  para cuando el mapa pequeño es solo para mirar y el ajuste se hace en grande. */
+    expandIcon?: 'expand' | 'edit';
     /** SPEC-025 R7 — milisegundos que tarda un marcador en DESPLAZARSE hasta su nueva posición.
      *  Sin esto, salta. Con posiciones que llegan cada pocos segundos, saltar se lee como un
      *  punto que parpadea en sitios distintos; desplazarse, como un vehículo que avanza. */

package/dist/components/molecules/chat/StructuredContent/components/ReactiveCrud/types.d.ts

@@ -1,6 +1,11 @@
 import type { FieldValidation } from '../ReactiveForm/types';
 import type { FilterFieldConfig, FilterManager } from '../../../../lumi/Filter/types';
-export type CrudMolecule = 'INPUT' | 'INPUT_NUMBER' | 'INPUT_CURRENCY' | 'TEXTAREA' | 'SELECT' | 'DATE_INPUT' | 'TIME_INPUT' | 'CHECKBOX' | 'BADGE' | 'FILE'
+import type { SanitizeSpec } from '../../../../../organisms/lumi/DynamicForm/helpers/sanitizers';
+export type CrudMolecule = 'INPUT' | 'INPUT_NUMBER' | 'INPUT_CURRENCY' | 'TEXTAREA'
+/** SPEC-184 — celular con su país: selector de bandera + indicativo y los dígitos. El valor es
+ *  UN string en formato internacional («+573001234567»). `uiProps.defaultCountry` (ISO2, «CO»
+ *  por defecto) y `uiProps.countries` para acotar o cambiar la lista. */
+ | 'INPUT_PHONE' | 'SELECT' | 'DATE_INPUT' | 'TIME_INPUT' | 'CHECKBOX' | 'BADGE' | 'FILE'
 /** SPEC-023 — ubicación: un campo con dos vías (mi ubicación / buscar dirección) que produce
  *  dirección + coordenadas. Requiere `bind` para saber a qué claves van los tres valores. */
  | 'LOCATION'
@@ -65,6 +70,21 @@ export interface ReactiveCrudField {
     optionsEndpoint?: CrudFieldOptionsEndpoint;
     /** SPEC-174 (solo SELECT): deja escribir para filtrar. Para listas largas (municipios). */
     searchable?: boolean;
+    /** SPEC-185 (solo SELECT): `sheet` elige en una hoja desde abajo (buscador con listas largas,
+     *  filas cómodas de tocar), en vez del desplegable pegado al campo. Lo que conviene en el
+     *  teléfono; en escritorio la hoja sale centrada. */
+    picker?: 'sheet' | 'dropdown';
+    /** SPEC-181 — el campo se pinta solo cuando OTRO campo del formulario vale lo que se dice:
+     *  la planta del parqueadero solo tiene sentido si la situación es «en un parqueadero». Misma
+     *  forma que en las acciones (una condición o varias unidas por «y»), y como todo en esta
+     *  firma, dato y no función: viaja en JSON desde el chat. Un campo obligatorio que no se pinta
+     *  no bloquea el envío. */
+    visibleWhen?: RowActionVisibleWhen | RowActionVisibleWhen[];
+    /** SPEC-183 — limpieza declarativa del texto, por nombre: `{ preset: 'plate' }` deja la placa
+     *  en mayúsculas y sin separadores mientras se escribe; `{ preset: 'phone' }` y `{ preset: 'id' }`
+     *  dejan solo dígitos; o reglas sueltas (`['digits', { maxLength: 10 }]`). La validación (pattern)
+     *  se evalúa sobre el texto ya limpio, así que puede ser estricta. */
+    sanitize?: SanitizeSpec;
     validation?: FieldValidation;
     /** Clave del registro de formatters (§8) — NO función inline. */
     format?: string;
@@ -252,9 +272,16 @@ export interface ReactiveCrudConfig {
     layout?: 'auto' | 'table' | 'cards';
     /** SPEC-093 — ancho (px) por debajo del cual `auto` pinta tarjetas. 768 por defecto. */
     cardsBelow?: number;
-    /** SPEC-087 — cuenta atrás en el panel de un registro. Ver `DeadlineConfig`. */
-    deadline?: DeadlineConfig;
+    /** SPEC-087 — cuenta atrás en el panel de un registro. Ver `DeadlineConfig`.
+     *  SPEC-187 — o VARIAS: se pinta la primera cuyo campo trae valor. Un módulo puede tener más
+     *  de un plazo (el de la solicitud, el del comprobante) y nunca corren a la vez. */
+    deadline?: DeadlineConfig | DeadlineConfig[];
 }
+/** SPEC-187 — de los plazos configurados, el que corre en esta fila (el primero con valor). */
+export declare function plazoVigente(deadline: DeadlineConfig | DeadlineConfig[] | undefined, row: Record<string, unknown> | null | undefined): {
+    config: DeadlineConfig;
+    at: string;
+} | null;
 /** SPEC-087 — fecha límite de un registro, pintada como cuenta atrás junto a sus acciones.
  *
  *  Es deliberadamente genérico: dice «esta tarjeta tiene una fecha límite», no de qué es el plazo.

package/dist/components/organisms/lumi/DynamicForm/helpers/sanitizers.d.ts

@@ -0,0 +1,28 @@
+export type SanitizeRule = 
+/** Quita espacios de los extremos. Solo al enviar. */
+'trim' | 'upper' | 'lower'
+/** Deja solo dígitos. */
+ | 'digits'
+/** Deja solo letras y dígitos (sin tildes ni símbolos): placas, códigos. */
+ | 'alnum'
+/** Quita caracteres de control (los que llegan de un pegado raro). */
+ | 'noControl'
+/** Varios espacios seguidos → uno. */
+ | 'collapseSpaces' | {
+    maxLength: number;
+}
+/** Quita todo lo que case con esta expresión regular (sin banderas; se aplica global). */
+ | {
+    strip: string;
+}
+/** Una forma conocida: equivale a la lista de reglas de `SANITIZE_PRESETS`. */
+ | {
+    preset: SanitizePreset;
+};
+export type SanitizePreset = 'plate' | 'phone' | 'id' | 'name' | 'note';
+export type SanitizeSpec = SanitizeRule | SanitizeRule[];
+export declare const SANITIZE_PRESETS: Record<SanitizePreset, SanitizeRule[]>;
+/** Aplica la limpieza. `live: true` es mientras se escribe (no recorta extremos). */
+export declare function sanitize(value: unknown, spec: SanitizeSpec | undefined, options?: {
+    live?: boolean;
+}): unknown;

package/dist/components/organisms/lumi/DynamicForm/types.d.ts

@@ -1,3 +1,4 @@
+import type { SanitizeSpec } from './helpers/sanitizers';
 import type { UseFormReturn, Control, FieldValues } from 'react-hook-form';
 /**
  * Tipos de moléculas soportadas por DynamicForm
@@ -45,6 +46,9 @@ export interface FormFieldConfig {
     transformOnReceive?: (value: unknown) => unknown;
     /** Condición para mostrar el campo (dependencia de otros campos) */
     showIf?: (formValues: Record<string, unknown>) => boolean;
+    /** SPEC-183 — limpieza declarativa del texto (ver helpers/sanitizers.ts): se aplica mientras se
+     *  escribe y al enviar. Ej.: `{ preset: 'plate' }`, `['digits', { maxLength: 10 }]`. */
+    sanitize?: SanitizeSpec;
     /** Opciones para SELECT, SELECT_MULTI */
     options?: SelectOption[];
     /** Orden de renderizado */

package/dist/components/templates/lumi/Crud/types.d.ts

@@ -1,4 +1,5 @@
 import type { FilterFieldConfig, FilterManager } from '../../../molecules/lumi/Filter/types';
+import type { SanitizeSpec } from '../../../organisms/lumi/DynamicForm/helpers/sanitizers';
 /**
  * Configuración de un campo renderizable en tabla y formulario
  */
@@ -51,6 +52,11 @@ export interface RenderFieldConfig {
     formatValue?: (value: unknown, row: unknown) => React.ReactNode;
     /** Función para parsear el valor antes de submit */
     parseValue?: (value: unknown) => unknown;
+    /** SPEC-181 — el campo se pinta solo si la condición se cumple con los valores actuales del
+     *  formulario. Llega a DynamicForm como su `showIf` de siempre. */
+    showIf?: (formValues: Record<string, unknown>) => boolean;
+    /** SPEC-183 — limpieza declarativa del texto (DynamicForm `sanitize`). */
+    sanitize?: SanitizeSpec;
     /** SPEC-131 T7 — cuántas columnas ocupa el campo en el formulario.
      *
      *  En un grid las celdas de una fila comparten altura, así que un campo que se despliega —el de

package/dist/index.d.ts

@@ -108,3 +108,6 @@ export { setLastFleetSnapshot, getLastFleetSnapshot } from './core/eventBus';
 export type { ChatEvents, ChatEventBus, FleetPosition } from './core/eventBus';
 export { ChatConfigProvider, useChatConfig, CHAT_CONFIG_DEFAULTS } from './core/chat';
 export type { ChatConfig } from './core/chat';
+export { sanitize, SANITIZE_PRESETS, type SanitizeRule, type SanitizeSpec, type SanitizePreset, } from './components/organisms/lumi/DynamicForm/helpers/sanitizers';
+export { PhoneInput as LumiPhoneInput, type PhoneInputProps as LumiPhoneInputProps, PHONE_COUNTRIES, DEFAULT_PHONE_COUNTRY, flagOf, splitPhone, type PhoneCountry, } from './components/atoms/lumi/PhoneInput';
+export { SheetSelect as LumiSheetSelect, type SheetSelectProps as LumiSheetSelectProps, type SheetSelectOption as LumiSheetSelectOption, } from './components/atoms/lumi/SheetSelect';