Skip to content

v0.2.0 — la segunda cosecha

Choose a tag to compare

@rodrigoteamx rodrigoteamx released this 04 Jul 00:41

La segunda cosecha: documentación versionada, artefactos de contenido, vocabulario de layouts y el contrato de theming para plugins.

npm i @milpa/design

63 piezas con contrato · 193 pares WCAG AA (dark + light, verificados en CI) · todo el CSS publicado en @layer milpa.*.

Added

  • Theming inyectable (la costura para plugins). Todo el CSS publicado declara el orden canónico @layer milpa.tokens, …, milpa.layouts y envuelve sus reglas en su capa: el CSS sin layer del consumidor/plugin siempre gana — sin !important, sin guerras de especificidad. Tres niveles en THEMING.md (retokenizar / reskin / reemplazo total). theme.contract.json (generado, drift-gated) publica los tokens requeridos + los pares AA como datos + invariantes; scripts/verify-theme.mjs (npm run verify:theme) es el validador de referencia.
  • Tokens nuevos: --syntax-* (11, highlighting de código, cada color 4.5:1 sobre --syntax-bg en ambos temas) y --viz-1..6 + --viz-*-active (charts categóricos, 3:1, separación verificada para daltonismo).
  • artifacts/el elote, 15 piezas de contenido: Code, Terminal, CodeGroup, Chart (bars/line/donut/sparkline), Quote, Callout, Api, Steps, FileTree, Prose, Toc, Search (⌘K) + el kit de versionado (VersionSwitcher, VersionBanner, Changelog) y las variantes de estabilidad del Badge (--since / --deprecated / --experimental).
  • layouts/la parcela, 11 piezas de estructura: mui-docs (shell de documentación versionada), Page/Section/Container, Hero, FeatureGrid, CtaBand, Pricing, Faq, Testimonial, Footer, MediaGrid, Lightbox.
  • Commerce en components/: ProductCard, Price, Rating, MediaGallery, CartLine.
  • Seis battle-tests en proof/ (compuestos SOLO del sistema): docs, blog, commerce, gallery (lightbox real con teclado), saas y themed — el blog vistiendo el skin "Nopal" (validado 193/193) sin tocar un solo bundle.
  • Exports nuevos: ./artifacts.css, ./layouts.css, ./theme, ./artifacts/*, ./layouts/*, ./package.json.

Changed

  • Todo el CSS publicado vive en cascade layers — nota de compat: los overrides sin layer de consumidores existentes ahora ganan SIEMPRE (antes dependían de especificidad). Es una mejora de comportamiento de cascada → minor bump.
  • Gate: 135 → 193 checks AA. Governance verifica la declaración @layer de cada CSS publicado (63 contratos).
  • La landing pasa a inglés (el mantra "Siembra módulos, cosecha aplicaciones." queda en español, es la firma) y consume el vocabulario nuevo de layouts/.

Changelog completo: CHANGELOG.md · La constitución: DESIGN.md