@stll/folio-core 0.1.3 → 0.3.0

package/dist/style-engine/styleEngine.js

@@ -23,6 +23,7 @@ function createStyleEngine(styleDefinitions, options) {
 	const paragraphCache = /* @__PURE__ */ new Map();
 	const runCache = /* @__PURE__ */ new Map();
 	const ownPropsCache = /* @__PURE__ */ new Map();
+	let tableOverlayCache = /* @__PURE__ */ new WeakMap();
 	let hits = 0;
 	let misses = 0;
 	const memoize = (cache, key, compute) => {
@@ -40,6 +41,18 @@ function createStyleEngine(styleDefinitions, options) {
 		cache.set(key, { value });
 		return value;
 	};
+	const memoizeInTable = (styleId, tableParagraphOverlay) => {
+		if (!cacheEnabled) {
+			misses += 1;
+			return resolver.resolveParagraphStyleInTable(styleId, tableParagraphOverlay);
+		}
+		let overlayCache = tableOverlayCache.get(tableParagraphOverlay);
+		if (!overlayCache) {
+			overlayCache = /* @__PURE__ */ new Map();
+			tableOverlayCache.set(tableParagraphOverlay, overlayCache);
+		}
+		return memoize(overlayCache, cacheKey(styleId), () => resolver.resolveParagraphStyleInTable(styleId, tableParagraphOverlay));
+	};
 	return {
 		getStyle: (styleId) => resolver.getStyle(styleId),
 		hasStyle: (styleId) => resolver.hasStyle(styleId),
@@ -50,12 +63,14 @@ function createStyleEngine(styleDefinitions, options) {
 		getParagraphStyles: () => resolver.getParagraphStyles(),
 		getTableStyles: () => resolver.getTableStyles(),
 		resolveParagraphStyle: (styleId) => memoize(paragraphCache, cacheKey(styleId), () => resolver.resolveParagraphStyle(styleId)),
+		resolveParagraphStyleInTable: (styleId, tableParagraphOverlay) => tableParagraphOverlay === void 0 ? memoize(paragraphCache, cacheKey(styleId), () => resolver.resolveParagraphStyleInTable(styleId, void 0)) : memoizeInTable(styleId, tableParagraphOverlay),
 		resolveRunStyle: (styleId) => memoize(runCache, cacheKey(styleId), () => resolver.resolveRunStyle(styleId)),
 		getRunStyleOwnProperties: (styleId) => memoize(ownPropsCache, cacheKey(styleId), () => resolver.getRunStyleOwnProperties(styleId)),
 		invalidate: () => {
 			paragraphCache.clear();
 			runCache.clear();
 			ownPropsCache.clear();
+			tableOverlayCache = /* @__PURE__ */ new WeakMap();
 			hits = 0;
 			misses = 0;
 		},

package/dist/utils/colorResolver.d.ts

@@ -16,6 +16,13 @@ declare function resolveColor(color: document_d_exports.ColorValue | undefined |
  * @param highlight - Highlight color name (e.g., "yellow", "cyan")
  * @returns CSS color string or empty string for "none"
  */
+/**
+ * Resolve a `ColorValue` to a bare 6-digit hex string (no leading `#`), or
+ * `undefined` for an `auto`/absent color. Theme colors resolve through the
+ * document theme; explicit `rgb` values are upper-cased. Used by adapters that
+ * need a normalized hex (e.g. comparing a cell fill against a swatch).
+ */
+declare function resolveColorToHex(color: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): string | undefined;
 declare function resolveHighlightColor(highlight: string | undefined): string;
 /**
  * Resolve a shading fill or pattern color to CSS
@@ -155,4 +162,4 @@ declare function generateThemeTintShadeMatrix(colorScheme?: document_d_exports.T
  */
 declare function colorsEqual(color1: document_d_exports.ColorValue | undefined | null, color2: document_d_exports.ColorValue | undefined | null, theme: document_d_exports.Theme | null | undefined): boolean;
 //#endregion
-export { STANDARD_TEXT_COLORS, ThemeMatrixCell, blendColors, colorsEqual, createRgbColor, createThemeColor, darkenColor, ensureHexPrefix, generateThemeTintShadeMatrix, getContrastingColor, getThemeTintShadeHex, isBlack, isWhite, lightenColor, parseColorString, resolveColor, resolveHighlightColor, resolveHighlightToCss, resolveShadingColor };
+export { STANDARD_TEXT_COLORS, ThemeMatrixCell, blendColors, colorsEqual, createRgbColor, createThemeColor, darkenColor, ensureHexPrefix, generateThemeTintShadeMatrix, getContrastingColor, getThemeTintShadeHex, isBlack, isWhite, lightenColor, parseColorString, resolveColor, resolveColorToHex, resolveHighlightColor, resolveHighlightToCss, resolveShadingColor };

package/dist/utils/colorResolver.js

@@ -218,6 +218,17 @@ function resolveColor(color, theme, defaultColor = "000000") {
 * @param highlight - Highlight color name (e.g., "yellow", "cyan")
 * @returns CSS color string or empty string for "none"
 */
+/**
+* Resolve a `ColorValue` to a bare 6-digit hex string (no leading `#`), or
+* `undefined` for an `auto`/absent color. Theme colors resolve through the
+* document theme; explicit `rgb` values are upper-cased. Used by adapters that
+* need a normalized hex (e.g. comparing a cell fill against a swatch).
+*/
+function resolveColorToHex(color, theme) {
+	if (!color || color.auto) return void 0;
+	if (color.themeColor && theme) return resolveColor(color, theme).slice(1);
+	if (color.rgb && color.rgb !== "auto") return color.rgb.toUpperCase().replace(/^#/, "");
+}
 function resolveHighlightColor(highlight) {
 	if (!highlight || highlight === "none") return "";
 	const hex = HIGHLIGHT_COLORS[highlight];
@@ -554,4 +565,4 @@ function colorsEqual(color1, color2, theme) {
 	return resolveColor(color1, theme).toUpperCase() === resolveColor(color2, theme).toUpperCase();
 }
 //#endregion
-export { STANDARD_TEXT_COLORS, blendColors, colorsEqual, createRgbColor, createThemeColor, darkenColor, ensureHexPrefix, generateThemeTintShadeMatrix, getContrastingColor, getThemeTintShadeHex, isBlack, isWhite, lightenColor, parseColorString, resolveColor, resolveHighlightColor, resolveHighlightToCss, resolveShadingColor };
+export { STANDARD_TEXT_COLORS, blendColors, colorsEqual, createRgbColor, createThemeColor, darkenColor, ensureHexPrefix, generateThemeTintShadeMatrix, getContrastingColor, getThemeTintShadeHex, isBlack, isWhite, lightenColor, parseColorString, resolveColor, resolveColorToHex, resolveHighlightColor, resolveHighlightToCss, resolveShadingColor };

package/dist/utils/findVerticalScrollParent.d.ts

@@ -0,0 +1,20 @@
+//#region src/utils/findVerticalScrollParent.d.ts
+/**
+ * Pure DOM helpers — locate the element that vertically scrolls the paginated
+ * editor. Shared by scroll-to-position, arrow-key line navigation, and drag
+ * auto-scroll so every framework adapter uses the same logic.
+ */
+/**
+ * First ancestor of `el` with `overflow-y: auto|scroll` and a scrollable
+ * overflow height. The walk starts at `el.parentElement` (it does not treat
+ * `el` itself as the scroller). Returns `null` when no such ancestor exists
+ * before `document.documentElement`.
+ */
+declare function findVerticalScrollParent(el: HTMLElement): HTMLElement | null;
+/**
+ * Same as {@link findVerticalScrollParent} but falls back to
+ * `document.documentElement` so callers always get a valid scroll target.
+ */
+declare function findVerticalScrollParentOrRoot(el: HTMLElement): HTMLElement;
+//#endregion
+export { findVerticalScrollParent, findVerticalScrollParentOrRoot };

package/dist/utils/findVerticalScrollParent.js

@@ -0,0 +1,30 @@
+//#region src/utils/findVerticalScrollParent.ts
+/**
+* Pure DOM helpers — locate the element that vertically scrolls the paginated
+* editor. Shared by scroll-to-position, arrow-key line navigation, and drag
+* auto-scroll so every framework adapter uses the same logic.
+*/
+/**
+* First ancestor of `el` with `overflow-y: auto|scroll` and a scrollable
+* overflow height. The walk starts at `el.parentElement` (it does not treat
+* `el` itself as the scroller). Returns `null` when no such ancestor exists
+* before `document.documentElement`.
+*/
+function findVerticalScrollParent(el) {
+	let parent = el.parentElement;
+	while (parent && parent !== document.documentElement) {
+		const { overflowY } = getComputedStyle(parent);
+		if ((overflowY === "auto" || overflowY === "scroll") && parent.scrollHeight > parent.clientHeight + 1) return parent;
+		parent = parent.parentElement;
+	}
+	return null;
+}
+/**
+* Same as {@link findVerticalScrollParent} but falls back to
+* `document.documentElement` so callers always get a valid scroll target.
+*/
+function findVerticalScrollParentOrRoot(el) {
+	return findVerticalScrollParent(el) ?? document.documentElement;
+}
+//#endregion
+export { findVerticalScrollParent, findVerticalScrollParentOrRoot };

package/dist/utils/fontResolver.d.ts

@@ -7,7 +7,7 @@ type ResolvedFont = {
   /** Google Font name to load (null if no mapping available) */googleFont: string | null; /** CSS font-family value with proper fallback stack */
   cssFallback: string; /** Original font name from the DOCX */
   originalFont: string; /** Whether this font has a Google Fonts equivalent */
-  hasGoogleEquivalent: boolean; /** OS/2 single-line ratio: (usWinAscent + usWinDescent) / unitsPerEm (no external leading) */
+  hasGoogleEquivalent: boolean; /** Single-line height ratio (single-line height ÷ font size). See `FontLineHeight`. */
   singleLineRatio: number;
 };
 /**
@@ -15,10 +15,29 @@ type ResolvedFont = {
  */
 type FontCategory = "sans-serif" | "serif" | "monospace" | "cursive" | "fantasy" | "system-ui";
 /**
- * Default OS/2 single-line ratio for unmapped fonts.
+ * Default single-line ratio for unmapped fonts.
  * Middle of the common range (1.07–1.27) for standard DOCX fonts.
  */
 declare const DEFAULT_SINGLE_LINE_RATIO = 1.15;
+/**
+ * True when `family` is a known East-Asian (CJK) typeface — a direct
+ * `FONT_MAPPINGS` CJK entry or a romanized alias of one. Used by the measurer
+ * to decide whether a run's `w:eastAsia` font can supply the line height for
+ * CJK text, or whether Word would font-link to a default East-Asian face
+ * instead (see `CJK_FALLBACK_FONT_FAMILY`). Unmapped families return false:
+ * we cannot know their metrics, so the caller falls back.
+ */
+declare function isCjkFont(family: string): boolean;
+/**
+ * Font family whose `singleLineRatio` stands in for Word's default East-Asian
+ * face when a CJK-text run declares no usable CJK font (its `w:eastAsia` slot
+ * is absent or names a Latin face like "Century"). Word font-links those
+ * glyphs to the OS default East-Asian font and takes THAT face's taller line
+ * height; MS Mincho carries the measured ratio for it
+ * (`JP_MEASURED_LINE_HEIGHT`, ≈1.303). Line-height resolution only — never
+ * used for width measurement or painting.
+ */
+declare const CJK_FALLBACK_FONT_FAMILY = "MS Mincho";
 declare function resolveFontFamily(docxFontName: string): ResolvedFont;
 /**
  * Resolve a theme font reference to actual font names
@@ -58,4 +77,4 @@ declare function getGoogleFontEquivalent(docxFontName: string): string | null;
  */
 declare function hasGoogleFontEquivalent(docxFontName: string): boolean;
 //#endregion
-export { DEFAULT_SINGLE_LINE_RATIO, ResolvedFont, buildFontFamilyString, getGoogleFontEquivalent, getGoogleFontsToLoad, hasGoogleFontEquivalent, resolveFontFamily, resolveThemeFont };
+export { CJK_FALLBACK_FONT_FAMILY, DEFAULT_SINGLE_LINE_RATIO, ResolvedFont, buildFontFamilyString, getGoogleFontEquivalent, getGoogleFontsToLoad, hasGoogleFontEquivalent, isCjkFont, resolveFontFamily, resolveThemeFont };

package/dist/utils/fontResolver.js

@@ -1,20 +1,62 @@
 //#region src/utils/fontResolver.ts
 /**
-* Default OS/2 single-line ratio for unmapped fonts.
+* Default 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;
 /**
+* Single-line height ratio (single-line height ÷ font size) for a
+* `FontLineHeight`. This is the ONLY place the derivation formula lives.
+*
+* For `"hhea"` sources: `(hheaAscent + |hheaDescent| + hheaLineGap) / unitsPerEm`.
+* This matches Word's rendered single-line pitch (11pt, single spacing) for
+* every font measured against real Word output so far (16 fonts, no
+* exceptions) — Word does NOT drop the font's line gap. Earlier revisions of
+* this table hand-transcribed ratios from the OS/2 table and omitted the line
+* gap for most fonts, which undershot Word's rendered line height for several
+* of them (confirmed against real Word for cambria, trebuchet ms, palatino
+* linotype, book antiqua, century gothic, consolas, and lucida console; arial
+* and times new roman were fixed in a prior revision). Future readers: to
+* correct or add a font, edit its `hhea*`/`unitsPerEm` metric fields, never the
+* resulting ratio.
+*
+* Most CJK fonts are intentionally left on `DEFAULT_SINGLE_LINE_RATIO`: Word's
+* East-Asian line height is not the run font's hhea ratio (it derives from the
+* paragraph's `w:eastAsia` slot and East-Asian grid layout, not the ascii
+* font), so a single per-font constant cannot capture it correctly. The
+* Japanese Mincho/Gothic entries carry a `"measured"` ratio instead — see
+* `JP_MEASURED_LINE_HEIGHT`.
+*/
+const singleLineRatioOf = (lineHeight) => lineHeight.source === "hhea" ? (lineHeight.hheaAscent - lineHeight.hheaDescent + lineHeight.hheaLineGap) / lineHeight.unitsPerEm : lineHeight.ratio;
+/**
+* Word's East-Asian single-line height for the Japanese Mincho/Gothic faces,
+* measured against real Word output on a NON-grid Japanese document
+* (10.5pt body renders at 13.68pt line pitch → 13.68 / 10.5 ≈ 1.303). Word
+* font-links CJK glyphs to the OS default East-Asian face and takes THAT
+* face's height, so the declared font's own `hhea` table is not the source of
+* truth here; a section with a `w:docGrid` line grid would override this value
+* entirely (out of scope). The ratio is approximate for the CJK long tail
+* (e.g. Yu Mincho renders taller, ≈1.60, when actually installed); it matches
+* the common MS Mincho/Gothic default.
+*/
+const JP_MEASURED_LINE_HEIGHT = {
+	source: "measured",
+	ratio: 1.303,
+	note: "Measured against real Word: 10.5pt Japanese body, non-grid section, renders at 13.68pt line pitch."
+};
+/**
 * 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).
+* `singleLineRatio` values are computed by `singleLineRatioOf` from each
+* font's `FontLineHeight`, never hand-written. For "hhea" entries the raw
+* `hheaAscent`/`hheaDescent`/`hheaLineGap`/`unitsPerEm` fields below are read
+* directly from the real font files' `hhea` table; the ratio is whatever
+* falls out of the formula in `singleLineRatioOf`. "legacy" entries (e.g.
+* garamond, lucida sans, lucida console) are unverified hand-transcribed
+* ratios carried over unchanged, pending measurement.
 */
 const FONT_MAPPINGS = {
 	calibri: {
@@ -27,7 +69,13 @@ const FONT_MAPPINGS = {
 			"Helvetica",
 			"sans-serif"
 		],
-		singleLineRatio: 1.2207
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 1950,
+			hheaDescent: -550,
+			hheaLineGap: 0,
+			unitsPerEm: 2048
+		})
 	},
 	cambria: {
 		googleFont: "Caladea",
@@ -38,7 +86,13 @@ const FONT_MAPPINGS = {
 			"Georgia",
 			"serif"
 		],
-		singleLineRatio: 1.2676
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 1946,
+			hheaDescent: -455,
+			hheaLineGap: 0,
+			unitsPerEm: 2048
+		})
 	},
 	arial: {
 		googleFont: "Arimo",
@@ -49,7 +103,13 @@ const FONT_MAPPINGS = {
 			"Helvetica",
 			"sans-serif"
 		],
-		singleLineRatio: 1.1172
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 1854,
+			hheaDescent: -434,
+			hheaLineGap: 67,
+			unitsPerEm: 2048
+		})
 	},
 	"times new roman": {
 		googleFont: "Tinos",
@@ -60,7 +120,13 @@ const FONT_MAPPINGS = {
 			"Times",
 			"serif"
 		],
-		singleLineRatio: 1.1074
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 1825,
+			hheaDescent: -443,
+			hheaLineGap: 87,
+			unitsPerEm: 2048
+		})
 	},
 	"courier new": {
 		googleFont: "Cousine",
@@ -71,7 +137,13 @@ const FONT_MAPPINGS = {
 			"Courier",
 			"monospace"
 		],
-		singleLineRatio: 1.1328
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 1705,
+			hheaDescent: -615,
+			hheaLineGap: 0,
+			unitsPerEm: 2048
+		})
 	},
 	georgia: {
 		googleFont: "Tinos",
@@ -82,7 +154,13 @@ const FONT_MAPPINGS = {
 			"Times New Roman",
 			"serif"
 		],
-		singleLineRatio: 1.1362
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 1878,
+			hheaDescent: -449,
+			hheaLineGap: 0,
+			unitsPerEm: 2048
+		})
 	},
 	verdana: {
 		googleFont: "Open Sans",
@@ -93,7 +171,13 @@ const FONT_MAPPINGS = {
 			"Arial",
 			"sans-serif"
 		],
-		singleLineRatio: 1.2153
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 2059,
+			hheaDescent: -430,
+			hheaLineGap: 0,
+			unitsPerEm: 2048
+		})
 	},
 	tahoma: {
 		googleFont: "Open Sans",
@@ -104,7 +188,13 @@ const FONT_MAPPINGS = {
 			"Arial",
 			"sans-serif"
 		],
-		singleLineRatio: 1.2075
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 2049,
+			hheaDescent: -423,
+			hheaLineGap: 0,
+			unitsPerEm: 2048
+		})
 	},
 	"trebuchet ms": {
 		googleFont: "Fira Sans",
@@ -115,7 +205,13 @@ const FONT_MAPPINGS = {
 			"Arial",
 			"sans-serif"
 		],
-		singleLineRatio: 1.1431
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 1923,
+			hheaDescent: -455,
+			hheaLineGap: 0,
+			unitsPerEm: 2048
+		})
 	},
 	"comic sans ms": {
 		googleFont: "Comic Neue",
@@ -125,7 +221,13 @@ const FONT_MAPPINGS = {
 			"Comic Neue",
 			"cursive"
 		],
-		singleLineRatio: 1.3936
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 2257,
+			hheaDescent: -597,
+			hheaLineGap: 0,
+			unitsPerEm: 2048
+		})
 	},
 	impact: {
 		googleFont: "Anton",
@@ -136,7 +238,13 @@ const FONT_MAPPINGS = {
 			"Arial Black",
 			"sans-serif"
 		],
-		singleLineRatio: 1.2197
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 2066,
+			hheaDescent: -432,
+			hheaLineGap: 0,
+			unitsPerEm: 2048
+		})
 	},
 	"palatino linotype": {
 		googleFont: "EB Garamond",
@@ -148,7 +256,13 @@ const FONT_MAPPINGS = {
 			"Georgia",
 			"serif"
 		],
-		singleLineRatio: 1.0259
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 2150,
+			hheaDescent: -613,
+			hheaLineGap: 0,
+			unitsPerEm: 2048
+		})
 	},
 	"book antiqua": {
 		googleFont: "EB Garamond",
@@ -160,7 +274,13 @@ const FONT_MAPPINGS = {
 			"Georgia",
 			"serif"
 		],
-		singleLineRatio: 1.0259
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 1891,
+			hheaDescent: -578,
+			hheaLineGap: 0,
+			unitsPerEm: 2048
+		})
 	},
 	garamond: {
 		googleFont: "EB Garamond",
@@ -171,7 +291,11 @@ const FONT_MAPPINGS = {
 			"Georgia",
 			"serif"
 		],
-		singleLineRatio: 1.068
+		singleLineRatio: singleLineRatioOf({
+			source: "legacy",
+			ratio: 1.068,
+			note: "Unverified hand-transcribed ratio; not yet measured against real Word output."
+		})
 	},
 	"century gothic": {
 		googleFont: "Questrial",
@@ -182,7 +306,13 @@ const FONT_MAPPINGS = {
 			"Arial",
 			"sans-serif"
 		],
-		singleLineRatio: 1.1611
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 2060,
+			hheaDescent: -451,
+			hheaLineGap: 0,
+			unitsPerEm: 2048
+		})
 	},
 	"lucida sans": {
 		googleFont: "Open Sans",
@@ -193,7 +323,11 @@ const FONT_MAPPINGS = {
 			"Arial",
 			"sans-serif"
 		],
-		singleLineRatio: 1.1655
+		singleLineRatio: singleLineRatioOf({
+			source: "legacy",
+			ratio: 1.1655,
+			note: "Unverified hand-transcribed ratio; not yet measured against real Word output."
+		})
 	},
 	"lucida console": {
 		googleFont: "Cousine",
@@ -204,7 +338,13 @@ const FONT_MAPPINGS = {
 			"Courier New",
 			"monospace"
 		],
-		singleLineRatio: 1.1387
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 1616,
+			hheaDescent: -432,
+			hheaLineGap: 0,
+			unitsPerEm: 2048
+		})
 	},
 	consolas: {
 		googleFont: "Inconsolata",
@@ -216,7 +356,13 @@ const FONT_MAPPINGS = {
 			"Courier New",
 			"monospace"
 		],
-		singleLineRatio: 1.1626
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 1521,
+			hheaDescent: -527,
+			hheaLineGap: 350,
+			unitsPerEm: 2048
+		})
 	},
 	"ms mincho": {
 		googleFont: "Noto Serif JP",
@@ -226,7 +372,7 @@ const FONT_MAPPINGS = {
 			"Noto Serif JP",
 			"serif"
 		],
-		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+		singleLineRatio: singleLineRatioOf(JP_MEASURED_LINE_HEIGHT)
 	},
 	"ｍｓ 明朝": {
 		googleFont: "Noto Serif JP",
@@ -237,7 +383,7 @@ const FONT_MAPPINGS = {
 			"Noto Serif JP",
 			"serif"
 		],
-		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+		singleLineRatio: singleLineRatioOf(JP_MEASURED_LINE_HEIGHT)
 	},
 	"ｍｓ ｐ明朝": {
 		googleFont: "Noto Serif JP",
@@ -248,7 +394,7 @@ const FONT_MAPPINGS = {
 			"Noto Serif JP",
 			"serif"
 		],
-		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+		singleLineRatio: singleLineRatioOf(JP_MEASURED_LINE_HEIGHT)
 	},
 	"ms gothic": {
 		googleFont: "Noto Sans JP",
@@ -258,7 +404,7 @@ const FONT_MAPPINGS = {
 			"Noto Sans JP",
 			"sans-serif"
 		],
-		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+		singleLineRatio: singleLineRatioOf(JP_MEASURED_LINE_HEIGHT)
 	},
 	"ｍｓ ゴシック": {
 		googleFont: "Noto Sans JP",
@@ -269,7 +415,7 @@ const FONT_MAPPINGS = {
 			"Noto Sans JP",
 			"sans-serif"
 		],
-		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+		singleLineRatio: singleLineRatioOf(JP_MEASURED_LINE_HEIGHT)
 	},
 	"ｍｓ ｐゴシック": {
 		googleFont: "Noto Sans JP",
@@ -280,7 +426,7 @@ const FONT_MAPPINGS = {
 			"Noto Sans JP",
 			"sans-serif"
 		],
-		singleLineRatio: DEFAULT_SINGLE_LINE_RATIO
+		singleLineRatio: singleLineRatioOf(JP_MEASURED_LINE_HEIGHT)
 	},
 	simhei: {
 		googleFont: "Noto Sans SC",
@@ -530,6 +676,45 @@ const CJK_FONT_ALIASES = {
 	游明朝: "ms mincho"
 };
 /**
+* The Noto families every CJK entry in `FONT_MAPPINGS` maps to. A mapping
+* whose `googleFont` is one of these is an East-Asian face; this is the single
+* classification source for `isCjkFont`, kept as an explicit set (not a name
+* heuristic) so a future non-Noto CJK mapping must extend it deliberately.
+*/
+const CJK_NOTO_FAMILIES = /* @__PURE__ */ new Set([
+	"Noto Serif JP",
+	"Noto Sans JP",
+	"Noto Serif SC",
+	"Noto Sans SC",
+	"Noto Serif TC",
+	"Noto Sans TC",
+	"Noto Serif KR",
+	"Noto Sans KR"
+]);
+/**
+* True when `family` is a known East-Asian (CJK) typeface — a direct
+* `FONT_MAPPINGS` CJK entry or a romanized alias of one. Used by the measurer
+* to decide whether a run's `w:eastAsia` font can supply the line height for
+* CJK text, or whether Word would font-link to a default East-Asian face
+* instead (see `CJK_FALLBACK_FONT_FAMILY`). Unmapped families return false:
+* we cannot know their metrics, so the caller falls back.
+*/
+function isCjkFont(family) {
+	const normalizedName = family.trim().toLowerCase();
+	const mapping = FONT_MAPPINGS[CJK_FONT_ALIASES[normalizedName] ?? normalizedName];
+	return mapping !== void 0 && CJK_NOTO_FAMILIES.has(mapping.googleFont);
+}
+/**
+* Font family whose `singleLineRatio` stands in for Word's default East-Asian
+* face when a CJK-text run declares no usable CJK font (its `w:eastAsia` slot
+* is absent or names a Latin face like "Century"). Word font-links those
+* glyphs to the OS default East-Asian font and takes THAT face's taller line
+* height; MS Mincho carries the measured ratio for it
+* (`JP_MEASURED_LINE_HEIGHT`, ≈1.303). Line-height resolution only — never
+* used for width measurement or painting.
+*/
+const CJK_FALLBACK_FONT_FAMILY = "MS Mincho";
+/**
 * Resolve a DOCX font name to a Google Font and CSS fallback stack
 *
 * @param docxFontName - The font name from the DOCX file
@@ -648,4 +833,4 @@ function hasGoogleFontEquivalent(docxFontName) {
 	return docxFontName.trim().toLowerCase() in FONT_MAPPINGS;
 }
 //#endregion
-export { DEFAULT_SINGLE_LINE_RATIO, buildFontFamilyString, getGoogleFontEquivalent, getGoogleFontsToLoad, hasGoogleFontEquivalent, resolveFontFamily, resolveThemeFont };
+export { CJK_FALLBACK_FONT_FAMILY, DEFAULT_SINGLE_LINE_RATIO, buildFontFamilyString, getGoogleFontEquivalent, getGoogleFontsToLoad, hasGoogleFontEquivalent, isCjkFont, resolveFontFamily, resolveThemeFont };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",
@@ -69,10 +69,18 @@
       "types": "./dist/prosemirror/conversion/index.d.ts",
       "import": "./dist/prosemirror/conversion/index.js"
     },
+    "./prosemirror/extensions": {
+      "types": "./dist/prosemirror/extensions/index.d.ts",
+      "import": "./dist/prosemirror/extensions/index.js"
+    },
     "./prosemirror/schema": {
       "types": "./dist/prosemirror/schema/index.d.ts",
       "import": "./dist/prosemirror/schema/index.js"
     },
+    "./docx": {
+      "types": "./dist/docx/index.d.ts",
+      "import": "./dist/docx/index.js"
+    },
     "./*": {
       "types": "./dist/*.d.ts",
       "import": "./dist/*.js"
@@ -118,6 +126,7 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
+    "skills",
     "README.md",
     "LICENSE",
     "NOTICE.md"