|
|
# mask-field — ficha de auditoría (RE-AUDITADA 2026-07-07, profundidad piloto)
|
|
|
|
|
|
- **Familia**: fields (Tier-1, decisiones LOCKED 07-05) · **Método**: solo análisis; evidencia por dimensión · demos fuera
|
|
|
- **Capas leídas**: [morfo](../../../src/uix/morfo/components/mask-field.ts) completo (1-110+) · [soma types](../../../src/uix/soma/components/mask-field/types.ts) completo · pack ✓ · engine propio (`mask-engine`, tests ×2 ✓)
|
|
|
- **Máquina**: PASS con `R-1.3` · tests **2** ✓✓ · README ×2 ✓
|
|
|
|
|
|
## Dimensiones (evidencia leída)
|
|
|
|
|
|
| # | Dimensión | Estado | Evidencia |
|
|
|
| --- | -------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
|
| 1 | Composición | ✓ | Single-input compositivo; el morfo RAZONA por qué NO se fragmenta en fake-segments (eso es de Date/Time — :18-20) |
|
|
|
| 2 | Naming | ✓ con dato nuevo | `value/onValueChange` ✓ + **`onValueCommit: OnChangeFn`** para blur/Enter (types :75-76) — TERCER patrón de callback terminal del catálogo (vs `onSubmit` crudo de search/password) → fila clave en \_naming; `showMask/placeholderChar/definitions` (decisiones locked); `unmaskedValue` como derivado read-only en snippet (:19-20) |
|
|
|
| 3 | Coherencia semántica | ✓ | `commit-set` solo en confirmación — la doctrina teclear≠commit citada y alineada (morfo :43-47); `expression: 'pack'` + pack ✓ |
|
|
|
| 4 | API | ✓ ejemplar | Alfabeto de tokens documentado con escape y cola opcional (`\9`, `[ ... ]` — types :47-53); `definitions` merge-over con RegExp por slot (:55-60); modelo de valor = string enmascarado con la convención de la industria citada (morfo :25-28) |
|
|
|
| 5 | Tokens | ✓ con dup | `height-{k}` duplicada (SYS-6); tokens 9-A-\* del engine per decisión |
|
|
|
| 6 | Sema | ✓ | Pack ✓ |
|
|
|
| 7 | Animaciones | ✓ | `showMask` revela esqueleto sin keyframes |
|
|
|
| 8 | Contrato morfo | ✓ | APG textbox CORRECTO (:41 — un solo textbox, no combobox como search); `data-complete` con razón (intrínseco a máscara, gate de submit sin re-derivar — :74-77); flags focused/empty ✓ |
|
|
|
| 9 | A11y | ✓ con doctrina propia | **Valor anunciado siempre veraz**: los keystrokes rechazados REVIERTEN visiblemente en vez de tragarse en silencio (el lector siempre relee el valor comprometido — morfo :21-23) — doctrina exportable a cualquier input con formateo |
|
|
|
| 10 | Theming | hallazgo | R-1.3 readonly sin estilo (patrón familia) |
|
|
|
| 11 | Composición interna | ✓ documentada | Field integration EXPLÍCITA: el Input se registra en `Field.inputId` → Label/Helper/Error se auto-cablean (types :35-38) — de lo poco de la familia que documenta el wiring |
|
|
|
| 12 | Estados | ✓ | complete/focused/empty + OR-merge; `name` envía el valor ENMASCARADO (documentado :89) |
|
|
|
| 13 | Runtime | ✓ | Engine puro con suite propia; sin timers/DOM crudo |
|
|
|
| 14 | Docs+tests | ✓ el mejor de la familia | 2 suites (engine + provider) |
|
|
|
| 15 | i18n | ✓ | translationRef en aria-label; texts morfo |
|
|
|
|
|
|
## Hallazgos y propuestas
|
|
|
|
|
|
| ID | Hallazgo | Propuesta |
|
|
|
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------ |
|
|
|
| **F-1** | readonly sin estilo (R-1.3) | Tratamiento único de familia |
|
|
|
| **F-2** | `height-{k}` duplicada | SYS-6 |
|
|
|
| **Nota ✓** | `onValueCommit` (OnChangeFn) es candidato a CANON del callback terminal (vs `onSubmit` crudo) — coincide con la convención Radix/bits del slider | Veredicto \_naming: unificar el trío de patrones |
|
|
|
|
|
|
## Escalan al sistema
|
|
|
|
|
|
\_naming (callback terminal: onValueCommit vs onSubmit vs solo-evento) · SYS-5 · SYS-6 · doctrina "valor anunciado veraz" exportable.
|
|
|
|
|
|
## Veredictos
|
|
|
|
|
|
_(pendiente — checkpoint post-barrido)_
|
