admin-ui-starter-kit 0.5.0 → 0.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "admin-ui-starter-kit",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "Opinionated React component kit for admin panels and SaaS dashboards, built on top of shadcn/ui + Tailwind CSS v4. Callback-driven, framework-agnostic, i18n-ready.",
   "type": "module",
   "license": "MIT",
@@ -37,14 +37,18 @@
     "PUBLISHING.md",
     "LICENSE",
     "src/App.css",
+    "src/css",
     "style.css.d.ts",
     "CLAUDE.md",
     "AGENTS.md",
     ".agents/skills/component-library-rules",
     ".agents/skills/admin-ui-consumer-migration",
     ".agents/skills/component-quality-pass",
+    ".agents/skills/token-system",
+    ".agents/skills/admin-ui-components",
     "scripts/audit-consumer.mjs",
     "scripts/install-skill.mjs",
+    "scripts/publish-theme.mjs",
     "scripts/serve-showcase.mjs",
     "scripts/metadata.json",
     "scripts/README.md"
@@ -52,6 +56,7 @@
   "bin": {
     "admin-ui-starter-kit-audit": "./scripts/audit-consumer.mjs",
     "admin-ui-starter-kit-install-skill": "./scripts/install-skill.mjs",
+    "admin-ui-starter-kit-publish-theme": "./scripts/publish-theme.mjs",
     "admin-ui-starter-kit-showcase": "./scripts/serve-showcase.mjs"
   },
   "sideEffects": [
@@ -64,27 +69,33 @@
     "build:lib": "node scripts/clean-dist.mjs && vite build -c vite.lib.config.ts && node scripts/prune-dist-aggregates.mjs && tailwindcss -i ./src/App.css -o ./dist/style.css --minify && node scripts/copy-style-assets.mjs",
     "lint": "eslint .",
     "lint:architecture": "node scripts/check-architecture.mjs",
+    "lint:tokens": "node scripts/check-token-contract.mjs",
     "quality:smells": "node .agents/skills/component-quality-pass/scripts/scan-quality-smells.mjs",
     "test:exports": "node scripts/check-package-exports.mjs",
     "docs:check-feature-parity": "node scripts/check-feature-parity.mjs",
     "test:dist-assets": "node scripts/check-dist-assets.mjs",
     "test:package-smoke": "npm run build:lib && npm run build:showcase && node scripts/check-package-smoke.mjs",
     "test:package-smoke:check": "node scripts/check-package-smoke.mjs",
+    "pretest:browser:features": "npm run build:showcase",
     "test:browser:features": "playwright test tests/showcase/features.browser.spec.ts",
+    "pretest:a11y:features": "npm run build:showcase",
     "test:a11y:features": "playwright test tests/showcase/features.a11y.spec.ts",
+    "pretest:visual:features": "npm run build:showcase",
     "test:visual:features": "playwright test tests/showcase/features.visual.spec.ts",
+    "pretest:visual:update": "npm run build:showcase",
     "test:visual:update": "playwright test tests/showcase/features.visual.spec.ts --update-snapshots",
     "docs:generate-props": "node scripts/generate-props-tables.mjs",
     "docs:check-props": "node scripts/check-props-fresh.mjs",
     "docs:sync-skill": "node scripts/sync-skill-components.mjs",
     "docs:check-scripts": "node scripts/check-script-metadata.mjs",
     "typecheck": "tsc -p tsconfig.app.json --noEmit --ignoreDeprecations 6.0",
-    "verify": "npm run lint:architecture && npm run quality:smells && npm run test:exports && npm run docs:check-feature-parity && npm run docs:check-props && npm run docs:sync-skill -- --check && npm run docs:check-scripts && npm run typecheck && npm run lint && npm run test -- --pool=threads --maxWorkers=1",
+    "verify": "npm run lint:architecture && npm run lint:tokens && npm run quality:smells && npm run test:exports && npm run docs:check-feature-parity && npm run docs:check-props && npm run docs:sync-skill -- --check && npm run docs:check-scripts && npm run typecheck && npm run lint && npm run test -- --pool=threads --maxWorkers=1",
     "verify:release": "npm run verify && npm run build:lib && npm run test:dist-assets && npm run build:showcase && npm run test:package-smoke:check && npm run test:browser:features && npm run test:a11y:features && npm run test:visual:features && git diff --check",
     "test": "vitest run",
     "preview": "vite preview",
     "prepublishOnly": "npm run build:lib && npm run test:dist-assets && npm run build:showcase",
-    "publish:skill": "node scripts/publish-skill.mjs"
+    "publish:skill": "node scripts/publish-skill.mjs",
+    "publish:theme": "node scripts/publish-theme.mjs"
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -159,11 +170,6 @@
       "import": "./dist/components/base/currency/index.js",
       "require": "./dist/components/base/currency/index.cjs"
     },
