@nebutra/tokens 0.1.2 → 0.1.3

package/src/brand-package/presets/vanta.ts

@@ -1,220 +0,0 @@
-/**
- * vanta design-language compile preset (stress fixture).
- */
-import { leafHex } from "../compile-helpers";
-import { tryHexToHsl } from "../hex-to-hsl";
-import type { BrandPackage } from "../types";
-import type { CompileContext } from "./context";
-import { buildRecipe } from "./recipe";
-
-export function buildVanta(ctx: CompileContext): BrandPackage {
-  const parchment = ctx.colors.parchment ?? ctx.colors["page-canvas"] ?? "#f7f8fa";
-  const paper = ctx.colors.paper ?? ctx.colors["card-surface"] ?? "#ffffff";
-  const carbon = ctx.colors.carbon ?? "#181822";
-  const graphite = ctx.colors.graphite ?? "#6d6e87";
-  const steel = ctx.colors.steel ?? "#9e9fb7";
-  const ash = ctx.colors.ash ?? "#dfdfe9";
-  const fog = ctx.colors.fog ?? "#eaeaf1";
-  const lavender = ctx.colors["lavender-wash"] ?? "#ddd6ff";
-  const vivid = ctx.colors["vivid-violet"] ?? "#5e05c4";
-  const indigo = ctx.colors["indigo-ink"] ?? "#260048";
-  const mid = ctx.colors["mid-violet"] ?? "#8f47d5";
-  const amber = ctx.colors["amber-signal"] ?? "#ffbe0f";
-
-  ctx.warnings.push(
-    "Vanta: vivid-violet is action CTA only; indigo-ink is brand-mark/logo (never default CTA fill).",
-  );
-  ctx.warnings.push("Vanta: elevation=none — cards use 1px carbon border, not box-shadow.");
-
-  const brand: BrandPackage = {
-    id: "vanta",
-    name: "Vanta",
-    darkDefault: false,
-    version: "1.0.0",
-    roles: {
-      canvas: tryHexToHsl(parchment, "220 23% 97%"),
-      canvasForeground: tryHexToHsl(carbon, "240 14% 11%"),
-      surface: tryHexToHsl(paper, "0 0% 100%"),
-      surfaceForeground: tryHexToHsl(carbon, "240 14% 11%"),
-      // Action = single saturated CTA moment
-      action: tryHexToHsl(vivid, "268 95% 39%"),
-      actionForeground: tryHexToHsl(paper, "0 0% 100%"),
-      // Brand mark = logo / wordmark / decorative ink (≠ action)
-      brand: tryHexToHsl(indigo, "273 100% 14%"),
-      brandForeground: tryHexToHsl(paper, "0 0% 100%"),
-      // Quiet = lavender informational chips (not violet fill)
-      quiet: tryHexToHsl(lavender, "249 100% 92%"),
-      quietForeground: tryHexToHsl(indigo, "273 100% 14%"),
-      muted: tryHexToHsl(fog, "240 14% 93%"),
-      mutedForeground: tryHexToHsl(graphite, "237 11% 48%"),
-      border: tryHexToHsl(carbon, "240 14% 11%"),
-      input: tryHexToHsl(paper, "0 0% 100%"),
-      ring: tryHexToHsl(vivid, "268 95% 39%"),
-      destructive: "0 72% 51%",
-      destructiveForeground: tryHexToHsl(paper, "0 0% 100%"),
-      warning: tryHexToHsl(amber, "44 100% 53%"),
-      warningForeground: tryHexToHsl(carbon, "240 14% 11%"),
-      info: tryHexToHsl(mid, "269 63% 56%"),
-      infoForeground: tryHexToHsl(paper, "0 0% 100%"),
-    },
-    // semantic filled by normalize from roles
-    semantic: {
-      background: tryHexToHsl(parchment, "220 23% 97%"),
-      foreground: tryHexToHsl(carbon, "240 14% 11%"),
-      card: tryHexToHsl(paper, "0 0% 100%"),
-      cardForeground: tryHexToHsl(carbon, "240 14% 11%"),
-      popover: tryHexToHsl(paper, "0 0% 100%"),
-      popoverForeground: tryHexToHsl(carbon, "240 14% 11%"),
-      primary: tryHexToHsl(vivid, "268 95% 39%"),
-      primaryForeground: tryHexToHsl(paper, "0 0% 100%"),
-      secondary: tryHexToHsl(lavender, "249 100% 92%"),
-      secondaryForeground: tryHexToHsl(indigo, "273 100% 14%"),
-      muted: tryHexToHsl(fog, "240 14% 93%"),
-      mutedForeground: tryHexToHsl(graphite, "237 11% 48%"),
-      accent: tryHexToHsl(indigo, "273 100% 14%"),
-      accentForeground: tryHexToHsl(paper, "0 0% 100%"),
-      destructive: "0 72% 51%",
-      destructiveForeground: tryHexToHsl(paper, "0 0% 100%"),
-      border: tryHexToHsl(carbon, "240 14% 11%"),
-      input: tryHexToHsl(paper, "0 0% 100%"),
-      ring: tryHexToHsl(vivid, "268 95% 39%"),
-      warning: tryHexToHsl(amber, "44 100% 53%"),
-      warningForeground: tryHexToHsl(carbon, "240 14% 11%"),
-      info: tryHexToHsl(mid, "269 63% 56%"),
-      infoForeground: tryHexToHsl(paper, "0 0% 100%"),
-    },
-    recipe: buildRecipe({
-      buttonDefault: ctx.recipeHints.buttonDefault ?? "solid",
-      // Prefer structural ctx.radius tokens (full=pill, 2xl=cards) over free-text
-      radii: {
-        button:
-          leafHex(ctx.radius, ["buttons"]) ??
-          leafHex(ctx.radius, ["full"]) ??
-          ctx.recipeHints.radii?.button ??
-          "999px",
-        card: leafHex(ctx.radius, ["cards"]) ?? leafHex(ctx.radius, ["2xl"]) ?? "16px",
-        badge:
-          leafHex(ctx.radius, ["badges"]) ??
-          leafHex(ctx.radius, ["full"]) ??
-          ctx.recipeHints.radii?.button ??
-          "999px",
-        input:
-          leafHex(ctx.radius, ["inputs"]) ??
-          leafHex(ctx.radius, ["full"]) ??
-          ctx.recipeHints.radii?.button ??
-          "999px",
-      },
-      elevationPreset: ctx.recipeHints.elevationPreset ?? "none",
-      density: ctx.recipeHints.density ?? "comfortable",
-      // Informational chips = lavender wash + indigo (quiet), not violet CTA fill
-      badgeDefault: "muted",
-      outlineBorder: carbon,
-    }),
-    typography: {
-      fontSans: `'Inter Variable', 'Inter', ui-sans-serif, system-ui, sans-serif`,
-      fontDisplay: `'Reckless', 'Source Serif 4', 'Lora', ui-serif, Georgia, serif`,
-      headingWeight: 500,
-      faces: [
-        {
-          family: "Inter Variable",
-          src: [
-            {
-              url: "https://cdn.jsdelivr.net/fontsource/fonts/inter:vf@latest/latin-wght-normal.woff2",
-              format: "woff2",
-            },
-          ],
-          weight: "100 900",
-          display: "swap",
-        },
-        {
-          family: "Reckless",
-          // Placeholder — Create Center / tenant hosts the licensed Reckless cut
-          src: [{ url: "/brand-assets/reckless-regular.woff2", format: "woff2" }],
-          weight: 400,
-          display: "swap",
-        },
-        {
-          family: "Reckless",
-          src: [{ url: "/brand-assets/reckless-medium.woff2", format: "woff2" }],
-          weight: 500,
-          display: "swap",
-        },
-      ],
-    },
-    zones: {
-      product: {
-        caption: {
-          fontSize: "12px",
-          lineHeight: 1.5,
-          fontWeight: 500,
-          letterSpacing: "-0.02px",
-        },
-        bodySm: {
-          fontSize: "14px",
-          lineHeight: 1.43,
-          fontWeight: 400,
-          letterSpacing: "-0.02px",
-        },
-        body: {
-          fontSize: "16px",
-          lineHeight: 1.5,
-          fontWeight: 400,
-          letterSpacing: "-0.02px",
-        },
-        subheading: { fontSize: "20px", lineHeight: 1.4, fontWeight: 500 },
-        headingSm: { fontSize: "24px", lineHeight: 1.35, fontWeight: 500 },
-        heading: { fontSize: "32px", lineHeight: 1.3, fontWeight: 500 },
-      },
-      marketing: {
-        body: {
-          fontSize: "16px",
-          lineHeight: 1.5,
-          fontWeight: 400,
-          letterSpacing: "-0.02px",
-        },
-        heading: {
-          fontSize: "42px",
-          lineHeight: 1.2,
-          fontWeight: 400,
-          letterSpacing: "-0.84px",
-        },
-        headingLg: {
-          fontSize: "56px",
-          lineHeight: 1.15,
-          fontWeight: 400,
-          letterSpacing: "-1.12px",
-        },
-        display: {
-          fontSize: "90px",
-          lineHeight: 1.1,
-          fontWeight: 400,
-          letterSpacing: "-1.62px",
-        },
-      },
-    },
-    extensions: {
-      categories: {
-        brand: indigo,
-        action: vivid,
-        link: mid,
-        heroWash: lavender,
-        warning: amber,
-        steel,
-        ash,
-      },
-      decorative: {
-        "hero-wash": lavender,
-      },
-      sourceUrl: typeof ctx.refero.url === "string" ? ctx.refero.url : "https://www.vanta.com",
-      notes: [
-        "roles.action = Vivid Violet (filled CTA only).",
-        "roles.brand = Indigo Ink (logo / wordmark / brand-mark).",
-        "Elevation none — 1px carbon borders frame cards; no drop-shadow.",
-        "Full-pill controls (999px); cards 16px.",
-        "UI = Inter Variable; marketing display = Reckless serif.",
-        "Lavender wash is marketing hero surface (decorative), not product chrome fill.",
-      ],
-    },
-  };
-  return brand;
-}

