@nebutra/fonts 0.1.1 → 3.0.0

package/dist/next-cjk.d.ts

@@ -1,60 +1,55 @@
 import * as next_dist_compiled__next_font from 'next/dist/compiled/@next/font';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
- * @nebutra/fonts/next/cjk — the self-hosted Simplified-Chinese face (server-only).
+ * MiSans @font-face, rendered at request time rather than shipped as CSS.
  *
- * WHY A SEPARATE ENTRY FROM `./next`: that module declares ~16 `next/font/google`
- * faces for the theme / DESIGN.md registry. Importing it just to get the CJK face
- * would drag those build-time Google downloads into every app — and this repo has
- * a known trap where `next/font/google` fails outright in a network-sandboxed dev
- * server. This file imports `next/font/local` ONLY: the woff2 files ship in the
- * package, so it works offline, in CI, and in the sandbox. `./next` re-exports it,
- * so an app already applying `fontRegistryClassName` still only needs one import.
+ * The MiSans licence forbids distributing the font on its own and this
+ * repository is public, so the subsets live in the deployment's public asset
+ * bucket and only their keys are committed (../generated/index.ts). A static
+ * stylesheet would have to spell out a host, and the host differs per
+ * deployment: Nebutra's CDN for Nebutra, the scaffold's own for a template
+ * user. publicAssetUrl() resolves it the way it resolves every other public
+ * asset — NEXT_PUBLIC_R2_PUBLIC_URL, then R2_PUBLIC_URL, then the brand's cdn
+ * origin.
  *
- * WHY SELF-HOSTED AT ALL: Geist has no CJK coverage, so without this every Chinese
- * character falls back to whatever the OS supplies — PingFang on macOS, Microsoft
- * YaHei on Windows, something else on Android. Chinese copy is a first-class
- * surface here (see docs/microcopy/), so the face is pinned rather than left to
- * the OS.
- *
- * The files are built by `pnpm --filter @nebutra/fonts subset:cjk`; the literal
- * `src` list below mirrors VIVO_SANS_CN_SOURCES in ../generated/index.ts (a drift
- * test in ./next-cjk.test.ts asserts they agree). It is spelled out rather than
- * spread because next/font is a compile-time transform — SWC statically analyses
- * this call, so the options object cannot be computed.
- *
- * FONT ATTRIBUTION (vivo Sans 字体知识产权许可协议 clause 2.1):
- *   您应在软件中特别注明使用了vivo Sans 字体 — this software uses the vivo Sans
- *   typeface. See ../vendor/vivo-sans/LICENCE-vivo-Sans.txt and the package README.
+ * Before the subsets have been uploaded (a fresh scaffold, `pnpm subset:cjk
+ * --upload` not yet run) the requests 404 and the token stacks fall through to
+ * PingFang / YaHei. That is the intended degraded state, not an error.
  */
+/** One @font-face per weight, CJK-only unicode-range, `swap` so text is never invisible. */
+declare function misansFontFaceCss(origin?: string): string;
+interface CjkFontFaceProps {
+    /** Asset origin override; defaults to the publicAssetUrl() resolution. */
+    origin?: string;
+    /**
+     * CSP nonce, for apps whose style-src allows inline styles only by nonce
+     * (apps/web). Without it the whole @font-face block is refused. The page's
+     * font-src must also allow publicAssetOrigin().
+     */
+    nonce?: string;
+}
 /**
- * vivo Sans SC — 400 / 500 / 600 / 700 static subsets.
- *
- * - `preload: false` on purpose. Each weight is ~490 KB; preloading them on every
- *   route would tax Latin-only pages for nothing. The browser fetches a weight
- *   only when a glyph in the `unicode-range` below actually renders.
- * - `declarations` carries that `unicode-range` (CJK blocks only — no ASCII, no
- *   Latin, no general punctuation), so a Latin-only page can never trigger a CJK
- *   download even if a font stack somewhere is written the wrong way round. Curly
- *   quotes, the em dash and the ellipsis are deliberately left to Geist: they are
- *   the codepoints Latin and Chinese copy share.
- * - `adjustFontFallback: false` — next/font's metric-matched fallback is derived
- *   from Arial, which is meaningless for a Han face and would add a size-adjusted
- *   ghost face into the same family.
- * - 700 is a real Bold subset (not synthetic). Without it, CSS weight matching
- *   collapses 700 → 600 and the mixed-script ladder flattens against Geist.
- *   `font-synthesis: none` still forbids faux bold for any weight we do not ship.
+ * Render once in each root layout, next to `cjkFontClassName` on <html>.
+ * React 19 hoists a `<style>` carrying `href` + `precedence` into <head> and
+ * dedupes it by `href`, so rendering it twice costs nothing.
+ */
+declare function CjkFontFace({ origin, nonce }: CjkFontFaceProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * DM Sans — one variable file (opsz 9–40, wght 100–1000), Latin subset, 67KB.
+ * Preloaded: headings render above the fold on most pages.
  */
-declare const vivoSansCn: next_dist_compiled__next_font.NextFontWithVariable;
+declare const dmSans: next_dist_compiled__next_font.NextFontWithVariable;
 /**
- * Apply to <html> next to the Geist loaders so `--font-vivo-sans-sc` exists:
+ * Apply to <html> next to the Geist loaders so `--font-dm-sans` exists:
  *
  *   className={`${GeistSans.variable} ${GeistMono.variable} ${cjkFontClassName}`}
  *
- * The token stacks (`--font-sans` / `--font-cn` / `--font-display` in
- * @nebutra/tokens) reference the variable AFTER Geist, so Geist keeps Latin and
- * the numerals and only CJK falls through to this face.
+ * The name predates DM Sans; it now carries both brand faces so every app that
+ * already applies it picks them up without a layout change.
  */
+declare const brandFontClassName: string;
 declare const cjkFontClassName: string;
 
-export { cjkFontClassName, vivoSansCn };
+export { CjkFontFace, brandFontClassName, cjkFontClassName, dmSans, misansFontFaceCss };

package/dist/next-cjk.js

@@ -1,9 +1,16 @@
 import {
+  CjkFontFace,
+  brandFontClassName,
   cjkFontClassName,
-  vivoSansCn
-} from "./chunk-MI5GQA6D.js";
+  dmSans,
+  misansFontFaceCss
+} from "./chunk-JHYTIKKY.js";
+import "./chunk-FUPJK5RT.js";
 export {
+  CjkFontFace,
+  brandFontClassName,
   cjkFontClassName,
-  vivoSansCn
+  dmSans,
+  misansFontFaceCss
 };
 //# sourceMappingURL=next-cjk.js.map

