@nebutra/ui 2.0.0 → 3.0.0

package/dist/typography/index.d.ts

@@ -104,44 +104,28 @@ declare const fontLicenseNotice: string;
  * Centralized typography configuration for the entire design system.
  * All font-related values should come from here.
  */
-/**
- * Primary font stack - Used for body text and UI.
- *
- * Token-first so next/font's generated face wins when available; the literal
- * family stack remains as a standalone fallback for docs/tests.
- */
-declare const FONT_FAMILY_PRIMARY = "var(--font-sans, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
-/**
- * Heading font stack - Used for titles and emphasis
- *
- * Geist Sans is the primary display typeface.
- */
-declare const FONT_FAMILY_HEADING = "var(--font-heading, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
-/**
- * Monospace font stack - Used for code and technical content
- */
-declare const FONT_FAMILY_MONO = "var(--font-mono, var(--font-geist-mono, \"Geist Mono\", ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, monospace))";
-/**
- * CJK (Chinese/Japanese/Korean) fallback stack
- *
- * Noto Sans SC is the primary Chinese font.
- * Provides consistent rendering for Chinese, Japanese, and Korean text.
- */
-declare const FONT_FAMILY_CJK = "\"Noto Sans SC\", \"Source Han Sans SC\", \"Source Han Sans\", \"Noto Sans CJK SC\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei\", sans-serif";
+/** Primary font stack — body text and UI. */
+declare const FONT_FAMILY_PRIMARY: string;
+/** Heading font stack — titles and emphasis (DM Sans, CJK through MiSans). */
+declare const FONT_FAMILY_HEADING: string;
+/** Monospace font stack — code and technical content. */
+declare const FONT_FAMILY_MONO: string;
+/** CJK-locale stack — MiSans behind the Latin face, system CJK faces after it. */
+declare const FONT_FAMILY_CJK: string;
 /**
  * Complete font stacks with CJK fallback
  */
 declare const fontFamilies: {
     /** Primary UI and body text */
-    readonly primary: "var(--font-sans, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+    readonly primary: string;
     /** Headings and titles */
-    readonly heading: "var(--font-heading, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+    readonly heading: string;
     /** Code and monospace */
-    readonly mono: "var(--font-mono, var(--font-geist-mono, \"Geist Mono\", ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, monospace))";
+    readonly mono: string;
     /** CJK-specific fallback */
-    readonly cjk: "\"Noto Sans SC\", \"Source Han Sans SC\", \"Source Han Sans\", \"Noto Sans CJK SC\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei\", sans-serif";
+    readonly cjk: string;
     /** Primary with CJK fallback for multilingual content */
-    readonly primaryCJK: "var(--font-sans, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif)), \"Noto Sans SC\", \"Source Han Sans SC\", \"Source Han Sans\", \"Noto Sans CJK SC\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei\", sans-serif";
+    readonly primaryCJK: `${string}, ${string}`;
     /** System font stack (fast fallback, no web fonts) */
     readonly system: "-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif";
 };
