@timber-js/app 0.2.0-alpha.64 → 0.2.0-alpha.66

package/dist/plugins/dev-browser-logs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-browser-logs.d.ts","sourceRoot":"","sources":["../../src/plugins/dev-browser-logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD,kEAAkE;AAClE,MAAM,MAAM,oBAAoB,GAAG,eAAe,GAAG,MAAM,GAAG,SAAS,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,eAAe,CAAC;IACvB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gDAAgD;IAChD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB;AA6BD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAsBnE;AAID;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,eAAe,GAAG,MAAM,GAClC,OAAO,CAGT;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzE;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM,CAgEhF;AAID;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAyD/D"}
+{"version":3,"file":"dev-browser-logs.d.ts","sourceRoot":"","sources":["../../src/plugins/dev-browser-logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,6CAA6C;AAC7C,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD,kEAAkE;AAClE,MAAM,MAAM,oBAAoB,GAAG,eAAe,GAAG,MAAM,GAAG,SAAS,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,eAAe,CAAC;IACvB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gDAAgD;IAChD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB;AA6BD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAsBnE;AAID;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,eAAe,GAAG,MAAM,GAClC,OAAO,CAGT;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzE;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM,CAgEhF;AAID;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA6D/D"}

package/dist/plugins/fonts.d.ts

@@ -16,6 +16,7 @@
 import type { Plugin } from 'vite';
 import type { PluginContext } from '../index.js';
 import type { ExtractedFont, GoogleFontConfig } from '../fonts/types.js';
+import type { FontFaceDescriptor } from '../fonts/types.js';
 /**
  * Registry of fonts extracted during transform.
  * Keyed by a unique font ID derived from family + config.
@@ -59,17 +60,23 @@ export declare function parseGoogleFontFamilies(source: string): Map<string, str
 /**
  * Generate CSS for a single extracted font.
  *
- * Includes @font-face rules (for local fonts), fallback @font-face,
+ * Includes @font-face rules (for local and Google fonts), fallback @font-face,
  * and the scoped class rule.
+ *
+ * For Google fonts, pass the resolved FontFaceDescriptor[] from either
+ * `generateProductionFontFaces()` (production) or `resolveDevFontFaces()` (dev).
  */
-export declare function generateFontCss(font: ExtractedFont): string;
+export declare function generateFontCss(font: ExtractedFont, googleFaces?: FontFaceDescriptor[]): string;
 /**
  * Generate the CSS output for all extracted fonts.
  *
- * Includes @font-face rules for local fonts, fallback @font-face rules,
- * and scoped classes.
+ * Includes @font-face rules for local and Google fonts, fallback @font-face
+ * rules, and scoped classes.
+ *
+ * `googleFontFacesMap` provides pre-resolved FontFaceDescriptor[] for each
+ * Google font ID (keyed by ExtractedFont.id).
  */
-export declare function generateAllFontCss(registry: FontRegistry): string;
+export declare function generateAllFontCss(registry: FontRegistry, googleFontFacesMap?: Map<string, FontFaceDescriptor[]>): string;
 /**
  * Parse the local name used for the default import of `@timber/fonts/local`.
  *

package/dist/plugins/fonts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../src/plugins/fonts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAGlD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAmCzE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AA4CtD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAE7E;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAE5F;AAUD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAkB/D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAqB3E;AAwED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAmB3D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAMjE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKtE;AAqED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA4VtD"}
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../src/plugins/fonts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAGlD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAYzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AA6B5D;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AA4CtD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAE7E;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAE5F;AAUD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAkB/D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAqB3E;AAwED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAwB/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,EACtB,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,GACrD,MAAM,CAOR;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKtE;AAqED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAqYtD"}

package/dist/shims/font-google.js

@@ -0,0 +1,42 @@
+//#region src/shims/font-google.ts
+/**
+* Create a stub FontResult with empty values.
+*
+* The timber-fonts plugin replaces these calls at build time with real
+* class names and font stacks. This stub ensures code that imports
+* font functions outside of the build pipeline (tests, type-checking)
+* gets a valid FontResult shape without runtime errors.
+*/
+function createStubFontResult(config) {
+	return {
+		className: "",
+		style: { fontFamily: "" },
+		variable: config?.variable
+	};
+}
+/**
+* Generic font loader — accepts any font name, returns a stub FontResult.
+*
+* Named exports like `Inter`, `Roboto`, etc. are generated dynamically
+* by the virtual module at build time. This function provides a catch-all
+* for non-Vite contexts.
+*/
+function createFont(_family, config) {
+	return createStubFontResult(config);
+}
+var Inter = (config) => createStubFontResult(config);
+var Roboto = (config) => createStubFontResult(config);
+var Open_Sans = (config) => createStubFontResult(config);
+var Lato = (config) => createStubFontResult(config);
+var Montserrat = (config) => createStubFontResult(config);
+var Poppins = (config) => createStubFontResult(config);
+var Geist = (config) => createStubFontResult(config);
+var Geist_Mono = (config) => createStubFontResult(config);
+var JetBrains_Mono = (config) => createStubFontResult(config);
+var Source_Code_Pro = (config) => createStubFontResult(config);
+var Playfair_Display = (config) => createStubFontResult(config);
+var Merriweather = (config) => createStubFontResult(config);
+//#endregion
+export { Geist, Geist_Mono, Inter, JetBrains_Mono, Lato, Merriweather, Montserrat, Open_Sans, Playfair_Display, Poppins, Roboto, Source_Code_Pro, createFont };
+
+//# sourceMappingURL=font-google.js.map

package/dist/shims/font-google.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-google.js","names":[],"sources":["../../src/shims/font-google.ts"],"sourcesContent":["/**\n * Fallback shim for `next/font/google` → `@timber/fonts/google`.\n *\n * At build time, the timber-fonts plugin's transform hook replaces font\n * function calls with static FontResult objects containing real class names\n * and font stacks. This file serves two purposes:\n *\n * 1. **TypeScript resolution** — provides types for IDEs and `tsc` outside\n *    of Vite's module graph (where the virtual module handles it).\n * 2. **Runtime fallback** — returns empty className/fontFamily values when\n *    the plugin hasn't processed a call (e.g. in tests or non-Vite environments).\n *\n * The shim resolution path (`next/font/google` → `\\0@timber/fonts/google`)\n * is unchanged — this file is NOT on that resolution path. It exists as a\n * physical module for direct imports and type re-exports.\n *\n * Design doc: 24-fonts.md, \"Next.js Font Compatibility\"\n */\n\nimport type { GoogleFontConfig, FontResult } from '../fonts/types.js';\n\nexport type { GoogleFontConfig, FontResult };\n\n/**\n * Create a stub FontResult with empty values.\n *\n * The timber-fonts plugin replaces these calls at build time with real\n * class names and font stacks. This stub ensures code that imports\n * font functions outside of the build pipeline (tests, type-checking)\n * gets a valid FontResult shape without runtime errors.\n */\nfunction createStubFontResult(config?: GoogleFontConfig): FontResult {\n  return {\n    className: '',\n    style: { fontFamily: '' },\n    variable: config?.variable,\n  };\n}\n\n/**\n * Generic font loader — accepts any font name, returns a stub FontResult.\n *\n * Named exports like `Inter`, `Roboto`, etc. are generated dynamically\n * by the virtual module at build time. This function provides a catch-all\n * for non-Vite contexts.\n */\nexport function createFont(_family: string, config?: GoogleFontConfig): FontResult {\n  return createStubFontResult(config);\n}\n\n// Common Google Font exports for TypeScript autocomplete.\n// These are stubs — the virtual module and transform hook provide real values.\nexport const Inter = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Roboto = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Open_Sans = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Lato = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Montserrat = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Poppins = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Geist = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const Geist_Mono = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\nexport const JetBrains_Mono = (config?: GoogleFontConfig): FontResult =>\n  createStubFontResult(config);\nexport const Source_Code_Pro = (config?: GoogleFontConfig): FontResult =>\n  createStubFontResult(config);\nexport const Playfair_Display = (config?: GoogleFontConfig): FontResult =>\n  createStubFontResult(config);\nexport const Merriweather = (config?: GoogleFontConfig): FontResult => createStubFontResult(config);\n"],"mappings":";;;;;;;;;AA+BA,SAAS,qBAAqB,QAAuC;AACnE,QAAO;EACL,WAAW;EACX,OAAO,EAAE,YAAY,IAAI;EACzB,UAAU,QAAQ;EACnB;;;;;;;;;AAUH,SAAgB,WAAW,SAAiB,QAAuC;AACjF,QAAO,qBAAqB,OAAO;;AAKrC,IAAa,SAAS,WAA0C,qBAAqB,OAAO;AAC5F,IAAa,UAAU,WAA0C,qBAAqB,OAAO;AAC7F,IAAa,aAAa,WAA0C,qBAAqB,OAAO;AAChG,IAAa,QAAQ,WAA0C,qBAAqB,OAAO;AAC3F,IAAa,cAAc,WAA0C,qBAAqB,OAAO;AACjG,IAAa,WAAW,WAA0C,qBAAqB,OAAO;AAC9F,IAAa,SAAS,WAA0C,qBAAqB,OAAO;AAC5F,IAAa,cAAc,WAA0C,qBAAqB,OAAO;AACjG,IAAa,kBAAkB,WAC7B,qBAAqB,OAAO;AAC9B,IAAa,mBAAmB,WAC9B,qBAAqB,OAAO;AAC9B,IAAa,oBAAoB,WAC/B,qBAAqB,OAAO;AAC9B,IAAa,gBAAgB,WAA0C,qBAAqB,OAAO"}

package/dist/shims/font-local.js

@@ -0,0 +1,20 @@
+//#region src/shims/font-local.ts
+/**
+* Create a local font.
+*
+* The timber-fonts plugin replaces these calls at build time with real
+* class names and font stacks. This stub ensures code that imports
+* `localFont` outside of the build pipeline (tests, type-checking)
+* gets a valid FontResult shape without runtime errors.
+*/
+function localFont(config) {
+	return {
+		className: "",
+		style: { fontFamily: "" },
+		variable: config?.variable
+	};
+}
+//#endregion
+export { localFont as default };
+
+//# sourceMappingURL=font-local.js.map

package/dist/shims/font-local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-local.js","names":[],"sources":["../../src/shims/font-local.ts"],"sourcesContent":["/**\n * Fallback shim for `next/font/local` → `@timber/fonts/local`.\n *\n * At build time, the timber-fonts plugin's transform hook replaces\n * `localFont()` calls with static FontResult objects containing real\n * class names and font stacks. This file serves two purposes:\n *\n * 1. **TypeScript resolution** — provides types for IDEs and `tsc` outside\n *    of Vite's module graph (where the virtual module handles it).\n * 2. **Runtime fallback** — returns empty className/fontFamily values when\n *    the plugin hasn't processed a call (e.g. in tests or non-Vite environments).\n *\n * Design doc: 24-fonts.md, \"Next.js Font Compatibility\"\n */\n\nimport type { LocalFontConfig, FontResult } from '../fonts/types.js';\n\nexport type { LocalFontConfig, FontResult };\n\n/**\n * Create a local font.\n *\n * The timber-fonts plugin replaces these calls at build time with real\n * class names and font stacks. This stub ensures code that imports\n * `localFont` outside of the build pipeline (tests, type-checking)\n * gets a valid FontResult shape without runtime errors.\n */\nexport default function localFont(config?: LocalFontConfig): FontResult {\n  return {\n    className: '',\n    style: { fontFamily: '' },\n    variable: config?.variable,\n  };\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAwB,UAAU,QAAsC;AACtE,QAAO;EACL,WAAW;EACX,OAAO,EAAE,YAAY,IAAI;EACzB,UAAU,QAAQ;EACnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timber-js/app",
-  "version": "0.2.0-alpha.64",
+  "version": "0.2.0-alpha.66",
   "description": "Vite-native React framework built for Servers and Serverless Platforms — correct HTTP semantics, real status codes, pages that work without JavaScript",
   "keywords": [
     "cloudflare-workers",
@@ -88,6 +88,11 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "build": "vite build --config vite.lib.config.ts && tsc --emitDeclarationOnly --project tsconfig.json --outDir dist",
+    "typecheck": "tsgo --noEmit",
+    "prepublishOnly": "pnpm run build"
+  },
   "dependencies": {
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/context-async-hooks": "^2.6.1",
@@ -126,9 +131,5 @@
   },
   "engines": {
     "node": ">=22.12.0"
-  },
-  "scripts": {
-    "build": "vite build --config vite.lib.config.ts && tsc --emitDeclarationOnly --project tsconfig.json --outDir dist",
-    "typecheck": "tsgo --noEmit"
   }
-}
+}