package/dist/next.d.ts

@@ -1,8 +1,9 @@
 import * as next_dist_compiled__next_font from 'next/dist/compiled/@next/font';
-export { cjkFontClassName, vivoSansCn } from './next-cjk.js';
+export { CjkFontFace, brandFontClassName, cjkFontClassName, dmSans } from './next-cjk.js';
+import 'react/jsx-runtime';
 
 /** All registry faces, in declaration order. */
-declare const FONT_REGISTRY_FACES: readonly [next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable];
+declare const FONT_REGISTRY_FACES: readonly [next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable, next_dist_compiled__next_font.NextFontWithVariable];
 /**
  * Space-joined `.variable` classNames for every registry face. Apply to <html>
  * so all `--font-*` registry variables are defined (font files lazy-load on

package/dist/next.js

@@ -1,14 +1,19 @@
 import {
+  CjkFontFace,
+  brandFontClassName,
   cjkFontClassName,
-  vivoSansCn
-} from "./chunk-MI5GQA6D.js";
+  dmSans
+} from "./chunk-JHYTIKKY.js";
+import "./chunk-FUPJK5RT.js";
 
 // src/next.ts
 import {
   DM_Sans,
   Figtree,
   Fira_Code,
+  Fraunces,
   Inter,
+  Inter_Tight,
   JetBrains_Mono,
   Lexend,
   Manrope,
@@ -19,10 +24,16 @@ import {
   Roboto_Mono,
   Sora,
   Source_Code_Pro,
+  Source_Serif_4,
   Space_Grotesk,
   Work_Sans
 } from "next/font/google";
 var inter = Inter({ subsets: ["latin"], display: "swap", variable: "--font-inter" });
+var interTight = Inter_Tight({
+  subsets: ["latin"],
+  display: "swap",
+  variable: "--font-reg-inter-tight"
+});
 var spaceGrotesk = Space_Grotesk({
   subsets: ["latin"],
   display: "swap",
@@ -33,6 +44,11 @@ var playfairDisplay = Playfair_Display({
   display: "swap",
   variable: "--font-playfair-display"
 });
+var fraunces = Fraunces({
+  subsets: ["latin"],
+  display: "swap",
+  variable: "--font-reg-fraunces"
+});
 var jetbrainsMono = JetBrains_Mono({
   subsets: ["latin"],
   display: "swap",
@@ -45,7 +61,7 @@ var workSans = Work_Sans({
   display: "swap",
   variable: "--font-reg-work-sans"
 });
-var dmSans = DM_Sans({ subsets: ["latin"], display: "swap", variable: "--font-reg-dm-sans" });
+var dmSans2 = DM_Sans({ subsets: ["latin"], display: "swap", variable: "--font-reg-dm-sans" });
 var plusJakartaSans = Plus_Jakarta_Sans({
   subsets: ["latin"],
   display: "swap",
@@ -69,6 +85,11 @@ var robotoMono = Roboto_Mono({
   display: "swap",
   variable: "--font-reg-roboto-mono"
 });
+var sourceSerif4 = Source_Serif_4({
+  subsets: ["latin"],
+  display: "swap",
+  variable: "--font-reg-source-serif-4"
+});
 var sourceCodePro = Source_Code_Pro({
   subsets: ["latin"],
   display: "swap",
@@ -76,13 +97,16 @@ var sourceCodePro = Source_Code_Pro({
 });
 var FONT_REGISTRY_FACES = [
   inter,
+  interTight,
   spaceGrotesk,
   playfairDisplay,
+  sourceSerif4,
+  fraunces,
   jetbrainsMono,
   manrope,
   sora,
   workSans,
-  dmSans,
+  dmSans2,
   plusJakartaSans,
   outfit,
   figtree,
@@ -94,9 +118,11 @@ var FONT_REGISTRY_FACES = [
 ];
 var fontRegistryClassName = FONT_REGISTRY_FACES.map((face) => face.variable).join(" ");
 export {
+  CjkFontFace,
   FONT_REGISTRY_FACES,
+  brandFontClassName,
   cjkFontClassName,
-  fontRegistryClassName,
-  vivoSansCn
+  dmSans,
+  fontRegistryClassName
 };
 //# sourceMappingURL=next.js.map

package/dist/next.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/next.ts"],"sourcesContent":["/**\n * @nebutra/fonts/next — build-time self-hosted OSS font faces (server-only).\n *\n * Each face is loaded via next/font/google, which downloads the font AT BUILD\n * TIME and self-hosts it from the app's own origin — there are ZERO runtime\n * requests to Google (no IP leak / GDPR concern, no third-party runtime\n * dependency). Each face exposes a CSS variable; the browser only fetches a\n * given font file when an element actually uses that variable, so declaring the\n * whole registry is cheap.\n *\n * Apply `fontRegistryClassName` to <html> so the `--font-*` variables exist;\n * the appearance layer then prepends the matching `var(--font-*)` (see the\n * client-safe map in `@nebutra/fonts`) when a theme / DESIGN.md font matches.\n *\n * All declarations use a literal options object — next/font statically analyses\n * the call, so the config must NOT be computed. Variable fonts omit `weight`.\n * Keep the `variable` names in sync with FONT_REGISTRY in `../index.ts`.\n *\n * The self-hosted Simplified-Chinese face lives in `./next-cjk` (next/font/local,\n * no Google fetch) and is re-exported here for discoverability. It is NOT folded\n * into `fontRegistryClassName`: the CJK face is core typography, not an optional\n * theme face, and every app wires it the same way — `${cjkFontClassName}` on\n * <html> beside the Geist loaders. Apps that only need the CJK face should import\n * `@nebutra/fonts/next/cjk` directly so they don't pull in the Google faces below.\n */\n\nimport {\n  DM_Sans,\n  Figtree,\n  Fira_Code,\n  Inter,\n  JetBrains_Mono,\n  Lexend,\n  Manrope,\n  Montserrat,\n  Outfit,\n  Playfair_Display,\n  Plus_Jakarta_Sans,\n  Roboto_Mono,\n  Sora,\n  Source_Code_Pro,\n  Space_Grotesk,\n  Work_Sans,\n} from \"next/font/google\";\n\nexport { cjkFontClassName, vivoSansCn } from \"./next-cjk\";\n\nconst inter = Inter({ subsets: [\"latin\"], display: \"swap\", variable: \"--font-inter\" });\nconst spaceGrotesk = Space_Grotesk({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-space-grotesk\",\n});\nconst playfairDisplay = Playfair_Display({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-playfair-display\",\n});\nconst jetbrainsMono = JetBrains_Mono({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-jetbrains-mono\",\n});\nconst manrope = Manrope({ subsets: [\"latin\"], display: \"swap\", variable: \"--font-reg-manrope\" });\nconst sora = Sora({ subsets: [\"latin\"], display: \"swap\", variable: \"--font-reg-sora\" });\nconst workSans = Work_Sans({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-reg-work-sans\",\n});\nconst dmSans = DM_Sans({ subsets: [\"latin\"], display: \"swap\", variable: \"--font-reg-dm-sans\" });\nconst plusJakartaSans = Plus_Jakarta_Sans({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-reg-plus-jakarta-sans\",\n});\nconst outfit = Outfit({ subsets: [\"latin\"], display: \"swap\", variable: \"--font-reg-outfit\" });\nconst figtree = Figtree({ subsets: [\"latin\"], display: \"swap\", variable: \"--font-reg-figtree\" });\nconst montserrat = Montserrat({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-reg-montserrat\",\n});\nconst lexend = Lexend({ subsets: [\"latin\"], display: \"swap\", variable: \"--font-reg-lexend\" });\nconst firaCode = Fira_Code({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-reg-fira-code\",\n});\nconst robotoMono = Roboto_Mono({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-reg-roboto-mono\",\n});\nconst sourceCodePro = Source_Code_Pro({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-reg-source-code-pro\",\n});\n\n/** All registry faces, in declaration order. */\nexport const FONT_REGISTRY_FACES = [\n  inter,\n  spaceGrotesk,\n  playfairDisplay,\n  jetbrainsMono,\n  manrope,\n  sora,\n  workSans,\n  dmSans,\n  plusJakartaSans,\n  outfit,\n  figtree,\n  montserrat,\n  lexend,\n  firaCode,\n  robotoMono,\n  sourceCodePro,\n] as const;\n\n/**\n * Space-joined `.variable` classNames for every registry face. Apply to <html>\n * so all `--font-*` registry variables are defined (font files lazy-load on\n * first use). Combine with the app's own Geist faces.\n */\nexport const fontRegistryClassName = FONT_REGISTRY_FACES.map((face) => face.variable).join(\" \");\n"],"mappings":";;;;;;AA0BA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIP,IAAM,QAAQ,MAAM,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,QAAQ,UAAU,eAAe,CAAC;AACrF,IAAM,eAAe,cAAc;AAAA,EACjC,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,kBAAkB,iBAAiB;AAAA,EACvC,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,gBAAgB,eAAe;AAAA,EACnC,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,UAAU,QAAQ,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,QAAQ,UAAU,qBAAqB,CAAC;AAC/F,IAAM,OAAO,KAAK,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,QAAQ,UAAU,kBAAkB,CAAC;AACtF,IAAM,WAAW,UAAU;AAAA,EACzB,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,SAAS,QAAQ,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,QAAQ,UAAU,qBAAqB,CAAC;AAC9F,IAAM,kBAAkB,kBAAkB;AAAA,EACxC,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,SAAS,OAAO,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,QAAQ,UAAU,oBAAoB,CAAC;AAC5F,IAAM,UAAU,QAAQ,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,QAAQ,UAAU,qBAAqB,CAAC;AAC/F,IAAM,aAAa,WAAW;AAAA,EAC5B,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,SAAS,OAAO,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,QAAQ,UAAU,oBAAoB,CAAC;AAC5F,IAAM,WAAW,UAAU;AAAA,EACzB,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,aAAa,YAAY;AAAA,EAC7B,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,gBAAgB,gBAAgB;AAAA,EACpC,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AAGM,IAAM,sBAAsB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAOO,IAAM,wBAAwB,oBAAoB,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,KAAK,GAAG;","names":[]}
+{"version":3,"sources":["../src/next.ts"],"sourcesContent":["/**\n * @nebutra/fonts/next — build-time self-hosted OSS font faces (server-only).\n *\n * Each face is loaded via next/font/google, which downloads the font AT BUILD\n * TIME and self-hosts it from the app's own origin — there are ZERO runtime\n * requests to Google (no IP leak / GDPR concern, no third-party runtime\n * dependency). Each face exposes a CSS variable; the browser only fetches a\n * given font file when an element actually uses that variable, so declaring the\n * whole registry is cheap.\n *\n * Apply `fontRegistryClassName` to <html> so the `--font-*` variables exist;\n * the appearance layer then prepends the matching `var(--font-*)` (see the\n * client-safe map in `@nebutra/fonts`) when a theme / DESIGN.md font matches.\n *\n * All declarations use a literal options object — next/font statically analyses\n * the call, so the config must NOT be computed. Variable fonts omit `weight`.\n * Keep the `variable` names in sync with FONT_REGISTRY in `../index.ts`.\n *\n * The brand faces live in `./next-cjk` — DM Sans (next/font/local, no Google\n * fetch) and <CjkFontFace /> for the CDN-hosted MiSans — and are re-exported\n * here for discoverability. They are NOT folded into `fontRegistryClassName`:\n * they are core typography, not optional theme faces, and every app wires them\n * the same way — `${cjkFontClassName}` on <html> beside the Geist loaders and\n * <CjkFontFace /> in the root layout. Apps that only need them should import\n * `@nebutra/fonts/next/cjk` directly so they don't pull in the Google faces below.\n */\n\nimport {\n  DM_Sans,\n  Figtree,\n  Fira_Code,\n  Fraunces,\n  Inter,\n  Inter_Tight,\n  JetBrains_Mono,\n  Lexend,\n  Manrope,\n  Montserrat,\n  Outfit,\n  Playfair_Display,\n  Plus_Jakarta_Sans,\n  Roboto_Mono,\n  Sora,\n  Source_Code_Pro,\n  Source_Serif_4,\n  Space_Grotesk,\n  Work_Sans,\n} from \"next/font/google\";\n\nexport { brandFontClassName, CjkFontFace, cjkFontClassName, dmSans } from \"./next-cjk\";\n\nconst inter = Inter({ subsets: [\"latin\"], display: \"swap\", variable: \"--font-inter\" });\nconst interTight = Inter_Tight({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-reg-inter-tight\",\n});\nconst spaceGrotesk = Space_Grotesk({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-space-grotesk\",\n});\nconst playfairDisplay = Playfair_Display({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-playfair-display\",\n});\nconst fraunces = Fraunces({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-reg-fraunces\",\n});\nconst jetbrainsMono = JetBrains_Mono({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-jetbrains-mono\",\n});\nconst manrope = Manrope({ subsets: [\"latin\"], display: \"swap\", variable: \"--font-reg-manrope\" });\nconst sora = Sora({ subsets: [\"latin\"], display: \"swap\", variable: \"--font-reg-sora\" });\nconst workSans = Work_Sans({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-reg-work-sans\",\n});\nconst dmSans = DM_Sans({ subsets: [\"latin\"], display: \"swap\", variable: \"--font-reg-dm-sans\" });\nconst plusJakartaSans = Plus_Jakarta_Sans({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-reg-plus-jakarta-sans\",\n});\nconst outfit = Outfit({ subsets: [\"latin\"], display: \"swap\", variable: \"--font-reg-outfit\" });\nconst figtree = Figtree({ subsets: [\"latin\"], display: \"swap\", variable: \"--font-reg-figtree\" });\nconst montserrat = Montserrat({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-reg-montserrat\",\n});\nconst lexend = Lexend({ subsets: [\"latin\"], display: \"swap\", variable: \"--font-reg-lexend\" });\nconst firaCode = Fira_Code({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-reg-fira-code\",\n});\nconst robotoMono = Roboto_Mono({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-reg-roboto-mono\",\n});\nconst sourceSerif4 = Source_Serif_4({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-reg-source-serif-4\",\n});\nconst sourceCodePro = Source_Code_Pro({\n  subsets: [\"latin\"],\n  display: \"swap\",\n  variable: \"--font-reg-source-code-pro\",\n});\n\n/** All registry faces, in declaration order. */\nexport const FONT_REGISTRY_FACES = [\n  inter,\n  interTight,\n  spaceGrotesk,\n  playfairDisplay,\n  sourceSerif4,\n  fraunces,\n  jetbrainsMono,\n  manrope,\n  sora,\n  workSans,\n  dmSans,\n  plusJakartaSans,\n  outfit,\n  figtree,\n  montserrat,\n  lexend,\n  firaCode,\n  robotoMono,\n  sourceCodePro,\n] as const;\n\n/**\n * Space-joined `.variable` classNames for every registry face. Apply to <html>\n * so all `--font-*` registry variables are defined (font files lazy-load on\n * first use). Combine with the app's own Geist faces.\n */\nexport const fontRegistryClassName = FONT_REGISTRY_FACES.map((face) => face.variable).join(\" \");\n"],"mappings":";;;;;;;;;AA2BA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIP,IAAM,QAAQ,MAAM,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,QAAQ,UAAU,eAAe,CAAC;AACrF,IAAM,aAAa,YAAY;AAAA,EAC7B,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,eAAe,cAAc;AAAA,EACjC,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,kBAAkB,iBAAiB;AAAA,EACvC,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,WAAW,SAAS;AAAA,EACxB,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,gBAAgB,eAAe;AAAA,EACnC,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,UAAU,QAAQ,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,QAAQ,UAAU,qBAAqB,CAAC;AAC/F,IAAM,OAAO,KAAK,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,QAAQ,UAAU,kBAAkB,CAAC;AACtF,IAAM,WAAW,UAAU;AAAA,EACzB,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAMA,UAAS,QAAQ,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,QAAQ,UAAU,qBAAqB,CAAC;AAC9F,IAAM,kBAAkB,kBAAkB;AAAA,EACxC,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,SAAS,OAAO,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,QAAQ,UAAU,oBAAoB,CAAC;AAC5F,IAAM,UAAU,QAAQ,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,QAAQ,UAAU,qBAAqB,CAAC;AAC/F,IAAM,aAAa,WAAW;AAAA,EAC5B,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,SAAS,OAAO,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,QAAQ,UAAU,oBAAoB,CAAC;AAC5F,IAAM,WAAW,UAAU;AAAA,EACzB,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,aAAa,YAAY;AAAA,EAC7B,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,eAAe,eAAe;AAAA,EAClC,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AACD,IAAM,gBAAgB,gBAAgB;AAAA,EACpC,SAAS,CAAC,OAAO;AAAA,EACjB,SAAS;AAAA,EACT,UAAU;AACZ,CAAC;AAGM,IAAM,sBAAsB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACAA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAOO,IAAM,wBAAwB,oBAAoB,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,KAAK,GAAG;","names":["dmSans"]}