package/src/brand-package/presets/vercel.ts

@@ -1,187 +0,0 @@
-/**
- * vercel design-language compile preset (stress fixture).
- * Dual-mode: light monochrome + dark monochrome (orthogonal to ThemeProvider class).
- */
-import { tryHexToHsl } from "../hex-to-hsl";
-import type { BrandPackage, BrandSemanticColors } from "../types";
-import type { CompileContext } from "./context";
-import { buildRecipe } from "./recipe";
-
-function vercelLightSemantic(
-  paper: string,
-  pure: string,
-  hairline: string,
-  charcoal: string,
-  stone: string,
-  obsidian: string,
-  terminal: string,
-): BrandSemanticColors {
-  return {
-    background: tryHexToHsl(paper, "0 0% 98%"),
-    foreground: tryHexToHsl(obsidian, "0 0% 9%"),
-    card: tryHexToHsl(pure, "0 0% 100%"),
-    cardForeground: tryHexToHsl(obsidian, "0 0% 9%"),
-    popover: tryHexToHsl(pure, "0 0% 100%"),
-    popoverForeground: tryHexToHsl(obsidian, "0 0% 9%"),
-    // Filled black button
-    primary: tryHexToHsl(obsidian, "0 0% 9%"),
-    primaryForeground: tryHexToHsl(pure, "0 0% 100%"),
-    secondary: tryHexToHsl(hairline, "0 0% 92%"),
-    secondaryForeground: tryHexToHsl(charcoal, "0 0% 30%"),
-    muted: tryHexToHsl(hairline, "0 0% 92%"),
-    mutedForeground: tryHexToHsl(stone, "0 0% 40%"),
-    accent: tryHexToHsl(hairline, "0 0% 92%"),
-    accentForeground: tryHexToHsl(obsidian, "0 0% 9%"),
-    destructive: "0 72% 51%",
-    destructiveForeground: tryHexToHsl(pure, "0 0% 100%"),
-    border: tryHexToHsl(hairline, "0 0% 92%"),
-    input: tryHexToHsl(pure, "0 0% 100%"),
-    ring: tryHexToHsl(obsidian, "0 0% 9%"),
-    success: tryHexToHsl(terminal, "133 49% 32%"),
-    successForeground: tryHexToHsl(pure, "0 0% 100%"),
-    info: tryHexToHsl(charcoal, "0 0% 30%"),
-    infoForeground: tryHexToHsl(pure, "0 0% 100%"),
-  };
-}
-
-/** Dark shell monochrome — white CTA on carbon, hairline borders. */
-function vercelDarkSemantic(terminal: string): BrandSemanticColors {
-  return {
-    background: "0 0% 0%",
-    foreground: "0 0% 93%",
-    card: "0 0% 4%",
-    cardForeground: "0 0% 93%",
-    popover: "0 0% 4%",
-    popoverForeground: "0 0% 93%",
-    primary: "0 0% 100%",
-    primaryForeground: "0 0% 0%",
-    secondary: "0 0% 12%",
-    secondaryForeground: "0 0% 93%",
-    muted: "0 0% 12%",
-    mutedForeground: "0 0% 63%",
-    accent: "0 0% 12%",
-    accentForeground: "0 0% 93%",
-    destructive: "0 72% 51%",
-    destructiveForeground: "0 0% 100%",
-    border: "0 0% 16%",
-    input: "0 0% 4%",
-    ring: "0 0% 100%",
-    success: tryHexToHsl(terminal, "133 49% 40%"),
-    successForeground: "0 0% 100%",
-    info: "0 0% 70%",
-    infoForeground: "0 0% 0%",
-  };
-}
-
-export function buildVercel(ctx: CompileContext): BrandPackage {
-  const paper = ctx.colors["paper-white"] ?? ctx.colors["page-canvas"] ?? "#fafafa";
-  const pure = ctx.colors["pure-white"] ?? ctx.colors["card-surface"] ?? "#ffffff";
-  const hairline = ctx.colors.hairline ?? "#ebebeb";
-  const charcoal = ctx.colors.charcoal ?? "#4d4d4d";
-  const stone = ctx.colors.stone ?? "#666666";
-  const obsidian = ctx.colors.obsidian ?? ctx.colors["inverted-surface"] ?? "#171717";
-  const carbon = ctx.colors.carbon ?? "#000000";
-  const terminal = ctx.colors["terminal-green"] ?? "#297a3a";
-
-  ctx.warnings.push(
-    "Vercel: monochrome dual-mode — no chromatic CTA; Terminal Green is support only.",
-  );
-
-  const light = vercelLightSemantic(paper, pure, hairline, charcoal, stone, obsidian, terminal);
-  const dark = vercelDarkSemantic(terminal);
-
-  const brand: BrandPackage = {
-    id: "vercel",
-    name: "Vercel",
-    darkDefault: false,
-    version: "1.0.0",
-    semantic: light,
-    modes: {
-      light: { semantic: light },
-      dark: { semantic: dark },
-    },
-    recipe: buildRecipe({
-      buttonDefault: "solid",
-      radii: {
-        button: ctx.recipeHints.radii?.button ?? "6px",
-        card: "6px",
-        badge: "6px",
-        input: "6px",
-      },
-      elevationPreset:
-        ctx.recipeHints.elevationPreset === "key"
-          ? "hairline"
-          : (ctx.recipeHints.elevationPreset ?? "hairline"),
-      density: ctx.recipeHints.density ?? "compact",
-      badgeDefault: "muted",
-      cardShadow: "rgba(0, 0, 0, 0.08) 0px 0px 0px 1px, rgb(250, 250, 250) 0px 0px 0px 1px",
-      outlineBorder: hairline,
-    }),
-    typography: {
-      fontSans: `'Geist Sans', 'Geist', ui-sans-serif, system-ui, sans-serif`,
-      fontMono: `'Geist Mono', ui-monospace, Menlo, monospace`,
-      fontDisplay: `'Geist Sans', 'Geist', ui-sans-serif, system-ui, sans-serif`,
-      headingWeight: 450,
-      faces: [
-        {
-          family: "Geist Sans",
-          src: [
-            {
-              url: "https://cdn.jsdelivr.net/fontsource/fonts/geist-sans:vf@latest/latin-wght-normal.woff2",
-              format: "woff2",
-            },
-          ],
-          weight: "100 900",
-          display: "swap",
-        },
-      ],
-    },
-    zones: {
-      product: {
-        caption: { fontSize: "13px", lineHeight: 1.54, fontWeight: 400 },
-        bodySm: { fontSize: "14px", lineHeight: 1.43, fontWeight: 400 },
-        body: { fontSize: "16px", lineHeight: 1.5, fontWeight: 400 },
-        heading: {
-          fontSize: "30px",
-          lineHeight: 1.1,
-          fontWeight: 500,
-          letterSpacing: "-1.5px",
-        },
-      },
-      marketing: {
-        body: { fontSize: "16px", lineHeight: 1.5, fontWeight: 400 },
-        heading: {
-          fontSize: "30px",
-          lineHeight: 1.1,
-          fontWeight: 450,
-          letterSpacing: "-1.5px",
-        },
-        headingLg: {
-          fontSize: "56px",
-          lineHeight: 1,
-          fontWeight: 450,
-          letterSpacing: "-3.36px",
-        },
-        display: {
-          fontSize: "64px",
-          lineHeight: 1,
-          fontWeight: 450,
-          letterSpacing: "-3.84px",
-        },
-      },
-    },
-    extensions: {
-      categories: {
-        carbon: carbon,
-        terminal: terminal,
-      },
-      sourceUrl: typeof ctx.refero.url === "string" ? ctx.refero.url : "https://vercel.com",
-      notes: [
-        "Dual-mode monochrome — light: Obsidian CTA; dark: white CTA on carbon.",
-        "Elevation is hairline double-ring, never drop-shadow.",
-        "Spectrum/solar gradients are marketing-only decorative (not product chrome).",
-      ],
-    },
-  };
-  return brand;
-}

