@higinio/design-mcp 0.2.0 → 0.2.1

package/assets/celeste/styleguide.html

@@ -15,29 +15,36 @@
   })();
 </script>
 <style>
-/* ==========================================================================
-   CELESTE CLÁSICA — Framework CSS v2.0 (embebido)
-   Idéntico a dist/celeste-clasica/celeste-clasica.css
-   ========================================================================== */
+/* ============================================================
+   Celeste Clásica — Design Tokens v2.0
+   Sistema de diseño de Higinio Sosa · light-first
+   Fuente de verdad: DESIGN-celeste-clasica.md
+   Uso: importar ANTES de cualquier estilo propio.
+   Los componentes consumen SOLO aliases semánticos, nunca hex.
+   ============================================================ */
 
 @import url("https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,600;0,9..144,700;1,9..144,600&family=Public+Sans:ital,wght@0,400;0,500;0,600;0,700;1,400&family=IBM+Plex+Mono:wght@400;500&display=swap");
 
 :root {
+  /* == Primitivos: primario (Azul Acero) == */
   --primary-50: #f2f6fa; --primary-100: #dfe9f2; --primary-200: #c3d5e6;
   --primary-300: #a0c0d4; --primary-400: #87a8c7; --primary-500: #7192ba;
   --primary-600: #5d7ba3; --primary-700: #4d6588; --primary-800: #40536e;
   --primary-900: #31343e;
 
+  /* == Primitivos: neutrales (Gris Azulado) == */
   --neutral-0: #ffffff; --neutral-50: #f7f8fa; --neutral-100: #eef0f3;
   --neutral-200: #dcdfe5; --neutral-300: #b8bdc7; --neutral-400: #8a8f9c;
   --neutral-500: #666b78; --neutral-600: #4d5160; --neutral-700: #3d414e;
   --neutral-800: #31343e; --neutral-900: #22242b;
 
+  /* == Primitivos: semánticos (ramp de 3: sólido / fondo / texto AA) == */
   --success-500: #3d9970; --success-100: #e2f3ec; --success-text: #2b6e50;
   --warning-500: #c9922e; --warning-100: #faf1de; --warning-text: #8a651c;
   --danger-500: #c04d4d;  --danger-100: #f9e7e7;  --danger-text: #8f3232;
   --info-500: #7192ba;    --info-100: #dfe9f2;    --info-text: #4d6588;
 
+  /* == Aliases semánticos (los componentes consumen SOLO esto) == */
   --bg: var(--neutral-50);
   --surface: var(--neutral-0);
   --surface-alt: var(--neutral-100);
@@ -54,11 +61,9 @@
   --accent-active: var(--primary-700);
   --accent-soft: var(--primary-50);
   --accent-soft-strong: var(--primary-100);
-  --link: var(--primary-700);
-  --overlay: rgba(49, 52, 62, .5);
-  --tooltip-bg: var(--neutral-900);
-  --tooltip-text: #ffffff;
+  --link: var(--primary-700); /* AA ~6:1 — texto de links y ghost; primary-500 solo para UI */
 
+  /* == Tipografía == */
   --font-display: "Fraunces", Georgia, serif;
   --font-body: "Public Sans", system-ui, -apple-system, sans-serif;
   --font-mono: "IBM Plex Mono", ui-monospace, monospace;
@@ -72,6 +77,7 @@
   --weight-regular: 400; --weight-medium: 500; --weight-semibold: 600; --weight-bold: 700;
   --measure: 65ch;
 
+  /* == Espaciado (escala base 4px) == */
   --space-1: 4px; --space-2: 8px; --space-3: 12px; --space-4: 16px;
   --space-5: 20px; --space-6: 24px; --space-8: 32px; --space-10: 40px;
   --space-12: 48px; --space-16: 64px; --space-20: 80px; --space-24: 96px;
@@ -81,6 +87,7 @@
   --control-height-sm: 36px; --control-height-md: 44px; --control-height-lg: 52px;
   --gutter: 24px; --gutter-mobile: 16px;
 
+  /* == Radios, bordes y sombras (teñidas de tinta, nunca negro puro) == */
   --radius-sm: 6px; --radius-md: 10px; --radius-lg: 14px;
   --radius-xl: 20px; --radius-full: 9999px;
   --border-width: 1px;
@@ -90,20 +97,60 @@
   --shadow-lg: 0 12px 24px rgba(49,52,62,.12), 0 4px 8px rgba(49,52,62,.06);
   --shadow-xl: 0 24px 48px rgba(49,52,62,.16);
 
+  /* == Focus == */
   --ring: 0 0 0 3px rgba(113,146,186,.25);
   --ring-color: rgba(113,146,186,.25);
-  --ring-danger: 0 0 0 3px rgba(192,77,77,.22);
 
+  /* == Motion == */
   --duration-instant: 100ms; --duration-fast: 150ms; --duration-base: 200ms;
   --duration-slow: 250ms; --duration-page: 320ms;
   --ease-out: cubic-bezier(0.2, 0, 0, 1);
   --ease-in: cubic-bezier(0.4, 0, 1, 1);
   --ease-in-out: cubic-bezier(0.65, 0, 0.35, 1); /* moverse de A a B en pantalla */
   --ease-spring: cubic-bezier(0.34, 1.4, 0.64, 1);
+  --stagger-step: 30ms;
 
   color-scheme: light;
-}
 
+  --overlay: rgba(49, 52, 62, .5);
+  --tooltip-bg: var(--neutral-900);
+  --tooltip-text: #ffffff;
+  --ring-danger: 0 0 0 3px rgba(192,77,77,.22);
+
+  --action-bg: var(--primary-700);
+  --action-hover: var(--primary-800);
+  --action-active: var(--primary-900);
+  --text-on-action: var(--text-on-primary);
+  --control-border: var(--neutral-400);
+  --placeholder: var(--text-muted);
+  --selection-bg: var(--action-bg);
+  --selection-text: var(--text-on-action);
+  --font-ui-heading: var(--font-body);
+  --text-ui-title: 2rem;
+  --touch-target: 44px;
+  --focus-color: var(--accent);
+  --text-display-fluid: clamp(2.75rem, 1.7rem + 3vw, 4.75rem);
+  --border-hover: var(--neutral-500);
+  --text-on-danger: #ffffff;
+
+  /* Series categóricas: orden estable; acompañar con etiqueta o forma. */
+  --chart-1: #4a8cc1;
+  --chart-2: #853f63;
+  --chart-3: #129a92;
+  --chart-4: #8e4031;
+  --chart-5: #5b975e;
+  --chart-6: #8a600a;
+  --chart-7: #857bc1;
+  /* Ritmo de contenido y formularios. */
+  --field-gap: 6px;
+  --heading-gap: var(--space-2);
+  --content-gap: var(--space-4);
+  --card-content-gap: var(--space-4);
+  --card-group-gap: var(--space-6);
+
+}
+
+/* == Modo oscuro (variante) — alternar data-theme en <html> == */
 [data-theme="dark"] {
   --bg: #16181e;
   --surface: #1d2028;
@@ -120,28 +167,58 @@
   --accent-soft: rgba(113,146,186,.12);
   --accent-soft-strong: rgba(113,146,186,.18);
   --text-on-primary: #16181e;
-  --text-on-primary-solid: #a0c0d4;
   --link: #a0c0d4;
-  --overlay: rgba(0, 0, 0, .6);
-  --tooltip-bg: #e6e9ee;
-  --tooltip-text: #31343e;
   --success-500: #5cbf93; --success-100: #12291f; --success-text: #7fd4ae;
   --warning-500: #e0ad4d; --warning-100: #2b2210; --warning-text: #ecc57e;
   --danger-500: #e07777;  --danger-100: #2e1515;  --danger-text: #eb9e9e;
   --info-500: #87a8c7;    --info-100: #1a2430;    --info-text: #a0c0d4;
   --ring: 0 0 0 3px rgba(160,192,212,.3);
-  --ring-danger: 0 0 0 3px rgba(224,119,119,.25);
+  --ring-color: rgba(160,192,212,.3);
   --shadow-sm: 0 1px 2px rgba(0,0,0,.35);
   --shadow-md: 0 4px 12px rgba(0,0,0,.45);
   --shadow-lg: 0 12px 32px rgba(0,0,0,.55);
   color-scheme: dark;
+
+  --text-on-primary-solid: #a0c0d4;
+  --overlay: rgba(0, 0, 0, .6);
+  --tooltip-bg: #e6e9ee;
+  --tooltip-text: #31343e;
+  --ring-danger: 0 0 0 3px rgba(224,119,119,.25);
+
+  --selection-bg: var(--action-bg);
+  --selection-text: var(--text-on-action);
+  --action-bg: var(--accent);
+  --action-hover: var(--accent-hover);
+  --action-active: var(--accent-active);
+  --control-border: var(--text-muted);
+  --border-hover: var(--text-secondary);
+  --text-on-danger: #16181e;
+  --focus-color: var(--accent);
+
+  /* Series categóricas: orden estable; acompañar con etiqueta o forma. */
+  --chart-1: #5798ce;
+  --chart-2: #a0587c;
+  --chart-3: #2aa79e;
+  --chart-4: #aa5849;
+  --chart-5: #67a369;
+  --chart-6: #946a1c;
+  --chart-7: #877cc3;
+}
+
+/* == Accesibilidad del movimiento == */
+
+@media (prefers-reduced-motion: reduce) {
+  :root {
+    --duration-instant: 0ms; --duration-fast: 0ms; --duration-base: 0ms;
+    --duration-slow: 0ms; --duration-page: 0ms; --stagger-step: 0ms;
+  }
 }
 
 *, *::before, *::after { box-sizing: border-box; }
-html, body { overflow-x: clip; }
 
+/* Focus ring global de teclado — especificidad cero vía :where() */
 :where(a, button, [role="button"], input, select, textarea, summary, [tabindex]):focus-visible {
-  outline: 2px solid var(--primary-500);
+  outline: 2px solid var(--focus-color);
   outline-offset: 2px;
   border-radius: 2px;
 }
@@ -178,18 +255,14 @@ html, body { overflow-x: clip; }
 .celeste-reset h6 { font-size: var(--text-base); line-height: var(--leading-base); }
 .celeste-reset p { max-width: var(--measure); margin: 0 0 1em; }
 .celeste-reset table { font-variant-numeric: tabular-nums; }
-.celeste-reset ::placeholder { color: var(--text-disabled); }
+.celeste-reset ::placeholder { color: var(--placeholder); }
 .celeste-reset ::selection { background: rgba(113,146,186,.25); }
 
-@media (prefers-reduced-motion: reduce) {
-  *, *::before, *::after {
-    animation-duration: 0.01ms !important;
-    animation-iteration-count: 1 !important;
-    transition-duration: 0.01ms !important;
-    scroll-behavior: auto !important;
-  }
-}
 
+
+/* --------------------------------------------------------------------------
+   3. LAYOUT — contenedor, grid 12 col (§14)
+   -------------------------------------------------------------------------- */
 .container { width: 100%; margin-inline: auto; padding-inline: var(--gutter-mobile); }
 @media (min-width: 640px)  { .container { padding-inline: var(--space-4); } }
 @media (min-width: 768px)  { .container { max-width: 720px; } }
@@ -211,6 +284,9 @@ html, body { overflow-x: clip; }
   .col-lg-6{grid-column:span 6}.col-lg-8{grid-column:span 8}.col-lg-12{grid-column:span 12}
 }
 
