@nebutra/theme 0.2.1 → 0.2.2

package/src/apply-language.ts

@@ -1,87 +0,0 @@
-/**
- * Runtime design-language switch — Create Center / SaaS global theme swap.
- *
- * Light/dark remains class="dark" on @nebutra/tokens ThemeProvider.
- * Design language is html[data-brand] + Brand Package CSS inject.
- *
- * Built-in languages load Brand Packages automatically; pass `package` only for
- * custom / compile-time packages (Create Center preview).
- */
-
-import {
-  type ApplyBrandOptions,
-  applyBrandPackage,
-  type BrandPackage,
-  clearBrand,
-  getActiveBrandId,
-  normalizeBrandPackage,
-  validateBrandPackage,
-} from "@nebutra/tokens/brand-package";
-import { getBuiltInBrandPackage } from "./built-in-packages";
-import { type DesignLanguageEntry, getLanguageById } from "./languages";
-
-export type { ApplyBrandOptions };
-
-export interface ApplyLanguageOptions extends ApplyBrandOptions {
-  /**
-   * Preloaded Brand Package (Create Center compile result or override).
-   * When omitted, built-in languages resolve from brands/<id>/brand.json.
-   */
-  package?: BrandPackage;
-}
-
-/**
- * Apply a design language by id.
- * - `factory` / unknown without package → clearBrand (tokens SSOT)
- * - built-in id without package → load shipped Brand Package
- * - with `package` → applyBrandPackage (full carrier swap)
- */
-export function applyLanguage(
-  languageId: string,
-  options: ApplyLanguageOptions = {},
-): DesignLanguageEntry | null {
-  const entry = getLanguageById(languageId);
-
-  if (!entry || entry.id === "factory" || entry.brandPath == null) {
-    if (options.package) {
-      const v = validateBrandPackage(options.package);
-      if (!v.ok) {
-        throw new Error(`Invalid Brand Package: ${v.errors.join("; ")}`);
-      }
-      applyBrandPackage(normalizeBrandPackage(options.package), options);
-      return entry ?? null;
-    }
-    clearBrand(options);
-    return entry ?? getLanguageById("factory") ?? null;
-  }
-
-  const pkg = options.package ?? getBuiltInBrandPackage(languageId);
-  if (!pkg) {
-    throw new Error(
-      `Language "${languageId}" has no built-in Brand Package and no options.package. ` +
-        `Load @nebutra/tokens/${entry.brandPath} or compileReferoTokens(), then ` +
-        `applyLanguage("${languageId}", { package }). ` +
-        `Or import the single skin CSS: ${entry.install.cssImport ?? "(none)"}.`,
-    );
-  }
-
-  const v = validateBrandPackage(pkg);
-  if (!v.ok) {
-    throw new Error(`Invalid Brand Package for ${languageId}: ${v.errors.join("; ")}`);
-  }
-  const normalized = normalizeBrandPackage({
-    ...pkg,
-    id: languageId,
-  });
-  applyBrandPackage(normalized, options);
-  return entry;
-}
-
-/** Restore factory product chrome (clear data-brand + injected skin). */
-export function clearLanguage(options: ApplyBrandOptions = {}): void {
-  clearBrand(options);
-}
-
-export function getActiveLanguageId(doc?: Document): string {
-  return getActiveBrandId(doc) ?? "factory";
-}

package/src/brand-package-surface.ts

@@ -1,30 +0,0 @@
-/**
- * Tooling / Create Center surface — compile + iframe preview + emit.
- * Prefer `@nebutra/tokens/brand-package` in new code; this re-export keeps
- * historical `@nebutra/theme` compile entry points without bloating the root.
- */
-
-export {
-  applyBrandCss,
-  applyBrandPackage,
-  applyBrandToIframe,
-  BRAND_STORAGE_KEY,
-  type BrandPackage,
-  type BrandPackageInput,
-  type BrandRecipe,
-  type BrandRecipeInput,
-  type CompileResult,
-  clearBrand,
-  compileReferoTokens,
-  type EmitBrandCssMode,
-  type EmitBrandCssOptions,
-  emitBrandCss,
-  emitGlobalSkinSelector,
-  getActiveBrandId,
-  normalizeBrandPackage,
-  restorePersistedBrand,
-  useBrand,
-  useBrandIframePreview,
-  type ValidationResult,
-  validateBrandPackage,
-} from "@nebutra/tokens/brand-package";

