@nebutra/ui 0.2.1 → 0.2.3

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/cn.ts","../../src/utils/brand-colors.ts","../../src/utils/index.ts"],"names":[],"mappings":";;;;AAGO,SAAS,MAAM,MAAA,EAAsB;AAC1C,EAAA,OAAO,OAAA,CAAQ,IAAA,CAAK,MAAM,CAAC,CAAA;AAC7B;;;ACQO,IAAM,cAAA,GAAiB;AAAA,EAC5B,OAAA,EAAS,SAAA;AAAA;AAAA,EACT,MAAA,EAAQ,SAAA;AAAA;AAAA,EACR,QAAA,EAAU,SAAA;AAAA;AAAA,EACV,WAAA,EAAa,SAAA;AAAA;AAAA,EACb,QAAA,EAAU;AAAA;AACZ;AAOO,SAAS,UAAA,CAAW,MAAc,QAAA,EAA0B;AACjE,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,IAAe,OAAO,aAAa,WAAA,EAAa;AACpE,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,MAAM,KAAA,GAAQ,iBAAiB,QAAA,CAAS,eAAe,EAAE,gBAAA,CAAiB,IAAI,EAAE,IAAA,EAAK;AACrF,EAAA,OAAO,KAAA,IAAS,QAAA;AAClB;AAGO,SAAS,eAAA,GAA0B;AACxC,EAAA,OAAO,UAAA,CAAW,iBAAA,EAAmB,cAAA,CAAe,OAAO,CAAA;AAC7D;AAGO,SAAS,cAAA,GAAyB;AACvC,EAAA,OAAO,UAAA,CAAW,gBAAA,EAAkB,cAAA,CAAe,MAAM,CAAA;AAC3D;AAGO,SAAS,gBAAA,GAA2B;AACzC,EAAA,OAAO,UAAA,CAAW,kBAAA,EAAoB,cAAA,CAAe,QAAQ,CAAA;AAC/D;;;AClCO,IAAM,WAAA,GAAc;AAAA,EACzB,EAAA,EAAI,CAAA;AAAA,EACJ,EAAA,EAAI,GAAA;AAAA,EACJ,EAAA,EAAI,GAAA;AAAA,EACJ,EAAA,EAAI,IAAA;AAAA,EACJ,EAAA,EAAI;AACN;AAOO,SAAS,eAAe,UAAA,EAAiC;AAC9D,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,IAAA;AAC1C,EAAA,OAAO,MAAA,CAAO,UAAA,IAAc,WAAA,CAAY,UAAU,CAAA;AACpD","file":"index.js","sourcesContent":["import { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n","/**\n * Brand Color Utilities\n *\n * Resolves Nebutra brand CSS variables at runtime for components that\n * require raw hex values (e.g. WebGL shaders, Canvas APIs, animation libraries\n * that can't consume `var(--token)` strings directly).\n *\n * Components that accept CSS color strings (inline styles, gradients, SVG)\n * should prefer `var(--brand-primary)` / `var(--brand-accent)` directly\n * instead of calling these helpers.\n */\n\n/** SSR / no-DOM fallbacks — only used when `window` is unavailable. */\nexport const BRAND_FALLBACK = {\n  primary: \"#0033FE\", // nebutra-blue-500\n  accent: \"#0BF1C3\", // nebutra-cyan-500\n  tertiary: \"#5c7cfa\", // nebutra-blue-400\n  primaryDark: \"#002ad4\", // nebutra-blue-600\n  backDark: \"#000830\", // nebutra-blue-950\n} as const;\n\n/**\n * Read a CSS variable from :root and return its trimmed value.\n * Falls back to `fallback` in SSR/no-DOM environments or when the var\n * is unresolved (empty string).\n */\nexport function readCssVar(name: string, fallback: string): string {\n  if (typeof window === \"undefined\" || typeof document === \"undefined\") {\n    return fallback;\n  }\n  const value = getComputedStyle(document.documentElement).getPropertyValue(name).trim();\n  return value || fallback;\n}\n\n/** Resolve `--brand-primary` to a hex/color string (with SSR fallback). */\nexport function getBrandPrimary(): string {\n  return readCssVar(\"--brand-primary\", BRAND_FALLBACK.primary);\n}\n\n/** Resolve `--brand-accent` to a hex/color string (with SSR fallback). */\nexport function getBrandAccent(): string {\n  return readCssVar(\"--brand-accent\", BRAND_FALLBACK.accent);\n}\n\n/** Resolve `--brand-tertiary` to a hex/color string (with SSR fallback). */\nexport function getBrandTertiary(): string {\n  return readCssVar(\"--brand-tertiary\", BRAND_FALLBACK.tertiary);\n}\n","/**\n * Utility Functions\n */\n\n/**\n * Merge class names — canonical implementation from ./cn.ts\n * Uses twMerge(clsx(...)) to correctly resolve Tailwind class conflicts.\n */\nexport { cn } from \"./cn\";\n\n/**\n * Breakpoint values (matches Primer)\n */\nexport const BREAKPOINTS = {\n  xs: 0,\n  sm: 544,\n  md: 768,\n  lg: 1012,\n  xl: 1280,\n} as const;\n\nexport type Breakpoint = keyof typeof BREAKPOINTS;\n\n/**\n * Check if viewport is at or above breakpoint\n */\nexport function isBreakpointUp(breakpoint: Breakpoint): boolean {\n  if (typeof window === \"undefined\") return true;\n  return window.innerWidth >= BREAKPOINTS[breakpoint];\n}\n\nexport {\n  BRAND_FALLBACK,\n  getBrandAccent,\n  getBrandPrimary,\n  getBrandTertiary,\n  readCssVar,\n} from \"./brand-colors\";\n"]}
+{"version":3,"sources":["../../src/utils/cn.ts","../../src/utils/primitive-props.ts","../../src/utils/brand-colors.ts","../../src/utils/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n","import type * as React from \"react\";\n\n/**\n * Base UI (and some Radix peers) type `style` as CSSProperties | state-function.\n * Token merge helpers only need the plain object branch — drop functions so DTS\n * builds stay green across monorepo and standalone package mirrors.\n * Returns `{}` (never undefined) so spreads stay exactOptionalPropertyTypes-safe.\n */\nexport function asPlainStyle(style: unknown): React.CSSProperties {\n  if (style == null || typeof style === \"function\") return {};\n  return style as React.CSSProperties;\n}\n\nexport type PrimitiveProps<T> = React.PropsWithChildren<T & { className?: string | undefined }>;\n\nexport type PrimitiveComponent<TElement, TProps> = React.ForwardRefExoticComponent<\n  PrimitiveProps<TProps> & React.RefAttributes<TElement>\n>;\n\n/**\n * Resolve the HTMLElement type for a given intrinsic element tag.\n */\ntype ElementForTag<E extends keyof React.JSX.IntrinsicElements> = E extends \"button\"\n  ? HTMLButtonElement\n  : E extends \"span\"\n    ? HTMLSpanElement\n    : E extends \"img\"\n      ? HTMLImageElement\n      : E extends \"label\"\n        ? HTMLLabelElement\n        : E extends \"input\"\n          ? HTMLInputElement\n          : E extends \"a\"\n            ? HTMLAnchorElement\n            : E extends \"p\"\n              ? HTMLParagraphElement\n              : E extends \"h1\" | \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\"\n                ? HTMLHeadingElement\n                : HTMLElement;\n\n/**\n * Workaround for Radix UI types not resolving HTML element props (className,\n * children, etc.) with React 19 + exactOptionalPropertyTypes.\n *\n * The optional second type parameter `Extra` allows preserving Radix-specific\n * props (e.g. `asChild`, `align`, `sideOffset`) that are not standard HTML attrs.\n *\n * Usage:\n *   const Header = withHtmlProps<\"h3\">(AccordionPrimitive.Header);\n *   const Trigger = withHtmlProps<\"button\", { asChild?: boolean }>(DialogPrimitive.Trigger);\n *   const Content = withHtmlProps<\"div\", { align?: string; sideOffset?: number }>(PopoverPrimitive.Content);\n */\n\nexport function withHtmlProps<E extends keyof React.JSX.IntrinsicElements, Extra = object>(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  Component: any,\n): React.ForwardRefExoticComponent<\n  React.ComponentPropsWithoutRef<E> & Extra & React.RefAttributes<ElementForTag<E>>\n> {\n  return Component;\n}\n","/**\n * Runtime color resolution for APIs that cannot consume CSS variables\n * (Canvas, WebGL, some animation libs).\n *\n * Layers (do not mix):\n * - Product action / CTA: getProductPrimary() → semantic `--primary` (roles.action)\n * - Brand mark / AI badge / logo tint: getBrandMark() → `--brand-mark` (roles.brand)\n * - VI lock (print / legal assets): getBrandPrimary() → `--brand-primary` hex\n *\n * Prefer CSS / Tailwind in components:\n * - `bg-primary` for CTAs\n * - `bg-brand-mark` / `text-brand-mark` for Logo/AI badge (see recipe.css)\n *\n * @see packages/design/ARCHITECTURE.md\n * @see packages/design/tokens/recipe.css\n */\n\n/** SSR fallbacks when document is unavailable */\nexport const BRAND_FALLBACK = {\n  /** VI 云毓蓝 — identity only */\n  primary: \"#0033FE\",\n  accent: \"#0BF1C3\",\n  tertiary: \"#5c7cfa\",\n  primaryDark: \"#002ad4\",\n  backDark: \"#000830\",\n  /** Soft product action (matches themes/light --primary ≈ #254bfa) */\n  productPrimary: \"#254bfa\",\n  /**\n   * Brand mark fallback (= product action when factory brand has action≡brand).\n   * Skins may diverge (e.g. Linear purple action + indigo mark).\n   */\n  brandMark: \"#254bfa\",\n  brandMarkForeground: \"#ffffff\",\n} as const;\n\n/**\n * Read a CSS variable from :root and return its trimmed value.\n */\nexport function readCssVar(name: string, fallback: string): string {\n  if (typeof window === \"undefined\" || typeof document === \"undefined\") {\n    return fallback;\n  }\n  const value = getComputedStyle(document.documentElement).getPropertyValue(name).trim();\n  return value || fallback;\n}\n\n/** Turn HSL channel triple or full color into a CSS color string. */\nfunction asCssColor(value: string, fallback: string): string {\n  const v = value.trim() || fallback;\n  if (\n    v.startsWith(\"#\") ||\n    v.startsWith(\"rgb\") ||\n    v.startsWith(\"hsl\") ||\n    v.startsWith(\"oklch\") ||\n    v.startsWith(\"color(\")\n  ) {\n    return v;\n  }\n  // shadcn-style \"228 85% 56%\"\n  return `hsl(${v})`;\n}\n\n/**\n * Product action color — follows the active skin (`--primary`).\n * Use for shaders/canvas that must match buttons/CTAs.\n */\nexport function getProductPrimary(): string {\n  return asCssColor(readCssVar(\"--primary\", \"228 85% 56%\"), BRAND_FALLBACK.productPrimary);\n}\n\n/** VI lock color — legal / print lockups only (not product chrome). */\nexport function getBrandPrimary(): string {\n  return asCssVarColor(\"--brand-primary\", BRAND_FALLBACK.primary);\n}\n\n/**\n * Product brand-mark (roles.brand) — Logo tile, AI badge, identity chips.\n * Never use for default CTA (that is getProductPrimary / --primary).\n */\nexport function getBrandMark(): string {\n  const raw = readCssVar(\"--brand-mark\", \"228 85% 56%\");\n  // Factory recipe defaults `--brand-mark: var(--primary)` — resolve to action color.\n  if (/var\\(\\s*--primary\\s*\\)/u.test(raw)) {\n    return getProductPrimary();\n  }\n  return asCssColor(raw, BRAND_FALLBACK.brandMark);\n}\n\n/** Foreground on brand-mark surfaces. */\nexport function getBrandMarkForeground(): string {\n  const raw = readCssVar(\"--brand-mark-foreground\", \"0 0% 100%\");\n  if (/var\\(\\s*--primary-foreground\\s*\\)/u.test(raw)) {\n    return asCssColor(\n      readCssVar(\"--primary-foreground\", \"0 0% 100%\"),\n      BRAND_FALLBACK.brandMarkForeground,\n    );\n  }\n  return asCssColor(raw, BRAND_FALLBACK.brandMarkForeground);\n}\n\nfunction asCssVarColor(name: string, fallback: string): string {\n  return asCssColor(readCssVar(name, fallback), fallback);\n}\n\nexport function getBrandAccent(): string {\n  return asCssVarColor(\"--brand-accent\", BRAND_FALLBACK.accent);\n}\n\nexport function getBrandTertiary(): string {\n  return asCssVarColor(\"--brand-tertiary\", BRAND_FALLBACK.tertiary);\n}\n","/**\n * Utility Functions\n */\n\n/**\n * Merge class names — canonical implementation from ./cn.ts\n * Uses twMerge(clsx(...)) to correctly resolve Tailwind class conflicts.\n */\nexport { cn } from \"./cn\";\nexport { asPlainStyle, withHtmlProps, type PrimitiveProps, type PrimitiveComponent } from \"./primitive-props\";\n\n/**\n * Breakpoint values (matches Primer)\n */\nexport const BREAKPOINTS = {\n  xs: 0,\n  sm: 544,\n  md: 768,\n  lg: 1012,\n  xl: 1280,\n} as const;\n\nexport type Breakpoint = keyof typeof BREAKPOINTS;\n\n/**\n * Check if viewport is at or above breakpoint\n */\nexport function isBreakpointUp(breakpoint: Breakpoint): boolean {\n  if (typeof window === \"undefined\") return true;\n  return window.innerWidth >= BREAKPOINTS[breakpoint];\n}\n\nexport {\n  BRAND_FALLBACK,\n  getBrandAccent,\n  getBrandMark,\n  getBrandMarkForeground,\n  getBrandPrimary,\n  getBrandTertiary,\n  getProductPrimary,\n  readCssVar,\n} from \"./brand-colors\";\n"]}

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@nebutra/ui",
-  "version": "0.2.1",
-  "description": "Unified UI component library — Lobe UI + Radix + HeroUI + layout components",
+  "version": "0.2.3",
+  "description": "Nebutra design-system UI primitives, patterns, layouts, and token-integrated components",
   "private": false,
   "license": "MIT",
   "type": "module",