package/generated/index.ts

@@ -0,0 +1,28 @@
+/**
+ * GENERATED FILE, DO NOT EDIT.
+ * Written by packages/design/fonts/scripts/subset-cjk.mjs.
+ *
+ * Metadata for the CDN-hosted MiSans subsets. <CjkFontFace /> in
+ * ../src/cjk-font-face.tsx turns it into @font-face rules at render time.
+ *
+ * The registry key is "misans" (see FONT_REGISTRY in ../src/index.ts);
+ * the CSS variable is "--font-misans".
+ */
+
+export const MISANS_VARIABLE = "--font-misans" as const;
+
+export const MISANS_FAMILY = "MiSans" as const;
+
+/** Characters covered per face (catalogs ∪ CJK punctuation ∪ GB2312 level-1). */
+export const MISANS_CHAR_COUNT = 4330 as const;
+
+/** `unicode-range` of every generated @font-face — CJK only, no Latin. */
+export const MISANS_UNICODE_RANGE = "U+3000-303F, U+3400-4DBF, U+4E00-9FFF, U+F900-FAFF, U+FE30-FE4F, U+FF00-FFEF" as const;
+
+/** Public-asset keys, one per weight (content-hashed names). No host: see publicAssetUrl(). */
+export const MISANS_FILES = [
+  { key: "fonts/misans/misans-400.6bf25dfdf3.woff2", weight: "400", bytes: 535408 },
+  { key: "fonts/misans/misans-500.442041bb9d.woff2", weight: "500", bytes: 537060 },
+  { key: "fonts/misans/misans-600.2590c17c53.woff2", weight: "600", bytes: 540540 },
+  { key: "fonts/misans/misans-700.ddd8bf8017.woff2", weight: "700", bytes: 545728 },
+] as const;

