npm - toiljs - Versions diffs - 0.0.11 → 0.0.12 - Mend

toiljs 0.0.11 → 0.0.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (119) hide show

package/README.md +2 -0
package/build/cli/.tsbuildinfo +1 -1
package/build/cli/configure.js +10 -4
package/build/cli/create.js +58 -30
package/build/cli/diagnostics.d.ts +55 -0
package/build/cli/diagnostics.js +333 -0
package/build/cli/doctor.d.ts +6 -0
package/build/cli/doctor.js +249 -0
package/build/cli/index.js +26 -0
package/build/cli/proc.d.ts +5 -0
package/build/cli/proc.js +20 -0
package/build/cli/ui.d.ts +1 -0
package/build/cli/ui.js +1 -0
package/build/cli/update.d.ts +7 -0
package/build/cli/update.js +117 -0
package/build/cli/updates.d.ts +10 -0
package/build/cli/updates.js +45 -0
package/build/client/.tsbuildinfo +1 -1
package/build/client/dev/error-overlay.js +1 -1
package/build/client/head/metadata.js +3 -1
package/build/client/index.d.ts +5 -1
package/build/client/index.js +2 -0
package/build/client/navigation/navigation.js +1 -1
package/build/client/routing/Router.js +2 -2
package/build/client/search/search.d.ts +26 -0
package/build/client/search/search.js +101 -0
package/build/client/search/use-page-search.d.ts +8 -0
package/build/client/search/use-page-search.js +21 -0
package/build/compiler/.tsbuildinfo +1 -1
package/build/compiler/generate.js +26 -23
package/build/compiler/index.d.ts +2 -0
package/build/compiler/index.js +1 -0
package/build/compiler/pages.d.ts +8 -0
package/build/compiler/pages.js +37 -0
package/build/compiler/plugin.js +3 -1
package/build/compiler/prerender.d.ts +1 -0
package/build/compiler/prerender.js +11 -5
package/build/compiler/seo.js +10 -3
package/build/io/.tsbuildinfo +1 -1
package/examples/basic/client/components/Header.tsx +43 -41
package/examples/basic/client/components/HoneycombBackground.tsx +223 -230
package/examples/basic/client/public/index.html +18 -16
package/examples/basic/client/routes/(legal)/privacy.tsx +18 -19
package/examples/basic/client/routes/(legal)/terms.tsx +15 -16
package/examples/basic/client/routes/about.tsx +21 -22
package/examples/basic/client/routes/blog/[id].tsx +26 -18
package/examples/basic/client/routes/features/actions.tsx +67 -67
package/examples/basic/client/routes/features/error/index.tsx +27 -27
package/examples/basic/client/routes/features/head.tsx +38 -38
package/examples/basic/client/routes/features/index.tsx +83 -75
package/examples/basic/client/routes/features/realtime.tsx +34 -32
package/examples/basic/client/routes/features/script.tsx +31 -31
package/examples/basic/client/routes/features/seo.tsx +39 -39
package/examples/basic/client/routes/features/template/index.tsx +20 -20
package/examples/basic/client/routes/features/template/template.tsx +16 -18
package/examples/basic/client/routes/gallery/@modal/(.)photo/[id].tsx +23 -23
package/examples/basic/client/routes/gallery/index.tsx +42 -42
package/examples/basic/client/routes/gallery/photo/[id].tsx +18 -18
package/examples/basic/client/routes/get-started.tsx +157 -84
package/examples/basic/client/routes/index.tsx +137 -96
package/examples/basic/client/routes/loader-demo/index.tsx +59 -52
package/examples/basic/client/routes/search.tsx +61 -0
package/examples/basic/client/routes/test.tsx +7 -8
package/examples/basic/client/styles/main.css +624 -552
package/package.json +2 -2
package/presets/eslint.js +10 -3
package/src/cli/configure.ts +363 -353
package/src/cli/create.ts +563 -530
package/src/cli/diagnostics.ts +421 -0
package/src/cli/doctor.ts +318 -0
package/src/cli/features.ts +166 -160
package/src/cli/index.ts +242 -211
package/src/cli/proc.ts +30 -0
package/src/cli/ui.ts +111 -103
package/src/cli/update.ts +150 -0
package/src/cli/updates.ts +69 -0
package/src/client/components/Image.tsx +91 -89
package/src/client/dev/error-overlay.tsx +193 -197
package/src/client/head/metadata.ts +94 -92
package/src/client/index.ts +79 -64
package/src/client/navigation/Link.tsx +94 -100
package/src/client/navigation/navigation.ts +215 -218
package/src/client/routing/Router.tsx +210 -193
package/src/client/routing/hooks.ts +110 -114
package/src/client/routing/lazy.ts +77 -81
package/src/client/search/search.ts +189 -0
package/src/client/search/use-page-search.ts +73 -0
package/src/compiler/config.ts +173 -171
package/src/compiler/fonts.ts +89 -87
package/src/compiler/generate.ts +378 -373
package/src/compiler/image-report.ts +88 -85
package/src/compiler/index.ts +2 -0
package/src/compiler/pages.ts +70 -0
package/src/compiler/plugin.ts +51 -47
package/src/compiler/prerender.ts +152 -130
package/src/compiler/routes.ts +132 -131
package/src/compiler/seo.ts +381 -356
package/src/compiler/vite.ts +155 -145
package/src/io/FastSet.ts +99 -96
package/test/configure.test.ts +94 -90
package/test/doctor.test.ts +140 -0
package/test/dom/Image.test.tsx +73 -46
package/test/dom/Script.test.tsx +48 -45
package/test/dom/action.test.tsx +146 -129
package/test/dom/error-overlay.test.tsx +44 -44
package/test/dom/loader.test.tsx +2 -2
package/test/dom/revalidate.test.tsx +1 -1
package/test/dom/route-head.test.tsx +1 -2
package/test/dom/slot.test.tsx +131 -109
package/test/dom/view-transitions.test.tsx +53 -51
package/test/features.test.ts +149 -142
package/test/fonts.test.ts +28 -26
package/test/head.test.ts +45 -35
package/test/metadata.test.ts +42 -41
package/test/pages.test.ts +105 -0
package/test/prerender.test.ts +54 -46
package/test/search.test.ts +114 -0
package/test/seo.test.ts +164 -142
package/test/update.test.ts +44 -0