-  "sideEffects": false,
+  "sideEffects": [
+    "**/*.css"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -27,6 +29,10 @@
       "types": "./dist/icons/index.d.ts",
       "import": "./dist/icons/index.js"
     },
+    "./agent": {
+      "types": "./dist/agent/index.d.ts",
+      "import": "./dist/agent/index.js"
+    },
     "./theme": {
       "types": "./dist/theme/index.d.ts",
       "import": "./dist/theme/index.js"
@@ -35,6 +41,10 @@
       "types": "./dist/primitives/index.d.ts",
       "import": "./dist/primitives/index.js"
     },
+    "./primitives/canonical": {
+      "types": "./dist/primitives/canonical.d.ts",
+      "import": "./dist/primitives/canonical.js"
+    },
     "./patterns": {
       "types": "./dist/patterns/index.d.ts",
       "import": "./dist/patterns/index.js"
@@ -43,11 +53,26 @@
       "types": "./dist/typography/index.d.ts",
       "import": "./dist/typography/index.js"
     },
-    "./typography/fonts.css": "./dist/typography/fonts.css",
+    "./typography/fonts.css": "./src/typography/fonts.css",
+    "./styles/sources.css": "./src/styles/sources.css",
+    "./styles/preset.css": "./src/styles/preset.css",
+    "./styles.css": "./src/styles/preset.css",
     "./hooks": {
       "types": "./dist/hooks/index.d.ts",
       "import": "./dist/hooks/index.js"
     },