package/generated/subset-manifest.json

@@ -1,9 +1,9 @@
 {
   "generatedBy": "packages/design/fonts/scripts/subset-cjk.mjs",
-  "inputHash": "330af2d7d4d2b86b78af4f5fac872d5ac8b7724713deb37363b0a2fe4d351ba9",
-  "charsetHash": "0bd19045d121e327c1f2b3030c53d0b13f0318f67b33a33450758c829ed5eb7e",
-  "charCount": 4282,
-  "charsFromCatalogs": 1586,
+  "inputHash": "9cf44b4c3896fbc5b675202e08ca3cf1ea50512a25e55f17e93249a5616e9894",
+  "charsetHash": "47ee971a6d79454b67b4a160bede9bc8f845d7efcf5ed5d88c1abe703bdae6f5",
+  "charCount": 4330,
+  "charsFromCatalogs": 1663,
   "punctuationFloor": 197,
   "gb2312Level1Floor": 3755,
   "uncoveredBySourceFace": "〄〘〙〚〛〜〟〠〪〭〮〯〫〬〰〱〲〳〴〵〶〷〸〹〺〻〼〽〿︲﹅﹆﹇﹈￦",
@@ -38,31 +38,31 @@
   "faces": [
     {
       "weight": 400,
-      "source": "vivoSans-Regular.ttf",
-      "sourceBytes": 7786748,
-      "output": "vivo-sans-sc-400.woff2",
-      "bytes": 498084
+      "source": "MiSans-Regular.ttf",
+      "sourceBytes": 8122324,
+      "output": "misans-400.woff2",
+      "bytes": 535408
     },
     {
       "weight": 500,
-      "source": "vivoSans-Medium.ttf",
-      "sourceBytes": 7776188,
-      "output": "vivo-sans-sc-500.woff2",
-      "bytes": 504228
+      "source": "MiSans-Medium.ttf",
+      "sourceBytes": 8103840,
+      "output": "misans-500.woff2",
+      "bytes": 537060
     },
     {
       "weight": 600,
-      "source": "vivoSans-DemiBold.ttf",
-      "sourceBytes": 7769504,
-      "output": "vivo-sans-sc-600.woff2",
-      "bytes": 504332
+      "source": "MiSans-Semibold.ttf",
+      "sourceBytes": 8034980,
+      "output": "misans-600.woff2",
+      "bytes": 540540
     },
     {
       "weight": 700,
-      "source": "vivoSans-Bold.ttf",
-      "sourceBytes": 7757540,
-      "output": "vivo-sans-sc-700.woff2",
-      "bytes": 506808
+      "source": "MiSans-Bold.ttf",
+      "sourceBytes": 8009316,
+      "output": "misans-700.woff2",
+      "bytes": 545728
     }
   ]
 }

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@nebutra/fonts",
-  "version": "0.1.1",
+  "version": "3.0.0",
   "type": "module",
   "description": "Self-hosted OSS font registry — build-time next/font faces + a name→CSS-var resolver so theme / DESIGN.md fonts render with zero runtime external requests",
   "private": false,
   "nebutra": {
+    "graph": "core",
     "status": "wip",
     "productionReady": false,
     "surface": "support-contract",
@@ -23,10 +24,12 @@
   },
   "files": [
     "dist",
-    "generated/vivo-sans-cn.css",
+    "src",
     "generated/subset-manifest.json",
-    "generated/*.woff2",
-    "vendor/vivo-sans/LICENCE-vivo-Sans.txt",
+    "generated/index.ts",
+    "vendor/misans/LICENSE.txt",
+    "vendor/dm-sans/OFL.txt",
+    "NOTICE-FONTS.md",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"
@@ -39,23 +42,34 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./registry": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
     "./next": {
-      "types": "./dist/next.d.ts",
-      "import": "./dist/next.js",
-      "default": "./dist/next.js"
+      "types": "./src/next.ts",
+      "import": "./src/next.ts",
+      "default": "./src/next.ts"
     },
     "./next/cjk": {
-      "types": "./dist/next-cjk.d.ts",
-      "import": "./dist/next-cjk.js",
-      "default": "./dist/next-cjk.js"
+      "types": "./src/next-cjk.ts",
+      "import": "./src/next-cjk.ts",
+      "default": "./src/next-cjk.ts"
+    },
+    "./font-face": {
+      "types": "./src/cjk-font-face.tsx",
+      "import": "./src/cjk-font-face.tsx",
+      "default": "./src/cjk-font-face.tsx"
     },
     "./cjk": {
       "types": "./dist/generated/index.d.ts",
       "import": "./dist/generated/index.js",
       "default": "./dist/generated/index.js"
-    },
-    "./cjk.css": "./generated/vivo-sans-cn.css",
-    "./generated/*": "./generated/*"
+    }
+  },
+  "dependencies": {
+    "@nebutra/brand": "3.0.0"
   },
   "devDependencies": {
     "@types/react": "^19.2.14",

package/src/cjk-font-face.tsx

@@ -0,0 +1,53 @@
+/**
+ * MiSans @font-face, rendered at request time rather than shipped as CSS.
+ *
+ * The MiSans licence forbids distributing the font on its own and this
+ * repository is public, so the subsets live in the deployment's public asset
+ * bucket and only their keys are committed (../generated/index.ts). A static
+ * stylesheet would have to spell out a host, and the host differs per
+ * deployment: Nebutra's CDN for Nebutra, the scaffold's own for a template
+ * user. publicAssetUrl() resolves it the way it resolves every other public
+ * asset — NEXT_PUBLIC_R2_PUBLIC_URL, then R2_PUBLIC_URL, then the brand's cdn
+ * origin.
+ *
+ * Before the subsets have been uploaded (a fresh scaffold, `pnpm subset:cjk
+ * --upload` not yet run) the requests 404 and the token stacks fall through to
+ * PingFang / YaHei. That is the intended degraded state, not an error.
+ */
+
+import { publicAssetUrl } from "@nebutra/brand/metadata-helpers";
+import { MISANS_FAMILY, MISANS_FILES, MISANS_UNICODE_RANGE } from "../generated/index";
+
+/** One @font-face per weight, CJK-only unicode-range, `swap` so text is never invisible. */
+export function misansFontFaceCss(origin?: string): string {
+  return MISANS_FILES.map(
+    (face) =>
+      `@font-face{font-family:"${MISANS_FAMILY}";font-style:normal;font-weight:${face.weight};` +
+      `font-display:swap;src:url("${publicAssetUrl(face.key, origin)}") format("woff2");` +
+      `unicode-range:${MISANS_UNICODE_RANGE}}`,
+  ).join("\n");
+}
+
+export interface CjkFontFaceProps {
+  /** Asset origin override; defaults to the publicAssetUrl() resolution. */
+  origin?: string;
+  /**
+   * CSP nonce, for apps whose style-src allows inline styles only by nonce
+   * (apps/web). Without it the whole @font-face block is refused. The page's
+   * font-src must also allow publicAssetOrigin().
+   */
+  nonce?: string;
+}
+
+/**
+ * Render once in each root layout, next to `cjkFontClassName` on <html>.
+ * React 19 hoists a `<style>` carrying `href` + `precedence` into <head> and
+ * dedupes it by `href`, so rendering it twice costs nothing.
+ */
+export function CjkFontFace({ origin, nonce }: CjkFontFaceProps) {
+  return (
+    <style href="nebutra-misans" precedence="default" nonce={nonce || undefined}>
+      {misansFontFaceCss(origin)}
+    </style>
+  );
+}

package/src/index.test.ts

@@ -0,0 +1,39 @@
+import { describe, expect, it } from "vitest";
+import { primaryFamily, resolveRegistryVar, withRegistryFont } from "./index";
+
+describe("@nebutra/fonts registry", () => {
+  it("normalizes the primary family (strips quotes, lowercases)", () => {
+    expect(primaryFamily("'Space Grotesk', sans-serif")).toBe("space grotesk");
+    expect(primaryFamily("Inter")).toBe("inter");
+    expect(primaryFamily('"JetBrains Mono", ui-monospace, monospace')).toBe("jetbrains mono");
+  });
+
+  it("resolves a registered family to its CSS variable", () => {
+    expect(resolveRegistryVar("Space Grotesk, sans-serif")).toBe("--font-space-grotesk");
+    expect(resolveRegistryVar("'JetBrains Mono', monospace")).toBe("--font-jetbrains-mono");
+    expect(resolveRegistryVar("Geist, sans-serif")).toBe("--font-geist-sans");
+  });
+
+  it("returns undefined for an unregistered (e.g. proprietary) family", () => {
+    expect(resolveRegistryVar("Airbnb Cereal VF, sans-serif")).toBeUndefined();
+    expect(resolveRegistryVar("BMWTypeNext, sans-serif")).toBeUndefined();
+  });
+
+  it("prepends the self-hosted var for a registered family, keeping the fallback", () => {
+    expect(withRegistryFont("Space Grotesk, sans-serif")).toBe(
+      "var(--font-space-grotesk), Space Grotesk, sans-serif",
+    );
+    expect(withRegistryFont("'JetBrains Mono', ui-monospace, monospace")).toBe(
+      "var(--font-jetbrains-mono), 'JetBrains Mono', ui-monospace, monospace",
+    );
+  });
+
+  it("leaves an unregistered stack untouched (graceful fallback)", () => {
+    expect(withRegistryFont("Airbnb Cereal, sans-serif")).toBe("Airbnb Cereal, sans-serif");
+  });
+
+  it("handles undefined/empty input safely", () => {
+    expect(withRegistryFont(undefined)).toBeUndefined();
+    expect(withRegistryFont("")).toBe("");
+  });
+});

package/src/index.ts

@@ -0,0 +1,105 @@
+/**
+ * @nebutra/fonts — self-hosted OSS font registry (client-safe entry).
+ *
+ * Maps a normalized theme / DESIGN.md font-family name to the CSS variable that
+ * the build-time self-hosted face defines (declared with next/font in
+ * `@nebutra/fonts/next`, applied to <html> via `fontRegistryClassName`).
+ *
+ * WHY: next/font registers each face under a HASHED family name reachable ONLY
+ * via its CSS variable — `font-family: 'Inter'` does NOT use the self-hosted
+ * Inter. So when a theme / imported DESIGN.md font's primary family matches an
+ * entry here, callers prepend `var(--font-…)` to the stack, making the
+ * self-hosted font actually render — with ZERO runtime external requests
+ * (next/font self-hosts at build time) and next/font's automatic metric-matched
+ * fallback (no layout shift). Unmatched families keep their declared stack.
+ *
+ * This entry is FREE of `next/font` imports so client modules can use it.
+ * The `./next` subpath holds the (server-only) next/font declarations and MUST
+ * keep its CSS-variable names in sync with FONT_REGISTRY below.
+ */
+
+export const FONT_REGISTRY: Record<string, string> = {
+  // Self-hosted via geist/font (default brand faces, loaded by the app shell)
+  geist: "--font-geist-sans",
+  "geist sans": "--font-geist-sans",
+  "geist mono": "--font-geist-mono",
+  // Self-hosted via next/font/local (see ./next-cjk). MiSans is the
+  // Simplified-Chinese face — CJK only via unicode-range, so it cannot take
+  // Latin away from Geist. DM Sans is the Latin display/heading face.
+  misans: "--font-misans",
+  "dm sans display": "--font-dm-sans",
+  // Self-hosted via next/font/google (see ./next)
+  inter: "--font-inter",
+  "inter tight": "--font-reg-inter-tight",
+  "space grotesk": "--font-space-grotesk",
+  "playfair display": "--font-playfair-display",
+  fraunces: "--font-reg-fraunces",
+  "source serif 4": "--font-reg-source-serif-4",
+  "jetbrains mono": "--font-jetbrains-mono",
+  manrope: "--font-reg-manrope",
+  sora: "--font-reg-sora",
+  "work sans": "--font-reg-work-sans",
+  "dm sans": "--font-reg-dm-sans",
+  "plus jakarta sans": "--font-reg-plus-jakarta-sans",
+  outfit: "--font-reg-outfit",
+  figtree: "--font-reg-figtree",
+  montserrat: "--font-reg-montserrat",
+  lexend: "--font-reg-lexend",
+  "fira code": "--font-reg-fira-code",
+  "roboto mono": "--font-reg-roboto-mono",
+  "source code pro": "--font-reg-source-code-pro",
+};
+
+/** Normalize a single font-family token: strip quotes/whitespace, lowercase. */
+function normalizeFamily(name: string): string {
+  // Strip ALL quotes with a quantifier-free global replace (quotes only appear
+  // at token boundaries in a font-family value). Avoids the end-anchored /['"]+$/
+  // form, which CodeQL flags as polynomial ReDoS (scanned from every position).
+  return name.replace(/['"]/g, "").trim().toLowerCase();
+}
+
+/** The first (primary) family in a CSS font-family list, normalized. */
+export function primaryFamily(stack: string): string {
+  return normalizeFamily(stack.split(",")[0] ?? "");
+}
+
+/** Registry CSS variable for a stack's primary family, or undefined. */
+export function resolveRegistryVar(stack: string): string | undefined {
+  return FONT_REGISTRY[primaryFamily(stack)];
+}
+
+/**
+ * Return `stack` with the self-hosted registry font prepended when its primary
+ * family is registered; otherwise return it unchanged.
+ * e.g. "Space Grotesk, sans-serif" → "var(--font-space-grotesk), Space Grotesk, sans-serif"
+ */
+export function withRegistryFont(stack: string | undefined): string | undefined {
+  if (!stack) return stack;
+  const variable = resolveRegistryVar(stack);
+  return variable ? `var(${variable}), ${stack}` : stack;
+}
+
+/**
+ * Like `withRegistryFont`, but matches the first registered family ANYWHERE in
+ * the stack rather than only in first position.
+ *
+ * A brand package names the typeface the design language actually uses, and
+ * those are frequently licensed faces we have no right to serve — Söhne, Mori,
+ * Lyon Text, Reckless. The declared stack already says what to do when they are
+ * absent: fall to the next family. But "the next family" is usually a bare name
+ * like `Inter`, which does NOT reach next/font's hashed face, so the stack
+ * skidded past every self-hosted option and landed on `ui-sans-serif`. All
+ * seven built-in design languages rendered in the system font until 2026-08-18.
+ *
+ * Prepending the nearest registered family produces exactly the outcome the
+ * declared chain intended, and leaves the licensed names in place so a customer
+ * who does own the font still gets it by shipping the face themselves.
+ */
+export function withNearestRegistryFont(stack: string | undefined): string | undefined {
+  if (!stack) return stack;
+  for (const token of stack.split(",")) {
+    const variable = FONT_REGISTRY[normalizeFamily(token)];
+    if (variable) return `var(${variable}), ${stack}`;
+  }
+  return stack;
+}