cursedbelt 1.0.0 → 2.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cursedbelt",
-	"version": "1.0.0",
+	"version": "2.3.0",
 	"license": "ISC",
 	"type": "module",
 	"description": "Shared Bun + React framework",
@@ -25,14 +25,18 @@
 	},
 	"scripts": {
 		"typecheck": "tsc --noEmit && tsc --noEmit --project tsconfig.server.json && tsc --noEmit --project tsconfig.specs.json",
-		"demo:check": "bun run scripts/demoCheck.ts",
+		"demo:check": "tsc --noEmit --project demo/tsconfig.json",
+		"demo:paths": "bun run demo/generatePaths.ts --write",
 		"guardrails:report": "bun run scripts/guardrailsEnforce.ts no-raw-action-button,no-raw-overflow,no-raw-inputs,no-hardcoded-colors,no-raw-modal-footer,no-unguarded-editing-modal,control-height-tokens,no-raw-zindex,no-raw-data-table,no-tailwind-palette,no-raw-title-attr,micro-typography-floor,choice-needs-empty-state,no-select-as-action-menu,no-native-dialog,no-fast-tooltip --scope cursedbelt src/react src/styles.css",
 		"format": "biome format --write .",
+		"styles:static": "bun run scripts/generateStaticStyles.ts",
 		"test": "NODE_ENV=development bun test src",
 		"test:pg": "bun run scripts/testPg.ts",
-		"demo": "cd demo && bun run dev",
+		"demo": "vite --config demo/vite.config.ts",
+		"demo:build": "vite build --config demo/vite.config.ts",
+		"demo:serve": "bun run demo:build && vite preview --config demo/vite.config.ts",
 		"prebuild": "bun run verify:gate",
-		"build": "rm -rf dist.next dist.prev && tsc --project tsconfig.build.json --outDir dist.next && tsc --project tsconfig.build.server.json --outDir dist.next && CURSEDBELT_DIST_DIR=dist.next bun run scripts/copyDistAssets.ts && { [ -d dist ] && mv dist dist.prev || true; } && mv dist.next dist && rm -rf dist.prev",
+		"build": "rm -rf dist.next dist.prev && bun run scripts/generateStaticStyles.ts && tsc --project tsconfig.build.json --outDir dist.next && tsc --project tsconfig.build.server.json --outDir dist.next && CURSEDBELT_DIST_DIR=dist.next bun run scripts/copyDistAssets.ts && { [ -d dist ] && mv dist dist.prev || true; } && mv dist.next dist && rm -rf dist.prev",
 		"e2e": "playwright test --config e2e/playwright.config.ts",
 		"e2e:filter-rail": "playwright test --config e2e/playwright.config.ts filter-rail.spec.ts",
 		"e2e:table-layout": "playwright test --config e2e/playwright.config.ts table-layout.spec.ts",
@@ -41,7 +45,8 @@
 		"verify:gate": "bun run src/verify/runtime/bin/ccVerify.ts --corpus",
 		"promote": "bun run src/verify/promotion/bin/ccPromote.ts",
 		"done:serial": "bun run verify:gate && bun run typecheck && bun run lint && bun run test && bun run build",
-		"verify": "bun run typecheck && bun run build && bun run test",
+		"paths": "bun ../../tools/check-paths.ts .",
+		"verify": "bun run paths && bun run typecheck && bun run demo:check && bun run build && bun run test && bun run e2e",
 		"prepublishOnly": "bun run verify"
 	},
 	"exports": {
@@ -57,12 +62,6 @@
 			"source": "./src/core/sharing/index.ts",
 			"import": "./dist/core/sharing/index.js"
 		},
-		"./duplicates": {
-			"types": "./dist/core/duplicates/index.d.ts",
-			"bun": "./src/core/duplicates/index.ts",
-			"source": "./src/core/duplicates/index.ts",
-			"import": "./dist/core/duplicates/index.js"
-		},
 		"./folder-tree": {
 			"types": "./dist/core/folder-tree/index.d.ts",
 			"bun": "./src/core/folder-tree/index.ts",
@@ -87,12 +86,6 @@
 			"source": "./src/verify/index.ts",
 			"import": "./dist/verify/index.js"
 		},
