@datatechsolutions/tympan-tokens 0.3.1 → 0.4.1

package/dist/index.d.ts

@@ -660,8 +660,70 @@ export declare function printStyleToTheme(style: PrintStyle, override?: PrintThe
 export declare function printThemeDroppedPins(style: PrintStyle, override?: PrintThemeOverride): Record<Mode, Partial<Record<RoleName, string>>>;
 /** Every book style as a UI theme, in the order of `printPresets`. */
 export declare const printThemePresets: readonly ThemeConfig[];
-/** Stylesheet URL of the families of each print theme, by theme name (for ThemeProvider's `fonts`). */
+/**
+ * Legacy: Google Fonts stylesheet URL of the families of each print theme, by
+ * theme name. The print theme sheets now declare the bundled fonts
+ * (`printThemeFontSpecs`), so ThemeProvider needs no `fonts` map; this stays
+ * for hosts that prefer Google's CDN.
+ */
 export declare const printThemeFontUrls: Readonly<Record<string, string>>;
+/**
+ * Google Fonts specs of each print theme, by theme name: the families its
+ * stacks name, bundled under fonts/ and declared in the theme's sheet.
+ */
+export declare const printThemeFontSpecs: Readonly<Record<string, readonly string[]>>;
+//#endregion
+//#region src/fonts.d.ts
+/** Base stacks of every preset: Source Serif 4, IBM Plex Sans, IBM Plex Mono. */
+export declare const BASE_FONT_SPECS: readonly string[];
+/** Noto families named by the base stacks and the per-script `:lang()` rules. */
+export declare const SCRIPT_FONT_FAMILIES: readonly string[];
+export declare const SCRIPT_FONT_SPECS: readonly string[];
+/**
+ * The CJK Noto families (about 41 MB of woff2). The token stacks and the
+ * `:lang()` rules still name them, but their files and @font-face rules live
+ * in the optional package @datatechsolutions/tympan-fonts-cjk (activated with
+ * `import '@datatechsolutions/tympan-fonts-cjk/fonts.css'`); without it the
+ * browser falls back to the system CJK faces.
+ */
+export declare const CJK_FONT_FAMILIES: readonly string[];
+/** Specs whose faces go into the fonts.css of @datatechsolutions/tympan-fonts-cjk. */
+export declare const CJK_FONT_SPECS: readonly string[];
+/** Every spec whose faces go into dist/fonts.css (and so tokens.css): base and non-CJK Noto. */
+export declare const CORE_FONT_SPECS: readonly string[];
+/**
+ * Family names that are platform faces, generic keywords or legacy aliases
+ * kept as fallbacks; they get no @font-face (tests check that every other
+ * family a theme names is bundled).
+ */
+export declare const SYSTEM_FONT_FAMILIES: readonly string[];
+/** Shape of fonts/manifest.json (written by scripts/fetch-fonts.mjs). */
+export interface FontManifest {
+  families: Record<string, {
+    slug: string;
+    version: string | null;
+    files: number;
+    bytes: number;
+    license: string;
+    licenseFile: string;
+  }>;
+  faces: Record<string, {
+    family: string;
+    style: string;
+    weights: number[];
+    unicodeRange: string | null;
+    file: string;
+    bytes: number;
+  }>;
+  specs: Record<string, string[]>;
+}
+/**
+ * @font-face rules for the faces of `specs`, with `url(<base><file>)`
+ * (`base` is the path from the stylesheet to the fonts/ folder), font-display
+ * swap and the unicode-range of each slice. Faces shared by several specs
+ * are declared once.
+ */
+export declare function fontFaceCss(manifest: FontManifest, specs: readonly string[], base: string): string;
 //#endregion
 //#region src/index.d.ts
 export declare const allThemes: readonly ThemeConfig[];

package/dist/index.js

@@ -4610,8 +4610,18 @@ function draftPrintTheme(style, override = PRINT_THEME_OVERRIDES[style.name] ??
 }
 /** Every book style as a UI theme, in the order of `printPresets`. */
 const printThemePresets = Object.values(printPresets).map((s) => printStyleToTheme(s));
-/** Stylesheet URL of the families of each print theme, by theme name (for ThemeProvider's `fonts`). */
+/**
+* Legacy: Google Fonts stylesheet URL of the families of each print theme, by
+* theme name. The print theme sheets now declare the bundled fonts
+* (`printThemeFontSpecs`), so ThemeProvider needs no `fonts` map; this stays
+* for hosts that prefer Google's CDN.
+*/
 const printThemeFontUrls = Object.fromEntries(printThemePresets.filter((t) => t.fontsUrl).map((t) => [t.name, t.fontsUrl]));
+/**
+* Google Fonts specs of each print theme, by theme name: the families its
+* stacks name, bundled under fonts/ and declared in the theme's sheet.
+*/
+const printThemeFontSpecs = Object.fromEntries(Object.values(printPresets).map((s) => [`${PRINT_THEME_PREFIX}${s.name}`, [...s.googleFonts]]));
 //#endregion
 //#region src/scripts.ts
 const SCRIPT_RULES = [
@@ -5135,9 +5145,156 @@ function flowToneRules() {
 	].map((part) => `  --ty-flow-tone${part}: var(--ty-flow-tone-${t}${part});`).join("\n") + "\n}").join("\n\n");
 }
 //#endregion