-    "./base/data-view": {
-      "types": "./dist/components/base/data-view/index.d.ts",
-      "import": "./dist/components/base/data-view/index.js",
-      "require": "./dist/components/base/data-view/index.cjs"
-    },
     "./base/date-pickers": {
       "types": "./dist/components/base/date-pickers/index.d.ts",
       "import": "./dist/components/base/date-pickers/index.js",
@@ -179,21 +185,11 @@
       "import": "./dist/components/base/display/chart.js",
       "require": "./dist/components/base/display/chart.cjs"
     },
-    "./base/display/metadata": {
-      "types": "./dist/components/base/display/metadata/index.d.ts",
-      "import": "./dist/components/base/display/metadata/index.js",
-      "require": "./dist/components/base/display/metadata/index.cjs"
-    },
     "./base/event-calendar": {
       "types": "./dist/components/base/event-calendar/index.d.ts",
       "import": "./dist/components/base/event-calendar/index.js",
       "require": "./dist/components/base/event-calendar/index.cjs"
     },
-    "./base/frame": {
-      "types": "./dist/components/base/frame/index.d.ts",
-      "import": "./dist/components/base/frame/index.js",
-      "require": "./dist/components/base/frame/index.cjs"
-    },
     "./base/forms": {
       "types": "./dist/components/base/forms/index.d.ts",
       "import": "./dist/components/base/forms/index.js",
@@ -319,6 +315,11 @@
       "import": "./dist/components/features/comments/index.js",
       "require": "./dist/components/features/comments/index.cjs"
     },
+    "./features/data-view": {
+      "types": "./dist/components/features/data-view/index.d.ts",
+      "import": "./dist/components/features/data-view/index.js",
+      "require": "./dist/components/features/data-view/index.cjs"
+    },
     "./features/event-log": {
       "types": "./dist/components/features/event-log/index.d.ts",
       "import": "./dist/components/features/event-log/index.js",
@@ -359,6 +360,11 @@
       "import": "./dist/components/features/products/index.js",
       "require": "./dist/components/features/products/index.cjs"
     },
+    "./features/resource": {
+      "types": "./dist/components/features/resource/index.d.ts",
+      "import": "./dist/components/features/resource/index.js",
+      "require": "./dist/components/features/resource/index.cjs"
+    },
     "./features/rich-text-editor": {
       "types": "./dist/components/features/rich-text-editor/index.d.ts",
       "import": "./dist/components/features/rich-text-editor/index.js",
@@ -404,11 +410,6 @@
       "import": "./dist/components/layout/page/index.js",
       "require": "./dist/components/layout/page/index.cjs"
     },
-    "./layout/resource": {
-      "types": "./dist/components/layout/resource/index.d.ts",
-      "import": "./dist/components/layout/resource/index.js",
-      "require": "./dist/components/layout/resource/index.cjs"
-    },
     "./layout/settings": {
       "types": "./dist/components/layout/settings/index.d.ts",
       "import": "./dist/components/layout/settings/index.js",

package/scripts/install-skill.mjs

@@ -21,6 +21,8 @@ import { fileURLToPath } from 'node:url';
 
 const SKILL_NAMES = [
 	'component-library-rules',
+	'admin-ui-components',
+	'token-system',
 	'admin-ui-consumer-migration',
 	'component-quality-pass',
 ];

package/scripts/metadata.json

@@ -48,6 +48,13 @@
       "whenToRun": "Run after import, layer, config, service, or component changes.",
       "mutates": false
     },