+    "./shared/animation": {
+      "types": "./dist/shared/animation/index.d.ts",
+      "import": "./dist/shared/animation/index.js"
+    },
+    "./shared/animation/css": {
+      "types": "./dist/shared/animation/css/index.d.ts",
+      "import": "./dist/shared/animation/css/index.js"
+    },
+    "./shared/animation/motion": {
+      "types": "./dist/shared/animation/motion/index.d.ts",
+      "import": "./dist/shared/animation/motion/index.js"
+    },
     "./utils": {
       "types": "./dist/utils/index.d.ts",
       "import": "./dist/utils/index.js"
@@ -59,6 +84,8 @@
   },
   "files": [
     "dist",
+    "src/styles",
+    "src/typography/fonts.css",
     "README.md"
   ],
   "dependencies": {
@@ -68,11 +95,13 @@
     "@lobehub/fluent-emoji": "^4.1.0",
     "@lobehub/icons": "^5.0.1",
     "@lobehub/ui": "^5.4.0",
-    "@xyflow/react": "^12.10.2",
     "@number-flow/react": "^0.5.5",
     "@paper-design/shaders-react": "^0.0.71",
     "@phosphor-icons/react": "^2.1.10",
     "@react-types/shared": "^3.33.1",
+    "@tanstack/react-table": "^8.21.3",
+    "@tanstack/react-virtual": "^3.13.24",
+    "@xyflow/react": "^12.10.2",
     "antd": "^6.3.1",
     "antd-style": "^4.1.0",
     "canvas-confetti": "^1.9.4",
@@ -85,7 +114,6 @@
     "embla-carousel-react": "^8.6.0",
     "framer-motion": "^12.35.0",
     "input-otp": "^1.4.2",
-    "motion": "^12.35.0",
     "piri": "^1.3.2",
     "react": "^19.2.4",
     "react-ascii-text": "*",
@@ -94,24 +122,26 @@
     "react-markdown": "^10.1.0",
     "react-resizable-panels": "^4.7.1",
     "react-syntax-highlighter": "^16.1.1",
-    "remark-gfm": "^4.0.1",
     "react-tweet": "^3.3.0",
     "react-use-measure": "^2.1.7",
     "recharts": "^3.7.0",
+    "remark-gfm": "^4.0.1",
     "rough-notation": "^0.5.1",
     "sonner": "^2.0.7",
     "streamdown": "^2.5.0",
     "tailwind-merge": "^3.5.0",
     "usehooks-ts": "^3.1.1",
     "vaul": "^1.1.2",
-    "@nebutra/brand": "0.1.1",
-    "@nebutra/graph-model": "0.2.1",
-    "@nebutra/icons": "0.1.1",
-    "@nebutra/tokens": "0.1.1"
+    "@nebutra/tokens": "0.1.3",
+    "@nebutra/icons": "0.1.2",
+    "@nebutra/graph-model": "0.2.3",
+    "@nebutra/brand": "0.1.2"
   },
   "peerDependencies": {
     "@clerk/nextjs": ">=5.0.0",
+    "driver.js": "^1.4.0",
     "next": ">=14.0.0",
+    "next-intl": "^4.12.0",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0"
   },