package/src/brand-package/types.ts

@@ -1,285 +0,0 @@
-/**
- * Brand Package — Create Center carrier contract.
- *
- * This is a *host* for third-party design languages (Linear, GSAP, Raycast, Vercel…),
- * not a list of brand presets. Presets only demonstrate the contract.
- *
- * Layers:
- *   1. roles     — color meaning (action vs brand-mark vs surface…)
- *   2. recipe    — control language (button/badge fill, radii slots, free elev CSS)
- *   3. typography / zones / fonts
- *   4. semantic  — shadcn/Tailwind bridge (derived from roles; components keep using --primary)
- *
- * @see packages/design/ARCHITECTURE.md
- */
-
-/** HSL channel triple without `hsl()` wrapper, e.g. "66 89% 54%" */
-export type HslChannels = string;
-
-/** Full CSS color (hex / rgb / hsl / oklch / gradient) */
-export type CssColor = string;
-
-export type ButtonDefaultStyle = "solid" | "outline" | "gradient-stroke";
-
-/**
- * Elevation *presets* are only shortcuts that expand to free CSS box-shadow tokens.
- * Carriers should prefer `recipe.elevationTokens` with arbitrary shadow stacks.
- */
-export type ElevationStyle = "none" | "soft" | "raised" | "key" | "hairline";
-
-export type Density = "compact" | "comfortable" | "spacious";
-
-/** Badge fill language (may diverge from action CTA) */
-export type BadgeDefaultStyle = "match-action" | "match-primary" | "muted" | "outline" | "brand";
-
-export type BrandZoneId = "product" | "marketing";
-
-/**
- * First-class color roles — what Create Center fills.
- * Maps onto CSS vars and into shadcn semantic for component compatibility.
- */
-export interface BrandColorRoles {
-  /** Page canvas */
-  canvas: HslChannels;
-  canvasForeground: HslChannels;
-  /** Contained surfaces (cards, panels) */
-  surface: HslChannels;
-  surfaceForeground: HslChannels;
-  /**
-   * Product *action* fill (default Button / primary chrome).
-   * Must be readable as a CTA — not necessarily the brand mark color.
-   */
-  action: HslChannels;
-  actionForeground: HslChannels;
-  /**
-   * Brand mark only (logo accent, AI diamond, VI-adjacent product accent).
-   * NEVER used for default form CTAs unless Create Center explicitly maps action ← brand.
-   */
-  brand?: HslChannels;
-  brandForeground?: HslChannels;
-  /** Quiet fills (secondary, badges muted) */
-  quiet: HslChannels;
-  quietForeground: HslChannels;
-  muted: HslChannels;
-  mutedForeground: HslChannels;
-  border: HslChannels;
-  input: HslChannels;
-  ring: HslChannels;
-  destructive: HslChannels;
-  destructiveForeground: HslChannels;
-  success?: HslChannels;
-  successForeground?: HslChannels;
-  warning?: HslChannels;
-  warningForeground?: HslChannels;
-  info?: HslChannels;
-  infoForeground?: HslChannels;
-}
-
-/** Shape slots — components bind per role, not one global radius */
-export interface BrandRadii {
-  button: string;
-  card: string;
-  badge?: string;
-  input?: string;
-  pill?: string;
-}
-
-/**
- * Free-form elevation — any CSS box-shadow string the brand requires.
- * Components only read --elevation-card / control / raised.
- */
-export interface BrandElevationTokens {
-  card: string;
-  control?: string;
-  raised?: string;
-}
-
-/**
- * shadcn/Tailwind bridge. Prefer editing `roles`; semantic is kept in sync by normalize().
- * Components continue to use bg-primary etc. which map to action.
- */
-export interface BrandSemanticColors {
-  background: HslChannels;
-  foreground: HslChannels;
-  card: HslChannels;
-  cardForeground: HslChannels;
-  popover: HslChannels;
-  popoverForeground: HslChannels;
-  /** = roles.action (product CTA) */
-  primary: HslChannels;
-  primaryForeground: HslChannels;
-  secondary: HslChannels;
-  secondaryForeground: HslChannels;
-  muted: HslChannels;
-  mutedForeground: HslChannels;
-  accent: HslChannels;
-  accentForeground: HslChannels;
-  destructive: HslChannels;
-  destructiveForeground: HslChannels;
-  border: HslChannels;
-  input: HslChannels;
-  ring: HslChannels;
-  success?: HslChannels;
-  successForeground?: HslChannels;
-  warning?: HslChannels;
-  warningForeground?: HslChannels;
-  info?: HslChannels;
-  infoForeground?: HslChannels;
-}
-
-/**
- * Canonical product-chrome recipe (post-normalize).
- * Free radii + free elevation tokens only — no buttonRadius/elevation aliases.
- */
-export interface BrandRecipe {
-  buttonDefault: ButtonDefaultStyle;
-  density: Density;
-  radii: BrandRadii;
-  elevationTokens: BrandElevationTokens;
-  primaryStrokeGradient?: string;
-  outlineBorder?: CssColor;
-  badgeDefault?: BadgeDefaultStyle;
-}
-
-/**
- * Loose recipe accepted by normalize/compile before canonicalization.
- * Legacy keys (buttonRadius, elevation preset, cardShadow) are input-only.
- */
-export type BrandRecipeInput = {
-  buttonDefault: ButtonDefaultStyle;
-  density?: Density;
-  radii?: BrandRadii;
-  elevationTokens?: BrandElevationTokens;
-  /** @deprecated input-only — expanded to elevationTokens */
-  elevation?: ElevationStyle;
-  primaryStrokeGradient?: string;
-  outlineBorder?: CssColor;
-  badgeDefault?: BadgeDefaultStyle;
-  /** @deprecated input-only — use radii.button */
-  buttonRadius?: string;
-  /** @deprecated input-only — use radii.card */
-  cardRadius?: string;
-  /** @deprecated input-only — use radii.badge */
-  badgeRadius?: string;
-  /** @deprecated input-only — use radii.input */
-  inputRadius?: string;
-  /** @deprecated input-only — use elevationTokens.card */
-  cardShadow?: string;
-};
-
-export interface BrandFontSource {
-  url: string;
-  format?: "woff2" | "woff" | "truetype" | "opentype" | "svg";
-}
-
-export interface BrandFontFace {
-  family: string;
-  src: BrandFontSource[];
-  weight?: number | string;
-  style?: "normal" | "italic" | "oblique";
-  display?: "auto" | "block" | "swap" | "fallback" | "optional";
-  unicodeRange?: string;
-}
-
-export interface BrandTypeStep {
-  fontSize: string;
-  lineHeight?: string | number;
-  letterSpacing?: string;
-  fontWeight?: string | number;
-}
-
-export interface BrandZoneTypography {
-  caption?: BrandTypeStep;
-  bodySm?: BrandTypeStep;
-  body?: BrandTypeStep;
-  bodyLg?: BrandTypeStep;
-  subheading?: BrandTypeStep;
-  headingSm?: BrandTypeStep;
-  heading?: BrandTypeStep;
-  headingLg?: BrandTypeStep;
-  display?: BrandTypeStep;
-}
-
-export interface BrandZones {
-  /** App shell — never inherits marketing display sizes */
-  product?: BrandZoneTypography;
-  /** Landing / hero — large display allowed */
-  marketing?: BrandZoneTypography;
-}
-
-export interface BrandTypography {
-  fontSans: string;
-  fontMono?: string;
-  fontDisplay?: string;
-  headingWeight?: number | string;
-  faces?: BrandFontFace[];
-}
-
-export interface BrandExtensions {
-  /** Taxonomy / category accents (GSAP disciplines, etc.) — product chrome may ignore */
-  categories?: Record<string, CssColor>;
-  /** Marketing-only decorative gradients (spectrum, hero floor) — never product CTA */
-  decorative?: Record<string, string>;
-  /** @deprecated prefer zones.marketing.display */
-  displaySizePx?: number;
-  sourceUrl?: string;
-  notes?: string[];
-}
-
-/**
- * One appearance mode’s colors (light or dark).
- * Prefer roles; semantic is the shadcn bridge (derived when omitted).
- */
-export interface BrandModePalette {
-  roles?: BrandColorRoles;
-  semantic?: BrandSemanticColors;
-}
-
-/**
- * Optional dual-mode colors. When both light and dark are set, emit binds:
- *   light → :root / html[data-brand]
- *   dark  → .dark / html.dark[data-brand]
- * Single-mode packs omit this and use top-level semantic + darkDefault selector rules.
- */
-export interface BrandModes {
-  light?: BrandModePalette;
-  dark?: BrandModePalette;
-}
-
-export interface BrandPackage {
-  id: string;
-  name: string;
-  darkDefault: boolean;
-  version: string;
-  /**
-   * Canonical color roles for the **default** mode (see darkDefault).
-   * If omitted, derived from semantic on normalize().
-   */
-  roles?: BrandColorRoles;
-  /**
-   * shadcn bridge for the default mode — always present after normalize().
-   */
-  semantic: BrandSemanticColors;
-  /**
-   * Dual light/dark palettes (optional). When present after normalize, both modes
-   * are fully specified and emitBrandCss writes separate light/dark color blocks.
-   */
-  modes?: BrandModes;
-  /** Always canonical after normalizeBrandPackage(). */
-  recipe: BrandRecipe;
-  typography: BrandTypography;
-  zones?: BrandZones;
-  extensions?: BrandExtensions;
-}
-
-/** Pre-normalize package (recipe may still use legacy keys). */
-export type BrandPackageInput = Omit<BrandPackage, "recipe"> & {
-  recipe: BrandRecipeInput;
-  modes?: BrandModes;
-};
-
-export interface CompileResult {
-  brand: BrandPackage;
-  css: string;
-  warnings: string[];
-}