package/src/built-in-packages.generated.ts

@@ -1,39 +0,0 @@
-/**
- * AUTO-GENERATED by scripts/sync-languages.mjs — DO NOT EDIT.
- * Built-in Brand Packages for applyLanguage(id) without manual JSON import.
- * Source: packages/design/tokens/brands/<id>/brand.json
- */
-
-import { type BrandPackage, normalizeBrandPackage } from "@nebutra/tokens/brand-package";
-import gsap from "@nebutra/tokens/brands/gsap/brand.json" with { type: "json" };
-import linear from "@nebutra/tokens/brands/linear/brand.json" with { type: "json" };
-import notion from "@nebutra/tokens/brands/notion/brand.json" with { type: "json" };
-import raycast from "@nebutra/tokens/brands/raycast/brand.json" with { type: "json" };
-import stripe from "@nebutra/tokens/brands/stripe/brand.json" with { type: "json" };
-import vanta from "@nebutra/tokens/brands/vanta/brand.json" with { type: "json" };
-import vercel from "@nebutra/tokens/brands/vercel/brand.json" with { type: "json" };
-
-const RAW_BUILT_IN: Record<string, BrandPackage> = {
-  gsap: gsap as BrandPackage,
-  linear: linear as BrandPackage,
-  notion: notion as BrandPackage,
-  raycast: raycast as BrandPackage,
-  stripe: stripe as BrandPackage,
-  vanta: vanta as BrandPackage,
-  vercel: vercel as BrandPackage,
-};
-
-/** Normalized package for a shipped design-language id, or undefined. */
-export function getBuiltInBrandPackage(id: string): BrandPackage | undefined {
-  const raw = RAW_BUILT_IN[id];
-  if (!raw) return undefined;
-  return normalizeBrandPackage({ ...raw, id });
-}
-
-export function listBuiltInBrandIds(): string[] {
-  return Object.keys(RAW_BUILT_IN);
-}
-
-export function hasBuiltInBrandPackage(id: string): boolean {
-  return id in RAW_BUILT_IN;
-}

package/src/built-in-packages.ts

@@ -1,14 +0,0 @@
-/**
- * Built-in Brand Packages for design-language ids.
- *
- * Implementation is AUTO-GENERATED — see built-in-packages.generated.ts
- * (pnpm --filter @nebutra/theme sync:languages).
- *
- * SSOT remains packages/design/tokens/brands/<id>/brand.json.
- */
-
-export {
-  getBuiltInBrandPackage,
-  hasBuiltInBrandPackage,
-  listBuiltInBrandIds,
-} from "./built-in-packages.generated";

package/src/client.ts

@@ -1,35 +0,0 @@
-/**
- * Explicit client entry — same lean surface as package root.
- * Use: `import { applyLanguage } from "@nebutra/theme/client"`
- *
- * Light/dark: `import { ThemeProvider, useTheme } from "@nebutra/tokens"`
- */
-
-export {
-  applyBrandPackage,
-  type BrandPackage,
-  clearBrand,
-  normalizeBrandPackage,
-} from "@nebutra/tokens/brand-package";
-export {
-  type ApplyLanguageOptions,
-  applyLanguage,
-  clearLanguage,
-  getActiveLanguageId,
-} from "./apply-language";
-export {
-  getBuiltInBrandPackage,
-  hasBuiltInBrandPackage,
-  listBuiltInBrandIds,
-} from "./built-in-packages";
-export {
-  BUILT_IN_LANGUAGE_IDS,
-  DEFAULT_LANGUAGE,
-  type DesignLanguageEntry,
-  type DesignLanguageRegistry,
-  getLanguageById,
-  isLanguageId,
-  LANGUAGE_IDS,
-  LANGUAGE_REGISTRY,
-  listSkinLanguages,
-} from "./languages";

package/src/index.ts