@@ -119,11 +149,18 @@
     "@clerk/nextjs": {
       "optional": true
     },
+    "driver.js": {
+      "optional": true
+    },
     "next": {
       "optional": true
+    },
+    "next-intl": {
+      "optional": true
     }
   },
   "devDependencies": {
+    "@storybook/react": "8.6.17",
     "@storybook/test": "^8.6.17",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
@@ -132,14 +169,17 @@
     "@types/react": "^19.2.14",
     "@types/react-syntax-highlighter": "^15.5.13",
     "@types/three": "^0.183.1",
+    "@vitejs/plugin-react-swc": "^4.3.1",
+    "driver.js": "^1.4.0",
     "next": "^16.2.6",
+    "next-intl": "^4.12.0",
     "storybook": "^8.6.17",
-    "@vitejs/plugin-react": "^4.3.4",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18",
-    "@nebutra/design-tokens": "0.1.1"
+    "jsdom": "^29.1.1",
+    "@nebutra/design-tokens": "0.1.2"
   },
   "homepage": "https://github.com/Nebutra/Nebutra-Sailor/tree/main/packages/design/ui#readme",
   "repository": {
@@ -157,11 +197,13 @@
     "@react-three/fiber": "^9.5.0",
     "three": "^0.183.2"
   },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "scripts": {
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
     "build:registry": "tsx scripts/build-registry.ts",
-    "build": "NODE_OPTIONS='--max-old-space-size=6144' tsup && tsx scripts/build-registry.ts",
+    "build": "NODE_OPTIONS='--max-old-space-size=6144' tsup",
     "dev": "tsup --watch"
   }
 }