-		"./verify/runtime": {
-			"types": "./dist/verify/runtime/index.d.ts",
-			"bun": "./src/verify/runtime/index.ts",
-			"source": "./src/verify/runtime/index.ts",
-			"import": "./dist/verify/runtime/index.js"
-		},
 		"./guardrails": {
 			"types": "./scripts/guardrailsEnforce.ts",
 			"bun": "./scripts/guardrailsEnforce.ts",
@@ -111,12 +104,6 @@
 			"source": "./src/studio/index.ts",
 			"import": "./dist/studio/index.js"
 		},
-		"./tokens": {
-			"types": "./dist/core/tokens/registry.d.ts",
-			"bun": "./src/core/tokens/registry.ts",
-			"source": "./src/core/tokens/registry.ts",
-			"import": "./dist/core/tokens/registry.js"
-		},
 		"./master-lock": {
 			"types": "./dist/core/master-lock/index.d.ts",
 			"bun": "./src/core/master-lock/index.ts",
@@ -183,12 +170,6 @@
 			"source": "./src/react/components/SelectField.tsx",
 			"import": "./dist/react/components/SelectField.js"
 		},
-		"./react/multi-select-field": {
-			"types": "./dist/react/components/MultiSelectField.d.ts",
-			"bun": "./src/react/components/MultiSelectField.tsx",
-			"source": "./src/react/components/MultiSelectField.tsx",
-			"import": "./dist/react/components/MultiSelectField.js"
-		},
 		"./react/slider": {
 			"types": "./dist/react/components/Slider.d.ts",
 			"bun": "./src/react/components/Slider.tsx",
@@ -207,12 +188,6 @@
 			"source": "./src/react/components/Checkbox.tsx",
 			"import": "./dist/react/components/Checkbox.js"
 		},
-		"./react/list-selection": {
-			"types": "./dist/react/hooks/useListSelection.d.ts",
-			"bun": "./src/react/hooks/useListSelection.ts",
-			"source": "./src/react/hooks/useListSelection.ts",
-			"import": "./dist/react/hooks/useListSelection.js"
-		},
 		"./react/dropdown-menu": {
 			"types": "./dist/react/components/DropdownMenu.d.ts",
 			"bun": "./src/react/components/DropdownMenu.tsx",
@@ -225,12 +200,6 @@
 			"source": "./src/react/components/DataTable/index.ts",
 			"import": "./dist/react/components/DataTable/index.js"
 		},
-		"./react/table-sort": {
-			"types": "./dist/react/hooks/useTableSort.d.ts",
-			"bun": "./src/react/hooks/useTableSort.ts",
-			"source": "./src/react/hooks/useTableSort.ts",
-			"import": "./dist/react/hooks/useTableSort.js"
-		},
 		"./react/markdown-doc": {
 			"types": "./dist/react/markdown/MarkdownDoc.d.ts",
 			"bun": "./src/react/markdown/MarkdownDoc.tsx",
@@ -249,12 +218,6 @@
 			"source": "./src/react/schema-fields/describeSchema.ts",
 			"import": "./dist/react/schema-fields/describeSchema.js"
 		},
-		"./react/seo": {
-			"types": "./dist/react/seo/index.d.ts",
-			"bun": "./src/react/seo/index.ts",
-			"source": "./src/react/seo/index.ts",
-			"import": "./dist/react/seo/index.js"
-		},
 		"./react/code-editor": {
 			"types": "./dist/react/code-editor/index.d.ts",
 			"bun": "./src/react/code-editor/index.ts",
@@ -351,12 +314,6 @@
 			"source": "./src/react/spreadsheet/index.ts",
 			"import": "./dist/react/spreadsheet/index.js"
 		},
-		"./react/timeline": {
-			"types": "./dist/react/timeline/index.d.ts",
-			"bun": "./src/react/timeline/index.ts",
-			"source": "./src/react/timeline/index.ts",
-			"import": "./dist/react/timeline/index.js"
-		},
 		"./react/media": {
 			"types": "./dist/react/media/index.d.ts",
 			"bun": "./src/react/media/index.ts",
@@ -387,12 +344,6 @@
 			"source": "./src/react/studios/viewIds.ts",
 			"import": "./dist/react/studios/viewIds.js"
 		},
-		"./react/media/mask-painter": {
-			"types": "./dist/react/media/MaskPainter.d.ts",
-			"bun": "./src/react/media/MaskPainter.tsx",
-			"source": "./src/react/media/MaskPainter.tsx",
-			"import": "./dist/react/media/MaskPainter.js"
-		},
 		"./react/media/poster": {
 			"types": "./dist/react/media/poster.d.ts",
 			"bun": "./src/react/media/poster.ts",
@@ -411,12 +362,6 @@
 			"source": "./src/react/media/fileUploadClient.ts",
 			"import": "./dist/react/media/fileUploadClient.js"
 		},
