@nebutra/theme 0.1.1 → 0.2.0

package/src/languages.json

@@ -0,0 +1,188 @@
+{
+  "$schema": "https://nebutra.com/schemas/design-language-registry.json",
+  "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).",
+  "languages": [
+    {
+      "id": "factory",
+      "name": "Nebutra Factory",
+      "kind": "design-language",
+      "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,
+      "brandPath": null,
+      "skinPath": null,
+      "install": {
+        "command": "nebutra theme use factory",
+        "cssImport": null
+      },
+      "compatibility": {
+        "tailwind": "4",
+        "cssVariables": true,
+        "brandPackage": true,
+        "dataBrand": true
+      }
+    },
+    {
+      "id": "gsap",
+      "name": "GSAP",
+      "kind": "design-language",
+      "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"
+      ],
+      "darkDefault": true,
+      "brandPath": "brands/gsap/brand.json",
+      "skinPath": "skins/gsap.css",
+      "install": {
+        "command": "nebutra theme use gsap",
+        "cssImport": "@nebutra/tokens/skins/gsap.css"
+      },
+      "compatibility": {
+        "tailwind": "4",
+        "cssVariables": true,
+        "brandPackage": true,
+        "dataBrand": true
+      }
+    },
+    {
+      "id": "linear",
+      "name": "Linear",
+      "kind": "design-language",
+      "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"],
+      "darkDefault": true,
+      "brandPath": "brands/linear/brand.json",
+      "skinPath": "skins/linear.css",
+      "install": {
+        "command": "nebutra theme use linear",
+        "cssImport": "@nebutra/tokens/skins/linear.css"
+      },
+      "compatibility": {
+        "tailwind": "4",
+        "cssVariables": true,
+        "brandPackage": true,
+        "dataBrand": true
+      }
+    },
+    {
+      "id": "notion",
+      "name": "Notion",
+      "kind": "design-language",
+      "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"
+      ],
+      "darkDefault": false,
+      "brandPath": "brands/notion/brand.json",
+      "skinPath": "skins/notion.css",
+      "install": {
+        "command": "nebutra theme use notion",
+        "cssImport": "@nebutra/tokens/skins/notion.css"
+      },
+      "compatibility": {
+        "tailwind": "4",
+        "cssVariables": true,
+        "brandPackage": true,
+        "dataBrand": true
+      }
+    },
+    {
+      "id": "raycast",
+      "name": "Raycast",
+      "kind": "design-language",
+      "description": "Neutral Mist/Iron filled CTA; Coral is brand-mark only. Key elevation stack.",
+      "proves": ["action ≠ brand-mark", "elevation=key free CSS"],
+      "darkDefault": true,
+      "brandPath": "brands/raycast/brand.json",
+      "skinPath": "skins/raycast.css",
+      "install": {
+        "command": "nebutra theme use raycast",
+        "cssImport": "@nebutra/tokens/skins/raycast.css"
+      },
+      "compatibility": {
+        "tailwind": "4",
+        "cssVariables": true,
+        "brandPackage": true,
+        "dataBrand": true
+      }
+    },
+    {
+      "id": "stripe",
+      "name": "Stripe",
+      "kind": "design-language",
+      "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"
+      ],
+      "darkDefault": false,
+      "brandPath": "brands/stripe/brand.json",
+      "skinPath": "skins/stripe.css",
+      "install": {
+        "command": "nebutra theme use stripe",
+        "cssImport": "@nebutra/tokens/skins/stripe.css"
+      },
+      "compatibility": {
+        "tailwind": "4",
+        "cssVariables": true,
+        "brandPackage": true,
+        "dataBrand": true
+      }
+    },
+    {
+      "id": "vanta",
+      "name": "Vanta",
+      "kind": "design-language",
+      "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"
+      ],
+      "darkDefault": false,
+      "brandPath": "brands/vanta/brand.json",
+      "skinPath": "skins/vanta.css",
+      "install": {
+        "command": "nebutra theme use vanta",
+        "cssImport": "@nebutra/tokens/skins/vanta.css"
+      },
+      "compatibility": {
+        "tailwind": "4",
+        "cssVariables": true,
+        "brandPackage": true,
+        "dataBrand": true
+      }
+    },
+    {
+      "id": "vercel",
+      "name": "Vercel",
+      "kind": "design-language",
+      "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"],
+      "darkDefault": false,
+      "brandPath": "brands/vercel/brand.json",
+      "skinPath": "skins/vercel.css",
+      "install": {
+        "command": "nebutra theme use vercel",
+        "cssImport": "@nebutra/tokens/skins/vercel.css"
+      },
+      "compatibility": {
+        "tailwind": "4",
+        "cssVariables": true,
+        "brandPackage": true,
+        "dataBrand": true
+      }
+    }
+  ]
+}

package/src/languages.meta.json