package/src/styles/brand-override.css

@@ -0,0 +1,61 @@
+/**
+ * brand-override.css — Custom Brand Configuration (legacy scale remap)
+ *
+ * Prefer the skin surface for product chrome:
+ *   @import "@nebutra/tokens/skins/<name>.css";
+ *   @see packages/design/tokens/skins/README.md
+ *
+ * This file remaps the **blue scale** only (residual `bg-blue-9` call sites).
+ * New code should use semantic tokens (`bg-primary`, `border-border`).
+ *
+ * Drop into globals.css after tokens if you still need scale remapping:
+ *   @import "@nebutra/ui/styles/brand-override.css";
+ *
+ * ────────────────────────────────────────────────────────────
+ * HOW THE CASCADE WORKS
+ *
+ *   1. You define: --your-primary-* (11 steps)
+ *   2. System maps: --blue-9 → --your-primary-500 (solid fill)
+ *                  --blue-3 → --your-primary-200 (component bg)
+ *   3. Residual blue-N utilities follow your brand; semantic CSS still wins
+ *      for Button / Input that already use --primary.
+ * ────────────────────────────────────────────────────────────
+ */
+
+:root {
+  /* ══════════════════════════════════════════════════════════
+     PRIMARY BRAND COLOR — replace #0033FE with your primary
+     ════════════════════════════════════════════════════════ */
+  --nebutra-blue-50: #f0f4ff; /* lightest tint — backgrounds */
+  --nebutra-blue-100: #dbe4ff;
+  --nebutra-blue-200: #bac8ff;
+  --nebutra-blue-300: #91a7ff;
+  --nebutra-blue-400: #5c7cfa;
+  --nebutra-blue-500: #0033fe; /* ← YOUR PRIMARY COLOR HERE */
+  --nebutra-blue-600: #002ad4;
+  --nebutra-blue-700: #0021ab;
+  --nebutra-blue-800: #001882;
+  --nebutra-blue-900: #000f59;
+  --nebutra-blue-950: #000830; /* darkest — text */
+
+  /* ══════════════════════════════════════════════════════════
+     SECONDARY ACCENT COLOR — replace #0BF1C3 with your accent
+     ════════════════════════════════════════════════════════ */
+  --nebutra-cyan-50: #e6fff8; /* lightest tint */
+  --nebutra-cyan-100: #b3ffec;
+  --nebutra-cyan-200: #80ffe0;
+  --nebutra-cyan-300: #4dfcd4;
+  --nebutra-cyan-400: #1af7c8;
+  --nebutra-cyan-500: #0bf1c3; /* ← YOUR ACCENT COLOR HERE */
+  --nebutra-cyan-600: #09c9a3;
+  --nebutra-cyan-700: #07a183;
+  --nebutra-cyan-800: #057963;
+  --nebutra-cyan-900: #035143;
+  --nebutra-cyan-950: #012923; /* darkest */
+
+  /* ══════════════════════════════════════════════════════════
+     OPTIONAL: Brand name tokens (used in metadata / docs only)
+     ════════════════════════════════════════════════════════ */
+  /* --brand-name: "Your Brand"; */
+  /* --brand-domain: "yourbrand.com"; */
+}

