@office-kit/pptx-preview 0.6.2 → 0.8.0

package/dist/{src-CVYeIBFN.js → src-D95l1T9U.js}

@@ -1,4 +1,4 @@
-import { getEffectiveColorMap, getGroupChildren, getGroupTransform, getParagraphAlignment, getParagraphBullet, getParagraphBulletImageBytes, getParagraphBulletStyle, getParagraphIndent, getParagraphLevel, getParagraphPropertiesEffective, getParagraphSpacing, getPresentationFonts, getPresentationTheme, getShapeAdjustValues, getShapeAltTitle, getShapeBodyPrEffective, getShapeBoundsResolved, getShapeChartSpec, getShapeClickAction, getShapeCustomGeometry, getShapeDescription, getShapeEffectsEffective, getShapeFillColorResolved, getShapeFillEffective, getShapeFlip, getShapeGradientFill, getShapeGradientFillEffective, getShapeHyperlink, getShapeHyperlinkTooltip, getShapeImageBiLevelThreshold, getShapeImageBrightness, getShapeImageBytes, getShapeImageContrast, getShapeImageCrop, getShapeImageDuotone, getShapeImageFillBytes, getShapeImageFormat, getShapeImageLinkUrl, getShapeImageOpacity, getShapeImagePartName, getShapeKind, getShapeName, getShapeParagraphCount, getShapeParagraphElements, getShapePatternFill, getShapePlaceholderType, getShapePreset, getShapeRotation, getShapeRunClickAction, getShapeRunFormat, getShapeRunFormatEffective, getShapeRunHyperlink, getShapeRunHyperlinkTooltip, getShapeStrokeArrow, getShapeStrokeCap, getShapeStrokeColorResolved, getShapeStrokeCompound, getShapeStrokeDash, getShapeStrokeEffective, getShapeStrokeJoin, getShapeTextAnchor, getShapeTextAutoFitParams, getShapeTextBodyRotationDeg, getShapeTextColumns, getShapeTextDirection, getShapeTextMargins, getShapeXmlString, getSlideBackground, getSlideBackgroundGradientFill, getSlideBackgroundImageBytes, getSlideBackgroundPatternFill, getSlideIndex, getSlideLayout, getSlideLayoutBackground, getSlideLayoutBackgroundGradientFill, getSlideLayoutBackgroundImageBytes, getSlideLayoutBackgroundPatternFill, getSlideLayoutShapes, getSlideMasterBackground, getSlideMasterBackgroundGradientFill, getSlideMasterBackgroundImageBytes, getSlideMasterBackgroundPatternFill, getSlideMasterShapes, getSlideShapes, getSlideSize, getTableCellAnchor, getTableCellBorders, getTableCellFill, getTableCellMargins, getTableCellParagraphs, getTableCellSpan, getTableCells, getTableColumnWidths, getTableDimensions, getTableRowHeights, getTableStyleFlags, isChartShape, isParagraphBulletPicture, isShapeImageGrayscale, isShapePlaceholder, isShapeTextBox, isTableShape, resolveDeckBodyTextColor } from "@office-kit/pptx";
+import { getEffectiveColorMap, getGroupChildren, getGroupTransform, getParagraphAlignment, getParagraphBullet, getParagraphBulletImageBytes, getParagraphBulletStyle, getParagraphIndent, getParagraphLevel, getParagraphPropertiesEffective, getParagraphSpacing, getPresentationFonts, getPresentationTheme, getShapeAdjustValues, getShapeAltTitle, getShapeBodyPrEffective, getShapeBoundsResolved, getShapeChartSpec, getShapeClickAction, getShapeCustomGeometry, getShapeDescription, getShapeEffectsEffective, getShapeFillColorResolved, getShapeFillEffective, getShapeFlip, getShapeGradientFill, getShapeGradientFillEffective, getShapeHyperlink, getShapeHyperlinkTooltip, getShapeImageBiLevelThreshold, getShapeImageBrightness, getShapeImageBytes, getShapeImageContrast, getShapeImageCrop, getShapeImageDuotone, getShapeImageFillBytes, getShapeImageFormat, getShapeImageLinkUrl, getShapeImageOpacity, getShapeImagePartName, getShapeKind, getShapeName, getShapeParagraphCount, getShapeParagraphElements, getShapePatternFill, getShapePlaceholderType, getShapePreset, getShapeRotation, getShapeRunClickAction, getShapeRunFormat, getShapeRunFormatEffective, getShapeRunHyperlink, getShapeRunHyperlinkTooltip, getShapeStrokeArrow, getShapeStrokeCap, getShapeStrokeColorResolved, getShapeStrokeCompound, getShapeStrokeDash, getShapeStrokeEffective, getShapeStrokeJoin, getShapeTextAnchor, getShapeTextAutoFitParams, getShapeTextBodyRotationDeg, getShapeTextColumns, getShapeTextDirection, getShapeTextMargins, getShapeXmlString, getSlideBackground, getSlideBackgroundGradientFill, getSlideBackgroundImageBytes, getSlideBackgroundPatternFill, getSlideIndex, getSlideLayout, getSlideLayoutBackground, getSlideLayoutBackgroundGradientFill, getSlideLayoutBackgroundImageBytes, getSlideLayoutBackgroundPatternFill, getSlideLayoutShapes, getSlideMasterBackground, getSlideMasterBackgroundGradientFill, getSlideMasterBackgroundImageBytes, getSlideMasterBackgroundPatternFill, getSlideMasterShapes, getSlideShapes, getSlideSize, getSlides, getTableCellAnchor, getTableCellBorders, getTableCellFill, getTableCellMargins, getTableCellParagraphs, getTableCellSpan, getTableCells, getTableColumnWidths, getTableDimensions, getTableRowHeights, getTableStyleFlags, isChartShape, isParagraphBulletPicture, isShapeImageGrayscale, isShapePlaceholder, isShapeTextBox, isTableShape, resolveDeckBodyTextColor } from "@office-kit/pptx";
 //#region src/text-layout.ts
 const SANS = "Carlito";
 const SERIF = "Caladea";