@@ -1,53 +0,0 @@
-/**
- * @nebutra/theme — Design-language switch surface (client-safe root)
- *
- * Root exports are intentionally lean for app bundles:
- *   applyLanguage / LANGUAGE_REGISTRY / built-in packages
- *
- * Light/dark ThemeProvider: import from `@nebutra/tokens` only (not here).
- *
- * Compile & Create Center tooling:
- *   @nebutra/tokens/brand-package  (preferred)
- *   @nebutra/theme/brand-package   (re-export alias)
- *
- * Layers:
- *   @nebutra/tokens  product chrome SSOT (styles.css + recipe.css + ThemeProvider)
- *   @nebutra/theme   LANGUAGE_REGISTRY + applyLanguage + skins.css
- */
-
-// Re-export apply helpers used with applyLanguage({ package })
-export {
-  type ApplyBrandOptions,
-  applyBrandPackage,
-  type BrandPackage,
-  clearBrand,
-  getActiveBrandId,
-  normalizeBrandPackage,
-  type ValidationResult,
-  validateBrandPackage,
-} from "@nebutra/tokens/brand-package";
-export {
-  type ApplyLanguageOptions,
-  applyLanguage,
-  clearLanguage,
-  getActiveLanguageId,
-} from "./apply-language";
-export {
-  getBuiltInBrandPackage,
-  hasBuiltInBrandPackage,
-  listBuiltInBrandIds,
-} from "./built-in-packages";
-export {
-  BUILT_IN_LANGUAGE_IDS,
-  DEFAULT_LANGUAGE,
-  type DesignLanguageCompatibility,
-  type DesignLanguageEntry,
-  type DesignLanguageInstall,
-  type DesignLanguageRegistry,
-  getLanguageById,
-  isLanguageId,
-  LANGUAGE_IDS,
-  LANGUAGE_REGISTRY,
-  type LanguageId,
-  listSkinLanguages,
-} from "./languages";

package/src/languages.meta.json

@@ -1,62 +0,0 @@
-{
-  "$comment": "Human catalog metadata for design languages. Merged with brands/*/brand.json by scripts/sync-languages.mjs → languages.json (AUTO-GENERATED).",
-  "version": "2026.07",
-  "defaultLanguage": "factory",
-  "description": "Design-language catalog for global product chrome swap (Create Center / SaaS theme). Not color moods — full Brand Packages (roles + recipe + elev + zones).",
-  "factory": {
-    "name": "Nebutra Factory",
-    "description": "Default product chrome from @nebutra/tokens (no skin). Clear data-brand to restore.",
-    "proves": ["factory HSL SSOT", "recipe defaults", "action≡brand-mark until skin"],
-    "darkDefault": true
-  },
-  "languages": {
-    "linear": {
-      "description": "Dual-mode: dark void default + light paper; solid acid-lime CTA, compact density.",
-      "proves": ["chromatic solid action", "dark product chrome", "dual-mode light/dark palettes"]
-    },
-    "gsap": {
-      "description": "Dark cream-on-void; shockingly-green is accent — CTA is gradient-stroke/outline, not solid green fill.",
-      "proves": [
-        "outline / gradient-stroke recipe",
-        "category extensions",
-        "marketing display zone"
-      ]
-    },
-    "raycast": {
-      "description": "Neutral Mist/Iron filled CTA; Coral is brand-mark only. Key elevation stack.",
-      "proves": ["action ≠ brand-mark", "elevation=key free CSS"]
-    },
-    "vercel": {
-      "description": "Monochrome dual-mode: light paper + Obsidian CTA; dark carbon + white CTA; hairline elevation (no chromatic CTA).",
-      "proves": ["light monochrome action", "elevation=hairline", "dual-mode light/dark palettes"]
-    },
-    "vanta": {
-      "description": "Editorial violet on parchment; Vivid Violet action ≠ Indigo Ink brand-mark; full pills; elevation=none (carbon hairlines).",
-      "proves": [
-        "action ≠ brand-mark (chromatic)",
-        "elevation=none border-only",
-        "999px pill controls",
-        "serif display + sans UI zones"
-      ]
-    },
-    "stripe": {
-      "description": "Indigo-ink ledger on frost glass; Indigo action ≠ Midnight brand-mark; 4px controls; elevation=none (tint + frost rules).",
-      "proves": [
-        "action ≠ brand-mark (chromatic indigo vs midnight)",
-        "elevation=none tint-ladder depth",
-        "4px squared controls (not pill)",
-        "whisper heading weight 300"
-      ]
-    },
-    "notion": {
-      "description": "Warm paper notebook; Notion Blue sole filled CTA ≠ Ink brand-mark; 8px buttons / 12px cards; elev=none + hairline; accent hues decorative only.",
-      "proves": [
-        "action ≠ brand-mark (blue vs ink)",
-        "canvas≠card (paper-warmth vs pure-white)",
-        "elevation=none content cards + raised nav shadow slot",
-        "table radius priority (8/12 over tertiary 4px)",
-        "decorative accents never product CTA"
-      ]
-    }
-  }
-}

