@donotdev/components 0.0.2 → 0.0.4

package/dist/styles/index.css

@@ -10,9 +10,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
@@ -277,28 +278,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 */
 }
 
@@ -527,52 +548,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 ul,
-article ul {
-  list-style-type: disc;
-}
+/* Main element - no focus outline (programmatic focus for keyboard nav) */
 
-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,
@@ -581,49 +569,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 */
@@ -670,7 +680,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);
@@ -932,15 +942,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'] {
@@ -1173,7 +1189,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'] {
@@ -1635,6 +1651,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
@@ -1642,37 +1690,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%,
@@ -1760,7 +1808,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);
@@ -1905,7 +1953,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;
 }
@@ -2042,7 +2090,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 */
@@ -2319,14 +2367,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;
@@ -2396,7 +2445,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;
@@ -2430,10 +2479,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 {
@@ -2454,7 +2508,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;
 }
@@ -2472,7 +2526,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),
@@ -2514,11 +2568,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'] {
@@ -2548,7 +2602,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);
 }
 
@@ -2834,13 +2888,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;
@@ -2921,19 +3002,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 */
@@ -3326,7 +3423,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);
@@ -3646,56 +3743,34 @@ em {
   display: grid;
   min-width: 0;
   width: 100%;
+  /* Default: use mobile columns */
+  grid-template-columns: repeat(var(--grid-cols-mobile, 1), 1fr);
 }
 
-/* Columns */
-
-.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));
-}
+/* Responsive columns via media queries */
 
-.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));
-}
+/* Tablet: 768px+ */
 
-.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 */
-
-.dndev-grid-component[data-cols='auto-fit'] {
-  grid-template-columns: repeat(
-    auto-fit,
-    minmax(min(100%, var(--min-col-width, 250px)), 1fr)
-  );
-}
+/* Desktop: 1440px+ */
 
-.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 */
@@ -3841,21 +3916,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 */
@@ -3874,7 +3935,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;
@@ -4014,7 +4075,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;
@@ -4071,7 +4132,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;
@@ -4168,16 +4229,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);
   }
@@ -4226,29 +4284,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;
@@ -4432,7 +4479,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),
@@ -4456,7 +4503,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;
 }
@@ -4591,27 +4638,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);
@@ -4854,6 +4931,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 {
@@ -4873,23 +4956,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 {
@@ -5318,7 +5391,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;
@@ -5772,7 +5845,7 @@ em {
   position: relative;
   width: 100%;
   overflow-y: auto;
-  border-radius: var(--radius-lg);
+  border-radius: 0;
   border: 1px solid var(--border);
 }
 
@@ -6070,7 +6143,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 */
 }
@@ -6107,28 +6180,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'] {
@@ -6188,7 +6269,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);
 }
@@ -6345,7 +6426,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);
 }
@@ -6439,7 +6520,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 */
 }
 
@@ -6517,6 +6598,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 {
@@ -7058,7 +7149,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'] {
@@ -7081,7 +7172,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) {
@@ -7130,7 +7221,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) */
@@ -7145,7 +7236,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 */
@@ -7163,7 +7254,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);
 }
 
 /* ===========================
@@ -7217,6 +7308,7 @@ h4[data-variant='code'] {
 
 .dndev-relative {
   position: relative;
+  min-width: 0; /* Allow flex items to shrink below content size */
 }
 
 .dndev-absolute {
@@ -7401,6 +7493,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