+//#region src/fonts.ts
+/** Base stacks of every preset: Source Serif 4, IBM Plex Sans, IBM Plex Mono. */
+const BASE_FONT_SPECS = [
+	"Source Serif 4:ital,opsz,wght@0,8..60,400;0,8..60,600;0,8..60,700;1,8..60,400",
+	"IBM Plex Sans:ital,wght@0,400;0,500;0,600;0,700;1,400",
+	"IBM Plex Mono:ital,wght@0,400;0,500;0,600;0,700;1,400"
+];
+const NOTO_WEIGHTS = "wght@400;500;600;700";
+/** Noto families named by the base stacks and the per-script `:lang()` rules. */
+const SCRIPT_FONT_FAMILIES = [.../* @__PURE__ */ new Set([
+	"Noto Sans",
+	"Noto Serif",
+	"Noto Sans Mono",
+	"Noto Naskh Arabic",
+	"Noto Sans Arabic",
+	"Noto Sans Hebrew",
+	"Noto Serif Hebrew",
+	"Noto Sans Devanagari",
+	"Noto Serif Devanagari",
+	"Noto Sans Bengali",
+	"Noto Sans Tamil",
+	"Noto Sans Thai",
+	"Noto Serif Thai",
+	"Noto Sans Ethiopic",
+	"Noto Serif Ethiopic",
+	"Noto Sans Armenian",
+	"Noto Sans Georgian",
+	"Noto Sans JP",
+	"Noto Serif JP",
+	"Noto Sans SC",
+	"Noto Serif SC",
+	"Noto Sans KR",
+	"Noto Serif KR",
+	...SCRIPT_RULES.flatMap((r) => [...r.sans, ...r.serif ?? []])
+])];
+const SCRIPT_FONT_SPECS = SCRIPT_FONT_FAMILIES.map((f) => `${f}:${NOTO_WEIGHTS}`);
+/**
+* The CJK Noto families (about 41 MB of woff2). The token stacks and the
+* `:lang()` rules still name them, but their files and @font-face rules live
+* in the optional package @datatechsolutions/tympan-fonts-cjk (activated with
+* `import '@datatechsolutions/tympan-fonts-cjk/fonts.css'`); without it the
+* browser falls back to the system CJK faces.
+*/
+const CJK_FONT_FAMILIES = [
+	"Noto Sans JP",
+	"Noto Serif JP",
+	"Noto Sans SC",
+	"Noto Serif SC",
+	"Noto Sans TC",
+	"Noto Serif TC",
+	"Noto Sans KR",
+	"Noto Serif KR"
+];
+const isCjkSpec = (spec) => CJK_FONT_FAMILIES.includes(spec.split(":")[0]);
+/** Specs whose faces go into the fonts.css of @datatechsolutions/tympan-fonts-cjk. */
+const CJK_FONT_SPECS = SCRIPT_FONT_SPECS.filter(isCjkSpec);
+/** Every spec whose faces go into dist/fonts.css (and so tokens.css): base and non-CJK Noto. */
+const CORE_FONT_SPECS = [...BASE_FONT_SPECS, ...SCRIPT_FONT_SPECS.filter((s) => !isCjkSpec(s))];
+/**
+* Family names that are platform faces, generic keywords or legacy aliases
+* kept as fallbacks; they get no @font-face (tests check that every other
+* family a theme names is bundled).
+*/
+const SYSTEM_FONT_FAMILIES = [
+	"serif",
+	"sans-serif",
+	"monospace",
+	"cursive",
+	"fantasy",
+	"system-ui",
+	"ui-monospace",
+	"ui-sans-serif",
+	"ui-serif",
+	"-apple-system",
+	"BlinkMacSystemFont",
+	"Segoe UI",
+	"Segoe Print",
+	"Roboto",
+	"Helvetica Neue",
+	"Helvetica",
+	"Arial",
+	"Georgia",
+	"Times New Roman",
+	"Times",
+	"SFMono-Regular",
+	"Menlo",
+	"Monaco",
+	"Consolas",
+	"Liberation Mono",
+	"Courier New",
+	"Courier",
+	"Palatino",
+	"Palatino Linotype",
+	"Book Antiqua",
+	"Garamond",
+	"Baskerville",
+	"Didot",
+	"Futura",
+	"Gill Sans",
+	"Optima",
+	"Impact",
+	"Verdana",
+	"Tahoma",
+	"Trebuchet MS",
+	"Arial Narrow",
+	"Arial Black",
+	"Avenir",
+	"Avenir Next",
+	"American Typewriter",
+	"Rockwell",
+	"Copperplate",
+	"Bodoni 72",
+	"Hoefler Text",
+	"Iowan Old Style",
+	"Charter",
+	"Source Serif Pro"
+];
+/**
+* @font-face rules for the faces of `specs`, with `url(<base><file>)`
+* (`base` is the path from the stylesheet to the fonts/ folder), font-display
+* swap and the unicode-range of each slice. Faces shared by several specs
+* are declared once.
+*/
+function fontFaceCss(manifest, specs, base) {
+	const ids = /* @__PURE__ */ new Set();
+	for (const spec of specs) {
+		const faces = manifest.specs[spec];
+		if (!faces) throw new Error(`Font spec not bundled (run scripts/fetch-fonts.mjs): ${spec}`);
+		for (const id of faces) ids.add(id);
+	}
+	return [...ids].map((id) => {
+		const f = manifest.faces[id];
+		const lo = Math.min(...f.weights);
+		const hi = Math.max(...f.weights);
+		return [
+			"@font-face {",
+			`  font-family: '${f.family}';`,
+			`  font-style: ${f.style};`,
+			`  font-weight: ${lo === hi ? lo : `${lo} ${hi}`};`,
+			"  font-display: swap;",
+			`  src: url('${base}${f.file}') format('woff2');`,
+			...f.unicodeRange ? [`  unicode-range: ${f.unicodeRange};`] : [],
+			"}"
+		].join("\n");
+	}).join("\n");
+}
+//#endregion
 //#region src/index.ts
 const allThemes = [...presets, ...printThemePresets];
 //#endregion
