svelte-kit-vice/docs/audit/components/cropper.md

# cropper — ficha de auditoría (RE-AUDITADA 2026-07-07, profundidad piloto)

- **Familia**: media/controls (recorte; capa zoom-pan compartida con image-picker) · **Método**: solo análisis · demos fuera
- **Capas leídas**: [morfo](../../../src/uix/morfo/components/cropper.ts) (148 líneas; eventos :31-73; **censo `apg:` = 0**) · pack ✓
- **Máquina**: PASS limpio · tests ✓ · README ×2 ✓ — **PERO ver F-2/F-3: dos cosas que no cazó**

## Dimensiones (evidencia leída)

| #     | Dimensión            | Estado            | Evidencia                                                                                                                                                                                                                                                                                      |
| ----- | -------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 2     | Naming               | hallazgo SYS-1    | **F-1: 8 hooks-clase** — el MAYOR ofensor del catálogo (button 6, image-picker 6)                                                                                                                                                                                                              |
| 3     | Coherencia semántica | ✓ con desajuste   | `handle-drag`/`handle-resize`/`handle-zoom` (:31-63 ✓ censo handle) + commit affirm (:64-69); **F-2**: el evento se llama `commit-crop` pero su verb es `'apply'` (:64-67) — el nombre rompe `{familia}-{verbo}` (sería commit-apply) y la regla A-3.6 no lo flagueó (cuarto agujero de regla) |
| 8     | Contrato morfo       | hallazgo          | **F-3**: sin cita `apg:` (censo = 0) con PASS — el A-1.4 tampoco lo cazó; caso "sin patrón oficial"                                                                                                                                                                                            |
| 12    | Runtime              | pendiente familia | Candidato del censo D13 (write-then-read): sus gestos miden el box — verificar `dom.measure` en provider al ejecutar                                                                                                                                                                           |
| resto |                      | ✓                 | Gestos, aspect locks, teclado de nudge; pack ✓; tests ✓                                                                                                                                                                                                                                        |

## Hallazgos y propuestas

| ID      | Hallazgo                                                                                                                                                                                                                                                               | Propuesta                                      |
| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| **F-1** | 8 hooks-clase                                                                                                                                                                                                                                                          | Codemod SYS-1                                  |
| ~~F-2~~ | _(RETIRADO en P1: `apply` ES canónico — extensión de autor, verbs.ts :97 — y `commit-crop` es etiqueta de dominio autorizada por el libro cap. 8 §1; vocab-check lo lista como warn de descubribilidad, no violación. Rename a `commit-apply-crop` = pulido opcional)_ | —                                              |
| **F-3** | Sin APG (regla no cazó)                                                                                                                                                                                                                                                | Regla "apg: none — rationale" + fix del script |

## Escalan al sistema

SYS-1 (top) · censos A-3.6/A-1.4 (agujeros del script ×4 ya) · censo D13 (candidato) · censo handle.

## Veredictos

_(pendiente — checkpoint post-barrido)_
-												feat(audit): component re-audit + fixes P0–P5 (P4 complete, P5 in progress)

Re-audit of the whole component catalog at pilot depth (91 fichas + the
checkpoint verdicts in docs/audit/components/) and the executed fix packages.

- P0–P3: doctrine (sema participation, CANON §3 intent, component-guide §5 +
  API naming, §32 outline), guards (morfo-vocabulary-check S10/S11d,
  component-audit A-3.1/A-1.4/S9, eidos-lint classHooks), morfo contracts
  (role=application removed ×4, aria-selected off the Day, drp translationRef,
  field data-state prune, pin-input commit-set, media-player renames), 13 new
  sema packs + 12 morfos family-default → pack.
- P4 (N1–N10) COMPLETE: selectionMode (select/combobox/toggle-group/calendar);
  onValueCommit terminal-callback norm (pin-input/search/password/textarea +
  date/time/color-field add); typed validation reason + onInvalid (tags-input,
  css-field); index/onIndexChange (carousel); deselectable; openDelay/
  groupSkipDelay; allowCustomValue; defaultValue prune.
