@junejs/server 1.0.0-dev.25 → 1.0.0-dev.28

package/assets/icon-latin.LICENSE.txt

@@ -0,0 +1,92 @@
+Copyright (c) 2016 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION AND CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/app.js

@@ -9,12 +9,13 @@ import { CLIENT_SCRIPT_URL, bundleClientSplit, findClientEntry } from "./client-
 import { generateIslandRegistry } from "./island-registry.js";
 import { STYLES_URL, findGlobalCss, globalCssUsesTailwind, processCssCached } from "./css.js";
 import { contentTypeFor, safeRelativePath } from "./static-files.js";
+import { GENERATED_ICONS, googleFontFetcher, publicFileCheck, renderIcons, resolveIcons } from "./favicon.js";
 import { existsSync, lstatSync, realpathSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { routeFromModule } from "@junejs/core/route";
-import { resolveAgent, resolveClientRouter, resolveSpeculationRules } from "@junejs/core/config";
+import { deployOrigin, resolveAgent, resolveClientRouter, resolveSpeculationRules } from "@junejs/core/config";
 import { runWithTrace } from "@junejs/core/instrumentation";
 import { anthropic } from "@junejs/core/agent-models";
 //#region src/app.ts
@@ -68,19 +69,31 @@ function createApp({ appDir: appDirInput, config = {} }) {
 	try {
 		if (lstatSync(publicDir).isDirectory()) publicRoot = realpathSync(publicDir);
 	} catch {}
+	const iconPlan = resolveIcons(config.site ?? {}, publicFileCheck(publicDir));
+	let iconsPromise;
+	const getIcons = () => iconsPromise ??= renderIcons({
+		site: config.site ?? {},
+		fetchFont: googleFontFetcher(join(dirname(appDir), "node_modules", ".cache", "june", "fonts")),
+		warn: (msg) => console.warn(msg)
+	}).catch((err) => {
+		iconsPromise = void 0;
+		throw err;
+	});
 	const agent = resolveAgent(config.agent);
 	const speculation = config.speculation;
 	const clientEntry = findClientEntry(appDir) ?? findClientEntry(join(dirname(appDir), ".june", "routes"));
 	const cssEntry = findGlobalCss(appDir);
 	const docConfig = {
 		site: config.site ?? {},
+		deployOrigin: deployOrigin(config),
 		speculationRules: resolveSpeculationRules(speculation ?? void 0),
 		speculationDelivery: speculation ? speculation.delivery ?? "inline" : "inline",
 		viewTransitions: config.viewTransitions ?? true,
 		cssReset: config.cssReset ?? !globalCssUsesTailwind(appDir),
 		clientRouter: resolveClientRouter(config.clientRouter),
 		clientScript: clientEntry ? CLIENT_SCRIPT_URL : null,
-		styles: cssEntry ? STYLES_URL : null
+		styles: cssEntry ? STYLES_URL : null,
+		icons: iconPlan.icons
 	};
 	let moduleCssPromise;
 	const getModuleCss = () => moduleCssPromise ??= buildModuleCss(appDir, dirname(appDir));
@@ -233,6 +246,13 @@ function createApp({ appDir: appDirInput, config = {} }) {
 					}
 				}
 			}