-		"./react/media/canvas-video-player": {
-			"types": "./dist/react/media/CanvasVideoPlayer.d.ts",
-			"bun": "./src/react/media/CanvasVideoPlayer.tsx",
-			"source": "./src/react/media/CanvasVideoPlayer.tsx",
-			"import": "./dist/react/media/CanvasVideoPlayer.js"
-		},
 		"./react/media/player-strip": {
 			"types": "./dist/react/media/PlayerStrip.d.ts",
 			"bun": "./src/react/media/PlayerStrip.tsx",
@@ -435,12 +380,6 @@
 			"source": "./src/core/media/index.ts",
 			"import": "./dist/core/media/index.js"
 		},
-		"./server/media": {
-			"types": "./dist/server/media-bun/index.d.ts",
-			"bun": "./src/server/media-bun/index.ts",
-			"source": "./src/server/media-bun/index.ts",
-			"import": "./dist/server/media-bun/index.js"
-		},
 		"./server/mixins": {
 			"types": "./dist/server/mixins/index.d.ts",
 			"bun": "./src/server/mixins/index.ts",
@@ -459,12 +398,6 @@
 			"source": "./src/server/stream/index.ts",
 			"import": "./dist/server/stream/index.js"
 		},
-		"./server/ops": {
-			"types": "./dist/server/ops/index.d.ts",
-			"bun": "./src/server/ops/index.ts",
-			"source": "./src/server/ops/index.ts",
-			"import": "./dist/server/ops/index.js"
-		},
 		"./server/runtime": {
 			"types": "./dist/server/runtime/index.d.ts",
 			"bun": "./src/server/runtime/index.ts",
@@ -537,18 +470,6 @@
 			"source": "./src/server/dropzone/index.ts",
 			"import": "./dist/server/dropzone/index.js"
 		},
-		"./server/private-media": {
-			"types": "./dist/server/private-media/index.d.ts",
-			"bun": "./src/server/private-media/index.ts",
-			"source": "./src/server/private-media/index.ts",
-			"import": "./dist/server/private-media/index.js"
-		},
-		"./server/seo": {
-			"types": "./dist/server/seo/index.d.ts",
-			"bun": "./src/server/seo/index.ts",
-			"source": "./src/server/seo/index.ts",
-			"import": "./dist/server/seo/index.js"
-		},
 		"./nav": {
 			"types": "./dist/core/navigation/index.d.ts",
 			"bun": "./src/core/navigation/index.ts",
@@ -561,36 +482,6 @@
 			"source": "./src/core/palette/index.ts",
 			"import": "./dist/core/palette/index.js"
 		},
-		"./layout": {
-			"types": "./dist/core/layout/index.d.ts",
-			"bun": "./src/core/layout/index.ts",
-			"source": "./src/core/layout/index.ts",
-			"import": "./dist/core/layout/index.js"
-		},
-		"./category": {
-			"types": "./dist/core/category/index.d.ts",
-			"bun": "./src/core/category/index.ts",
-			"source": "./src/core/category/index.ts",
-			"import": "./dist/core/category/index.js"
-		},
-		"./namespace": {
-			"types": "./dist/core/namespace/index.d.ts",
-			"bun": "./src/core/namespace/index.ts",
-			"source": "./src/core/namespace/index.ts",
-			"import": "./dist/core/namespace/index.js"
-		},
-		"./game": {
-			"types": "./dist/game/core/index.d.ts",
-			"bun": "./src/game/core/index.ts",
-			"source": "./src/game/core/index.ts",
-			"import": "./dist/game/core/index.js"
-		},
-		"./game/react": {
-			"types": "./dist/game/react/index.d.ts",
-			"bun": "./src/game/react/index.ts",
-			"source": "./src/game/react/index.ts",
-			"import": "./dist/game/react/index.js"
-		},
 		"./server": {
 			"types": "./dist/server/index.d.ts",
 			"bun": "./src/server/index.ts",
@@ -609,18 +500,6 @@
 			"source": "./src/server/sqlite/index.ts",
 			"import": "./dist/server/sqlite/index.js"
 		},
