@docen/docx 0.3.1 → 0.3.3

package/dist/utils-BPT4tjcn.mjs

@@ -1,333 +0,0 @@
-//#region src/extensions/utils.ts
-/** Common CSS named colors → hex */
-const CSS_COLORS = {
-	black: "#000000",
-	white: "#FFFFFF",
-	red: "#FF0000",
-	green: "#008000",
-	blue: "#0000FF",
-	yellow: "#FFFF00",
-	cyan: "#00FFFF",
-	magenta: "#FF00FF",
-	gray: "#808080",
-	grey: "#808080",
-	orange: "#FFA500",
-	purple: "#800080",
-	pink: "#FFC0CB",
-	brown: "#A52A2A",
-	lime: "#00FF00",
-	navy: "#000080",
-	teal: "#008080",
-	silver: "#C0C0C0",
-	maroon: "#800000",
-	olive: "#808000",
-	aqua: "#00FFFF",
-	fuchsia: "#FF00FF",
-	indigo: "#4B0082",
-	violet: "#EE82EE",
-	coral: "#FF7F50",
-	gold: "#FFD700",
-	salmon: "#FA8072",
-	tomato: "#FF6347"
-};
-/** Normalize a CSS color value to hex (e.g., "red" → "#FF0000", "#ff0000" → "#FF0000").
-*  Accepts a string (CSS name/hex or bare OOXML hex), or an OOXML ColorOptions
-*  object ({ val, themeColor, themeTint, themeShade }) — the object form
-*  resolves to its val (the RGB fallback Word stores alongside themeColor) for
-*  CSS rendering. The themeColor/tint/shade are preserved verbatim in the attrs
-*  and round-trip back to the DOCX (see text-style/paragraph parseDocx), so
-*  theme semantics survive even though only val is rendered here. A pure theme
-*  reference with no val (rare — Word usually stores both) would need theme.xml
-*  to resolve and is left unset. */
-function normalizeColorToHex(color) {
-	if (!color) return void 0;
-	if (typeof color === "object") {
-		const { val } = color;
-		return val ? normalizeColorToHex(val) : void 0;
-	}
-	if (typeof color !== "string") return void 0;
-	if (color === "auto") return void 0;
-	if (color.startsWith("#")) return color.length === 4 ? `#${color[1]}${color[1]}${color[2]}${color[2]}${color[3]}${color[3]}`.toUpperCase() : color.toUpperCase();
-	if (/^[0-9A-Fa-f]{6}$/.test(color)) return `#${color.toUpperCase()}`;
-	if (/^[0-9A-Fa-f]{3}$/.test(color)) return `#${color[0]}${color[0]}${color[1]}${color[1]}${color[2]}${color[2]}`.toUpperCase();
-	return CSS_COLORS[color.toLowerCase()] ?? void 0;
-}
-/** Resolve a font value (string or OOXML rFonts { ascii, eastAsia, hAnsi, cs }) to a CSS family name. */
-function resolveFontName(font) {
-	if (!font) return null;
-	if (typeof font === "string") return font;
-	if (typeof font === "object") {
-		const f = font;
-		return f.ascii || f.hAnsi || f.eastAsia || null;
-	}
-	return null;
-}
-/** CSS value (e.g., "18pt") → twip number. 1 pt = 20 twips, 1 px = 15 twips (96 DPI). */
-function cssToTwip(value) {
-	if (!value) return void 0;
-	const match = value.match(/^([\d.]+)(pt|px|em|cm|in)?$/);
-	if (!match) return void 0;
-	const num = parseFloat(match[1]);
-	switch (match[2] ?? "pt") {
-		case "pt": return Math.round(num * 20);
-		case "px": return Math.round(num * 15);
-		case "in": return Math.round(num * 1440);
-		case "cm": return Math.round(num * 567);
-		case "em": return Math.round(num * 240);
-		default: return Math.round(num * 20);
-	}
-}
-/** Twip value → CSS string (e.g., 360 → "18pt"). */
-function twipToCss(value) {
-	if (value == null) return null;
-	if (typeof value === "string") return value;
-	return `${value / 20}pt`;
-}
-const ALIGNMENT_TO_CSS = {
-	left: "left",
-	center: "center",
-	right: "right",
-	start: "start",
-	end: "end",
-	both: "justify",
-	distribute: "justify"
-};
-const CSS_TO_ALIGNMENT = {
-	left: "left",
-	center: "center",
-	right: "right",
-	start: "start",
-	end: "end",
-	justify: "both"
-};
-/** OOXML alignment → CSS text-align. */
-function alignmentToCss(alignment) {
-	if (!alignment) return null;
-	return ALIGNMENT_TO_CSS[alignment] ?? null;
-}
-/** CSS text-align → OOXML alignment. */
-function alignmentFromCss(css) {
-	if (!css) return null;
-	return CSS_TO_ALIGNMENT[css] ?? null;
-}
-/** Shading.fill → CSS background-color hex. */
-function shadingToCss(shading) {
-	if (!shading?.fill) return null;
-	return normalizeColorToHex(shading.fill) ?? null;
-}
-/** CSS background-color → ShadingAttributesProperties (fill normalized to hex). */
-function shadingFromCss(css) {
-	const hex = normalizeColorToHex(css ?? void 0);
-	return hex ? {
-		fill: hex,
-		type: "clear"
-	} : null;
-}
-function lineSpacingToCss(spacing) {
-	if (!spacing?.line) return null;
-	const rule = spacing.lineRule;
-	if (rule === "exact" || rule === "exactly" || rule === "atLeast") return `${spacing.line / 20}pt`;
-	return `calc(var(--docen-line-pitch, 1em) * ${Number((spacing.line / 240).toFixed(2))})`;
-}
-function sizeToCss(size) {
-	if (size == null) return null;
-	return `${size}pt`;
-}
-function sizeFromCss(css) {
-	if (!css) return null;
-	const m = css.match(/^([\d.]+)(pt|px)?$/);
-	if (!m) return null;
-	const num = parseFloat(m[1]);
-	return (m[2] ?? "pt") === "px" ? num * .75 : num;
-}
-function characterSpacingToCss(spacing) {
-	if (spacing == null) return null;
-	return `${spacing / 20}pt`;
-}
-function characterSpacingFromCss(css) {
-	if (!css) return null;
-	const m = css.match(/^(-?[\d.]+)pt$/);
-	return m ? Math.round(parseFloat(m[1]) * 20) : null;
-}
-/** Render a BorderOptions to CSS string. OOXML border.size is in eighths of a point. */
-function renderBorderCSS(border) {
-	if (!border || !border.style || border.style === "none" || border.style === "nil") return null;
-	const size = border.size != null ? `${border.size / 8}pt` : "1pt";
-	const cssStyle = {
-		single: "solid",
-		dashed: "dashed",
-		dotted: "dotted",
-		double: "double",
-		dotDash: "dashed",
-		dotDotDash: "dotted"
-	}[border.style || "single"] || "solid";
-	const hex = border.color && border.color !== "auto" ? normalizeColorToHex(border.color) : null;
-	return hex ? `${cssStyle} ${size} ${hex}` : `${cssStyle} ${size}`;
-}
-/**
-* Compute all paragraph-level CSS styles from nested attrs.
-* Shared by Paragraph and Heading extensions for node-level renderHTML.
-* Attrs store office-open native values; mappers here convert to CSS.
-*/
-function renderParagraphStyles(attrs) {
-	const a = attrs;
-	const styles = [];
-	const align = alignmentToCss(a.alignment);
-	if (align) styles.push(`text-align:${align}`);
-	if (a.indent) {
-		const left = twipToCss(a.indent.left);
-		if (left) styles.push(`margin-left:${left}`);
-		const right = twipToCss(a.indent.right);
-		if (right) styles.push(`margin-right:${right}`);
-		if (a.indent.firstLine != null) {
-			const fl = twipToCss(a.indent.firstLine);
-			if (fl) styles.push(`text-indent:${fl}`);
-		} else if (a.indent.hanging != null) {
-			const h = twipToCss(a.indent.hanging);
-			if (h) styles.push(`text-indent:-${h}`);
-		} else if (a.indent.firstLineChars != null) styles.push(`text-indent:${a.indent.firstLineChars / 100}em`);
-	}
-	const markLineHeight = a.run?.size != null ? sizeToCss(a.run.size) : null;
-	if (markLineHeight) styles.push(`line-height:${markLineHeight}`);
-	if (a.spacing) {
-		const before = twipToCss(a.spacing.before);
-		if (before) styles.push(`margin-top:${before}`);
-		const after = twipToCss(a.spacing.after);
-		if (after) styles.push(`margin-bottom:${after}`);
-		const lh = lineSpacingToCss(a.spacing);
-		if (lh) styles.push(`line-height:${lh}`);
-	}
-	const bg = shadingToCss(a.shading);
-	if (bg) styles.push(`background-color:${bg}`, `color:contrast-color(${bg})`);
-	if (a.border) {
-		const sides = [
-			["top", a.border.top],
-			["bottom", a.border.bottom],
-			["left", a.border.left],
-			["right", a.border.right]
-		];
-		for (const [side, b] of sides) {
-			const css = b ? renderBorderCSS(b) : null;
-			if (css) styles.push(`border-${side}:${css}`);
-		}
-	}
-	return styles;
-}
-/**
-* Compute run-level CSS (font/size/color/weight/…) from office-open run attrs.
-* Shared by text-style marks and the styles→CSS generator (stylesToCss).
-*/
-function renderRunStyles(attrs) {
-	const a = attrs;
-	const styles = [];
-	if (a.bold) styles.push("font-weight:bold");
-	if (a.italic) styles.push("font-style:italic");
-	if (a.smallCaps) styles.push("font-variant:small-caps");
-	if (a.allCaps) styles.push("text-transform:uppercase");
-	const deco = [];
-	if (a.underline) deco.push("underline");
-	if (a.strike || a.doubleStrike) deco.push("line-through");
-	if (deco.length) styles.push(`text-decoration:${deco.join(" ")}`);
-	const font = resolveFontName(a.font);
-	if (font) styles.push(`font-family:${font}`);
-	const size = sizeToCss(a.size);
-	if (size) styles.push(`font-size:${size}`);
-	const color = a.color === "auto" ? void 0 : normalizeColorToHex(a.color);
-	if (color) styles.push(`color:${color}`);
-	const spacing = characterSpacingToCss(a.characterSpacing);
-	if (spacing) styles.push(`letter-spacing:${spacing}`);
-	if (a.highlight) {
-		const hl = normalizeColorToHex(typeof a.highlight === "string" ? a.highlight : null);
-		if (hl) styles.push(`background-color:${hl}`, `color:contrast-color(${hl})`);
-	}
-	return styles;
-}
-/**
-* Compute table cell CSS styles from nested attrs.
-* Shared by TableCell and TableHeader extensions.
-*/
-function renderTableCellStyles(attrs) {
-	const a = attrs;
-	const styles = [];
-	if (a.noWrap) styles.push("white-space:nowrap");
-	const bg = shadingToCss(a.shading);
-	if (bg) styles.push(`background-color:${bg}`, `color:contrast-color(${bg})`);
-	if (a.verticalAlign) styles.push(`vertical-align:${a.verticalAlign}`);
-	return styles;
-}
-/** Parse text-align → OOXML alignment. */
-function alignmentFromElement(el) {
-	return alignmentFromCss(el.style.textAlign || null);
-}
-/** Parse margin-left/right + text-indent → OOXML indent (twips). */
-function indentFromElement(el) {
-	const indent = {};
-	const left = cssToTwip(el.style.marginLeft);
-	if (left) indent.left = left;
-	const right = cssToTwip(el.style.marginRight);
-	if (right) indent.right = right;
-	const ti = el.style.textIndent;
-	if (ti) if (ti.startsWith("-")) {
-		const h = cssToTwip(ti.slice(1));
-		if (h) indent.hanging = h;
-	} else {
-		const f = cssToTwip(ti);
-		if (f) indent.firstLine = f;
-	}
-	return Object.keys(indent).length > 0 ? indent : null;
-}
-/** Parse margin-top/bottom + line-height → OOXML spacing (twips). */
-function spacingFromElement(el) {
-	const spacing = {};
-	const before = cssToTwip(el.style.marginTop);
-	if (before) spacing.before = before;
-	const after = cssToTwip(el.style.marginBottom);
-	if (after) spacing.after = after;
-	const lh = el.style.lineHeight;
-	if (lh) {
-		const m = lh.match(/^([\d.]+)(pt|px)?$/);
-		if (m) {
-			const num = parseFloat(m[1]);
-			if (m[2]) {
-				spacing.line = Math.round(num * (m[2] === "px" ? 15 : 20));
-				spacing.lineRule = "exact";
-			} else {
-				spacing.line = Math.round(num * 240);
-				spacing.lineRule = "auto";
-			}
-		}
-	}
-	return Object.keys(spacing).length > 0 ? spacing : null;
-}
-/** Parse border-* → OOXML BordersOptions. */
-function bordersFromElement(el) {
-	const borders = {};
-	const sides = [
-		["top", el.style.borderTop],
-		["bottom", el.style.borderBottom],
-		["left", el.style.borderLeft],
-		["right", el.style.borderRight]
-	];
-	for (const [side, css] of sides) {
-		if (!css || css === "initial" || css === "none") continue;
-		const m = css.match(/^(none|solid|dashed|dotted|double)\s+([\d.]+pt)\s+(.+)$/);
-		if (!m) continue;
-		borders[side] = {
-			style: {
-				solid: "single",
-				dashed: "dashed",
-				dotted: "dotted",
-				double: "double"
-			}[m[1]] ?? "single",
-			size: Math.round(parseFloat(m[2]) * 8),
-			color: m[3]
-		};
-	}
-	return Object.keys(borders).length > 0 ? borders : null;
-}
-/** Parse background-color → OOXML shading. */
-function shadingFromElement(el) {
-	return shadingFromCss(el.style.backgroundColor || null);
-}
-//#endregion
-export { twipToCss as S, shadingFromElement as _, characterSpacingFromCss as a, sizeToCss as b, indentFromElement as c, renderBorderCSS as d, renderParagraphStyles as f, shadingFromCss as g, resolveFontName as h, bordersFromElement as i, lineSpacingToCss as l, renderTableCellStyles as m, alignmentFromElement as n, characterSpacingToCss as o, renderRunStyles as p, alignmentToCss as r, cssToTwip as s, alignmentFromCss as t, normalizeColorToHex as u, shadingToCss as v, spacingFromElement as x, sizeFromCss as y };