@stll/folio-core 0.61.0 → 0.63.0

package/dist/utils/fontResolver.d.ts

@@ -1,10 +1,11 @@
 import { document_d_exports } from "../types/document.js";
 import "../types/index.js";
+import { DocumentFontFacts } from "../fonts/documentFontFacts.js";
 //#region src/utils/fontResolver.d.ts
 /**
  * Result of resolving a font family
  */
-type ResolvedFont = {
+export type ResolvedFont = {
   /** Google Font name to load (null if no mapping available) */
   googleFont: string | null;
   /** CSS font-family value with proper fallback stack */
@@ -24,7 +25,7 @@ type FontCategory = "sans-serif" | "serif" | "monospace" | "cursive" | "fantasy"
  * 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;
+export 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
@@ -33,7 +34,7 @@ declare const DEFAULT_SINGLE_LINE_RATIO = 1.15;
  * 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;
+export 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
@@ -43,22 +44,23 @@ declare function isCjkFont(family: string): boolean;
  * (`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 const setGoogleFontsEnabled: (enabled: boolean) => void;
-declare const getGoogleFontsEnabled: () => boolean;
+export declare const CJK_FALLBACK_FONT_FAMILY = "MS Mincho";
+export declare const setGoogleFontsEnabled: (enabled: boolean) => void;
+export declare const getGoogleFontsEnabled: () => boolean;
 type FontResolutionOptions = {
   alternateFontName?: string | undefined;
   embeddedFontFamilyMap?: ReadonlyMap<string, string> | undefined;
+  documentFontFacts?: DocumentFontFacts | undefined;
 };
 /** Resolve against the calling editor's immutable embedded-font lookup. */
-declare function resolveFontFamily(docxFontName: string, options?: FontResolutionOptions): ResolvedFont;
+export declare function resolveFontFamily(docxFontName: string, options?: FontResolutionOptions): ResolvedFont;
 /**
  * Split a CSS `font-family` list built by `quoteFontName` back into family
  * names: the inverse of the quoting and escaping applied there. Quoted entries
  * may contain commas, quotes (backslash-escaped), and the newline escapes
  * `escapeQuotedFontName` emits; unquoted entries end at the next comma.
  */
-declare function parseFontFamilyList(list: string): string[];
+export declare function parseFontFamilyList(list: string): string[];
 /**
  * Resolve a theme font reference to actual font names
  *
@@ -66,14 +68,14 @@ declare function parseFontFamilyList(list: string): string[];
  * @param fontScheme - Theme font scheme from the DOCX
  * @returns Resolved font name or null if not found
  */
-declare function resolveThemeFont(themeRef: string, fontScheme?: document_d_exports.ThemeFontScheme): string | null;
+export declare function resolveThemeFont(themeRef: string, fontScheme?: document_d_exports.ThemeFontScheme): string | 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
  */
-declare function getGoogleFontsToLoad(docxFonts: string[]): string[];
+export declare function getGoogleFontsToLoad(docxFonts: string[]): string[];
 /**
  * Build a CSS font-family string from an array of font names
  *
@@ -81,20 +83,20 @@ declare function getGoogleFontsToLoad(docxFonts: string[]): string[];
  * @param category - Fallback category
  * @returns CSS font-family value
  */
-declare function buildFontFamilyString(fonts: string[], category?: FontCategory): string;
+export declare function buildFontFamilyString(fonts: string[], category?: FontCategory): string;
 /**
  * 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
  */
-declare function getGoogleFontEquivalent(docxFontName: string): string | null;
+export declare function getGoogleFontEquivalent(docxFontName: string): string | null;
 /**
  * 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
  */
-declare function hasGoogleFontEquivalent(docxFontName: string): boolean;
+export declare function hasGoogleFontEquivalent(docxFontName: string): boolean;
 //#endregion
-export { CJK_FALLBACK_FONT_FAMILY, DEFAULT_SINGLE_LINE_RATIO, ResolvedFont, buildFontFamilyString, getGoogleFontEquivalent, getGoogleFontsEnabled, getGoogleFontsToLoad, hasGoogleFontEquivalent, isCjkFont, parseFontFamilyList, resolveFontFamily, resolveThemeFont, setGoogleFontsEnabled };
+export {};

package/dist/utils/fontResolver.js

@@ -1,5 +1,14 @@
+import { documentFontInfoOf } from "../fonts/documentFontFacts.js";
 //#region src/utils/fontResolver.ts
 /**
+* Font Family Resolver
+*
+* Maps DOCX font names to Google Fonts equivalents with proper CSS fallback stacks.
+*
+* DOCX files often use fonts that aren't freely available (Calibri, Cambria, etc.)
+* This module provides mappings to metrically-compatible Google Fonts alternatives.
+*/
+/**
 * Default single-line ratio for unmapped fonts.
 * Middle of the common range (1.07–1.27) for standard DOCX fonts.
 */
@@ -960,6 +969,19 @@ function detectFontCategory(fontName) {
 	if (lower.includes("script") || lower.includes("cursive") || lower.includes("comic") || lower.includes("brush") || lower.includes("hand")) return "cursive";
 	return "sans-serif";
 }
+const categoryFromDocumentFacts = (fontName, documentFontFacts) => {
+	const font = documentFontInfoOf(fontName, documentFontFacts);
+	if (font?.pitch === "fixed") return "monospace";
+	switch (font?.family) {
+		case "decorative": return "fantasy";
+		case "modern": return "monospace";
+		case "roman": return "serif";
+		case "script": return "cursive";
+		case "swiss": return "sans-serif";
+		case "auto":
+		case void 0: return detectFontCategory(fontName);
+	}
+};
 /**
 * Romanized CJK font spellings → the native key already present in
 * FONT_MAPPINGS (port of eigenpal/docx-editor#957). Word writes either the
@@ -1045,7 +1067,7 @@ const setGoogleFontsEnabled = (enabled) => {
 const getGoogleFontsEnabled = () => googleFontsEnabled;
 /** Resolve against the calling editor's immutable embedded-font lookup. */
 function resolveFontFamily(docxFontName, options = {}) {
-	const { alternateFontName, embeddedFontFamilyMap } = options;
+	const { alternateFontName, embeddedFontFamilyMap, documentFontFacts } = options;
 	const normalizedName = docxFontName.trim().toLowerCase();
 	const scopedFamily = embeddedFontFamilyMap?.get(docxFontName) ?? null;
 	const aliasTarget = CJK_FONT_ALIASES[normalizedName];
@@ -1060,7 +1082,10 @@ function resolveFontFamily(docxFontName, options = {}) {
 			hasGoogleEquivalent: googleFontsEnabled,
 			singleLineRatio: mapping.singleLineRatio
 		};
-		const alternate = resolveFontFamily(alternateFontName, { embeddedFontFamilyMap });
+		const alternate = resolveFontFamily(alternateFontName, {
+			embeddedFontFamilyMap,
+			documentFontFacts
+		});
 		const category = mapping.category;
 		const concreteStack = dedupeFontFamilies([
 			scopedFamily ?? docxFontName,
@@ -1078,8 +1103,11 @@ function resolveFontFamily(docxFontName, options = {}) {
 	}
 	const alternateName = alternateFontName?.trim();
 	if (alternateName && alternateName.toLowerCase() !== normalizedName) {
-		const alternate = resolveFontFamily(alternateName, { embeddedFontFamilyMap });
-		const category = detectFontCategory(docxFontName);
+		const alternate = resolveFontFamily(alternateName, {
+			embeddedFontFamilyMap,
+			documentFontFacts
+		});
+		const category = categoryFromDocumentFacts(docxFontName, documentFontFacts);
 		const concreteStack = dedupeFontFamilies([scopedFamily ?? docxFontName, ...parseFontFamilyList(alternate.cssFallback)]).filter((family) => !isCssGenericFontFamily(family));
 		return {
 			googleFont: googleFontsEnabled ? alternate.googleFont : null,
@@ -1089,7 +1117,7 @@ function resolveFontFamily(docxFontName, options = {}) {
 			singleLineRatio: alternate.singleLineRatio
 		};
 	}
-	const category = detectFontCategory(docxFontName);
+	const category = categoryFromDocumentFacts(docxFontName, documentFontFacts);
 	const defaultFallback = DEFAULT_FALLBACKS[category];
 	return {
 		googleFont: null,

package/dist/utils/fontWeights.d.ts

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

package/dist/utils/formatToStyle.d.ts

@@ -10,7 +10,7 @@ type CSSProperties = Properties<string | number>;
  * @param theme - Theme for resolving colors and fonts
  * @returns React CSSProperties
  */
-declare function textToStyle(formatting: document_d_exports.TextFormatting | undefined | null, theme?: document_d_exports.Theme | null): CSSProperties;
+export declare function textToStyle(formatting: document_d_exports.TextFormatting | undefined | null, theme?: document_d_exports.Theme | null): CSSProperties;
 /**
  * Convert ParagraphFormatting to CSS properties
  *
@@ -18,7 +18,7 @@ declare function textToStyle(formatting: document_d_exports.TextFormatting | und
  * @param theme - Theme for resolving colors
  * @returns React CSSProperties
  */
-declare function paragraphToStyle(formatting: document_d_exports.ParagraphFormatting | undefined | null, theme?: document_d_exports.Theme | null): CSSProperties;
+export declare function paragraphToStyle(formatting: document_d_exports.ParagraphFormatting | undefined | null, theme?: document_d_exports.Theme | null): CSSProperties;
 /**
  * Convert a BorderSpec to CSS border properties
  *
@@ -27,7 +27,7 @@ declare function paragraphToStyle(formatting: document_d_exports.ParagraphFormat
  * @param theme - Theme for color resolution
  * @returns Partial CSSProperties with border styles
  */
-declare function borderToStyle(border: document_d_exports.BorderSpec | undefined | null, side?: "Top" | "Bottom" | "Left" | "Right" | "", theme?: document_d_exports.Theme | null): CSSProperties;
+export declare function borderToStyle(border: document_d_exports.BorderSpec | undefined | null, side?: "Top" | "Bottom" | "Left" | "Right" | "", theme?: document_d_exports.Theme | null): CSSProperties;
 /**
  * Convert ShadingProperties to background color
  *
@@ -35,9 +35,9 @@ declare function borderToStyle(border: document_d_exports.BorderSpec | undefined
  * @param theme - Theme for color resolution
  * @returns CSS color string or empty string
  */
-declare function resolveShadingFill(shading: document_d_exports.ShadingProperties | undefined | null, theme?: document_d_exports.Theme | null): string;
+export declare function resolveShadingFill(shading: document_d_exports.ShadingProperties | undefined | null, theme?: document_d_exports.Theme | null): string;
 /** The CSS `text-decoration-style` keywords folio paints an underline with. */
-type CssTextDecorationStyle = "solid" | "double" | "dotted" | "dashed" | "wavy";
+export type CssTextDecorationStyle = "solid" | "double" | "dotted" | "dashed" | "wavy";
 /**
  * What an authored underline paints as, in CSS.
  *
@@ -46,7 +46,7 @@ type CssTextDecorationStyle = "solid" | "double" | "dotted" | "dashed" | "wavy";
  * `decorationThickness` is absent wherever the font's own underline weight is
  * what Word draws.
  */
-type UnderlineDecorationCss = {
+export type UnderlineDecorationCss = {
   readonly decorationStyle?: CssTextDecorationStyle;
   readonly decorationThickness?: string;
 };
@@ -56,7 +56,7 @@ type UnderlineDecorationCss = {
  * It is also what an underline CSS cannot spell parses back as; see
  * `underlineStyleFromCssDecoration`.
  */
-declare const PLAIN_UNDERLINE = "single";
+export declare const PLAIN_UNDERLINE = "single";
 /**
  * Every `ST_Underline` member's CSS line. The one table: the ProseMirror mark's
  * `toDOM`, the DOM painter and `textToStyle` all render a run from this, so a
@@ -76,7 +76,7 @@ declare const PLAIN_UNDERLINE = "single";
  * weight only, which the thickness carries, so the line they name is their
  * plain counterpart's.
  */
-declare const UNDERLINE_DECORATION_STYLES: {
+export declare const UNDERLINE_DECORATION_STYLES: {
   readonly none: undefined;
   readonly single: "solid";
   readonly words: "solid";
@@ -105,7 +105,7 @@ declare const UNDERLINE_DECORATION_STYLES: {
  * with the font size, and which members are heavy is read off the row rather
  * than listed again here, so the page and the editor cannot disagree about it.
  */
-declare const underlineDecorationCss: (style: document_d_exports.UnderlineStyle) => UnderlineDecorationCss;
+export declare const underlineDecorationCss: (style: document_d_exports.UnderlineStyle) => UnderlineDecorationCss;
 /**
  * The `ST_Underline` member an authored `text-decoration` or
  * `text-decoration-style` value parses back as.
@@ -117,7 +117,7 @@ declare const underlineDecorationCss: (style: document_d_exports.UnderlineStyle)
  * as `dotted`, `words` and `thick` as `single`, `wavyDouble` as `double`. A
  * value naming no keyword folio writes parses as the plain underline.
  */
-declare const underlineStyleFromCssDecoration: (value: string) => document_d_exports.UnderlineStyle;
+export declare const underlineStyleFromCssDecoration: (value: string) => document_d_exports.UnderlineStyle;
 /**
  * Merge multiple CSSProperties objects
  *
@@ -126,7 +126,7 @@ declare const underlineStyleFromCssDecoration: (value: string) => document_d_exp
  * @param styles - Array of CSSProperties objects
  * @returns Merged CSSProperties
  */
-declare function mergeStyles(...styles: (CSSProperties | undefined | null)[]): CSSProperties;
+export declare function mergeStyles(...styles: (CSSProperties | undefined | null)[]): CSSProperties;
 /**
  * Get CSS for a table cell based on formatting
  *
@@ -134,7 +134,7 @@ declare function mergeStyles(...styles: (CSSProperties | undefined | null)[]): C
  * @param theme - Theme for color resolution
  * @returns CSSProperties for the cell
  */
-declare function tableCellToStyle(formatting: {
+export declare function tableCellToStyle(formatting: {
   verticalAlign?: "top" | "center" | "bottom";
   textDirection?: document_d_exports.TextDirection;
   shading?: document_d_exports.ShadingProperties;
@@ -169,7 +169,7 @@ declare function tableCellToStyle(formatting: {
  * @param sectionProps - Section properties
  * @returns CSSProperties for the page container
  */
-declare function sectionToStyle(sectionProps: {
+export declare function sectionToStyle(sectionProps: {
   pageWidth?: number;
   pageHeight?: number;
   marginTop?: number;
@@ -181,4 +181,4 @@ declare function sectionToStyle(sectionProps: {
   };
 } | undefined | null, theme?: document_d_exports.Theme | null): CSSProperties;
 //#endregion
-export { CssTextDecorationStyle, PLAIN_UNDERLINE, UNDERLINE_DECORATION_STYLES, UnderlineDecorationCss, borderToStyle, mergeStyles, paragraphToStyle, resolveShadingFill, sectionToStyle, tableCellToStyle, textToStyle, underlineDecorationCss, underlineStyleFromCssDecoration };
+export {};

package/dist/utils/formatToStyle.js

@@ -61,9 +61,6 @@ function textToStyle(formatting, theme) {
 		case "subscript":
 			style.verticalAlign = "sub";
 			style.fontSize ??= "0.83em";
-			break;
-		case "baseline": break;
-		default: break;
 	}
 	if (formatting.position !== void 0 && formatting.position !== 0) {
 		const positionPx = halfPointsToPixels(formatting.position);
@@ -104,22 +101,27 @@ function paragraphToStyle(formatting, theme) {
 	else if (formatting.spaceBefore !== void 0) style.marginTop = formatPx(twipsToPixels(formatting.spaceBefore));
 	if (formatting.afterAutospacing) style.marginBottom = formatPx(AUTO_PARAGRAPH_SPACING_PX);
 	else if (formatting.spaceAfter !== void 0) style.marginBottom = formatPx(twipsToPixels(formatting.spaceAfter));
-	if (formatting.lineSpacing !== void 0 && formatting.lineSpacing > 0) if (formatting.lineSpacingRule === "exact") {
-		const exactPx = twipsToPixels(formatting.lineSpacing);
-		if (exactPx > 0) style.lineHeight = formatPx(exactPx);
-	} else if (formatting.lineSpacingRule === "atLeast") {
-		const atLeastPx = twipsToPixels(formatting.lineSpacing);
-		if (atLeastPx > 0) {
-			style.minHeight = formatPx(atLeastPx);
-			style.lineHeight = formatPx(atLeastPx);
+	if (formatting.lineSpacing !== void 0 && formatting.lineSpacing > 0) {
+		if (formatting.lineSpacingRule === "exact") {
+			const exactPx = twipsToPixels(formatting.lineSpacing);
+			if (exactPx > 0) style.lineHeight = formatPx(exactPx);
+		} else if (formatting.lineSpacingRule === "atLeast") {
+			const atLeastPx = twipsToPixels(formatting.lineSpacing);
+			if (atLeastPx > 0) {
+				style.minHeight = formatPx(atLeastPx);
+				style.lineHeight = formatPx(atLeastPx);
+			}
+		} else {
+			const lineMultiplier = formatting.lineSpacing / 240;
+			if (lineMultiplier > 0) style.lineHeight = lineMultiplier.toString();
 		}
-	} else {
-		const lineMultiplier = formatting.lineSpacing / 240;
-		if (lineMultiplier > 0) style.lineHeight = lineMultiplier.toString();
 	}
 	if (formatting.indentLeft !== void 0) style.marginLeft = formatPx(twipsToPixels(formatting.indentLeft));
 	if (formatting.indentRight !== void 0) style.marginRight = formatPx(twipsToPixels(formatting.indentRight));
-	if (formatting.indentFirstLine !== void 0) style.textIndent = formatPx(twipsToPixels(formatting.hangingIndent ? -Math.abs(formatting.indentFirstLine) : formatting.indentFirstLine));
+	if (formatting.indentFirstLine !== void 0) {
+		const textIndent = formatting.hangingIndent ? -Math.abs(formatting.indentFirstLine) : formatting.indentFirstLine;
+		style.textIndent = formatPx(twipsToPixels(textIndent));
+	}
 	if (formatting.borders) {
 		if (formatting.borders.top) Object.assign(style, borderToStyle(formatting.borders.top, "Top", theme));
 		if (formatting.borders.bottom) Object.assign(style, borderToStyle(formatting.borders.bottom, "Bottom", theme));

package/dist/utils/headerFooter.d.ts

@@ -1,12 +1,12 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/utils/headerFooter.d.ts
-type HeaderFooterPosition = "header" | "footer";
+export type HeaderFooterPosition = "header" | "footer";
 /**
  * The resolved header/footer slots for the active document, plus the
  * relationship ids that save/remove must target (the *displayed* slot's rId,
  * not necessarily `finalSectionProperties`).
  */
-type HeaderFooterResolution = {
+export type HeaderFooterResolution = {
   headerContent: document_d_exports.HeaderFooter | null;
   footerContent: document_d_exports.HeaderFooter | null;
   firstPageHeaderContent: document_d_exports.HeaderFooter | null;
@@ -21,21 +21,21 @@ type HeaderFooterResolution = {
  * Resolve the header/footer content (and the active relationship ids) for a
  * parsed package. Returns the empty resolution when no package is loaded.
  */
-declare const resolveHeaderFooterContent: (pkg: document_d_exports.DocxPackage | undefined) => HeaderFooterResolution;
+export declare const resolveHeaderFooterContent: (pkg: document_d_exports.DocxPackage | undefined) => HeaderFooterResolution;
 /**
  * The section properties that drive the rendered chrome, with `titlePg` merged
  * in when title-page mode was inferred from header/footer references.
  */
-declare const resolveEffectiveSectionProperties: (documentBody: document_d_exports.DocumentBody | undefined, hasTitlePg: boolean) => document_d_exports.SectionProperties | undefined;
+export declare const resolveEffectiveSectionProperties: (documentBody: document_d_exports.DocumentBody | undefined, hasTitlePg: boolean) => document_d_exports.SectionProperties | undefined;
 /** Pick the relationship id for the slot a save/remove targets. */
-declare const pickActiveHeaderFooterRId: (resolution: HeaderFooterResolution, position: HeaderFooterPosition, isFirstPage: boolean) => string | null;
+export declare const pickActiveHeaderFooterRId: (resolution: HeaderFooterResolution, position: HeaderFooterPosition, isFirstPage: boolean) => string | null;
 /**
  * Build a Document with a fresh empty header/footer for the given slot, wired
  * into `finalSectionProperties` via a new reference. Returns null when the
  * document has no final section properties to attach the reference to.
  */
-declare const createEmptyHeaderFooter: (document: document_d_exports.Document, position: HeaderFooterPosition, isFirstPage: boolean) => document_d_exports.Document | null;
-type SaveHeaderFooterArgs = {
+export declare const createEmptyHeaderFooter: (document: document_d_exports.Document, position: HeaderFooterPosition, isFirstPage: boolean) => document_d_exports.Document | null;
+export type SaveHeaderFooterArgs = {
   document: document_d_exports.Document;
   position: HeaderFooterPosition;
   isFirstPage: boolean;
@@ -50,8 +50,8 @@ type SaveHeaderFooterArgs = {
  * Document untouched so undo can step back to the pre-edit state. Returns null
  * when the target header/footer cannot be found.
  */
-declare const saveHeaderFooterContent: ({ document, position, isFirstPage, activeRId, blocks }: SaveHeaderFooterArgs) => document_d_exports.Document | null;
-type RemoveHeaderFooterArgs = {
+export declare const saveHeaderFooterContent: ({ document, position, isFirstPage, activeRId, blocks }: SaveHeaderFooterArgs) => document_d_exports.Document | null;
+export type RemoveHeaderFooterArgs = {
   document: document_d_exports.Document;
   position: HeaderFooterPosition;
   /** The relationship id the displayed slot resolves to (`pickActiveHeaderFooterRId`). */
@@ -61,6 +61,5 @@ type RemoveHeaderFooterArgs = {
  * Remove a header/footer and drop its reference from every section that points
  * at it, returning the new Document.
  */
-declare const removeHeaderFooter: ({ document, position, activeRId }: RemoveHeaderFooterArgs) => document_d_exports.Document;
-//#endregion
-export { HeaderFooterPosition, HeaderFooterResolution, RemoveHeaderFooterArgs, SaveHeaderFooterArgs, createEmptyHeaderFooter, pickActiveHeaderFooterRId, removeHeaderFooter, resolveEffectiveSectionProperties, resolveHeaderFooterContent, saveHeaderFooterContent };
+export declare const removeHeaderFooter: ({ document, position, activeRId }: RemoveHeaderFooterArgs) => document_d_exports.Document;
+//#endregion

package/dist/utils/headerFooter.js

@@ -1,5 +1,15 @@
 import { clearHeaderFooterVerbatimXml } from "../docx/headerFooterVerbatim.js";
 //#region src/utils/headerFooter.ts
+/**
+* Header/footer document-model operations, extracted from the React
+* `useHeaderFooterEditor` hook. Pure functions over the folio `Document`
+* model: resolving which header/footer renders for each slot, and building the
+* new `Document` produced by creating, saving, or removing a header/footer.
+*
+* ProseMirror stays in the adapter: the save path serialises the live hidden
+* header/footer PM doc to `BlockContent[]` (`proseDocToBlocks`) and passes the
+* blocks in here.
+*/
 const EMPTY_RESOLUTION = {
 	headerContent: null,
 	footerContent: null,

package/dist/utils/headingCollector.d.ts

@@ -4,7 +4,7 @@ import { Node } from "prosemirror-model";
 /**
  * Information about a heading found in the document.
  */
-type HeadingInfo = {
+export type HeadingInfo = {
   /** The text content of the heading */
   text: string;
   /** Outline level (0 = Heading 1, 1 = Heading 2, etc.) */
@@ -23,6 +23,5 @@ type HeadingInfo = {
  * `Nadpis1` or `berschrift1` resolves through its name rather than falling out
  * of the outline.
  */
-declare function collectHeadings(doc: Node, styles: BuiltInStyleIndex): HeadingInfo[];
-//#endregion
-export { HeadingInfo, collectHeadings };
+export declare function collectHeadings(doc: Node, styles: BuiltInStyleIndex): HeadingInfo[];
+//#endregion

package/dist/utils/hexId.d.ts

@@ -14,7 +14,7 @@
  * to survive both Word ("Document Recovery — Table Properties") and
  * strict OOXML validators.
  */
-declare const MAX_HEX_ID_EXCLUSIVE = 2147483647;
+export declare const MAX_HEX_ID_EXCLUSIVE = 2147483647;
 /**
  * OOXML `ST_LongHexNumber` shape: exactly 8 hex digits (`xsd:hexBinary`,
  * length 4 bytes). `w14:paraId` / `w14:textId` / comment `paraId` /
@@ -22,9 +22,9 @@ declare const MAX_HEX_ID_EXCLUSIVE = 2147483647;
  * is not a real Word id — it must not be trusted as one (e.g. echoed
  * unescaped into serialized XML attributes).
  */
-declare const HEX_ID_PATTERN: RegExp;
+export declare const HEX_ID_PATTERN: RegExp;
 /** Whether `value` is a well-formed 8-hex-digit OOXML long-hex id. */
-declare const isValidHexId: (value: string | undefined | null) => boolean;
+export declare const isValidHexId: (value: string | undefined | null) => boolean;
 /**
  * Random 8-char uppercase hex id, matching Microsoft's `w14:paraId`
  * extension format (also reused for comment `paraId` / `durableId`).
@@ -35,7 +35,7 @@ declare const isValidHexId: (value: string | undefined | null) => boolean;
  * Uses `Math.random()` rather than `crypto.randomUUID()` so the
  * generator works in non-secure contexts (file://, web workers).
  */
-declare const generateHexId: () => string;
+export declare const generateHexId: () => string;
 /**
  * Deterministic 8-char uppercase hex id (FNV-1a over `seed`), `< 0x7FFFFFFF`.
  * Re-deriving from the same seed mints the same id, so content/position-derived
@@ -45,6 +45,5 @@ declare const generateHexId: () => string;
  * sentinel, and remapping only that one (already invalid) output keeps every
  * previously shipped deterministic id unchanged.
  */
-declare const deterministicHexId: (seed: string) => string;
-//#endregion
-export { HEX_ID_PATTERN, MAX_HEX_ID_EXCLUSIVE, deterministicHexId, generateHexId, isValidHexId };
+export declare const deterministicHexId: (seed: string) => string;
+//#endregion

package/dist/utils/hexId.js

@@ -35,7 +35,7 @@ const isValidHexId = (value) => typeof value === "string" && HEX_ID_PATTERN.test
 * Uses `Math.random()` rather than `crypto.randomUUID()` so the
 * generator works in non-secure contexts (file://, web workers).
 */
-const generateHexId = () => (Math.floor(Math.random() * (MAX_HEX_ID_EXCLUSIVE - 1)) + 1).toString(16).toUpperCase().padStart(8, "0");
+const generateHexId = () => (Math.floor(Math.random() * 2147483646) + 1).toString(16).toUpperCase().padStart(8, "0");
 /**
 * Deterministic 8-char uppercase hex id (FNV-1a over `seed`), `< 0x7FFFFFFF`.
 * Re-deriving from the same seed mints the same id, so content/position-derived

package/dist/utils/horizontalScale.d.ts

@@ -5,7 +5,7 @@
  * The OOXML value is bounded from 0% through 600%. Missing or malformed
  * values use the document default (100%) and stay absent in the model.
  */
-declare function normalizeHorizontalScalePercent(horizontalScale: number | null | undefined): number | undefined;
+export declare function normalizeHorizontalScalePercent(horizontalScale: number | null | undefined): number | undefined;
 /**
  * Parse the lexical forms accepted by OOXML `ST_TextScale`.
  *
@@ -13,8 +13,8 @@ declare function normalizeHorizontalScalePercent(horizontalScale: number | null
  * unsigned decimal grammar defined by `ST_TextScalePercent`. Surrounding
  * whitespace is ignored, but an empty value or partial numeric prefix is not.
  */
-declare function parseHorizontalScalePercent(horizontalScale: string | null | undefined): number | undefined;
-declare function getHorizontalScaleFactor(horizontalScale: number | null | undefined): number;
+export declare function parseHorizontalScalePercent(horizontalScale: string | null | undefined): number | undefined;
+export declare function getHorizontalScaleFactor(horizontalScale: number | null | undefined): number;
 /**
  * Quantize an in-range model value for OOXML's integer-only representation.
  *
@@ -23,6 +23,5 @@ declare function getHorizontalScaleFactor(horizontalScale: number | null | undef
  * preserving the existing integer-attribute contract without emitting an
  * invalid fractional value.
  */
-declare function roundHorizontalScalePercentForSerialization(horizontalScale: number | null | undefined): number | undefined;
-//#endregion
-export { getHorizontalScaleFactor, normalizeHorizontalScalePercent, parseHorizontalScalePercent, roundHorizontalScalePercentForSerialization };
+export declare function roundHorizontalScalePercentForSerialization(horizontalScale: number | null | undefined): number | undefined;
+//#endregion

package/dist/utils/htmlComments.d.ts

@@ -12,6 +12,5 @@
  *
  * Both comment strippers resolve the terminator here so the two cannot drift.
  */
-declare const htmlCommentEnd: (html: string, start: number) => number | null;
-//#endregion
-export { htmlCommentEnd };
+export declare const htmlCommentEnd: (html: string, start: number) => number | null;
+//#endregion

package/dist/utils/imageLuminance.d.ts

@@ -1,15 +1,14 @@
 //#region src/utils/imageLuminance.d.ts
-type ImageLuminance = {
+export type ImageLuminance = {
   brightness?: number | null;
   contrast?: number | null;
 };
 /** Clamp a finite percentage to the range accepted by DrawingML `a:lum`. */
-declare const normalizeImageLuminancePercent: (value: number) => number;
+export declare const normalizeImageLuminancePercent: (value: number) => number;
 /**
  * Convert DrawingML brightness and contrast percentages into Word's single
  * linear per-channel transfer, expressed as CSS filters without an
  * intermediate clamp changing the result.
  */
-declare const imageLuminanceFilter: ({ brightness, contrast }: ImageLuminance) => string | undefined;
-//#endregion
-export { ImageLuminance, imageLuminanceFilter, normalizeImageLuminancePercent };
+export declare const imageLuminanceFilter: ({ brightness, contrast }: ImageLuminance) => string | undefined;
+//#endregion

package/dist/utils/imageResize.d.ts

@@ -0,0 +1,18 @@
+//#region src/utils/imageResize.d.ts
+declare const IMAGE_RESIZE_HANDLE_VALUES: readonly ["nw", "ne", "se", "sw", "n", "s", "e", "w"];
+export type ImageResizeHandle = (typeof IMAGE_RESIZE_HANDLE_VALUES)[number];
+export declare const IMAGE_RESIZE_HANDLES: readonly ImageResizeHandle[];
+type ImageResizeOptions = {
+  handle: ImageResizeHandle;
+  deltaX: number;
+  deltaY: number;
+  startWidth: number;
+  startHeight: number;
+  aspect: "locked" | "free";
+};
+export declare const calculateResizedImageDimensions: ({ handle, deltaX, deltaY, startWidth, startHeight, aspect }: ImageResizeOptions) => {
+  width: number;
+  height: number;
+};
+//#endregion
+export {};

package/dist/utils/imageResize.js

@@ -0,0 +1,37 @@
+const IMAGE_RESIZE_HANDLES = [
+	"nw",
+	"ne",
+	"se",
+	"sw",
+	"n",
+	"s",
+	"e",
+	"w"
+];
+const MIN_IMAGE_PX = 20;
+const MAX_IMAGE_PX = 2e3;
+const calculateResizedImageDimensions = ({ handle, deltaX, deltaY, startWidth, startHeight, aspect }) => {
+	const drivesWidth = handle.includes("w") || handle.includes("e");
+	const drivesHeight = handle.includes("n") || handle.includes("s");
+	const signX = handle.includes("w") ? -1 : 1;
+	const signY = handle.includes("n") ? -1 : 1;
+	if (drivesWidth && drivesHeight && aspect === "locked") {
+		const scaleX = startWidth > 0 ? (startWidth + deltaX * signX) / startWidth : 1;
+		const scaleY = startHeight > 0 ? (startHeight + deltaY * signY) / startHeight : 1;
+		const desiredScale = Math.abs(scaleX - 1) > Math.abs(scaleY - 1) ? scaleX : scaleY;
+		const minScale = Math.max(startWidth > 0 ? MIN_IMAGE_PX / startWidth : 0, startHeight > 0 ? MIN_IMAGE_PX / startHeight : 0);
+		const maxScale = Math.min(startWidth > 0 ? MAX_IMAGE_PX / startWidth : Infinity, startHeight > 0 ? MAX_IMAGE_PX / startHeight : Infinity);
+		const scale = Math.min(maxScale, Math.max(minScale, desiredScale));
+		return {
+			width: startWidth * scale,
+			height: startHeight * scale
+		};
+	}
+	const clamp = (dimension) => Math.max(MIN_IMAGE_PX, Math.min(MAX_IMAGE_PX, dimension));
+	return {
+		width: drivesWidth ? clamp(startWidth + deltaX * signX) : startWidth,
+		height: drivesHeight ? clamp(startHeight + deltaY * signY) : startHeight
+	};
+};
+//#endregion
+export { IMAGE_RESIZE_HANDLES, calculateResizedImageDimensions };

package/dist/utils/imageValidation.d.ts

@@ -1,5 +1,4 @@
 //#region src/utils/imageValidation.d.ts
-declare function isAllowedImageMimeType(mimeType: string): boolean;
-declare function isSafeImageFile(file: File): Promise<boolean>;
-//#endregion
-export { isAllowedImageMimeType, isSafeImageFile };
+export declare function isAllowedImageMimeType(mimeType: string): boolean;
+export declare function isSafeImageFile(file: File): Promise<boolean>;
+//#endregion

package/dist/utils/imageValidation.js

@@ -1,5 +1,5 @@
 //#region src/utils/imageValidation.ts
-const MAX_INSERTED_IMAGE_BYTES = 10 * 1024 * 1024;
+const MAX_INSERTED_IMAGE_BYTES = 10485760;
 const ALLOWED_IMAGE_MIME_TYPES = /* @__PURE__ */ new Set([
 	"image/png",
 	"image/jpeg",