- P5 (in progress): S1 class-hooks codemod (22 hooks → data-attrs across
  cropper/button/image-picker/toggle/image-adjustments); S5 outline remnant in
  field.css; depth pass (data-depth=overlay on tooltip/toast/float-panel);
  touch-rows (--touch-target token, decoupled ::before hit-slop, area-not-visual,
  44 AAA). S6 (Field composition) + S8 (calendar-surface) pending.

Verification: errors-outside-(alpha|words|palabras|chronos) == 59 (baseline);
morfo-vocabulary-check exit 0; eidos-lint class-hooks/invalid 0 on touched
components; per-component vitest suites green.

Handoff + remaining plan: docs/process/continue-audit-fixes-2026-07.md
Excluded (broken by the N1 rename, left broken per user decision, not staged):
words/**, palabras/**, chronos, web/routes/alpha/**.

Reconciliation pending: the touch-rows ::before for checkbox/switch reverses
changelog §37's earlier pseudo-element rejection (WCAG-overlap) that had routed
markers to a labeled-row/Field task — flagged for the user in the handoff.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

											
										
										
											3 months ago
+								# cropper — ficha de auditoría (RE-AUDITADA 2026-07-07, profundidad piloto)
 								- **Familia**: media/controls (recorte; capa zoom-pan compartida con image-picker) · **Método**: solo análisis · demos fuera
 								- **Capas leídas**: [morfo](../../../src/uix/morfo/components/cropper.ts) (148 líneas; eventos :31-73; **censo `apg:` = 0**) · pack ✓
 								- **Máquina**: PASS limpio · tests ✓ · README ×2 ✓ — **PERO ver F-2/F-3: dos cosas que no cazó**
 								## Dimensiones (evidencia leída)
-												style: prettier de una sola vez sobre el repositorio (F5 del cierre, parte 3)

Formato puro: `npm run format` (dos pases; siete ficheros no convergían en el
primero) sobre todo lo que .prettierignore no excluye (web/ congelado,
.claude/, artefactos generados). Este commit va en .git-blame-ignore-revs.

Neutralidad medida fichero a fichero, compilando y minificando con esbuild (y
con el compilador de Svelte, cliente y servidor, para .svelte) la versión de
HEAD y la formateada: 1 031 ficheros de código idénticos; 9 CSS que solo
difieren en espacios pegados a un paréntesis (`var( --x )` frente a
`var(--x)`), que CSS no tokeniza como significativos; 510 Markdown sin
compilación posible (docs:check los valida). Los dos generados y el guard que
dependía del formato se resolvieron en el commit anterior.

Verificación sobre este árbol: npm run lint exit 0 · gate entero verde salvo
focus-census, arreglado en el commit anterior y re-ejecutado (9/9): check:gate
OK (src/ y scripts/ a cero) · docs:check 0/0 · arts/blocks/packs/rtl/
translations/agent · eidos:lint 0 inválidos · apps:check (boot 27/27, 0
errores) · suite 465/466 → 466/466 con el guard corregido · build de la raíz
exit 0.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

											
										
										
											3 weeks ago
+								| #     | Dimensión            | Estado            | Evidencia                                                                                                                                                                                                                                                                                      |
 								| ----- | -------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 								| 2     | Naming               | hallazgo SYS-1    | **F-1: 8 hooks-clase** — el MAYOR ofensor del catálogo (button 6, image-picker 6)                                                                                                                                                                                                              |
 								| 3     | Coherencia semántica | ✓ con desajuste   | `handle-drag`/`handle-resize`/`handle-zoom` (:31-63 ✓ censo handle) + commit affirm (:64-69); **F-2**: el evento se llama `commit-crop` pero su verb es `'apply'` (:64-67) — el nombre rompe `{familia}-{verbo}` (sería commit-apply) y la regla A-3.6 no lo flagueó (cuarto agujero de regla) |
 								| 8     | Contrato morfo       | hallazgo          | **F-3**: sin cita `apg:` (censo = 0) con PASS — el A-1.4 tampoco lo cazó; caso "sin patrón oficial"                                                                                                                                                                                            |
 								| 12    | Runtime              | pendiente familia | Candidato del censo D13 (write-then-read): sus gestos miden el box — verificar `dom.measure` en provider al ejecutar                                                                                                                                                                           |
 								| resto |                      | ✓                 | Gestos, aspect locks, teclado de nudge; pack ✓; tests ✓                                                                                                                                                                                                                                        |
-												feat(audit): component re-audit + fixes P0–P5 (P4 complete, P5 in progress)

Re-audit of the whole component catalog at pilot depth (91 fichas + the
checkpoint verdicts in docs/audit/components/) and the executed fix packages.

- P0–P3: doctrine (sema participation, CANON §3 intent, component-guide §5 +
  API naming, §32 outline), guards (morfo-vocabulary-check S10/S11d,
  component-audit A-3.1/A-1.4/S9, eidos-lint classHooks), morfo contracts
  (role=application removed ×4, aria-selected off the Day, drp translationRef,
  field data-state prune, pin-input commit-set, media-player renames), 13 new
  sema packs + 12 morfos family-default → pack.
- P4 (N1–N10) COMPLETE: selectionMode (select/combobox/toggle-group/calendar);
  onValueCommit terminal-callback norm (pin-input/search/password/textarea +
  date/time/color-field add); typed validation reason + onInvalid (tags-input,
  css-field); index/onIndexChange (carousel); deselectable; openDelay/
  groupSkipDelay; allowCustomValue; defaultValue prune.
- P5 (in progress): S1 class-hooks codemod (22 hooks → data-attrs across
  cropper/button/image-picker/toggle/image-adjustments); S5 outline remnant in
  field.css; depth pass (data-depth=overlay on tooltip/toast/float-panel);
  touch-rows (--touch-target token, decoupled ::before hit-slop, area-not-visual,
  44 AAA). S6 (Field composition) + S8 (calendar-surface) pending.

Verification: errors-outside-(alpha|words|palabras|chronos) == 59 (baseline);
morfo-vocabulary-check exit 0; eidos-lint class-hooks/invalid 0 on touched
components; per-component vitest suites green.

Handoff + remaining plan: docs/process/continue-audit-fixes-2026-07.md
Excluded (broken by the N1 rename, left broken per user decision, not staged):
words/**, palabras/**, chronos, web/routes/alpha/**.

Reconciliation pending: the touch-rows ::before for checkbox/switch reverses
changelog §37's earlier pseudo-element rejection (WCAG-overlap) that had routed
markers to a labeled-row/Field task — flagged for the user in the handoff.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

											
										
										
											3 months ago
 								## Hallazgos y propuestas
-												style: prettier de una sola vez sobre el repositorio (F5 del cierre, parte 3)

Formato puro: `npm run format` (dos pases; siete ficheros no convergían en el
primero) sobre todo lo que .prettierignore no excluye (web/ congelado,
.claude/, artefactos generados). Este commit va en .git-blame-ignore-revs.

Neutralidad medida fichero a fichero, compilando y minificando con esbuild (y
con el compilador de Svelte, cliente y servidor, para .svelte) la versión de
HEAD y la formateada: 1 031 ficheros de código idénticos; 9 CSS que solo
difieren en espacios pegados a un paréntesis (`var( --x )` frente a
`var(--x)`), que CSS no tokeniza como significativos; 510 Markdown sin
compilación posible (docs:check los valida). Los dos generados y el guard que
dependía del formato se resolvieron en el commit anterior.

Verificación sobre este árbol: npm run lint exit 0 · gate entero verde salvo
focus-census, arreglado en el commit anterior y re-ejecutado (9/9): check:gate
OK (src/ y scripts/ a cero) · docs:check 0/0 · arts/blocks/packs/rtl/
translations/agent · eidos:lint 0 inválidos · apps:check (boot 27/27, 0
errores) · suite 465/466 → 466/466 con el guard corregido · build de la raíz
exit 0.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

											
										
										
											3 weeks ago
+								| ID      | Hallazgo                                                                                                                                                                                                                                                               | Propuesta                                      |
 								| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
 								| **F-1** | 8 hooks-clase                                                                                                                                                                                                                                                          | Codemod SYS-1                                  |
 								| ~~F-2~~ | _(RETIRADO en P1: `apply` ES canónico — extensión de autor, verbs.ts :97 — y `commit-crop` es etiqueta de dominio autorizada por el libro cap. 8 §1; vocab-check lo lista como warn de descubribilidad, no violación. Rename a `commit-apply-crop` = pulido opcional)_ | —                                              |
 								| **F-3** | Sin APG (regla no cazó)                                                                                                                                                                                                                                                | Regla "apg: none — rationale" + fix del script |
-												feat(audit): component re-audit + fixes P0–P5 (P4 complete, P5 in progress)

Re-audit of the whole component catalog at pilot depth (91 fichas + the
checkpoint verdicts in docs/audit/components/) and the executed fix packages.

- P0–P3: doctrine (sema participation, CANON §3 intent, component-guide §5 +
  API naming, §32 outline), guards (morfo-vocabulary-check S10/S11d,
  component-audit A-3.1/A-1.4/S9, eidos-lint classHooks), morfo contracts
  (role=application removed ×4, aria-selected off the Day, drp translationRef,
  field data-state prune, pin-input commit-set, media-player renames), 13 new
  sema packs + 12 morfos family-default → pack.
- P4 (N1–N10) COMPLETE: selectionMode (select/combobox/toggle-group/calendar);
  onValueCommit terminal-callback norm (pin-input/search/password/textarea +
  date/time/color-field add); typed validation reason + onInvalid (tags-input,
  css-field); index/onIndexChange (carousel); deselectable; openDelay/
  groupSkipDelay; allowCustomValue; defaultValue prune.
- P5 (in progress): S1 class-hooks codemod (22 hooks → data-attrs across
  cropper/button/image-picker/toggle/image-adjustments); S5 outline remnant in
  field.css; depth pass (data-depth=overlay on tooltip/toast/float-panel);
  touch-rows (--touch-target token, decoupled ::before hit-slop, area-not-visual,
  44 AAA). S6 (Field composition) + S8 (calendar-surface) pending.

Verification: errors-outside-(alpha|words|palabras|chronos) == 59 (baseline);
morfo-vocabulary-check exit 0; eidos-lint class-hooks/invalid 0 on touched
components; per-component vitest suites green.

Handoff + remaining plan: docs/process/continue-audit-fixes-2026-07.md
Excluded (broken by the N1 rename, left broken per user decision, not staged):
words/**, palabras/**, chronos, web/routes/alpha/**.

Reconciliation pending: the touch-rows ::before for checkbox/switch reverses
changelog §37's earlier pseudo-element rejection (WCAG-overlap) that had routed
markers to a labeled-row/Field task — flagged for the user in the handoff.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

											
										
										
											3 months ago
 								## Escalan al sistema
 								SYS-1 (top) · censos A-3.6/A-1.4 (agujeros del script ×4 ya) · censo D13 (candidato) · censo handle.
 								## Veredictos
-												style: prettier de una sola vez sobre el repositorio (F5 del cierre, parte 3)

Formato puro: `npm run format` (dos pases; siete ficheros no convergían en el
primero) sobre todo lo que .prettierignore no excluye (web/ congelado,
.claude/, artefactos generados). Este commit va en .git-blame-ignore-revs.

Neutralidad medida fichero a fichero, compilando y minificando con esbuild (y
con el compilador de Svelte, cliente y servidor, para .svelte) la versión de
HEAD y la formateada: 1 031 ficheros de código idénticos; 9 CSS que solo
difieren en espacios pegados a un paréntesis (`var( --x )` frente a
`var(--x)`), que CSS no tokeniza como significativos; 510 Markdown sin
compilación posible (docs:check los valida). Los dos generados y el guard que
dependía del formato se resolvieron en el commit anterior.

Verificación sobre este árbol: npm run lint exit 0 · gate entero verde salvo
focus-census, arreglado en el commit anterior y re-ejecutado (9/9): check:gate
OK (src/ y scripts/ a cero) · docs:check 0/0 · arts/blocks/packs/rtl/
translations/agent · eidos:lint 0 inválidos · apps:check (boot 27/27, 0
errores) · suite 465/466 → 466/466 con el guard corregido · build de la raíz
exit 0.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

											
										
										
											3 weeks ago
+								_(pendiente — checkpoint post-barrido)_