@@ -91,7 +91,8 @@ const layoutCore = (input, measure) => {
 	const buildLines = (contentLeft, contentRight) => {
 		const lines = [];
 		let cursorY = 0;
-		for (const para of input.paragraphs) {
+		for (let paraIndex = 0; paraIndex < input.paragraphs.length; paraIndex++) {
+			const para = input.paragraphs[paraIndex];
 			cursorY += para.spcBefPx;
 			const wrapLeft = contentLeft + para.marLpx;
 			const wrapRight = contentRight - para.marRpx;
@@ -154,6 +155,7 @@ const layoutCore = (input, measure) => {
 				const lineLeft = bullet ? Math.max(wrapLeft, firstLeft + bulletLead) : (isFirst ? firstLeft : wrapLeft) + bulletLead;
 				const line = {
 					tokens: toks,
+					paraIndex,
 					ascent,
 					descent,
 					lineGap,
@@ -1917,7 +1919,7 @@ const buildSvgTextInput = (a) => {
 					underline: fmt?.underline ?? true
 				};
 			}
-			const family = substituteFamily(fmt?.font ?? a.themeFace);
+			const family = (a.resolveFamily ?? substituteFamily)(fmt?.font ?? a.themeFace);
 			const sizePx = run.sizePt * scale * PX_PER_PT;
 			const fillHex = fmt?.color !== void 0 && fmt.color !== null ? resolveColor(fmt.color, a.theme, "#000000") : a.defaultColor;
 			const superSub = fmt?.baseline !== void 0 && fmt.baseline !== 0 ? fmt.baseline > 0 ? 1 : -1 : 0;
@@ -2018,7 +2020,7 @@ const buildBullet = (a, para, pi) => {
 	const fillHex = para.bulletDetail.color ? resolveColor(para.bulletDetail.color, a.theme, "#000000") : a.defaultColor;
 	return {
 		text: char,
-		family: substituteFamily(para.bulletDetail.font ?? DEFAULT_BULLET_FONT),
+		family: (a.resolveFamily ?? substituteFamily)(para.bulletDetail.font ?? DEFAULT_BULLET_FONT),
 		sizePx,
 		fillHex,
 		...para.bulletImageHref ? { imageHref: para.bulletImageHref } : {}
@@ -2059,14 +2061,14 @@ const presetTextRect = (preset) => {
 		default: return null;
 	}
 };
-const renderTextBody = (pres, shape, bounds, theme, phType, ctx) => {
+const resolveTextBodyModel = (pres, shape, bounds, theme, phType, measure, defaultColor) => {
 	let paragraphCount;
 	try {
 		paragraphCount = getShapeParagraphCount(shape);
 	} catch {
-		return "";
+		return null;
 	}
-	if (paragraphCount === 0) return "";
+	if (paragraphCount === 0) return null;
 	const defaultPt = placeholderDefaultPt(phType);
 	const themeFonts = getPresentationFonts(pres);
 	const themeFace = phType === "title" || phType === "ctrTitle" ? themeFonts?.majorLatin ?? null : themeFonts?.minorLatin ?? null;
@@ -2111,7 +2113,7 @@ const renderTextBody = (pres, shape, bounds, theme, phType, ctx) => {
 		innerW = rectW;
 		innerH = rectH;
 	}
-	if (innerW <= 0 || innerH <= 0) return "";
+	if (innerW <= 0 || innerH <= 0) return null;
 	const svgTextRect = (v) => v === "none" || v === "upright" ? {
 		x: innerX,
 		y: innerY,
@@ -2249,7 +2251,7 @@ const renderTextBody = (pres, shape, bounds, theme, phType, ctx) => {
 			indent
 		});
 	}
-	if (!hasAnyText) return "";
+	if (!hasAnyText) return null;
 	const authoredAutofit = getShapeTextAutoFitParams(shape);
 	let autoFitScale = authoredAutofit?.fontScale ?? 1;
 	let lineHeightScale = 1 - (authoredAutofit?.lnSpcReduction ?? 0);
@@ -2320,14 +2322,14 @@ const renderTextBody = (pres, shape, bounds, theme, phType, ctx) => {
 			lineHeightScale,
 			defaultPt,
 			themeFace,
-			defaultColor: activeDeckTextColor,
+			defaultColor,
 			anchor: anchor === "center" || anchor === "bottom" ? anchor : "top",
 			wrap: effectiveBody.wrap !== "none",
 			innerX: fitRect.x,
 			innerY: fitRect.y,
 			innerW: fitRect.w,
 			innerH: fitRect.h,
-			measure: ctx.measure,
+			measure,
 			vert: fitVert,
 			columns: fitColumns
 		};
@@ -2336,11 +2338,33 @@ const renderTextBody = (pres, shape, bounds, theme, phType, ctx) => {
 			if (measureTextBodyHeight(buildSvgTextInput({
 				...fitArgsBase,
 				autoFitScale: s
-			}), ctx.measure) <= fitBoxPx) break;
+			}), measure) <= fitBoxPx) break;
 			s -= AUTOFIT_STEP;
 		}
 		autoFitScale = Math.max(AUTOFIT_FLOOR, s);
 	}
+	return {
+		paraData,
+		numberLabels,
+		authoredAutofit,
+		autoFitScale,
+		lineHeightScale,
+		defaultPt,
+		themeFace,
+		effectiveDefaultFont,
+		effectiveBody,
+		anchor,
+		innerX,
+		innerY,
+		innerW,
+		innerH,
+		svgTextRect
+	};
+};
+const renderTextBody = (pres, shape, bounds, theme, phType, ctx) => {
+	const model = resolveTextBodyModel(pres, shape, bounds, theme, phType, ctx.measure, activeDeckTextColor);
+	if (model === null) return "";
+	const { paraData, numberLabels, authoredAutofit, autoFitScale, defaultPt, themeFace, effectiveDefaultFont, effectiveBody, anchor, innerX, innerY, innerW, innerH, svgTextRect } = model;
 	const paragraphs = [];
 	for (let pi = 0; pi < paraData.length; pi++) {
 		const para = paraData[pi];
@@ -4318,6 +4342,27 @@ const buildEffectsFilter = (pres, shape) => {
 		defs: `<defs><filter id="${id}" x="-25%" y="-25%" width="150%" height="150%">${primitives.join("")}</filter></defs>`
 	};
 };
+const flattenedDescendantCount = (group, dropPlaceholders) => {
+	let count = 0;
+	for (const child of getGroupChildren(group)) {
+		if (!dropPlaceholders || !isShapePlaceholder(child)) count += 1;
+		if (getShapeKind(child) === "group") count += flattenedDescendantCount(child, dropPlaceholders);
+	}
+	return count;
+};
+const topLevelShapes = (shapes, opts) => {
+	const out = [];
+	let skip = 0;
+	for (const shape of shapes) {
+		if (skip > 0) {
+			skip -= 1;
+			continue;
+		}
+		out.push(shape);
+		if (getShapeKind(shape) === "group") skip = flattenedDescendantCount(shape, opts.dropPlaceholders);
+	}
+	return out;
+};
 const renderSlideSvg = (pres, slide, opts = {}) => {
 	const size = getSlideSize(pres) ?? DEFAULT_SIZE;
 	const W = size.width;
@@ -4393,13 +4438,13 @@ const renderSlideSvg = (pres, slide, opts = {}) => {
 	let layoutBgShapes = "";
 	const layoutForBg = getSlideLayout(slide);
 	if (layoutForBg) try {
-		const masterShapes = getSlideMasterShapes(pres, layoutForBg);
-		const layoutShapes = getSlideLayoutShapes(pres, layoutForBg);
+		const masterShapes = topLevelShapes(getSlideMasterShapes(pres, layoutForBg), { dropPlaceholders: true });
+		const layoutShapes = topLevelShapes(getSlideLayoutShapes(pres, layoutForBg), { dropPlaceholders: true });
 		layoutBgShapes = [...masterShapes, ...layoutShapes].map((s) => renderShape(s, pres, theme, ctx)).join("");
 	} catch {
 		layoutBgShapes = "";
 	}
-	const shapesSvg = getSlideShapes(slide).map((s) => renderShape(s, pres, theme, ctx)).join("");
+	const shapesSvg = topLevelShapes(getSlideShapes(slide), { dropPlaceholders: false }).map((s) => renderShape(s, pres, theme, ctx)).join("");
 	return [
 		`<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 ${E(W)} ${E(H)}" preserveAspectRatio="xMidYMid meet">`,
 		bgGradientDefs,
@@ -4421,6 +4466,156 @@ const detectImageFormatLocal = (bytes) => {
 	return null;
 };
 //#endregion
-export { SERIF as a, substituteFamily as c, SANS as i, ARIAL as n, TIMES as o, MONO as r, defaultMeasurer as s, renderSlideSvg as t };
+//#region src/audit.ts
+const DEFAULT_TOLERANCE_PX = 1;
+const round2 = (n) => Math.round(n * 100) / 100;
+function* walkShapes(shapes) {
+	for (const shape of shapes) if (getShapeKind(shape) !== "group") yield shape;
+}
+const passthroughFamily = (family) => family ?? "Carlito";
+const auditShape = (pres, theme, shape, slideIndex, measure, tolerancePx, reportSoftWraps, issues) => {
+	const kind = getShapeKind(shape);
+	if (kind !== "shape" && kind !== "graphicFrame") return;
+	const bounds = getShapeBoundsResolved(pres, shape);
+	if (!bounds) return;
+	const model = resolveTextBodyModel(pres, shape, {
+		x: bounds.x,
+		y: bounds.y,
+		w: bounds.w,
+		h: bounds.h
+	}, theme, getShapePlaceholderType(shape), measure, "#000000");
+	if (model === null) return;
+	const vert = verticalLayoutOf(model.effectiveBody.vert ?? getShapeTextDirection(shape));
+	const cols = getShapeTextColumns(shape);
+	const columns = vert === "none" && cols && cols.count >= 2 ? {
+		count: cols.count,
+		gapPx: cols.gapEmu !== void 0 ? cols.gapEmu / EMU_PER_PX : 12
+	} : null;
+	const rect = model.svgTextRect(vert);
+	if (rect.w <= 0 || rect.h <= 0) return;
+	const autoFitScale = model.authoredAutofit ? model.autoFitScale : 1;
+	const input = buildSvgTextInput({
+		pres,
+		shape,
+		theme,
+		paraData: model.paraData,
+		numberLabels: model.numberLabels,
+		autoFitScale,
+		lineHeightScale: model.lineHeightScale,
+		defaultPt: model.defaultPt,
+		themeFace: model.themeFace,
+		defaultColor: "#000000",
+		anchor: model.anchor,
+		wrap: model.effectiveBody.wrap !== "none",
+		innerX: rect.x,
+		innerY: rect.y,
+		innerW: rect.w,
+		innerH: rect.h,
+		measure,
+		vert,
+		columns,
+		resolveFamily: passthroughFamily
+	});
+	const core = layoutCore(input, measure);
+	const frame = vert === "cw90" || vert === "cw270" ? {
+		x: input.boxXpx + input.boxWpx / 2 - input.boxHpx / 2,
+		y: input.boxYpx + input.boxHpx / 2 - input.boxWpx / 2,
+		w: input.boxHpx,
+		h: input.boxWpx
+	} : {
+		x: input.boxXpx,
+		y: input.boxYpx,
+		w: input.boxWpx,
+		h: input.boxHpx
+	};
+	let inkTop = Infinity;
+	let inkBottom = -Infinity;
+	let overflowX = 0;
+	let anyInk = false;
+	for (const p of core.placements) {
+		const toks = [...p.line.tokens];
+		while (toks.length > 0 && (toks[toks.length - 1].isSpace || toks[toks.length - 1].isBreak)) toks.pop();
+		if (!toks.some((t) => !t.isSpace && !t.isBreak)) continue;
+		anyInk = true;
+		let lineW = 0;
+		for (const t of toks) if (!t.isBreak) lineW += t.width;
+		const left = p.line.textAnchor === "middle" ? p.line.anchorX - lineW / 2 : p.line.textAnchor === "end" ? p.line.anchorX - lineW : p.line.anchorX;
+		const over = Math.max(frame.x - (left + p.dx), left + p.dx + lineW - (frame.x + frame.w));
+		if (over > overflowX) overflowX = over;
+		inkTop = Math.min(inkTop, p.baselineY - p.line.ascent);
+		inkBottom = Math.max(inkBottom, p.baselineY + p.line.descent);
+	}
+	if (!anyInk) return;
+	const approximate = detectApproximate(input.paragraphs, measure);
+	const slideRef = {
+		slideIndex,
+		shapeName: getShapeName(shape),
+		approximate
+	};
+	if (overflowX > tolerancePx) issues.push({
+		...slideRef,
+		kind: "overflow-x",
+		overflowPx: round2(overflowX)
+	});
+	const overflowY = Math.max(frame.y - inkTop, inkBottom - (frame.y + frame.h));
+	if (overflowY > tolerancePx) issues.push({
+		...slideRef,
+		kind: "overflow-y",
+		overflowPx: round2(overflowY)
+	});
+	if (reportSoftWraps && vert === "none") {
+		const lineCounts = /* @__PURE__ */ new Map();
+		for (const p of core.placements) lineCounts.set(p.line.paraIndex, (lineCounts.get(p.line.paraIndex) ?? 0) + 1);
+		input.paragraphs.forEach((para, pi) => {
+			const breaks = para.pieces.reduce((n, pc) => n + (pc.isBreak ? 1 : 0), 0);
+			const extraLines = (lineCounts.get(pi) ?? 0) - 1 - breaks;
+			if (extraLines > 0) issues.push({
+				...slideRef,
+				kind: "soft-wrap",
+				paragraphIndex: pi,
+				extraLines
+			});
+		});
+	}
+};
+const detectApproximate = (paragraphs, measure) => {
+	const seen = /* @__PURE__ */ new Set();
+	for (const para of paragraphs) for (const piece of para.pieces) {
+		if (piece.isBreak || piece.text === "") continue;
+		const key = `${piece.family}|${piece.sizePx}|${piece.bold}|${piece.italic}|${piece.text}`;
+		if (seen.has(key)) continue;
+		seen.add(key);
+		const spec = {
+			family: piece.family,
+			sizePx: piece.sizePx,
+			bold: piece.bold,
+			italic: piece.italic,
+			letterSpacingPx: piece.letterSpacingPx
+		};
+		const r = measure(piece.text, spec);
+		if (r.approximate === true || r.ascentPx === void 0) return true;
+	}
+	return false;
+};
+/**
+* Measures every text body in the deck and reports text that escapes its box
+* (`overflow-x` / `overflow-y`) and, opt-in, paragraphs that soft-wrap
+* (`soft-wrap`, 段落ち).
+*
+* Table cell text is not audited (v1 covers shape text bodies, including
+* placeholders and shapes inside groups).
+*/
+const auditTextLayout = (pres, options = {}) => {
+	const measure = options.measureText ?? defaultMeasurer;
+	const tolerancePx = options.tolerancePx ?? DEFAULT_TOLERANCE_PX;
+	const reportSoftWraps = options.reportSoftWraps ?? false;
+	const theme = getPresentationTheme(pres);
+	const issues = [];
+	const slides = getSlides(pres);
+	for (let slideIndex = 0; slideIndex < slides.length; slideIndex++) for (const shape of walkShapes(getSlideShapes(slides[slideIndex]))) auditShape(pres, theme, shape, slideIndex, measure, tolerancePx, reportSoftWraps, issues);
+	return issues;
+};
+//#endregion
+export { MONO as a, TIMES as c, substituteFamily as d, AVG_GLYPH_W_RATIO$1 as i, defaultMeasurer as l, renderSlideSvg as n, SANS as o, ARIAL as r, SERIF as s, auditTextLayout as t, isCjk as u };
 
-//# sourceMappingURL=src-CVYeIBFN.js.map
+//# sourceMappingURL=src-D95l1T9U.js.map