cursedbelt 3.0.2 → 4.0.0

package/src/styles-areas/workbench.css

@@ -0,0 +1,543 @@
+/*
+ * cursedbelt — the `workbench` area. GENERATED BUILD ARTIFACT. Never hand-edit.
+ *
+ * the resizable/split/panelled work surfaces and the drag-and-drop affordances.
+ *
+ * Every Tailwind utility the modules in this area's import closure use, MINUS the
+ * ones `styles-areas/core.css` already ships. 🔴 Import ALL of these, in
+ * this order — this file alone is incomplete:
+ *
+ *   @import "tailwindcss";
+ *   @import "cursedbelt/styles-static.css";
+ *   @import "cursedbelt/styles-areas/core.css";
+ *   @import "cursedbelt/styles-areas/workbench.css";
+ *   @import "cursedbelt/theme.css";
+ *
+ * An app that imports every area gets exactly what `cursedbelt/styles-utilities.css`
+ * emits — proved rule by rule in src/stylesAreas.spec.ts, which is also what fails
+ * when this file is stale. 770 candidate(s) scanned.
+ *
+ * Written by scripts/generateAreaStyles.ts (`bun run styles:areas`), which
+ * `bun run build` runs. The map of what is in which area, and why the areas are
+ * import closures rather than a hand-written list, is scripts/styleAreas.ts.
+ */
+/*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
+@layer properties;
+@layer theme, base, components, utilities;
+@layer theme {
+  :root, :host {
+    --spacing: 0.25rem;
+    --text-xl: 1.25rem;
+    --text-xl--line-height: calc(1.75 / 1.25);
+    --default-transition-duration: 150ms;
+    --default-transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
+  }
+}
+@layer utilities {
+  .right-4 {
+    right: calc(var(--spacing) * 4);
+  }
+  .bottom-6 {
+    bottom: calc(var(--spacing) * 6);
+  }
+  .left-0 {
+    left: 0px;
+  }
+  .-my-0\.5 {
+    margin-block: calc(var(--spacing) * -0.5);
+  }
+  .h-3\.5 {
+    height: calc(var(--spacing) * 3.5);
+  }
+  .h-40 {
+    height: calc(var(--spacing) * 40);
+  }
+  .h-\[420px\] {
+    height: 420px;
+  }
+  .max-h-\[40dvh\] {
+    max-height: 40dvh;
+  }
+  .max-h-\[65dvh\] {
+    max-height: 65dvh;
+  }
+  .max-h-\[85dvh\] {
+    max-height: 85dvh;
+  }
+  .max-h-full {
+    max-height: 100%;
+  }
+  .min-h-20 {
+    min-height: calc(var(--spacing) * 20);
+  }
+  .min-h-\[2\.25rem\] {
+    min-height: 2.25rem;
+  }
+  .min-h-\[44px\] {
+    min-height: 44px;
+  }
+  .min-h-dvh {
+    min-height: 100dvh;
+  }
+  .min-h-full {
+    min-height: 100%;
+  }
+  .w-1\/2 {
+    width: calc(1 / 2 * 100%);
+  }
+  .w-2\/3 {
+    width: calc(2 / 3 * 100%);
+  }
+  .w-3\.5 {
+    width: calc(var(--spacing) * 3.5);
+  }
+  .w-\[352px\] {
+    width: 352px;
+  }
+  .min-w-40 {
+    min-width: calc(var(--spacing) * 40);
+  }
+  .min-w-\[5rem\] {
+    min-width: 5rem;
+  }
+  .shrink-\[2\] {
+    flex-shrink: 2;
+  }
+  .translate-y-0 {
+    --tw-translate-y: 0px;
+    translate: var(--tw-translate-x) var(--tw-translate-y);
+  }
+  .translate-y-2 {
+    --tw-translate-y: calc(var(--spacing) * 2);
+    translate: var(--tw-translate-x) var(--tw-translate-y);
+  }
+  .scale-\[1\.01\] {
+    scale: 1.01;
+  }
+  .rotate-90 {
+    rotate: 90deg;
+  }
+  .cursor-not-allowed {
+    cursor: not-allowed;
+  }
+  .resize-none {
+    resize: none;
+  }
+  .\[scrollbar-width\:none\] {
+    scrollbar-width: none;
+  }
+  .flex-row {
+    flex-direction: row;
+  }
+  .self-center {
+    align-self: center;
+  }
+  .self-stretch {
+    align-self: stretch;
+  }
+  .rounded-\[2\.5rem\] {
+    border-radius: 2.5rem;
+  }
+  .rounded-t-xl {
+    border-top-left-radius: 1.5rem;
+    border-top-right-radius: 1.5rem;
+  }
+  .rounded-l-xl {
+    border-top-left-radius: 1.5rem;
+    border-bottom-left-radius: 1.5rem;
+  }
+  .rounded-r-xl {
+    border-top-right-radius: 1.5rem;
+    border-bottom-right-radius: 1.5rem;
+  }
+  .border-0 {
+    border-style: var(--tw-border-style);
+    border-width: 0px;
+  }
+  .border-2 {
+    border-style: var(--tw-border-style);
+    border-width: 2px;
+  }
+  .border-8 {
+    border-style: var(--tw-border-style);
+    border-width: 8px;
+  }
+  .border-r {
+    border-right-style: var(--tw-border-style);
+    border-right-width: 1px;
+  }
+  .border-l {
+    border-left-style: var(--tw-border-style);
+    border-left-width: 1px;
+  }
+  .border-dashed {
+    --tw-border-style: dashed;
+    border-style: dashed;
+  }
+  .border-solid {
+    --tw-border-style: solid;
+    border-style: solid;
+  }
+  .border-accent {
+    border-color: var(--accent);
+  }
+  .border-accent-solid {
+    border-color: var(--accent-solid);
+  }
+  .border-accent\/70 {
+    border-color: var(--accent);
+    @supports (color: color-mix(in lab, red, red)) {
+      border-color: color-mix(in oklab, var(--accent) 70%, transparent);
+    }
+  }
+  .border-border-strong\/60 {
+    border-color: var(--border-strong);
+    @supports (color: color-mix(in lab, red, red)) {
+      border-color: color-mix(in oklab, var(--border-strong) 60%, transparent);
+    }
+  }
+  .bg-accent\/8 {
+    background-color: var(--accent);
+    @supports (color: color-mix(in lab, red, red)) {
+      background-color: color-mix(in oklab, var(--accent) 8%, transparent);
+    }
+  }
+  .bg-accent\/15 {
+    background-color: var(--accent);
+    @supports (color: color-mix(in lab, red, red)) {
+      background-color: color-mix(in oklab, var(--accent) 15%, transparent);
+    }
+  }
+  .bg-accent\/40 {
+    background-color: var(--accent);
+    @supports (color: color-mix(in lab, red, red)) {
+      background-color: color-mix(in oklab, var(--accent) 40%, transparent);
+    }
+  }
+  .bg-border-strong {
+    background-color: var(--border-strong);
+  }
+  .bg-card-overlay\/85 {
+    background-color: var(--card-overlay);
+    @supports (color: color-mix(in lab, red, red)) {
+      background-color: color-mix(in oklab, var(--card-overlay) 85%, transparent);
+    }
+  }
+  .bg-muted\/40 {
+    background-color: var(--muted);
+    @supports (color: color-mix(in lab, red, red)) {
+      background-color: color-mix(in oklab, var(--muted) 40%, transparent);
+    }
+  }
+  .bg-muted\/60 {
+    background-color: var(--muted);
+    @supports (color: color-mix(in lab, red, red)) {
+      background-color: color-mix(in oklab, var(--muted) 60%, transparent);
+    }
+  }
+  .bg-success\/8 {
+    background-color: var(--success);
+    @supports (color: color-mix(in lab, red, red)) {
+      background-color: color-mix(in oklab, var(--success) 8%, transparent);
+    }
+  }
+  .pb-0\.5 {
+    padding-bottom: calc(var(--spacing) * 0.5);
+  }
+  .pb-\[max\(env\(safe-area-inset-bottom\,0px\)\,0\.5rem\)\] {
+    padding-bottom: max(env(safe-area-inset-bottom,0px), 0.5rem);
+  }
+  .pl-1 {
+    padding-left: var(--spacing);
+  }
+  .pl-3 {
+    padding-left: calc(var(--spacing) * 3);
+  }
+  .text-xl {
+    font-size: var(--text-xl);
+    line-height: var(--tw-leading, var(--text-xl--line-height));
+  }
+  .break-words {
+    overflow-wrap: break-word;
+  }
+  .text-muted-foreground\/60 {
+    color: var(--muted-foreground);
+    @supports (color: color-mix(in lab, red, red)) {
+      color: color-mix(in oklab, var(--muted-foreground) 60%, transparent);
+    }
+  }
+  .text-tone-amber-ink {
+    color: var(--tone-amber-ink);
+  }
+  .text-tone-cyan-ink {
+    color: var(--tone-cyan-ink);
+  }
+  .text-tone-emerald-ink {
+    color: var(--tone-emerald-ink);
+  }
+  .text-tone-orange-ink {
+    color: var(--tone-orange-ink);
+  }
+  .text-tone-purple-ink {
+    color: var(--tone-purple-ink);
+  }
+  .text-tone-rose-ink {
+    color: var(--tone-rose-ink);
+  }
+  .text-tone-sky-ink {
+    color: var(--tone-sky-ink);
+  }
+  .text-tone-slate-ink {
+    color: var(--tone-slate-ink);
+  }
+  .italic {
+    font-style: italic;
+  }
+  .opacity-100 {
+    opacity: 100%;
+  }
+  .ring-1 {
+    --tw-ring-shadow: var(--tw-ring-inset,) 0 0 0 calc(1px + var(--tw-ring-offset-width)) var(--tw-ring-color, currentcolor);
+    box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
+  }
+  .ring-4 {
+    --tw-ring-shadow: var(--tw-ring-inset,) 0 0 0 calc(4px + var(--tw-ring-offset-width)) var(--tw-ring-color, currentcolor);
+    box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
+  }
+  .ring-accent\/20 {
+    --tw-ring-color: var(--accent);
+    @supports (color: color-mix(in lab, red, red)) {
+      --tw-ring-color: color-mix(in oklab, var(--accent) 20%, transparent);
+    }
+  }
+  .ring-accent\/30 {
+    --tw-ring-color: var(--accent);
+    @supports (color: color-mix(in lab, red, red)) {
+      --tw-ring-color: color-mix(in oklab, var(--accent) 30%, transparent);
+    }
+  }
+  .ring-accent\/40 {
+    --tw-ring-color: var(--accent);
+    @supports (color: color-mix(in lab, red, red)) {
+      --tw-ring-color: color-mix(in oklab, var(--accent) 40%, transparent);
+    }
+  }
+  .ring-border {
+    --tw-ring-color: var(--border);
+  }
+  .ring-ring {
+    --tw-ring-color: var(--ring);
+  }
+  .transition-\[opacity\,transform\] {
+    transition-property: opacity,transform;
+    transition-timing-function: var(--tw-ease, var(--default-transition-timing-function));
+    transition-duration: var(--tw-duration, var(--default-transition-duration));
+  }
+  .duration-150 {
+    --tw-duration: 150ms;
+    transition-duration: 150ms;
+  }
+  .ring-inset {
+    --tw-ring-inset: inset;
+  }
+  .peer-focus\:rounded-lg:is(:where(.peer):focus ~ *) {
+    border-radius: 1rem;
+  }
+  .peer-focus\:ring-2:is(:where(.peer):focus ~ *) {
+    --tw-ring-shadow: var(--tw-ring-inset,) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color, currentcolor);
+    box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
+  }
+  .peer-focus\:ring-field-ring\/40:is(:where(.peer):focus ~ *) {
+    --tw-ring-color: var(--field-ring);
+    @supports (color: color-mix(in lab, red, red)) {
+      --tw-ring-color: color-mix(in oklab, var(--field-ring) 40%, transparent);
+    }
+  }
+  .peer-focus\:outline-none:is(:where(.peer):focus ~ *) {
+    --tw-outline-style: none;
+    outline-style: none;
+  }
+  @media (hover: hover) {
+    .hover\:border-border-strong:hover {
+      border-color: var(--border-strong);
+    }
+    .hover\:border-field-ring:hover {
+      border-color: var(--field-ring);
+    }
+    .hover\:bg-card-overlay:hover {
+      background-color: var(--card-overlay);
+    }
+    .hover\:bg-muted-foreground\/10:hover {
+      background-color: var(--muted-foreground);
+    }
+    @supports (color: color-mix(in lab, red, red)) {
+      .hover\:bg-muted-foreground\/10:hover {
+        background-color: color-mix(in oklab, var(--muted-foreground) 10%, transparent);
+      }
+    }
+    .hover\:bg-muted\/80:hover {
+      background-color: var(--muted);
+    }
+    @supports (color: color-mix(in lab, red, red)) {
+      .hover\:bg-muted\/80:hover {
+        background-color: color-mix(in oklab, var(--muted) 80%, transparent);
+      }
+    }
+    .hover\:shadow-popover:hover {
+      --tw-shadow: var(--shadow-popover);
+      box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
+    }
+  }
+  .data-\[state\=closed\]\:slide-out-to-bottom[data-state="closed"] {
+    --tw-exit-translate-y: 100%;
+  }
+  .data-\[state\=closed\]\:slide-out-to-left[data-state="closed"] {
+    --tw-exit-translate-x: -100%;
+  }
+  .data-\[state\=closed\]\:slide-out-to-right[data-state="closed"] {
+    --tw-exit-translate-x: 100%;
+  }
+  .data-\[state\=open\]\:slide-in-from-bottom[data-state="open"] {
+    --tw-enter-translate-y: 100%;
+  }
+  .data-\[state\=open\]\:slide-in-from-left[data-state="open"] {
+    --tw-enter-translate-x: -100%;
+  }
+  .data-\[state\=open\]\:slide-in-from-right[data-state="open"] {
+    --tw-enter-translate-x: 100%;
+  }
+  @media (width >= 40rem) {
+    .sm\:w-56 {
+      width: calc(var(--spacing) * 56);
+    }
+  }
+  @media (pointer: coarse) {
+    .pointer-coarse\:h-12 {
+      height: calc(var(--spacing) * 12);
+    }
+    .pointer-coarse\:w-12 {
+      width: calc(var(--spacing) * 12);
+    }
+  }
+  .\[\&_svg\]\:size-3\.5 svg {
+    width: calc(var(--spacing) * 3.5);
+    height: calc(var(--spacing) * 3.5);
+  }
+  .\[\&\:\:-webkit-scrollbar\]\:hidden::-webkit-scrollbar {
+    display: none;
+  }
+}
+@property --tw-translate-x {
+  syntax: "*";
+  inherits: false;
+  initial-value: 0;
+}
+@property --tw-translate-y {
+  syntax: "*";
+  inherits: false;
+  initial-value: 0;
+}
+@property --tw-translate-z {
+  syntax: "*";
+  inherits: false;
+  initial-value: 0;
+}
+@property --tw-border-style {
+  syntax: "*";
+  inherits: false;
+  initial-value: solid;
+}
+@property --tw-shadow {
+  syntax: "*";
+  inherits: false;
+  initial-value: 0 0 #0000;
+}
+@property --tw-shadow-color {
+  syntax: "*";
+  inherits: false;
+}
+@property --tw-shadow-alpha {
+  syntax: "<percentage>";
+  inherits: false;
+  initial-value: 100%;
+}
+@property --tw-inset-shadow {
+  syntax: "*";
+  inherits: false;
+  initial-value: 0 0 #0000;
+}
+@property --tw-inset-shadow-color {
+  syntax: "*";
+  inherits: false;
+}
+@property --tw-inset-shadow-alpha {
+  syntax: "<percentage>";
+  inherits: false;
+  initial-value: 100%;
+}
+@property --tw-ring-color {
+  syntax: "*";
+  inherits: false;
+}
+@property --tw-ring-shadow {
+  syntax: "*";
+  inherits: false;
+  initial-value: 0 0 #0000;
+}
+@property --tw-inset-ring-color {
+  syntax: "*";
+  inherits: false;
+}
+@property --tw-inset-ring-shadow {
+  syntax: "*";
+  inherits: false;
+  initial-value: 0 0 #0000;
+}
+@property --tw-ring-inset {
+  syntax: "*";
+  inherits: false;
+}
+@property --tw-ring-offset-width {
+  syntax: "<length>";
+  inherits: false;
+  initial-value: 0px;
+}
+@property --tw-ring-offset-color {
+  syntax: "*";
+  inherits: false;
+  initial-value: #fff;
+}
+@property --tw-ring-offset-shadow {
+  syntax: "*";
+  inherits: false;
+  initial-value: 0 0 #0000;
+}
+@property --tw-duration {
+  syntax: "*";
+  inherits: false;
+}
+@layer properties {
+  @supports ((-webkit-hyphens: none) and (not (margin-trim: inline))) or ((-moz-orient: inline) and (not (color:rgb(from red r g b)))) {
+    *, ::before, ::after, ::backdrop {
+      --tw-translate-x: 0;
+      --tw-translate-y: 0;
+      --tw-translate-z: 0;
+      --tw-border-style: solid;
+      --tw-shadow: 0 0 #0000;
+      --tw-shadow-color: initial;
+      --tw-shadow-alpha: 100%;
+      --tw-inset-shadow: 0 0 #0000;
+      --tw-inset-shadow-color: initial;
+      --tw-inset-shadow-alpha: 100%;
+      --tw-ring-color: initial;
+      --tw-ring-shadow: 0 0 #0000;
+      --tw-inset-ring-color: initial;
+      --tw-inset-ring-shadow: 0 0 #0000;
+      --tw-ring-inset: initial;
+      --tw-ring-offset-width: 0px;
+      --tw-ring-offset-color: #fff;
+      --tw-ring-offset-shadow: 0 0 #0000;
+      --tw-duration: initial;
+    }
+  }
+}

package/src/styles-areas/workbook-viewer.css

@@ -0,0 +1,44 @@
+/*
+ * cursedbelt — the `workbook-viewer` area. GENERATED BUILD ARTIFACT. Never hand-edit.
+ *
+ * the lazy XLSX viewer (an optional peer already).
+ *
+ * Every Tailwind utility the modules in this area's import closure use, MINUS the
+ * ones `styles-areas/core.css` already ships. 🔴 Import ALL of these, in
+ * this order — this file alone is incomplete:
+ *
+ *   @import "tailwindcss";
+ *   @import "cursedbelt/styles-static.css";
+ *   @import "cursedbelt/styles-areas/core.css";
+ *   @import "cursedbelt/styles-areas/workbook-viewer.css";
+ *   @import "cursedbelt/theme.css";
+ *
+ * An app that imports every area gets exactly what `cursedbelt/styles-utilities.css`
+ * emits — proved rule by rule in src/stylesAreas.spec.ts, which is also what fails
+ * when this file is stale. 247 candidate(s) scanned.
+ *
+ * Written by scripts/generateAreaStyles.ts (`bun run styles:areas`), which
+ * `bun run build` runs. The map of what is in which area, and why the areas are
+ * import closures rather than a hand-written list, is scripts/styleAreas.ts.
+ */
+/*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
+@layer theme, base, components, utilities;
+@layer theme {
+  :root, :host {
+    --font-sans: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', 'Noto Sans', Arial,
+    sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji';
+    --spacing: 0.25rem;
+    --text-sm: 0.875rem;
+  }
+}
+@layer utilities {
+  .collapse {
+    visibility: collapse;
+  }
+  .w-48 {
+    width: calc(var(--spacing) * 48);
+  }
+  .min-w-16 {
+    min-width: calc(var(--spacing) * 16);
+  }
+}

package/src/styles-static.css

@@ -6,29 +6,32 @@
  * This `@source` makes Tailwind v4 scan cursedbelt's source files so the utility
  * classes used by its components are generated in the app's stylesheet.
  *
- * ── Two ways in, and which one an app wants ──────────────────────────────────
+ * ── Three ways in, and which one an app wants ────────────────────────────────
  * `@source "."` is the expensive half: it points Tailwind's JIT at cursedbelt's
  * ENTIRE source tree, so the app emits the union of the whole design system
  * whether it renders three components or eighty, and its own build walks 827
  * files it does not own. Everything else in this file is CSS the components
  * genuinely need and no app can do without.
  *
- * A CSS `@import` takes the whole file, so the split is two more subpaths:
+ * A CSS `@import` takes the whole file, so the split is more subpaths:
  *
- *   cursedbelt/styles.css            this file — the real CSS + the `@source` scan
- *   cursedbelt/styles-static.css     the same file MINUS the `@source` line
- *   cursedbelt/styles-utilities.css  the utilities that `@source` line would have
- *                                    produced, precompiled at cursedbelt's build
+ *   cursedbelt/styles.css              this file — the real CSS + the `@source` scan
+ *   cursedbelt/styles-static.css       the same file MINUS the `@source` line
+ *   cursedbelt/styles-utilities.css    the utilities that `@source` line would have
+ *                                      produced, precompiled at cursedbelt's build
+ *   cursedbelt/styles-areas/<area>.css the same utilities, split by component family
  *
- * The second two are a PAIR and neither is usable alone — `styles-static.css` on
- * its own gets the tooltip pointer-events fix, the Progress keyframes, the
- * lightbox bridge, the ambient/glass layer and `tw-animate-css`, and emits none
- * of cursedbelt's utility classes, i.e. an unstyled app:
+ * `styles-static.css` is never usable alone — on its own it gets the tooltip
+ * pointer-events fix, the Progress keyframes, the lightbox bridge, the
+ * ambient/glass layer and `tw-animate-css`, and emits none of cursedbelt's
+ * utility classes, i.e. an unstyled app. It pairs with EITHER of the other two:
  *
- *   @import "tailwindcss";
- *   @import "cursedbelt/styles-static.css";
- *   @import "cursedbelt/styles-utilities.css";
- *   @import "cursedbelt/theme.css";
+ *   @import "tailwindcss";                        @import "tailwindcss";
+ *   @import "cursedbelt/styles-static.css";       @import "cursedbelt/styles-static.css";
+ *   @import "cursedbelt/styles-utilities.css";    @import "cursedbelt/styles-areas/core.css";
+ *   @import "cursedbelt/theme.css";               @import "cursedbelt/styles-areas/data-table.css";
+ *                                                 @import "cursedbelt/theme.css";
+ *      the whole design system                       what this app renders
  *
  * 🔴 Do NOT hand-list cursedbelt's component files to get the utilities back.
  * Tailwind v4 resolves every `@source` to a DIRECTORY and scans it recursively —
@@ -38,22 +41,30 @@
  * into this package's source tree is also a `file:` dependency wearing a
  * stylesheet's clothes, and it buys nothing: it is the thing the previous
  * generation's 29-line-per-app arrangement is remembered for, and those 29 lines
- * were never file-level scoping either.
+ * were never file-level scoping either. Three apps hand-maintained such a list
+ * and one of them ran to 173 lines; all three were deleted, because every one of
+ * them was a directory list wearing a costume.
  *
- * The pair is not SMALLER than this file — measured, both routes emit the same
- * rules within 54 bytes. What it buys is a build that scans nothing of another
- * package's source tree, and a `styles-static.css` that finally has a correct
- * use. The measurements, and what would actually shrink a consumer, are in the
- * header of `scripts/generateUtilityStyles.ts`.
+ * `styles-utilities.css` is not SMALLER than this file — measured, both routes
+ * emit the same rules within 54 bytes; the union is the union however it is
+ * assembled. What it buys is a build that scans nothing of another package's
+ * source tree. 🔴 What makes a consumer smaller is the AREAS, and only the
+ * package could build them: Tailwind cannot aim a `@source` at anything finer
+ * than a directory, but `@tailwindcss/oxide` can be handed a FILE LIST, which is
+ * what `scripts/generateAreaStyles.ts` does. Measured on the fixture consumer
+ * `demo/fixtures/lean-app`, the area route emits 30% less CSS than the union, and
+ * `src/fixtureAppCss.spec.ts` is the ratchet that stops it climbing back. The
+ * area map, and a sentence on what each area is for, is `scripts/styleAreas.ts`.
  *
  * 🔴 This header is in BOTH of the first two files, because one is generated from
  * the other and a test holds them byte-identical apart from the `@source` line.
  * Always edit `src/styles.css`; never `src/styles-static.css`, which
  * `scripts/generateStaticStyles.ts` rewrites on every `bun run build` and
  * `src/stylesStaticMatches.spec.ts` fails on when it is stale. Editing this file
- * invalidates `src/styles-utilities.css` too — it is compiled against the static
- * variant, `scripts/generateUtilityStyles.ts` rewrites it in the same build step,
- * and `src/stylesUtilitiesMatches.spec.ts` is what fails when it is stale.
+ * invalidates `src/styles-utilities.css` and every `src/styles-areas/*.css` too —
+ * all of them are compiled against the static variant, `bun run styles` rewrites
+ * them in the same build step, and `src/stylesUtilitiesMatches.spec.ts` /
+ * `src/stylesAreas.spec.ts` are what fail when they are stale.
  */
 
 /* Animation utilities (animate-in/out, fade/zoom/slide-in-from-*) consumed by the