+			if (iconPlan.generate && (request.method === "GET" || request.method === "HEAD")) {
+				const name = new URL(request.url).pathname.slice(1);
+				if (GENERATED_ICONS.includes(name)) return getIcons().then((icons) => new Response(request.method === "HEAD" ? null : icons[name], { headers: {
+					"content-type": contentTypeFor(name),
+					"cache-control": "public, max-age=0, must-revalidate"
+				} }), () => toPipeline());
+			}
 			return toPipeline();
 		},
 		async warmup() {

package/dist/build.js

@@ -7,6 +7,7 @@ import { bundleClientToFile, findClientEntry } from "./client-bundle.js";
 import { generateIslandRegistry } from "./island-registry.js";
 import { cssTargets, minifyCss, processCss } from "./css.js";
 import { RESERVED_PREFIX } from "./static-files.js";
+import { GENERATED_ICONS, googleFontFetcher, publicFileCheck, renderIcons, resolveIcons } from "./favicon.js";
 import { loadJuneConfig } from "./config-loader.js";
 import { freezeConfig, normalizeBase, resolveDeployAdapter, workerName } from "./config-freeze.js";
 import { generateContent } from "./content-freeze.js";
@@ -17,6 +18,7 @@ import { buildRsc, findRscRoutes } from "./rsc-build.js";
 import { existsSync, lstatSync } from "node:fs";
 import { copyFile, mkdir, readdir, rm, writeFile } from "node:fs/promises";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";
+import { PRERENDER_ORIGIN } from "@junejs/core/document";
 import { buildLinkHeader } from "@junejs/core/discovery";
 import { localeHref } from "@junejs/core/i18n";
 import { createHash } from "node:crypto";
@@ -287,6 +289,20 @@ ${doClass}`;
 		}
 		if (publicFiles.length) hasAssets = true;
 	}
+	const site = frozen.document.site;
+	if (resolveIcons(site, publicFileCheck(publicDir)).generate) {
+		const icons = await renderIcons({
+			site,
+			fetchFont: googleFontFetcher(join(appRoot, "node_modules", ".cache", "june", "fonts")),
+			warn: (msg) => console.warn(msg)
+		});
+		await mkdir(assetsDir, { recursive: true });
+		for (const file of GENERATED_ICONS) {
+			await writeFile(join(assetsDir, file), icons[file]);
+			publicFiles.push(file);
+		}
+		hasAssets = true;
+	}
 	const isStatic = adapter.capabilities.runtime === "static";
 	const i18n = frozen.i18n;
 	const prerenderOne = async (reqPath, def) => {
@@ -301,7 +317,7 @@ ${doClass}`;
 		if (def.md !== false) targets.push([mdReq, mdFile]);
 		if (typeof def.json === "function") targets.push([jsonReq, jsonFile]);
 		for (const [rp, file] of targets) {
-			const res = await worker.fetch(new Request(`https://prerender.june${rp}`));
+			const res = await worker.fetch(new Request(`${PRERENDER_ORIGIN}${rp}`));
 			if (!res.ok) throw new Error(`prerender ${rp} → ${res.status}`);
 			const dest = join(assetsDir, file);
 			await mkdir(dirname(dest), { recursive: true });
@@ -326,15 +342,16 @@ ${doClass}`;
 		}
 		for (const [reqPath, file] of [
 			["/favicon.svg", "favicon.svg"],
+			["/manifest.webmanifest", "manifest.webmanifest"],
 			["/llms.txt", "llms.txt"],
 			["/sitemap.xml", "sitemap.xml"]
 		]) {
-			const res = await worker.fetch(new Request(`https://prerender.june${reqPath}`));
+			const res = await worker.fetch(new Request(`${PRERENDER_ORIGIN}${reqPath}`));
 			if (!res.ok) continue;
 			await writeFile(join(assetsDir, file), Buffer.from(await res.arrayBuffer()));
 			hasAssets = true;
 		}
-		const nf = await worker.fetch(new Request("https://prerender.june/__june_not_found__"));
+		const nf = await worker.fetch(new Request(`${PRERENDER_ORIGIN}/__june_not_found__`));
 		await writeFile(join(assetsDir, "404.html"), Buffer.from(await nf.arrayBuffer()));
 		hasAssets = true;
 	}

package/dist/config-freeze.js

@@ -1,9 +1,10 @@
 import { deno, staticSite, vercel, workers } from "./adapter.js";
 import { CLIENT_SCRIPT_URL, findClientEntry } from "./client-bundle.js";
 import { STYLES_URL, findGlobalCss, globalCssUsesTailwind } from "./css.js";
+import { publicFileCheck, resolveIcons } from "./favicon.js";
 import { loadJuneConfig } from "./config-loader.js";
 import { join } from "node:path";
