@donotdev/ui 0.0.2 → 0.0.4

package/dist/styles/index.css

@@ -18,9 +18,10 @@
      Used by: CSS @media queries, JavaScript hooks, responsive components
      Note: CSS variables don't work in @media, so we use hardcoded px values
      =========================== */
-  --breakpoint-mobile: 768px;
-  --breakpoint-tablet: 1024px; /* Key breakpoint, layout presets are based on mobile + tablet vs desktop+wide breakpoints */
-  --breakpoint-desktop: 1440px;
+  --breakpoint-mobile: 768px;   /* < 768 = mobile */
+  --breakpoint-tablet: 1024px;  /* 768-1023 = tablet */
+  --breakpoint-laptop: 1440px;  /* 1024-1439 = laptop (key layout split) */
+  --breakpoint-desktop: 1920px; /* 1440+ = desktop */
 
   /* ===========================
      INTERACTIVE ELEMENTS
@@ -285,28 +286,48 @@
 /* Compact (Admin/Data) - Dense, information-dense layouts - Minor Third (1.2×) */
 
 [data-density='compact'] {
-  --font-size-base: 0.875rem; /* 14px */
-  --font-size-lg: 1.05rem; /* base × 1.2¹ */
-  --font-size-xl: 1.26rem; /* base × 1.2² */
-  --font-size-2xl: 1.512rem; /* base × 1.2³ */
-  --font-size-3xl: 1.814rem; /* base × 1.2⁴ */
-  --gap-sm: 0.375rem; /* 6px - tighter than standard */
-  --gap-md: 0.75rem; /* 12px */
-  --gap-lg: 1.5rem; /* 24px */
+  /* Base sizes: Fluid responsiveness for all text, zoom-safe */
+  --font-size-base: clamp(0.875rem, 0.8125rem + 0.25vw, 0.9375rem); /* 14-15px fluid */
+  --font-size-lg: clamp(1.05rem, 0.9375rem + 0.5vw, 1.125rem); /* 17-18px fluid */
+  --font-size-xl: clamp(1.26rem, 1.125rem + 0.75vw, 1.375rem); /* 20-22px fluid */
+  /* Display sizes: Musical scale + fluid responsiveness */
+  --font-size-2xl: clamp(
+    1.512rem,
+    1.375rem + 0.75vw,
+    1.625rem
+  ); /* 24-26px fluid */
+  --font-size-3xl: clamp(
+    1.814rem,
+    1.625rem + 1vw,
+    2rem
+  ); /* 29-32px fluid */
+  --gap-sm: clamp(0.375rem, 0.3125rem + 0.25vw, 0.5rem); /* 6-8px fluid */
+  --gap-md: clamp(0.75rem, 0.625rem + 0.5vw, 0.875rem); /* 12-14px fluid, zoom-safe */
+  --gap-lg: clamp(1.5rem, 1.25rem + 1vw, 1.75rem); /* 24-28px fluid, zoom-safe */
   --line-height: 1.2; /* Minor Third - All text */
 }
 
 /* Standard (Docs/SaaS) - DEFAULT, balanced for readability */
 
 [data-density='standard'] {
-  --font-size-base: 1rem; /* 16px */
-  --font-size-lg: 1.25rem; /* 20px - base × 1.25¹ */
-  --font-size-xl: 1.563rem; /* 25px - base × 1.25² */
-  --font-size-2xl: 1.953rem; /* 31px - base × 1.25³ */
-  --font-size-3xl: 2.441rem; /* 39px - base × 1.25⁴ - hero text */
-  --gap-sm: 0.5rem; /* 8px - explicit default */
-  --gap-md: 1rem; /* 16px */
-  --gap-lg: 2rem; /* 32px */
+  /* Base sizes: Fluid responsiveness for all text, zoom-safe */
+  --font-size-base: clamp(1rem, 0.9375rem + 0.25vw, 1.0625rem); /* 16-17px fluid */
+  --font-size-lg: clamp(1.25rem, 1.125rem + 0.5vw, 1.375rem); /* 20-22px fluid */
+  --font-size-xl: clamp(1.563rem, 1.375rem + 0.75vw, 1.75rem); /* 25-28px fluid */
+  /* Display sizes: Musical scale + fluid responsiveness */
+  --font-size-2xl: clamp(
+    1.953rem,
+    1.75rem + 1vw,
+    2.25rem
+  ); /* 31-36px fluid */
+  --font-size-3xl: clamp(
+    2.441rem,
+    2rem + 1.5vw,
+    3rem
+  ); /* 39-48px fluid - hero text */
+  --gap-sm: clamp(0.5rem, 0.4375rem + 0.25vw, 0.625rem); /* 8-10px fluid */
+  --gap-md: clamp(1rem, 0.875rem + 0.5vw, 1.25rem); /* 16-20px fluid, zoom-safe */
+  --gap-lg: clamp(2rem, 1.75rem + 1vw, 2.5rem); /* 32-40px fluid, zoom-safe */
   --line-height: 1.25; /* Major Third - All text */
 }
 