package/src/styles/preset.css

@@ -0,0 +1,29 @@
+/**
+ * Full design-system CSS entry for product apps (Tailwind v4).
+ *
+ * Architecture: packages/design/ARCHITECTURE.md
+ *
+ * One import wires:
+ *   1. Tailwind
+ *   2. @nebutra/tokens (semantic CSS variables + @theme)  ← skin surface
+ *   3. Source scan so UI CVA classes are generated
+ *   4. Typography CSS variables
+ *   5. dark variant
+ *
+ * Simple apps:
+ *   @import "@nebutra/ui/styles/preset.css";
+ *
+ * Complex apps (fumadocs, katex first):
+ *   @import "tailwindcss";
+ *   @import "…third-party…";
+ *   @import "@nebutra/tokens/styles.css";
+ *   @import "@nebutra/ui/styles/sources.css";
+ */
+
+@import "tailwindcss";
+@import "@nebutra/tokens/styles.css";
+@import "@nebutra/tokens/recipe.css";
+@import "./sources.css";
+@import "../typography/fonts.css";
+
+@custom-variant dark (&:is(.dark *));

package/src/styles/sources.css

@@ -0,0 +1,37 @@
+/**
+ * Tailwind v4 source registration for @nebutra/ui (+ icons).
+ *
+ * WHY THIS FILE EXISTS
+ * --------------------
+ * UI primitives style themselves with CVA *utility class strings*, not a
+ * prebuilt component CSS sheet. Under Tailwind v4 those utilities only exist
+ * in an app’s bundle if the app’s CSS pipeline *scans* this package.
+ *
+ * Best practice: the design-system package owns the scan paths.
+ * Apps import this file once — they never hardcode monorepo-relative @source.
+ *
+ * Usage (after @import "tailwindcss"):
+ *   @import "@nebutra/ui/styles/sources.css";
+ *
+ * Or use the full preset:
+ *   @import "@nebutra/ui/styles/preset.css";
+ *
+ * Paths are relative to THIS file so resolution is stable in workspace
+ * and when resolved through node_modules/@nebutra/ui.
+ */
+
+/* All CVA / className strings under the UI package */
+@source "../**/*.{ts,tsx,js,jsx}";
+
+/* Icon components often appear in class strings next to UI primitives */
+@source "../../../icons/src/**/*.{ts,tsx,js,jsx}";
+
+/*
+ * @nebutra/i18n ships rendered components (locale-switcher, market-locale-picker),
+ * so its class strings need compiling too. Without this the utilities silently
+ * do not exist: the locale switcher asked for `bg-neutral-1` to opt out of the
+ * translucent popover surface and got nothing, so the DS default `bg-popover/95`
+ * kept winning and the panel stayed see-through — a fix that was correct in the
+ * source and absent from the stylesheet.
+ */
+@source "../../../../platform/i18n/src/**/*.{ts,tsx,js,jsx}";