-import { resolveAgent, resolveClientRouter, resolveSpeculationRules } from "@junejs/core/config";
+import { deployOrigin, resolveAgent, resolveClientRouter, resolveSpeculationRules } from "@junejs/core/config";
 //#region src/config-freeze.ts
 function resolveDeployAdapter(deploy) {
 	if (deploy?.adapter) return deploy.adapter;
@@ -24,6 +25,7 @@ async function freezeConfig(appRoot) {
 	return {
 		document: {
 			site: cfg.site ?? {},
+			deployOrigin: deployOrigin(cfg),
 			speculationRules: resolveSpeculationRules(cfg.speculation ?? void 0),
 			speculationDelivery: "inline",
 			viewTransitions: cfg.viewTransitions ?? true,
@@ -31,7 +33,8 @@ async function freezeConfig(appRoot) {
 			clientRouter: resolveClientRouter(cfg.clientRouter),
 			clientScript: hasClient ? CLIENT_SCRIPT_URL : null,
 			styles: hasCss ? STYLES_URL : null,
-			basePath: normalizeBase(cfg.basePath)
+			basePath: normalizeBase(cfg.basePath),
+			icons: resolveIcons(cfg.site ?? {}, publicFileCheck(join(appRoot, "public"))).icons
 		},
 		agent: resolveAgent(cfg.agent),
 		i18n: cfg.i18n,

package/dist/content.d.ts

@@ -1,5 +1,14 @@
 import { ContentSource } from "@junejs/core/config";
 //#region src/content.d.ts
+type Heading = {
+  depth: number;
+  text: string;
+  id: string;
+};
+declare function headingIds(html: string): {
+  html: string;
+  headings: Heading[];
+};
 type ContentEntry = {
   slug: string;
   file: string;
@@ -9,8 +18,13 @@ type ContentEntry = {
   body: string;
   /** The authored file, verbatim — the agent-facing .md projection. */
   original: string;
-  /** The body rendered to HTML (CommonMark + GFM, via @momiji-rs/sparkdown/gfm wasm). */
+  /** The body rendered to HTML (CommonMark + GFM, via @momiji-rs/sparkdown/gfm wasm).
+   *  Every heading carries a GitHub-compatible `id` (see @junejs/core/slug) and nothing
+   *  else — no injected links or classes; how an anchor looks is the app's call. */
   html: string;
+  /** The headings of `html`, in document order: their depth (1–6), plain text, and the
+   *  `id` each carries in `html` — for a table of contents, or a structured projection. */
+  headings: Heading[];
   /** The locale this entry was authored in — set for files under a `<locale>/`
    *  subdir, undefined for the flat (default-locale) files. */
   locale?: string;
@@ -36,4 +50,4 @@ declare function generateContentModule(contentDir: string, knownLocales?: readon
   names: string[];
 };
 //#endregion
-export { ContentEntry, ScannedCollection, collection, entry, generateContentModule, scanCollection };
+export { ContentEntry, Heading, ScannedCollection, collection, entry, generateContentModule, headingIds, scanCollection };

package/dist/content.js

@@ -1,6 +1,7 @@
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { initSync, toHtmlSync } from "@momiji-rs/sparkdown/gfm";
+import { createSlugger } from "@junejs/core/slug";
 //#region src/content.ts
 let wasmReady = false;
 const ensureWasm = () => {
@@ -9,6 +10,42 @@ const ensureWasm = () => {
 		wasmReady = true;
 	}
 };
+const NAMED = {
+	amp: "&",
+	lt: "<",
+	gt: ">",
+	quot: "\"",
+	apos: "'"
+};
+const decodeEntities = (s) => s.replace(/&(#x[0-9a-f]+|#\d+|[a-z]+);/gi, (m, e) => e[0] === "#" ? String.fromCodePoint(e[1] === "x" || e[1] === "X" ? parseInt(e.slice(2), 16) : Number(e.slice(1))) : NAMED[e.toLowerCase()] ?? m);
+const ID_ATTR = /\sid\s*=\s*(?:"([^"]*)"|'([^']*)')/i;
+function headingIds(html) {
+	const slug = createSlugger();
+	const taken = /* @__PURE__ */ new Set();
+	for (const m of html.matchAll(new RegExp(ID_ATTR.source, "gi"))) taken.add(m[1] ?? m[2]);
+	const headings = [];
+	return {
+		html: html.replace(/<h([1-6])(\s[^>]*)?>([\s\S]*?)<\/h\1>/gi, (_m, depth, attrs, inner) => {
+			const text = decodeEntities(inner.replace(/<[^>]*>/g, "")).trim();
+			const own = attrs ? ID_ATTR.exec(attrs) : null;
+			const authored = own ? own[1] ?? own[2] : void 0;
+			let id = authored;
+			if (!id) {
+				do
+					id = slug(text);
+				while (taken.has(id));
+				taken.add(id);
+			}
+			headings.push({
+				depth: Number(depth),
+				text,
+				id
+			});
+			return authored ? _m : `<h${depth}${(attrs ?? "").replace(ID_ATTR, "")} id="${id}">${inner}</h${depth}>`;
+		}),
+		headings
+	};
+}
 function parseFrontmatter(raw) {
 	if (!raw.startsWith("---")) return {
 		data: {},
@@ -48,13 +85,15 @@ function loadEntry(file, slug, locale) {
 		if (h1?.[1]) data.title = h1[1];
 	}
 	ensureWasm();
+	const { html, headings } = headingIds(toHtmlSync(body));
 	const entry = {
 		slug,
 		file,
 		data,
 		body,
 		original,
-		html: toHtmlSync(body),
+		html,
+		headings,
 		...locale ? { locale } : {}
 	};
 	memo.set(key, {
@@ -160,6 +199,7 @@ function generateContentModule(contentDir, knownLocales, sources) {
 		body: e.body,
 		original: e.original,
 		html: e.html,
+		headings: e.headings,
 		...e.locale ? { locale: e.locale } : {}
 	});
 	const collections = /* @__PURE__ */ new Map();
@@ -193,9 +233,9 @@ function generateContentModule(contentDir, knownLocales, sources) {
 		names.push(name);
 	}
 	return {
-		code: "// AUTO-GENERATED by `june build` — edit content/**/*.md, not this file.\n" + (anyLocale ? "export type ContentEntry = { slug: string; data: Record<string, string | string[]>; body: string; original: string; html: string; locale?: string };\n" : "export type ContentEntry = { slug: string; data: Record<string, string | string[]>; body: string; original: string; html: string };\n") + body,
+		code: "// AUTO-GENERATED by `june build` — edit content/**/*.md, not this file.\n" + (anyLocale ? "export type ContentEntry = { slug: string; data: Record<string, string | string[]>; body: string; original: string; html: string; headings: Array<{ depth: number; text: string; id: string }>; locale?: string };\n" : "export type ContentEntry = { slug: string; data: Record<string, string | string[]>; body: string; original: string; html: string; headings: Array<{ depth: number; text: string; id: string }> };\n") + body,
 		names
 	};
 }
 //#endregion
-export { collection, entry, generateContentModule, scanCollection };
+export { collection, entry, generateContentModule, headingIds, scanCollection };

package/dist/favicon.d.ts

@@ -0,0 +1,38 @@
+import { DocumentConfig } from "@junejs/core/document";
+//#region src/favicon.d.ts
+type Site = DocumentConfig["site"];
+declare const ICON_BG = "#1d1d1f";
+declare const ICON_FG = "#fbfbf8";
+declare const GENERATED_ICONS: readonly ["apple-touch-icon.png", "icon.png", "favicon.ico", "icon-192.png", "icon-512.png"];
+type GeneratedIconFile = (typeof GENERATED_ICONS)[number];
+declare function publicFileCheck(publicDir: string): (file: string) => boolean;
+declare function resolveIcons(site: Site, inPublic: (file: string) => boolean): {
+  generate: boolean;
+  icons: NonNullable<DocumentConfig["icons"]>;
+};
+declare function hanFamily(lang: string | undefined): string;
+declare function iconFamily(ch: string, lang: string | undefined): string | null | undefined;
+type FontFetcher = (family: string, text: string) => Promise<Uint8Array | null>;
+declare function googleFontFetcher(cacheDir: string, opts?: {
+  fetch?: typeof fetch;
+  timeoutMs?: number;
+}): FontFetcher;
+declare const INK_H = 28;
+declare const INK_W = 40;
+declare function pngToIco(png: Uint8Array, size: number): Uint8Array<ArrayBuffer>;
+type GeneratedIcons = {
+  "apple-touch-icon.png": Uint8Array<ArrayBuffer>;
+  "icon.png": Uint8Array<ArrayBuffer>;
+  "favicon.ico": Uint8Array<ArrayBuffer>;
+  "icon-192.png": Uint8Array<ArrayBuffer>;
+  "icon-512.png": Uint8Array<ArrayBuffer>;
+  letter: string;
+  family: string | null;
+};
+declare function renderIcons(opts: {
+  site: Site;
+  fetchFont: FontFetcher;
+  warn?: (msg: string) => void;
+}): Promise<GeneratedIcons>;
+//#endregion
+export { FontFetcher, GENERATED_ICONS, GeneratedIconFile, GeneratedIcons, ICON_BG, ICON_FG, INK_H, INK_W, googleFontFetcher, hanFamily, iconFamily, pngToIco, publicFileCheck, renderIcons, resolveIcons };

package/dist/favicon.js

@@ -0,0 +1,248 @@
+import { iconLetter } from "./icon-letter.js";
+import { existsSync, lstatSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { createHash } from "node:crypto";
+import { createRequire } from "node:module";
+//#region src/favicon.ts
+const ICON_BG = "#1d1d1f";
+const ICON_FG = "#fbfbf8";
+const GENERATED_ICONS = [
+	"apple-touch-icon.png",
+	"icon.png",
+	"favicon.ico",
+	"icon-192.png",
+	"icon-512.png"
+];
+const PRIMARY_ICON_FILES = [
+	"favicon.svg",
+	"icon.svg",
+	"favicon.png",
+	"icon.png",
+	"favicon.ico"
+];
+const CUSTOM_ICON_FILES = [...PRIMARY_ICON_FILES, "apple-touch-icon.png"];
+const MANIFEST_FILES = [
+	"manifest.webmanifest",
+	"manifest.json",
+	"site.webmanifest"
+];
+function publicFileCheck(publicDir) {
+	let real = false;
+	try {
+		real = lstatSync(publicDir).isDirectory();
+	} catch {}
+	return (file) => real && existsSync(join(publicDir, file));
+}
+function resolveIcons(site, inPublic) {
+	const ownManifest = MANIFEST_FILES.find(inPublic);
+	if (!(Boolean(site.icon) || CUSTOM_ICON_FILES.some(inPublic))) return {
+		generate: true,
+		icons: {
+			png: "/icon.png",
+			appleTouch: "/apple-touch-icon.png",
+			manifest: ownManifest ? `/${ownManifest}` : "/manifest.webmanifest",
+			generated: !ownManifest
+		}
+	};
+	const primary = PRIMARY_ICON_FILES.find(inPublic);
+	return {
+		generate: false,
+		icons: {
+			primary: primary ? `/${primary}` : void 0,
+			png: inPublic("icon.png") ? "/icon.png" : void 0,
+			appleTouch: inPublic("apple-touch-icon.png") ? "/apple-touch-icon.png" : void 0,
+			manifest: ownManifest ? `/${ownManifest}` : void 0
+		}
+	};
+}
+const is = (re) => (ch) => re.test(ch);
+const isBundled = is(/^[\p{Script=Latin}\p{Script=Greek}\p{Script=Cyrillic}0-9•]/u);
+const isEmoji = is(/^\p{Extended_Pictographic}/u);
+const isKana = is(/^[\p{Script=Hiragana}\p{Script=Katakana}]/u);
+const isHangul = is(/^\p{Script=Hangul}/u);
+const isHan = is(/^\p{Script=Han}/u);
+const NOTO_SCRIPT_RES = [
+	"Arabic",
+	"Armenian",
+	"Bengali",
+	"Devanagari",
+	"Ethiopic",
+	"Georgian",
+	"Gujarati",
+	"Gurmukhi",
+	"Hebrew",
+	"Kannada",
+	"Khmer",
+	"Lao",
+	"Malayalam",
+	"Myanmar",
+	"Sinhala",
+	"Tamil",
+	"Telugu",
+	"Thai"
+].map((s) => [s, new RegExp(`^\\p{Script=${s}}`, "u")]);
+function hanFamily(lang) {
+	let loc;
+	try {
+		loc = new Intl.Locale(lang || "und").maximize();
+	} catch {
+		return "Noto Sans SC";
+	}
+	if (loc.script === "Jpan") return "Noto Sans JP";
+	if (loc.script === "Kore") return "Noto Sans KR";
+	if (loc.script === "Hant") return loc.region === "HK" || loc.region === "MO" ? "Noto Sans HK" : "Noto Sans TC";
+	return "Noto Sans SC";
+}
+function iconFamily(ch, lang) {
+	if (!ch) return void 0;
+	if (isBundled(ch)) return null;
+	if (isEmoji(ch)) return "Noto Emoji";
+	if (isKana(ch)) return "Noto Sans JP";
+	if (isHangul(ch)) return "Noto Sans KR";
+	if (isHan(ch)) return hanFamily(lang);
+	const script = NOTO_SCRIPT_RES.find(([, re]) => re.test(ch))?.[0];
+	return script ? `Noto Sans ${script}` : void 0;
+}
+const LEGACY_UA = "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_6_8) AppleWebKit/533.21.1 (KHTML, like Gecko) Version/5.0.5 Safari/533.21.1";
+function googleFontFetcher(cacheDir, opts = {}) {
+	const doFetch = opts.fetch ?? fetch;
+	const timeoutMs = opts.timeoutMs ?? 3e3;
+	return async (family, text) => {
+		const cssUrl = `https://fonts.googleapis.com/css2?family=${encodeURIComponent(family)}:wght@600&text=${encodeURIComponent(text)}`;
+		const file = join(cacheDir, createHash("sha256").update(cssUrl).digest("hex").slice(0, 32) + ".ttf");
+		try {
+			return new Uint8Array(await readFile(file));
+		} catch {}
+		try {
+			const signal = AbortSignal.timeout(timeoutMs);
+			const cssRes = await doFetch(cssUrl, {
+				headers: { "User-Agent": LEGACY_UA },
+				signal
+			});
+			if (!cssRes.ok) return null;
+			const url = (await cssRes.text()).match(/src: url\((.+?)\)/)?.[1];
+			if (!url) return null;
+			const fontRes = await doFetch(url, { signal });
+			if (!fontRes.ok) return null;
+			const bytes = new Uint8Array(await fontRes.arrayBuffer());
+			await mkdir(cacheDir, { recursive: true });
+			await writeFile(file, bytes);
+			return bytes;
+		} catch {
+			return null;
+		}
+	};
+}
+let resvgReady;
+function loadResvg() {
+	return resvgReady ??= (async () => {
+		const mod = await import("@resvg/resvg-wasm");
+		const wasmPath = createRequire(import.meta.url).resolve("@resvg/resvg-wasm/index_bg.wasm");
+		await mod.initWasm(await readFile(wasmPath));
+		return mod;
+	})();
+}
+let bundledFont;
+const loadBundledFont = () => bundledFont ??= readFile(new URL("../assets/icon-latin.ttf", import.meta.url)).then((b) => new Uint8Array(b));
+const BUNDLED_FAMILY = "Inter";
+const escapeXml = (s) => s.replace(/[<>&"']/g, (c) => `&#${c.charCodeAt(0)};`);
+const PROBE = 1e3;
+const INK_H = 28;
+const INK_W = 40;
+function inkBox(resvg, ch, family, font) {
+	const probe = `<svg xmlns="http://www.w3.org/2000/svg" width="${PROBE}" height="${PROBE}"><text x="${PROBE / 2}" y="${PROBE * .7}" font-family="${family}" font-size="${PROBE * .6}">${escapeXml(ch)}</text></svg>`;
+	const r = new resvg.Resvg(probe, { font: {
+		fontBuffers: [font],
+		loadSystemFonts: false,
+		defaultFontFamily: family
+	} });
+	const bbox = r.getBBox();
+	const box = bbox && bbox.width > 0 && bbox.height > 0 ? {
+		x: bbox.x,
+		y: bbox.y,
+		width: bbox.width,
+		height: bbox.height
+	} : null;
+	bbox?.free();
+	r.free();
+	return box;
+}
+const NOTDEF_PROBE = "";
+function place(resvg, ch, family, font) {
+	const bbox = inkBox(resvg, ch, family, font);
+	if (!bbox) return null;
+	const notdef = inkBox(resvg, NOTDEF_PROBE, family, font);
+	if (notdef && notdef.x === bbox.x && notdef.y === bbox.y && notdef.width === bbox.width && notdef.height === bbox.height) return null;
+	const scale = Math.min(28 / bbox.height, 40 / bbox.width);
+	const cx = bbox.x + bbox.width / 2 - PROBE / 2;
+	const cy = bbox.y + bbox.height / 2 - PROBE * .7;
+	return {
+		family,
+		font,
+		size: PROBE * .6 * scale,
+		x: 32 - cx * scale,
+		y: 32 - cy * scale
+	};
+}
+function iconSvg(ch, p, rounded) {
+	const glyph = p ? `<text x="${p.x.toFixed(2)}" y="${p.y.toFixed(2)}" font-family="${p.family}" font-size="${p.size.toFixed(2)}" fill="${ICON_FG}">${escapeXml(ch)}</text>` : "";
+	return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64"><rect width="64" height="64"${rounded ? ` rx="12"` : ""} fill="${ICON_BG}"/>${glyph}</svg>`;
+}
+function pngToIco(png, size) {
+	const out = new Uint8Array(22 + png.length);
+	const v = new DataView(out.buffer);
+	v.setUint16(2, 1, true);
+	v.setUint16(4, 1, true);
+	out[6] = size >= 256 ? 0 : size;
+	out[7] = size >= 256 ? 0 : size;
+	v.setUint16(10, 1, true);
+	v.setUint16(12, 32, true);
+	v.setUint32(14, png.length, true);
+	v.setUint32(18, 22, true);
+	out.set(png, 22);
+	return out;
+}
+async function renderIcons(opts) {
+	const resvg = await loadResvg();
+	const ch = iconLetter(opts.site.name);
+	const family = iconFamily(ch, opts.site.lang);
+	let placement = null;
+	if (family === null) placement = place(resvg, ch, BUNDLED_FAMILY, await loadBundledFont());
+	else if (family !== void 0) {
+		const font = await opts.fetchFont(family, ch);
+		if (font) placement = place(resvg, ch, family, font);
+	}
+	if (ch && !placement) opts.warn?.(`[june] default icon: no font for "${ch}"${family ? ` (${family} unavailable — offline?)` : ""}; drew the square without it. Set site.icon or add public/icon.png to use your own.`);
+	const fonts = placement ? [placement.font] : [];
+	const render = (size, rounded) => {
+		const r = new resvg.Resvg(iconSvg(ch, placement, rounded), {
+			fitTo: {
+				mode: "width",
+				value: size
+			},
+			font: {
+				fontBuffers: fonts,
+				loadSystemFonts: false,
+				defaultFontFamily: placement?.family ?? BUNDLED_FAMILY
+			}
+		});
+		const image = r.render();
+		const png = image.asPng();
+		image.free();
+		r.free();
+		return png;
+	};
+	const icon32 = render(32, true);
+	return {
+		"apple-touch-icon.png": render(180, false),
+		"icon.png": icon32,
+		"favicon.ico": pngToIco(icon32, 32),
+		"icon-192.png": render(192, false),
+		"icon-512.png": render(512, false),
+		letter: ch,
+		family: placement?.family ?? null
+	};
+}
+//#endregion
+export { GENERATED_ICONS, ICON_BG, ICON_FG, INK_H, INK_W, googleFontFetcher, hanFamily, iconFamily, pngToIco, publicFileCheck, renderIcons, resolveIcons };

package/dist/icon-letter.d.ts

@@ -0,0 +1,4 @@
+//#region src/icon-letter.d.ts
+declare function iconLetter(name: string | undefined): string;
+//#endregion
+export { iconLetter };

package/dist/icon-letter.js

@@ -0,0 +1,8 @@
+//#region src/icon-letter.ts
+function iconLetter(name) {
+	const trimmed = (name ?? "").trim();
+	if (!trimmed) return "";
+	return (new Intl.Segmenter(void 0, { granularity: "grapheme" }).segment(trimmed)[Symbol.iterator]().next().value?.segment ?? "").toUpperCase();
+}
+//#endregion
+export { iconLetter };