+    "lint:tokens": {
+      "summary": "Check the structural token contract and reject deprecated token utility usage in source.",
+      "category": "quality",
+      "command": "node scripts/check-token-contract.mjs",
+      "whenToRun": "Run after token CSS layers, token utilities, component class names, or token docs change.",
+      "mutates": false
+    },
     "quality:smells": {
       "summary": "Run static quality smell scans for token, style, and API anti-patterns.",
       "category": "quality",
@@ -95,6 +102,15 @@
       "dependsOn": ["build:lib", "build:showcase"],
       "outputs": ["node_modules/.tmp/package-smoke-*"]
     },
+    "pretest:browser:features": {
+      "summary": "Build the static showcase before the browser route and workflow sweep.",
+      "category": "browser",
+      "command": "npm run build:showcase",
+      "whenToRun": "Runs automatically before test:browser:features.",
+      "mutates": true,
+      "dependsOn": ["build:showcase"],
+      "outputs": ["dist/showcase"]
+    },
     "test:browser:features": {
       "summary": "Run Playwright browser route and workflow checks for all registered feature routes.",
       "category": "browser",
@@ -103,6 +119,15 @@
       "mutates": false,
       "dependsOn": ["build:showcase"]
     },
+    "pretest:a11y:features": {
+      "summary": "Build the static showcase before the feature accessibility sweep.",
+      "category": "browser",
+      "command": "npm run build:showcase",
+      "whenToRun": "Runs automatically before test:a11y:features.",
+      "mutates": true,
+      "dependsOn": ["build:showcase"],
+      "outputs": ["dist/showcase"]
+    },
     "test:a11y:features": {
       "summary": "Run axe-powered serious/critical accessibility checks for all registered feature routes.",
       "category": "browser",
@@ -111,6 +136,15 @@
       "mutates": false,
       "dependsOn": ["build:showcase"]
     },
+    "pretest:visual:features": {
+      "summary": "Build the static showcase before the feature visual baseline check.",
+      "category": "browser",
+      "command": "npm run build:showcase",
+      "whenToRun": "Runs automatically before test:visual:features.",
+      "mutates": true,
+      "dependsOn": ["build:showcase"],
+      "outputs": ["dist/showcase"]
+    },
     "test:visual:features": {
       "summary": "Compare all registered feature routes against committed Chromium visual baselines.",
       "category": "browser",
@@ -119,6 +153,15 @@
       "mutates": false,
       "dependsOn": ["build:showcase"]
     },
+    "pretest:visual:update": {
+      "summary": "Build the static showcase before updating feature visual baselines.",
+      "category": "browser",
+      "command": "npm run build:showcase",
+      "whenToRun": "Runs automatically before test:visual:update.",
+      "mutates": true,
+      "dependsOn": ["build:showcase"],
+      "outputs": ["dist/showcase"]
+    },
     "test:visual:update": {
       "summary": "Update committed Chromium feature-route visual baselines intentionally.",
       "category": "browser",
@@ -166,12 +209,12 @@
       "mutates": false
     },
     "verify": {
-      "summary": "Run the standard maintainer verification chain: architecture, smells, exports, docs, typecheck, lint, and Vitest.",
+      "summary": "Run the standard maintainer verification chain: architecture, token contract, smells, exports, docs, typecheck, lint, and Vitest.",
       "category": "quality",
-      "command": "npm run lint:architecture && npm run quality:smells && npm run test:exports && npm run docs:check-feature-parity && npm run docs:check-props && npm run docs:sync-skill -- --check && npm run docs:check-scripts && npm run typecheck && npm run lint && npm run test -- --pool=threads --maxWorkers=1",
+      "command": "npm run lint:architecture && npm run lint:tokens && npm run quality:smells && npm run test:exports && npm run docs:check-feature-parity && npm run docs:check-props && npm run docs:sync-skill -- --check && npm run docs:check-scripts && npm run typecheck && npm run lint && npm run test -- --pool=threads --maxWorkers=1",
       "whenToRun": "Run before handing off source changes.",
       "mutates": true,
-      "dependsOn": ["lint:architecture", "quality:smells", "test:exports", "docs:check-feature-parity", "docs:check-props", "docs:sync-skill", "docs:check-scripts", "typecheck", "lint", "test"]
+      "dependsOn": ["lint:architecture", "lint:tokens", "quality:smells", "test:exports", "docs:check-feature-parity", "docs:check-props", "docs:sync-skill", "docs:check-scripts", "typecheck", "lint", "test"]
     },
     "verify:release": {
       "summary": "Run the full release gate: verify, builds, dist assets, package smoke, browser workflows, a11y, visual baselines, and whitespace checks.",
@@ -213,6 +256,14 @@
       "whenToRun": "Run when updating local/global maintainer skills on this machine.",
       "mutates": true,
       "outputs": ["~/.claude/skills", "~/.agents/skills"]
+    },
+    "publish:theme": {
+      "summary": "Copy editable theme/default token layers and local CSS entrypoints into the current project.",
+      "category": "consumer",
+      "command": "node scripts/publish-theme.mjs",
+      "whenToRun": "Run from a consumer app when publishing local token files for overrides.",
+      "mutates": true,
+      "outputs": ["src/styles/admin-ui"]
     }
   },
   "files": {
@@ -266,6 +317,12 @@
       "usedBy": "npm run docs:check-scripts",
       "mutates": false
     },