package/src/typography/fonts.css

@@ -0,0 +1,124 @@
+/**
+ * Font rules — the typography BEHAVIOUR layer (which element gets which stack).
+ * The STACKS themselves are owned by @nebutra/tokens, generated from
+ * packages/design/design-tokens/tokens/core.json → fontFamily.*.
+ *
+ * Font loading (Next.js apps): each app's layout.tsx applies the loader classes
+ *   GeistSans        → --font-geist-sans     (variable, 100–900)   Latin + numerals
+ *   GeistMono        → --font-geist-mono     (variable, 100–900)   code
+ *   cjkFontClassName → --font-vivo-sans-sc   (@nebutra/fonts/next/cjk)  CJK
+ * and the token stacks reference those variables in that order, so Geist keeps
+ * Latin and only CJK falls through to vivo Sans SC.
+ *
+ * IMPORT ORDER MATTERS: this file must come AFTER @nebutra/tokens/styles.css
+ * (see ../styles/preset.css). It used to re-declare --font-sans / --font-heading /
+ * --font-mono here as Geist-only literals; being the later import, those copies
+ * won, and the CJK half of every token stack was silently discarded. Declare
+ * stacks in the tokens, never here.
+ */
+
+/* ============================================
+   CSS Custom Properties — derived aliases only
+   ============================================ */
+
+:root {
+  /* Legacy alias for the body/UI stack — the stack lives in the tokens. */
+  --font-primary: var(--font-sans);
+
+  /* CJK — appended as a fallback on the rules below (see the note there). The
+     token already leads with the self-hosted face; the system families repeat
+     here so this alias still degrades on its own. */
+  --font-cjk:
+    var(--font-cn), "Noto Sans SC", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
+
+  /* Not a token: no Nebutra surface uses a serif, this exists for shadcn parity. */
+  --font-serif: Georgia, Cambria, "Times New Roman", Times, serif;
+}
+
+/* ============================================
+   Font Smoothing & Rendering
+   ============================================ */
+
+html {
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  text-rendering: optimizeLegibility;
+  font-feature-settings:
+    "calt" 1,
+    "liga" 1;
+  /* Variable-font polish: */
+  /*  - font-synthesis: none → forbid faux-bold / faux-italic synthesis;
+       variable fonts already ship every weight/style, synthesised faces
+       look fuzzy at sub-pixel boundaries.
+     - font-optical-sizing: auto → tells the engine to use the opsz axis
+       on fonts that ship one (Geist Sans, Geist Mono, Inter, Playfair),
+       so glyphs are rendered with weights tuned to their display size
+       instead of being scaled uniformly. */
+  font-synthesis: none;
+  font-optical-sizing: auto;
+}
+
+/* ============================================
+   Base Typography
+   ============================================ */
+
+body {
+  /* Font precedence in ONE place: explicit user choice (--user-ui-font) →
+     active theme/DESIGN font (--font-sans) → default; the CJK stack is always
+     appended as a fallback so Chinese/Japanese/Korean glyphs render regardless
+     of the (often Latin-only) theme font. This replaces a blanket :lang(zh)
+     override that used to discard the theme font entirely. */
+  font-family: var(--user-ui-font, var(--font-sans)), var(--font-cjk);
+  /* An explicit user size (--user-ui-font-size) wins; otherwise the active
+     theme/DESIGN type-scale (--text-base); otherwise the 1rem default. This is
+     backward-compatible — with neither var set it resolves to exactly 1rem.
+     (Previously this was a hardcoded 1rem that, being unlayered, silently
+     overrode the app's --user-ui-font-size font-size control.) */
+  font-size: var(--user-ui-font-size, var(--text-base, 1rem));
+  line-height: 1.5;
+  font-weight: 400;
+}
+
+/* Headings */
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  font-family: var(--font-heading), var(--font-cjk);
+  /* Theme/DESIGN can lighten headings via fontWeight.heading; default 600. */
+  font-weight: var(--font-weight-heading, 600);
+  line-height: 1.25;
+}
+
+/* Code */
+code,
+kbd,
+pre,
+samp {
+  font-family: var(--user-code-font, var(--font-mono)), var(--font-cjk);
+}
+
+/* ============================================
+   Font Feature Settings
+   ============================================ */
+
+/* Enable tabular figures for numbers in tables */
+.tabular-nums {
+  font-feature-settings: "tnum" 1;
+}
+
+/* Enable case-sensitive forms for all-caps text */
+.case-sensitive {
+  font-feature-settings: "case" 1;
+}
+
+/* ============================================
+   CJK Support
+   ============================================ */
+
+/* No blanket :lang(zh) font-family override here. The CJK stack is appended as
+   a fallback on the body / heading / code rules above, so the active theme or
+   DESIGN.md font drives Latin text on every locale while CJK glyphs still fall
+   back to --font-cjk. (A blanket override would discard the theme font.) */