package/src/compiler/config.ts CHANGED Viewed

@@ -1,171 +1,173 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-import { type InlineConfig } from 'vite';
-import { type SeoConfig } from './seo.js';
-export type { SeoConfig } from './seo.js';
-/**
- * Client-side (TSX/React/Vite) configuration. All fields optional; sensible defaults applied.
- */
-export interface ClientConfig {
-    /** Client source directory, relative to root. Default `client`. */
-    readonly srcDir?: string;
-    /** Routes directory, relative to `srcDir`. Default `routes`. */
-    readonly routesDir?: string;
-    /**
-     * Static assets directory, relative to root. Default `<srcDir>/public` (e.g. `client/public`).
-     * Holds the `index.html` template (owned and edited by you) plus any files served as-is at the
-     * base path (favicons, images, …).
-     */
-    readonly publicDir?: string;
-    /** Production output directory, relative to root. Default `build/client`. */
-    readonly outDir?: string;
-    /** Public base path. Default `/`. */
-    readonly base?: string;
-    /** Dev server port. Default `3000`. */
-    readonly port?: number;
-    /**
-     * Optimize imported images at build time (resize/convert via `vite-imagetools` + sharp): an
-     * import like `logo.png?w=400;800&format=webp&as=srcset` emits resized, compressed variants.
-     * Default `true`. Set `false` to disable the pipeline (images are then served as-is).
-     */
-    readonly images?: boolean;
-    /**
-     * Preload bundled fonts at build time: injects `<link rel="preload" as="font">` for each
-     * `@font-face` font so it loads in parallel with the CSS (faster text paint). Default `true`.
-     */
-    readonly fonts?: boolean;
-    /**
-     * Animate cross-page navigations with the browser View Transitions API (a crossfade by default;
-     * add `view-transition-name` in CSS for shared-element transitions). Respects
-     * `prefers-reduced-motion`. Default `false`.
-     */
-    readonly viewTransitions?: boolean;
-    /**
-     * Build-time SEO: bakes site-level metadata into the HTML `<head>` (so JS-less crawlers and AI
-     * bots see real tags) and generates `robots.txt`, `sitemap.xml`, and `llms.txt`. Omit to skip.
-     */
-    readonly seo?: SeoConfig;
-    /**
-     * Raw Vite escape hatch, deep-merged over the framework's opinionated config.
-     * This is NOT the client config itself, toil owns the Vite setup; use this only
-     * to override specific Vite options.
-     */
-    readonly vite?: InlineConfig;
-}
-/**
- * Server-side (toilscript → WASM) configuration. Reserved: the compiler does not yet
- * build the server target via `toil build`; today it is compiled by `toilscript` directly.
- */
-export interface ServerConfig {
-    /** Server source directory, relative to root. Default `server`. */
-    readonly srcDir?: string;
-    /** Server build output directory, relative to root. Default `build/server`. */
-    readonly outDir?: string;
-}
-/**
- * The `toil.config` schema. All fields optional; sensible defaults applied.
- * Client and server are configured in separate sections.
- */
-export interface ToilConfig {
-    /** Project root. Defaults to the current working directory. */
-    readonly root?: string;
-    /** Client (TSX/React/Vite) configuration. */
-    readonly client?: ClientConfig;
-    /** Server (toilscript/WASM) configuration. */
-    readonly server?: ServerConfig;
-}
-/** Fully-resolved config with absolute paths, used internally by the compiler. */
-export interface ResolvedToilConfig {
-    readonly root: string;
-    readonly srcDir: string;
-    readonly clientAbsDir: string;
-    readonly routesAbsDir: string;
-    /** Absolute path to the static-assets dir (holds the `index.html` template). */
-    readonly publicDir: string;
-    readonly toilDir: string;
-    readonly outDir: string;
-    readonly base: string;
-    readonly port: number;
-    /** Whether build-time image optimization (`vite-imagetools`) is enabled. */
-    readonly images: boolean;
-    /** Whether build-time font preloading is enabled. */
-    readonly fonts: boolean;
-    /** Whether animated View Transitions are enabled for navigation. */
-    readonly viewTransitions: boolean;
-    /** Build-time SEO config, or `null` when not configured. */
-    readonly seo: SeoConfig | null;
-    /** Absolute path to the framework client runtime (`toiljs/client`). */
-    readonly runtimePath: string;
-    readonly vite: InlineConfig;
-}
-/** Identity helper for typed config files: `export default defineConfig({ ... })`. */
-export function defineConfig(config: ToilConfig): ToilConfig {
-    return config;
-}
-const CONFIG_NAMES = [
-    'toil.config.ts',
-    'toil.config.mts',
-    'toil.config.js',
-    'toil.config.mjs',
-    'toiljs.config.ts',
-    'toiljs.config.mts',
-    'toiljs.config.js',
-    'toiljs.config.mjs',
-];
-/** Path to the built client runtime (`build/client/index.js`), sibling to `build/compiler`. */
-function resolveRuntimePath(): string {
-    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../client/index.js');
-}
-/** Finds and loads `toil.config.*` or `toiljs.config.*` from `root`, then resolves defaults. */
-export async function loadConfig(
-    opts: { root?: string; port?: number } = {},
-): Promise<ResolvedToilConfig> {
-    const root = path.resolve(opts.root ?? process.cwd());
-    let user: ToilConfig = {};
-    for (const name of CONFIG_NAMES) {
-        const candidate = path.join(root, name);
-        if (fs.existsSync(candidate)) {
-            const loaded = (await import(pathToFileURL(candidate).href)) as { default?: ToilConfig };
-            if (loaded.default) user = loaded.default;
-            break;
-        }
-    }
-    const client = user.client ?? {};
-    const srcDir = client.srcDir ?? 'client';
-    const routesDir = client.routesDir ?? 'routes';
-    const clientAbsDir = path.join(root, srcDir);
-    return {
-        root,
-        srcDir,
-        clientAbsDir,
-        routesAbsDir: path.join(clientAbsDir, routesDir),
-        publicDir: client.publicDir
-            ? path.resolve(root, client.publicDir)
-            : path.join(clientAbsDir, 'public'),
-        toilDir: path.join(root, '.toil'),
-        outDir: client.outDir ?? 'build/client',
-        base: client.base ?? '/',
-        port: opts.port ?? client.port ?? 3000,
-        images: client.images ?? true,
-        fonts: client.fonts ?? true,
-        viewTransitions: client.viewTransitions ?? false,
-        seo: client.seo ?? null,
-        runtimePath: resolveRuntimePath(),
-        vite: client.vite ?? {},
-    };
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { type InlineConfig } from 'vite';
+import { type SeoConfig } from './seo.js';
+export type { SeoConfig } from './seo.js';
+/**
+ * Client-side (TSX/React/Vite) configuration. All fields optional; sensible defaults applied.
+ */
+export interface ClientConfig {
+    /** Client source directory, relative to root. Default `client`. */
+    readonly srcDir?: string;
+    /** Routes directory, relative to `srcDir`. Default `routes`. */
+    readonly routesDir?: string;
+    /**
+     * Static assets directory, relative to root. Default `<srcDir>/public` (e.g. `client/public`).
+     * Holds the `index.html` template (owned and edited by you) plus any files served as-is at the
+     * base path (favicons, images, …).
+     */
+    readonly publicDir?: string;
+    /** Production output directory, relative to root. Default `build/client`. */
+    readonly outDir?: string;
+    /** Public base path. Default `/`. */
+    readonly base?: string;
+    /** Dev server port. Default `3000`. */
+    readonly port?: number;
+    /**
+     * Optimize imported images at build time (resize/convert via `vite-imagetools` + sharp): an
+     * import like `logo.png?w=400;800&format=webp&as=srcset` emits resized, compressed variants.
+     * Default `true`. Set `false` to disable the pipeline (images are then served as-is).
+     */
+    readonly images?: boolean;
+    /**
+     * Preload bundled fonts at build time: injects `<link rel="preload" as="font">` for each
+     * `@font-face` font so it loads in parallel with the CSS (faster text paint). Default `true`.
+     */
+    readonly fonts?: boolean;
+    /**
+     * Animate cross-page navigations with the browser View Transitions API (a crossfade by default;
+     * add `view-transition-name` in CSS for shared-element transitions). Respects
+     * `prefers-reduced-motion`. Default `false`.
+     */
+    readonly viewTransitions?: boolean;
+    /**
+     * Build-time SEO: bakes site-level metadata into the HTML `<head>` (so JS-less crawlers and AI
+     * bots see real tags) and generates `robots.txt`, `sitemap.xml`, and `llms.txt`. Omit to skip.
+     */
+    readonly seo?: SeoConfig;
+    /**
+     * Raw Vite escape hatch, deep-merged over the framework's opinionated config.
+     * This is NOT the client config itself, toil owns the Vite setup; use this only
+     * to override specific Vite options.
+     */
+    readonly vite?: InlineConfig;
+}
+/**
+ * Server-side (toilscript → WASM) configuration. Reserved: the compiler does not yet
+ * build the server target via `toil build`; today it is compiled by `toilscript` directly.
+ */
+export interface ServerConfig {
+    /** Server source directory, relative to root. Default `server`. */
+    readonly srcDir?: string;
+    /** Server build output directory, relative to root. Default `build/server`. */
+    readonly outDir?: string;
+}
+/**
+ * The `toil.config` schema. All fields optional; sensible defaults applied.
+ * Client and server are configured in separate sections.
+ */
+export interface ToilConfig {
+    /** Project root. Defaults to the current working directory. */
+    readonly root?: string;
+    /** Client (TSX/React/Vite) configuration. */
+    readonly client?: ClientConfig;
+    /** Server (toilscript/WASM) configuration. */
+    readonly server?: ServerConfig;
+}
+/** Fully-resolved config with absolute paths, used internally by the compiler. */
+export interface ResolvedToilConfig {
+    readonly root: string;
+    readonly srcDir: string;
+    readonly clientAbsDir: string;
+    readonly routesAbsDir: string;
+    /** Absolute path to the static-assets dir (holds the `index.html` template). */
+    readonly publicDir: string;
+    readonly toilDir: string;
+    readonly outDir: string;
+    readonly base: string;
+    readonly port: number;
+    /** Whether build-time image optimization (`vite-imagetools`) is enabled. */
+    readonly images: boolean;
+    /** Whether build-time font preloading is enabled. */
+    readonly fonts: boolean;
+    /** Whether animated View Transitions are enabled for navigation. */
+    readonly viewTransitions: boolean;
+    /** Build-time SEO config, or `null` when not configured. */
+    readonly seo: SeoConfig | null;
+    /** Absolute path to the framework client runtime (`toiljs/client`). */
+    readonly runtimePath: string;
+    readonly vite: InlineConfig;
+}
+/** Identity helper for typed config files: `export default defineConfig({ ... })`. */
+export function defineConfig(config: ToilConfig): ToilConfig {
+    return config;
+}
+const CONFIG_NAMES = [
+    'toil.config.ts',
+    'toil.config.mts',
+    'toil.config.js',
+    'toil.config.mjs',
+    'toiljs.config.ts',
+    'toiljs.config.mts',
+    'toiljs.config.js',
+    'toiljs.config.mjs',
+];
+/** Path to the built client runtime (`build/client/index.js`), sibling to `build/compiler`. */
+function resolveRuntimePath(): string {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../client/index.js');
+}
+/** Finds and loads `toil.config.*` or `toiljs.config.*` from `root`, then resolves defaults. */
+export async function loadConfig(
+    opts: { root?: string; port?: number } = {},
+): Promise<ResolvedToilConfig> {
+    const root = path.resolve(opts.root ?? process.cwd());
+    let user: ToilConfig = {};
+    for (const name of CONFIG_NAMES) {
+        const candidate = path.join(root, name);
+        if (fs.existsSync(candidate)) {
+            const loaded = (await import(pathToFileURL(candidate).href)) as {
+                default?: ToilConfig;
+            };
+            if (loaded.default) user = loaded.default;
+            break;
+        }
+    }
+    const client = user.client ?? {};
+    const srcDir = client.srcDir ?? 'client';
+    const routesDir = client.routesDir ?? 'routes';
+    const clientAbsDir = path.join(root, srcDir);
+    return {
+        root,
+        srcDir,
+        clientAbsDir,
+        routesAbsDir: path.join(clientAbsDir, routesDir),
+        publicDir: client.publicDir
+            ? path.resolve(root, client.publicDir)
+            : path.join(clientAbsDir, 'public'),
+        toilDir: path.join(root, '.toil'),
+        outDir: client.outDir ?? 'build/client',
+        base: client.base ?? '/',
+        port: opts.port ?? client.port ?? 3000,
+        images: client.images ?? true,
+        fonts: client.fonts ?? true,
+        viewTransitions: client.viewTransitions ?? false,
+        seo: client.seo ?? null,
+        runtimePath: resolveRuntimePath(),
+        vite: client.vite ?? {},
+    };
+}

package/src/compiler/fonts.ts CHANGED Viewed

@@ -1,87 +1,89 @@
-import type { HtmlTagDescriptor, Logger, Plugin } from 'vite';
-import { type ResolvedToilConfig } from './config.js';
-/**
- * Build-time font optimization. Bundled font files (`@font-face` `url(...)` imports) are emitted +
- * hashed by Vite, but without a hint the browser only discovers them after parsing CSS, delaying
- * text paint. This injects a `<link rel="preload" as="font" crossorigin>` for each bundled font so
- * it loads in parallel with the CSS, and logs what it preloaded (mirrors the image-optimization log).
- */
-const FONT_RE = /\.(woff2|woff|ttf|otf)$/i;
-const FONT_TYPE: Record<string, string> = {
-    woff2: 'font/woff2',
-    woff: 'font/woff',
-    ttf: 'font/ttf',
-    otf: 'font/otf',
-};
-function kb(bytes: number): string {
-    return `${(bytes / 1000).toFixed(2)} kB`;
-}
-/** Builds the `<link rel="preload">` head tags for a set of bundled font file names. */
-export function fontPreloadTags(fileNames: readonly string[], base: string): HtmlTagDescriptor[] {
-    const prefix = base.endsWith('/') ? base : `${base}/`;
-    return fileNames
-        .filter((name) => FONT_RE.test(name))
-        .map((name) => {
-            const ext = name.split('.').pop()?.toLowerCase() ?? '';
-            return {
-                tag: 'link',
-                attrs: {
-                    rel: 'preload',
-                    as: 'font',
-                    type: FONT_TYPE[ext] ?? `font/${ext}`,
-                    href: `${prefix}${name}`,
-                    crossorigin: '',
-                },
-                injectTo: 'head',
-            };
-        });
-}
-/** Build-only plugin that preloads bundled fonts and logs them. Disabled by `client.fonts: false`. */
-export function fontPreloadPlugin(cfg: ResolvedToilConfig): Plugin {
-    let logger: Logger | undefined;
-    let logged = false;
-    return {
-        name: 'toil:font-preload',
-        apply: 'build',
-        configResolved(config) {
-            logger = config.logger;
-        },
-        transformIndexHtml: {
-            order: 'post',
-            handler(html, ctx) {
-                const bundle = ctx.bundle ?? {};
-                const fonts = Object.values(bundle).filter(
-                    (file) => file.type === 'asset' && FONT_RE.test(file.fileName),
-                );
-                if (fonts.length === 0) return html;
-                // Log once (the same template's HTML is transformed per emitted page).
-                if (!logged && logger) {
-                    logged = true;
-                    logger.info('');
-                    logger.info(`  ✓ preloaded ${String(fonts.length)} font${fonts.length === 1 ? '' : 's'}`);
-                    for (const file of fonts) {
-                        const size =
-                            file.type === 'asset' && typeof file.source !== 'string'
-                                ? kb(file.source.byteLength)
-                                : '';
-                        logger.info(`    → ${file.fileName}  ${size}`);
-                    }
-                }
-                return {
-                    html,
-                    tags: fontPreloadTags(
-                        fonts.map((f) => f.fileName),
-                        cfg.base,
-                    ),
-                };
-            },
-        },
-    };
-}
+import type { HtmlTagDescriptor, Logger, Plugin } from 'vite';
+import { type ResolvedToilConfig } from './config.js';
+/**
+ * Build-time font optimization. Bundled font files (`@font-face` `url(...)` imports) are emitted +
+ * hashed by Vite, but without a hint the browser only discovers them after parsing CSS, delaying
+ * text paint. This injects a `<link rel="preload" as="font" crossorigin>` for each bundled font so
+ * it loads in parallel with the CSS, and logs what it preloaded (mirrors the image-optimization log).
+ */
+const FONT_RE = /\.(woff2|woff|ttf|otf)$/i;
+const FONT_TYPE: Record<string, string> = {
+    woff2: 'font/woff2',
+    woff: 'font/woff',
+    ttf: 'font/ttf',
+    otf: 'font/otf',
+};
+function kb(bytes: number): string {
+    return `${(bytes / 1000).toFixed(2)} kB`;
+}
+/** Builds the `<link rel="preload">` head tags for a set of bundled font file names. */
+export function fontPreloadTags(fileNames: readonly string[], base: string): HtmlTagDescriptor[] {
+    const prefix = base.endsWith('/') ? base : `${base}/`;
+    return fileNames
+        .filter((name) => FONT_RE.test(name))
+        .map((name) => {
+            const ext = name.split('.').pop()?.toLowerCase() ?? '';
+            return {
+                tag: 'link',
+                attrs: {
+                    rel: 'preload',
+                    as: 'font',
+                    type: FONT_TYPE[ext] ?? `font/${ext}`,
+                    href: `${prefix}${name}`,
+                    crossorigin: '',
+                },
+                injectTo: 'head',
+            };
+        });
+}
+/** Build-only plugin that preloads bundled fonts and logs them. Disabled by `client.fonts: false`. */
+export function fontPreloadPlugin(cfg: ResolvedToilConfig): Plugin {
+    let logger: Logger | undefined;
+    let logged = false;
+    return {
+        name: 'toil:font-preload',
+        apply: 'build',
+        configResolved(config) {
+            logger = config.logger;
+        },
+        transformIndexHtml: {
+            order: 'post',
+            handler(html, ctx) {
+                const bundle = ctx.bundle ?? {};
+                const fonts = Object.values(bundle).filter(
+                    (file) => file.type === 'asset' && FONT_RE.test(file.fileName),
+                );
+                if (fonts.length === 0) return html;
+                // Log once (the same template's HTML is transformed per emitted page).
+                if (!logged && logger) {
+                    logged = true;
+                    logger.info('');
+                    logger.info(
+                        `  ✓ preloaded ${String(fonts.length)} font${fonts.length === 1 ? '' : 's'}`,
+                    );
+                    for (const file of fonts) {
+                        const size =
+                            file.type === 'asset' && typeof file.source !== 'string'
+                                ? kb(file.source.byteLength)
+                                : '';
+                        logger.info(`    → ${file.fileName}  ${size}`);
+                    }
+                }
+                return {
+                    html,
+                    tags: fontPreloadTags(
+                        fonts.map((f) => f.fileName),
+                        cfg.base,
+                    ),
+                };
+            },
+        },
+    };
+}