@nebutra/tokens 0.1.2 → 0.1.3

package/.turbo/turbo-build.log

@@ -1,8 +0,0 @@
-
-> @nebutra/tokens@0.1.2 build /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/design/tokens
-> node scripts/sync-styles.mjs && node scripts/emit-skins.mjs
-
-Formatted 1 file in 9ms. No fixes applied.
-styles.css refreshed from @nebutra/design-tokens
-emit-skins: 7 skins from brand.json → skins/*.css
-  gsap, linear, notion, raycast, stripe, vanta, vercel

package/.turbo/turbo-typecheck.log

@@ -1,4 +0,0 @@
-
-> @nebutra/tokens@0.1.2 typecheck /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/design/tokens
-> tsc --noEmit
-

package/AGENTS.md

@@ -1,45 +0,0 @@
-# AGENTS.md — packages/tokens
-
-Execution contract for Nebutra's runtime design-token package.
-
-## Scope
-
-Applies to everything under `packages/design/tokens/`.
-
-This package is the canonical runtime token layer for Nebutra apps. It owns the
-base semantic CSS variables and the light/dark theme-provider surface.
-
-## Source Of Truth
-
-- Public package surface and exports: `package.json`, `src/index.ts`
-- Canonical runtime token definitions: `styles.css` (generated from `@nebutra/design-tokens` via `sync-styles.mjs`; keep `verify:parity` at 100%)
-
-## Contract Boundaries
-
-- Treat `styles.css` as the single source of truth for runtime token names,
-  semantic aliases, and Tailwind-consumable CSS variables. Do not redefine core
-  token names in apps or sibling packages.
-- Keep `THEME_IDS` and `DEFAULT_THEME` in `src/index.ts` aligned with the
-  actual light/dark behavior implemented in `styles.css`.
-- This package owns the base light/dark token system only. Do not move named
-  product-mood presets here. **Design-language catalog & global swap** belong in
-  `@nebutra/theme` (`languages.json`, `applyLanguage`, `skins.css`). Brand Package
-  *engine* (compile / emit / normalize) stays in this package (`brand-package/`).
-  Multi-mood oklch catalogs were deleted — never reintroduce a second root `@theme` primary.
-- Preserve the package boundary between CSS tokens and component usage.
-  `@nebutra/ui` and apps should consume the exported CSS surface rather than
-  importing token internals.
-- Because `./styles.css` is an exported side-effect file, treat renames or
-  variable removals as cross-repo breaking changes even if TypeScript passes.
-
-## Generated And Derived Files
-
-- `tsconfig.tsbuildinfo` and compiler artifacts are derived files.
-- Consumer app compiled CSS output is derived from `styles.css`.
-
-## Validation
-
-- Token or export changes:
-  `pnpm --filter @nebutra/tokens typecheck`
-- When token names or theme IDs change, verify at least one consuming package
-  updates with the same change instead of relying on stale compiled CSS.

package/DESIGN.md

@@ -1,357 +0,0 @@
-# `@nebutra/tokens` — Design Spec
-
-> Runtime token layer of the Nebutra-Sailor design system.
-> Part of the [root DESIGN.md](../../DESIGN.md). Spec format: `design-md@2026.05`.
-
-| Field | Value |
-|------|------|
-| Package | `@nebutra/tokens` |
-| Status | **★ Source of truth for runtime apps** |
-| Source file | `packages/design/tokens/styles.css` |
-| Tailwind integration | Tailwind v4 `@theme inline` block in same file |
-| Re-exports | Custom `ThemeProvider` / `useTheme` (cookie + class; not next-themes) |
-
----
-
-## 1. Identity
-
-This package emits the **runtime CSS variables** consumed by every Nebutra app.
-
-### App consumption contract (package-owned)
-
-Apps should **not** hand-roll monorepo `@source` paths. Import the UI entry:
-
-```css
-/* Simple apps */
-@import "@nebutra/ui/styles/preset.css";
-
-/* Or: tokens yourself + package-owned source scan */
-@import "tailwindcss";
-@import "@nebutra/tokens/styles.css";
-@import "@nebutra/ui/styles/sources.css";
-```
-
-| Layer | Entry | Role |
-|-------|-------|------|
-| Tokens | `@nebutra/tokens/styles.css` | CSS variables + `@theme` only |
-| UI sources | `@nebutra/ui/styles/sources.css` | Tailwind `@source` for CVA classes (owned by UI package) |
-| UI preset | `@nebutra/ui/styles/preset.css` | tailwind + tokens + sources + fonts |
-
-Tokens alone never style `Input`/`Button` — utilities come from scanning UI.
-
-Tokens are organized in three concentric rings:
-
-```
-Brand scales (raw)            → --nebutra-blue-{50..950}, --nebutra-cyan-{50..950}, --nebutra-neutral-{50..950}
-12-step semantic scales       → --neutral-{1..12}, --blue-{1..12}, --cyan-{1..12}
-Aliased semantic tokens       → --background, --foreground, --primary, --brand-primary, --status-*
-```
-
----
-
-## 2. Tokens
-
-### 2.1 Brand color scales (locked anchors)
-
-#### 云毓蓝 (`--nebutra-blue-*`)
-
-| Step | Hex |
-|------|-----|
-| 50 | `#F0F4FF` |
-| 100 | `#DBE4FF` |
-| 200 | `#BAC8FF` |
-| 300 | `#91A7FF` |
-| 400 | `#5C7CFA` |
-| **500** | **`#0033FE`** (base) |
-| 600 | `#002AD4` |
-| 700 | `#0021AB` |
-| 800 | `#001882` |
-| 900 | `#000F59` |
-| 950 | `#000830` |
-
-#### 云毓青 (`--nebutra-cyan-*`)
-
-| Step | Hex |
-|------|-----|
-| 50 | `#E6FFF8` |
-| 100 | `#B3FFEC` |
-| 200 | `#80FFE0` |
-| 300 | `#4DFCD4` |
-| 400 | `#1AF7C8` |
-| **500** | **`#0BF1C3`** (base) |
-| 600 | `#09C9A3` |
-| 700 | `#07A183` |
-| 800 | `#057963` |
-| 900 | `#035143` |
-| 950 | `#012923` |
-
-#### Neutral (blue-undertone slate; `--nebutra-neutral-*`)
-
-| Step | Hex |
-|------|-----|
-| 50 | `#F8FAFC` |
-| 100 | `#F1F5F9` |
-| 200 | `#E2E8F0` |
-| 300 | `#CBD5E1` |
-| 400 | `#94A3B8` |
-| 500 | `#64748B` |
-| 600 | `#475569` |
-| 700 | `#334155` |
-| 800 | `#1E293B` |
-| 900 | `#0F172A` |
-| 950 | `#020617` |
-
-> Wide-gamut: when the display supports `display-p3`, `--nebutra-brand-blue` and `--nebutra-brand-cyan` upgrade automatically to richer P3 values (`color(display-p3 …)` syntax).
-
-### 2.2 12-step functional scales — semantic ladder
-
-Each scale obeys this Geist-style mapping:
-
-| Steps | Role |
-|-------|------|
-| 1–2 | Backgrounds (app, subtle) |
-| 3–5 | Component bg (default / hover / active) |
-| 6–8 | Borders (subtle / default / hover) |
-| 9–10 | Solid fills (default / hover) |
-| 11 | Low-contrast / secondary text |
-| 12 | High-contrast / primary text |
-
-Scales: `--neutral-{1..12}`, `--blue-{1..12}`, `--cyan-{1..12}`. Light values are derived from the brand scales above; dark values invert the order so `step 1 = darkest, step 12 = lightest`. Full mapping table is in [root DESIGN.md §2.1](../../DESIGN.md#21-color--12-step-functional-scales).
-
-### 2.3 Brand aliases (canonical for app code)
-
-| Token | Resolves to | Use |
-|-------|-------------|-----|
-| `--brand-primary` | `var(--blue-9)` → `#0033FE` | Primary brand |
-| `--brand-accent` | `var(--cyan-9)` → `#0BF1C3` | Accent |
-| `--brand-tertiary` | `#8B5CF6` | Data viz / infra tags only |
-| `--primary` | `228 85% 56%` → soft blue for UI | **Canonical product CTA** (`bg-primary`, `Button` default) |
-| `--brand-primary` | `#0033FE` | VI 云毓蓝 — logo / identity |
-| `--brand-gradient` | `hsl(var(--primary))` | **Legacy alias of `--primary`**, not a separate color. Prefer `Button` / `bg-primary`. |
-| `--brand-gradient-logo` | `linear-gradient(135deg, #0033FE → #00A2E9 → #0BF1C3)` | Logo/VI only (OKLab mid stop) |
-
-**CTA rule:** use existing `@nebutra/ui` `Button` (`bg-primary`). Do not invent parallel “action” colors. `#0033FE` is identity; UI softens via `--primary` already defined in `themes/light.json`.
-
-**Logo gradient / dirty-mid rule:** `--brand-gradient-logo` must keep **three hex stops** ending in `#0033fe` → `#00a2e9` → `#0bf1c3` (see `semantic.json` + `verify-brand-token-sync`). Mid `#00a2e9` is the OKLab midpoint — prevents soft/gray mids on large VI surfaces. Product chrome must not reintroduce multi-stop blue→cyan as button fills. Full guidance: [`packages/design/brand/DESIGN.md` §2.2](../brand/DESIGN.md#22-brand-gradient).
-
-### 2.4 Semantic theme tokens (HSL triplets — Tailwind compatible)
-
-These are stored as space-separated HSL triplets so Tailwind v4 can consume them via `hsl(var(--token))`.
-
-| Token | Light value | Dark value | Tailwind class |
-|------|-------------|-----------|---------------|
-| `--background` | `0 0% 100%` | `222 47% 4%` | `bg-background` |
-| `--foreground` | `222 47% 11%` | `210 40% 98%` | `text-foreground` |
-| `--card` | `0 0% 100%` | `222 47% 7%` | `bg-card` |
-| `--popover` | `0 0% 100%` | `222 47% 7%` | `bg-popover` |
-| `--primary` | `228 85% 56%` | `228 90% 72%` | `bg-primary` |
-| `--secondary` | `210 40% 96%` | `217 33% 17%` | `bg-secondary` |
-| `--muted` | `210 40% 96%` | `217 33% 17%` | `bg-muted` |
-| `--accent` | `228 100% 97%` | `228 100% 12%` | `bg-accent` |
-| `--destructive` | `0 84% 45%` | `0 63% 31%` | `bg-destructive` |
-| `--success` | `142 71% 29%` | `142 76% 36%` | `bg-success` |
-| `--warning` | `38 92% 50%` | `38 80% 45%` | `bg-warning` |
-| `--info` | `228 100% 50%` | `228 95% 67%` | `bg-info` |
-| `--border` | `240 5.9% 90%` | `217 33% 17%` | `border-border` |
-| `--ring` | `228 100% 50%` | `228 95% 67%` | `ring-ring` |
-
-### 2.5 Status colors (direct hex — for SVG, charts, inline)
-
-| Token | Hex |
-|-------|-----|
-| `--status-danger` | `#EF4444` |
-| `--status-warning` | `#F59E0B` |
-| `--status-success` | `#10B981` |
-| `--status-info` | `var(--brand-primary)` |
-
-### 2.6 Geist DS scale (interop with 21st.dev / Geist components)
-
-`--ds-blue-{200,700,900}`, `--ds-red-*`, `--ds-amber-*`, `--ds-green-*`, `--ds-teal-*`, `--ds-purple-*`, `--ds-pink-*`, `--ds-gray-{100..1000}`, `--ds-background-100`, plus accent gradients `--ds-trial-*`, `--ds-turbo-*`. Stored as oklch (with sRGB hsla fallback for legacy engines).
-
-### 2.7 Layout containers
-
-| Token | Value |
-|-------|-------|
-| `--container-text` | `896px` |
-| `--container-content` | `1152px` |
-| `--container-wide` | `1400px` |
-
-### 2.8 Radius scale
-
-```
---radius-none: 0
---radius-sm:   0.25rem  (4px)
---radius-md:   0.375rem (6px)   ← default --radius
---radius-lg:   0.5rem   (8px)
---radius-xl:   0.75rem  (12px)
---radius-2xl:  1rem     (16px)
---radius-3xl:  1.5rem   (24px)
---radius-full: 9999px
-```
-
-### 2.9 Elevation / shadow
-
-| Token | Light | Dark |
-|------|-------|------|
-| `--elevation-xs` | `0 1px 2px 0 rgb(0 0 0 / 0.05)` | `0 1px 2px 0 rgb(0 0 0 / 0.3)` |
-| `--elevation-sm` | small card shadow | higher-contrast variant |
-| `--elevation-md` | dropdown shadow | — |
-| `--elevation-lg` | floating panel | — |
-| `--elevation-xl` | modal | — |
-| `--elevation-2xl` | top overlay | — |
-| `--elevation-brand` | `0 0 0 1px rgb(0 51 254 / 0.15), 0 4px 20px -2px rgb(0 51 254 / 0.2)` | uses `#5C7CFA` glow |
-| `--elevation-brand-lg` | hero CTA | hero CTA dark |
-
-Aliased to Tailwind: `shadow-{xs,sm,md,lg,xl,2xl,brand,brand-lg}`.
-
-### 2.10 Motion
-
-Easing:
-
-```
---ease-in:      cubic-bezier(0.4, 0, 1, 1)
---ease-out:     cubic-bezier(0, 0, 0.2, 1)
---ease-in-out:  cubic-bezier(0.4, 0, 0.2, 1)
---ease-spring:  cubic-bezier(0.175, 0.885, 0.32, 1.275)
-```
-
-Duration:
-
-```
---duration-micro:      100ms   /* hover, focus, toggle, button press */
---duration-flow:       200ms   /* modal, dropdown, tab — default */
---duration-reveal:     300ms   /* slide, expand, accordion, drawer */
---duration-cinematic:  500ms   /* hero entrance, big delight */
-```
-
-Reduced motion: a global `@media (prefers-reduced-motion: reduce)` block in `styles.css` collapses all animation/transition durations to `0.01ms`.
-
-### 2.11 Typography utilities
-
-Geist-style named utilities defined via Tailwind v4 `@utility`. Naming pattern: `text-{role}-{px}[-strong|-mono|-tabular]`.
-
-| Role | Sizes (px) |
-|------|-----------|
-| `text-heading-{px}` | 72, 64, 56, 48, 40, 32, 24, 20, 16, 14 |
-| `text-button-{px}` | 16, 14, 12 |
-| `text-label-{px}[-strong/-mono/-tabular]` | 20, 18, 16, 14, 13, 12 |
-| `text-copy-{px}[-strong/-mono]` | 24, 20, 18, 16, 14, 13 |
-
-Plus `font-cn` (CJK utility, `line-height: 1.75`, word-break-aware). Auto-activates on `<html lang="zh|ja|ko">`.
-
-### 2.12 Chart colors
-
-`--chart-{1..5}` — light: blue-500, cyan-500, purple, cyan-300, blue-700. Dark: brighter equivalents.
-
----
-
-## 3. Patterns
-
-### 3.1 Tailwind class usage (canonical)
-
-```tsx
-// 12-step scale classes
-<div className="bg-neutral-3 text-neutral-12 border-neutral-7" />
-<div className="bg-blue-9 text-cyan-11" />
-
-// Semantic Tailwind classes
-<div className="bg-primary text-primary-foreground" />
-<div className="bg-destructive text-destructive-foreground" />
-
-// Brand aliases
-<div className="bg-brand-primary text-brand-accent" />
-
-// Inline CSS variables (for SVG, recharts, dynamic values)
-<stop stopColor="var(--brand-primary)" />
-<Cell fill="var(--brand-accent)" />
-<div style={{ background: "var(--brand-gradient)" }} />
-
-// Arbitrary Tailwind for non-scale tokens
-<div className="text-[color:var(--status-warning)]" />
-```
-
-### 3.2 ThemeProvider wiring (per app)
-
-```tsx
-// apps/{app}/src/app/layout.tsx
-import { ThemeProvider } from "@nebutra/tokens";
-
-<html lang="en" suppressHydrationWarning>
-  <body>
-    <ThemeProvider attribute="class" defaultTheme="system" enableSystem>
-      {children}
-    </ThemeProvider>
-  </body>
-</html>
-```
-
----
-
-## 4. Imports & Conventions
-
-### Allowed
-
-```ts
-import { ThemeProvider, useTheme } from "@nebutra/tokens";
-```
-
-```css
-@import "@nebutra/tokens/styles.css";
-```
-
-### Forbidden
-
-```tsx
-// ❌ Hardcoded brand hex
-<div style={{ color: "#0033FE" }} />
-
-// ❌ Importing JS color tokens in runtime
-import { colors } from "@nebutra/ui/theme";  // deprecated
-
-// ❌ Adding raw hex into Tailwind arbitrary classes for brand colors
-<div className="bg-[#0a0a0a]" />   // → bg-neutral-1
-```
-
----
-
-## 5. Theming
-
-Light/dark switching: handled by `@nebutra/tokens` `ThemeProvider` via the `class` attribute (`class="dark"`). The `.dark` selector inside `styles.css` (generated from design-tokens) overrides every semantic token plus inverts the 12-step scales (step 1 = darkest, step 12 = lightest in dark mode).
-
-For **design-language swap** (Brand Packages / `applyLanguage`), see [`packages/design/theme/DESIGN.md`](../theme/DESIGN.md).
-
----
-
-## 6. Versioning & Governance
-
-| Surface | Status |
-|--------|--------|
-| Brand color hex anchors (`#0033FE`, `#0BF1C3`, `--nebutra-neutral-{50..950}`) | **Locked** |
-| UI CTA color | Use `--primary` / `Button`; `--brand-gradient` is a legacy alias of `--primary` |
-| 12-step semantic ladder positions (1–12 meaning) | **Locked** |
-| Container widths | **Locked** |
-| Radius scale values | **Locked** |
-| Status color hex | **Locked** |
-| Adding a new semantic token | Extensible — must come with both light + dark values and Tailwind binding |
-| Adding a new typography utility | Extensible — must follow `text-{role}-{px}` naming |
-| Removing/renaming any token | **Forbidden** without a codemod (`scripts/codemod-tokens.ts`) |
-
-### Governance scripts
-
-```bash
-pnpm --filter @nebutra/tokens typecheck
-node scripts/codemod-tokens.ts                 # migrate hex → tokens
-pnpm tsx scripts/validate-ui-governance-policy.ts
-```
-
----
-
-## 7. Open questions / review notes
-
-- The HSL semantic tokens (`--primary` etc.) and the 12-step scales (`--blue-9` etc.) have separate value definitions. The `--primary` light value `228 85% 56%` (#254bfa) is intentionally *softer* than `--blue-9` (#0033FE) for Shadcn-style emphasis. Document this rationale once more in §2.4.
-- `--ds-*` Geist colors duplicate some 12-step scales — verify whether they can be consolidated when 21st.dev components are migrated.
-
----
-
-← back to [root DESIGN.md](../../DESIGN.md) ·
-peer specs: [brand](../brand/DESIGN.md) · [theme](../theme/DESIGN.md) · [ui](../ui/DESIGN.md)

package/scripts/compile-brand-run.ts

@@ -1,79 +0,0 @@
-import { mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
-import { basename, join, resolve } from "node:path";
-import { compileReferoTokens } from "../src/brand-package/index";
-
-function parseArgs(argv: string[]) {
-  let input: string | null = null;
-  let id: string | undefined;
-  let name: string | undefined;
-  let out: string | undefined;
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a === "--id") id = argv[++i];
-    else if (a === "--name") name = argv[++i];
-    else if (a === "--out") out = argv[++i];
-    else if (!a.startsWith("-")) input = resolve(a);
-  }
-  return { input, id, name, out };
-}
-
-const args = parseArgs(process.argv.slice(2));
-if (!args.input) {
-  process.stderr.write(
-    "Usage: compile-brand.mjs <dir|tokens.json> [--id id] [--name name] [--out dir]\n",
-  );
-  process.exit(1);
-}
-
-const st = statSync(args.input);
-let tokens: Record<string, unknown>;
-let designMd = "";
-let hintId = "custom";
-
-if (st.isDirectory()) {
-  const tokensPath = join(args.input, "tokens.json");
-  try {
-    tokens = JSON.parse(readFileSync(tokensPath, "utf8"));
-  } catch {
-    throw new Error(`No tokens.json in ${args.input}`);
-  }
-  const designPath = join(args.input, "DESIGN.md");
-  try {
-    designMd = readFileSync(designPath, "utf8");
-  } catch {
-    designMd = "";
-  }
-  hintId = basename(args.input).toLowerCase();
-} else {
-  tokens = JSON.parse(readFileSync(args.input, "utf8"));
-  hintId = basename(args.input, ".json").toLowerCase();
-}
-
-const result = compileReferoTokens({
-  tokens,
-  designMd,
-  id: args.id ?? hintId,
-  name: args.name,
-});
-
-const packageRoot = resolve(import.meta.dirname, "..");
-const outDir = args.out ? resolve(args.out) : join(packageRoot, "brands", result.brand.id);
-mkdirSync(outDir, { recursive: true });
-// brand.json is SSOT — skin CSS only under skins/<id>.css (via emit-skins)
-writeFileSync(join(outDir, "brand.json"), `${JSON.stringify(result.brand, null, 2)}\n`);
-mkdirSync(join(packageRoot, "skins"), { recursive: true });
-writeFileSync(join(packageRoot, "skins", `${result.brand.id}.css`), result.css);
-
-process.stdout.write(
-  `${JSON.stringify(
-    {
-      out: outDir,
-      id: result.brand.id,
-      recipe: result.brand.recipe.buttonDefault,
-      warnings: result.warnings,
-      note: "brand.json is SSOT; re-run emit-skins after hand-edits to brand.json",
-    },
-    null,
-    2,
-  )}\n`,
-);

package/scripts/compile-brand.mjs

@@ -1,25 +0,0 @@
-#!/usr/bin/env node
-/**
- * Compile Refero export → Brand Package + skin CSS
- *
- *   node packages/design/tokens/scripts/compile-brand.mjs ~/Desktop/GSAP --id gsap
- */
-import { spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-const repoRoot = resolve(packageRoot, "../../..");
-const tsx = join(repoRoot, "node_modules/.bin/tsx");
-const runner = join(packageRoot, "scripts/compile-brand-run.ts");
-
-const r = spawnSync(
-  existsSync(tsx) ? tsx : "npx",
-  existsSync(tsx) ? [runner, ...process.argv.slice(2)] : ["tsx", runner, ...process.argv.slice(2)],
-  {
-    stdio: "inherit",
-    cwd: packageRoot,
-  },
-);
-process.exit(r.status ?? 1);

package/scripts/emit-skins-run.ts

@@ -1,62 +0,0 @@
-/**
- * Re-emit all skin CSS files from brands/<id>/brand.json (SSOT).
- */
-import { spawnSync } from "node:child_process";
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
-import { join, resolve } from "node:path";
-import { emitBrandCss, normalizeBrandPackage } from "../src/brand-package/index.ts";
-
-const packageRoot = resolve(import.meta.dirname, "..");
-const repoRoot = resolve(packageRoot, "../../..");
-const brandsDir = join(packageRoot, "brands");
-const skinsDir = join(packageRoot, "skins");
-const biomeBin = join(repoRoot, "node_modules/.bin/biome");
-
-if (!existsSync(brandsDir)) {
-  throw new Error(`Missing brands dir: ${brandsDir}`);
-}
-
-mkdirSync(skinsDir, { recursive: true });
-
-const ids = readdirSync(brandsDir, { withFileTypes: true })
-  .filter((d) => d.isDirectory())
-  .map((d) => d.name)
-  .sort();
-
-const written: string[] = [];
-const cssPaths: string[] = [];
-
-for (const id of ids) {
-  const brandPath = join(brandsDir, id, "brand.json");
-  if (!existsSync(brandPath)) {
-    process.stderr.write(`skip ${id}: no brand.json\n`);
-    continue;
-  }
-  const raw = JSON.parse(readFileSync(brandPath, "utf8"));
-  const brand = normalizeBrandPackage({ ...raw, id: raw.id || id });
-  const css = emitBrandCss(brand, { mode: "global" });
-
-  // Single publish path: skins/<id>.css (no brands/<id>/skin.css mirror)
-  const outPath = join(skinsDir, `${brand.id}.css`);
-  writeFileSync(outPath, css);
-  cssPaths.push(outPath);
-  written.push(brand.id);
-}
-
-// Post-format so CI "governance lint guards" (biome check) stays green after
-// typecheck/build re-emits skins in the same workspace.
-if (cssPaths.length > 0 && existsSync(biomeBin)) {
-  const fmt = spawnSync(biomeBin, ["format", "--write", ...cssPaths], {
-    cwd: repoRoot,
-    encoding: "utf8",
-  });
-  if (fmt.status !== 0) {
-    process.stderr.write(fmt.stderr || fmt.stdout || "biome format failed on skins\n");
-    process.exit(fmt.status ?? 1);
-  }
-}
-
-process.stdout.write(
-  `emit-skins: ${written.length} skins from brand.json → skins/*.css\n` +
-    `  ${written.join(", ")}\n`,
-);

package/scripts/emit-skins.mjs

@@ -1,31 +0,0 @@
-#!/usr/bin/env node
-/**
- * Skin CSS SSOT pipeline.
- *
- * Source of truth: brands/<id>/brand.json
- * Generated (do not hand-edit):
- *   - skins/<id>.css   (single publish path for @import / cssImport)
- *
- * Catalog: packages/design/theme/skins.css via theme scripts/sync-skins.mjs
- *
- * Usage: node scripts/emit-skins.mjs
- */
-import { spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-const repoRoot = resolve(packageRoot, "../../..");
-const tsx = join(repoRoot, "node_modules/.bin/tsx");
-const runner = join(packageRoot, "scripts/emit-skins-run.ts");
-
-const r = spawnSync(
-  existsSync(tsx) ? tsx : "npx",
-  existsSync(tsx) ? [runner, ...process.argv.slice(2)] : ["tsx", runner, ...process.argv.slice(2)],
-  {
-    stdio: "inherit",
-    cwd: packageRoot,
-  },
-);
-process.exit(r.status ?? 1);

package/scripts/sync-styles.mjs

@@ -1,29 +0,0 @@
-import { execFileSync } from "node:child_process";
-import { copyFileSync, existsSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-const repoRoot = resolve(packageRoot, "..", "..", "..");
-const designTokensRoot = resolve(packageRoot, "..", "design-tokens");
-const generatedStylesPath = resolve(designTokensRoot, "build", "css", "styles.generated.css");
-const runtimeStylesPath = resolve(packageRoot, "styles.css");
-const biomeBin = resolve(
-  repoRoot,
-  "node_modules",
-  ".bin",
-  process.platform === "win32" ? "biome.cmd" : "biome",
-);
-
-if (!existsSync(generatedStylesPath)) {
-  throw new Error(
-    `Missing generated runtime token CSS at ${generatedStylesPath}. Run \`pnpm --filter @nebutra/design-tokens build\` before syncing @nebutra/tokens.`,
-  );
-}
-
-copyFileSync(generatedStylesPath, runtimeStylesPath);
-execFileSync(biomeBin, ["format", "--write", runtimeStylesPath], {
-  cwd: repoRoot,
-  stdio: "inherit",
-});
-process.stdout.write("styles.css refreshed from @nebutra/design-tokens\n");