+/* --------------------------------------------------------------------------
+   4. BOTONES (§10.1) · ICON BUTTON (§10.2) · SPINNER (§10.3)
+   -------------------------------------------------------------------------- */
 .btn {
   display: inline-flex; align-items: center; justify-content: center; gap: var(--space-2);
   height: var(--control-height-md); padding: var(--button-padding-md);
@@ -227,15 +303,15 @@ html, body { overflow-x: clip; }
 .btn:disabled { cursor: not-allowed; }
 .btn svg { width: 20px; height: 20px; flex: none; }
 
-/* Gating de hover (§11.5): los hover que mueven/elevan van dentro de
-   @media (hover: hover) and (pointer: fine) — en touch el tap deja el hover pegado.
-   Los hover de solo color/fondo quedan fuera. */
-.btn--primary { background: var(--accent); color: var(--text-on-primary); }
-.btn--primary:hover:not(:disabled) { background: var(--accent-hover); }
+/* Gating de hover (§11.5): los hover que mueven/elevan (transform, box-shadow) van
+   dentro de @media (hover: hover) and (pointer: fine) — en touch el tap dispara
+   hovers falsos que se quedan pegados. Los hover de solo color/fondo quedan fuera. */
+.btn--primary { background: var(--action-bg); color: var(--text-on-action); }
+.btn--primary:hover:not(:disabled) { background: var(--action-hover); }
 @media (hover: hover) and (pointer: fine) {
   .btn--primary:hover:not(:disabled) { box-shadow: var(--shadow-sm); }
 }
-.btn--primary:active:not(:disabled) { background: var(--accent-active); box-shadow: none; }
+.btn--primary:active:not(:disabled) { background: var(--action-active); box-shadow: none; }
 .btn--primary:disabled { background: var(--border); color: var(--text-disabled); box-shadow: none; }
 
 .btn--secondary { background: var(--surface); border-color: var(--border-strong); color: var(--text-primary); }
@@ -253,7 +329,7 @@ html, body { overflow-x: clip; }
 .btn--ghost:active:not(:disabled) { background: var(--accent-soft-strong); }
 .btn--ghost:disabled { background: var(--border); color: var(--text-disabled); }
 
-.btn--danger { background: var(--danger-500); color: #fff; }
+.btn--danger { background: var(--danger-500); color: var(--text-on-danger); }
 .btn--danger:hover:not(:disabled) { background: color-mix(in srgb, var(--danger-500) 92%, #000); }
 .btn--danger:active:not(:disabled) { background: color-mix(in srgb, var(--danger-500) 86%, #000); }
 .btn--danger:disabled { opacity: .5; }
@@ -261,9 +337,10 @@ html, body { overflow-x: clip; }
 .btn--sm { height: var(--control-height-sm); padding: var(--button-padding-sm); font-size: var(--text-sm); }
 .btn--lg { height: var(--control-height-lg); padding: 14px 24px; font-size: var(--text-lg); }
 
+/* IconButton — requiere aria-label */
 .icon-btn {
   display: inline-grid; place-items: center;
-  width: var(--control-height-md); height: var(--control-height-md); padding: 0;
+  width: 40px; height: 40px; padding: 0;
   border: var(--border-width) solid transparent; border-radius: var(--radius-md);
   background: transparent; color: var(--text-secondary); cursor: pointer;
   transition: background-color var(--duration-fast) var(--ease-out),
@@ -273,7 +350,7 @@ html, body { overflow-x: clip; }
 .icon-btn:active:not(:disabled) { transform: scale(.98); }
 .icon-btn:disabled { opacity: .5; cursor: not-allowed; }
 .icon-btn svg { width: 18px; height: 18px; }
-.icon-btn--sm { width: var(--control-height-sm); height: var(--control-height-sm); } .icon-btn--sm svg { width: 16px; height: 16px; }
+.icon-btn--sm { width: 32px; height: 32px; } .icon-btn--sm svg { width: 16px; height: 16px; }
 .icon-btn--lg { width: 48px; height: 48px; } .icon-btn--lg svg { width: 20px; height: 20px; }
 .icon-btn--ghost:hover:not(:disabled) { background: var(--surface-alt); color: var(--text-primary); }
 .icon-btn--primary { background: var(--accent); color: var(--text-on-primary); }
@@ -281,15 +358,19 @@ html, body { overflow-x: clip; }
 .icon-btn--secondary { background: var(--surface); border-color: var(--border-strong); }
 .icon-btn--secondary:hover:not(:disabled) { background: var(--bg); }
 
+/* Spinner */
 .spinner { width: 16px; height: 16px; animation: cc-spin .8s linear infinite; color: var(--accent); }
 .spinner circle { opacity: .25; }
 .spinner path { opacity: 1; }
 @keyframes cc-spin { to { transform: rotate(360deg); } }
 
+/* --------------------------------------------------------------------------
+   5. FORMULARIOS — field, input, textarea, select (§10.4–10.6)
+   -------------------------------------------------------------------------- */
 .field { display: flex; flex-direction: column; gap: 6px; }
 .field__label { font-size: var(--text-sm); font-weight: var(--weight-medium); color: var(--text-secondary); }
 .field__help { font-size: var(--text-sm); color: var(--text-muted); }
-.field__error { font-size: var(--text-sm); color: var(--danger-500); display: inline-flex; align-items: center; gap: 6px; }
+.field__error { font-size: var(--text-sm); color: var(--danger-text); display: inline-flex; align-items: center; gap: 6px; }
 .field__error svg { width: 14px; height: 14px; flex: none; }
 /* Campo obligatorio (§10.4): asterisco decorativo; el input lleva required/aria-required */
 .field--required .field__label::after { content: " *"; color: var(--danger-500); }
@@ -297,14 +378,14 @@ html, body { overflow-x: clip; }
 .input, .textarea, .select {
   width: 100%; font-family: var(--font-body); font-size: var(--text-base);
   color: var(--text-primary); background: var(--surface);
-  border: var(--border-width) solid var(--border-strong); border-radius: var(--radius-sm);
+  border: var(--border-width) solid var(--control-border); border-radius: var(--radius-sm);
   transition: border-color var(--duration-fast) var(--ease-out),
               box-shadow var(--duration-fast) var(--ease-out);
 }
 .input, .select { height: var(--control-height-md); padding: 0 14px; }
 .input:hover:not(:disabled):not(:focus),
 .textarea:hover:not(:disabled):not(:focus),
-.select:hover:not(:disabled):not(:focus) { border-color: var(--text-disabled); }
+.select:hover:not(:disabled):not(:focus) { border-color: var(--border-hover); }
 .input:focus, .textarea:focus, .select:focus {
   outline: none; border-color: var(--accent); box-shadow: var(--ring);
 }
@@ -335,6 +416,9 @@ html, body { overflow-x: clip; }
   transition: transform var(--duration-base) var(--ease-out);
 }
 
+/* --------------------------------------------------------------------------
+   6. SEGMENTED CONTROL (§10.7) · SLIDER (§10.8)
+   -------------------------------------------------------------------------- */
 .segmented {
   display: inline-flex; align-items: stretch;
   background: var(--surface-alt); border-radius: var(--radius-md); padding: 3px;
@@ -355,7 +439,7 @@ html, body { overflow-x: clip; }
   background: var(--surface); color: var(--text-primary);
   font-weight: var(--weight-semibold); box-shadow: var(--shadow-xs);
 }
-.segmented input:focus-visible + label { outline: 2px solid var(--primary-500); outline-offset: 2px; }
+.segmented input:focus-visible + label { outline: 2px solid var(--focus-color); outline-offset: 2px; }
 
 .slider-row { display: flex; justify-content: space-between; align-items: baseline; margin-bottom: 10px; }
 .slider-row .slider-label { font-size: var(--text-sm); color: var(--text-secondary); }
@@ -380,6 +464,9 @@ html, body { overflow-x: clip; }
 }
 .slider:active::-moz-range-thumb { transform: scale(1.15); }
 
+/* --------------------------------------------------------------------------
+   7. SELECCIÓN — checkbox, radio, switch (§10.9–10.10)
+   -------------------------------------------------------------------------- */
 .checkbox, .radio {
   display: inline-flex; align-items: center; gap: 10px;
   font-size: var(--text-base); color: var(--text-primary); cursor: pointer; position: relative;
@@ -389,7 +476,7 @@ html, body { overflow-x: clip; }
 }
 .checkbox__box {
   width: 20px; height: 20px; flex: none; display: grid; place-items: center;
-  background: var(--surface); border: 2px solid var(--border-strong); border-radius: 4px;
+  background: var(--surface); border: 2px solid var(--control-border); border-radius: 4px;
   transition: background-color var(--duration-fast) var(--ease-out),
               border-color var(--duration-fast) var(--ease-out);
 }
@@ -399,7 +486,7 @@ html, body { overflow-x: clip; }
   stroke-dasharray: 20; stroke-dashoffset: 20;
   transition: stroke-dashoffset var(--duration-base) var(--ease-spring);
 }
-.checkbox:hover .checkbox__box { border-color: var(--primary-400); }
+.checkbox:hover .checkbox__box { border-color: var(--focus-color); }
 .checkbox input:checked ~ .checkbox__box { background: var(--accent); border-color: var(--accent); }
 .checkbox input:checked ~ .checkbox__box svg { stroke-dashoffset: 0; }
 .checkbox input:focus-visible ~ .checkbox__box { box-shadow: var(--ring); }
@@ -416,7 +503,7 @@ html, body { overflow-x: clip; }
 
 .radio__dot {
   width: 20px; height: 20px; flex: none; display: grid; place-items: center;
-  background: var(--surface); border: 2px solid var(--border-strong); border-radius: var(--radius-full);
+  background: var(--surface); border: 2px solid var(--control-border); border-radius: var(--radius-full);
   transition: background-color var(--duration-fast) var(--ease-out),
               border-color var(--duration-fast) var(--ease-out);
 }
@@ -425,7 +512,7 @@ html, body { overflow-x: clip; }
   background: var(--text-on-primary); transform: scale(0);
   transition: transform var(--duration-base) var(--ease-spring);
 }
-.radio:hover .radio__dot { border-color: var(--primary-400); }
+.radio:hover .radio__dot { border-color: var(--focus-color); }
 .radio input:checked ~ .radio__dot { background: var(--accent); border-color: var(--accent); }
 .radio input:checked ~ .radio__dot::after { transform: scale(1); }
 .radio input:focus-visible ~ .radio__dot { box-shadow: var(--ring); }
@@ -447,6 +534,9 @@ html, body { overflow-x: clip; }
 .switch input:focus-visible ~ .switch__track { box-shadow: var(--ring); }
 .switch input:disabled ~ * { opacity: .5; cursor: not-allowed; }
 
+/* --------------------------------------------------------------------------
+   8. SUPERFICIES — card, badge, tag, avatar, divider, accordion (§10.11–10.14)
+   -------------------------------------------------------------------------- */
 .card {
   background: var(--surface); border: var(--border-width) solid var(--border);
   border-radius: var(--radius-lg); padding: var(--card-padding);
@@ -572,6 +662,10 @@ html, body { overflow-x: clip; }
 }
 .accordion__item.is-open .accordion__content { opacity: 1; }
 
+/* --------------------------------------------------------------------------
+   9. FEEDBACK — tooltip, alert, toast, progress, skeleton, empty state
+      (§10.15–10.18, §10.25)
+   -------------------------------------------------------------------------- */
 [data-tooltip] { position: relative; }
 [data-tooltip]::after {
   content: attr(data-tooltip);
@@ -611,11 +705,11 @@ html, body { overflow-x: clip; }
 .alert__body { margin: 0; }
 .alert__close {
   margin-left: auto; flex: none; display: grid; place-items: center;
-  width: 36px; height: 36px; border: 0; border-radius: var(--radius-sm);
+  width: 24px; height: 24px; border: 0; border-radius: var(--radius-sm);
   background: transparent; color: inherit; cursor: pointer; opacity: .7;
 }
 .alert__close:hover { opacity: 1; }
-.alert__close svg { width: 18px; height: 18px; }
+.alert__close svg { width: 16px; height: 16px; }
 .alert--info    { background: var(--info-100);    color: var(--info-text); }
 .alert--info > svg    { color: var(--info-500); }
 .alert--success { background: var(--success-100); color: var(--success-text); }
@@ -707,6 +801,9 @@ html, body { overflow-x: clip; }
 .empty-state__title { font-size: var(--text-lg); font-weight: var(--weight-semibold); color: var(--text-primary); margin: 0; }
 .empty-state__desc { font-size: var(--text-sm); color: var(--text-muted); max-width: 40ch; margin: 0; }
 
+/* --------------------------------------------------------------------------
+   10. OVERLAYS — modal, menu (§10.19–10.20)
+   -------------------------------------------------------------------------- */
 .modal {
   position: fixed; inset: 0; z-index: 100;
   display: grid; place-items: center; padding: var(--space-4);
@@ -745,10 +842,14 @@ html, body { overflow-x: clip; }
   background: var(--surface); border: var(--border-width) solid var(--border);
   border-radius: var(--radius-md); box-shadow: var(--shadow-lg);
   opacity: 0; transform: translateY(-4px); pointer-events: none;
-  transition: opacity 160ms var(--ease-out), transform 160ms var(--ease-out);
+  transition: opacity var(--duration-fast) var(--ease-out), transform var(--duration-fast) var(--ease-out);
+
+  visibility: hidden;
+
+  display: none;
 }
 .menu--right { left: auto; right: 0; }
-.menu.is-open { opacity: 1; transform: none; pointer-events: auto; }
+.menu.is-open { opacity: 1; transform: none; pointer-events: auto;  visibility: visible;  display: block; }
 .menu__item {
   display: flex; align-items: center; gap: 10px; width: 100%;
   padding: 9px 12px; border: 0; border-radius: var(--radius-sm);
@@ -758,10 +859,13 @@ html, body { overflow-x: clip; }
 }
 .menu__item:hover { background: var(--bg); }
 .menu__item svg { width: 16px; height: 16px; color: var(--text-muted); flex: none; }
-.menu__item--danger, .menu__item--danger svg { color: var(--danger-500); }
+.menu__item--danger, .menu__item--danger svg { color: var(--danger-text); }
 .menu__item--danger:hover { background: var(--danger-100); }
 .menu__sep { height: var(--border-width); background: var(--border); margin: 6px 4px; }
 
+/* --------------------------------------------------------------------------
+   11. DATOS — tabla, stat, pagination (§10.21–10.23)
+   -------------------------------------------------------------------------- */
 .table { width: 100%; border-collapse: collapse; font-size: var(--text-sm); font-variant-numeric: tabular-nums; }
 .table thead th {
   height: 40px; padding: 0 16px; text-align: left;
@@ -847,7 +951,7 @@ button.metric-chip {
 }
 button.metric-chip:hover { background: var(--accent-soft); border-color: var(--accent); }
 button.metric-chip:active { background: var(--accent-soft-strong); transform: scale(.98); }
-button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+button.metric-chip:focus-visible { outline: 2px solid var(--focus-color); outline-offset: 2px; }
 
 .pagination { display: flex; align-items: center; gap: 4px; list-style: none; padding: 0; margin: 0; }
 .pagination__btn {
@@ -866,6 +970,9 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 .pagination__btn svg { width: 16px; height: 16px; }
 .pagination__ellipsis { color: var(--text-disabled); padding: 0 4px; user-select: none; }
 
+/* --------------------------------------------------------------------------
+   12. NAVEGACIÓN — navbar, sidebar, tabs, breadcrumbs (§10.24)
+   -------------------------------------------------------------------------- */
 .navbar {
   display: flex; align-items: center; gap: var(--space-8);
   height: 64px; padding: 0 var(--space-6);
@@ -984,6 +1091,9 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 .breadcrumbs__sep { user-select: none; }
 .breadcrumbs__current { color: var(--text-primary); }
 
+/* --------------------------------------------------------------------------
+   13. TIPOGRÁFICOS — link, code
+   -------------------------------------------------------------------------- */
 .link {
   color: var(--link); text-decoration: none;
   background-image: linear-gradient(currentColor, currentColor);
@@ -1000,17 +1110,21 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
   border-radius: var(--radius-sm); padding: 1px 6px;
 }
 
+/* --------------------------------------------------------------------------
+   13b. COMBOBOX · BÚSQUEDA · DRAWER · POPOVER · BUTTONGROUP (§10.28–10.31)
+   -------------------------------------------------------------------------- */
+
 /* Combobox / Autocomplete (§10.28) */
 .combobox { position: relative; }
 .combobox__input {
   width: 100%; height: var(--control-height-md); padding: 0 14px;
   font-family: var(--font-body); font-size: var(--text-base);
   color: var(--text-primary); background: var(--surface);
-  border: var(--border-width) solid var(--border-strong); border-radius: var(--radius-sm);
+  border: var(--border-width) solid var(--control-border); border-radius: var(--radius-sm);
   transition: border-color var(--duration-fast) var(--ease-out),
               box-shadow var(--duration-fast) var(--ease-out);
 }
-.combobox__input:hover:not(:disabled):not(:focus) { border-color: var(--text-disabled); }
+.combobox__input:hover:not(:disabled):not(:focus) { border-color: var(--border-hover); }
 .combobox__input:focus { outline: none; border-color: var(--accent); box-shadow: var(--ring); }
 .combobox__input:disabled { background: var(--surface-alt); color: var(--text-disabled); cursor: not-allowed; }
 .combobox__list {
@@ -1048,12 +1162,12 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
   width: 100%; height: var(--control-height-md); padding: 0 40px;
   font-family: var(--font-body); font-size: var(--text-base);
   color: var(--text-primary); background: var(--surface);
-  border: var(--border-width) solid var(--border-strong); border-radius: var(--radius-sm);
+  border: var(--border-width) solid var(--control-border); border-radius: var(--radius-sm);
   transition: border-color var(--duration-fast) var(--ease-out),
               box-shadow var(--duration-fast) var(--ease-out);
 }
 .search__input::-webkit-search-cancel-button { -webkit-appearance: none; appearance: none; }
-.search__input:hover:not(:focus) { border-color: var(--text-disabled); }
+.search__input:hover:not(:focus) { border-color: var(--border-hover); }
 .search__input:focus { outline: none; border-color: var(--accent); box-shadow: var(--ring); }
 .search__clear {
   position: absolute; right: 6px; top: 50%; transform: translateY(-50%);
@@ -1116,8 +1230,12 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
   transform-origin: top left; opacity: 0; transform: scale(.96); pointer-events: none;
   transition: opacity var(--duration-base) var(--ease-out),
               transform var(--duration-base) var(--ease-out);
+
+  visibility: hidden;
+
+  display: none;
 }
-.popover.is-open .popover__panel { opacity: 1; transform: none; pointer-events: auto; }
+.popover.is-open .popover__panel { opacity: 1; transform: none; pointer-events: auto;  visibility: visible;  display: block; }
 .popover--right .popover__panel { left: auto; right: 0; transform-origin: top right; }
 
 /* ButtonGroup (§10.31) */
@@ -1132,17 +1250,21 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 .btn-group .btn:not(:first-child) { margin-left: calc(var(--border-width) * -1); }
 .btn-group .btn:hover, .btn-group .btn:focus-visible { z-index: 1; }
 
+/* --------------------------------------------------------------------------
+   13c. DATEPICKER · FILEUPLOAD · STEPPER · KBD (§10.32–10.35)
+   -------------------------------------------------------------------------- */
+
 /* DatePicker (§10.32) */
 .datepicker { position: relative; display: inline-block; }
 .datepicker__input {
   width: 100%; height: var(--control-height-md); padding: 0 40px 0 14px;
   font-family: var(--font-body); font-size: var(--text-base);
   color: var(--text-primary); background: var(--surface);
-  border: var(--border-width) solid var(--border-strong); border-radius: var(--radius-sm);
+  border: var(--border-width) solid var(--control-border); border-radius: var(--radius-sm);
   transition: border-color var(--duration-fast) var(--ease-out),
               box-shadow var(--duration-fast) var(--ease-out);
 }
-.datepicker__input:hover:not(:disabled):not(:focus) { border-color: var(--text-disabled); }
+.datepicker__input:hover:not(:disabled):not(:focus) { border-color: var(--border-hover); }
 .datepicker__input:focus { outline: none; border-color: var(--accent); box-shadow: var(--ring); }
 .datepicker__input:disabled { background: var(--surface-alt); color: var(--text-disabled); cursor: not-allowed; }
 .datepicker__icon {
@@ -1157,8 +1279,12 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
   transform-origin: top left; opacity: 0; transform: scale(.96); pointer-events: none;
   transition: opacity var(--duration-base) var(--ease-out),
               transform var(--duration-base) var(--ease-out);
+
+  visibility: hidden;
+
+  display: none;
 }
-.datepicker.is-open .datepicker__calendar { opacity: 1; transform: none; pointer-events: auto; }
+.datepicker.is-open .datepicker__calendar { opacity: 1; transform: none; pointer-events: auto;  visibility: visible;  display: block; }
 .datepicker--right .datepicker__calendar { left: auto; right: 0; transform-origin: top right; }
 
 .calendar { width: 15.75rem; }
@@ -1293,6 +1419,9 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 }
 .kbd-combo { display: inline-flex; align-items: center; gap: 4px; color: var(--text-muted); font-size: var(--text-xs); }
 
+/* --------------------------------------------------------------------------
+   14. UTILIDADES MÍNIMAS
+   -------------------------------------------------------------------------- */
 .u-visually-hidden {
   position: absolute; width: 1px; height: 1px; margin: -1px;
   clip-path: inset(50%); overflow: hidden; white-space: nowrap;
@@ -1301,6 +1430,172 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 .u-muted { color: var(--text-muted); }
 .u-measure { max-width: var(--measure); }
 
+/* CONTRATOS COMPARTIDOS GENERADOS */
+/* Contratos comunes de interacción; la identidad y los valores viven en tokens.css. */
+.grid { grid-template-columns: repeat(12, minmax(0, 1fr)); }
+.grid > *, .field, .card { min-inline-size: 0; }
+.stack, .card__content, .form-stack, .text-group { display: flex; flex-direction: column; align-items: stretch; }
+.stack, .card__content { gap: var(--content-gap); }
+.stack--tight, .text-group { gap: var(--heading-gap); }
+.stack--cards { gap: var(--card-group-gap); }
+.form-stack { gap: var(--form-gap); }
+.cluster { display: flex; flex-wrap: wrap; align-items: center; gap: var(--space-3); }
+.card { display: flex; flex-direction: column; gap: var(--card-content-gap); }
+.field { gap: var(--field-gap); }
+.field__label, .field__help, .field__error, .field > :is(label, p, span, div) { margin-block: 0; }
+:where(.field + .field, .field + .btn, .field + .cluster) { margin-block-start: var(--form-gap); }
+:where(.card + .card) { margin-block-start: var(--card-group-gap); }
+.stack > *, .card__content > *, .form-stack > *, .text-group > *, .grid > .card,
+.card > :is(h1, h2, h3, h4, h5, h6, p), .text-group > :is(h1, h2, h3, h4, h5, h6, p),
+.stack > :is(h1, h2, h3, h4, h5, h6, p) { margin-block: 0; }
+.form-stack > .field { margin-block: 0; }
+.btn {
+  block-size: auto;
+  min-block-size: var(--control-height-md);
+  max-inline-size: 100%;
+  white-space: normal;
+  line-height: 1.35;
+  text-align: center;
+}
+.btn--sm { min-block-size: var(--control-height-sm, 36px); }
+.btn--lg { min-block-size: var(--control-height-lg, 52px); }
+.btn--primary, .icon-btn--primary, .calendar__day--selected, .pagination__btn.is-active {
+  background: var(--action-bg);
+  color: var(--text-on-action);
+}
+.btn--primary:hover:not(:disabled), .icon-btn--primary:hover:not(:disabled) { background: var(--action-hover); color: var(--text-on-action); }
+.btn--primary:active:not(:disabled), .icon-btn--primary:active:not(:disabled) { background: var(--action-active); color: var(--text-on-action); }
+.input, .textarea, .select, .combobox__input, .search__input, .datepicker__input {
+  max-inline-size: 100%;
+  caret-color: var(--focus-color);
+}
+.input, .select, .combobox__input, .search__input, .datepicker__input {
+  block-size: auto; min-block-size: var(--control-height-md);
+  padding-block: var(--space-2); line-height: 1.5;
+}
+:is(.input, .textarea, .select, .combobox__input, .search__input, .datepicker__input):not(.input--error, .input--success, .textarea--error, [aria-invalid="true"]) { border-color: var(--control-border); }
+.input:hover:not(:disabled):not(:focus):not(.input--error, .input--success, [aria-invalid="true"]), .textarea:hover:not(:disabled):not(:focus):not(.textarea--error, [aria-invalid="true"]),
+.select:hover:not(:disabled):not(:focus), .combobox__input:hover:not(:disabled):not(:focus),
+.search__input:hover:not(:focus), .datepicker__input:hover:not(:disabled):not(:focus) { border-color: var(--border-hover); }
+.input:focus-visible, .textarea:focus-visible, .select:focus-visible,
+.combobox__input:focus-visible, .search__input:focus-visible, .datepicker__input:focus-visible {
+  outline: 2px solid var(--focus-color);
+  outline-offset: 2px;
+}
+.input[aria-invalid="true"], .textarea[aria-invalid="true"] { border-color: var(--danger-text, var(--danger)); }
+.input.input--error, .textarea.textarea--error,
+.input.input--error:hover:not(:disabled):not(:focus), .textarea.textarea--error:hover:not(:disabled):not(:focus),
+:is(.input, .textarea, .select, .combobox__input, .search__input, .datepicker__input)[aria-invalid="true"]:hover:not(:disabled):not(:focus) {
+  border-color: var(--danger-text, var(--danger));
+}
+.input.input--success, .input.input--success:hover:not(:disabled):not(:focus) { border-color: var(--success-text, var(--success)); }
+.pagination { max-inline-size: 100%; flex-wrap: wrap; row-gap: var(--space-2); }
+.pagination__ellipsis { color: var(--text-muted); }
+.step--current .step__marker { color: var(--link); border-color: var(--focus-color); }
+.checkbox input:focus-visible ~ .checkbox__box,
+.radio input:focus-visible ~ .radio__dot,
+.switch input:focus-visible ~ .switch__track {
+  outline: 2px solid var(--focus-color);
+  outline-offset: 2px;
+}
+input.checkbox, input.radio { border-color: var(--control-border); }
+input.checkbox:hover, input.radio:hover { border-color: var(--focus-color); }
+input.checkbox:checked, input.checkbox:indeterminate, input.radio:checked { border-color: var(--focus-color); }
+.switch__track { background: var(--control-border); }
+.tabs { max-inline-size: 100%; overflow-x: auto; }
+.tabs__tab { flex-shrink: 0; }
+.segmented { max-inline-size: 100%; block-size: auto; min-block-size: var(--control-height-md); overflow-x: auto; }
+.segmented label { padding-block: var(--space-2); }
+.stat__row, .breadcrumbs, .check-row { flex-wrap: wrap; row-gap: var(--space-2); }
+.progress-row, .slider-row { flex-wrap: wrap; gap: var(--space-2); }
+.stat__value { max-inline-size: 100%; white-space: normal; overflow-wrap: anywhere; }
+.file-upload, .file-upload__label { min-inline-size: 0; max-inline-size: 100%; }
+.file-upload__button { max-inline-size: 100%; white-space: normal; text-align: center; }
+.file-upload__hint { overflow-wrap: anywhere; }
+.table-scroll { max-inline-size: 100%; overflow-x: auto; overscroll-behavior-inline: contain; }
+.popover__panel, .datepicker__calendar, .combobox__list {
+  max-inline-size: calc(100vw - 2rem);
+  max-block-size: min(32rem, 70dvh);
+  overflow: auto;
+}
+.file-upload__input:focus-visible + .file-upload__label { outline: 2px solid var(--focus-color); outline-offset: 2px; }
+.calendar { max-inline-size: calc(100vw - 2rem); }
+.ui-title, :is(h1, h2, h3, h4, h5, h6).ui-title, [data-mode="operate"] :is(h1, h2, h3) {
+  font-family: var(--font-ui-heading);
+  letter-spacing: 0;
+  line-height: 1.3;
+  font-weight: var(--weight-semibold);
+}
+.ui-title, :is(h1, h2, h3, h4, h5, h6).ui-title, [data-mode="operate"] h1 { font-size: var(--text-ui-title); }
+[data-mode="operate"] h2 { font-size: var(--text-xl); }
+[data-mode="operate"] h3 { font-size: var(--text-lg); }
+.display, .reading-title, :is(h1, h2, h3, h4, h5, h6):is(.display, .reading-title) {
+  font-family: var(--font-display);
+  font-size: var(--text-display-fluid);
+  line-height: 1.08;
+  letter-spacing: var(--tracking-display);
+  text-wrap: balance;
+}
+:where(.celeste-reset, .salvia-reset, .bruma-reset, .nocturna-reset, body[data-system]) {
+  scrollbar-color: var(--control-border) var(--bg);
+}
+::selection,
+.celeste-reset ::selection, .salvia-reset ::selection, .bruma-reset ::selection {
+  background: var(--selection-bg); color: var(--selection-text);
+}
+::placeholder { color: var(--placeholder); opacity: 1; }
+:where(a) { text-underline-offset: .2em; text-decoration-thickness: .08em; }
+.skip-link {
+  position: fixed; inset-block-start: var(--space-2); inset-inline-start: var(--space-2);
+  z-index: 1000; padding: var(--space-3) var(--space-4);
+  background: var(--action-bg); color: var(--text-on-action);
+  border-radius: var(--radius-sm); transform: translateY(-180%);
+}
+.skip-link:focus { transform: none; outline: 2px solid var(--focus-color); outline-offset: 2px; }
+[data-tooltip]::before, [data-tooltip]::after { display: none; }
+[data-tooltip]:focus-visible::before, [data-tooltip]:focus-visible::after { display: block; }
+.has-tooltip .tooltip { display: none; }
+.has-tooltip:has(:focus-visible) .tooltip { display: block; opacity: 1; transform: translate(-50%, 0); }
+@media (hover: hover) and (pointer: fine) {
+  [data-tooltip]:hover::before, [data-tooltip]:hover::after { display: block; }
+  .has-tooltip:hover .tooltip { display: block; }
+}
+@media (pointer: coarse) {
+  .btn, .icon-btn, .segmented label, .pagination button,
+  .tag__close, .search__clear, .toast__close, .check-row,
+  .checkbox:not(input), .radio:not(input), .switch:not(input) {
+    min-block-size: var(--touch-target);
+    min-inline-size: var(--touch-target);
+  }
+}
+@media (max-width: 479px) {
+  .btn-group { flex-wrap: wrap; }
+  .modal { max-inline-size: calc(100vw - 2rem); }
+  .stepper { flex-direction: column; align-items: stretch; gap: var(--space-4); }
+  .step { flex-direction: row; align-items: center; gap: var(--space-3); text-align: start; min-inline-size: 0; }
+  .step__label { overflow-wrap: anywhere; }
+  .step__connector { display: none; }
+}
+@media (prefers-reduced-motion: reduce) {
+  html, html:focus-within { scroll-behavior: auto; }
+  .spinner, .skeleton, .skeleton::after,
+  .progress--indeterminate .progress__bar, .alert.is-leaving, .toast.is-leaving { animation: none; }
+  .progress--indeterminate .progress__bar { transform: none; }
+  .btn, .icon-btn, .card--interactive, .slider::-webkit-slider-thumb { transform: none; }
+  .btn:active:not(:disabled), .icon-btn:active:not(:disabled), .card--interactive:hover { transform: none; }
+  .btn, .icon-btn { transition: background-color 80ms linear, color 80ms linear; }
+  .menu, .popover__panel, .datepicker__calendar, .link::after { transition: none; }
+  .progress__bar, .progress-ring__value, .accordion__content, .accordion__body { transition: none; }
+}
+@media (forced-colors: active) {
+  input.switch, .switch__track { border: 1px solid CanvasText; background: Canvas; }
+  input.switch::after, .switch__track::after { background: CanvasText; }
+  input.switch:checked, .switch input:checked ~ .switch__track { border-color: Highlight; }
+  input.switch:checked::after, .switch input:checked ~ .switch__track::after { background: Highlight; }
+  .checkbox__box, .radio__dot { border-color: CanvasText; }
+}
+
+
 /* ==========================================================================
    ESTILOS DE LA PÁGINA DE DOCUMENTACIÓN (.ds-*)
    ========================================================================== */
@@ -1447,7 +1742,7 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 .ds-type-row__meta { width: 190px; flex: none; font-family: var(--font-mono); font-size: var(--text-xs); color: var(--text-muted); }
 .ds-type-row__sample { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 
-.ds-font-card h4 { margin-bottom: 2px; }
+.ds-font-card h3 { margin-bottom: 2px; }
 .ds-font-card .ds-font-sample { font-size: var(--text-3xl); line-height: 1.2; margin: 6px 0; }
 .ds-font-card p { font-size: var(--text-sm); color: var(--text-muted); margin: 0; max-width: none; }
 
@@ -1485,10 +1780,10 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 @media (hover: hover) and (pointer: fine) {
   .ds-ease-chip:hover { transform: translateX(24px); }
 }
-.ds-ease-chip--out   { transition: transform 400ms var(--ease-out); }
-.ds-ease-chip--in    { transition: transform 400ms var(--ease-in); }
-.ds-ease-chip--inout { transition: transform 400ms var(--ease-in-out); }
-.ds-ease-chip--spring{ transition: transform 400ms var(--ease-spring); }
+.ds-ease-chip--out   { transition: transform var(--duration-page) var(--ease-out); }
+.ds-ease-chip--in    { transition: transform var(--duration-page) var(--ease-in); }
+.ds-ease-chip--inout { transition: transform var(--duration-page) var(--ease-in-out); }
+.ds-ease-chip--spring{ transition: transform var(--duration-page) var(--ease-spring); }
 
 .ds-icon-grid { display: flex; flex-wrap: wrap; gap: var(--space-4); }
 .ds-icon-cell {
@@ -1517,9 +1812,118 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
   .ds-main, .ds-footer { margin-left: 0; }
   .ds-main { padding: var(--space-8) var(--space-4) var(--space-16); }
 }
+/* ESTILOS COMPARTIDOS GENERADOS */
+/* La documentación comparte navegación y deja que cada marca determine el ritmo. */
+.ds-topbar { gap: var(--space-3); }
+.ds-brand { min-inline-size: 0; }
+.ds-brand, .ds-brand__name { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.ds-theme-toggle, .ds-hamburger { flex-shrink: 0; }
+.ds-main { padding-block-start: var(--space-12); }
+.ds-main > section { scroll-margin-block-start: 88px; }
+.ds-main > section > h2 { text-wrap: balance; }
+.ds-main :is(h1, h2, h3, h4, h5, h6) { overflow-wrap: anywhere; }
+.ds-hero {
+  display: grid;
+  grid-template-columns: minmax(0, 1.45fr) minmax(12rem, .65fr);
+  column-gap: var(--space-12);
+  row-gap: var(--space-6);
+  padding-block-start: var(--space-6);
+}
+.ds-hero > h1 {
+  grid-column: 1 / -1;
+  font-size: var(--text-display-fluid);
+  line-height: 1.08;
+  letter-spacing: var(--tracking-display);
+  text-wrap: balance;
+  margin: 0;
+}
+.ds-hero > .ds-lead { grid-column: 1; margin: 0; max-inline-size: 55ch; }
+.ds-hero > .ds-actions { grid-column: 1; margin: 0; display: flex; flex-wrap: wrap; gap: var(--space-3); }
+.ds-hero__palette {
+  grid-column: 2; grid-row: 2 / 4;
+  display: grid; grid-template-columns: 2fr 1.25fr .75fr;
+  gap: var(--space-1); margin: 0; min-block-size: 150px;
+  align-self: stretch; overflow: hidden; border-radius: var(--radius-lg);
+}
+.ds-hero__chip { inline-size: auto; block-size: auto; border: 0; border-radius: 0; }
+.ds-principles {
+  grid-column: 1 / -1; display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: var(--space-6) var(--space-10); margin-block: var(--space-4) 0;
+}
+.ds-principle { padding-block-start: var(--space-4); border-block-start: 1px solid var(--border); }
+.ds-principle h2 { font-family: var(--font-body); font-size: var(--text-base); line-height: 1.5; margin: 0 0 var(--space-2); }
+.ds-principle p { font-size: var(--text-sm); color: var(--text-secondary); margin: 0; max-inline-size: 48ch; }
+.ds-hero > .alert, .ds-hero > .ds-callout { grid-column: 1 / -1; margin: var(--space-3) 0 0; }
+.ds-callout { border: 1px solid var(--border); border-radius: var(--radius-md); }
+.ds-recipes { margin: 0; }
+.ds-recipes > div {
+  display: grid; grid-template-columns: minmax(8rem, .4fr) minmax(0, 1fr);
+  gap: var(--space-4); padding-block: var(--space-5); border-block-start: 1px solid var(--border);
+}
+.ds-recipes dt { font-weight: var(--weight-semibold); }
+.ds-recipes dd { margin: 0; color: var(--text-secondary); max-inline-size: 65ch; }
+.ds-chart-palette { list-style: none; padding: 0; display: grid; grid-template-columns: repeat(auto-fit, minmax(150px, 1fr)); gap: var(--space-4); }
+.ds-chart-palette li { display: grid; gap: var(--space-2); }
+.ds-chart-palette__color { display: block; block-size: 56px; border-radius: var(--radius-sm); }
+.ds-chart-palette code { font-family: var(--font-mono); font-size: var(--text-sm); }
+.ds-chart-palette [data-chart-color] { color: var(--text-muted); font-size: var(--text-sm); }
+.ds-nav a { min-block-size: 36px; display: flex; align-items: center; }
+.ds-nav__sub a { font-size: var(--text-sm); }
+.ds-demo { min-inline-size: 0; max-inline-size: 100%; }
+.ds-demo > * { min-inline-size: 0; max-inline-size: 100%; }
+.ds-demo :has(> .divider--vertical) { flex-wrap: wrap; row-gap: var(--space-3); }
+.ds-wordmark-demo { display: inline-block; max-inline-size: 100%; overflow-x: auto; vertical-align: bottom; }
+.ds-main code:not(.ds-pre code), .ds-main .code, .ds-main .u-mono { overflow-wrap: anywhere; white-space: normal; }
+.ds-demo .popover__panel { max-inline-size: calc(100vw - var(--space-20)); }
+.ds-demo--grid, .ds-semantic-grid { grid-template-columns: repeat(auto-fit, minmax(min(100%, 200px), 1fr)); }
+.ds-copy { min-block-size: 36px; }
+.ds-code summary { padding-block: var(--space-3); }
+.ds-pre { max-inline-size: 100%; }
+.ds-type-row__sample { min-inline-size: 0; white-space: normal; overflow-wrap: anywhere; }
+.ds-main table { min-inline-size: 0; }
+.ds-theme-toggle[data-tooltip]::after { left: auto; right: 0; transform: translateY(4px); }
+.ds-theme-toggle[data-tooltip]:hover::after, .ds-theme-toggle[data-tooltip]:focus-visible::after { transform: translateY(0); }
+[data-system="nocturna"] .ds-wordmark-badge { color: var(--night-50); }
+.ds-main p { overflow-wrap: anywhere; }
+.ds-type-row { min-inline-size: 0; }
+[data-system="celeste"] .ds-hero { padding-block-start: var(--space-10); }
+[data-system="salvia"] .ds-principles { row-gap: var(--space-8); }
+[data-system="bruma"] .ds-principles { gap: var(--space-4) var(--space-8); }
+[data-system="nocturna"] .ds-main { padding-block-start: calc(64px + var(--space-10)); }
+@media (max-width: 1023px) {
+  .ds-main { padding-inline: var(--space-5); }
+  .ds-hero { column-gap: var(--space-6); }
+  .ds-nav a { min-block-size: var(--touch-target); }
+  .ds-sidenav:not(.is-open), .ds-sidebar:not(.is-open) { visibility: hidden; }
+}
+@media (max-width: 639px) {
+  .ds-topbar { padding-inline: var(--space-4); }
+  .ds-version { max-inline-size: 44vw; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+  .ds-main { padding-inline: var(--space-4); padding-block-start: var(--space-8); }
+  .ds-hero { grid-template-columns: minmax(0, 1fr); row-gap: var(--space-5); padding-block-start: var(--space-2); }
+  .ds-hero > h1, .ds-hero > .ds-lead, .ds-hero > .ds-actions { grid-column: 1; }
+  .ds-hero__palette { grid-column: 1; grid-row: auto; min-block-size: 64px; }
+  .ds-principles { grid-template-columns: minmax(0, 1fr); }
+  .ds-demo { padding: var(--space-4); }
+  .ds-type-row { display: grid; gap: var(--space-2); }
+  .ds-type-row__meta { inline-size: auto; }
+  .ds-space-item { min-inline-size: 0; }
+  .ds-space-item .u-mono { inline-size: 96px; flex: none; }
+  .ds-space-bar { max-inline-size: calc(100vw - 164px); }
+  .ds-recipes > div { grid-template-columns: minmax(0, 1fr); gap: var(--space-2); }
+  .ds-actions > .btn { flex: 1 1 12rem; }
+  .ds-copy { min-block-size: var(--touch-target); }
+}
+@media (prefers-reduced-motion: reduce) {
+  .ds-sidenav, .ds-sidebar, .ds-swatch, .ds-ease-chip { transition: none; }
+  .ds-swatch:hover, .ds-ease-chip:hover { transform: none; }
+}
+
 </style>
 </head>
-<body class="celeste-reset">
+<body class="celeste-reset" data-system="celeste" data-mode="read">
+<a class="skip-link" href="#contenido">Saltar al contenido</a>
 
 <!-- Iconos (estilo Lucide, trazo 2px) -->
 <svg xmlns="http://www.w3.org/2000/svg" style="display:none" aria-hidden="true">
@@ -1578,10 +1982,13 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
   <nav class="ds-nav" id="dsNav">
     <div class="ds-nav__group">Fundamentos</div>
     <a href="#introduccion">Introducción</a>
+    <a href="#datos">Color para datos</a>
+    <a href="#criterio">Criterio de uso</a>
     <a href="#voz">Voz y contenido</a>
     <a href="#colores">Colores</a>
     <a href="#tipografia">Tipografía</a>
     <a href="#espaciado">Espaciado</a>
+    <a href="#ritmo">Ritmo de contenido</a>
     <a href="#bordes">Bordes, radios y focus</a>
     <a href="#elevacion">Elevación</a>
     <a href="#iconografia">Iconografía</a>
@@ -1634,11 +2041,10 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
   </nav>
 </aside>
 
-<main class="ds-main">
+<main class="ds-main" id="contenido" tabindex="-1">
 
   <!-- ============================== INTRODUCCIÓN ============================== -->
   <section id="introduccion" class="ds-hero">
-    <p class="ds-eyebrow">Sistema de diseño · Higinio Sosa</p>
     <h1>Celeste Clásica</h1>
     <p class="ds-lead u-measure">
       Sistema de marca <strong>light-first</strong>, sereno y confiable, para todos los productos de
@@ -1651,17 +2057,17 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
       <div class="ds-hero__chip" style="background:#31343e"></div>
     </div>
 
-    <div style="display:flex;gap:16px;flex-wrap:wrap;margin:24px 0;">
+    <div class="ds-actions">
       <button class="btn btn--primary" id="dsHeroStart">Empezar a construir</button>
       <button class="btn btn--outline" id="dsHeroTokens">Ver tokens</button>
     </div>
 
     <div class="ds-principles">
-      <div class="card"><span class="ds-num">01</span><h4>Claridad primero</h4><p>El contenido siempre por encima de la decoración.</p></div>
-      <div class="card"><span class="ds-num">02</span><h4>Calma visual</h4><p>Superficies claras, whitespace generoso, contraste solo donde importa.</p></div>
-      <div class="card"><span class="ds-num">03</span><h4>Un acento a la vez</h4><p>El azul acero guía la acción; nunca compite consigo mismo.</p></div>
-      <div class="card"><span class="ds-num">04</span><h4>Consistencia sobre novedad</h4><p>Mismos tokens en todos los productos; cero valores mágicos.</p></div>
-      <div class="card"><span class="ds-num">05</span><h4>Movimiento con propósito</h4><p>La animación explica — aparece, cambia, desaparece — nunca decora sola.</p></div>
+      <div class="ds-principle"><h2>Claridad primero</h2><p>El contenido siempre por encima de la decoración.</p></div>
+      <div class="ds-principle"><h2>Calma visual</h2><p>Superficies claras, whitespace generoso, contraste solo donde importa.</p></div>
+      <div class="ds-principle"><h2>Un acento a la vez</h2><p>El azul acero guía la acción; nunca compite consigo mismo.</p></div>
+      <div class="ds-principle"><h2>Consistencia sobre novedad</h2><p>Mismos tokens en todos los productos; cero valores mágicos.</p></div>
+      <div class="ds-principle"><h2>Movimiento con propósito</h2><p>La animación explica — aparece, cambia, desaparece — nunca decora sola.</p></div>
     </div>
 
     <div class="alert alert--info" style="margin-top:24px">
@@ -1674,8 +2080,43 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
   </section>
 
   <!-- ============================== VOZ Y CONTENIDO ============================== -->
+  <section id="datos">
+    <h2>Color para datos</h2>
+    <p>Serie categórica de orden estable, con pasos propios en cada tema. El color identifica; etiquetas, formas o patrones conservan el significado. Los labels usan tinta, no el color de la serie.</p>
+    <ul class="ds-chart-palette"><li><span class="ds-chart-palette__color" style="background:var(--chart-1)" aria-hidden="true"></span><code>--chart-1</code><span data-chart-color="--chart-1"></span></li><li><span class="ds-chart-palette__color" style="background:var(--chart-2)" aria-hidden="true"></span><code>--chart-2</code><span data-chart-color="--chart-2"></span></li><li><span class="ds-chart-palette__color" style="background:var(--chart-3)" aria-hidden="true"></span><code>--chart-3</code><span data-chart-color="--chart-3"></span></li><li><span class="ds-chart-palette__color" style="background:var(--chart-4)" aria-hidden="true"></span><code>--chart-4</code><span data-chart-color="--chart-4"></span></li><li><span class="ds-chart-palette__color" style="background:var(--chart-5)" aria-hidden="true"></span><code>--chart-5</code><span data-chart-color="--chart-5"></span></li><li><span class="ds-chart-palette__color" style="background:var(--chart-6)" aria-hidden="true"></span><code>--chart-6</code><span data-chart-color="--chart-6"></span></li><li><span class="ds-chart-palette__color" style="background:var(--chart-7)" aria-hidden="true"></span><code>--chart-7</code><span data-chart-color="--chart-7"></span></li></ul>
+    <p class="u-muted">Las pruebas comprueban contraste con la superficie y separación perceptual entre colores adyacentes. Ofrece una tabla equivalente; más de siete series necesitan agrupación u otra composición.</p>
+  </section>
+
+  <section id="ritmo">
+    <h2>Ritmo de contenido</h2>
+    <p>El espacio sigue a la relación: 6px dentro de un campo, 8px entre título y descripción, 16px entre bloques, 20px entre campos y 24px entre tarjetas. Las secciones se separan 64px.</p>
+    <div class="stack stack--cards" data-spacing-example data-mode="operate">
+      <section class="card">
+        <header class="text-group"><h3>Datos de contacto</h3><p>Ejemplo de composición. El título y su descripción forman un grupo.</p></header>
+        <form class="form-stack" onsubmit="return false">
+          <div class="field"><label class="field__label" for="rh-name">Nombre</label><input class="input" id="rh-name" autocomplete="name" placeholder="Tu nombre"><p class="field__help">Escribe el nombre que quieres mostrar.</p></div>
+          <div class="field"><label class="field__label" for="rh-email">Correo</label><input class="input" id="rh-email" type="email" autocomplete="email" placeholder="nombre@ejemplo.com"><p class="field__help">La ayuda puede ocupar varias líneas sin juntarse con el siguiente control.</p></div>
+          <div class="cluster"><button class="btn btn--primary" type="button">Acción de ejemplo</button><button class="btn btn--secondary" type="button">Cancelar</button></div>
+        </form>
+      </section>
+      <section class="card">
+        <header class="text-group"><h3>Contenido relacionado</h3><p>Una tarjeta distinta conserva su propia distancia.</p></header>
+        <div class="stack"><p>Los párrafos y los divs no necesitan una colección de márgenes manuales.</p><div>Este bloque mantiene 16px respecto al párrafo anterior.</div></div>
+      </section>
+    </div>
+  </section>
+
+  <section id="criterio">
+    <h2>Diseñar con Celeste Clásica</h2>
+    <dl class="ds-recipes">
+      <div><dt>Operar</dt><dd>Una tarea clara por región. Títulos en la familia de UI, datos estables y una acción dominante por contexto. Usa <code>data-mode="operate"</code> en formularios, paneles y tablas.</dd></div>
+      <div><dt>Leer</dt><dd>Display para abrir la lectura; cuerpo de 65–75 caracteres por línea. Agrupa lo relacionado y separa las secciones con espacio, sin convertir cada párrafo en una tarjeta.</dd></div>
+      <div><dt>Decidir</dt><dd>La composición sigue a la decisión: contexto, evidencia y acción. Conserva la identidad de marca y evita trasladar la densidad de un dashboard a una landing.</dd></div>
+      <div><dt>Interactuar</dt><dd>Los botones sólidos usan <code>--action-bg</code> y <code>--text-on-action</code>. Foco, hover y error deben seguir siendo reconocibles en ambos temas, con teclado y con movimiento reducido.</dd></div>
+    </dl>
+  </section>
+
   <section id="voz">
-    <p class="ds-eyebrow">Fundamentos</p>
     <h2>Voz y contenido</h2>
     <p class="ds-lead">Una consultora seria pero cálida — "banca privada boutique", no "startup ruidosa".</p>
     <div class="ds-demo ds-demo--col">
@@ -1695,7 +2136,6 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 
   <!-- ============================== COLORES ============================== -->
   <section id="colores">
-    <p class="ds-eyebrow">Fundamentos</p>
     <h2>Colores</h2>
     <p class="ds-lead">Un solo acento — azul acero <span class="u-mono">#7192ba</span> — sobre neutrales grisáceo-azulados derivados de la tinta <span class="u-mono">#31343e</span>. Haz clic en cualquier muestra para copiar su variable.</p>
 
@@ -1713,7 +2153,7 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
     <p>Los componentes consumen <strong>solo esta capa</strong> — así el cambio de tema es un cambio de atributo.</p>
     <div class="ds-demo ds-demo--col" style="padding:16px">
       <table class="table" id="aliasTable">
-        <thead><tr><th style="width:52px"></th><th>Alias</th><th>Valor (light)</th><th>Rol</th></tr></thead>
+        <thead><tr><th style="width:min(100%, 52px)"></th><th>Alias</th><th>Valor (light)</th><th>Rol</th></tr></thead>
         <tbody></tbody>
       </table>
     </div>
@@ -1730,14 +2170,13 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
     <div class="ds-ratio">
       <div style="flex:6;background:var(--bg);color:var(--text-secondary)">60% neutrales claros</div>
       <div style="flex:3;background:var(--neutral-600);color:#fff">30% tinta y estructura</div>
-      <div style="flex:1;background:var(--accent);color:var(--text-on-primary)">10%</div>
+      <div style="flex:1;background:var(--action-bg);color:var(--text-on-action)">10%</div>
     </div>
     <p><strong>Un solo botón primario visible por pantalla</strong>; el resto secundarios o ghost. Fondos siempre planos: sin gradientes, texturas ni patrones. El acento pierde poder si supera el 10&nbsp;%.</p>
   </section>
 
   <!-- ============================== TIPOGRAFÍA ============================== -->
   <section id="tipografia">
-    <p class="ds-eyebrow">Fundamentos</p>
     <h2>Tipografía</h2>
     <p class="ds-lead">Tres familias con roles estrictos. Escala 1.25 (tercera mayor) desde 16&nbsp;px.</p>
 
@@ -1766,7 +2205,6 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 
   <!-- ============================== ESPACIADO ============================== -->
   <section id="espaciado">
-    <p class="ds-eyebrow">Fundamentos</p>
     <h2>Espaciado</h2>
     <p class="ds-lead">Escala base 4&nbsp;px — cero valores mágicos. El número del token = px ÷ 4.</p>
     <div class="ds-space-list" id="spaceScale"></div>
@@ -1788,7 +2226,6 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 
   <!-- ============================== BORDES, RADIOS Y FOCUS ============================== -->
   <section id="bordes">
-    <p class="ds-eyebrow">Fundamentos</p>
     <h2>Bordes, radios y focus</h2>
     <p class="ds-lead">Bordes de 1&nbsp;px, radios generosos y un focus siempre visible — la geometría que sostiene la calma de la marca.</p>
     <h3>Radios</h3>
@@ -1797,14 +2234,13 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
       <div class="ds-radius-box" style="border-radius:var(--radius-md)">md · 10</div>
       <div class="ds-radius-box" style="border-radius:var(--radius-lg)">lg · 14</div>
       <div class="ds-radius-box" style="border-radius:var(--radius-xl)">xl · 20</div>
-      <div class="ds-radius-box" style="border-radius:var(--radius-full);width:72px">full</div>
+      <div class="ds-radius-box" style="border-radius:var(--radius-full);width:min(100%, 72px)">full</div>
     </div>
     <p>Borde por defecto <span class="u-mono">1px solid var(--border)</span>. Focus ring global de teclado: <span class="u-mono">2px var(--primary-500)</span> con offset 2px vía <span class="u-mono">:focus-visible</span> — el click de ratón no lo dispara. Único uso de transparencia: overlay de modal y ring de focus. <strong>No hay blur ni glassmorphism en Celeste Clásica.</strong></p>
   </section>
 
   <!-- ============================== ELEVACIÓN ============================== -->
   <section id="elevacion">
-    <p class="ds-eyebrow">Fundamentos</p>
     <h2>Elevación</h2>
     <p class="ds-lead">Sombras frías teñidas con la tinta <span class="u-mono">rgba(49,52,62,…)</span>, nunca negro puro. Máximo 3 niveles de elevación visibles por pantalla. Sin resplandor de acento: el <span class="u-mono">glow</span> es exclusivo de Nocturna Eléctrica.</p>
     <h3>Niveles</h3>
@@ -1826,7 +2262,6 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 
   <!-- ============================== ICONOGRAFÍA ============================== -->
   <section id="iconografia">
-    <p class="ds-eyebrow">Fundamentos</p>
     <h2>Iconografía</h2>
     <p class="ds-lead">Set sustituto: <a class="link" href="https://lucide.dev" target="_blank" rel="noopener noreferrer">Lucide</a> — trazo 1.5–2&nbsp;px, esquinas redondeadas, geométrico. Si existe un set propio de marca, reemplazar.</p>
     <div class="ds-icon-grid">
@@ -1846,7 +2281,6 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 
   <!-- ============================== MARCA / WORDMARK ============================== -->
   <section id="marca">
-    <p class="ds-eyebrow">Fundamentos</p>
     <h2>Marca / wordmark</h2>
     <p class="ds-lead">No hay logo ni imágenes de marca. Donde un mockup necesite logotipo se renderiza <strong>«Higinio»</strong> (o el nombre del producto) en <span class="u-mono">--font-display</span> (Fraunces) — nunca se dibuja un logo aproximado.</p>
     <div class="ds-demo" style="gap:32px">
@@ -1863,7 +2297,6 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 
   <!-- ============================== COMPONENTES ============================== -->
   <section id="componentes">
-    <p class="ds-eyebrow">Biblioteca</p>
     <h2>Componentes</h2>
     <p class="ds-lead">Los 35 componentes del sistema, renderizados en vivo con las clases del framework <span class="u-mono">celeste-clasica.css</span>. Cada bloque incluye su código de uso.</p>
 
@@ -1932,8 +2365,8 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
       <p class="ds-spec">Trazo 2.5, rotación 0.8 s linear. Si la carga dura &lt;300 ms, no mostrar spinner. Blanco dentro de botones primarios.</p>
       <div class="ds-demo">
         <svg class="spinner" viewBox="0 0 24 24" fill="none"><circle cx="12" cy="12" r="9" stroke="currentColor" stroke-width="2.5"/><path d="M21 12a9 9 0 0 0-9-9" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"/></svg>
-        <svg class="spinner" style="width:24px;height:24px" viewBox="0 0 24 24" fill="none"><circle cx="12" cy="12" r="9" stroke="currentColor" stroke-width="2.5"/><path d="M21 12a9 9 0 0 0-9-9" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"/></svg>
-        <svg class="spinner" style="width:32px;height:32px;color:var(--text-muted)" viewBox="0 0 24 24" fill="none"><circle cx="12" cy="12" r="9" stroke="currentColor" stroke-width="2.5"/><path d="M21 12a9 9 0 0 0-9-9" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"/></svg>
+        <svg class="spinner" style="width:min(100%, 24px);height:24px" viewBox="0 0 24 24" fill="none"><circle cx="12" cy="12" r="9" stroke="currentColor" stroke-width="2.5"/><path d="M21 12a9 9 0 0 0-9-9" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"/></svg>
+        <svg class="spinner" style="width:min(100%, 32px);height:32px;color:var(--text-muted)" viewBox="0 0 24 24" fill="none"><circle cx="12" cy="12" r="9" stroke="currentColor" stroke-width="2.5"/><path d="M21 12a9 9 0 0 0-9-9" stroke="currentColor" stroke-width="2.5" stroke-linecap="round"/></svg>
       </div>
       <details class="ds-code"><summary>Ver código</summary>
         <div class="ds-code-box"><button class="ds-copy">Copiar</button>
@@ -2463,7 +2896,7 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
       <p class="ds-spec">Panel 190 px mín. con <span class="u-mono">shadow-lg</span> · entrada fade + translateY(-4→0) 160 ms · ítem danger con hover <span class="u-mono">danger-100</span>.</p>
       <div class="ds-demo" style="padding-bottom:180px">
         <div class="menu-wrap">
-          <button class="btn btn--secondary js-menu-toggle">Acciones<svg style="width:16px;height:16px"><use href="#i-chevron-down"/></svg></button>
+          <button class="btn btn--secondary js-menu-toggle">Acciones<svg style="width:min(100%, 16px);height:16px"><use href="#i-chevron-down"/></svg></button>
           <div class="menu" role="menu">
             <button class="menu__item" role="menuitem"><svg><use href="#i-pencil"/></svg>Editar</button>
             <button class="menu__item" role="menuitem"><svg><use href="#i-copy"/></svg>Duplicar</button>
@@ -2569,13 +3002,13 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
     <!-- Stat -->
     <div class="ds-component" id="comp-stat">
       <h3>Stat</h3>
-      <p class="ds-spec">KPI único, componer dentro de Card. Valor en mono <span class="u-mono">text-3xl</span> · delta con flecha en tonos <span class="u-mono">--*-text</span> · count-up al entrar en viewport.</p>
+      <p class="ds-spec">KPI único, componer dentro de Card. Valor en mono <span class="u-mono">text-3xl</span> · delta con flecha en tonos <span class="u-mono">--*-text</span> · valor final visible desde la carga.</p>
       <div class="grid">
         <div class="card col-12 col-md-4">
           <div class="stat">
             <span class="stat__label"><svg><use href="#i-chart"/></svg>Ingresos del mes</span>
             <div class="stat__row">
-              <span class="stat__value js-countup" data-target="128400" data-prefix="$ ">$ 0</span>
+              <span class="stat__value " data-target="128400" data-prefix="$ ">$ 128,400</span>
               <span class="stat__delta stat__delta--up"><svg><use href="#i-trending-up"/></svg>+12.4%</span>
             </div>
           </div>
@@ -2584,7 +3017,7 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
           <div class="stat">
             <span class="stat__label"><svg><use href="#i-user"/></svg>Clientes activos</span>
             <div class="stat__row">
-              <span class="stat__value js-countup" data-target="1284">0</span>
+              <span class="stat__value " data-target="1284">1,284</span>
               <span class="stat__delta stat__delta--down"><svg><use href="#i-trending-down"/></svg>-2.1%</span>
             </div>
           </div>
@@ -2593,7 +3026,7 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
           <div class="stat">
             <span class="stat__label"><svg><use href="#i-folder"/></svg>Proyectos abiertos</span>
             <div class="stat__row">
-              <span class="stat__value js-countup" data-target="37">0</span>
+              <span class="stat__value " data-target="37">37</span>
               <span class="stat__delta"><svg><use href="#i-minus"/></svg>0%</span>
             </div>
           </div>
@@ -2778,7 +3211,7 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
       <div class="grid">
         <div class="card col-12 col-md-6">
           <div style="display:flex;gap:12px;align-items:center;margin-bottom:16px">
-            <div class="skeleton skeleton--circle" style="width:40px;height:40px"></div>
+            <div class="skeleton skeleton--circle" style="width:min(100%, 40px);height:40px"></div>
             <div style="flex:1;display:flex;flex-direction:column;gap:8px">
               <div class="skeleton" style="height:12px;width:60%"></div>
               <div class="skeleton" style="height:10px;width:40%"></div>
@@ -2800,7 +3233,7 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
       <details class="ds-code"><summary>Ver código</summary>
         <div class="ds-code-box"><button class="ds-copy">Copiar</button>
 <pre class="ds-pre"><code>&lt;div class="skeleton" style="height:10px;width:85%"&gt;&lt;/div&gt;
-&lt;div class="skeleton skeleton--circle" style="width:40px;height:40px"&gt;&lt;/div&gt;
+&lt;div class="skeleton skeleton--circle" style="width:min(100%, 40px);height:40px"&gt;&lt;/div&gt;
 
 &lt;div class="empty-state"&gt;
   &lt;svg&gt;…icono 40px…&lt;/svg&gt;
@@ -3206,7 +3639,6 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 
   <!-- ============================== MOTION ============================== -->
   <section id="motion">
-    <p class="ds-eyebrow">Sistema</p>
     <h2>Motion</h2>
     <p class="ds-lead">Solo <span class="u-mono">transform</span> y <span class="u-mono">opacity</span>. La salida siempre ~20 % más corta que la entrada. Distancias de 4–8 px: nada "vuela" por la pantalla.</p>
     <div class="ds-demo ds-demo--col" style="padding:16px">
@@ -3231,13 +3663,12 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
     <ul style="max-width:var(--measure)">
       <li>Stagger en listas: 30 ms por ítem, máximo 6 ítems.</li>
       <li>Si la carga dura &lt;300 ms, no mostrar spinner (evita parpadeo).</li>
-      <li><span class="u-mono">prefers-reduced-motion</span> colapsa toda animación a 0.01 ms.</li>
+      <li><span class="u-mono">prefers-reduced-motion</span> conserva estados finales, evita desplazamientos y detiene la carga animada.</li>
     </ul>
   </section>
 
   <!-- ============================== ACCESIBILIDAD ============================== -->
   <section id="accesibilidad">
-    <p class="ds-eyebrow">Sistema</p>
     <h2>Accesibilidad</h2>
     <p class="ds-lead">WCAG AA mínimo: 4.5:1 texto normal, 3:1 texto grande y componentes UI. Touch targets de 44×44 px. Estado nunca comunicado solo con color.</p>
     <div class="ds-demo ds-demo--col" style="padding:16px">
@@ -3261,73 +3692,208 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 
   <!-- ============================== TOKENS Y DESCARGA ============================== -->
   <section id="tokens">
-    <p class="ds-eyebrow">Sistema</p>
     <h2>Tokens y descarga</h2>
     <p class="ds-lead">El sistema completo vive en <span class="u-mono">dist/celeste-clasica/</span>: <span class="u-mono">celeste-clasica.css</span> (framework completo), <span class="u-mono">tokens.css</span> (solo variables), <span class="u-mono">tailwind.css</span> (@theme para Tailwind v4) y <span class="u-mono">tokens.json</span> (W3C DTCG 2025.10, interoperable con Figma / Tokens Studio / Style Dictionary).</p>
 
     <h3>Variables CSS</h3>
     <div class="ds-code-box"><button class="ds-copy">Copiar</button>
-<pre class="ds-pre"><code>:root {
-  /* Primario */
+<pre class="ds-pre"><code>/* ============================================================
+   Celeste Clásica — Design Tokens v2.0
+   Sistema de diseño de Higinio Sosa · light-first
+   Fuente de verdad: DESIGN-celeste-clasica.md
+   Uso: importar ANTES de cualquier estilo propio.
+   Los componentes consumen SOLO aliases semánticos, nunca hex.
+   ============================================================ */
+
+@import url("https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,600;0,9..144,700;1,9..144,600&amp;family=Public+Sans:ital,wght@0,400;0,500;0,600;0,700;1,400&amp;family=IBM+Plex+Mono:wght@400;500&amp;display=swap");
+
+:root {
+  /* == Primitivos: primario (Azul Acero) == */
   --primary-50: #f2f6fa; --primary-100: #dfe9f2; --primary-200: #c3d5e6;
   --primary-300: #a0c0d4; --primary-400: #87a8c7; --primary-500: #7192ba;
   --primary-600: #5d7ba3; --primary-700: #4d6588; --primary-800: #40536e;
   --primary-900: #31343e;
 
-  /* Neutrales */
+  /* == Primitivos: neutrales (Gris Azulado) == */
   --neutral-0: #ffffff; --neutral-50: #f7f8fa; --neutral-100: #eef0f3;
   --neutral-200: #dcdfe5; --neutral-300: #b8bdc7; --neutral-400: #8a8f9c;
   --neutral-500: #666b78; --neutral-600: #4d5160; --neutral-700: #3d414e;
   --neutral-800: #31343e; --neutral-900: #22242b;
 
-  /* Semánticos (ramp de 3) */
+  /* == Primitivos: semánticos (ramp de 3: sólido / fondo / texto AA) == */
   --success-500: #3d9970; --success-100: #e2f3ec; --success-text: #2b6e50;
   --warning-500: #c9922e; --warning-100: #faf1de; --warning-text: #8a651c;
   --danger-500: #c04d4d;  --danger-100: #f9e7e7;  --danger-text: #8f3232;
   --info-500: #7192ba;    --info-100: #dfe9f2;    --info-text: #4d6588;
 
-  /* Aliases (los componentes consumen SOLO esto) */
-  --bg: var(--neutral-50); --surface: var(--neutral-0); --surface-alt: var(--neutral-100);
-  --border: var(--neutral-200); --border-strong: var(--neutral-300);
-  --text-primary: var(--neutral-800); --text-secondary: var(--neutral-600);
-  --text-muted: var(--neutral-500); --text-disabled: var(--neutral-400);
-  --text-on-primary: #ffffff; --text-on-primary-solid: var(--primary-700);
-  --accent: var(--primary-500); --accent-hover: var(--primary-600);
-  --accent-active: var(--primary-700); --accent-soft: var(--primary-50);
-  --accent-soft-strong: var(--primary-100); --link: var(--primary-700);
-
-  /* Tipografía */
+  /* == Aliases semánticos (los componentes consumen SOLO esto) == */
+  --bg: var(--neutral-50);
+  --surface: var(--neutral-0);
+  --surface-alt: var(--neutral-100);
+  --border: var(--neutral-200);
+  --border-strong: var(--neutral-300);
+  --text-primary: var(--neutral-800);
+  --text-secondary: var(--neutral-600);
+  --text-muted: var(--neutral-500);
+  --text-disabled: var(--neutral-400);
+  --text-on-primary: #ffffff;
+  --text-on-primary-solid: var(--primary-700);
+  --accent: var(--primary-500);
+  --accent-hover: var(--primary-600);
+  --accent-active: var(--primary-700);
+  --accent-soft: var(--primary-50);
+  --accent-soft-strong: var(--primary-100);
+  --link: var(--primary-700); /* AA ~6:1 — texto de links y ghost; primary-500 solo para UI */
+
+  /* == Tipografía == */
   --font-display: "Fraunces", Georgia, serif;
   --font-body: "Public Sans", system-ui, -apple-system, sans-serif;
   --font-mono: "IBM Plex Mono", ui-monospace, monospace;
   --text-xs: .75rem; --text-sm: .875rem; --text-base: 1rem; --text-lg: 1.125rem;
   --text-xl: 1.25rem; --text-2xl: 1.5625rem; --text-3xl: 1.9375rem;
   --text-4xl: 2.4375rem; --text-5xl: 3.0625rem;
-  --tracking-display: -0.02em; --tracking-label: 0.04em; --measure: 65ch;
+  --leading-xs: 1.5; --leading-sm: 1.5; --leading-base: 1.6; --leading-lg: 1.55;
+  --leading-xl: 1.4; --leading-2xl: 1.3; --leading-3xl: 1.25;
+  --leading-4xl: 1.15; --leading-5xl: 1.1;
+  --tracking-display: -0.02em; --tracking-body: 0; --tracking-label: 0.04em;
+  --weight-regular: 400; --weight-medium: 500; --weight-semibold: 600; --weight-bold: 700;
+  --measure: 65ch;
 
-  /* Espaciado (base 4px) */
+  /* == Espaciado (escala base 4px) == */
   --space-1: 4px; --space-2: 8px; --space-3: 12px; --space-4: 16px;
   --space-5: 20px; --space-6: 24px; --space-8: 32px; --space-10: 40px;
   --space-12: 48px; --space-16: 64px; --space-20: 80px; --space-24: 96px;
+  --card-padding: var(--space-6); --card-padding-mobile: var(--space-4);
+  --section-gap: var(--space-16); --form-gap: var(--space-5);
+  --button-padding-md: 12px 20px; --button-padding-sm: 8px 14px;
   --control-height-sm: 36px; --control-height-md: 44px; --control-height-lg: 52px;
+  --gutter: 24px; --gutter-mobile: 16px;
 
-  /* Radios y sombras */
+  /* == Radios, bordes y sombras (teñidas de tinta, nunca negro puro) == */
   --radius-sm: 6px; --radius-md: 10px; --radius-lg: 14px;
   --radius-xl: 20px; --radius-full: 9999px;
+  --border-width: 1px;
   --shadow-xs: 0 1px 2px rgba(49,52,62,.06);
   --shadow-sm: 0 1px 3px rgba(49,52,62,.08), 0 1px 2px rgba(49,52,62,.05);
   --shadow-md: 0 4px 8px rgba(49,52,62,.09), 0 2px 4px rgba(49,52,62,.05);
   --shadow-lg: 0 12px 24px rgba(49,52,62,.12), 0 4px 8px rgba(49,52,62,.06);
   --shadow-xl: 0 24px 48px rgba(49,52,62,.16);
+
+  /* == Focus == */
   --ring: 0 0 0 3px rgba(113,146,186,.25);
+  --ring-color: rgba(113,146,186,.25);
 
-  /* Motion */
+  /* == Motion == */
   --duration-instant: 100ms; --duration-fast: 150ms; --duration-base: 200ms;
   --duration-slow: 250ms; --duration-page: 320ms;
   --ease-out: cubic-bezier(0.2, 0, 0, 1);
   --ease-in: cubic-bezier(0.4, 0, 1, 1);
-  --ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);
+  --ease-in-out: cubic-bezier(0.65, 0, 0.35, 1); /* moverse de A a B en pantalla */
   --ease-spring: cubic-bezier(0.34, 1.4, 0.64, 1);
+  --stagger-step: 30ms;
+
+  color-scheme: light;
+
+  --overlay: rgba(49, 52, 62, .5);
+  --tooltip-bg: var(--neutral-900);
+  --tooltip-text: #ffffff;
+  --ring-danger: 0 0 0 3px rgba(192,77,77,.22);
+
+  --action-bg: var(--primary-700);
+  --action-hover: var(--primary-800);
+  --action-active: var(--primary-900);
+  --text-on-action: var(--text-on-primary);
+  --control-border: var(--neutral-400);
+  --placeholder: var(--text-muted);
+  --selection-bg: var(--action-bg);
+  --selection-text: var(--text-on-action);
+  --font-ui-heading: var(--font-body);
+  --text-ui-title: 2rem;
+  --touch-target: 44px;
+  --focus-color: var(--accent);
+  --text-display-fluid: clamp(2.75rem, 1.7rem + 3vw, 4.75rem);
+  --border-hover: var(--neutral-500);
+  --text-on-danger: #ffffff;
+
+  /* Series categóricas: orden estable; acompañar con etiqueta o forma. */
+  --chart-1: #4a8cc1;
+  --chart-2: #853f63;
+  --chart-3: #129a92;
+  --chart-4: #8e4031;
+  --chart-5: #5b975e;
+  --chart-6: #8a600a;
+  --chart-7: #857bc1;
+  /* Ritmo de contenido y formularios. */
+  --field-gap: 6px;
+  --heading-gap: var(--space-2);
+  --content-gap: var(--space-4);
+  --card-content-gap: var(--space-4);
+  --card-group-gap: var(--space-6);
+
+}
+
+/* == Modo oscuro (variante) — alternar data-theme en &lt;html&gt; == */
+[data-theme="dark"] {
+  --bg: #16181e;
+  --surface: #1d2028;
+  --surface-alt: #252935;
+  --border: #3a3f4d;
+  --border-strong: #4a5060;
+  --text-primary: #e6e9ee;
+  --text-secondary: #b9bfcb;
+  --text-muted: #8b91a0;
+  --text-disabled: #6f7585;
+  --accent: #87a8c7;
+  --accent-hover: #a0c0d4;
+  --accent-active: #7192ba;
+  --accent-soft: rgba(113,146,186,.12);
+  --accent-soft-strong: rgba(113,146,186,.18);
+  --text-on-primary: #16181e;
+  --link: #a0c0d4;
+  --success-500: #5cbf93; --success-100: #12291f; --success-text: #7fd4ae;
+  --warning-500: #e0ad4d; --warning-100: #2b2210; --warning-text: #ecc57e;
+  --danger-500: #e07777;  --danger-100: #2e1515;  --danger-text: #eb9e9e;
+  --info-500: #87a8c7;    --info-100: #1a2430;    --info-text: #a0c0d4;
+  --ring: 0 0 0 3px rgba(160,192,212,.3);
+  --ring-color: rgba(160,192,212,.3);
+  --shadow-sm: 0 1px 2px rgba(0,0,0,.35);
+  --shadow-md: 0 4px 12px rgba(0,0,0,.45);
+  --shadow-lg: 0 12px 32px rgba(0,0,0,.55);
+  color-scheme: dark;
+
+  --text-on-primary-solid: #a0c0d4;
+  --overlay: rgba(0, 0, 0, .6);
+  --tooltip-bg: #e6e9ee;
+  --tooltip-text: #31343e;
+  --ring-danger: 0 0 0 3px rgba(224,119,119,.25);
+
+  --selection-bg: var(--action-bg);
+  --selection-text: var(--text-on-action);
+  --action-bg: var(--accent);
+  --action-hover: var(--accent-hover);
+  --action-active: var(--accent-active);
+  --control-border: var(--text-muted);
+  --border-hover: var(--text-secondary);
+  --text-on-danger: #16181e;
+  --focus-color: var(--accent);
+
+  /* Series categóricas: orden estable; acompañar con etiqueta o forma. */
+  --chart-1: #5798ce;
+  --chart-2: #a0587c;
+  --chart-3: #2aa79e;
+  --chart-4: #aa5849;
+  --chart-5: #67a369;
+  --chart-6: #946a1c;
+  --chart-7: #877cc3;
+}
+
+/* == Accesibilidad del movimiento == */
+
+@media (prefers-reduced-motion: reduce) {
+  :root {
+    --duration-instant: 0ms; --duration-fast: 0ms; --duration-base: 0ms;
+    --duration-slow: 0ms; --duration-page: 0ms; --stagger-step: 0ms;
+  }
 }</code></pre>
     </div>
 
@@ -3388,7 +3954,6 @@ button.metric-chip:focus-visible { outline: 2px solid var(--accent); outline-off
 
   <!-- ============================== INSTALACIÓN ============================== -->
   <section id="instalacion">
-    <p class="ds-eyebrow">Sistema</p>
     <h2>Instalación</h2>
     <p class="ds-lead">El sistema se distribuye como paquete npm (<span class="u-mono">@higinio/design-css</span>) y también como archivos sueltos en <span class="u-mono">dist/celeste-clasica/</span>. Instálalo o cópialos, y elige qué importar según tu stack (A/B/C). En todas: <strong>light por defecto</strong>; <span class="u-mono">&lt;html data-theme="dark"&gt;</span> activa el modo oscuro, y los componentes consumen <strong>solo aliases semánticos</strong>, nunca hex.</p>
 
@@ -3453,7 +4018,6 @@ npm i tailwindcss @tailwindcss/postcss
 
   <!-- ============================== MCP ============================== -->
   <section id="mcp">
-    <p class="ds-eyebrow">Sistema</p>
     <h2>MCP</h2>
     <p class="ds-lead">El paquete <span class="code">@higinio/design-mcp</span> expone los sistemas de diseño de Higinio Sosa, entre ellos Celeste Clásica (<span class="u-mono">system="celeste"</span>), a cualquier IDE o cliente compatible con Model Context Protocol: tokens, componentes, reglas duras y validación de código. Complementa a las skills de Claude, no las reemplaza: misma fuente de verdad, accesible también fuera del entorno de Claude.</p>
 
@@ -3654,24 +4218,6 @@ npm i tailwindcss @tailwindcss/postcss
   if (heroStart) heroStart.addEventListener("click", function () { scrollToId("componentes"); });
   if (heroTokens) heroTokens.addEventListener("click", function () { scrollToId("tokens"); });
 
-  /* ---------- Menú móvil ---------- */
-  var burger = d.getElementById("dsHamburger");
-  var sidenav = d.getElementById("dsSidenav");
-  if (burger && sidenav) {
-    burger.addEventListener("click", function (e) {
-      e.stopPropagation();
-      sidenav.classList.toggle("is-open");
-    });
-    d.addEventListener("click", function (e) {
-      if (sidenav.classList.contains("is-open") && !sidenav.contains(e.target) && e.target !== burger) {
-        sidenav.classList.remove("is-open");
-      }
-    });
-    sidenav.addEventListener("click", function (e) {
-      if (e.target.closest("a")) sidenav.classList.remove("is-open");
-    });
-  }
-
   /* ---------- Copiar al portapapeles ---------- */
   function copyText(text, feedbackFn) {
     function done() { if (feedbackFn) feedbackFn(); }
@@ -3695,7 +4241,7 @@ npm i tailwindcss @tailwindcss/postcss
     if (!code) return;
     copyText(code.textContent, function () {
       var prev = btn.textContent;
-      btn.textContent = "¡Copiado!";
+      btn.textContent = "Copiado";
       setTimeout(function () { btn.textContent = prev; }, 1600);
     });
   });
@@ -3747,10 +4293,10 @@ npm i tailwindcss @tailwindcss/postcss
     ["--text-primary", "neutral-800", "Texto principal"],
     ["--text-secondary", "neutral-600", "Texto secundario"],
     ["--text-muted", "neutral-500", "Terciario, captions"],
-    ["--text-disabled", "neutral-400", "Deshabilitado, placeholder"],
-    ["--text-on-primary", "#ffffff", "Texto sobre botón primario"],
-    ["--accent", "primary-500", "Rellenos de acción, bordes activos, focus"],
-    ["--accent-hover", "primary-600", "Hover del primario"],
+    ["--text-disabled", "neutral-400", "Solo controles deshabilitados"],
+    ["--text-on-primary", "#ffffff", "Texto de compatibilidad sobre acento"],
+    ["--accent", "primary-500", "Firma de marca y acentos de UI"],
+    ["--accent-hover", "primary-600", "Hover del acento de marca"],
     ["--accent-active", "primary-700", "Pressed"],
     ["--accent-soft", "primary-50", "Hover de ghost, fondos sutiles"],
     ["--accent-soft-strong", "primary-100", "Seleccionados suaves"],
@@ -3798,7 +4344,7 @@ npm i tailwindcss @tailwindcss/postcss
     var tr = d.createElement("tr");
     var chipColor = a[1].indexOf("#") === 0 ? a[1] : "var(--" + a[1] + ")";
     tr.innerHTML =
-      '<td><span style="display:inline-block;width:24px;height:24px;border-radius:6px;border:1px solid var(--border);background:' + chipColor + '"></span></td>' +
+      '<td><span style="display:inline-block;width:min(100%, 24px);height:24px;border-radius:6px;border:1px solid var(--border);background:' + chipColor + '"></span></td>' +
       '<td class="u-mono">' + a[0] + "</td>" +
       '<td class="u-mono" style="color:var(--text-muted)">' + a[1] + "</td>" +
       "<td>" + a[2] + "</td>";
@@ -3812,7 +4358,7 @@ npm i tailwindcss @tailwindcss/postcss
       var nameEl = sw.querySelector(".ds-swatch__name") || sw.querySelector(".ds-swatch__hex");
       if (!nameEl) return;
       var prev = nameEl.textContent;
-      nameEl.textContent = "¡Copiado!";
+      nameEl.textContent = "Copiado";
       setTimeout(function () { nameEl.textContent = prev; }, 1200);
     });
   });
@@ -4097,7 +4643,8 @@ npm i tailwindcss @tailwindcss/postcss
     function dismiss() {
       if (!toast.parentElement) return;
       toast.classList.add("is-leaving");
-      toast.addEventListener("animationend", function () { toast.remove(); });
+      toast.addEventListener("animationend", function () { toast.remove(); }, { once: true });
+      setTimeout(function () { toast.remove(); }, 400);
       if (reduceMotion) toast.remove();
     }
   }
@@ -4173,40 +4720,6 @@ npm i tailwindcss @tailwindcss/postcss
     renderPagination();
   }
 
-  /* ---------- Count-up de Stat ---------- */
-  function countUp(el) {
-    var target = parseFloat(el.getAttribute("data-target") || 0);
-    var prefix = el.getAttribute("data-prefix") || "";
-    var suffix = el.getAttribute("data-suffix") || "";
-    function fmt(v) { return prefix + Math.round(v).toLocaleString("es-MX") + suffix; }
-    if (reduceMotion) { el.textContent = fmt(target); return; }
-    var start = null, DUR = 600;
-    function tick(ts) {
-      if (start === null) start = ts;
-      var t = Math.min(1, (ts - start) / DUR);
-      var eased = 1 - Math.pow(1 - t, 3);
-      el.textContent = fmt(target * eased);
-      if (t < 1) requestAnimationFrame(tick);
-    }
-    requestAnimationFrame(tick);
-  }
-  var countEls = d.querySelectorAll(".js-countup");
-  if ("IntersectionObserver" in window) {
-    var seen = new WeakSet();
-    var counter = new IntersectionObserver(function (entries) {
-      entries.forEach(function (entry) {
-        if (entry.isIntersecting && !seen.has(entry.target)) {
-          seen.add(entry.target);
-          countUp(entry.target);
-          counter.unobserve(entry.target);
-        }
-      });
-    }, { threshold: 0.4 });
-    Array.prototype.forEach.call(countEls, function (el) { counter.observe(el); });
-  } else {
-    Array.prototype.forEach.call(countEls, countUp);
-  }
-
   /* ---------- Drawer (§10.29): focus-trap + retorno de foco + Esc ---------- */
   var drawerTrigger = null;
   function openDrawer(dr, trigger) {
@@ -4525,6 +5038,75 @@ npm i tailwindcss @tailwindcss/postcss
     });
   }
 })();