-		"./upload": {
-			"types": "./dist/upload.d.ts",
-			"bun": "./src/upload.ts",
-			"source": "./src/upload.ts",
-			"import": "./dist/upload.js"
-		},
-		"./ctgr": {
-			"types": "./dist/ctgr/index.d.ts",
-			"bun": "./src/ctgr/index.ts",
-			"source": "./src/ctgr/index.ts",
-			"import": "./dist/ctgr/index.js"
-		},
 		"./client/ws-wire": {
 			"types": "./dist/client/wsWire.d.ts",
 			"bun": "./src/client/wsWire.ts",
@@ -634,6 +513,7 @@
 			"import": "./dist/client/index.js"
 		},
 		"./styles.css": "./src/styles.css",
+		"./styles-static.css": "./src/styles-static.css",
 		"./theme.css": "./src/theme.css",
 		"./workspace.css": "./src/workspace.css",
 		"./react/keep-awake": {
@@ -660,12 +540,6 @@
 			"source": "./src/react/pdf-viewer/index.ts",
 			"import": "./dist/react/pdf-viewer/index.js"
 		},
-		"./react/canvas": {
-			"types": "./dist/react/canvas/index.d.ts",
-			"bun": "./src/react/canvas/index.ts",
-			"source": "./src/react/canvas/index.ts",
-			"import": "./dist/react/canvas/index.js"
-		},
 		"./react/master-detail": {
 			"types": "./dist/react/master-detail/index.d.ts",
 			"bun": "./src/react/master-detail/index.ts",
@@ -701,12 +575,10 @@
 		"**/server/**",
 		"**/ctgr/**",
 		"**/core/**",
-		"**/client/**",
-		"**/game/core/**"
+		"**/client/**"
 	],
 	"peerDependencies": {
 		"@node-rs/argon2": ">=2",
-		"@codemirror/autocomplete": ">=6",
 		"@codemirror/commands": ">=6",
 		"@codemirror/lang-javascript": ">=6",
 		"@codemirror/lang-json": ">=6",
@@ -714,8 +586,6 @@
 		"@codemirror/lang-yaml": ">=6",
 		"@codemirror/language": ">=6",
 		"@codemirror/legacy-modes": ">=6",
-		"@codemirror/lint": ">=6",
-		"@codemirror/search": ">=6",
 		"@codemirror/state": ">=6",
 		"@codemirror/view": ">=6",
 		"@lezer/highlight": ">=1",
@@ -728,11 +598,9 @@
 		"@tiptap/extension-character-count": ">=3",
 		"@tiptap/extension-code-block-lowlight": ">=3",
 		"@tiptap/extension-image": ">=3",
-		"@tiptap/extension-link": ">=3",
 		"@tiptap/extension-placeholder": ">=3",
 		"@tiptap/extension-task-item": ">=3",
 		"@tiptap/extension-task-list": ">=3",
-		"@tiptap/pm": ">=3",
 		"@tiptap/react": ">=3",
 		"@tiptap/starter-kit": ">=3",
 		"@vidstack/react": ">=1",
@@ -761,9 +629,6 @@
 		"@node-rs/argon2": {
 			"optional": true
 		},
-		"@codemirror/autocomplete": {
-			"optional": true
-		},
 		"@codemirror/commands": {
 			"optional": true
 		},
@@ -785,12 +650,6 @@
 		"@codemirror/legacy-modes": {
 			"optional": true
 		},
-		"@codemirror/lint": {
-			"optional": true
-		},
-		"@codemirror/search": {
-			"optional": true
-		},
 		"@codemirror/state": {
 			"optional": true
 		},
@@ -824,9 +683,6 @@
 		"@tiptap/extension-image": {
 			"optional": true
 		},
-		"@tiptap/extension-link": {
-			"optional": true
-		},
 		"@tiptap/extension-placeholder": {
 			"optional": true
 		},
@@ -836,9 +692,6 @@
 		"@tiptap/extension-task-list": {
 			"optional": true
 		},
-		"@tiptap/pm": {
-			"optional": true
-		},
 		"@tiptap/react": {
 			"optional": true
 		},
@@ -918,6 +771,7 @@
 		"@lezer/highlight": "^1.2.3",
 		"@node-rs/argon2": "^2.0.2",
 		"@playwright/test": "^1.61.0",
+		"@tailwindcss/vite": "^4.3.1",
 		"@tanstack/react-query": "5.101.2",
 		"@testing-library/dom": "^10.4.1",
 		"@testing-library/react": "16.3.2",
@@ -935,10 +789,10 @@
 		"@types/bun": "^1.3.14",
 		"@types/diff": "^8.0.0",
 		"@types/node": "^24",
-		"@types/papaparse": "^5.5.2",
 		"@types/react": "^19.2.17",
 		"@types/react-dom": "^19.2.3",
 		"@vidstack/react": "1.15.6",
+		"@vitejs/plugin-react": "^5.2.0",
 		"hls.js": "^1.5.0",
 		"hono": "4.12.28",
 		"konva": "^10.3.0",
@@ -950,6 +804,8 @@
 		"partysocket": "^1.2.0",
 		"pdfjs-dist": "^4.10.38",
 		"plainjob": "^0.0.14",
+		"react": "19.2.7",
+		"react-dom": "19.2.7",
 		"react-filerobot-image-editor": "5.0.0-beta.159",
 		"react-konva": "^19.2.5",
 		"react-photo-album": "^3.6.0",
@@ -959,11 +815,10 @@
 		"tailwindcss": "^4.3.1",
 		"tiptap-markdown": "^0.9.0",
 		"typescript": "^6.0.3",
+		"vite": "^7.3.6",
 		"xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz",
 		"yet-another-react-lightbox": "^3.32.0",
-		"zod": "4.4.3",
-		"react": "19.2.7",
-		"react-dom": "19.2.7"
+		"zod": "4.4.3"
 	},
 	"dependencies": {
 		"@atlaskit/pragmatic-drag-and-drop": "^2.0.1",
@@ -983,12 +838,10 @@
 		"@radix-ui/react-dialog": "^1.1.17",
 		"@radix-ui/react-dropdown-menu": "^2.1.18",
 		"@radix-ui/react-hover-card": "^1.1.17",
-		"@radix-ui/react-label": "^2.1.10",
 		"@radix-ui/react-popover": "^1.1.17",
 		"@radix-ui/react-progress": "^1.1.10",
 		"@radix-ui/react-radio-group": "^1.3.9",
 		"@radix-ui/react-select": "^2.3.1",
-		"@radix-ui/react-separator": "^1.1.10",
 		"@radix-ui/react-slider": "^1.4.2",
 		"@radix-ui/react-slot": "^1.3.0",
 		"@radix-ui/react-switch": "^1.3.1",
@@ -1005,7 +858,6 @@
 		"jose": "^6.2.3",
 		"lucide-react": "^1.21.0",
 		"marked": "^14.0.0",
-		"papaparse": "^5.5.4",
 		"react-grid-layout": "2.2.3",
 		"react-hook-form": "^7.80.0",
 		"react-resizable-panels": "^4.12.0",
@@ -1021,4 +873,4 @@
 		"type": "git",
 		"url": "git+https://github.com/curtwphillips/cursedbelt.git"
 	}