@@ -0,0 +1,62 @@
+{
+  "$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

@@ -0,0 +1,70 @@
+/**
+ * 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,199 +1,7 @@
 {
   "$schema": "https://nebutra.com/schemas/theme-registry.json",
-  "version": "2026.05",
-  "defaultTheme": "neon",
-  "themes": [
-    {
-      "id": "neon",
-      "name": "Neon",
-      "category": "ai-native",
-      "mood": "AI SaaS default - dark, electric, high contrast",
-      "tokenPath": "tokens/themes/neon.json",
-      "install": {
-        "command": "nebutra theme add neon",
-        "registryUrl": "https://ui.nebutra.com/themes/neon.json"
-      },
-      "compatibility": {
-        "tailwind": "4",
-        "cssVariables": true,
-        "figmaVariables": true,
-        "shadcnRegistry": true
-      },
-      "governance": {
-        "wcag": "AA",
-        "requiredTokens": [
-          "color.primary",
-          "color.primary-foreground",
-          "color.background",
-          "color.foreground",
-          "color.card",
-          "color.border",
-          "color.ring",
-          "radius.md",
-          "fontFamily.sans"
-        ],
-        "visualSuites": ["forms", "pricing", "dashboard", "ai-chat", "charts"]
-      }
-    },
-    {
-      "id": "gradient",
-      "name": "Gradient",
-      "category": "marketing",
-      "mood": "Growth and marketing - bright, polished, conversion-oriented",
-      "tokenPath": "tokens/themes/gradient.json",
-      "install": {
-        "command": "nebutra theme add gradient",
-        "registryUrl": "https://ui.nebutra.com/themes/gradient.json"
-      },
-      "compatibility": {
-        "tailwind": "4",
-        "cssVariables": true,
-        "figmaVariables": true,
-        "shadcnRegistry": true
-      },
-      "governance": {
-        "wcag": "AA",
-        "requiredTokens": [
-          "color.primary",
-          "color.primary-foreground",
-          "color.background",
-          "color.foreground",
-          "color.card",
-          "color.border",
-          "color.ring",
-          "radius.md",
-          "fontFamily.sans"
-        ],
-        "visualSuites": ["forms", "pricing", "dashboard", "ai-chat", "charts"]
-      }
-    },
-    {
-      "id": "dark-dense",
-      "name": "Dark Dense",
-      "category": "pro-tools",
-      "mood": "Dense operator surfaces - dark, compact, low distraction",
-      "tokenPath": "tokens/themes/dark-dense.json",
-      "install": {
-        "command": "nebutra theme add dark-dense",
-        "registryUrl": "https://ui.nebutra.com/themes/dark-dense.json"
-      },
-      "compatibility": {
-        "tailwind": "4",
-        "cssVariables": true,
-        "figmaVariables": true,
-        "shadcnRegistry": true
-      },
-      "governance": {
-        "wcag": "AA",
-        "requiredTokens": [
-          "color.primary",
-          "color.primary-foreground",
-          "color.background",
-          "color.foreground",
-          "color.card",
-          "color.border",
-          "color.ring",
-          "radius.md",
-          "fontFamily.sans"
-        ],
-        "visualSuites": ["forms", "pricing", "dashboard", "ai-chat", "charts"]
-      }
-    },
-    {
-      "id": "minimal",
-      "name": "Minimal",
-      "category": "productivity",
-      "mood": "Document and workspace apps - neutral, calm, readable",
-      "tokenPath": "tokens/themes/minimal.json",
-      "install": {
-        "command": "nebutra theme add minimal",
-        "registryUrl": "https://ui.nebutra.com/themes/minimal.json"
-      },
-      "compatibility": {
-        "tailwind": "4",
-        "cssVariables": true,
-        "figmaVariables": true,
-        "shadcnRegistry": true
-      },
-      "governance": {
-        "wcag": "AA",
-        "requiredTokens": [
-          "color.primary",
-          "color.primary-foreground",
-          "color.background",
-          "color.foreground",
-          "color.card",
-          "color.border",
-          "color.ring",
-          "radius.md",
-          "fontFamily.sans"
-        ],
-        "visualSuites": ["forms", "pricing", "dashboard", "ai-chat", "charts"]
-      }
-    },
-    {
-      "id": "vibrant",
-      "name": "Vibrant",
-      "category": "creative",
-      "mood": "Creator and consumer surfaces - saturated, expressive, energetic",
-      "tokenPath": "tokens/themes/vibrant.json",
-      "install": {
-        "command": "nebutra theme add vibrant",
-        "registryUrl": "https://ui.nebutra.com/themes/vibrant.json"
-      },
-      "compatibility": {
-        "tailwind": "4",
-        "cssVariables": true,
-        "figmaVariables": true,
-        "shadcnRegistry": true
-      },
-      "governance": {
-        "wcag": "AA",
-        "requiredTokens": [
-          "color.primary",
-          "color.primary-foreground",
-          "color.background",
-          "color.foreground",
-          "color.card",
-          "color.border",
-          "color.ring",
-          "radius.md",
-          "fontFamily.sans"
-        ],
-        "visualSuites": ["forms", "pricing", "dashboard", "ai-chat", "charts"]
-      }
-    },
-    {
-      "id": "ocean",
-      "name": "Ocean",
-      "category": "enterprise",
-      "mood": "B2B infrastructure and finance - cool, stable, trustworthy",
-      "tokenPath": "tokens/themes/ocean.json",
-      "install": {
-        "command": "nebutra theme add ocean",
-        "registryUrl": "https://ui.nebutra.com/themes/ocean.json"
-      },
-      "compatibility": {
-        "tailwind": "4",
-        "cssVariables": true,
-        "figmaVariables": true,
-        "shadcnRegistry": true
-      },
-      "governance": {
-        "wcag": "AA",
-        "requiredTokens": [
-          "color.primary",
-          "color.primary-foreground",
-          "color.background",
-          "color.foreground",
-          "color.card",
-          "color.border",
-          "color.ring",
-          "radius.md",
-          "fontFamily.sans"
-        ],
-        "visualSuites": ["forms", "pricing", "dashboard", "ai-chat", "charts"]
-      }
-    }
-  ]
+  "version": "2026.07",
+  "defaultTheme": "factory",
+  "themes": [],
+  "notes": "FROZEN empty mood list. Design languages: languages.json. Do not add themes here."
 }