-export { DEFAULT_CHART_HUES, DEFAULT_PRINT_STYLE, DEFAULT_THEME, DENSITIES, ESTADOS_PROVA, FLOW_TOKENS, FLOW_TONES, FONT_ROLE_TOKENS, FORCED_COLORS_VARS, OPAQUE_VARS, PRINT_PRESET_NAMES, PRINT_STYLE_ALIASES, PRINT_THEME_ALIASES, PRINT_THEME_OVERRIDES, PRINT_THEME_PREFIX, RAMP_STEPS, ROLE_ALIASES, ROLE_NAMES, ROTULOS_PROVA, allThemes, apcaContrast, astrlabeControlePreset, astrlabePreset, buildStylesheet, composite, contrastPairs, contrastRatio, deltaE2000, densityToDtcg, densityVariables, fakhirPreset, flatten, flowCssName, flowToDtcg, flowTokenCss, flowToneRules, flowVariables, fontStackToCss, fromDtcgColor, generatePrintThemesCss, generateRamp, generateThemeCss, googleFontsUrl, gradientToCss, highContrastPreset, legibleOn, luminance, mergePrintStyle, neutralPreset, oklchToRgb, papelEscuro, parseColor, parseFontStack, presetThemeVars, presets, printPresetById, printPresets, printStyleAccent, printStyleCoresPb, printStyleToCss, printStyleToTheme, printStyleVariables, printThemeDroppedPins, printThemeFontUrls, printThemePresets, resolvePrintStyle, resolvePrintStyleName, resolvePrintThemeName, resolveTheme, rgbToLab, rgbToOklab, rgbToOklch, seedFromColor, shadowToCss, themeSelectors, themeToDtcg, themeVariables, themeVarsFor, toCss, toDtcgColor, toGrey, toHex, tympanPreset, warnDeprecatedPrintId };
+export { BASE_FONT_SPECS, CJK_FONT_FAMILIES, CJK_FONT_SPECS, CORE_FONT_SPECS, DEFAULT_CHART_HUES, DEFAULT_PRINT_STYLE, DEFAULT_THEME, DENSITIES, ESTADOS_PROVA, FLOW_TOKENS, FLOW_TONES, FONT_ROLE_TOKENS, FORCED_COLORS_VARS, OPAQUE_VARS, PRINT_PRESET_NAMES, PRINT_STYLE_ALIASES, PRINT_THEME_ALIASES, PRINT_THEME_OVERRIDES, PRINT_THEME_PREFIX, RAMP_STEPS, ROLE_ALIASES, ROLE_NAMES, ROTULOS_PROVA, SCRIPT_FONT_FAMILIES, SCRIPT_FONT_SPECS, SYSTEM_FONT_FAMILIES, allThemes, apcaContrast, astrlabeControlePreset, astrlabePreset, buildStylesheet, composite, contrastPairs, contrastRatio, deltaE2000, densityToDtcg, densityVariables, fakhirPreset, flatten, flowCssName, flowToDtcg, flowTokenCss, flowToneRules, flowVariables, fontFaceCss, fontStackToCss, fromDtcgColor, generatePrintThemesCss, generateRamp, generateThemeCss, googleFontsUrl, gradientToCss, highContrastPreset, legibleOn, luminance, mergePrintStyle, neutralPreset, oklchToRgb, papelEscuro, parseColor, parseFontStack, presetThemeVars, presets, printPresetById, printPresets, printStyleAccent, printStyleCoresPb, printStyleToCss, printStyleToTheme, printStyleVariables, printThemeDroppedPins, printThemeFontSpecs, printThemeFontUrls, printThemePresets, resolvePrintStyle, resolvePrintStyleName, resolvePrintThemeName, resolveTheme, rgbToLab, rgbToOklab, rgbToOklch, seedFromColor, shadowToCss, themeSelectors, themeToDtcg, themeVariables, themeVarsFor, toCss, toDtcgColor, toGrey, toHex, tympanPreset, warnDeprecatedPrintId };
 
 //# sourceMappingURL=index.js.map