@@ -535,52 +556,19 @@ a:not(.dndev-interactive):active {
 a:focus-visible {
     outline: 2px solid var(--ring);
     outline-offset: 2px;
-    border-radius: var(--radius-md);
+    border-radius: var(--radius-interactive);
   }
 
-/* ===========================
-   BASE LIST STYLING
-   Use text-base styles for lists
-   =========================== */
-
-/* Content lists only - not navigation menus */
-
-main ul,
-main ol,
-article ul,
-article ol {
-  font-weight: 500;
-  line-height: var(--line-height);
-  color: var(--foreground);
-  background: transparent !important;
-  list-style-position: outside;
-  padding-inline-start: var(--gap-lg);
-  margin-block: var(--gap-md);
-}
+/* Main element - no focus outline (programmatic focus for keyboard nav) */
 
-main ul,
-article ul {
-  list-style-type: disc;
-}
-
-main ol,
-article ol {
-  list-style-type: decimal;
-}
-
-main li,
-article li {
-  font-weight: 500;
-  line-height: var(--line-height);
-  color: var(--foreground);
-  background: transparent !important;
-  margin-block: var(--gap-sm);
-  padding-inline-start: var(--gap-sm);
+main:focus-visible {
+  outline: none;
 }
 
 /* ===========================
-   BASE TYPOGRAPHY STYLING
-   Use text-base styles for headings and paragraphs
+   BASE TYPOGRAPHY - RESET ONLY
+   Zero margins, components own their spacing
+   Use .prose wrapper for content pages (docs, markdown)
    =========================== */
 
 h1,
@@ -589,49 +577,71 @@ h3,
 h4,
 h5,
 h6 {
-  font-weight: 500;
+  font-weight: var(--font-weight-medium);
   line-height: var(--line-height);
   color: var(--foreground);
   background: transparent;
-  margin-block: var(--gap-md);
 }
 
 h1 {
   font-family: var(--font-headline);
   font-size: var(--font-size-3xl);
-  font-weight: 700;
+  font-weight: var(--font-weight-bold);
   letter-spacing: -0.02em;
 }
 
 h2 {
   font-family: var(--font-headline);
   font-size: var(--font-size-2xl);
-  font-weight: 700;
+  font-weight: var(--font-weight-bold);
   letter-spacing: -0.01em;
 }
 
 h3 {
   font-size: var(--font-size-xl);
-  font-weight: 600;
+  font-weight: var(--font-weight-semibold);
 }
 
 h4 {
   font-size: var(--font-size-lg);
-  font-weight: 600;
+  font-weight: var(--font-weight-semibold);
 }
 
 h5,
 h6 {
   font-size: var(--font-size-base);
-  font-weight: 600;
+  font-weight: var(--font-weight-semibold);
 }
 
 p {
-  font-weight: 500;
+  font-weight: var(--font-weight-medium);
+  line-height: var(--line-height);
+  color: var(--foreground);
+  background: transparent;
+}
+
+ul,
+ol {
+  font-weight: var(--font-weight-medium);
+  line-height: var(--line-height);
+  color: var(--foreground);
+  background: transparent;
+  list-style-position: outside;
+}
+
+ul {
+  list-style-type: disc;
+}
+
+ol {
+  list-style-type: decimal;
+}
+
+li {
+  font-weight: var(--font-weight-medium);
   line-height: var(--line-height);
   color: var(--foreground);
   background: transparent;
-  margin-block: var(--gap-md);
 }
 
 /* Semantic HTML - strong and em */
@@ -678,7 +688,7 @@ em {
 .dndev-input {
   display: flex;
   width: 100%;
-  border-radius: 0;
+  border-radius: var(--radius-interactive);
   border: var(--border-hairline) solid var(--line-2);
   background-color: transparent;
   color: var(--foreground);
@@ -940,15 +950,21 @@ em {
 
 .dndev-surface[data-role='card'] {
     padding: var(--gap-md);
-    border-radius: var(--radius-md);
+    border-radius: var(--radius-surface);
   }
 
 /* Elevated cards - stronger shadow */
 
-.dndev-surface[data-elevated='true'] {
+/* Apply if elevated=true OR (clickable=true AND elevated!=false) */
+
+.dndev-surface[data-elevated='true'],.dndev-surface[data-clickable='true']:not([data-elevated='false']) {
     box-shadow: var(--shadow-xl);
   }
 
+:is(.dndev-surface[data-elevated='true'],.dndev-surface[data-clickable='true']:not([data-elevated='false'])):dir(rtl) {
+      box-shadow: var(--shadow-xl-rtl);
+    }
+
 /* Clickable cards - hover effects */
 
 .dndev-surface[data-clickable='true'] {
@@ -1181,7 +1197,7 @@ em {
 
 .dndev-floating[data-role='card'] {
     padding: var(--gap-md);
-    border-radius: var(--radius-md);
+    border-radius: var(--radius-surface);
   }
 
 .dndev-floating[data-role='floating'] {
@@ -1643,6 +1659,38 @@ em {
     color: var(--background);
   }
 
+/* CONTROL GROUP - Shared pattern for grouped controls (RadioGroup, Checkbox groups) */
+
+.dndev-control-group {
+  display: grid;
+  gap: var(--gap-md); /* 16px - standard spacing between grouped items */
+
+  /* Control + label pattern - used by RadioGroup, CheckboxFieldComponent, etc. */
+}
+
+.dndev-control-group label {
+    display: flex;
+    align-items: center;
+    gap: var(--gap-sm); /* 8px - spacing between control and label */
+    font-size: var(--font-size-base);
+    color: var(--foreground);
+    cursor: pointer;
+    transition: color var(--transition-fast);
+
+    /* Subtle hover on label text */
+  }
+
+:is(.dndev-control-group label):hover {
+      color: var(--primary);
+    }
+
+/* Selected state - label color changes */
+
+:is(.dndev-control-group label):has([data-state='checked']),:is(.dndev-control-group label):has([data-state='on']) {
+      color: var(--primary);
+      font-weight: var(--font-weight-medium);
+    }
+
 /**
    * Variant system - 8 control variants
    * Variants override --control-border to use semantic colors
@@ -1650,37 +1698,37 @@ em {
    * On state: fills with variant color
    */
 
-.dndev-control[data-variant='primary'] {
+.dndev-control-group[data-variant='primary'] {
     --control-border: var(--primary);
   }
 
-.dndev-control[data-variant='secondary'] {
+.dndev-control-group[data-variant='secondary'] {
     --control-border: var(--secondary);
   }
 
-.dndev-control[data-variant='muted'] {
+.dndev-control-group[data-variant='muted'] {
     --control-border: var(--muted-foreground);
   }
 
-.dndev-control[data-variant='accent'] {
+.dndev-control-group[data-variant='accent'] {
     --control-border: var(--accent);
   }
 
-.dndev-control[data-variant='success'] {
+.dndev-control-group[data-variant='success'] {
     --control-border: var(--success);
   }
 
-.dndev-control[data-variant='warning'] {
+.dndev-control-group[data-variant='warning'] {
     --control-border: var(--warning);
   }
 
-.dndev-control[data-variant='destructive'] {
+.dndev-control-group[data-variant='destructive'] {
     --control-border: var(--destructive);
   }
 
 /* Default variant explicitly (same as base) */
 
-.dndev-control[data-variant='default'] {
+.dndev-control-group[data-variant='default'] {
     --control-border: color-mix(
       in oklab,
       var(--foreground) 70%,
@@ -1768,7 +1816,7 @@ em {
   display: grid;
   gap: var(--gap-sm);
   padding: var(--gap-md);
-  border-radius: var(--radius-none);
+  border-radius: var(--radius-floating);
   border: var(--border-hairline) solid var(--border);
   /* Inverted floating colors: popover-foreground as background, popover as foreground */
   background: color-mix(in oklab, var(--popover-foreground) 95%, transparent);
@@ -1913,7 +1961,7 @@ em {
   width: var(--icon-md);
   height: var(--icon-md);
   border: 2px solid currentColor;
-  border-radius: 50%;
+  border-radius: var(--radius-full);
   border-right-color: transparent;
   animation: spin 1s linear infinite;
 }
@@ -2050,7 +2098,7 @@ em {
   display: flex;
   flex-direction: column;
   padding: 0;
-  border-radius: 0;
+  border-radius: var(--radius-floating);
   min-width: 15ch; /* Character-based: scales with font size, ensures readable width */
   width: -moz-fit-content;
   width: fit-content; /* Stretch to fit children */
@@ -2327,14 +2375,15 @@ em {
   margin-top: var(--gap-md);
 }
 
-/* Tech card */
+/* Tech card - override Card's grid layout for centered content */
 
 .dndev-tech-card {
   height: 100%;
   min-height: 120px;
-  display: flex;
+  display: flex !important; /* Override Card's grid layout */
   align-items: center;
   justify-content: center;
+  align-content: center; /* Override Card's align-content: start */
   transition:
     border-color 0.2s ease,
     box-shadow 0.2s ease;
@@ -2404,7 +2453,7 @@ em {
 }
 
 .dndev-blockquote-content {
-  font-size: 1.125em; /* 1.125x body (18px on 16px base) */
+  font-size: var(--font-size-lg); /* 20px - emphasized text */
   line-height: 1.7; /* Industry standard for readability */
   font-weight: 400;
   color: inherit;
@@ -2438,10 +2487,15 @@ em {
  */
 
 .dndev-blockquote[data-variant='default'] blockquote {
-  padding: var(--gap-md) var(--gap-md) var(--gap-md) var(--gap-lg);
+  padding: var(--gap-md) calc(var(--gap-md) + 4px) var(--gap-md) var(--gap-lg);
   background: var(--muted);
   border-inline-start: 4px solid var(--primary);
-  border-radius: 0 var(--radius-md) var(--radius-md) 0;
+  border-inline-end: none;
+  border-block-start: none;
+  border-block-end: none;
+  border-radius: var(--radius-interactive) var(--radius-surface)
+    var(--radius-surface) var(--radius-interactive);
+  overflow: hidden;
 }
 
 .dndev-blockquote[data-variant='default'] .dndev-blockquote-content {
@@ -2462,7 +2516,7 @@ em {
 .dndev-blockquote[data-variant='editorial'] .dndev-blockquote-content {
   font-family: Georgia, 'Times New Roman', serif;
   font-style: italic;
-  font-size: 1.25em; /* Larger for editorial impact */
+  font-size: var(--font-size-xl); /* 25px - larger for editorial impact */
   color: inherit;
   opacity: 0.95;
 }
@@ -2480,7 +2534,7 @@ em {
 .dndev-blockquote[data-variant='testimonial'] {
   background: var(--card);
   border: 1px solid var(--border);
-  border-radius: var(--radius-lg);
+  border-radius: var(--radius-surface);
   padding: calc(var(--gap-lg) + var(--gap-md)); /* 2.5rem */
   box-shadow:
     0 1px 3px 0 hsl(var(--foreground-hsl) / 0.1),
@@ -2522,11 +2576,11 @@ em {
   }
 
   .dndev-blockquote-content {
-    font-size: 1.0625em; /* Slightly smaller on mobile (17px) */
+    font-size: var(--font-size-base); /* Slightly smaller on mobile */
   }
 
   .dndev-blockquote[data-variant='editorial'] .dndev-blockquote-content {
-    font-size: 1.125em;
+    font-size: var(--font-size-lg);
   }
 
   .dndev-blockquote[data-variant='testimonial'] {
@@ -2556,7 +2610,7 @@ em {
   color: var(--popover-foreground);
   background: var(--popover);
   border: var(--border-hairline) solid var(--border);
-  border-radius: var(--radius-interactive);
+  border-radius: var(--radius-floating);
   box-shadow: var(--shadow-md);
 }
 
@@ -2842,13 +2896,40 @@ em {
 /* packages/components/src/atomic/CallToAction/CallToAction.css */
 
 .dndev-cta {
-  /* Full width gradient */
+  /* Default gradient */
   background: linear-gradient(to right, var(--secondary), var(--background));
   color: var(--foreground);
   /* Padding for background - vertical only, horizontal handled by content */
   padding-block: var(--gap-lg);
 }
 
+/* Tone variants - leverage existing data-tone system */
+
+.dndev-cta[data-tone='base'] {
+  background: linear-gradient(to right, var(--secondary), var(--background));
+}
+
+.dndev-cta[data-tone='muted'] {
+  background: linear-gradient(to right, var(--muted), var(--background));
+}
+
+.dndev-cta[data-tone='accent'] {
+  background: linear-gradient(
+    to right,
+    color-mix(in oklab, var(--accent) 10%, transparent),
+    var(--background)
+  );
+}
+
+.dndev-cta[data-tone='contrast'] {
+  background: linear-gradient(to right, var(--foreground), var(--background));
+  color: var(--background);
+}
+
+.dndev-cta[data-tone='elevated'] {
+  background: linear-gradient(to right, var(--secondary), var(--background));
+}
+
 .dndev-cta-content {
   display: flex;
   flex-direction: column;
@@ -2929,19 +3010,35 @@ em {
 .dndev-card {
   display: grid;
   gap: var(--gap-md);
+  text-align: start;
+  align-content: start;
+}
+
+.dndev-card-header {
+  display: flex;
+  flex-direction: column;
+}
+
+.dndev-card-header > .dndev-stack {
+  min-width: 0;
+}
+
+.dndev-card-header > .dndev-stack > .dndev-card-title {
+  flex: 1;
+  min-width: 0;
 }
 
 .dndev-card-title {
-  font-size: var(--font-size-xl);
-  font-weight: 600;
-  color: inherit; /* Inherit from surface variant */
   margin: 0;
+  min-width: 0;
+  word-wrap: break-word;
 }
 
 .dndev-card-subtitle {
-  font-size: var(--font-size-base);
-  font-weight: 600;
-  color: inherit; /* Inherit from surface variant */
+  margin-top: 0;
+  margin-bottom: 0;
+  min-width: 0;
+  word-wrap: break-word;
 }
 
 /* packages/components/src/atomic/Checkbox/Checkbox.css */
@@ -3334,7 +3431,7 @@ em {
 
 .dndev-command-footer-key {
   padding: 0.125rem 0.375rem;
-  border-radius: calc(var(--radius-md) * 0.5);
+  border-radius: 2px;
   background: var(--muted);
   border: 1px solid var(--border);
   font-family: var(--font-mono);
@@ -3654,56 +3751,34 @@ em {
   display: grid;
   min-width: 0;
   width: 100%;
+  /* Default: use mobile columns */
+  grid-template-columns: repeat(var(--grid-cols-mobile, 1), 1fr);
 }
 
-/* Columns */
+/* Responsive columns via media queries */
 
-.dndev-grid-component[data-cols='1'] {
-  grid-template-columns: repeat(1, minmax(0, 1fr));
-}
-
-.dndev-grid-component[data-cols='2'] {
-  grid-template-columns: repeat(2, minmax(0, 1fr));
-}
-
-.dndev-grid-component[data-cols='3'] {
-  grid-template-columns: repeat(3, minmax(0, 1fr));
-}
+/* Tablet: 768px+ */
 
-.dndev-grid-component[data-cols='4'] {
-  grid-template-columns: repeat(4, minmax(0, 1fr));
-}
-
-.dndev-grid-component[data-cols='5'] {
-  grid-template-columns: repeat(5, minmax(0, 1fr));
-}
-
-.dndev-grid-component[data-cols='6'] {
-  grid-template-columns: repeat(6, minmax(0, 1fr));
+@media (min-width: 768px) {
+  .dndev-grid-component {
+    grid-template-columns: repeat(var(--grid-cols-tablet, 1), 1fr);
+  }
 }
 
-.dndev-grid-component[data-cols='10'] {
-  grid-template-columns: repeat(10, minmax(0, 1fr));
-}
+/* Laptop: 1024px+ (key layout split) */
 
-.dndev-grid-component[data-cols='12'] {
-  grid-template-columns: repeat(12, minmax(0, 1fr));
+@media (min-width: 1024px) {
+  .dndev-grid-component {
+    grid-template-columns: repeat(var(--grid-cols-laptop, 1), 1fr);
+  }
 }
 
-/* Auto-fit/fill columns */
+/* Desktop: 1440px+ */
 
-.dndev-grid-component[data-cols='auto-fit'] {
-  grid-template-columns: repeat(
-    auto-fit,
-    minmax(min(100%, var(--min-col-width, 250px)), 1fr)
-  );
-}
-
-.dndev-grid-component[data-cols='auto-fill'] {
-  grid-template-columns: repeat(
-    auto-fill,
-    minmax(min(100%, var(--min-col-width, 250px)), 1fr)
-  );
+@media (min-width: 1440px) {
+  .dndev-grid-component {
+    grid-template-columns: repeat(var(--grid-cols-desktop, 1), 1fr);
+  }
 }
 
 /* Spacing from CSS variables */
@@ -3849,21 +3924,7 @@ em {
     }
 
 .dndev-hero-subtitle {
-  font-size: var(--font-size-xl);
-}
-
-/* Responsive Content Visibility */
-
-@media (width < 1024px) {
-  .dndev-hero-section .dndev-desktop-only {
-    display: none !important;
-  }
-}
-
-@media (width >= 1024px) {
-  .dndev-hero-section .dndev-mobile-only {
-    display: none !important;
-  }
+  font-size: var(--font-size-lg); /* 20px - muted via component */
 }
 
 /* packages/components/src/atomic/HoverCard/HoverCard.css */
@@ -3882,7 +3943,7 @@ em {
   height: var(--touch-target);
   padding: 0;
   border: 1px solid var(--card-foreground);
-  border-radius: var(--radius-md);
+  border-radius: var(--radius-surface);
   background: transparent;
   display: inline-flex;
   align-items: center;
@@ -4022,7 +4083,7 @@ em {
 
 .dndev-json-viewer-container {
   background-color: var(--muted);
-  border-radius: var(--radius);
+  border-radius: var(--radius-surface);
   padding: 1rem;
   overflow: auto;
   max-height: 600px;
@@ -4079,7 +4140,7 @@ em {
   align-items: flex-start;
   gap: 0.25rem;
   cursor: pointer;
-  border-radius: var(--radius-sm);
+  border-radius: var(--radius-interactive);
   padding-inline-start: 0.25rem;
   padding-inline-end: 0.25rem;
   margin-inline-start: -0.25rem;
@@ -4176,16 +4237,13 @@ em {
 .dndev-list {
   display: flex;
   flex-direction: column;
-  gap: var(--gap-none);
+  gap: var(--gap-sm);
   padding-inline-start: 0; /* Controllable via parent/style prop */
+  margin: 0;
   list-style-position: outside;
-  /* text-align: inherit from parent (removed hardcoded start) */
+  text-align: start; /* Always start-aligned, even when parent is centered */
 }
 
-.dndev-list[data-gap='none'] {
-    gap: var(--gap-none);
-  }
-
 .dndev-list[data-gap='tight'] {
     gap: var(--gap-sm);
   }
@@ -4234,29 +4292,18 @@ em {
       font-size: var(--font-size-base);
     }
 
-/* Default: native list items (no flex) - preserves markers */
+/* Always use flex layout for consistent alignment */
 
 .dndev-list .dndev-list-item {
     font-size: var(--font-size-sm);
-    /* No display: flex by default - allows native markers */
-
-    /* Modern ::marker styling (2026 best practice) */
+    display: flex;
+    align-items: flex-start;
+    gap: var(--gap-sm);
+    list-style: none; /* Remove native marker */
+    margin-block: 0;
+    padding-inline-start: 0;
   }
 
-:is(.dndev-list .dndev-list-item)::marker {
-      color: currentColor;
-    }
-
-/* Only use flex when icon is present */
-
-:is(.dndev-list .dndev-list-item):has(.dndev-list-item-icon) {
-      display: flex;
-      align-items: center; /* Center vertically */
-      gap: var(--gap-sm);
-      list-style: none; /* Remove native marker when using icon */
-      padding-inline-start: 0; /* Reset padding when flex */
-    }
-
 :is(.dndev-list .dndev-list-item) .dndev-list-item-icon {
       display: flex;
       align-items: center;
@@ -4440,7 +4487,7 @@ em {
   grid-row: span 3;
   height: 100%;
   padding: var(--gap-md);
-  border-radius: var(--radius);
+  border-radius: var(--radius-floating);
   background: linear-gradient(
     to bottom,
     color-mix(in oklab, var(--muted) 50%, transparent),
@@ -4464,7 +4511,7 @@ em {
 
 .dndev-nav-menu-item-container {
   padding: var(--gap-md);
-  border-radius: var(--radius);
+  border-radius: var(--radius-floating);
   text-decoration: none;
   outline: none;
 }
@@ -4599,27 +4646,57 @@ em {
 
 /* packages/components/src/atomic/RadioGroup/RadioGroup.css */
 
-.dndev-radio-group {
-  display: grid;
-  gap: var(--gap-sm);
+/* Uses shared .dndev-control-group pattern from patterns.css */
 
-  /* RadioGroup label styling - Stack as="label" now has dndev-text-base */
-}
+/* Root is display: grid - items are direct children */
 
-.dndev-radio-group label {
-    font-size: var(--font-size-base);
-    color: var(--foreground);
-    transition: color var(--dur-fast) var(--ease-in-out);
+/* Grid columns via data-cols attribute */
 
-    /* Label text when radio is checked */
+.dndev-radio-group[data-cols] {
+    width: -moz-fit-content;
+    width: fit-content;
+    margin-inline: auto; /* Self-center in parent */
   }
 
-:is(.dndev-radio-group label):has([data-state='checked']) {
-      color: var(--primary);
-      font-weight: var(--font-weight-medium);
-    }
+.dndev-radio-group[data-cols='2'] {
+    grid-template-columns: repeat(2, auto);
+  }
+
+.dndev-radio-group[data-cols='3'] {
+    grid-template-columns: repeat(3, auto);
+  }
+
+.dndev-radio-group[data-cols='4'] {
+    grid-template-columns: repeat(4, auto);
+  }
+
+.dndev-radio-group[data-cols='5'] {
+    grid-template-columns: repeat(5, auto);
+  }
+
+.dndev-radio-group[data-cols='6'] {
+    grid-template-columns: repeat(6, auto);
+  }
+
+.dndev-radio-group[data-cols='10'] {
+    grid-template-columns: repeat(10, auto);
+  }
+
+.dndev-radio-group[data-cols='12'] {
+    grid-template-columns: repeat(12, auto);
+  }
+
+.dndev-radio-group[data-cols='auto-fit'] {
+    grid-template-columns: repeat(auto-fit, minmax(8rem, 1fr));
+    width: 100%;
+  }
+
+.dndev-radio-group[data-cols='auto-fill'] {
+    grid-template-columns: repeat(auto-fill, minmax(8rem, 1fr));
+    width: 100%;
+  }
 
-/* Variant colors for checked labels */
+/* Variant colors for checked labels - override base pattern */
 
 .dndev-radio-group[data-variant='primary'] label:has([data-state='checked']) {
     color: var(--primary);
@@ -4862,6 +4939,12 @@ em {
 
 /* packages/components/src/atomic/Section/Section.css */
 
+/* Full-width section wrapper for tone backgrounds */
+
+.dndev-section-full-width {
+  width: 100%;
+}
+
 /* Content wrapper: constrained + centered + padded */
 
 .dndev-section-content {
@@ -4881,23 +4964,13 @@ em {
 }
   }
 
-/* Section title: XL, uppercase, accent, tracking */
+/* Section title: uppercase, accent color, letter spacing */
 
 .dndev-section-title {
-  display: block;
-  font-size: var(--font-size-xl);
-  font-weight: var(--font-weight-semibold);
   text-transform: uppercase;
   letter-spacing: 0.2em;
-  color: var(--accent);
-  margin-bottom: var(--gap-lg);
-}
-
-/* Grid container with default gap */
-
-.dndev-section-grid {
-  display: grid;
-  gap: var(--gap-md);
+  color: var(--accent) !important;
+  margin-block-end: var(--gap-md);
 }
 
 .dndev-section-full-width[data-text-align='start'] .dndev-section-content {
@@ -5326,7 +5399,7 @@ em {
   color: var(--foreground);
   background-color: var(--background);
   padding: 0.125rem 0.375rem;
-  border-radius: var(--radius);
+  border-radius: var(--radius-interactive);
   box-shadow: var(--shadow-sm);
   white-space: nowrap;
   pointer-events: none;
@@ -5780,7 +5853,7 @@ em {
   position: relative;
   width: 100%;
   overflow-y: auto;
-  border-radius: var(--radius-lg);
+  border-radius: 0;
   border: 1px solid var(--border);
 }
 
@@ -6078,7 +6151,7 @@ em {
 }
 
 .dndev-text-base {
-  font-weight: 500;
+  font-weight: var(--font-weight-medium);
   line-height: var(--line-height);
   background-color: transparent; /* Text never has background, only color changes */
 }
@@ -6115,28 +6188,36 @@ em {
     color: var(--destructive);
   }
 
+.dndev-text-base[data-variant='code'] {
+    font-family: var(--font-mono);
+    font-size: 0.9em;
+    background: var(--muted);
+    padding: 0.1em 0.4em;
+    border-radius: var(--radius-interactive);
+  }
+
 /* Level overrides */
 
 .dndev-text-base[data-level='h1'] {
     font-size: var(--font-size-3xl);
-    font-weight: 700;
+    font-weight: var(--font-weight-bold);
     letter-spacing: -0.02em;
   }
 
 .dndev-text-base[data-level='h2'] {
-    font-size: var(--font-size-2xl);
-    font-weight: 700;
-    letter-spacing: -0.01em;
+    font-size: var(--font-size-lg);
+    font-weight: var(--font-weight-semibold);
   }
 
 .dndev-text-base[data-level='h3'] {
-    font-size: var(--font-size-xl);
-    font-weight: 600;
+    font-size: var(--font-size-lg);
+    font-weight: var(--font-weight-semibold);
   }
 
 .dndev-text-base[data-level='h4'] {
-    font-size: var(--font-size-lg);
-    font-weight: 600;
+    font-size: var(--font-size-base);
+    font-weight: var(--font-weight-medium);
+    color: var(--muted-foreground);
   }
 
 .dndev-text-base[data-level='body'] {
@@ -6196,7 +6277,7 @@ em {
   flex-shrink: 0;
   padding-inline-start: var(--gap-md);
   padding-inline-end: var(--gap-md);
-  border-radius: var(--radius-md);
+  border-radius: var(--radius-interactive);
   border: 1px solid var(--border);
   font-size: var(--font-size-sm);
 }
@@ -6353,7 +6434,7 @@ em {
   align-items: center;
   gap: 0;
   padding: 0.125rem;
-  border-radius: var(--radius);
+  border-radius: var(--radius-interactive);
   background-color: var(--muted);
   border: var(--border-width) solid var(--border);
 }
@@ -6447,7 +6528,7 @@ em {
   box-shadow: var(--shadow-lg); /* Stronger shadow for visibility */
   padding: 0.375rem 0.5rem; /* 6px 8px - industry standard */
   font-size: var(--font-size-xs); /* 12px */
-  border-radius: 0; /* Square, modern look */
+  border-radius: var(--radius-floating);
   max-width: 12.5rem; /* 200px */
 }
 
@@ -6525,6 +6606,16 @@ em {
   filter: drop-shadow(0 2px 8px rgb(from var(--background) r g b / 0.5));
 }
 
+/* Loading overlay - shown while iframe loads */
+
+.dndev-video-loading-overlay {
+  z-index: 1;
+}
+
+.dndev-video-loading-overlay .dndev-video-play-overlay {
+    background: rgb(from var(--background) r g b / 0.6);
+  }
+
 /* Modal dialog wrapper */
 
 .dndev-video-dialog {
@@ -7066,7 +7157,7 @@ em {
   }
 
 .dndev-section-full-width[data-tone='muted'] {
-    background: color-mix(in oklab, var(--muted) 50%, transparent);
+    background: var(--muted);
   }
 
 .dndev-section-full-width[data-tone='elevated'] {
@@ -7089,7 +7180,7 @@ em {
   }
 
 [data-tone='muted']:not(.dndev-section-full-width) {
-    background: color-mix(in oklab, var(--muted) 50%, transparent);
+    background: var(--muted);
   }
 
 [data-tone='elevated']:not(.dndev-section-full-width) {
@@ -7138,7 +7229,7 @@ code {
   line-height: 1.5;
   white-space: pre-wrap;
   word-break: break-all;
-  border-radius: var(--radius-sm);
+  border-radius: var(--radius-interactive);
 }
 
 /* Code element + variant = semantic + visual (monospace + background) */
@@ -7153,7 +7244,7 @@ code[data-variant='code'] {
   line-height: 1.5;
   white-space: pre-wrap;
   word-break: break-all;
-  border-radius: var(--radius-sm);
+  border-radius: var(--radius-interactive);
 }
 
 /* Heading + code variant = heading size/weight + code background */
@@ -7171,7 +7262,7 @@ h4[data-variant='code'] {
   line-height: 1.5;
   white-space: pre-wrap;
   word-break: break-all;
-  border-radius: var(--radius-sm);
+  border-radius: var(--radius-interactive);
 }
 
 /* ===========================
@@ -7225,6 +7316,7 @@ h4[data-variant='code'] {
 
 .dndev-relative {
   position: relative;
+  min-width: 0; /* Allow flex items to shrink below content size */
 }
 
 .dndev-absolute {
@@ -7409,6 +7501,40 @@ h4[data-variant='code'] {
   border: 0;
 }
 
+/* ===========================
+   PROSE - SEMANTIC TYPOGRAPHY FOR CONTENT PAGES
+   Wrap docs/markdown/article content in .prose for semantic margins
+   Components are unaffected - they own their own spacing
+   =========================== */
+
+.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6 {
+    margin-block: var(--gap-md);
+  }
+
+.prose p {
+    margin-block: var(--gap-md);
+  }
+
+.prose ul,.prose ol {
+    padding-inline-start: var(--gap-lg);
+    margin-block: var(--gap-md);
+  }
+
+.prose li {
+    margin-block: var(--gap-sm);
+    padding-inline-start: var(--gap-sm);
+  }
+
+/* First/last child: remove top/bottom margin for clean container edges */
+
+.prose  > :first-child {
+    margin-block-start: 0;
+  }
+
+.prose  > :last-child {
+    margin-block-end: 0;
+  }
+
 /* ===========================
    SHADOW CONTROL (Universal)
    Works with any element
@@ -7636,7 +7762,7 @@ h4[data-variant='code'] {
      =========================== */
 
   /* Single animation type (fade, slide, or none to disable) - app-wide */
-  --routing-animation: fade;
+  --routing-animation: none;
   --routing-default-duration: var(--dur-normal);
 
   /* Breakpoint-specific durations */
@@ -7716,24 +7842,26 @@ h4[data-variant='code'] {
 
 /* Routing animations - applied to main content area */
 
+/* Default: visible (progressive enhancement - content shows even if JS fails) */
+
 main[role='main'] {
-  opacity: 0;
+  opacity: 1;
 }
 
-/* Fade animation */
+/* Fade animation - keyframes handle opacity 0→1 */
 
 main[role='main'][data-routing-animation='fade'] {
   animation: routeFadeIn var(--routing-default-duration, 300ms) ease-in forwards;
 }
 
-/* Slide animation */
+/* Slide animation - keyframes handle opacity 0→1 */
 
 main[role='main'][data-routing-animation='slide'] {
   animation: routeSlideIn var(--routing-default-duration, 300ms) ease-in
     forwards;
 }
 
-/* No animation */
+/* No animation - already visible by default, explicit for clarity */
 
 main[role='main'][data-routing-animation='none'] {
   animation: none;
@@ -7844,18 +7972,20 @@ main[role='main'][data-routing-animation='none'] {
   display: grid;
   /* ONE DRY grid structure: 3 rows, 2 columns */
   /* Footer starts at sidebar edge (column 2) - when sidebar-width is 0px, footer starts at left edge */
+  /* Footer grows with content wrapping. For pixel-perfect calc() accuracy when footer wraps,
+     implement ResizeObserver to update --footer-height dynamically. */
   grid-template-areas:
     'header header'
     'sidebar main'
     'footer footer';
-  grid-template-rows: var(--header-height) 1fr var(--footer-height);
+  grid-template-rows: var(--header-height) 1fr minmax(var(--footer-height), auto);
   grid-template-columns: var(--sidebar-width) 1fr;
 
   /* Game layout: Grid rows adjust based on breakpoint (footer hidden on tablet/mobile) */
 }
 
 [data-layout='game']:root .dndev-layout {
-    grid-template-rows: var(--header-height) 1fr var(--footer-height);
+    grid-template-rows: var(--header-height) 1fr minmax(var(--footer-height), auto);
   }
 
 /* ===========================
@@ -8142,13 +8272,6 @@ aside.sidebar[role='navigation'] .dndev-interactive-label {
       justify-content: center;
     }
 
-/* Sidebar navigation menu - 48px buttons/icons default */
-
-.dndev-sidebar-nav-menu[data-vertical='true'] .dndev-interactive[data-role='menu-item'],.dndev-sidebar-nav-menu[data-vertical='true'] .dndev-interactive[data-role='nav-trigger'] {
-    width: var(--touch-target);
-    height: var(--touch-target);
-  }
-
 /* Collapsed sidebar: hide labels, center icons */
 
 /* Hide all auto-display labels */
@@ -8214,7 +8337,7 @@ footer[role='contentinfo'] {
   grid-area: footer;
   box-sizing: border-box;
   grid-column: 1 / -1;
-  height: var(--footer-height);
+  min-height: var(--footer-height);
   z-index: var(--z-footer);
 
   /* Theme-aware styling - 100% controlled by theme system */
@@ -8262,7 +8385,7 @@ footer[role='contentinfo'] > * {
 
 footer[role='contentinfo'] .footer-copyright {
   color: var(--muted-foreground);
-  font-size: var(--font-size-xs);
+  font-size: var(--font-size-sm);
 }
 
 footer[role='contentinfo'] a:not(.dndev-interactive) {
@@ -8270,7 +8393,7 @@ footer[role='contentinfo'] a:not(.dndev-interactive) {
   text-decoration: underline;
   text-underline-offset: 2px;
   color: var(--muted-foreground);
-  font-size: var(--font-size-xs);
+  font-size: var(--font-size-sm);
   background: transparent;
 }
 
@@ -8669,6 +8792,7 @@ footer[role='contentinfo'] a:not(.dndev-interactive):hover {
 .dndev-container[data-centered='false'] {
     margin-inline-start: 0;
     margin-inline-end: 0;
+    justify-content: flex-start;
   }
 
 /* Full width - no constraints */