-}
+}

package/scripts/generateStaticStyles.ts

@@ -0,0 +1,122 @@
+/**
+ * Generate `src/styles-static.css` from `src/styles.css` — the SCOPED entry point.
+ *
+ * ── Why a second stylesheet exists ──────────────────────────────────────────
+ * `src/styles.css` is two different things wearing one name:
+ *
+ *   1. real CSS the components need — `tw-animate-css` (the dialog family's
+ *      enter/exit motion), `.cb-meta-label`, `.cb-code`, the Progress keyframes,
+ *      the lightbox token bridge, the ambient/glass layer, and the tooltip
+ *      pointer-events rules that stop a focus-opened tooltip eating a click; and
+ *   2. `@source "."`, which points Tailwind's JIT at cursedbelt's ENTIRE source
+ *      tree, so the consuming app emits the union of the whole design system —
+ *      measured at 113 KB / 846 selectors in the previous generation — whether it
+ *      renders three components or eighty.
+ *
+ * A CSS `@import` takes the whole file, so an app that wants (1) without (2) has
+ * no way to ask. `cursedbelt/styles-static.css` is that ask.
+ *
+ * ── Why GENERATED, and not a second file somebody maintains ─────────────────
+ * The previous generation solved this with `satellite-kit/styles/belt-static.css`
+ * — a hand-kept COPY of this file with the one line deleted — and every app then
+ * hand-listed the component files Tailwind was allowed to scan (29 relative
+ * `@source` lines in flix alone, each one reaching into another package's source
+ * tree: a `file:` dependency wearing a stylesheet's clothes). A copy nothing
+ * compares is a copy that drifts, and the drift is invisible: the scoped app
+ * simply stops getting the tooltip fix, or the Progress keyframes, and nobody
+ * finds out until a user reports a click that does nothing.
+ *
+ * So the second file is OUTPUT. This script writes it, `bun run build` runs this
+ * script first, and `src/stylesStaticMatches.spec.ts` fails if what is on disk is
+ * not exactly what this produces. Document the WHY; automate the WHETHER.
+ *
+ * Usage:
+ *   bun run styles:static            # write src/styles-static.css
+ *   bun run styles:static --check    # exit 1 if it is stale, write nothing
+ */
+
+/**
+ * Repo root, resolved from this file — never `process.cwd()`; the suite imports
+ * this module and `bun test` can be started from anywhere. A string trim rather
+ * than `node:path`: the test preload virtualizes node builtins, so a helper the
+ * suite shares must not reach through a mocked module (same trap as the
+ * `Bun.file` note in `src/publishShape.spec.ts`), and the result stays an
+ * absolute path a person can paste instead of `…/scripts/..`.
+ */
+export const REPO_ROOT = import.meta.dir.replace(/\/scripts$/, '');
+
+export const SOURCE_STYLESHEET = 'src/styles.css';
+export const STATIC_STYLESHEET = 'src/styles-static.css';
+
+/** A whole-line `@source …` at-rule — the one thing the static variant drops. */
+export const SOURCE_DIRECTIVE = /^\s*@source\b/;
+
+/**
+ * `styles.css` minus its `@source` line(s).
+ *
+ * The blank line that FOLLOWS a dropped directive goes with it, so the output is
+ * a clean subsequence of the input's lines rather than a file with a two-line gap
+ * where the directive used to be. Nothing else is touched — no reflow, no
+ * re-indent, no normalisation — because "identical except that line" is the
+ * property the spec asserts, and a formatter in here would quietly weaken it.
+ */
+export const staticStylesFrom = (css: string): string => {
+	const lines = css.split('\n');
+	const out: string[] = [];
+	for (let i = 0; i < lines.length; i++) {
+		if (SOURCE_DIRECTIVE.test(lines[i] ?? '')) {
+			if (lines[i + 1]?.trim() === '') i++;
+			continue;
+		}
+		out.push(lines[i] ?? '');
+	}
+	return out.join('\n');
+};
+
+/** Read `src/styles.css` and the static variant's expected + on-disk contents. */
+export const readStylesheets = async (): Promise<{
+	source: string;
+	expected: string;
+	onDisk: string | null;
+}> => {
+	const source = await Bun.file(`${REPO_ROOT}/${SOURCE_STYLESHEET}`).text();
+	const target = Bun.file(`${REPO_ROOT}/${STATIC_STYLESHEET}`);
+	return {
+		source,
+		expected: staticStylesFrom(source),
+		onDisk: (await target.exists()) ? await target.text() : null,
+	};
+};
+
+if (import.meta.main) {
+	const { source, expected, onDisk } = await readStylesheets();
+	if (expected === source) {
+		console.error(
+			`❌ ${SOURCE_STYLESHEET} carries no \`@source\` directive, so the static variant would be a\n` +
+				'   byte-for-byte duplicate of it and this whole subpath would be pointless. Either the\n' +
+				'   directive was deleted (every consumer now emits no cursedbelt utilities at all) or it\n' +
+				'   was reshaped past what SOURCE_DIRECTIVE matches.',
+		);
+		process.exit(1);
+	}
+	if (process.argv.includes('--check')) {
+		if (onDisk === expected) {
+			console.log(`✅ ${STATIC_STYLESHEET} is current.`);
+			process.exit(0);
+		}
+		console.error(
+			`❌ ${STATIC_STYLESHEET} is ${onDisk === null ? 'missing' : 'stale'}. Run:\n` +
+				`     cd ${REPO_ROOT} && bun run styles:static`,
+		);
+		process.exit(1);
+	}
+	if (onDisk === expected) {
+		console.log(`✅ ${STATIC_STYLESHEET} already current (${expected.length} bytes).`);
+	} else {
+		await Bun.write(`${REPO_ROOT}/${STATIC_STYLESHEET}`, expected);
+		console.log(
+			`✅ wrote ${STATIC_STYLESHEET} — ${SOURCE_STYLESHEET} minus its \`@source\` line ` +
+				`(${source.length} → ${expected.length} bytes).`,
+		);
+	}
+}