+</script>
+<!-- INTERACCIONES COMPARTIDAS GENERADAS -->
+<script>
+(function () {
+  "use strict";
+  var trigger = document.getElementById("dsHamburger");
+  var panel = document.getElementById("dsSidenav") || document.getElementById("dsSidebar");
+  var mobile = window.matchMedia("(max-width: 1023px)");
+
+  /**
+   * Actualiza la navegación como disclosure, sin crear una trampa de foco.
+   * @param {boolean} open - Si la navegación móvil debe estar disponible.
+   * @param {boolean} restore - Si el cierre debe devolver foco al disparador.
+   * @returns {void}
+   */
+  function setNavigation(open, restore) {
+    if (!trigger || !panel) return;
+    panel.classList.toggle("is-open", open);
+    panel.inert = mobile.matches && !open;
+    trigger.setAttribute("aria-expanded", String(open));
+    trigger.setAttribute("aria-label", open ? "Cerrar navegación" : "Abrir navegación");
+    if (restore) trigger.focus();
+  }
+
+  if (trigger && panel) {
+    trigger.setAttribute("aria-controls", panel.id);
+    setNavigation(false, false);
+    trigger.addEventListener("click", function () { setNavigation(!panel.classList.contains("is-open"), false); });
+    panel.addEventListener("click", function (event) {
+      var link = event.target.closest("a[href^='#']");
+      if (!link || !mobile.matches) return;
+      var target = document.getElementById(link.hash.slice(1));
+      setNavigation(false, false);
+      if (target) {
+        target.setAttribute("tabindex", "-1");
+        target.focus({ preventScroll: true });
+      }
+    });
+    document.addEventListener("keydown", function (event) {
+      if (event.key === "Escape" && mobile.matches && panel.classList.contains("is-open")) setNavigation(false, true);
+    });
+    document.addEventListener("click", function (event) {
+      if (mobile.matches && !panel.contains(event.target) && !trigger.contains(event.target)) setNavigation(false, false);
+    });
+    mobile.addEventListener("change", function () { setNavigation(false, false); });
+  }
+
+  var themeButton = document.getElementById("dsThemeToggle") || document.getElementById("dsTheme");
+  /**
+   * Nombra la acción de tema y mantiene semántica de ubicación en el índice.
+   * @returns {void}
+   */
+  function updateLabels() {
+    if (themeButton) themeButton.setAttribute("aria-label", document.documentElement.dataset.theme === "dark" ? "Usar tema claro" : "Usar tema oscuro");
+    document.querySelectorAll(".ds-nav a").forEach(function (link) {
+      if (link.classList.contains("is-active")) link.setAttribute("aria-current", "location");
+      else link.removeAttribute("aria-current");
+    });
+    var style = getComputedStyle(document.documentElement);
+    document.querySelectorAll("[data-chart-color]").forEach(function (label) {
+      label.textContent = style.getPropertyValue(label.getAttribute("data-chart-color")).trim();
+    });
+  }
+  updateLabels();
+  new MutationObserver(updateLabels).observe(document.documentElement, { attributes: true, attributeFilter: ["data-theme"] });
+  var nav = document.querySelector(".ds-nav");
+  if (nav) new MutationObserver(updateLabels).observe(nav, { subtree: true, attributes: true, attributeFilter: ["class"] });
+})();
+
 </script>
 </body>
 </html>