From b4e4fe1fe8989e5a2980866659042bbeb3fbc326 Mon Sep 17 00:00:00 2001 From: dev Date: Sun, 23 Aug 2026 23:33:43 +0200 Subject: [PATCH] docs(theming): la sonda y el guard no se pueden lanzar con --import tsx/esm MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Medido supervisando calendar. Cualquier script del eje que use page.evaluate muere con «ReferenceError: __name is not defined» DENTRO del navegador: el transform de esbuild que trae tsx envuelve las funciones con su ayudante keepNames, el cuerpo de la evaluación viaja serializado a la página y llega sin él. Reproducido en __theming-probe.ts y en theming-sentinel.ts. Se lanzan con node a secas — Node 24 desnuda los tipos de forma nativa, que es justo lo que hace npm run theming:sentinel. Sólo los scripts SIN page.evaluate (censo, component-audit, eidos-lint) toleran el --import tsx/esm. Vale una sesión entera si se confunde, porque el error no nombra ni a tsx ni a la sonda: nombra una variable que nadie ha escrito. Co-Authored-By: Claude Opus 5 --- docs/next-features.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/next-features.md b/docs/next-features.md index e52a8aadc..7e7851f89 100644 --- a/docs/next-features.md +++ b/docs/next-features.md @@ -1443,6 +1443,20 @@ Lo que `chart` destapó (2026-08-22): chevron, con lo que los dos tokens de reposo del trigger leen muertos. Miden bien con el panel CERRADO. No hay arreglo dentro de una corrida: el instrumento sólo puede estar en un estado a la vez; se adjudica. +- **⚠ LA SONDA Y EL GUARD NO SE PUEDEN LANZAR CON `--import tsx/esm`** (medido + 2026-08-24 supervisando `calendar`). Cualquier script del eje que use + `page.evaluate` muere con `ReferenceError: __name is not defined` dentro del + navegador: el transform de esbuild que trae `tsx` envuelve las funciones con + su ayudante `keepNames`, y ese ayudante existe en Node, no en la página — el + cuerpo de la evaluación viaja serializado y llega sin él. Reproducido en + `__theming-probe.ts` y en `theming-sentinel.ts`. + + Se lanzan con **`node` a secas** (Node 24 desnuda los tipos de forma nativa), + que es justo lo que hace `npm run theming:sentinel`. Sólo los scripts SIN + `page.evaluate` —el censo, `component-audit`, `eidos-lint`— toleran el + `--import tsx/esm`. Cuesta una sesión entera si se confunde, porque el error + no nombra ni a tsx ni a la sonda. + - **Un token VIVO sobre un nodo APLASTADO lee igual que uno muerto** (medido 2026-08-24 en `select.separator-size`). El separador vive en la columna flex del `ScrollArea` con `flex-shrink` 1 y el panel desborda (scrollHeight 670 vs