package/src/languages.ts

@@ -1,70 +0,0 @@
-/**
- * Design-language catalog — the real product surface of @nebutra/theme.
- *
- * A "language" is a full Brand Package (roles + recipe + elev + zones), proven by
- * external DS stress tests (Linear / GSAP / Raycast / Vercel / Vanta / Stripe / Notion).
- * Swapping `html[data-brand]` (or applyLanguage) recolors product chrome without
- * call-site edits.
- *
- * Multi-mood oklch catalog was removed. Use LANGUAGE_REGISTRY / isLanguageId only.
- */
-
-/** Generated by scripts/sync-languages.mjs from brands + languages.meta.json */
-import languagesJson from "./languages.json" with { type: "json" };
-
-export interface DesignLanguageInstall {
-  command: string;
-  /** Single-skin import for demos; null for factory */
-  cssImport: string | null;
-}
-
-export interface DesignLanguageCompatibility {
-  tailwind: "4";
-  cssVariables: boolean;
-  brandPackage: boolean;
-  dataBrand: boolean;
-}
-
-export interface DesignLanguageEntry {
-  id: string;
-  name: string;
-  kind: "design-language";
-  description: string;
-  /** Contract proofs this fixture exercises */
-  proves: string[];
-  darkDefault: boolean;
-  /** Relative to @nebutra/tokens package root; null = factory (no override) */
-  brandPath: string | null;
-  skinPath: string | null;
-  install: DesignLanguageInstall;
-  compatibility: DesignLanguageCompatibility;
-}
-
-export interface DesignLanguageRegistry {
-  $schema: string;
-  version: string;
-  defaultLanguage: string;
-  description: string;
-  languages: DesignLanguageEntry[];
-}
-
-export const LANGUAGE_REGISTRY = languagesJson as DesignLanguageRegistry;
-export const LANGUAGE_IDS = LANGUAGE_REGISTRY.languages.map((l) => l.id);
-export const DEFAULT_LANGUAGE = LANGUAGE_REGISTRY.defaultLanguage;
-/** Alias — “theme” in product speak = design language */
-export const BUILT_IN_LANGUAGE_IDS = LANGUAGE_IDS;
-
-export type LanguageId = string;
-
-export function isLanguageId(id: string): boolean {
-  return LANGUAGE_IDS.includes(id);
-}
-
-export function getLanguageById(id: string): DesignLanguageEntry | undefined {
-  return LANGUAGE_REGISTRY.languages.find((l) => l.id === id);
-}
-
-/** Fixture languages that ship a Brand Package (excludes factory). */
-export function listSkinLanguages(): DesignLanguageEntry[] {
-  return LANGUAGE_REGISTRY.languages.filter((l) => l.brandPath != null);
-}

package/src/registry.json

@@ -1,7 +0,0 @@
-{
-  "$schema": "https://nebutra.com/schemas/theme-registry.json",
-  "version": "2026.07",
-  "defaultTheme": "factory",
-  "themes": [],
-  "notes": "FROZEN empty mood list. Design languages: languages.json. Do not add themes here."
-}

package/tsconfig.json

@@ -1,10 +0,0 @@
-{
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "jsx": "react-jsx",
-    "outDir": "dist",
-    "rootDir": "src"
-  },
-  "include": ["src"],
-  "exclude": ["node_modules", "dist"]
-}

package/turbo.json

@@ -1,25 +0,0 @@
-{
-  "extends": ["//"],
-  "tasks": {
-    "build": {
-      "dependsOn": ["@nebutra/design-tokens#build", "@nebutra/tokens#build"],
-      "inputs": [
-        "$TURBO_EXTENDS$",
-        "scripts/sync-skins.mjs",
-        "scripts/sync-languages.mjs",
-        "src/languages.meta.json",
-        "../tokens/brands/**",
-        "../tokens/skins/**",
-        "../tokens/scripts/emit-skins.mjs",
-        "../tokens/scripts/emit-skins-run.ts"
-      ],
-      "outputs": [
-        "skins.css",
-        "keyframes.css",
-        "themes.css",
-        "src/languages.json",
-        "src/built-in-packages.generated.ts"
-      ]
-    }
-  }
-}