package/src/plugins/dev-browser-logs.ts

@@ -231,7 +231,11 @@ export function timberDevBrowserLogs(ctx: PluginContext): Plugin {
 
     configureServer(server: ViteDevServer) {
       const threshold = ctx.config.devBrowserLogs ?? 'warn';
-      if (threshold === 'none') return;
+      if (threshold === 'none') {
+        // Clear any stale script from a prior server instance (e.g. HMR reconfigure)
+        delete (globalThis as Record<string, unknown>).__timber_dev_browser_log_script;
+        return;
+      }
 
       // Register the client injection script on globalThis so the RSC entry
       // can include it in headHtml for all Timber route responses.

package/src/plugins/fonts.ts

@@ -24,7 +24,13 @@ import { generateVariableClass, generateFontFamilyClass, generateFontFaces } fro
 import { generateFallbackCss, buildFontStack } from '../fonts/fallbacks.js';
 import { processLocalFont, generateLocalFontFaces } from '../fonts/local.js';
 import { inferFontFormat } from '../fonts/local.js';
-import { downloadAndCacheFonts, type CachedFont } from '../fonts/google.js';
+import {
+  downloadAndCacheFonts,
+  generateProductionFontFaces,
+  resolveDevFontFaces,
+  type CachedFont,
+} from '../fonts/google.js';
+import type { FontFaceDescriptor } from '../fonts/types.js';
 import {
   extractFontConfigAst,
   extractLocalFontConfigAst,
@@ -264,10 +270,13 @@ function generateLocalVirtualModule(): string {
 /**
  * Generate CSS for a single extracted font.
  *
- * Includes @font-face rules (for local fonts), fallback @font-face,
+ * Includes @font-face rules (for local and Google fonts), fallback @font-face,
  * and the scoped class rule.
+ *
+ * For Google fonts, pass the resolved FontFaceDescriptor[] from either
+ * `generateProductionFontFaces()` (production) or `resolveDevFontFaces()` (dev).
  */
-export function generateFontCss(font: ExtractedFont): string {
+export function generateFontCss(font: ExtractedFont, googleFaces?: FontFaceDescriptor[]): string {
   const cssParts: string[] = [];
 
   if (font.provider === 'local' && font.localSources) {
@@ -276,6 +285,11 @@ export function generateFontCss(font: ExtractedFont): string {
     if (faceCss) cssParts.push(faceCss);
   }
 
+  if (font.provider === 'google' && googleFaces && googleFaces.length > 0) {
+    const faceCss = generateFontFaces(googleFaces);
+    if (faceCss) cssParts.push(faceCss);
+  }
+
   const fallbackCss = generateFallbackCss(font.family);
   if (fallbackCss) cssParts.push(fallbackCss);
 
@@ -291,13 +305,20 @@ export function generateFontCss(font: ExtractedFont): string {
 /**
  * Generate the CSS output for all extracted fonts.
  *
- * Includes @font-face rules for local fonts, fallback @font-face rules,
- * and scoped classes.
+ * Includes @font-face rules for local and Google fonts, fallback @font-face
+ * rules, and scoped classes.
+ *
+ * `googleFontFacesMap` provides pre-resolved FontFaceDescriptor[] for each
+ * Google font ID (keyed by ExtractedFont.id).
  */
-export function generateAllFontCss(registry: FontRegistry): string {
+export function generateAllFontCss(
+  registry: FontRegistry,
+  googleFontFacesMap?: Map<string, FontFaceDescriptor[]>
+): string {
   const cssParts: string[] = [];
   for (const font of registry.values()) {
-    cssParts.push(generateFontCss(font));
+    const googleFaces = googleFontFacesMap?.get(font.id);
+    cssParts.push(generateFontCss(font, googleFaces));
   }
   return cssParts.join('\n\n');
 }
@@ -390,6 +411,11 @@ export function timberFonts(ctx: PluginContext): Plugin {
   const registry: FontRegistry = new Map();
   /** Fonts downloaded during buildStart (production only). */
   let cachedFonts: CachedFont[] = [];
+  /**
+   * Pre-resolved @font-face descriptors for Google fonts, keyed by font ID.
+   * Populated in buildStart (production) or lazily in load (dev).
+   */
+  const googleFontFacesMap = new Map<string, FontFaceDescriptor[]>();
 
   return {
     name: 'timber-fonts',
@@ -429,12 +455,32 @@ export function timberFonts(ctx: PluginContext): Plugin {
      * Because this is loaded lazily (on first request), the font
      * registry is always populated by the time it's needed.
      */
-    load(id: string) {
+    async load(id: string) {
       if (id === RESOLVED_GOOGLE) return generateGoogleVirtualModule(registry);
       if (id === RESOLVED_LOCAL) return generateLocalVirtualModule();
 
       if (id === RESOLVED_FONT_CSS_REGISTER) {
-        const css = generateAllFontCss(registry);
+        // In dev mode, resolve Google font faces from CDN on demand.
+        if (ctx.dev) {
+          const googleFonts = [...registry.values()].filter((f) => f.provider === 'google');
+          for (const font of googleFonts) {
+            if (!googleFontFacesMap.has(font.id)) {
+              try {
+                const faces = await resolveDevFontFaces(font);
+                googleFontFacesMap.set(font.id, faces);
+              } catch (e) {
+                // In dev mode, fail gracefully — fonts fall back to system fonts.
+                const msg = e instanceof Error ? e.message : String(e);
+                console.warn(
+                  `[timber-fonts] Failed to resolve Google font "${font.family}": ${msg}`
+                );
+                googleFontFacesMap.set(font.id, []);
+              }
+            }
+          }
+        }
+
+        const css = generateAllFontCss(registry, googleFontFacesMap);
         // Side-effect module: sets font CSS on globalThis for the RSC entry to read.
         return `globalThis.__timber_font_css = ${JSON.stringify(css)};`;
       }
@@ -515,6 +561,22 @@ export function timberFonts(ctx: PluginContext): Plugin {
       if (googleFonts.length === 0) return;
 
       cachedFonts = await downloadAndCacheFonts(googleFonts, ctx.root);
+
+      // Build a family→CachedFont[] lookup, then generate production @font-face
+      // descriptors for each registered Google font.
+      const cachedByFamily = new Map<string, CachedFont[]>();
+      for (const cf of cachedFonts) {
+        const key = cf.face.family.toLowerCase();
+        const arr = cachedByFamily.get(key) ?? [];
+        arr.push(cf);
+        cachedByFamily.set(key, arr);
+      }
+
+      for (const font of googleFonts) {
+        const familyCached = cachedByFamily.get(font.family.toLowerCase()) ?? [];
+        const faces = generateProductionFontFaces(familyCached, font.display);
+        googleFontFacesMap.set(font.id, faces);
+      }
     },
 
     /**

package/LICENSE

@@ -1,8 +0,0 @@
-DONTFUCKINGUSE LICENSE
-
-Copyright (c) 2025 Daniel Saewitz
-
-This software may not be used, copied, modified, merged, published,
-distributed, sublicensed, or sold by anyone other than the copyright holder.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.