@stll/folio-core 0.0.1-placeholder.0 → 0.1.0

package/dist/utils/fontResolver.js

@@ -0,0 +1,651 @@
+//#region src/utils/fontResolver.ts
+/**
+* Default OS/2 single-line ratio for unmapped fonts.
+* Middle of the common range (1.07–1.27) for standard DOCX fonts.
+*/
+const DEFAULT_SINGLE_LINE_RATIO = 1.15;
+/**
+* Mapping of common DOCX fonts to Google Fonts equivalents
+*
+* These are metrically compatible fonts that preserve document layout.
+* See: https://wiki.archlinux.org/title/Metric-compatible_fonts
+*
+* singleLineRatio values are derived from each font's OS/2 table:
+* (usWinAscent + usWinDescent) / unitsPerEm
+* These define the Windows GDI "single line" height that OOXML lineRule="auto" uses.
+* sTypoLineGap (external leading) is NOT included — Word excludes it from the
+* lineRule="auto" calculation (ECMA-376 §17.3.1.33).
+*/
+const FONT_MAPPINGS = {
+	calibri: {
+		googleFont: "Carlito",
+		category: "sans-serif",
+		fallbackStack: [
+			"Calibri",
+			"Carlito",
+			"Arial",
+			"Helvetica",
+			"sans-serif"
+		],
+		singleLineRatio: 1.2207
+	},
+	cambria: {
+		googleFont: "Caladea",
+		category: "serif",
+		fallbackStack: [
+			"Cambria",
+			"Caladea",
+			"Georgia",
+			"serif"
+		],
+		singleLineRatio: 1.2676
+	},
+	arial: {
+		googleFont: "Arimo",
+		category: "sans-serif",
+		fallbackStack: [
+			"Arial",
+			"Arimo",
+			"Helvetica",
+			"sans-serif"
+		],
+		singleLineRatio: 1.1172
+	},
+	"times new roman": {
+		googleFont: "Tinos",
+		category: "serif",
+		fallbackStack: [
+			"Times New Roman",
+			"Tinos",
+			"Times",
+			"serif"
+		],
+		singleLineRatio: 1.1074
+	},
+	"courier new": {
+		googleFont: "Cousine",
+		category: "monospace",
+		fallbackStack: [
+			"Courier New",
+			"Cousine",
+			"Courier",
+			"monospace"
+		],
+		singleLineRatio: 1.1328
+	},
+	georgia: {
+		googleFont: "Tinos",
+		category: "serif",
+		fallbackStack: [
+			"Georgia",
+			"Tinos",
+			"Times New Roman",
+			"serif"
+		],
+		singleLineRatio: 1.1362
+	},
+	verdana: {
+		googleFont: "Open Sans",
+		category: "sans-serif",
+		fallbackStack: [
+			"Verdana",
+			"Open Sans",
+			"Arial",
+			"sans-serif"
+		],
+		singleLineRatio: 1.2153
+	},
+	tahoma: {
+		googleFont: "Open Sans",
+		category: "sans-serif",
+		fallbackStack: [
+			"Tahoma",
+			"Open Sans",
+			"Arial",
+			"sans-serif"
+		],
+		singleLineRatio: 1.2075
+	},
+	"trebuchet ms": {
+		googleFont: "Fira Sans",
+		category: "sans-serif",
+		fallbackStack: [
+			"Trebuchet MS",
+			"Fira Sans",
+			"Arial",
+			"sans-serif"
+		],
+		singleLineRatio: 1.1431
+	},
+	"comic sans ms": {
+		googleFont: "Comic Neue",
+		category: "cursive",
+		fallbackStack: [
+			"Comic Sans MS",
+			"Comic Neue",
+			"cursive"
+		],
+		singleLineRatio: 1.3936
+	},
+	impact: {
+		googleFont: "Anton",
+		category: "sans-serif",
+		fallbackStack: [
+			"Impact",
+			"Anton",
+			"Arial Black",
+			"sans-serif"
+		],
+		singleLineRatio: 1.2197
+	},
+	"palatino linotype": {
+		googleFont: "EB Garamond",
+		category: "serif",
+		fallbackStack: [
+			"Palatino Linotype",
+			"EB Garamond",
+			"Palatino",
+			"Georgia",
+			"serif"
+		],
+		singleLineRatio: 1.0259
+	},
+	"book antiqua": {
+		googleFont: "EB Garamond",
+		category: "serif",
+		fallbackStack: [
+			"Book Antiqua",
+			"EB Garamond",
+			"Palatino",
+			"Georgia",
+			"serif"
+		],
+		singleLineRatio: 1.0259
+	},
+	garamond: {
+		googleFont: "EB Garamond",
+		category: "serif",
+		fallbackStack: [
+			"Garamond",
+			"EB Garamond",
+			"Georgia",
+			"serif"
+		],
+		singleLineRatio: 1.068
+	},
+	"century gothic": {
+		googleFont: "Questrial",
+		category: "sans-serif",
+		fallbackStack: [
+			"Century Gothic",
+			"Questrial",
+			"Arial",
+			"sans-serif"
+		],
+		singleLineRatio: 1.1611
+	},
+	"lucida sans": {
+		googleFont: "Open Sans",
+		category: "sans-serif",
+		fallbackStack: [
+			"Lucida Sans",
+			"Open Sans",
+			"Arial",
+			"sans-serif"
+		],
+		singleLineRatio: 1.1655
+	},
+	"lucida console": {
+		googleFont: "Cousine",
+		category: "monospace",
+		fallbackStack: [
+			"Lucida Console",
+			"Cousine",
+			"Courier New",
+			"monospace"
+		],
+		singleLineRatio: 1.1387
+	},
+	consolas: {
+		googleFont: "Inconsolata",
+		category: "monospace",
+		fallbackStack: [
+			"Consolas",
+			"Inconsolata",
+			"Cousine",
+			"Courier New",
+			"monospace"
+		],
+		singleLineRatio: 1.1626
+	},
+	"ms mincho": {
+		googleFont: "Noto Serif JP",
+		category: "serif",
+		fallbackStack: [
+			"MS Mincho",
+			"Noto Serif JP",
+			"serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	"ｍｓ 明朝": {
+		googleFont: "Noto Serif JP",
+		category: "serif",
+		fallbackStack: [
+			"MS Mincho",
+			"ＭＳ 明朝",
+			"Noto Serif JP",
+			"serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	"ｍｓ ｐ明朝": {
+		googleFont: "Noto Serif JP",
+		category: "serif",
+		fallbackStack: [
+			"MS PMincho",
+			"ＭＳ Ｐ明朝",
+			"Noto Serif JP",
+			"serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	"ms gothic": {
+		googleFont: "Noto Sans JP",
+		category: "sans-serif",
+		fallbackStack: [
+			"MS Gothic",
+			"Noto Sans JP",
+			"sans-serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	"ｍｓ ゴシック": {
+		googleFont: "Noto Sans JP",
+		category: "sans-serif",
+		fallbackStack: [
+			"MS Gothic",
+			"ＭＳ ゴシック",
+			"Noto Sans JP",
+			"sans-serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	"ｍｓ ｐゴシック": {
+		googleFont: "Noto Sans JP",
+		category: "sans-serif",
+		fallbackStack: [
+			"MS PGothic",
+			"ＭＳ Ｐゴシック",
+			"Noto Sans JP",
+			"sans-serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	simhei: {
+		googleFont: "Noto Sans SC",
+		category: "sans-serif",
+		fallbackStack: [
+			"SimHei",
+			"Noto Sans SC",
+			"sans-serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	simsun: {
+		googleFont: "Noto Serif SC",
+		category: "serif",
+		fallbackStack: [
+			"SimSun",
+			"Noto Serif SC",
+			"serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	"malgun gothic": {
+		googleFont: "Noto Sans KR",
+		category: "sans-serif",
+		fallbackStack: [
+			"Malgun Gothic",
+			"Noto Sans KR",
+			"sans-serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	宋体: {
+		googleFont: "Noto Serif SC",
+		category: "serif",
+		fallbackStack: [
+			"SimSun",
+			"宋体",
+			"Noto Serif SC",
+			"serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	黑体: {
+		googleFont: "Noto Sans SC",
+		category: "sans-serif",
+		fallbackStack: [
+			"SimHei",
+			"黑体",
+			"Noto Sans SC",
+			"sans-serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	微软雅黑: {
+		googleFont: "Noto Sans SC",
+		category: "sans-serif",
+		fallbackStack: [
+			"Microsoft YaHei",
+			"微软雅黑",
+			"Noto Sans SC",
+			"sans-serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	等线: {
+		googleFont: "Noto Sans SC",
+		category: "sans-serif",
+		fallbackStack: [
+			"DengXian",
+			"等线",
+			"Noto Sans SC",
+			"sans-serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	仿宋: {
+		googleFont: "Noto Serif SC",
+		category: "serif",
+		fallbackStack: [
+			"FangSong",
+			"仿宋",
+			"Noto Serif SC",
+			"serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	楷体: {
+		googleFont: "Noto Serif SC",
+		category: "serif",
+		fallbackStack: [
+			"KaiTi",
+			"楷体",
+			"Noto Serif SC",
+			"serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	新細明體: {
+		googleFont: "Noto Serif TC",
+		category: "serif",
+		fallbackStack: [
+			"PMingLiU",
+			"新細明體",
+			"Noto Serif TC",
+			"serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	細明體: {
+		googleFont: "Noto Serif TC",
+		category: "serif",
+		fallbackStack: [
+			"MingLiU",
+			"細明體",
+			"Noto Serif TC",
+			"serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	微軟正黑體: {
+		googleFont: "Noto Sans TC",
+		category: "sans-serif",
+		fallbackStack: [
+			"Microsoft JhengHei",
+			"微軟正黑體",
+			"Noto Sans TC",
+			"sans-serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	標楷體: {
+		googleFont: "Noto Serif TC",
+		category: "serif",
+		fallbackStack: [
+			"DFKai-SB",
+			"標楷體",
+			"Noto Serif TC",
+			"serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	"맑은 고딕": {
+		googleFont: "Noto Sans KR",
+		category: "sans-serif",
+		fallbackStack: [
+			"Malgun Gothic",
+			"맑은 고딕",
+			"Noto Sans KR",
+			"sans-serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	굴림: {
+		googleFont: "Noto Sans KR",
+		category: "sans-serif",
+		fallbackStack: [
+			"Gulim",
+			"굴림",
+			"Noto Sans KR",
+			"sans-serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	돋움: {
+		googleFont: "Noto Sans KR",
+		category: "sans-serif",
+		fallbackStack: [
+			"Dotum",
+			"돋움",
+			"Noto Sans KR",
+			"sans-serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	바탕: {
+		googleFont: "Noto Serif KR",
+		category: "serif",
+		fallbackStack: [
+			"Batang",
+			"바탕",
+			"Noto Serif KR",
+			"serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	},
+	궁서: {
+		googleFont: "Noto Serif KR",
+		category: "serif",
+		fallbackStack: [
+			"Gungsuh",
+			"궁서",
+			"Noto Serif KR",
+			"serif"
+		],
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	}
+};
+/**
+* Default fallback stacks by category
+*/
+const DEFAULT_FALLBACKS = {
+	"sans-serif": "Arial, Helvetica, sans-serif",
+	serif: "Times New Roman, Times, serif",
+	monospace: "Courier New, Courier, monospace",
+	cursive: "cursive",
+	fantasy: "fantasy",
+	"system-ui": "system-ui, sans-serif"
+};
+/**
+* Detect font category from font name
+*/
+function detectFontCategory(fontName) {
+	const lower = fontName.toLowerCase();
+	if (lower.includes("mono") || lower.includes("courier") || lower.includes("consolas") || lower.includes("console") || lower.includes("code") || lower.includes("terminal")) return "monospace";
+	if (lower.includes("times") || lower.includes("georgia") || lower.includes("garamond") || lower.includes("palatino") || lower.includes("baskerville") || lower.includes("bodoni") || lower.includes("cambria") || lower.includes("mincho") || lower.includes("明朝") || lower.includes("明體") || lower.includes("宋") || lower.includes("ming") || lower.includes("song") || lower.includes("serif")) return "serif";
+	if (lower.includes("script") || lower.includes("cursive") || lower.includes("comic") || lower.includes("brush") || lower.includes("hand")) return "cursive";
+	return "sans-serif";
+}
+/**
+* Romanized CJK font spellings → the native key already present in
+* FONT_MAPPINGS (port of eigenpal/docx-editor#957). Word writes either the
+* native typeface name (the theme path, e.g. `新細明體`) or the romanized name
+* (run `rFonts`, e.g. `PMingLiU`); both must resolve to the same Noto family +
+* CSS stack + category. Aliasing keeps a single set of CJK entries instead of
+* duplicating each under both spellings. (Keys already present directly in
+* FONT_MAPPINGS — `simsun`, `simhei`, `malgun gothic`, `ms mincho`,
+* `ms gothic` — are intentionally omitted.)
+*/
+const CJK_FONT_ALIASES = {
+	"microsoft yahei": "微软雅黑",
+	dengxian: "等线",
+	fangsong: "仿宋",
+	kaiti: "楷体",
+	pmingliu: "新細明體",
+	mingliu: "細明體",
+	"microsoft jhenghei": "微軟正黑體",
+	"dfkai-sb": "標楷體",
+	gulim: "굴림",
+	dotum: "돋움",
+	batang: "바탕",
+	gungsuh: "궁서",
+	meiryo: "ms gothic",
+	メイリオ: "ms gothic",
+	"yu gothic": "ms gothic",
+	游ゴシック: "ms gothic",
+	"yu mincho": "ms mincho",
+	游明朝: "ms mincho"
+};
+/**
+* Resolve a DOCX font name to a Google Font and CSS fallback stack
+*
+* @param docxFontName - The font name from the DOCX file
+* @returns Resolved font information
+*/
+const ARABIC_FALLBACK = "\"Noto Sans Arabic\"";
+const TRAILING_GENERIC = /,\s*(?<generic>sans-serif|serif|monospace|cursive)\s*$/u;
+const withArabicFallback = (stack) => TRAILING_GENERIC.test(stack) ? stack.replace(TRAILING_GENERIC, `, ${ARABIC_FALLBACK}, $<generic>`) : `${stack}, ${ARABIC_FALLBACK}`;
+function resolveFontFamily(docxFontName) {
+	const normalizedName = docxFontName.trim().toLowerCase();
+	const aliasTarget = CJK_FONT_ALIASES[normalizedName];
+	const mapping = FONT_MAPPINGS[aliasTarget ?? normalizedName];
+	if (mapping) {
+		const fallbackStack = aliasTarget && !mapping.fallbackStack.some((f) => f.toLowerCase() === normalizedName) ? [docxFontName, ...mapping.fallbackStack] : mapping.fallbackStack;
+		return {
+			googleFont: mapping.googleFont,
+			cssFallback: withArabicFallback(fallbackStack.map(quoteFontName).join(", ")),
+			originalFont: docxFontName,
+			hasGoogleEquivalent: true,
+			singleLineRatio: mapping.singleLineRatio
+		};
+	}
+	const defaultFallback = DEFAULT_FALLBACKS[detectFontCategory(docxFontName)];
+	return {
+		googleFont: null,
+		cssFallback: withArabicFallback(`${quoteFontName(docxFontName)}, ${defaultFallback}`),
+		originalFont: docxFontName,
+		hasGoogleEquivalent: false,
+		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+	};
+}
+const CSS_NEWLINE_ESCAPES = {
+	"\n": "\\a ",
+	"\r": "\\d ",
+	"\f": "\\c "
+};
+/**
+* Escape a DOCX-supplied font name for a double-quoted CSS string.
+*/
+function escapeQuotedFontName(fontName) {
+	return fontName.replace(/["\\]/g, "\\$&").replace(/[\n\r\f]/g, (char) => CSS_NEWLINE_ESCAPES[char] ?? char);
+}
+/**
+* Quote a font name if it contains spaces or special characters
+*/
+function quoteFontName(fontName) {
+	if ([
+		"serif",
+		"sans-serif",
+		"monospace",
+		"cursive",
+		"fantasy",
+		"system-ui"
+	].includes(fontName.toLowerCase())) return fontName;
+	if (/[\s,'"()]/.test(fontName)) return `"${escapeQuotedFontName(fontName)}"`;
+	return fontName;
+}
+/**
+* Resolve a theme font reference to actual font names
+*
+* @param themeRef - Theme font reference (e.g., 'majorAscii', 'minorHAnsi')
+* @param fontScheme - Theme font scheme from the DOCX
+* @returns Resolved font name or null if not found
+*/
+function resolveThemeFont(themeRef, fontScheme) {
+	if (!fontScheme) return null;
+	const themeFont = themeRef.toLowerCase().startsWith("major") ? fontScheme.majorFont : fontScheme.minorFont;
+	if (!themeFont) return null;
+	const ref = themeRef.toLowerCase();
+	if (ref.includes("eastasia") || ref.includes("ea")) return themeFont.ea ?? themeFont.latin ?? null;
+	if (ref.includes("cs") || ref.includes("bidi")) return themeFont.cs ?? themeFont.latin ?? null;
+	return themeFont.latin ?? null;
+}
+/**
+* Get all Google Font names needed for a list of DOCX fonts
+*
+* @param docxFonts - Array of font names from the DOCX
+* @returns Array of Google Font names to load
+*/
+function getGoogleFontsToLoad(docxFonts) {
+	const googleFonts = /* @__PURE__ */ new Set();
+	for (const font of docxFonts) {
+		const resolved = resolveFontFamily(font);
+		if (resolved.googleFont) googleFonts.add(resolved.googleFont);
+	}
+	return Array.from(googleFonts);
+}
+/**
+* Build a CSS font-family string from an array of font names
+*
+* @param fonts - Array of font names
+* @param category - Fallback category
+* @returns CSS font-family value
+*/
+function buildFontFamilyString(fonts, category = "sans-serif") {
+	const parts = [...fonts.map(quoteFontName)];
+	if (!parts.some((p) => p.toLowerCase() === category)) parts.push(category);
+	return parts.join(", ");
+}
+/**
+* Get the Google Font equivalent for a DOCX font (if any)
+*
+* @param docxFontName - The font name from the DOCX file
+* @returns Google Font name or null
+*/
+function getGoogleFontEquivalent(docxFontName) {
+	return resolveFontFamily(docxFontName).googleFont;
+}
+/**
+* Check if a font has a known Google Fonts equivalent
+*
+* @param docxFontName - The font name from the DOCX file
+* @returns true if there's a Google Fonts equivalent
+*/
+function hasGoogleFontEquivalent(docxFontName) {
+	return docxFontName.trim().toLowerCase() in FONT_MAPPINGS;
+}
+//#endregion
+export { DEFAULT_SINGLE_LINE_RATIO, buildFontFamilyString, getGoogleFontEquivalent, getGoogleFontsToLoad, hasGoogleFontEquivalent, resolveFontFamily, resolveThemeFont };

package/dist/utils/fontWeights.d.ts

@@ -0,0 +1,4 @@
+//#region src/utils/fontWeights.d.ts
+declare const DOCX_BOLD_FONT_WEIGHT = "800";
+//#endregion
+export { DOCX_BOLD_FONT_WEIGHT };

package/dist/utils/fontWeights.js

@@ -0,0 +1,4 @@
+//#region src/utils/fontWeights.ts
+const DOCX_BOLD_FONT_WEIGHT = "800";
+//#endregion
+export { DOCX_BOLD_FONT_WEIGHT };