+    "scripts/check-token-contract.mjs": {
+      "summary": "Layered token contract guard for shadcn theme, package token files, compatibility aliases, and component utility usage.",
+      "category": "quality",
+      "usedBy": "npm run lint:tokens",
+      "mutates": false
+    },
     "scripts/clean-dist.mjs": {
       "summary": "Clear dist contents while preserving the directory.",
       "category": "build",
@@ -308,6 +365,13 @@
       "mutates": true,
       "outputs": ["~/.claude/skills", "~/.agents/skills"]
     },
+    "scripts/publish-theme.mjs": {
+      "summary": "Consumer-facing helper that publishes editable theme/default token layers and CSS entrypoints.",
+      "category": "consumer",
+      "usedBy": "admin-ui-starter-kit-publish-theme bin and npm run publish:theme",
+      "mutates": true,
+      "outputs": ["src/styles/admin-ui"]
+    },
     "scripts/serve-showcase.mjs": {
       "summary": "Consumer-facing static server for the bundled showcase.",
       "category": "consumer",

package/scripts/publish-theme.mjs

@@ -0,0 +1,245 @@
+#!/usr/bin/env node
+/**
+ * publish-theme — copy admin-ui-starter-kit token sources into a consumer app.
+ *
+ * Default:
+ *   npx admin-ui-starter-kit-publish-theme
+ *
+ * Writes:
+ *   src/styles/admin-ui/theme.css       raw editable shadcn theme adapter
+ *   src/styles/admin-ui/defaults.css    raw editable package token layers
+ *   src/styles/admin-ui/overrides.css   runtime variable overrides only
+ *   src/styles/admin-ui/admin-ui.css    imports package style.css + overrides
+ *   src/styles/admin-ui/source.css      Tailwind source-mode starter
+ */
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const packageRoot = path.resolve(path.dirname(__filename), '..');
+const cwd = process.cwd();
+const packageName = 'admin-ui-starter-kit';
+
+function parseArgs(argv) {
+	const options = {
+		outDir: 'src/styles/admin-ui',
+		force: false,
+		dryRun: false,
+		help: false,
+	};
+
+	for (const arg of argv.slice(2)) {
+		if (arg === '--force' || arg === '-f') {
+			options.force = true;
+		} else if (arg === '--dry-run') {
+			options.dryRun = true;
+		} else if (arg === '--help' || arg === '-h') {
+			options.help = true;
+		} else if (arg.startsWith('--out-dir=')) {
+			options.outDir = arg.slice('--out-dir='.length);
+		} else {
+			throw new Error(`Unknown argument: ${arg}`);
+		}
+	}
+
+	return options;
+}
+
+function printHelp() {
+	console.log(
+		`Usage: npx ${packageName}-publish-theme [options]\n\n` +
+			`Copies editable token layers from ${packageName} into the current project.\n\n` +
+			`Options:\n` +
+			`  --out-dir=<path>   Output directory (default: src/styles/admin-ui)\n` +
+			`  --force, -f        Overwrite existing files\n` +
+			`  --dry-run          Print planned writes without changing files\n` +
+			`  --help, -h         Show this message\n`,
+	);
+}
+
+function skipBalancedBlock(source, start) {
+	const firstBrace = source.indexOf('{', start);
+	if (firstBrace === -1) {
+		const nextLine = source.indexOf('\n', start);
+		return nextLine === -1 ? source.length : nextLine + 1;
+	}
+
+	let depth = 0;
+	for (let index = firstBrace; index < source.length; index += 1) {
+		const char = source[index];
+		if (char === '{') depth += 1;
+		if (char === '}') {
+			depth -= 1;
+			if (depth === 0) {
+				let end = index + 1;
+				while (source[end] === '\n' || source[end] === '\r') end += 1;
+				return end;
+			}
+		}
+	}
+
+	return source.length;
+}
+
+function stripBuildTimeCss(source) {
+	const withoutComments = source.replace(/\/\*[\s\S]*?\*\//g, '');
+	let output = '';
+	let index = 0;
+
+	while (index < withoutComments.length) {
+		const lineStart = index;
+		while (withoutComments[index] === ' ' || withoutComments[index] === '\t' || withoutComments[index] === '\r') {
+			index += 1;
+		}
+
+		if (withoutComments.startsWith('@import', index) || withoutComments.startsWith('@custom-variant', index)) {
+			const nextLine = withoutComments.indexOf('\n', index);
+			index = nextLine === -1 ? withoutComments.length : nextLine + 1;
+			continue;
+		}
+
+		if (withoutComments.startsWith('@theme', index) || withoutComments.startsWith('@utility', index)) {
+			index = skipBalancedBlock(withoutComments, index);
+			continue;
+		}
+
+		output += withoutComments[lineStart];
+		index = lineStart + 1;
+	}
+
+	return `${output.replace(/\n{3,}/g, '\n\n').trim()}\n`;
+}
+
+function toCssPath(value) {
+	return value.split(path.sep).join('/');
+}
+
+async function plannedWrite(filePath, contents, options) {
+	if (existsSync(filePath) && !options.force) {
+		const current = await readFile(filePath, 'utf8');
+		if (current === contents) {
+			console.log(`  · unchanged ${path.relative(cwd, filePath)}`);
+			return;
+		}
+		throw new Error(
+			`${path.relative(cwd, filePath)} already exists. Re-run with --force to overwrite it.`,
+		);
+	}
+
+	if (options.dryRun) {
+		console.log(`  · would write ${path.relative(cwd, filePath)}`);
+		return;
+	}
+
+	await writeFile(filePath, contents);
+	console.log(`  ✓ wrote ${path.relative(cwd, filePath)}`);
+}
+
+async function main() {
+	let options;
+	try {
+		options = parseArgs(process.argv);
+	} catch (error) {
+		console.error(`✖ ${error.message}`);
+		printHelp();
+		process.exit(2);
+	}
+
+	if (options.help) {
+		printHelp();
+		return;
+	}
+
+	const outDir = path.resolve(cwd, options.outDir);
+	const sourceThemePath = path.join(packageRoot, 'src', 'css', 'themes', 'shadcn.default.css');
+	const sourceTokenPaths = [
+		['tokens/foundation.css', path.join(packageRoot, 'src', 'css', 'tokens', 'foundation.css')],
+		['tokens/states.css', path.join(packageRoot, 'src', 'css', 'tokens', 'states.css')],
+		['tokens/primitives.css', path.join(packageRoot, 'src', 'css', 'tokens', 'primitives.css')],
+		['tokens/layout.css', path.join(packageRoot, 'src', 'css', 'tokens', 'layout.css')],
+		['tokens/components.css', path.join(packageRoot, 'src', 'css', 'tokens', 'components.css')],
+		['tokens/compat.css', path.join(packageRoot, 'src', 'css', 'tokens', 'compat.css')],
+	];
+
+	const [themeCss, tokenLayers] = await Promise.all([
+		readFile(sourceThemePath, 'utf8'),
+		Promise.all(
+			sourceTokenPaths.map(async ([label, filePath]) => ({
+				label,
+				css: await readFile(filePath, 'utf8'),
+			})),
+		),
+	]);
+	const defaultsCss = `${tokenLayers
+		.map(({ label, css }) => [`/* ${packageName}: ${label} */`, css.trim()].join('\n'))
+		.join('\n\n')}\n`;
+
+	const relativeDist = toCssPath(
+		path.relative(outDir, path.join(cwd, 'node_modules', packageName, 'dist')) || '.',
+	);
+	const sourceImport = `${relativeDist}/**/*.{js,cjs}`;
+
+	const overridesCss = [
+		'/*',
+		` * Runtime token overrides generated from ${packageName}.`,
+		` * Import after ${packageName}/style.css, or use admin-ui.css below.`,
+		' * Edit the variable values, keep the variable names stable.',
+		' */',
+		'',
+		'/* Shadcn theme adapter: color, radius, shadow, dark/light, charts, sidebar. */',
+		stripBuildTimeCss(themeCss),
+		'/* Package token layers: states, typography, spacing, density, primitives, rows, surfaces, shell. */',
+		stripBuildTimeCss(defaultsCss),
+	].join('\n');
+
+	const adminUiCss = [
+		'/*',
+		` * Local ${packageName} stylesheet entrypoint.`,
+		' * Import this file from your app instead of importing the package style directly',
+		' * when you want checked-in editable theme/default variables.',
+		' */',
+		`@import '${packageName}/style.css';`,
+		"@import './overrides.css';",
+		'',
+	].join('\n');
+
+	const sourceCss = [
+		'/*',
+		` * Tailwind source-mode starter for ${packageName}.`,
+		' * Use only when the app intentionally rebuilds Tailwind instead of importing',
+		` * ${packageName}/style.css. Most consumers should use admin-ui.css.`,
+		' */',
+		"@import 'tailwindcss';",
+		"@import 'tw-animate-css';",
+		"@import 'shadcn/tailwind.css';",
+		"@import '@fontsource-variable/inter';",
+		`@source '${sourceImport}';`,
+		"@import './theme.css';",
+		"@import './defaults.css';",
+		'',
+	].join('\n');
+
+	console.log(`Publishing ${packageName} editable token layers`);
+	console.log(`Output: ${path.relative(cwd, outDir) || '.'}\n`);
+
+	if (!options.dryRun) {
+		await mkdir(outDir, { recursive: true });
+	}
+
+	await plannedWrite(path.join(outDir, 'theme.css'), themeCss, options);
+	await plannedWrite(path.join(outDir, 'defaults.css'), defaultsCss, options);
+	await plannedWrite(path.join(outDir, 'overrides.css'), overridesCss, options);
+	await plannedWrite(path.join(outDir, 'admin-ui.css'), adminUiCss, options);
+	await plannedWrite(path.join(outDir, 'source.css'), sourceCss, options);
+
+	console.log(
+		`\nImport ${path.join(options.outDir, 'admin-ui.css')} from the app to use package CSS plus local token overrides.`,
+	);
+}
+
+main().catch((error) => {
+	console.error(`✖ ${error instanceof Error ? error.message : String(error)}`);
+	process.exit(1);
+});

package/src/App.css

@@ -9,10 +9,17 @@
 @import "leaflet.markercluster/dist/MarkerCluster.Default.css";
 
 /* shadcn theme — swap this one file to retheme (palette, radius, dark/light). */
-@import "./css/themes/default.css";
+@import "./css/themes/shadcn.default.css";
 
-/* Global config + overrides that are not part of the shadcn theme. */
-@import "./css/defaults.css";
+/* Package-owned design tokens. These are not part of the shadcn theme. */
+@import "./css/tokens/foundation.css";
+@import "./css/tokens/states.css";
+@import "./css/tokens/primitives.css";
+@import "./css/tokens/layout.css";
+@import "./css/tokens/components.css";
+
+/* Temporary aliases for pre-token-split names. Remove after consumers migrate. */
+@import "./css/tokens/compat.css";
 
 /* Feature-local stylesheets (co-located with their components, pulled into
  * the published style.css here because App.css is the Tailwind CLI entry). */

package/src/css/defaults.css

@@ -0,0 +1,12 @@
+/*
+ * Legacy structural-token entrypoint.
+ *
+ * Kept for source-level compatibility. New package builds import each token
+ * layer directly from `src/App.css`.
+ */
+@import "./tokens/foundation.css";
+@import "./tokens/states.css";
+@import "./tokens/primitives.css";
+@import "./tokens/layout.css";
+@import "./tokens/components.css";
+@import "./tokens/compat.css";

package/src/css/themes/default.css

@@ -0,0 +1,7 @@
+/*
+ * Legacy theme entrypoint.
+ *
+ * Kept for source-level compatibility. New package builds import
+ * `themes/shadcn.default.css` directly from `src/App.css`.
+ */
+@import "./shadcn.default.css";