2 Commits (3bf7930baa3ae26ccb38e7f33d3fb488df73f06a)

Author	SHA1	Message	Date
dev	f3bf6a0299	docs(blocks): la ficha del shell cabía en cinco líneas porque no miraba el ecosistema ... Fase 0 de F3.1 `app-shell`, firmada. La ficha original se escribió antes de que existieran el canon `Sidebar` y la capa `affix`, y el autor preguntó lo que había que preguntar: si su alcance tenía delante `active-app` y `active-uix` enteros. No los tenía. Las cuatro decisiones que se firman, y lo que las obligó: - **Q1 — el block NO cablea servicios.** La integración del ecosistema se demuestra en una app de referencia en app-land, no dentro del block. Un shell que leyera `App.session` para dibujar el menú de usuario sería una raíz de composición disfrazada: funcionaría, y metería el arranque del ecosistema dentro de una pieza que ha de poder caer en cualquier app. - **Q2 — dos modelos de scroll por prop.** `main` (rejilla 100dvh, sin fixed, sin números) es lo que cierra A-95 por construcción; `body` es lo que `docs-shell` necesitará para anclas y TOC pegada. - **Q3 — cabecera dentro del inset.** El provider del `Sidebar` ES la fila flex, así que su `Trigger` sólo vive dentro. Una cabecera a todo lo ancho exigiría partir ese provider: queda como gap de canon para v2. - **Q4 — canon `skip-link` + uno por región montada** (técnica G124). De paso, tres cosas que estaban mal escritas y ahora lo dicen: - El dossier afirmaba que **ninguna referencia trae skip-link** y que era superación nuestra. Es falso: Polaris lo trae en `Frame` y Atlassian genera un menú entero. La superación real es generarlos del mismo contrato que estampa el landmark. Y el icon-rail no es de Mantine (su `collapsed` es booleano); es de shadcn, AntD, Toolpad y Atlassian. El dossier tampoco miró nunca el `navigation-system` actual de Atlassian, y el `page-layout` que sí miró está deprecado. - **D-BLK.6 ha derivado**: la celda dice «ni prefs ni langs ni eidos» y la doctrina vigente (`blocks.md` §Services) sancionó dos servicios en julio y agosto. Queda enmendada con lo que sigue siendo cierto: ningún block CREA ni cablea servicios. - **E-5 está desfasada**: `Command.Dialog` ya trae el atajo (`shortcut`, `mod+k` por defecto). El listener a mano de F4.1 no hay que escribirlo. - **F3.2 `auth`**: la ficha dice cuatro vistas y el dominio tiene seis. Falta `update-password`, que no es un lujo — es donde aterriza el enlace de recuperación, y sin ella el camino de `recover` no termina. `blocks.md` gana un párrafo «Shells» bajo §Conventions: qué poseen (geometría, landmarks, alturas) y dónde está la línea (la raíz de composición es de la app). Verificado en código antes de escribirlo: `Sidebar.Inset` acepta `child`, `Box` expone minHeight/position/overflow y `Grid` templateRows —la rejilla del shell no necesita CSS propio—, y `Sticky` expone `root`. docs:check 0 errores, 0 avisos (635 docs). Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2 months ago
dev	aff42fee0f	docs(blocks): dossier de referencia — 6 pistas, suelos de paridad + enmiendas E-1..E-5 ... Encargo del usuario (2026-07-21): estudio de referencia para "estar al menos a la par y cuanto menos superarlo". 6 agentes de investigación web en paralelo sobre fuentes oficiales vivas (varias verificadas a nivel de código fuente: sidebar.tsx del registry shadcn, styles.js de tailwind-typography, sources de Mantine/Starlight/Docusaurus/Ark). - docs/process/RESEARCH-blocks-references.md — el dossier: P1 catálogos de marketing (conteos+variantes) · P2 aplicación (ProTable/ProLayout, dashboard-01, Tremor 303, Clerk/Supabase) · P3 F1 ligeros (APIs a nivel de prop; scroll-state(stuck) como vocabulario de plataforma; role=alert de shadcn = bug a no copiar) · P4 prose+sidebar (not-prose/:where()+donut; shadcn 23 partes) · P5 docs shells (Fumadocs benchmark; colision F1.7 vs nav-tree/B-5; ruta svelte2tsx para props TS) · P6 ecosistema Svelte (shadcn-svelte 58 blocks solo-app; hueco "sistema integrado" VACIO) + sintesis: 5 conclusiones, enmiendas E-1..E-5 (presentadas, firmas pendientes), 10 angulos de superacion. - PLAN-blocks.md — regla nueva §4 (toda fase 0 contrasta contra el dossier), puntero de colision en F1.7, registro. Verificacion: docs:check 0/0 (512 docs). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	3 months ago