@@ -269,7 +253,7 @@ declare const letterSpacing: {
 declare const typeStyles: {
     /** Hero/Display - Large marketing headlines */
     readonly display: {
-        readonly fontFamily: "var(--font-heading, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+        readonly fontFamily: string;
         readonly fontSize: "3.75rem";
         readonly fontWeight: 700;
         readonly lineHeight: 1.25;
@@ -277,7 +261,7 @@ declare const typeStyles: {
     };
     /** H1 - Page titles */
     readonly h1: {
-        readonly fontFamily: "var(--font-heading, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+        readonly fontFamily: string;
         readonly fontSize: "3rem";
         readonly fontWeight: 700;
         readonly lineHeight: 1.25;
@@ -285,7 +269,7 @@ declare const typeStyles: {
     };
     /** H2 - Section titles */
     readonly h2: {
-        readonly fontFamily: "var(--font-heading, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+        readonly fontFamily: string;
         readonly fontSize: "2.25rem";
         readonly fontWeight: 700;
         readonly lineHeight: 1.25;
@@ -293,7 +277,7 @@ declare const typeStyles: {
     };
     /** H3 - Subsection titles */
     readonly h3: {
-        readonly fontFamily: "var(--font-heading, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+        readonly fontFamily: string;
         readonly fontSize: "1.875rem";
         readonly fontWeight: 600;
         readonly lineHeight: 1.375;
@@ -301,7 +285,7 @@ declare const typeStyles: {
     };
     /** H4 - Card titles, small sections */
     readonly h4: {
-        readonly fontFamily: "var(--font-heading, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+        readonly fontFamily: string;
         readonly fontSize: "1.5rem";
         readonly fontWeight: 600;
         readonly lineHeight: 1.375;
@@ -309,7 +293,7 @@ declare const typeStyles: {
     };
     /** H5 - Widget titles */
     readonly h5: {
-        readonly fontFamily: "var(--font-heading, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+        readonly fontFamily: string;
         readonly fontSize: "1.25rem";
         readonly fontWeight: 600;
         readonly lineHeight: 1.5;
@@ -317,7 +301,7 @@ declare const typeStyles: {
     };
     /** H6 - Smallest heading */
     readonly h6: {
-        readonly fontFamily: "var(--font-heading, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+        readonly fontFamily: string;
         readonly fontSize: "1.125rem";
         readonly fontWeight: 600;
         readonly lineHeight: 1.5;
@@ -325,7 +309,7 @@ declare const typeStyles: {
     };
     /** Body - Default paragraph text */
     readonly body: {
-        readonly fontFamily: "var(--font-sans, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+        readonly fontFamily: string;
         readonly fontSize: "1rem";
         readonly fontWeight: 400;
         readonly lineHeight: 1.5;
@@ -333,7 +317,7 @@ declare const typeStyles: {
     };
     /** Body Large - Lead paragraphs */
     readonly bodyLarge: {
-        readonly fontFamily: "var(--font-sans, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+        readonly fontFamily: string;
         readonly fontSize: "1.125rem";
         readonly fontWeight: 400;
         readonly lineHeight: 1.625;
@@ -341,7 +325,7 @@ declare const typeStyles: {
     };
     /** Body Small - Secondary text */
     readonly bodySmall: {
-        readonly fontFamily: "var(--font-sans, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+        readonly fontFamily: string;
         readonly fontSize: "0.875rem";
         readonly fontWeight: 400;
         readonly lineHeight: 1.5;
@@ -349,7 +333,7 @@ declare const typeStyles: {
     };
     /** Caption - Image captions, timestamps */
     readonly caption: {
-        readonly fontFamily: "var(--font-sans, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+        readonly fontFamily: string;
         readonly fontSize: "0.75rem";
         readonly fontWeight: 400;
         readonly lineHeight: 1.5;
@@ -357,7 +341,7 @@ declare const typeStyles: {
     };
     /** Label - Form labels, UI labels */
     readonly label: {
-        readonly fontFamily: "var(--font-sans, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+        readonly fontFamily: string;
         readonly fontSize: "0.875rem";
         readonly fontWeight: 500;
         readonly lineHeight: 1.25;
@@ -365,7 +349,7 @@ declare const typeStyles: {
     };
     /** Button - Button text */
     readonly button: {
-        readonly fontFamily: "var(--font-sans, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+        readonly fontFamily: string;
         readonly fontSize: "0.875rem";
         readonly fontWeight: 500;
         readonly lineHeight: 1.25;
@@ -373,7 +357,7 @@ declare const typeStyles: {
     };
     /** Code - Inline code */
     readonly code: {
-        readonly fontFamily: "var(--font-mono, var(--font-geist-mono, \"Geist Mono\", ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, monospace))";
+        readonly fontFamily: string;
         readonly fontSize: "0.875rem";
         readonly fontWeight: 400;
         readonly lineHeight: 1.5;
@@ -381,7 +365,7 @@ declare const typeStyles: {
     };
     /** Code Block - Code blocks */
     readonly codeBlock: {
-        readonly fontFamily: "var(--font-mono, var(--font-geist-mono, \"Geist Mono\", ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, monospace))";
+        readonly fontFamily: string;
         readonly fontSize: "0.875rem";
         readonly fontWeight: 400;
         readonly lineHeight: 1.625;
@@ -389,7 +373,7 @@ declare const typeStyles: {
     };
     /** Overline - Small caps labels */
     readonly overline: {
-        readonly fontFamily: "var(--font-sans, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))";
+        readonly fontFamily: string;
         readonly fontSize: "0.75rem";
         readonly fontWeight: 600;
         readonly lineHeight: 1.5;

package/dist/typography/index.js

@@ -1,3 +1,5 @@
+import { tokenValue } from '@nebutra/tokens/values';
+
 // src/typography/fonts.ts
 var fonts = {
   geistSans: {
@@ -48,15 +50,25 @@ var fonts = {
     license: "OFL",
     licenseUrl: "https://github.com/JetBrains/JetBrainsMono/blob/master/OFL.txt"
   },
-  sourceHanSans: {
-    family: "Noto Sans SC",
-    weights: [400, 500, 700],
+  dmSans: {
+    family: "DM Sans",
+    weights: [400, 500, 600],
     italic: false,
     display: "swap",
-    variable: false,
-    googleFontsParam: "Noto+Sans+SC:wght@400;500;700",
+    variable: true,
+    selfHostUrl: "@nebutra/fonts/next/cjk (dmSans)",
     license: "OFL",
-    licenseUrl: "https://github.com/adobe-fonts/source-han-sans/blob/master/LICENSE.txt"
+    licenseUrl: "https://github.com/googlefonts/dm-fonts/blob/main/OFL.txt"
+  },
+  misans: {
+    family: "MiSans",
+    weights: [400, 500, 600, 700],
+    italic: false,
+    display: "swap",
+    variable: false,
+    selfHostUrl: "@nebutra/fonts/next/cjk (misans)",
+    license: "Other",
+    licenseUrl: "https://hyperos.mi.com/font/zh/download/"
   }
 };
 function getGoogleFontsUrl(fontKeys) {
@@ -65,7 +77,7 @@ function getGoogleFontsUrl(fontKeys) {
   return `https://fonts.googleapis.com/css2?family=${families}&display=swap`;
 }
 var defaultFonts = ["geistSans", "geistMono"];
-var cjkFonts = ["sourceHanSans"];
+var cjkFonts = ["misans"];
 var allFonts = [...defaultFonts, ...cjkFonts];
 function getFontPreloadLinks(fontKeys) {
   return fontKeys.map((key) => {
@@ -131,16 +143,16 @@ Fonts used in this project are licensed under open-source licenses:
 - Geist: SIL Open Font License 1.1
 - Geist Mono: SIL Open Font License 1.1
 - JetBrains Mono: SIL Open Font License 1.1
-- Noto Sans SC (Source Han Sans): SIL Open Font License 1.1
+- DM Sans: SIL Open Font License 1.1
+- MiSans (Xiaomi): free for commercial use; embedding requires stating that MiSans is used
 
 All fonts are free for commercial use. See individual license files for details.
 `.trim();
-
-// src/typography/tokens.ts
-var FONT_FAMILY_PRIMARY = 'var(--font-sans, var(--font-geist-sans, "Geist", "Noto Sans SC", "PingFang SC", "Microsoft YaHei", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif))';
-var FONT_FAMILY_HEADING = 'var(--font-heading, var(--font-geist-sans, "Geist", "Noto Sans SC", "PingFang SC", "Microsoft YaHei", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif))';
-var FONT_FAMILY_MONO = 'var(--font-mono, var(--font-geist-mono, "Geist Mono", ui-monospace, SFMono-Regular, "SF Mono", Menlo, monospace))';
-var FONT_FAMILY_CJK = '"Noto Sans SC", "Source Han Sans SC", "Source Han Sans", "Noto Sans CJK SC", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif';
+var tokenFirst = (name) => `var(${name}, ${tokenValue(name)})`;
+var FONT_FAMILY_PRIMARY = tokenFirst("--font-sans");
+var FONT_FAMILY_HEADING = tokenFirst("--font-heading");
+var FONT_FAMILY_MONO = tokenFirst("--font-mono");
+var FONT_FAMILY_CJK = tokenFirst("--font-cn");
 var fontFamilies = {
   /** Primary UI and body text */
   primary: FONT_FAMILY_PRIMARY,

package/dist/typography/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/typography/fonts.ts","../../src/typography/tokens.ts"],"names":["fontFamilies"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Font Configuration and Loading Utilities\n *\n * Handles web font loading, preloading, and performance optimization.\n */\n\n// ============================================\n// Font Definitions\n// ============================================\n\n/**\n * Font configuration object\n */\nexport interface FontConfig {\n  /** Font family name */\n  family: string;\n  /** Font weights to load */\n  weights: number[];\n  /** Include italic variants */\n  italic?: boolean;\n  /** Font display strategy */\n  display?: \"auto\" | \"block\" | \"swap\" | \"fallback\" | \"optional\";\n  /** Is this a variable font */\n  variable?: boolean;\n  /** Google Fonts URL parameter name */\n  googleFontsParam?: string;\n  /** Self-hosted font URL */\n  selfHostUrl?: string;\n  /** Font license */\n  license: \"OFL\" | \"Apache-2.0\" | \"Ubuntu\" | \"MIT\" | \"Other\";\n  /** Source URL for license */\n  licenseUrl?: string;\n}\n\n/**\n * Registered fonts for the design system\n */\nexport const fonts: Record<string, FontConfig> = {\n  geistSans: {\n    family: \"Geist\",\n    weights: [300, 400, 500, 600, 700],\n    italic: false,\n    display: \"swap\",\n    variable: true,\n    license: \"OFL\",\n    licenseUrl: \"https://github.com/vercel/geist-font/blob/main/LICENSE.txt\",\n  },\n\n  geistMono: {\n    family: \"Geist Mono\",\n    weights: [400, 500, 600, 700],\n    italic: false,\n    display: \"swap\",\n    variable: true,\n    license: \"OFL\",\n    licenseUrl: \"https://github.com/vercel/geist-font/blob/main/LICENSE.txt\",\n  },\n\n  inter: {\n    family: \"Inter\",\n    weights: [300, 400, 500, 600, 700],\n    italic: false,\n    display: \"swap\",\n    variable: true,\n    googleFontsParam: \"Inter:wght@300;400;500;600;700\",\n    license: \"OFL\",\n    licenseUrl: \"https://github.com/rsms/inter/blob/master/LICENSE.txt\",\n  },\n\n  publicSans: {\n    family: \"Public Sans\",\n    weights: [300, 400, 500, 600, 700],\n    italic: true,\n    display: \"swap\",\n    variable: true,\n    googleFontsParam: \"Public+Sans:ital,wght@0,300;0,400;0,500;0,600;0,700;1,400;1,500\",\n    license: \"OFL\",\n    licenseUrl: \"https://github.com/uswds/public-sans/blob/develop/LICENSE.md\",\n  },\n\n  jetbrainsMono: {\n    family: \"JetBrains Mono\",\n    weights: [400, 500, 700],\n    italic: false,\n    display: \"swap\",\n    variable: true,\n    googleFontsParam: \"JetBrains+Mono:wght@400;500;700\",\n    license: \"OFL\",\n    licenseUrl: \"https://github.com/JetBrains/JetBrainsMono/blob/master/OFL.txt\",\n  },\n\n  sourceHanSans: {\n    family: \"Noto Sans SC\",\n    weights: [400, 500, 700],\n    italic: false,\n    display: \"swap\",\n    variable: false,\n    googleFontsParam: \"Noto+Sans+SC:wght@400;500;700\",\n    license: \"OFL\",\n    licenseUrl: \"https://github.com/adobe-fonts/source-han-sans/blob/master/LICENSE.txt\",\n  },\n};\n\n// ============================================\n// Google Fonts URL Builder\n// ============================================\n\n/**\n * Generate Google Fonts URL for specified fonts\n */\nexport function getGoogleFontsUrl(fontKeys: (keyof typeof fonts)[]): string {\n  const families = fontKeys\n    .map((key) => fonts[key]?.googleFontsParam)\n    .filter(Boolean)\n    .join(\"&family=\");\n\n  if (!families) return \"\";\n\n  return `https://fonts.googleapis.com/css2?family=${families}&display=swap`;\n}\n\n/**\n * Default fonts to load\n */\nexport const defaultFonts: (keyof typeof fonts)[] = [\"geistSans\", \"geistMono\"];\n\n/**\n * Fonts for CJK (Chinese) support\n */\nexport const cjkFonts: (keyof typeof fonts)[] = [\"sourceHanSans\"];\n\n/**\n * All fonts including CJK\n */\nexport const allFonts: (keyof typeof fonts)[] = [...defaultFonts, ...cjkFonts];\n\n// ============================================\n// Font Loading Utilities\n// ============================================\n\n/**\n * Generate preload link elements for critical fonts\n */\nexport function getFontPreloadLinks(fontKeys: (keyof typeof fonts)[]): string[] {\n  return fontKeys\n    .map((key) => {\n      const font = fonts[key];\n      if (!font) return \"\";\n\n      const url = getGoogleFontsUrl([key]);\n      return `<link rel=\"preload\" href=\"${url}\" as=\"style\" crossorigin>`;\n    })\n    .filter(Boolean);\n}\n\n/**\n * Generate link element for Google Fonts\n */\nexport function getGoogleFontsLink(fontKeys: (keyof typeof fonts)[]): string {\n  const url = getGoogleFontsUrl(fontKeys);\n  if (!url) return \"\";\n\n  return `<link rel=\"stylesheet\" href=\"${url}\">`;\n}\n\n/**\n * Check if fonts are loaded\n */\nexport async function areFontsLoaded(fontFamilies: string[]): Promise<boolean> {\n  if (typeof document === \"undefined\") return false;\n\n  try {\n    await Promise.all(fontFamilies.map((family) => document.fonts.load(`16px \"${family}\"`)));\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Wait for fonts to load with timeout\n */\nexport async function waitForFonts(fontFamilies: string[], timeout = 3000): Promise<boolean> {\n  if (typeof document === \"undefined\") return false;\n\n  return new Promise((resolve) => {\n    const timer = setTimeout(() => resolve(false), timeout);\n\n    areFontsLoaded(fontFamilies).then((loaded) => {\n      clearTimeout(timer);\n      resolve(loaded);\n    });\n  });\n}\n\n// ============================================\n// CSS-in-JS Helpers\n// ============================================\n\n/**\n * Font smoothing CSS for crisp text rendering\n */\nexport const fontSmoothing = {\n  WebkitFontSmoothing: \"antialiased\",\n  MozOsxFontSmoothing: \"grayscale\",\n  textRendering: \"optimizeLegibility\",\n} as const;\n\n/**\n * Font feature settings for Geist\n */\nexport const fontFeatureSettings = {\n  /** Enable common ligatures and contextual alternates */\n  normal: '\"calt\" 1, \"liga\" 1',\n  /** Enable tabular figures for aligned numbers */\n  tabular: '\"tnum\" 1, \"calt\" 1',\n  /** Enable case-sensitive forms */\n  case: '\"case\" 1',\n  /** Enable stylistic set 01 (alternate digits) */\n  ss01: '\"ss01\" 1',\n  /** Enable stylistic set 02 (alternate a) */\n  ss02: '\"ss02\" 1',\n} as const;\n\n// ============================================\n// License Information\n// ============================================\n\n/**\n * Get license information for all used fonts\n */\nexport function getFontLicenses(): Array<{\n  family: string;\n  license: string;\n  url?: string | undefined;\n}> {\n  return Object.values(fonts).map((font) => ({\n    family: font.family,\n    license: font.license,\n    url: font.licenseUrl,\n  }));\n}\n\n/**\n * Font license compliance notice\n */\nexport const fontLicenseNotice = `\nFonts used in this project are licensed under open-source licenses:\n\n- Inter: SIL Open Font License 1.1\n- Public Sans: SIL Open Font License 1.1\n- Geist: SIL Open Font License 1.1\n- Geist Mono: SIL Open Font License 1.1\n- JetBrains Mono: SIL Open Font License 1.1\n- Noto Sans SC (Source Han Sans): SIL Open Font License 1.1\n\nAll fonts are free for commercial use. See individual license files for details.\n`.trim();\n","/**\n * Typography Tokens\n *\n * Centralized typography configuration for the entire design system.\n * All font-related values should come from here.\n */\n\n// ============================================\n// Font Families\n// ============================================\n\n/**\n * Primary font stack - Used for body text and UI.\n *\n * Token-first so next/font's generated face wins when available; the literal\n * family stack remains as a standalone fallback for docs/tests.\n */\nexport const FONT_FAMILY_PRIMARY =\n  'var(--font-sans, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))';\n\n/**\n * Heading font stack - Used for titles and emphasis\n *\n * Geist Sans is the primary display typeface.\n */\nexport const FONT_FAMILY_HEADING =\n  'var(--font-heading, var(--font-geist-sans, \"Geist\", \"Noto Sans SC\", \"PingFang SC\", \"Microsoft YaHei\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif))';\n\n/**\n * Monospace font stack - Used for code and technical content\n */\nexport const FONT_FAMILY_MONO =\n  'var(--font-mono, var(--font-geist-mono, \"Geist Mono\", ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, monospace))';\n\n/**\n * CJK (Chinese/Japanese/Korean) fallback stack\n *\n * Noto Sans SC is the primary Chinese font.\n * Provides consistent rendering for Chinese, Japanese, and Korean text.\n */\nexport const FONT_FAMILY_CJK =\n  '\"Noto Sans SC\", \"Source Han Sans SC\", \"Source Han Sans\", \"Noto Sans CJK SC\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei\", sans-serif';\n\n/**\n * Complete font stacks with CJK fallback\n */\nexport const fontFamilies = {\n  /** Primary UI and body text */\n  primary: FONT_FAMILY_PRIMARY,\n\n  /** Headings and titles */\n  heading: FONT_FAMILY_HEADING,\n\n  /** Code and monospace */\n  mono: FONT_FAMILY_MONO,\n\n  /** CJK-specific fallback */\n  cjk: FONT_FAMILY_CJK,\n\n  /** Primary with CJK fallback for multilingual content */\n  primaryCJK: `${FONT_FAMILY_PRIMARY}, ${FONT_FAMILY_CJK}`,\n\n  /** System font stack (fast fallback, no web fonts) */\n  system: '-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif',\n} as const;\n\n// ============================================\n// Type Scale\n// ============================================\n\n/**\n * Font size scale using rem units for accessibility\n *\n * Base: 16px = 1rem\n * Each step follows a modular scale (~1.25 ratio)\n */\nexport const fontSizes = {\n  /** 12px - Micro text, badges */\n  xs: \"0.75rem\",\n\n  /** 14px - Small text, captions, labels */\n  sm: \"0.875rem\",\n\n  /** 16px - Base body text */\n  base: \"1rem\",\n\n  /** 18px - Lead text, larger body */\n  lg: \"1.125rem\",\n\n  /** 20px - Small headings, subtitles */\n  xl: \"1.25rem\",\n\n  /** 24px - H4 equivalent */\n  \"2xl\": \"1.5rem\",\n\n  /** 30px - H3 equivalent */\n  \"3xl\": \"1.875rem\",\n\n  /** 36px - H2 equivalent */\n  \"4xl\": \"2.25rem\",\n\n  /** 48px - H1 equivalent */\n  \"5xl\": \"3rem\",\n\n  /** 60px - Display/Hero text */\n  \"6xl\": \"3.75rem\",\n\n  /** 72px - Large display */\n  \"7xl\": \"4.5rem\",\n\n  /** 96px - Extra large display */\n  \"8xl\": \"6rem\",\n} as const;\n\n/**\n * Font size in pixels (for cases where rem isn't suitable)\n */\nexport const fontSizesPx = {\n  xs: 12,\n  sm: 14,\n  base: 16,\n  lg: 18,\n  xl: 20,\n  \"2xl\": 24,\n  \"3xl\": 30,\n  \"4xl\": 36,\n  \"5xl\": 48,\n  \"6xl\": 60,\n  \"7xl\": 72,\n  \"8xl\": 96,\n} as const;\n\n// ============================================\n// Line Heights\n// ============================================\n\n/**\n * Line height scale\n *\n * Using unitless values for better inheritance.\n */\nexport const lineHeights = {\n  /** 1 - Single line, icons */\n  none: 1,\n\n  /** 1.25 - Tight, for large headings */\n  tight: 1.25,\n\n  /** 1.375 - Slightly snug */\n  snug: 1.375,\n\n  /** 1.5 - Normal body text */\n  normal: 1.5,\n\n  /** 1.625 - Relaxed reading */\n  relaxed: 1.625,\n\n  /** 1.75 - Loose, for small text */\n  loose: 1.75,\n\n  /** 2 - Double spaced */\n  double: 2,\n} as const;\n\n// ============================================\n// Font Weights\n// ============================================\n\n/**\n * Font weight scale\n *\n * Inter and Public Sans support all these weights.\n * Variable fonts can use any value 100-900.\n */\nexport const fontWeights = {\n  /** 100 - Thin (if available) */\n  thin: 100,\n\n  /** 200 - Extra light */\n  extralight: 200,\n\n  /** 300 - Light */\n  light: 300,\n\n  /** 400 - Regular/Normal */\n  normal: 400,\n\n  /** 500 - Medium */\n  medium: 500,\n\n  /** 600 - Semibold */\n  semibold: 600,\n\n  /** 700 - Bold */\n  bold: 700,\n\n  /** 800 - Extra bold */\n  extrabold: 800,\n\n  /** 900 - Black */\n  black: 900,\n} as const;\n\n// ============================================\n// Letter Spacing (Tracking)\n// ============================================\n\n/**\n * Letter spacing scale\n *\n * Negative values for tight headlines, positive for small caps.\n */\nexport const letterSpacing = {\n  /** -0.05em - Very tight, large display only */\n  tighter: \"-0.05em\",\n\n  /** -0.025em - Slightly tight, headings */\n  tight: \"-0.025em\",\n\n  /** 0 - Normal */\n  normal: \"0\",\n\n  /** 0.025em - Slightly wide */\n  wide: \"0.025em\",\n\n  /** 0.05em - Wide, for small caps */\n  wider: \"0.05em\",\n\n  /** 0.1em - Very wide, all caps */\n  widest: \"0.1em\",\n} as const;\n\n// ============================================\n// Combined Type Styles\n// ============================================\n\n/**\n * Pre-defined typography presets\n *\n * These combine font-family, size, weight, and line-height\n * for common use cases.\n */\nexport const typeStyles = {\n  /** Hero/Display - Large marketing headlines */\n  display: {\n    fontFamily: fontFamilies.heading,\n    fontSize: fontSizes[\"6xl\"],\n    fontWeight: fontWeights.bold,\n    lineHeight: lineHeights.tight,\n    letterSpacing: letterSpacing.tight,\n  },\n\n  /** H1 - Page titles */\n  h1: {\n    fontFamily: fontFamilies.heading,\n    fontSize: fontSizes[\"5xl\"],\n    fontWeight: fontWeights.bold,\n    lineHeight: lineHeights.tight,\n    letterSpacing: letterSpacing.tight,\n  },\n\n  /** H2 - Section titles */\n  h2: {\n    fontFamily: fontFamilies.heading,\n    fontSize: fontSizes[\"4xl\"],\n    fontWeight: fontWeights.bold,\n    lineHeight: lineHeights.tight,\n    letterSpacing: letterSpacing.tight,\n  },\n\n  /** H3 - Subsection titles */\n  h3: {\n    fontFamily: fontFamilies.heading,\n    fontSize: fontSizes[\"3xl\"],\n    fontWeight: fontWeights.semibold,\n    lineHeight: lineHeights.snug,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** H4 - Card titles, small sections */\n  h4: {\n    fontFamily: fontFamilies.heading,\n    fontSize: fontSizes[\"2xl\"],\n    fontWeight: fontWeights.semibold,\n    lineHeight: lineHeights.snug,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** H5 - Widget titles */\n  h5: {\n    fontFamily: fontFamilies.heading,\n    fontSize: fontSizes.xl,\n    fontWeight: fontWeights.semibold,\n    lineHeight: lineHeights.normal,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** H6 - Smallest heading */\n  h6: {\n    fontFamily: fontFamilies.heading,\n    fontSize: fontSizes.lg,\n    fontWeight: fontWeights.semibold,\n    lineHeight: lineHeights.normal,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** Body - Default paragraph text */\n  body: {\n    fontFamily: fontFamilies.primary,\n    fontSize: fontSizes.base,\n    fontWeight: fontWeights.normal,\n    lineHeight: lineHeights.normal,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** Body Large - Lead paragraphs */\n  bodyLarge: {\n    fontFamily: fontFamilies.primary,\n    fontSize: fontSizes.lg,\n    fontWeight: fontWeights.normal,\n    lineHeight: lineHeights.relaxed,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** Body Small - Secondary text */\n  bodySmall: {\n    fontFamily: fontFamilies.primary,\n    fontSize: fontSizes.sm,\n    fontWeight: fontWeights.normal,\n    lineHeight: lineHeights.normal,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** Caption - Image captions, timestamps */\n  caption: {\n    fontFamily: fontFamilies.primary,\n    fontSize: fontSizes.xs,\n    fontWeight: fontWeights.normal,\n    lineHeight: lineHeights.normal,\n    letterSpacing: letterSpacing.wide,\n  },\n\n  /** Label - Form labels, UI labels */\n  label: {\n    fontFamily: fontFamilies.primary,\n    fontSize: fontSizes.sm,\n    fontWeight: fontWeights.medium,\n    lineHeight: lineHeights.tight,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** Button - Button text */\n  button: {\n    fontFamily: fontFamilies.primary,\n    fontSize: fontSizes.sm,\n    fontWeight: fontWeights.medium,\n    lineHeight: lineHeights.tight,\n    letterSpacing: letterSpacing.wide,\n  },\n\n  /** Code - Inline code */\n  code: {\n    fontFamily: fontFamilies.mono,\n    fontSize: fontSizes.sm,\n    fontWeight: fontWeights.normal,\n    lineHeight: lineHeights.normal,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** Code Block - Code blocks */\n  codeBlock: {\n    fontFamily: fontFamilies.mono,\n    fontSize: fontSizes.sm,\n    fontWeight: fontWeights.normal,\n    lineHeight: lineHeights.relaxed,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** Overline - Small caps labels */\n  overline: {\n    fontFamily: fontFamilies.primary,\n    fontSize: fontSizes.xs,\n    fontWeight: fontWeights.semibold,\n    lineHeight: lineHeights.normal,\n    letterSpacing: letterSpacing.widest,\n    textTransform: \"uppercase\" as const,\n  },\n} as const;\n\nexport type TypeStyle = keyof typeof typeStyles;\n\n// ============================================\n// Responsive Typography\n// ============================================\n\n/**\n * Fluid typography clamp values\n *\n * Format: clamp(min, preferred, max)\n * Uses viewport width for smooth scaling.\n */\nexport const fluidFontSizes = {\n  /** Display: 36px to 72px */\n  display: \"clamp(2.25rem, 5vw + 1rem, 4.5rem)\",\n\n  /** H1: 30px to 48px */\n  h1: \"clamp(1.875rem, 4vw + 0.5rem, 3rem)\",\n\n  /** H2: 24px to 36px */\n  h2: \"clamp(1.5rem, 3vw + 0.5rem, 2.25rem)\",\n\n  /** H3: 20px to 30px */\n  h3: \"clamp(1.25rem, 2vw + 0.5rem, 1.875rem)\",\n\n  /** Body: 14px to 18px */\n  body: \"clamp(0.875rem, 1vw + 0.5rem, 1.125rem)\",\n} as const;\n\n// ============================================\n// Type Exports\n// ============================================\n\nexport type FontFamily = keyof typeof fontFamilies;\nexport type FontSize = keyof typeof fontSizes;\nexport type LineHeight = keyof typeof lineHeights;\nexport type FontWeight = keyof typeof fontWeights;\nexport type LetterSpacing = keyof typeof letterSpacing;\n"]}
+{"version":3,"sources":["../../src/typography/fonts.ts","../../src/typography/tokens.ts"],"names":["fontFamilies"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Font Configuration and Loading Utilities\n *\n * Handles web font loading, preloading, and performance optimization.\n */\n\n// ============================================\n// Font Definitions\n// ============================================\n\n/**\n * Font configuration object\n */\nexport interface FontConfig {\n  /** Font family name */\n  family: string;\n  /** Font weights to load */\n  weights: number[];\n  /** Include italic variants */\n  italic?: boolean;\n  /** Font display strategy */\n  display?: \"auto\" | \"block\" | \"swap\" | \"fallback\" | \"optional\";\n  /** Is this a variable font */\n  variable?: boolean;\n  /** Google Fonts URL parameter name */\n  googleFontsParam?: string;\n  /** Self-hosted font URL */\n  selfHostUrl?: string;\n  /** Font license */\n  license: \"OFL\" | \"Apache-2.0\" | \"Ubuntu\" | \"MIT\" | \"Other\";\n  /** Source URL for license */\n  licenseUrl?: string;\n}\n\n/**\n * Registered fonts for the design system\n */\nexport const fonts: Record<string, FontConfig> = {\n  geistSans: {\n    family: \"Geist\",\n    weights: [300, 400, 500, 600, 700],\n    italic: false,\n    display: \"swap\",\n    variable: true,\n    license: \"OFL\",\n    licenseUrl: \"https://github.com/vercel/geist-font/blob/main/LICENSE.txt\",\n  },\n\n  geistMono: {\n    family: \"Geist Mono\",\n    weights: [400, 500, 600, 700],\n    italic: false,\n    display: \"swap\",\n    variable: true,\n    license: \"OFL\",\n    licenseUrl: \"https://github.com/vercel/geist-font/blob/main/LICENSE.txt\",\n  },\n\n  inter: {\n    family: \"Inter\",\n    weights: [300, 400, 500, 600, 700],\n    italic: false,\n    display: \"swap\",\n    variable: true,\n    googleFontsParam: \"Inter:wght@300;400;500;600;700\",\n    license: \"OFL\",\n    licenseUrl: \"https://github.com/rsms/inter/blob/master/LICENSE.txt\",\n  },\n\n  publicSans: {\n    family: \"Public Sans\",\n    weights: [300, 400, 500, 600, 700],\n    italic: true,\n    display: \"swap\",\n    variable: true,\n    googleFontsParam: \"Public+Sans:ital,wght@0,300;0,400;0,500;0,600;0,700;1,400;1,500\",\n    license: \"OFL\",\n    licenseUrl: \"https://github.com/uswds/public-sans/blob/develop/LICENSE.md\",\n  },\n\n  jetbrainsMono: {\n    family: \"JetBrains Mono\",\n    weights: [400, 500, 700],\n    italic: false,\n    display: \"swap\",\n    variable: true,\n    googleFontsParam: \"JetBrains+Mono:wght@400;500;700\",\n    license: \"OFL\",\n    licenseUrl: \"https://github.com/JetBrains/JetBrainsMono/blob/master/OFL.txt\",\n  },\n\n  dmSans: {\n    family: \"DM Sans\",\n    weights: [400, 500, 600],\n    italic: false,\n    display: \"swap\",\n    variable: true,\n    selfHostUrl: \"@nebutra/fonts/next/cjk (dmSans)\",\n    license: \"OFL\",\n    licenseUrl: \"https://github.com/googlefonts/dm-fonts/blob/main/OFL.txt\",\n  },\n\n  misans: {\n    family: \"MiSans\",\n    weights: [400, 500, 600, 700],\n    italic: false,\n    display: \"swap\",\n    variable: false,\n    selfHostUrl: \"@nebutra/fonts/next/cjk (misans)\",\n    license: \"Other\",\n    licenseUrl: \"https://hyperos.mi.com/font/zh/download/\",\n  },\n};\n\n// ============================================\n// Google Fonts URL Builder\n// ============================================\n\n/**\n * Generate Google Fonts URL for specified fonts\n */\nexport function getGoogleFontsUrl(fontKeys: (keyof typeof fonts)[]): string {\n  const families = fontKeys\n    .map((key) => fonts[key]?.googleFontsParam)\n    .filter(Boolean)\n    .join(\"&family=\");\n\n  if (!families) return \"\";\n\n  return `https://fonts.googleapis.com/css2?family=${families}&display=swap`;\n}\n\n/**\n * Default fonts to load\n */\nexport const defaultFonts: (keyof typeof fonts)[] = [\"geistSans\", \"geistMono\"];\n\n/**\n * Fonts for CJK (Chinese) support\n */\nexport const cjkFonts: (keyof typeof fonts)[] = [\"misans\"];\n\n/**\n * All fonts including CJK\n */\nexport const allFonts: (keyof typeof fonts)[] = [...defaultFonts, ...cjkFonts];\n\n// ============================================\n// Font Loading Utilities\n// ============================================\n\n/**\n * Generate preload link elements for critical fonts\n */\nexport function getFontPreloadLinks(fontKeys: (keyof typeof fonts)[]): string[] {\n  return fontKeys\n    .map((key) => {\n      const font = fonts[key];\n      if (!font) return \"\";\n\n      const url = getGoogleFontsUrl([key]);\n      return `<link rel=\"preload\" href=\"${url}\" as=\"style\" crossorigin>`;\n    })\n    .filter(Boolean);\n}\n\n/**\n * Generate link element for Google Fonts\n */\nexport function getGoogleFontsLink(fontKeys: (keyof typeof fonts)[]): string {\n  const url = getGoogleFontsUrl(fontKeys);\n  if (!url) return \"\";\n\n  return `<link rel=\"stylesheet\" href=\"${url}\">`;\n}\n\n/**\n * Check if fonts are loaded\n */\nexport async function areFontsLoaded(fontFamilies: string[]): Promise<boolean> {\n  if (typeof document === \"undefined\") return false;\n\n  try {\n    await Promise.all(fontFamilies.map((family) => document.fonts.load(`16px \"${family}\"`)));\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Wait for fonts to load with timeout\n */\nexport async function waitForFonts(fontFamilies: string[], timeout = 3000): Promise<boolean> {\n  if (typeof document === \"undefined\") return false;\n\n  return new Promise((resolve) => {\n    const timer = setTimeout(() => resolve(false), timeout);\n\n    areFontsLoaded(fontFamilies).then((loaded) => {\n      clearTimeout(timer);\n      resolve(loaded);\n    });\n  });\n}\n\n// ============================================\n// CSS-in-JS Helpers\n// ============================================\n\n/**\n * Font smoothing CSS for crisp text rendering\n */\nexport const fontSmoothing = {\n  WebkitFontSmoothing: \"antialiased\",\n  MozOsxFontSmoothing: \"grayscale\",\n  textRendering: \"optimizeLegibility\",\n} as const;\n\n/**\n * Font feature settings for Geist\n */\nexport const fontFeatureSettings = {\n  /** Enable common ligatures and contextual alternates */\n  normal: '\"calt\" 1, \"liga\" 1',\n  /** Enable tabular figures for aligned numbers */\n  tabular: '\"tnum\" 1, \"calt\" 1',\n  /** Enable case-sensitive forms */\n  case: '\"case\" 1',\n  /** Enable stylistic set 01 (alternate digits) */\n  ss01: '\"ss01\" 1',\n  /** Enable stylistic set 02 (alternate a) */\n  ss02: '\"ss02\" 1',\n} as const;\n\n// ============================================\n// License Information\n// ============================================\n\n/**\n * Get license information for all used fonts\n */\nexport function getFontLicenses(): Array<{\n  family: string;\n  license: string;\n  url?: string | undefined;\n}> {\n  return Object.values(fonts).map((font) => ({\n    family: font.family,\n    license: font.license,\n    url: font.licenseUrl,\n  }));\n}\n\n/**\n * Font license compliance notice\n */\nexport const fontLicenseNotice = `\nFonts used in this project are licensed under open-source licenses:\n\n- Inter: SIL Open Font License 1.1\n- Public Sans: SIL Open Font License 1.1\n- Geist: SIL Open Font License 1.1\n- Geist Mono: SIL Open Font License 1.1\n- JetBrains Mono: SIL Open Font License 1.1\n- DM Sans: SIL Open Font License 1.1\n- MiSans (Xiaomi): free for commercial use; embedding requires stating that MiSans is used\n\nAll fonts are free for commercial use. See individual license files for details.\n`.trim();\n","/**\n * Typography Tokens\n *\n * Centralized typography configuration for the entire design system.\n * All font-related values should come from here.\n */\n\nimport { tokenValue } from \"@nebutra/tokens/values\";\n\n// ============================================\n// Font Families\n// ============================================\n\n/**\n * Font stacks as CSS values: the token first, then — for a surface that never\n * loaded the token stylesheet — the token's own declared value, read from\n * @nebutra/tokens/values. The fallback is the stylesheet, not a copy of it.\n */\nconst tokenFirst = (name: \"--font-sans\" | \"--font-heading\" | \"--font-mono\" | \"--font-cn\") =>\n  `var(${name}, ${tokenValue(name)})`;\n\n/** Primary font stack — body text and UI. */\nexport const FONT_FAMILY_PRIMARY = tokenFirst(\"--font-sans\");\n\n/** Heading font stack — titles and emphasis (DM Sans, CJK through MiSans). */\nexport const FONT_FAMILY_HEADING = tokenFirst(\"--font-heading\");\n\n/** Monospace font stack — code and technical content. */\nexport const FONT_FAMILY_MONO = tokenFirst(\"--font-mono\");\n\n/** CJK-locale stack — MiSans behind the Latin face, system CJK faces after it. */\nexport const FONT_FAMILY_CJK = tokenFirst(\"--font-cn\");\n\n/**\n * Complete font stacks with CJK fallback\n */\nexport const fontFamilies = {\n  /** Primary UI and body text */\n  primary: FONT_FAMILY_PRIMARY,\n\n  /** Headings and titles */\n  heading: FONT_FAMILY_HEADING,\n\n  /** Code and monospace */\n  mono: FONT_FAMILY_MONO,\n\n  /** CJK-specific fallback */\n  cjk: FONT_FAMILY_CJK,\n\n  /** Primary with CJK fallback for multilingual content */\n  primaryCJK: `${FONT_FAMILY_PRIMARY}, ${FONT_FAMILY_CJK}`,\n\n  /** System font stack (fast fallback, no web fonts) */\n  system: '-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif',\n} as const;\n\n// ============================================\n// Type Scale\n// ============================================\n\n/**\n * Font size scale using rem units for accessibility\n *\n * Base: 16px = 1rem\n * Each step follows a modular scale (~1.25 ratio)\n */\nexport const fontSizes = {\n  /** 12px - Micro text, badges */\n  xs: \"0.75rem\",\n\n  /** 14px - Small text, captions, labels */\n  sm: \"0.875rem\",\n\n  /** 16px - Base body text */\n  base: \"1rem\",\n\n  /** 18px - Lead text, larger body */\n  lg: \"1.125rem\",\n\n  /** 20px - Small headings, subtitles */\n  xl: \"1.25rem\",\n\n  /** 24px - H4 equivalent */\n  \"2xl\": \"1.5rem\",\n\n  /** 30px - H3 equivalent */\n  \"3xl\": \"1.875rem\",\n\n  /** 36px - H2 equivalent */\n  \"4xl\": \"2.25rem\",\n\n  /** 48px - H1 equivalent */\n  \"5xl\": \"3rem\",\n\n  /** 60px - Display/Hero text */\n  \"6xl\": \"3.75rem\",\n\n  /** 72px - Large display */\n  \"7xl\": \"4.5rem\",\n\n  /** 96px - Extra large display */\n  \"8xl\": \"6rem\",\n} as const;\n\n/**\n * Font size in pixels (for cases where rem isn't suitable)\n */\nexport const fontSizesPx = {\n  xs: 12,\n  sm: 14,\n  base: 16,\n  lg: 18,\n  xl: 20,\n  \"2xl\": 24,\n  \"3xl\": 30,\n  \"4xl\": 36,\n  \"5xl\": 48,\n  \"6xl\": 60,\n  \"7xl\": 72,\n  \"8xl\": 96,\n} as const;\n\n// ============================================\n// Line Heights\n// ============================================\n\n/**\n * Line height scale\n *\n * Using unitless values for better inheritance.\n */\nexport const lineHeights = {\n  /** 1 - Single line, icons */\n  none: 1,\n\n  /** 1.25 - Tight, for large headings */\n  tight: 1.25,\n\n  /** 1.375 - Slightly snug */\n  snug: 1.375,\n\n  /** 1.5 - Normal body text */\n  normal: 1.5,\n\n  /** 1.625 - Relaxed reading */\n  relaxed: 1.625,\n\n  /** 1.75 - Loose, for small text */\n  loose: 1.75,\n\n  /** 2 - Double spaced */\n  double: 2,\n} as const;\n\n// ============================================\n// Font Weights\n// ============================================\n\n/**\n * Font weight scale\n *\n * Inter and Public Sans support all these weights.\n * Variable fonts can use any value 100-900.\n */\nexport const fontWeights = {\n  /** 100 - Thin (if available) */\n  thin: 100,\n\n  /** 200 - Extra light */\n  extralight: 200,\n\n  /** 300 - Light */\n  light: 300,\n\n  /** 400 - Regular/Normal */\n  normal: 400,\n\n  /** 500 - Medium */\n  medium: 500,\n\n  /** 600 - Semibold */\n  semibold: 600,\n\n  /** 700 - Bold */\n  bold: 700,\n\n  /** 800 - Extra bold */\n  extrabold: 800,\n\n  /** 900 - Black */\n  black: 900,\n} as const;\n\n// ============================================\n// Letter Spacing (Tracking)\n// ============================================\n\n/**\n * Letter spacing scale\n *\n * Negative values for tight headlines, positive for small caps.\n */\nexport const letterSpacing = {\n  /** -0.05em - Very tight, large display only */\n  tighter: \"-0.05em\",\n\n  /** -0.025em - Slightly tight, headings */\n  tight: \"-0.025em\",\n\n  /** 0 - Normal */\n  normal: \"0\",\n\n  /** 0.025em - Slightly wide */\n  wide: \"0.025em\",\n\n  /** 0.05em - Wide, for small caps */\n  wider: \"0.05em\",\n\n  /** 0.1em - Very wide, all caps */\n  widest: \"0.1em\",\n} as const;\n\n// ============================================\n// Combined Type Styles\n// ============================================\n\n/**\n * Pre-defined typography presets\n *\n * These combine font-family, size, weight, and line-height\n * for common use cases.\n */\nexport const typeStyles = {\n  /** Hero/Display - Large marketing headlines */\n  display: {\n    fontFamily: fontFamilies.heading,\n    fontSize: fontSizes[\"6xl\"],\n    fontWeight: fontWeights.bold,\n    lineHeight: lineHeights.tight,\n    letterSpacing: letterSpacing.tight,\n  },\n\n  /** H1 - Page titles */\n  h1: {\n    fontFamily: fontFamilies.heading,\n    fontSize: fontSizes[\"5xl\"],\n    fontWeight: fontWeights.bold,\n    lineHeight: lineHeights.tight,\n    letterSpacing: letterSpacing.tight,\n  },\n\n  /** H2 - Section titles */\n  h2: {\n    fontFamily: fontFamilies.heading,\n    fontSize: fontSizes[\"4xl\"],\n    fontWeight: fontWeights.bold,\n    lineHeight: lineHeights.tight,\n    letterSpacing: letterSpacing.tight,\n  },\n\n  /** H3 - Subsection titles */\n  h3: {\n    fontFamily: fontFamilies.heading,\n    fontSize: fontSizes[\"3xl\"],\n    fontWeight: fontWeights.semibold,\n    lineHeight: lineHeights.snug,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** H4 - Card titles, small sections */\n  h4: {\n    fontFamily: fontFamilies.heading,\n    fontSize: fontSizes[\"2xl\"],\n    fontWeight: fontWeights.semibold,\n    lineHeight: lineHeights.snug,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** H5 - Widget titles */\n  h5: {\n    fontFamily: fontFamilies.heading,\n    fontSize: fontSizes.xl,\n    fontWeight: fontWeights.semibold,\n    lineHeight: lineHeights.normal,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** H6 - Smallest heading */\n  h6: {\n    fontFamily: fontFamilies.heading,\n    fontSize: fontSizes.lg,\n    fontWeight: fontWeights.semibold,\n    lineHeight: lineHeights.normal,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** Body - Default paragraph text */\n  body: {\n    fontFamily: fontFamilies.primary,\n    fontSize: fontSizes.base,\n    fontWeight: fontWeights.normal,\n    lineHeight: lineHeights.normal,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** Body Large - Lead paragraphs */\n  bodyLarge: {\n    fontFamily: fontFamilies.primary,\n    fontSize: fontSizes.lg,\n    fontWeight: fontWeights.normal,\n    lineHeight: lineHeights.relaxed,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** Body Small - Secondary text */\n  bodySmall: {\n    fontFamily: fontFamilies.primary,\n    fontSize: fontSizes.sm,\n    fontWeight: fontWeights.normal,\n    lineHeight: lineHeights.normal,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** Caption - Image captions, timestamps */\n  caption: {\n    fontFamily: fontFamilies.primary,\n    fontSize: fontSizes.xs,\n    fontWeight: fontWeights.normal,\n    lineHeight: lineHeights.normal,\n    letterSpacing: letterSpacing.wide,\n  },\n\n  /** Label - Form labels, UI labels */\n  label: {\n    fontFamily: fontFamilies.primary,\n    fontSize: fontSizes.sm,\n    fontWeight: fontWeights.medium,\n    lineHeight: lineHeights.tight,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** Button - Button text */\n  button: {\n    fontFamily: fontFamilies.primary,\n    fontSize: fontSizes.sm,\n    fontWeight: fontWeights.medium,\n    lineHeight: lineHeights.tight,\n    letterSpacing: letterSpacing.wide,\n  },\n\n  /** Code - Inline code */\n  code: {\n    fontFamily: fontFamilies.mono,\n    fontSize: fontSizes.sm,\n    fontWeight: fontWeights.normal,\n    lineHeight: lineHeights.normal,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** Code Block - Code blocks */\n  codeBlock: {\n    fontFamily: fontFamilies.mono,\n    fontSize: fontSizes.sm,\n    fontWeight: fontWeights.normal,\n    lineHeight: lineHeights.relaxed,\n    letterSpacing: letterSpacing.normal,\n  },\n\n  /** Overline - Small caps labels */\n  overline: {\n    fontFamily: fontFamilies.primary,\n    fontSize: fontSizes.xs,\n    fontWeight: fontWeights.semibold,\n    lineHeight: lineHeights.normal,\n    letterSpacing: letterSpacing.widest,\n    textTransform: \"uppercase\" as const,\n  },\n} as const;\n\nexport type TypeStyle = keyof typeof typeStyles;\n\n// ============================================\n// Responsive Typography\n// ============================================\n\n/**\n * Fluid typography clamp values\n *\n * Format: clamp(min, preferred, max)\n * Uses viewport width for smooth scaling.\n */\nexport const fluidFontSizes = {\n  /** Display: 36px to 72px */\n  display: \"clamp(2.25rem, 5vw + 1rem, 4.5rem)\",\n\n  /** H1: 30px to 48px */\n  h1: \"clamp(1.875rem, 4vw + 0.5rem, 3rem)\",\n\n  /** H2: 24px to 36px */\n  h2: \"clamp(1.5rem, 3vw + 0.5rem, 2.25rem)\",\n\n  /** H3: 20px to 30px */\n  h3: \"clamp(1.25rem, 2vw + 0.5rem, 1.875rem)\",\n\n  /** Body: 14px to 18px */\n  body: \"clamp(0.875rem, 1vw + 0.5rem, 1.125rem)\",\n} as const;\n\n// ============================================\n// Type Exports\n// ============================================\n\nexport type FontFamily = keyof typeof fontFamilies;\nexport type FontSize = keyof typeof fontSizes;\nexport type LineHeight = keyof typeof lineHeights;\nexport type FontWeight = keyof typeof fontWeights;\nexport type LetterSpacing = keyof typeof letterSpacing;\n"]}

package/dist/utils/index.d.ts

@@ -49,22 +49,28 @@ declare function withHtmlProps<E extends keyof React.JSX.IntrinsicElements, Extr
  * @see packages/design/ARCHITECTURE.md
  * @see packages/design/tokens/recipe.css
  */
-/** SSR fallbacks when document is unavailable */
+/**
+ * SSR fallbacks when document is unavailable — the light-mode token values,
+ * read from @nebutra/tokens/values rather than restated. Hand-copied, these
+ * had drifted: the product action was still the old blue after --primary
+ * became ink (a shader painted blue on the server and flipped to ink on
+ * hydration) and tertiary named a colour --brand-tertiary does not hold.
+ */
 declare const BRAND_FALLBACK: {
     /** VI 云毓蓝 — identity only */
-    readonly primary: "#0033FE";
-    readonly accent: "#0BF1C3";
-    readonly tertiary: "#5c7cfa";
-    readonly primaryDark: "#002ad4";
-    readonly backDark: "#000830";
-    /** Soft product action (matches themes/light --primary ≈ #254bfa) */
-    readonly productPrimary: "#254bfa";
+    readonly primary: string;
+    readonly accent: string;
+    readonly tertiary: string;
+    readonly primaryDark: string;
+    readonly backDark: string;
+    /** Product action — semantic --primary */
+    readonly productPrimary: string;
     /**
-     * Brand mark fallback (= product action when factory brand has action≡brand).
-     * Skins may diverge (e.g. Linear purple action + indigo mark).
+     * Brand mark fallback (= product action: the factory recipe sets
+     * --brand-mark: var(--primary)). Skins may diverge.
      */
-    readonly brandMark: "#254bfa";
-    readonly brandMarkForeground: "#ffffff";
+    readonly brandMark: string;
+    readonly brandMarkForeground: string;
 };
 /**
  * Read a CSS variable from :root and return its trimmed value.

package/dist/utils/index.js

@@ -1,11 +1,86 @@
 import { clsx } from 'clsx';
-import { twMerge } from 'tailwind-merge';
+import { extendTailwindMerge } from 'tailwind-merge';
+import { tokenColor, tokenValue } from '@nebutra/tokens/values';
 
 // src/utils/auth-surfaces.ts
 var AUTH_FORM_COLUMN_CLASS = "relative mx-auto min-w-0 w-[min(100%,360px)] shrink-0";
 var AUTH_PRIMARY_CTA_CLASS = "h-11 w-full";
 var AUTH_OAUTH_GRID_CLASS = "grid grid-cols-2 gap-2";
 var AUTH_OAUTH_BUTTON_CLASS = "h-9 w-full justify-center gap-2 border-border bg-background px-2.5 text-sm font-medium text-foreground shadow-none hover:bg-muted";
+
+// src/utils/tw-merge-theme.generated.ts
+var TW_MERGE_THEME = {
+  breakpoint: ["3xl", "shell", "tight", "xs"],
+  container: ["content", "text", "wide"],
+  ease: ["brand", "in", "in-out", "out", "spring"],
+  font: ["cn", "display", "heading", "mono", "sans"],
+  leading: ["display", "heading"],
+  radius: ["2xl", "3xl", "button", "card", "full", "lg", "md", "none", "panel", "sm", "xl", "xs"],
+  shadow: [
+    "2xl",
+    "ambient-glow",
+    "ambient-lg",
+    "ambient-md",
+    "ambient-sm",
+    "brand",
+    "brand-lg",
+    "glass-lg",
+    "glass-md",
+    "glass-sm",
+    "glow-accent",
+    "glow-accent-lg",
+    "glow-accent-sm",
+    "glow-primary",
+    "lg",
+    "md",
+    "sheen",
+    "sm",
+    "xl",
+    "xs"
+  ],
+  text: [
+    "2xl",
+    "2xs",
+    "3xl",
+    "4xl",
+    "5xl",
+    "6xl",
+    "7xl",
+    "8xl",
+    "9xl",
+    "base",
+    "body",
+    "display",
+    "label",
+    "lg",
+    "meta",
+    "sm",
+    "ui",
+    "xl",
+    "xs"
+  ],
+  tracking: ["display", "heading", "label", "tight"]
+};
+var TW_MERGE_CLASS_GROUPS = {
+  duration: [{ duration: ["cinematic", "flow", "micro", "reveal"] }]
+};
+
+// src/utils/cn.ts
+var twMerge = extendTailwindMerge({
+  extend: {
+    theme: Object.fromEntries(
+      Object.entries(TW_MERGE_THEME).map(([key, values]) => [key, [...values]])
+    ),
+    classGroups: Object.fromEntries(
+      Object.entries(TW_MERGE_CLASS_GROUPS).map(([key, groups]) => [
+        key,
+        groups.map(
+          (group) => Object.fromEntries(Object.entries(group).map(([k, v]) => [k, [...v]]))
+        )
+      ])
+    )
+  }
+});
 function cn(...inputs) {
   return twMerge(clsx(inputs));
 }
@@ -18,23 +93,21 @@ function asPlainStyle(style) {
 function withHtmlProps(Component) {
   return Component;
 }
-
-// src/utils/brand-colors.ts
 var BRAND_FALLBACK = {
   /** VI 云毓蓝 — identity only */
-  primary: "#0033FE",
-  accent: "#0BF1C3",
-  tertiary: "#5c7cfa",
-  primaryDark: "#002ad4",
-  backDark: "#000830",
-  /** Soft product action (matches themes/light --primary ≈ #254bfa) */
-  productPrimary: "#254bfa",
+  primary: tokenColor("--brand-primary"),
+  accent: tokenColor("--brand-accent"),
+  tertiary: tokenColor("--brand-tertiary"),
+  primaryDark: tokenColor("--nebutra-blue-600"),
+  backDark: tokenColor("--nebutra-blue-950"),
+  /** Product action — semantic --primary */
+  productPrimary: tokenColor("--primary"),
   /**
-   * Brand mark fallback (= product action when factory brand has action≡brand).
-   * Skins may diverge (e.g. Linear purple action + indigo mark).
+   * Brand mark fallback (= product action: the factory recipe sets
+   * --brand-mark: var(--primary)). Skins may diverge.
    */
-  brandMark: "#254bfa",
-  brandMarkForeground: "#ffffff"
+  brandMark: tokenColor("--primary"),
+  brandMarkForeground: tokenColor("--primary-foreground")
 };
 function readCssVar(name, fallback) {
   if (typeof window === "undefined" || typeof document === "undefined") {
@@ -51,23 +124,26 @@ function asCssColor(value, fallback) {
   return `hsl(${v})`;
 }
 function getProductPrimary() {
-  return asCssColor(readCssVar("--primary", "228 85% 56%"), BRAND_FALLBACK.productPrimary);
+  return asCssColor(
+    readCssVar("--primary", tokenValue("--primary")),
+    BRAND_FALLBACK.productPrimary
+  );
 }
 function getBrandPrimary() {
   return asCssVarColor("--brand-primary", BRAND_FALLBACK.primary);
 }
 function getBrandMark() {
-  const raw = readCssVar("--brand-mark", "228 85% 56%");
+  const raw = readCssVar("--brand-mark", tokenValue("--primary"));
   if (/var\(\s*--primary\s*\)/u.test(raw)) {
     return getProductPrimary();
   }
   return asCssColor(raw, BRAND_FALLBACK.brandMark);
 }
 function getBrandMarkForeground() {
-  const raw = readCssVar("--brand-mark-foreground", "0 0% 100%");
+  const raw = readCssVar("--brand-mark-foreground", tokenValue("--primary-foreground"));
   if (/var\(\s*--primary-foreground\s*\)/u.test(raw)) {
     return asCssColor(
-      readCssVar("--primary-foreground", "0 0% 100%"),
+      readCssVar("--primary-foreground", tokenValue("--primary-foreground")),
       BRAND_FALLBACK.brandMarkForeground
     );
   }