@nebutra/tokens 0.1.2 → 2.0.0

package/src/brand-package/compile-helpers.ts

@@ -1,170 +0,0 @@
-/**
- * Shared helpers for Refero → Brand Package compilation.
- * Preset builders live in compile-refero.ts; keep color/font extraction here.
- */
-
-export type Json = Record<string, unknown>;
-
-export type PresetId =
-  | "linear"
-  | "gsap"
-  | "raycast"
-  | "vercel"
-  | "vanta"
-  | "stripe"
-  | "notion"
-  | "generic";
-
-export function leafHex(tree: Json | undefined, path: string[]): string | undefined {
-  let cur: unknown = tree;
-  for (const p of path) {
-    if (!cur || typeof cur !== "object") return undefined;
-    cur = (cur as Json)[p];
-  }
-  if (!cur || typeof cur !== "object") return undefined;
-  const v = (cur as Json).$value ?? (cur as Json).value;
-  return typeof v === "string" ? v : undefined;
-}
-
-export function detectPreset(idHint: string, colors: Record<string, string>): PresetId {
-  const id = idHint.toLowerCase();
-  if (id.includes("linear")) return "linear";
-  if (id.includes("gsap")) return "gsap";
-  if (id.includes("raycast")) return "raycast";
-  if (id.includes("vercel")) return "vercel";
-  if (id.includes("vanta")) return "vanta";
-  if (id.includes("stripe")) return "stripe";
-  if (id.includes("notion")) return "notion";
-  // Heuristics from Refero extractions
-  if (colors["paper-white"] && colors.obsidian && colors.hairline) return "vercel";
-  if (colors["coral-pulse"] || (colors["void-black"] && colors.mist && colors.ink)) {
-    return "raycast";
-  }
-  if (colors["acid-lime"] || colors.void) return "linear";
-  if (colors["shockingly-green"] || colors["surface-cream"] || colors["just-black"]) return "gsap";
-  if (colors["just-black"] && colors["surface-cream"]) return "gsap";
-  // Notion: warm paper canvas + single blue CTA + ink hierarchy
-  if (
-    (colors["notion-blue"] || colors["paper-warmth"]) &&
-    (colors["paper-warmth"] || colors["ink-black"]) &&
-    (colors["sky-tint"] || colors.marigold || colors.coral)
-  ) {
-    return "notion";
-  }
-  // Stripe: indigo-ink action + pure-white canvas + frost borders + midnight text
-  if (
-    colors["indigo-ink"] &&
-    colors["pure-white"] &&
-    (colors.frost || colors["lavender-border"] || colors["midnight-ink"]) &&
-    !colors["paper-warmth"]
-  ) {
-    return "stripe";
-  }
-  // Vanta: indigo-ink as logo + vivid-violet CTA + parchment (not pure-white ledger)
-  if (
-    (colors["indigo-ink"] || colors["vivid-violet"]) &&
-    (colors.parchment || colors["lavender-wash"] || colors.paper) &&
-    !colors["pure-white"]
-  ) {
-    return "vanta";
-  }
-  return "generic";
-}
-
-/** First font family leaf that is UI/sans (not display/serif display faces). */
-export function pickUiFontFamily(font: Json): string | undefined {
-  const preferUi = /(inter|geist|manrope|dm sans|sans|ui)/i;
-  const avoidDisplay = /(reckless|serif|display|editorial|playfair|lora|source serif)/i;
-  const entries = Object.entries(font);
-  for (const [k, v] of entries) {
-    if (!v || typeof v !== "object") continue;
-    const name = String((v as Json).$value ?? (v as Json).value ?? "");
-    if (!name || avoidDisplay.test(k) || avoidDisplay.test(name)) continue;
-    if (preferUi.test(k) || preferUi.test(name) || entries.length === 1) return name;
-  }
-  for (const [k, v] of entries) {
-    if (!v || typeof v !== "object") continue;
-    const name = String((v as Json).$value ?? (v as Json).value ?? "");
-    if (name && !avoidDisplay.test(k) && !avoidDisplay.test(name)) return name;
-  }
-  return undefined;
-}
-
-export function pickDisplayFontFamily(font: Json): string | undefined {
-  const prefer = /(reckless|serif|display|editorial|playfair|lora|source serif|mori)/i;
-  for (const [k, v] of Object.entries(font)) {
-    if (!v || typeof v !== "object") continue;
-    const name = String((v as Json).$value ?? (v as Json).value ?? "");
-    if (name && (prefer.test(k) || prefer.test(name))) return name;
-  }
-  return undefined;
-}
-
-/**
- * shadcn / Appearance / playground token names → keys generic + presets already pick.
- * Kebab and camel both land on the same slot so compileReferoTokens works for imports.
- */
-const COLOR_KEY_ALIASES: Record<string, string[]> = {
-  background: ["background", "canvas", "page-canvas"],
-  foreground: ["foreground", "ink", "ink-black"],
-  card: ["card", "card-surface", "surface"],
-  "card-foreground": ["card-foreground"],
-  cardForeground: ["card-foreground"],
-  primary: ["primary", "action"],
-  "primary-foreground": ["primary-foreground"],
-  primaryForeground: ["primary-foreground"],
-  secondary: ["secondary", "quiet"],
-  "secondary-foreground": ["secondary-foreground"],
-  secondaryForeground: ["secondary-foreground"],
-  muted: ["muted"],
-  "muted-foreground": ["muted-foreground", "mutedForeground", "stone"],
-  mutedForeground: ["muted-foreground", "stone"],
-  accent: ["accent"],
-  "accent-foreground": ["accent-foreground"],
-  accentForeground: ["accent-foreground"],
-  border: ["border", "hairline"],
-  input: ["input"],
-  ring: ["ring"],
-  destructive: ["destructive"],
-  "destructive-foreground": ["destructive-foreground"],
-  destructiveForeground: ["destructive-foreground"],
-  success: ["success"],
-  popover: ["popover"],
-  "popover-foreground": ["popover-foreground"],
-  popoverForeground: ["popover-foreground"],
-};
-
-function isUsableColorValue(val: string): boolean {
-  const t = val.trim();
-  if (!t) return false;
-  if (t.startsWith("#")) return true;
-  if (/^\d+(\.\d+)?\s+\d+(\.\d+)?%\s+\d+(\.\d+)?%$/.test(t)) return true;
-  if (/^hsla?\(/i.test(t) || /^rgba?\(/i.test(t)) return true;
-  // oklch/lab left out of compile path (no reliable SSR convert); Appearance still has canvas probe
-  return false;
-}
-
-export function collectColors(colorRoot: Json | undefined): Record<string, string> {
-  const raw: Record<string, string> = {};
-  if (!colorRoot || typeof colorRoot !== "object") return raw;
-  for (const [k, v] of Object.entries(colorRoot)) {
-    if (!v || typeof v !== "object") continue;
-    const val = (v as Json).$value ?? (v as Json).value;
-    if (typeof val === "string" && isUsableColorValue(val)) raw[k] = val.trim();
-  }
-
-  // Expand aliases so shadcn-named imports hit preset pick() keys
-  const out: Record<string, string> = { ...raw };
-  for (const [key, value] of Object.entries(raw)) {
-    const aliases = COLOR_KEY_ALIASES[key];
-    if (!aliases) continue;
-    for (const alias of aliases) {
-      if (!out[alias]) out[alias] = value;
-    }
-  }
-  return out;
-}
-
-export function collectSurfaces(surfaceRoot: Json | undefined): Record<string, string> {
-  return collectColors(surfaceRoot as Json | undefined);
-}

package/src/brand-package/compile-refero.ts

@@ -1,69 +0,0 @@
-/**
- * Compile Refero DTCG tokens.json (+ optional DESIGN.md) into a Brand Package.
- *
- * Structure:
- *   compile-helpers.ts  — detectPreset, color/font leaf helpers
- *   presets/*           — named fixture builders (linear…notion) + generic
- *   compile-refero.ts   — orchestration only
- *
- * Named fixtures are stress-test carriers (not mood presets). Prefer extending
- * the generic path + DESIGN.md inference over adding one-off hacks.
- */
-
-import { collectColors, collectSurfaces, detectPreset, type Json } from "./compile-helpers";
-import { emitBrandCss } from "./emit-css";
-import { inferRecipeFromDesignMd } from "./infer-recipe";
-import { normalizeBrandPackage } from "./normalize";
-import { buildPresetBrand } from "./presets";
-import type { BrandPackage, CompileResult } from "./types";
-
-function finish(brand: BrandPackage, warnings: string[]): CompileResult {
-  const b = normalizeBrandPackage(brand);
-  return { brand: b, css: emitBrandCss(b), warnings };
-}
-
-/**
- * Compile a Refero-style DTCG tokens.json (+ optional DESIGN.md text) into a Brand Package.
- * Known fixtures get opinionated recipes; generic brands get solid CTAs.
- */
-export function compileReferoTokens(input: {
-  tokens: Json;
-  id?: string;
-  name?: string;
-  designMd?: string;
-}): CompileResult {
-  const warnings: string[] = [];
-  const color = (input.tokens.color ?? {}) as Json;
-  const surface = (input.tokens.surface ?? {}) as Json;
-  const font = (input.tokens.font ?? {}) as Json;
-  const radius = (input.tokens.radius ?? {}) as Json;
-  const ext = (input.tokens.$extensions ?? {}) as Json;
-  const refero = (ext["com.refero.extraction"] ?? {}) as Json;
-
-  const colors = { ...collectColors(color), ...collectSurfaces(surface) };
-  const siteName =
-    (typeof refero.siteName === "string" && refero.siteName) || input.name || "Custom Brand";
-  const id =
-    input.id ||
-    siteName
-      .toLowerCase()
-      .replace(/[^a-z0-9]+/g, "-")
-      .replace(/^-|-$/g, "") ||
-    "custom";
-
-  const preset = detectPreset(id, colors);
-  const recipeHints = inferRecipeFromDesignMd(input.designMd ?? "");
-
-  const brand = buildPresetBrand(preset, {
-    colors,
-    font,
-    radius,
-    refero,
-    recipeHints,
-    warnings,
-    id,
-    siteName,
-  });
-
-  return finish(brand, warnings);
-}