@cola1900/dsh-ppt 0.1.2

package/lib/pptd-2VqVzr_T.js

@@ -0,0 +1,2173 @@
+const MISPLACED_TEXT_STYLE_FIELDS = new Set(["fontFamily", "fontSize", "bold", "italic", "color", "lineHeight", "letterSpacing", "wrap", "align", "verticalAlign", "textDirection", "style"]);
+import { wrapTextLines } from "./text-wrap.js";
+import { lstat, readFile, readdir, realpath } from "node:fs/promises";
+import path from "node:path";
+import { createHash } from "node:crypto";
+import yaml from "js-yaml";
+import PptxGenJSImport from "pptxgenjs";
+//#region lib/types/pptd-colors.js
+/** Shared PPTD color normalization used by checking, preview, and PPTX export. */
+/** Deterministic series palette used when a chart series omits an explicit color. */
+const PPTD_CHART_SERIES_PALETTE = [
+	"#2563EB",
+	"#F59E0B",
+	"#10B981",
+	"#EF4444",
+	"#8B5CF6",
+	"#06B6D4"
+];
+function record$1(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function themeColors(project) {
+	return record$1(project.theme.colors) ?? {};
+}
+/** Resolve a literal or theme-referenced PPTD color without applying a silent fallback. */
+function resolvePptdColor(project, value) {
+	let current = value;
+	const colors = themeColors(project);
+	for (let depth = 0; depth < 8 && typeof current === "string" && current.startsWith("$"); depth += 1) current = colors[current.slice(1)];
+	return typeof current === "string" && /^#[0-9a-f]{6}(?:[0-9a-f]{2})?$/iu.test(current) ? current : void 0;
+}
+/**
+* Normalize chart-series colors from either color scalars or solid paint objects.
+* Pie series may supply an array; unsupported paints and invalid colors return undefined.
+*/
+function resolvePptdChartSeriesColors(project, value) {
+	if (value === void 0) return void 0;
+	const values = Array.isArray(value) ? value : [value];
+	if (values.length === 0) return void 0;
+	const resolved = values.map((item) => {
+		const paint = record$1(item);
+		return resolvePptdColor(project, paint === void 0 ? item : paint.type === "solid" ? paint.color : void 0);
+	});
+	return resolved.every((item) => item !== void 0) ? resolved : void 0;
+}
+//#endregion
+//#region lib/types/text-layout.js
+/** Deterministic text-box capacity estimates shared by template references and PPT renderers. */
+const WIDTH_RESERVE = .95;
+const DEFAULT_LINE_HEIGHT = 1.15;
+function positive(value, fallback) {
+	return value !== void 0 && Number.isFinite(value) && value > 0 ? value : fallback;
+}
+function glyphWidth(character) {
+	if (/\p{Mark}/u.test(character)) return 0;
+	if (/\s/u.test(character)) return .33;
+	if (/^[ilI1|.,'`:;!]$/u.test(character)) return .3;
+	if (/^[mwMW@%&]$/u.test(character)) return .82;
+	if (/^[A-Z]$/u.test(character)) return .68;
+	if (/^[\u0000-\u00ff]$/u.test(character)) return .56;
+	if (/\p{Extended_Pictographic}/u.test(character)) return 1;
+	return 1;
+}
+function lineWidth(text, fontSize, letterSpacing, bold) {
+	const characters = Array.from(text);
+	const glyphs = characters.reduce((sum, character) => sum + glyphWidth(character), 0);
+	const spacing = Math.max(0, characters.length - 1) * letterSpacing;
+	return glyphs * fontSize * (bold ? 1.04 : 1) + spacing;
+}
+/**
+* Estimate native text wrapping while retaining the authored font size.
+* @param input - Text, box geometry, and effective text style in PowerPoint points.
+* @returns Estimated line use and overflow state.
+*/
+function measureTextLayout(input) {
+	const fontSize = positive(input.fontSize, 18);
+	const lineHeight = positive(input.lineHeight, DEFAULT_LINE_HEIGHT);
+	const letterSpacing = typeof input.letterSpacing === "number" && Number.isFinite(input.letterSpacing) ? input.letterSpacing : 0;
+	const availableLineWidth = Math.max(0, input.width) * WIDTH_RESERVE;
+	const paragraphWidths = input.text.length === 0 ? [] : input.text.split("\n").map((line) => lineWidth(line, fontSize, letterSpacing, input.bold === true));
+	const widestLine = Math.max(0, ...paragraphWidths);
+	const wrap = input.wrap !== false;
+	const lineCount = input.text.length === 0 ? 0 : wrapTextLines(input.text, availableLineWidth, text => lineWidth(text, fontSize, letterSpacing, input.bold === true), wrap).length;
+	const requiredHeight = lineCount * fontSize * lineHeight;
+	const maxLineCount = Math.max(0, Math.floor(Math.max(0, input.height) / (fontSize * lineHeight)));
+	const horizontalOverflow = !wrap && widestLine > availableLineWidth;
+	return {
+		lineCount,
+		maxLineCount,
+		requiredHeight,
+		availableLineWidth,
+		widestLine,
+		horizontalOverflow,
+		overflow: horizontalOverflow || lineCount > maxLineCount
+	};
+}
+/**
+* Derive a conservative full-width character budget for an empty text region.
+* @param width - Text-region width in PowerPoint points.
+* @param height - Text-region height in PowerPoint points.
+* @param fontSize - Intended font size in points.
+* @param lineHeight - Line-height multiplier.
+* @returns Recommended full-width character count.
+*/
+function recommendedTextCapacity(width, height, fontSize, lineHeight = DEFAULT_LINE_HEIGHT) {
+	const size = positive(fontSize, 18);
+	const spacing = positive(lineHeight, DEFAULT_LINE_HEIGHT);
+	const charactersPerLine = Math.max(1, Math.floor(Math.max(0, width) * WIDTH_RESERVE / size));
+	const lines = Math.max(1, Math.floor(Math.max(0, height) / (size * spacing)));
+	return Math.max(1, Math.min(1e3, Math.floor(charactersPerLine * lines * .9)));
+}
+//#endregion
+//#region lib/types/pptd.js
+/** Local PPTD v2 parser, checker, loader, and native editable PPTX renderer. */
+const PptxGenJS = typeof PptxGenJSImport === "function" ? PptxGenJSImport : PptxGenJSImport.default;
+const POINTS_PER_INCH = 72;
+const MAX_MANIFEST_BYTES = 512 * 1024;
+const MAX_PAGE_BYTES = 2 * 1024 * 1024;
+const MAX_ASSET_BYTES = 32 * 1024 * 1024;
+const MAX_TOTAL_ASSET_BYTES = 256 * 1024 * 1024;
+const MAX_PAGES = 200;
+const MAX_ELEMENTS_PER_PAGE = 2e3;
+function record(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function string(value) {
+	return typeof value === "string" ? value : void 0;
+}
+function number(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function boolean(value) {
+	return typeof value === "boolean" ? value : void 0;
+}
+const NATIVE_CHART_TYPES = new Set([
+	"bar",
+	"line",
+	"area",
+	"scatter",
+	"bubble",
+	"pie",
+	"radar"
+]);
+const UNSUPPORTED_CHART_TYPES = new Set([
+	"candlestick",
+	"waterfall",
+	"heatmap",
+	"treemap",
+	"sunburst",
+	"sankey"
+]);
+const NATIVE_SHAPE_NAMES = new Set(Object.values(new PptxGenJS().ShapeType));
+const MANIFEST_FIELDS = new Set([
+	"version",
+	"title",
+	"size",
+	"template",
+	"theme",
+	"pages"
+]);
+const TEMPLATE_FIELDS = new Set([
+	"id",
+	"name",
+	"sourceFile",
+	"sourceSha256"
+]);
+const PAGE_FIELDS = new Set([
+	"pageType",
+	"templateReference",
+	"background",
+	"notes",
+	"elements"
+]);
+const TEMPLATE_REFERENCE_FIELDS = new Set([
+	"sourceSlideNumber",
+	"rationale",
+	"contentRelationship"
+]);
+const TEMPLATE_RELATIONSHIPS = new Set([
+	"statement",
+	"independent",
+	"comparison",
+	"process",
+	"timeline",
+	"overlap",
+	"data",
+	"generic"
+]);
+const ELEMENT_BASE_FIELDS = [
+	"elementId",
+	"elementType",
+	"bounds"
+];
+const ELEMENT_FIELDS = {
+	text: new Set([
+		...ELEMENT_BASE_FIELDS,
+		"rotation",
+		"opacity",
+		"flip",
+		"content"
+	]),
+	shape: new Set([
+		...ELEMENT_BASE_FIELDS,
+		"rotation",
+		"opacity",
+		"flip",
+		"shapeName",
+		"adjustments",
+		"viewBox",
+		"path",
+		"fill",
+		"border",
+		"shadow"
+	]),
+	line: new Set([
+		...ELEMENT_BASE_FIELDS,
+		"rotation",
+		"opacity",
+		"flip",
+		"viewBox",
+		"points",
+		"curve",
+		"arrow",
+		"border",
+		"shadow"
+	]),
+	image: new Set([
+		...ELEMENT_BASE_FIELDS,
+		"rotation",
+		"opacity",
+		"flip",
+		"src",
+		"cropShape",
+		"fit",
+		"crop",
+		"border",
+		"shadow"
+	]),
+	icon: new Set([
+		...ELEMENT_BASE_FIELDS,
+		"rotation",
+		"opacity",
+		"flip",
+		"iconName",
+		"color",
+		"fill",
+		"border",
+		"shadow"
+	]),
+	table: new Set([
+		...ELEMENT_BASE_FIELDS,
+		"columnWidths",
+		"rowHeights",
+		"rows",
+		"style",
+		"fill",
+		"shadow"
+	]),
+	chart: new Set([
+		...ELEMENT_BASE_FIELDS,
+		"data",
+		"series",
+		"seriesDefaults",
+		"xAxis",
+		"yAxis",
+		"barWidth",
+		"barGap",
+		"categoryGap",
+		"spokeAxis",
+		"title",
+		"legend",
+		"dataLabels",
+		"fontFamily",
+		"fill",
+		"border",
+		"shadow"
+	])
+};
+function unknownFields(value, allowed) {
+	return Object.keys(value).filter((key) => !allowed.has(key));
+}
+function compatibilitySummary(project) {
+	const summary = {
+		native: 0,
+		normalized: 0,
+		vectorFallback: 0,
+		rasterFallback: 0,
+		unsupported: 0
+	};
+	const recordLevel = (level) => {
+		if (level === "native") summary.native += 1;
+		else if (level === "normalized") summary.normalized += 1;
+		else if (level === "vector-fallback") summary.vectorFallback += 1;
+		else if (level === "raster-fallback") summary.rasterFallback += 1;
+		else summary.unsupported += 1;
+	};
+	for (const page of project.pages) for (const element of page.elements) {
+		const type = string(element.elementType);
+		if (type === "icon") {
+			recordLevel("normalized");
+			continue;
+		}
+		if (type === "shape" && element.shapeName === "custom") {
+			recordLevel("vector-fallback");
+			continue;
+		}
+		if (type === "line" && (string(element.curve) === "smooth" || (string(element.points)?.trim().split(/\s+/u).length ?? 0) > 2)) {
+			recordLevel("vector-fallback");
+			continue;
+		}
+		if (type === "image" && record(element.cropShape)?.shapeName === "custom") {
+			recordLevel("raster-fallback");
+			continue;
+		}
+		if (type === "chart") {
+			const chartTypes = (Array.isArray(element.series) ? element.series.map(record).filter((item) => item !== void 0) : []).map((item) => string(item.type)).filter((item) => item !== void 0);
+			if (chartTypes.some((item) => UNSUPPORTED_CHART_TYPES.has(item))) {
+				recordLevel("unsupported");
+				continue;
+			}
+			if (chartTypes.some((item) => !NATIVE_CHART_TYPES.has(item))) {
+				recordLevel("unsupported");
+				continue;
+			}
+		}
+		const fill = record(element.fill);
+		const content = record(element.content);
+		recordLevel(fill?.type === "gradient" || fill?.type === "image" || content?.gradient !== void 0 || content?.shadow !== void 0 || element.shadow !== void 0 || element.adjustments !== void 0 || element.crop !== void 0 || element.cropShape !== void 0 ? "normalized" : "native");
+	}
+	return summary;
+}
+function tuple(value, size) {
+	if (!Array.isArray(value) || value.length !== size) return void 0;
+	const values = value.map(number);
+	return values.every((item) => item !== void 0) ? values : void 0;
+}
+function safeProjectPath(value) {
+	if (value === "" || path.isAbsolute(value) || value.includes("\\")) return void 0;
+	const normalized = path.posix.normalize(value);
+	return normalized === ".." || normalized.startsWith("../") || normalized.startsWith("/") ? void 0 : normalized;
+}
+function parseYaml(content, file, issues) {
+	try {
+		const value = record(yaml.load(content, {
+			schema: yaml.JSON_SCHEMA,
+			json: true
+		}));
+		if (value !== void 0) return value;
+		issues.push({
+			code: "yaml-root",
+			severity: "error",
+			file,
+			message: `${file} 的 YAML 根节点必须是对象。`
+		});
+	} catch (error) {
+		issues.push({
+			code: "yaml-syntax",
+			severity: "error",
+			file,
+			message: `${file} 无法解析：${error instanceof Error ? error.message : String(error)}`
+		});
+	}
+}
+/** Parse a bounded in-memory PPTD v2 project into a renderer-independent AST. */
+function parsePptdProject(source) {
+	const issues = [...source.issues ?? []];
+	const manifest = parseYaml(source.manifest, source.entryName, issues) ?? {};
+	for (const field of unknownFields(manifest, MANIFEST_FIELDS)) issues.push({
+		code: "unknown-field",
+		severity: "error",
+		file: source.entryName,
+		message: `PPTD 包含未知字段 ${field}。`
+	});
+	if (manifest.version !== "v2") issues.push({
+		code: "version",
+		severity: "error",
+		file: source.entryName,
+		message: "PPTD version 必须为 v2。"
+	});
+	const size = tuple(manifest.size, 2);
+	const pageWidth = size?.[0];
+	const pageHeight = size?.[1];
+	if (pageWidth === void 0 || pageHeight === void 0 || pageWidth <= 0 || pageHeight <= 0) issues.push({
+		code: "page-size",
+		severity: "error",
+		file: source.entryName,
+		message: "PPTD size 必须是两个正数。"
+	});
+	const template = manifest.template === void 0 ? void 0 : record(manifest.template);
+	if (manifest.template !== void 0 && template === void 0) issues.push({
+		code: "template",
+		severity: "error",
+		file: source.entryName,
+		message: "PPTD template 必须是对象。"
+	});
+	if (template !== void 0) {
+		for (const field of unknownFields(template, TEMPLATE_FIELDS)) issues.push({
+			code: "unknown-field",
+			severity: "error",
+			file: source.entryName,
+			message: `PPTD template 包含未知字段 ${field}。`
+		});
+		if (typeof template.id !== "string" || typeof template.name !== "string") issues.push({
+			code: "template",
+			severity: "error",
+			file: source.entryName,
+			message: "PPTD template.id 和 template.name 必须是字符串。"
+		});
+		if (template.sourceFile !== void 0 && typeof template.sourceFile !== "string") issues.push({
+			code: "template",
+			severity: "error",
+			file: source.entryName,
+			message: "PPTD template.sourceFile 必须是字符串。"
+		});
+		if (template.sourceSha256 !== void 0 && (typeof template.sourceSha256 !== "string" || !/^[0-9a-f]{64}$/iu.test(template.sourceSha256))) issues.push({
+			code: "template",
+			severity: "error",
+			file: source.entryName,
+			message: "PPTD template.sourceSha256 必须是 SHA-256。"
+		});
+	}
+	const pageRefs = Array.isArray(manifest.pages) ? manifest.pages : [];
+	if (!Array.isArray(manifest.pages) || pageRefs.length === 0 || pageRefs.length > MAX_PAGES) issues.push({
+		code: "pages",
+		severity: "error",
+		file: source.entryName,
+		message: `PPTD pages 必须包含 1 到 ${MAX_PAGES} 个页面路径。`
+	});
+	const pages = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const [index, rawRef] of pageRefs.slice(0, MAX_PAGES).entries()) {
+		const ref = typeof rawRef === "string" ? safeProjectPath(rawRef) : void 0;
+		if (ref === void 0 || !ref.endsWith(".page")) {
+			issues.push({
+				code: "page-path",
+				severity: "error",
+				page: index + 1,
+				message: `第 ${index + 1} 个页面路径无效。`
+			});
+			continue;
+		}
+		if (seen.has(ref)) {
+			issues.push({
+				code: "duplicate-page",
+				severity: "error",
+				file: ref,
+				page: index + 1,
+				message: `页面 ${ref} 被重复引用。`
+			});
+			continue;
+		}
+		seen.add(ref);
+		const content = source.pages.get(ref);
+		if (content === void 0) {
+			issues.push({
+				code: "missing-page",
+				severity: "error",
+				file: ref,
+				page: index + 1,
+				message: `找不到页面文件 ${ref}。`
+			});
+			continue;
+		}
+		const parsed = parseYaml(content, ref, issues);
+		if (parsed === void 0) continue;
+		for (const field of unknownFields(parsed, PAGE_FIELDS)) issues.push({
+			code: "unknown-field",
+			severity: "error",
+			file: ref,
+			page: index + 1,
+			message: `页面包含未知字段 ${field}。`
+		});
+		const elements = Array.isArray(parsed.elements) ? parsed.elements.map(record).filter((item) => item !== void 0) : [];
+		if (!Array.isArray(parsed.elements) || elements.length > MAX_ELEMENTS_PER_PAGE) issues.push({
+			code: "elements",
+			severity: "error",
+			file: ref,
+			page: index + 1,
+			message: `页面 elements 必须是数组且不超过 ${MAX_ELEMENTS_PER_PAGE} 个元素。`
+		});
+		const background = record(parsed.background);
+		const templateReference = parsed.templateReference === void 0 ? void 0 : record(parsed.templateReference);
+		if (parsed.templateReference !== void 0 && templateReference === void 0) issues.push({
+			code: "template-reference",
+			severity: "error",
+			file: ref,
+			page: index + 1,
+			message: "页面 templateReference 必须是对象。"
+		});
+		if (templateReference !== void 0) {
+			for (const field of unknownFields(templateReference, TEMPLATE_REFERENCE_FIELDS)) issues.push({
+				code: "unknown-field",
+				severity: "error",
+				file: ref,
+				page: index + 1,
+				message: `页面 templateReference 包含未知字段 ${field}。`
+			});
+			if (!Number.isInteger(templateReference.sourceSlideNumber) || Number(templateReference.sourceSlideNumber) <= 0) issues.push({
+				code: "template-reference",
+				severity: "error",
+				file: ref,
+				page: index + 1,
+				message: "页面 templateReference.sourceSlideNumber 必须是正整数。"
+			});
+			if (typeof templateReference.rationale !== "string" || templateReference.rationale.trim() === "") issues.push({
+				code: "template-reference",
+				severity: "error",
+				file: ref,
+				page: index + 1,
+				message: "页面 templateReference.rationale 必须说明源页选择理由。"
+			});
+			if (templateReference.contentRelationship !== void 0 && (typeof templateReference.contentRelationship !== "string" || !TEMPLATE_RELATIONSHIPS.has(templateReference.contentRelationship))) issues.push({
+				code: "template-reference",
+				severity: "error",
+				file: ref,
+				page: index + 1,
+				message: "页面 templateReference.contentRelationship 必须是受支持的内容关系。"
+			});
+		}
+		for (const element of elements) {
+			const type = string(element.elementType);
+			const allowed = type === void 0 ? void 0 : ELEMENT_FIELDS[type];
+			if (allowed === void 0) continue;
+			for (const field of unknownFields(element, allowed)) issues.push({
+				code: type === "text" && MISPLACED_TEXT_STYLE_FIELDS.has(field) ? "misplaced-text-style" : "unknown-field",
+				severity: "error",
+				file: ref,
+				page: index + 1,
+				...typeof element.elementId === "string" ? { elementId: element.elementId } : {},
+				message: type === "text" && MISPLACED_TEXT_STYLE_FIELDS.has(field) ? `文本属性 ${field} 应放在 content 内，请修正 YAML 缩进。` : `元素包含未知字段 ${field}。`
+			});
+		}
+		pages.push({
+			file: ref,
+			...typeof parsed.pageType === "string" ? { pageType: parsed.pageType } : {},
+			...templateReference === void 0 || !Number.isInteger(templateReference.sourceSlideNumber) || typeof templateReference.rationale !== "string" ? {} : { templateReference: {
+				sourceSlideNumber: Number(templateReference.sourceSlideNumber),
+				rationale: templateReference.rationale,
+				...typeof templateReference.contentRelationship === "string" && TEMPLATE_RELATIONSHIPS.has(templateReference.contentRelationship) ? { contentRelationship: templateReference.contentRelationship } : {}
+			} },
+			...background === void 0 ? {} : { background },
+			notes: typeof parsed.notes === "string" ? parsed.notes : "",
+			elements: elements.slice(0, MAX_ELEMENTS_PER_PAGE)
+		});
+	}
+	return {
+		source,
+		title: typeof manifest.title === "string" ? manifest.title : path.basename(source.entryName, ".pptd"),
+		width: pageWidth ?? 960,
+		height: pageHeight ?? 540,
+		...template === void 0 ? {} : { template },
+		theme: record(manifest.theme) ?? {},
+		pages,
+		parseIssues: issues
+	};
+}
+function projectDigest(project) {
+	const hash = createHash("sha256").update(project.source.manifest);
+	for (const page of project.pages) hash.update(page.file).update(project.source.pages.get(page.file) ?? "");
+	for (const asset of [...project.source.assets.values()].sort((left, right) => left.path.localeCompare(right.path))) hash.update(asset.path).update(asset.sha256);
+	return hash.digest("hex");
+}
+function themeMap(project, key) {
+	return record(project.theme[key]) ?? {};
+}
+function themeReferenceIssue(project, value, mapName, file, page, elementId) {
+	if (typeof value !== "string" || !value.startsWith("$")) return void 0;
+	const key = value.slice(1);
+	if (key !== "" && key in themeMap(project, mapName)) return void 0;
+	return {
+		code: "invalid-theme",
+		severity: "error",
+		file,
+		...page === void 0 ? {} : { page },
+		...elementId === void 0 ? {} : { elementId },
+		message: `主题引用 ${value} 不存在于 theme.${mapName}。`
+	};
+}
+function colorThemeIssues(project, value, file, page, elementId) {
+	const issues = [];
+	const visited = /* @__PURE__ */ new WeakSet();
+	const visit = (current, field) => {
+		if (typeof current === "string") {
+			if (field === "color" || field === "backgroundColor" || field === "lineColor" || field === "areaColor" || field === "fill") {
+				const issue = themeReferenceIssue(project, current, "colors", file, page, elementId);
+				if (issue !== void 0) issues.push(issue);
+			}
+			return;
+		}
+		if (Array.isArray(current)) {
+			if (visited.has(current)) return;
+			visited.add(current);
+			for (const item of current) visit(item, field);
+			return;
+		}
+		const object = record(current);
+		if (object === void 0) return;
+		if (visited.has(object)) return;
+		visited.add(object);
+		for (const [key, child] of Object.entries(object)) visit(child, key === "fill" ? "fill" : key);
+	};
+	visit(value);
+	return issues;
+}
+function themeColorChainIssues(project) {
+	const colors = themeMap(project, "colors");
+	const issues = [];
+	const reportedCycles = /* @__PURE__ */ new Set();
+	const reportedInvalidTerminals = /* @__PURE__ */ new Set();
+	for (const start of Object.keys(colors)) {
+		const path = [];
+		let key = start;
+		while (true) {
+			const cycleIndex = path.indexOf(key);
+			if (cycleIndex >= 0) {
+				const cycle = path.slice(cycleIndex);
+				const signature = [...cycle].sort().join("\0");
+				if (!reportedCycles.has(signature)) {
+					reportedCycles.add(signature);
+					issues.push({
+						code: "invalid-theme",
+						severity: "error",
+						file: project.source.entryName,
+						message: `theme.colors 存在循环引用：${[...cycle, key].map((item) => `$${item}`).join(" -> ")}。`
+					});
+				}
+				break;
+			}
+			path.push(key);
+			const value = colors[key];
+			if (typeof value !== "string" || !value.startsWith("$")) {
+				if (key !== start && (typeof value !== "string" || !/^#[0-9a-f]{6}(?:[0-9a-f]{2})?$/iu.test(value))) {
+					if (!reportedInvalidTerminals.has(key)) {
+						reportedInvalidTerminals.add(key);
+						issues.push({
+							code: "invalid-theme",
+							severity: "error",
+							file: project.source.entryName,
+							message: `theme.colors.${start} 最终指向无效颜色 theme.colors.${key}。`
+						});
+					}
+				}
+				break;
+			}
+			const next = value.slice(1);
+			if (!(next in colors)) break;
+			key = next;
+		}
+	}
+	return issues;
+}
+function resolveThemeReference(value, map) {
+	if (typeof value !== "string" || !value.startsWith("$")) return value;
+	return map[value.slice(1)];
+}
+function resolveColorValue(project, value, fallback = "#000000") {
+	return resolvePptdColor(project, value) ?? fallback;
+}
+function colorOptions(project, value, opacity = 1) {
+	const resolved = resolveColorValue(project, value);
+	const alpha = resolved.length === 9 ? Number.parseInt(resolved.slice(7, 9), 16) / 255 : 1;
+	const transparency = Math.round((1 - Math.max(0, Math.min(1, alpha * opacity))) * 100);
+	return {
+		color: resolved.slice(1, 7).toUpperCase(),
+		...transparency === 0 ? {} : { transparency }
+	};
+}
+function readableForeground(background) {
+	const red = Number.parseInt(background.slice(0, 2), 16) / 255;
+	const green = Number.parseInt(background.slice(2, 4), 16) / 255;
+	const blue = Number.parseInt(background.slice(4, 6), 16) / 255;
+	return red * .2126 + green * .7152 + blue * .0722 < .5 ? "E2E8F0" : "1F2937";
+}
+function textStyle(project, content) {
+	return {
+		...record(resolveThemeReference(content.style, themeMap(project, "textStyles"))) ?? {},
+		...content
+	};
+}
+function plainText(value) {
+	return value.replace(/<br\s*\/?\s*>/giu, "\n").replace(/<\/p\s*>/giu, "\n").replace(/<li(?:\s[^>]*)?>/giu, "• ").replace(/<\/li\s*>/giu, "\n").replace(/<[^>]+>/gu, "").replace(/&lt;/gu, "<").replace(/&gt;/gu, ">").replace(/&amp;/gu, "&").replace(/&quot;/gu, "\"").replace(/\n{3,}/gu, "\n\n").trimEnd();
+}
+function textLayout(project, element) {
+	// Fix structural errors before estimating layout with fallback styles.
+	if (unknownFields(element, ELEMENT_FIELDS.text).length > 0) return void 0;
+	const bounds = tuple(element.bounds, 4);
+	const content = record(element.content);
+	if (bounds === void 0 || content === void 0 || typeof content.text !== "string" || plainText(content.text).trim() === "") return void 0;
+	const style = textStyle(project, content);
+	const fontSize = number(style.fontSize) ?? 18;
+	const inlineSizes = Array.from(content.text.matchAll(/font-size\s*:\s*(\d+(?:\.\d+)?)px/giu), (match) => Number(match[1]));
+	const vertical = style.textDirection === "vertical";
+	const lineHeight = number(style.lineHeight);
+	const letterSpacing = number(style.letterSpacing);
+	const wrap = boolean(style.wrap);
+	return measureTextLayout({
+		text: plainText(content.text),
+		width: bounds[vertical ? 3 : 2] ?? 0,
+		height: bounds[vertical ? 2 : 3] ?? 0,
+		fontSize: Math.max(fontSize, ...inlineSizes),
+		bold: boolean(style.bold) === true || /<(?:b|strong)(?:\s|>)/iu.test(content.text),
+		...lineHeight === void 0 ? {} : { lineHeight },
+		...letterSpacing === void 0 ? {} : { letterSpacing },
+		...wrap === void 0 ? {} : { wrap }
+	});
+}
+function localAssetPath(value) {
+	if (typeof value !== "string" || /^https?:\/\//iu.test(value)) return void 0;
+	return safeProjectPath(value);
+}
+function elementContext(page, element) {
+	return {
+		page,
+		...typeof element.elementId === "string" ? { elementId: element.elementId } : {}
+	};
+}
+function compatibilityIssue(page, context, level, feature) {
+	const severity = level === "unsupported" ? "error" : "warning";
+	return {
+		code: `compatibility-${level}`,
+		severity,
+		file: page.file,
+		...context,
+		message: `${feature} 的渲染兼容级别为 ${level}。`
+	};
+}
+function validTableGrid(element) {
+	const rows = Array.isArray(element.rows) ? element.rows : [];
+	const columnWidths = Array.isArray(element.columnWidths) ? element.columnWidths.map(number) : [];
+	const rowHeights = Array.isArray(element.rowHeights) ? element.rowHeights.map(number) : [];
+	const columnCount = columnWidths.length;
+	const rowCount = rowHeights.length;
+	if (rowCount === 0 || columnCount === 0 || rows.length !== rowCount) return false;
+	if (columnWidths.some((value) => value === void 0 || value < 0 || value > 1) || rowHeights.some((value) => value === void 0 || value < 0 || value > 1)) return false;
+	const nearOne = (values) => {
+		const total = values.reduce((sum, value) => sum + (value ?? 0), 0);
+		return Math.abs(total - 1) < .001;
+	};
+	if (!nearOne(columnWidths) || !nearOne(rowHeights)) return false;
+	const occupied = Array.from({ length: rowCount }, () => Array.from({ length: columnCount }, () => false));
+	for (const [rowIndex, rawRow] of rows.entries()) {
+		if (!Array.isArray(rawRow)) return false;
+		let columnIndex = 0;
+		for (const rawCell of rawRow) {
+			while (columnIndex < columnCount && occupied[rowIndex]?.[columnIndex] === true) columnIndex += 1;
+			const cell = record(rawCell) ?? {};
+			const rowSpan = number(cell.rowSpan) ?? 1;
+			const colSpan = number(cell.colSpan) ?? 1;
+			if (!Number.isInteger(rowSpan) || !Number.isInteger(colSpan) || rowSpan < 1 || colSpan < 1 || rowIndex + rowSpan > rowCount || columnIndex + colSpan > columnCount) return false;
+			for (let row = rowIndex; row < rowIndex + rowSpan; row += 1) {
+				const occupiedRow = occupied[row];
+				if (occupiedRow === void 0) return false;
+				for (let column = columnIndex; column < columnIndex + colSpan; column += 1) {
+					if (occupiedRow[column] === true) return false;
+					occupiedRow[column] = true;
+				}
+			}
+			columnIndex += colSpan;
+		}
+		if (occupied[rowIndex]?.some((value) => !value) === true) return false;
+	}
+	return true;
+}
+function checkElement(project, page, pageNumber, element, ids) {
+	const issues = [];
+	const context = elementContext(pageNumber, element);
+	const id = string(element.elementId);
+	issues.push(...colorThemeIssues(project, element, page.file, pageNumber, id));
+	if (id === void 0 || id.trim() === "") issues.push({
+		code: "element-id",
+		severity: "error",
+		file: page.file,
+		...context,
+		message: "元素缺少 elementId。"
+	});
+	else if (ids.has(id)) issues.push({
+		code: "duplicate-id",
+		severity: "error",
+		file: page.file,
+		...context,
+		message: `元素 ID ${id} 重复。`
+	});
+	else ids.add(id);
+	const bounds = tuple(element.bounds, 4);
+	const [x = 0, y = 0, width = -1, height = -1] = bounds ?? [];
+	if (bounds === void 0 || width < 0 || height < 0) issues.push({
+		code: "bounds",
+		severity: "error",
+		file: page.file,
+		...context,
+		message: "元素 bounds 必须是 [x, y, width, height]。"
+	});
+	else if (x < 0 || y < 0 || x + width > project.width + .01 || y + height > project.height + .01) issues.push({
+		code: "out-of-bounds",
+		severity: "error",
+		file: page.file,
+		...context,
+		message: "元素超出 PPTD 页面边界。"
+	});
+	const type = string(element.elementType);
+	if (![
+		"text",
+		"shape",
+		"line",
+		"image",
+		"icon",
+		"table",
+		"chart"
+	].includes(type ?? "")) {
+		issues.push({
+			code: "element-type",
+			severity: "error",
+			file: page.file,
+			...context,
+			message: `不支持的 elementType：${type ?? "missing"}。`
+		});
+		return issues;
+	}
+	if (type === "text") {
+		const content = record(element.content);
+		const styleIssue = themeReferenceIssue(project, content?.style, "textStyles", page.file, pageNumber, id);
+		if (styleIssue !== void 0) issues.push(styleIssue);
+		if (content === void 0 || typeof content.text !== "string") issues.push({
+			code: "text-content",
+			severity: "error",
+			file: page.file,
+			...context,
+			message: "文本元素需要 content.text。"
+		});
+		else {
+			const layout = textLayout(project, element);
+			if (layout?.overflow === true) {
+				const message = layout.horizontalOverflow ? `文本设置为不换行，但预计宽度 ${Math.ceil(layout.widestLine)}pt 超过文本框可用宽度 ${Math.floor(layout.availableLineWidth)}pt；请缩短文案或增大文本框。` : `文本预计需要 ${layout.lineCount} 行，当前文本框可容纳 ${layout.maxLineCount} 行；请缩短文案、增大文本框或拆分页面。`;
+				issues.push({
+					code: "text-overflow",
+					severity: "error",
+					file: page.file,
+					...context,
+					message
+				});
+			}
+		}
+		if (content !== void 0 && (content.gradient !== void 0 || content.shadow !== void 0)) issues.push(compatibilityIssue(page, context, "normalized", "文本渐变或阴影"));
+		if (typeof content?.text === "string" && /<(?:u|s|sup|sub|a|ol)(?:\s|>)/iu.test(content.text)) issues.push(compatibilityIssue(page, context, "normalized", "高级富文本标签"));
+	}
+	if (type === "shape") {
+		const name = string(element.shapeName);
+		if (name === void 0) issues.push({
+			code: "shape-name",
+			severity: "error",
+			file: page.file,
+			...context,
+			message: "形状元素需要 shapeName。"
+		});
+		else if (name === "custom") if (tuple(element.viewBox, 2) === void 0 || typeof element.path !== "string") issues.push({
+			code: "custom-shape",
+			severity: "error",
+			file: page.file,
+			...context,
+			message: "自定义形状需要 viewBox 和 SVG path。"
+		});
+		else issues.push(compatibilityIssue(page, context, "vector-fallback", "自定义 SVG 形状"));
+		else if (!NATIVE_SHAPE_NAMES.has(name)) issues.push({
+			code: "shape-name",
+			severity: "error",
+			file: page.file,
+			...context,
+			message: `未知的内置形状：${name}。`
+		});
+		if (element.adjustments !== void 0) issues.push(compatibilityIssue(page, context, "normalized", "形状 adjustments"));
+		const fill = record(element.fill);
+		if (fill?.type === "gradient" || fill?.type === "image") issues.push(compatibilityIssue(page, context, "normalized", "形状渐变或图片填充"));
+		if (element.shadow !== void 0) issues.push(compatibilityIssue(page, context, "normalized", "形状阴影"));
+	}
+	if (type === "line") {
+		const points = typeof element.points === "string" ? element.points.trim().split(/\s+/u) : [];
+		const invalidPoint = points.some((point) => !/^-?\d+(?:\.\d+)?,-?\d+(?:\.\d+)?$/u.test(point));
+		if (tuple(element.viewBox, 2) === void 0 || points.length < 2 || invalidPoint) issues.push({
+			code: "line-path",
+			severity: "error",
+			file: page.file,
+			...context,
+			message: "线条元素需要有效的 viewBox 和至少两个 points。"
+		});
+		else if (points.length > 2 || element.curve === "smooth") issues.push(compatibilityIssue(page, context, "vector-fallback", "贝塞尔曲线"));
+		if (element.shadow !== void 0) issues.push(compatibilityIssue(page, context, "normalized", "线条阴影"));
+	}
+	if (type === "image") {
+		if (typeof element.src !== "string") issues.push({
+			code: "image-src",
+			severity: "error",
+			file: page.file,
+			...context,
+			message: "图片元素需要 src。"
+		});
+		else if (/^https?:\/\//iu.test(element.src)) issues.push({
+			code: "remote-image",
+			severity: "error",
+			file: page.file,
+			...context,
+			message: "本地 PPTD 渲染器不访问网络图片，请先将图片放入项目目录。"
+		});
+		else {
+			const assetPath = localAssetPath(element.src);
+			if (assetPath === void 0 || !project.source.assets.has(assetPath)) issues.push({
+				code: "missing-asset",
+				severity: "error",
+				file: page.file,
+				...context,
+				message: `找不到图片资源 ${element.src}。`
+			});
+		}
+		const fit = record(element.fit);
+		if (fit !== void 0 && ![
+			"fill",
+			"contain",
+			"cover"
+		].includes(string(fit.mode) ?? "")) issues.push({
+			code: "image-fit",
+			severity: "error",
+			file: page.file,
+			...context,
+			message: "图片 fit.mode 必须是 fill、contain 或 cover。"
+		});
+		if (element.crop !== void 0 || element.cropShape !== void 0 || element.shadow !== void 0 || element.border !== void 0) {
+			const cropShape = record(element.cropShape);
+			issues.push(compatibilityIssue(page, context, cropShape?.shapeName === "custom" ? "raster-fallback" : "normalized", "图片裁剪、边框或阴影"));
+		}
+	}
+	if (type === "table") {
+		if (typeof element.style === "string") {
+			const styleIssue = themeReferenceIssue(project, element.style, "tableStyles", page.file, pageNumber, id);
+			if (styleIssue !== void 0) issues.push(styleIssue);
+		}
+		const rows = Array.isArray(element.rows) ? element.rows : [];
+		for (const rawRow of rows) for (const rawCell of Array.isArray(rawRow) ? rawRow : []) {
+			const styleIssue = themeReferenceIssue(project, record(rawCell)?.textStyle, "textStyles", page.file, pageNumber, id);
+			if (styleIssue !== void 0) issues.push(styleIssue);
+		}
+		if (!validTableGrid(element)) issues.push({
+			code: "table-data",
+			severity: "error",
+			file: page.file,
+			...context,
+			message: "表格网格、宽高比例或合并区域无效。"
+		});
+	}
+	if (type === "chart") {
+		const data = record(element.data);
+		const cols = Array.isArray(data?.cols) ? data.cols : [];
+		const rows = Array.isArray(data?.rows) ? data.rows : [];
+		const series = Array.isArray(element.series) ? element.series.map(record).filter((item) => item !== void 0) : [];
+		const validRows = rows.every((row) => Array.isArray(row) && row.length === cols.length);
+		const validSeries = series.length > 0 && series.every((item) => {
+			const encode = record(item.encode);
+			const refs = encode === void 0 ? [] : Object.values(encode).filter((value) => typeof value === "string");
+			return typeof item.type === "string" && refs.length >= 2 && refs.every((ref) => cols.includes(ref));
+		});
+		if (cols.length < 2 || rows.length === 0 || !validRows || !validSeries) issues.push({
+			code: "chart-data",
+			severity: "error",
+			file: page.file,
+			...context,
+			message: "图表 data/series/encode 结构不完整。"
+		});
+		const chartTypes = series.map((item) => string(item.type)).filter((item) => item !== void 0);
+		const unknownTypes = chartTypes.filter((item) => !NATIVE_CHART_TYPES.has(item) && !UNSUPPORTED_CHART_TYPES.has(item));
+		if (unknownTypes.length > 0) issues.push({
+			code: "chart-type",
+			severity: "error",
+			file: page.file,
+			...context,
+			message: `未知的图表类型：${[...new Set(unknownTypes)].join("、")}。`
+		});
+		const unsupportedTypes = chartTypes.filter((item) => UNSUPPORTED_CHART_TYPES.has(item));
+		if (unsupportedTypes.length > 0) issues.push(compatibilityIssue(page, context, "unsupported", `图表类型 ${[...new Set(unsupportedTypes)].join("、")}`));
+		const seriesDefaults = record(element.seriesDefaults) ?? {};
+		for (const [seriesIndex, item] of series.entries()) {
+			const chartType = string(item.type) ?? "bar";
+			const effective = {
+				...record(seriesDefaults[chartType]) ?? {},
+				...item
+			};
+			const paint = chartType === "line" || chartType === "area" || chartType === "radar" ? effective.lineColor ?? effective.areaColor : effective.fill;
+			if (paint === void 0) continue;
+			const multipleColors = Array.isArray(paint);
+			const validColors = resolvePptdChartSeriesColors(project, paint) !== void 0;
+			if (multipleColors && chartType !== "pie" || !validColors) issues.push({
+				code: "chart-series-color",
+				severity: "error",
+				file: page.file,
+				...context,
+				message: `图表序列 ${seriesIndex + 1} 的颜色需要使用 #RRGGBB、#RRGGBBAA、主题颜色引用或 solid 填充；饼图同时接受颜色数组。`
+			});
+		}
+	}
+	if (type === "icon") if (typeof element.iconName !== "string") issues.push({
+		code: "icon-name",
+		severity: "error",
+		file: page.file,
+		...context,
+		message: "图标元素需要 iconName。"
+	});
+	else issues.push(compatibilityIssue(page, context, "normalized", "Font Awesome 图标"));
+	return issues;
+}
+function textLayerIssues(project, page, pageNumber) {
+	const issues = [];
+	const overlap = (left, right) => {
+		const rightEdge = Math.min((left[0] ?? 0) + (left[2] ?? 0), (right[0] ?? 0) + (right[2] ?? 0));
+		const leftEdge = Math.max(left[0] ?? 0, right[0] ?? 0);
+		const bottomEdge = Math.min((left[1] ?? 0) + (left[3] ?? 0), (right[1] ?? 0) + (right[3] ?? 0));
+		const topEdge = Math.max(left[1] ?? 0, right[1] ?? 0);
+		const width = Math.max(0, rightEdge - leftEdge);
+		return {
+			area: width * Math.max(0, bottomEdge - topEdge),
+			width
+		};
+	};
+	for (const [index, element] of page.elements.entries()) {
+		if (element.elementType !== "text") continue;
+		const textBounds = tuple(element.bounds, 4);
+		if (textBounds === void 0 || (textBounds[2] ?? 0) <= 0 || (textBounds[3] ?? 0) <= 0) continue;
+		const textArea = (textBounds[2] ?? 0) * (textBounds[3] ?? 0);
+		const estimatedBottom = (textBounds[1] ?? 0) + (textLayout(project, element)?.requiredHeight ?? 0);
+		for (const earlier of page.elements.slice(0, index)) {
+			if (earlier.elementType !== "table" && earlier.elementType !== "chart") continue;
+			const earlierBounds = tuple(earlier.bounds, 4);
+			if (earlierBounds === void 0) continue;
+			if (overlap(textBounds, earlierBounds).area / textArea >= .15) {
+				issues.push({
+					code: "text-occlusion",
+					severity: "warning",
+					file: page.file,
+					page: pageNumber,
+					...typeof element.elementId === "string" ? { elementId: element.elementId } : {},
+					message: `文本与 ${string(earlier.elementId) ?? earlier.elementType} 的内容区域重叠。`
+				});
+				break;
+			}
+		}
+		for (const later of page.elements.slice(index + 1)) {
+			if (later.elementType === "line" || number(later.opacity) === 0) continue;
+			const laterBounds = tuple(later.bounds, 4);
+			if (laterBounds === void 0) continue;
+			const intersection = overlap(textBounds, laterBounds);
+			if (intersection.area / textArea >= .15) {
+				issues.push({
+					code: "text-occlusion",
+					severity: "warning",
+					file: page.file,
+					page: pageNumber,
+					...typeof element.elementId === "string" ? { elementId: element.elementId } : {},
+					message: `文本可能被后绘制元素 ${string(later.elementId) ?? later.elementType ?? "unknown"} 遮挡。`
+				});
+				break;
+			}
+			const laterTop = laterBounds[1] ?? 0;
+			if (laterTop > (textBounds[1] ?? 0) && laterTop < (textBounds[1] ?? 0) + (textBounds[3] ?? 0) && estimatedBottom > laterTop && intersection.width / (textBounds[2] ?? 1) >= .3) {
+				issues.push({
+					code: "text-drift",
+					severity: "warning",
+					file: page.file,
+					page: pageNumber,
+					...typeof element.elementId === "string" ? { elementId: element.elementId } : {},
+					message: `文本可能跨入下方元素 ${string(later.elementId) ?? later.elementType ?? "unknown"} 的边界。`
+				});
+				break;
+			}
+		}
+	}
+	return issues;
+}
+function isCompositionBookend(page) {
+	return /^(?:cover|title|opening|section|closing|final)$/iu.test(page.pageType?.trim() ?? "");
+}
+function visibleTextSizes(project, page) {
+	return page.elements.flatMap((element) => {
+		if (element.elementType !== "text") return [];
+		const content = record(element.content);
+		if (content === void 0 || typeof content.text !== "string" || plainText(content.text).trim() === "") return [];
+		return [number(textStyle(project, content).fontSize) ?? 18];
+	});
+}
+function coverFocusIssues(project) {
+	const canvasArea = project.width * project.height;
+	return project.pages.flatMap((page, index) => {
+		if (!/^(?:cover|title|opening)$/iu.test(page.pageType?.trim() ?? "")) return [];
+		if (page.elements.reduce((largest, element) => {
+			if (![
+				"image",
+				"chart",
+				"table"
+			].includes(string(element.elementType) ?? "")) return largest;
+			const bounds = tuple(element.bounds, 4);
+			if (bounds === void 0 || canvasArea <= 0) return largest;
+			return Math.max(largest, (bounds[2] ?? 0) * (bounds[3] ?? 0) / canvasArea);
+		}, 0) >= .25) return [];
+		const sizes = visibleTextSizes(project, page).sort((left, right) => left - right);
+		if (sizes.length < 3) return [];
+		const middle = Math.floor(sizes.length / 2);
+		const median = sizes.length % 2 === 1 ? sizes[middle] ?? 0 : ((sizes[middle - 1] ?? 0) + (sizes[middle] ?? 0)) / 2;
+		const largest = sizes.at(-1) ?? 0;
+		if (median > 0 && largest / median >= 3) return [];
+		return [{
+			code: "cover-focus",
+			severity: "warning",
+			file: page.file,
+			page: index + 1,
+			message: "封面需要更明确的首读焦点：让一张图片、图表或表格占据至少 25% 画布，或让最大标题达到可见文字中位字号的 3 倍。"
+		}];
+	});
+}
+function compositionFamily(element) {
+	const type = string(element.elementType);
+	if (type === "text" || type === "icon") return "text";
+	if (type === "image" || type === "chart" || type === "table") return "visual";
+	if (type === "shape") return "shape";
+}
+function layoutSignature(project, page) {
+	const canvasArea = project.width * project.height;
+	const landmarks = /* @__PURE__ */ new Set();
+	for (const element of page.elements) {
+		const family = compositionFamily(element);
+		const bounds = tuple(element.bounds, 4);
+		if (family === void 0 || bounds === void 0 || canvasArea <= 0) continue;
+		const [x = 0, y = 0, width = 0, height = 0] = bounds;
+		if (width <= 0 || height <= 0) continue;
+		const areaShare = width * height / canvasArea;
+		if (family === "shape" && (areaShare < .01 || areaShare > .85)) continue;
+		const column = Math.max(0, Math.min(3, Math.floor((x + width / 2) / project.width * 4)));
+		const row = Math.max(0, Math.min(3, Math.floor((y + height / 2) / project.height * 4)));
+		const scale = areaShare >= .25 ? "large" : areaShare >= .08 ? "medium" : "small";
+		landmarks.add(`${family}:${column}:${row}:${scale}`);
+	}
+	return [...landmarks].sort().join("|");
+}
+function layoutRepetitionIssues(project) {
+	const issues = [];
+	let runStart = 0;
+	let runSignature;
+	const finishRun = (end) => {
+		if (runSignature === void 0 || end - runStart < 3) return;
+		const first = project.pages[runStart];
+		if (first === void 0) return;
+		issues.push({
+			code: "layout-repetition",
+			severity: "warning",
+			file: first.file,
+			page: runStart + 1,
+			message: `第 ${runStart + 1}–${end} 页连续使用相同构图轮廓。调整主视觉位置、尺度或内容分组，并重新预览这组页面；固定指标序列可以保留重复。`
+		});
+	};
+	for (const [index, page] of project.pages.entries()) {
+		const signature = isCompositionBookend(page) ? "" : layoutSignature(project, page);
+		if (signature === "") {
+			finishRun(index);
+			runStart = index + 1;
+			runSignature = void 0;
+			continue;
+		}
+		if (signature === runSignature) continue;
+		finishRun(index);
+		runStart = index;
+		runSignature = signature;
+	}
+	finishRun(project.pages.length);
+	return issues;
+}
+function compositionIssues(project) {
+	return [...coverFocusIssues(project), ...layoutRepetitionIssues(project)];
+}
+/** Check structure, renderability, and measurable composition signals without external effects. */
+function checkPptdProject(project) {
+	const issues = [...project.parseIssues];
+	issues.push(...colorThemeIssues(project, project.theme, project.source.entryName));
+	for (const [key, value] of Object.entries(themeMap(project, "colors"))) {
+		const referenceIssue = themeReferenceIssue(project, value, "colors", project.source.entryName);
+		if (referenceIssue !== void 0) issues.push(referenceIssue);
+		if (typeof value !== "string" || !value.startsWith("$") && !/^#[0-9a-f]{6}(?:[0-9a-f]{2})?$/iu.test(value)) issues.push({
+			code: "invalid-theme",
+			severity: "error",
+			file: project.source.entryName,
+			message: `theme.colors.${key} 必须是颜色或颜色主题引用。`
+		});
+	}
+	issues.push(...themeColorChainIssues(project));
+	for (const [index, page] of project.pages.entries()) {
+		const ids = /* @__PURE__ */ new Set();
+		issues.push(...colorThemeIssues(project, page.background, page.file, index + 1));
+		for (const element of page.elements) issues.push(...checkElement(project, page, index + 1, element, ids));
+		issues.push(...textLayerIssues(project, page, index + 1));
+	}
+	issues.push(...compositionIssues(project));
+	const errorCount = issues.filter((item) => item.severity === "error").length;
+	const warningCount = issues.filter((item) => item.severity === "warning").length;
+	return {
+		status: errorCount > 0 ? "fail" : warningCount > 0 ? "warning" : "pass",
+		digest: projectDigest(project),
+		pageCount: project.pages.length,
+		nativeObjectCount: project.pages.reduce((sum, page) => sum + page.elements.length, 0),
+		warningCount,
+		errorCount,
+		issues,
+		compatibility: compatibilitySummary(project)
+	};
+}
+function inches(value) {
+	return value / POINTS_PER_INCH;
+}
+function frame(element) {
+	const [x = 0, y = 0, width = 0, height = 0] = tuple(element.bounds, 4) ?? [
+		0,
+		0,
+		0,
+		0
+	];
+	return {
+		x: inches(x),
+		y: inches(y),
+		w: inches(width),
+		h: inches(height)
+	};
+}
+function fontFace(value, fallback = "Arial", text = "") {
+	if (typeof value === "string") return value;
+	const font = record(value);
+	const eastAsian = /[\u2e80-\u9fff\uf900-\ufaff]/u.test(text);
+ const ea = process.platform === "darwin" ? font?.mac ?? font?.ea : process.platform === "win32" ? font?.win ?? font?.ea : font?.ea;
+ return (eastAsian ? string(ea) ?? string(font?.latin) : string(font?.latin) ?? string(ea)) ?? fallback;
+}
+function inlineStyle(project, raw) {
+	const options = {};
+	for (const declaration of raw?.split(";") ?? []) {
+		const [name, ...rest] = declaration.split(":");
+		const value = rest.join(":").trim();
+		if (name?.trim() === "color") options.color = colorOptions(project, value).color;
+		if (name?.trim() === "font-size" && /^\d+(?:\.\d+)?px$/u.test(value)) options.fontSize = Number.parseFloat(value);
+		if (name?.trim() === "font-family" && value !== "") {
+			const face = value.replace(/^['"]|['"]$/gu, "").split(",")[0]?.trim();
+			if (face !== void 0) options.fontFace = face;
+		}
+		if (name?.trim() === "background-color") options.highlight = colorOptions(project, value).color;
+		if (name?.trim() === "font-weight" && (value === "bold" || Number(value) >= 600)) options.bold = true;
+		if (name?.trim() === "font-style" && value === "italic") options.italic = true;
+	}
+	return options;
+}
+function richRuns(project, value) {
+	const runs = [];
+	const stack = [{
+		tag: "root",
+		options: {}
+	}];
+	const currentOptions = () => stack.at(-1)?.options ?? {};
+	for (const token of value.split(/(<[^>]+>)/gu)) {
+		if (token === "") continue;
+		if (!token.startsWith("<")) {
+			const decoded = plainText(token);
+			if (decoded !== "") runs.push({
+				text: decoded,
+				options: { ...currentOptions() }
+			});
+			continue;
+		}
+		const closing = /^<\/([a-z0-9]+)/iu.exec(token);
+		if (closing !== null) {
+			const tag = closing[1]?.toLowerCase();
+			if (tag === void 0) continue;
+			if (tag === "p" || tag === "li") runs.push({
+				text: "\n",
+				options: { ...currentOptions() }
+			});
+			while (stack.length > 1) if (stack.pop()?.tag === tag) break;
+			continue;
+		}
+		const opening = /^<([a-z0-9]+)/iu.exec(token);
+		if (opening === null) continue;
+		const tag = opening[1]?.toLowerCase();
+		if (tag === void 0) continue;
+		if (tag === "br") {
+			runs.push({
+				text: "\n",
+				options: { ...currentOptions() }
+			});
+			continue;
+		}
+		if (tag === "li") runs.push({
+			text: "• ",
+			options: { ...currentOptions() }
+		});
+		const style = /\sstyle=(?:"([^"]*)"|'([^']*)')/iu.exec(token);
+		const options = {
+			...currentOptions(),
+			...inlineStyle(project, style?.[1] ?? style?.[2])
+		};
+		if (tag === "strong") options.bold = true;
+		if (tag === "em") options.italic = true;
+		if (tag === "u") options.underline = { style: "sng" };
+		if (tag === "s") options.strike = "sngStrike";
+		if (tag === "sup") options.superscript = true;
+		if (tag === "sub") options.subscript = true;
+		if (tag === "a") {
+			const href = /\shref=(?:"([^"]*)"|'([^']*)')/iu.exec(token)?.slice(1).find((item) => item !== void 0);
+			if (href !== void 0 && /^(?:https?:|mailto:)/iu.test(href)) options.hyperlink = { url: href };
+		}
+		stack.push({
+			tag,
+			options
+		});
+	}
+	while (runs.at(-1)?.text === "\n") runs.pop();
+	return runs;
+}
+function flipOptions(element) {
+	const flip = Array.isArray(element.flip) ? element.flip : [];
+	return {
+		...typeof flip[0] === "boolean" ? { flipH: flip[0] } : {},
+		...typeof flip[1] === "boolean" ? { flipV: flip[1] } : {}
+	};
+}
+function shadowOptions(project, value) {
+	const shadow = record(value);
+	if (shadow === void 0 || number(shadow.blur) === void 0 || typeof shadow.color !== "string") return void 0;
+	const resolved = resolveColorValue(project, shadow.color);
+	const alpha = resolved.length === 9 ? Number.parseInt(resolved.slice(7, 9), 16) / 255 : 1;
+	const [offsetX = 0, offsetY = 0] = tuple(shadow.offset, 2) ?? [0, 0];
+	const angle = (Math.atan2(-offsetY, offsetX) * 180 / Math.PI + 360) % 360;
+	return {
+		type: "outer",
+		color: resolved.slice(1, 7).toUpperCase(),
+		opacity: alpha,
+		blur: number(shadow.blur) ?? 0,
+		offset: Math.hypot(offsetX, offsetY),
+		angle
+	};
+}
+function dash(value) {
+	return value === "dash" || value === "dot" ? value : "solid";
+}
+function border(project, value) {
+	const config = record(value);
+	if (config === void 0) return void 0;
+	const style = dash(config.style);
+	return {
+		color: colorOptions(project, config.color).color,
+		width: number(config.width) ?? 1,
+		...style === "solid" ? {} : { dash: style }
+	};
+}
+function horizontalAlign(value, fallback) {
+	return value === "center" || value === "right" || value === "justify" ? value : fallback;
+}
+function verticalAlign(value, fallback) {
+	return value === "middle" || value === "bottom" ? value : fallback;
+}
+function renderText(project, slide, element) {
+	const content = record(element.content) ?? {};
+	const style = textStyle(project, content);
+	const align = Array.isArray(style.align) ? style.align : [];
+	const raw = string(content.text) ?? "";
+	const runs = /<[^>]+>/u.test(raw) ? richRuns(project, raw) : raw;
+	const textColor = colorOptions(project, style.color).color;
+	const objectName = string(element.elementId);
+	const charSpacing = number(style.letterSpacing);
+	const horizontal = horizontalAlign(align[0], "left");
+	const vertical = verticalAlign(align[1], "top");
+	const textShadow = shadowOptions(project, style.shadow);
+	slide.addText(runs, {
+		...frame(element),
+		...objectName === void 0 ? {} : { objectName },
+		fontFace: fontFace(style.fontFamily, "Arial", raw),
+		fontSize: number(style.fontSize) ?? 18,
+		color: textColor,
+		bold: boolean(style.bold) ?? false,
+		italic: boolean(style.italic) ?? false,
+		align: horizontal,
+		valign: vertical,
+		margin: 0,
+		breakLine: false,
+		wrap: boolean(style.wrap) ?? true,
+		textDirection: style.textDirection === "vertical" ? "vert" : "horz",
+		rotate: number(element.rotation) ?? 0,
+		...flipOptions(element),
+		transparency: Math.round((1 - (number(element.opacity) ?? 1)) * 100),
+		...textShadow === void 0 ? {} : { shadow: textShadow },
+		...charSpacing === void 0 ? {} : { charSpacing }
+	});
+}
+function solidFill(project, value, opacity = 1) {
+	const fill = record(value);
+	if (fill === void 0) return void 0;
+	if (fill.type === "solid") return colorOptions(project, fill.color, opacity);
+	if (fill.type === "gradient" && Array.isArray(fill.stops)) {
+		const first = record(fill.stops[0]);
+		return first === void 0 ? void 0 : colorOptions(project, first.color, opacity);
+	}
+}
+function shapeType(pptx, value) {
+	const name = typeof value === "string" ? value : "rect";
+	const shape = pptx.ShapeType[name];
+	if (shape === void 0) throw new Error(`Unsupported PPTD preset shape: ${name}`);
+	return shape;
+}
+function xmlEscape(value) {
+	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;");
+}
+function svgPaint(project, fillValue, opacity) {
+	const fill = record(fillValue);
+	if (fill?.type === "gradient" && Array.isArray(fill.stops) && fill.stops.length >= 2) {
+		const id = "pptd-gradient";
+		const stops = fill.stops.map((rawStop) => {
+			const stop = record(rawStop) ?? {};
+			const color = colorOptions(project, stop.color, opacity);
+			return `<stop offset="${Math.round(Math.max(0, Math.min(1, number(stop.position) ?? 0)) * 100)}%" stop-color="#${color.color}"${color.transparency === void 0 ? "" : ` stop-opacity="${1 - color.transparency / 100}"`}/>`;
+		}).join("");
+		if (fill.gradientType === "radial") return {
+			paint: `url(#${id})`,
+			definition: `<radialGradient id="${id}">${stops}</radialGradient>`
+		};
+		const angle = number(fill.angle) ?? 0;
+		return {
+			paint: `url(#${id})`,
+			definition: `<linearGradient id="${id}" x1="0" y1="0.5" x2="1" y2="0.5" gradientTransform="rotate(${angle} 0.5 0.5)">${stops}</linearGradient>`
+		};
+	}
+	return {
+		paint: `#${colorOptions(project, fill?.type === "solid" ? fill.color : "#000000", opacity).color}`,
+		definition: ""
+	};
+}
+function svgData(svg) {
+	return `data:image/svg+xml;base64,${Buffer.from(svg).toString("base64")}`;
+}
+function renderCustomShape(project, slide, element) {
+	const viewBox = tuple(element.viewBox, 2) ?? [1, 1];
+	const pathData = string(element.path) ?? "";
+	const opacity = number(element.opacity) ?? 1;
+	const fill = svgPaint(project, element.fill, opacity);
+	const line = border(project, element.border);
+	const shadow = shadowOptions(project, element.shadow);
+	const shadowAngle = shadow?.angle ?? 0;
+	const shadowOffset = shadow?.offset ?? 0;
+	const shadowBlur = shadow?.blur ?? 0;
+	const objectName = string(element.elementId);
+	const [width = 1, height = 1] = viewBox;
+	const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${width} ${height}"><defs>${[fill.definition, shadow === void 0 ? "" : [
+		"<filter id=\"pptd-shadow\" x=\"-50%\" y=\"-50%\" width=\"200%\" height=\"200%\">",
+		`<feDropShadow dx="${Math.cos(shadowAngle * Math.PI / 180) * shadowOffset}" dy="${-Math.sin(shadowAngle * Math.PI / 180) * shadowOffset}" stdDeviation="${shadowBlur / 2}" flood-color="#${shadow?.color ?? "000000"}" flood-opacity="${shadow?.opacity ?? 1}"/>`,
+		"</filter>"
+	].join("")].join("")}</defs><path d="${xmlEscape(pathData)}" fill="${fill.paint}" fill-rule="evenodd"${line === void 0 ? " stroke=\"none\"" : ` stroke="#${line.color}" stroke-width="${line.width}"${line.dash === void 0 ? "" : ` stroke-dasharray="${line.dash === "dot" ? "1 2" : "4 3"}"`}`}${shadow === void 0 ? "" : " filter=\"url(#pptd-shadow)\""}/></svg>`;
+	slide.addImage({
+		...frame(element),
+		data: svgData(svg),
+		...objectName === void 0 ? {} : { objectName },
+		rotate: number(element.rotation) ?? 0,
+		...flipOptions(element)
+	});
+}
+function renderShape(project, pptx, slide, element) {
+	if (element.shapeName === "custom") {
+		renderCustomShape(project, slide, element);
+		return;
+	}
+	const opacity = number(element.opacity) ?? 1;
+	const fill = solidFill(project, element.fill, opacity);
+	const line = border(project, element.border);
+	const objectName = string(element.elementId);
+	const shapeShadow = shadowOptions(project, element.shadow);
+	slide.addShape(shapeType(pptx, element.shapeName), {
+		...frame(element),
+		...objectName === void 0 ? {} : { objectName },
+		rotate: number(element.rotation) ?? 0,
+		...flipOptions(element),
+		...fill === void 0 ? { fill: {
+			color: "FFFFFF",
+			transparency: 100
+		} } : { fill },
+		line: line === void 0 ? {
+			color: "FFFFFF",
+			transparency: 100
+		} : line,
+		...shapeShadow === void 0 ? {} : { shadow: shapeShadow }
+	});
+}
+function renderCurvedLine(project, slide, element, points) {
+	const [width = 1, height = 1] = tuple(element.viewBox, 2) ?? [1, 1];
+	const [first = [0, 0], ...rest] = points;
+	const [startX = 0, startY = 0] = first;
+	const pathData = rest.length === 3 ? `M ${startX} ${startY} C ${rest.map((point) => point.join(" ")).join(" ")}` : `M ${startX} ${startY} ${rest.map((point) => `L ${point[0] ?? 0} ${point[1] ?? 0}`).join(" ")}`;
+	const line = border(project, element.border) ?? {
+		color: "000000",
+		width: 1
+	};
+	const arrow = Array.isArray(element.arrow) ? element.arrow : [];
+	const marker = (id, kind) => kind === null || kind === void 0 ? "" : [
+		`<marker id="${id}" markerWidth="8" markerHeight="8" refX="7" refY="4" orient="auto" markerUnits="strokeWidth">`,
+		kind === "oval" ? "<circle cx=\"4\" cy=\"4\" r=\"3\" fill=\"context-stroke\"/>" : kind === "diamond" ? "<path d=\"M0,4 L4,0 L8,4 L4,8 Z\" fill=\"context-stroke\"/>" : "<path d=\"M0,0 L8,4 L0,8 Z\" fill=\"context-stroke\"/>",
+		"</marker>"
+	].join("");
+	const dash = line.dash === void 0 ? "" : ` stroke-dasharray="${line.dash === "dot" ? "1 2" : "4 3"}"`;
+	const markerStart = arrow[0] === void 0 || arrow[0] === null ? "" : " marker-start=\"url(#start)\"";
+	const markerEnd = arrow[1] === void 0 || arrow[1] === null ? "" : " marker-end=\"url(#end)\"";
+	const svg = [
+		`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${width} ${height}">`,
+		`<defs>${marker("start", arrow[0])}${marker("end", arrow[1])}</defs>`,
+		`<path d="${pathData}" fill="none" stroke="#${line.color}" stroke-width="${line.width}"`,
+		`${dash}${markerStart}${markerEnd}/></svg>`
+	].join("");
+	const objectName = string(element.elementId);
+	slide.addImage({
+		...frame(element),
+		data: svgData(svg),
+		...objectName === void 0 ? {} : { objectName },
+		rotate: number(element.rotation) ?? 0,
+		...flipOptions(element)
+	});
+}
+function renderLine(project, pptx, slide, element) {
+	const points = (string(element.points) ?? "").trim().split(/\s+/u).map((value) => value.split(",").map(Number));
+	if (points.length > 2 || element.curve === "smooth") {
+		renderCurvedLine(project, slide, element, points);
+		return;
+	}
+	const viewBox = tuple(element.viewBox, 2) ?? [1, 1];
+	const bounds = frame(element);
+	const first = points[0] ?? [0, 0];
+	const last = points.at(-1) ?? [viewBox[0] ?? 1, viewBox[1] ?? 1];
+	const x1 = bounds.x + (first[0] ?? 0) / (viewBox[0] ?? 1) * bounds.w;
+	const y1 = bounds.y + (first[1] ?? 0) / (viewBox[1] ?? 1) * bounds.h;
+	const x2 = bounds.x + (last[0] ?? 0) / (viewBox[0] ?? 1) * bounds.w;
+	const y2 = bounds.y + (last[1] ?? 0) / (viewBox[1] ?? 1) * bounds.h;
+	const line = border(project, element.border) ?? {
+		color: "000000",
+		width: 1
+	};
+	const arrow = Array.isArray(element.arrow) ? element.arrow : [];
+	const objectName = string(element.elementId);
+	const lineShadow = shadowOptions(project, element.shadow);
+	slide.addShape(pptx.ShapeType.line, {
+		x: Math.min(x1, x2),
+		y: Math.min(y1, y2),
+		w: Math.abs(x2 - x1),
+		h: Math.abs(y2 - y1),
+		...objectName === void 0 ? {} : { objectName },
+		flipH: x2 < x1,
+		flipV: y2 < y1,
+		rotate: number(element.rotation) ?? 0,
+		line: {
+			...line,
+			...arrow[0] === void 0 || arrow[0] === null ? {} : { beginArrowType: arrow[0] },
+			...arrow[1] === void 0 || arrow[1] === null ? {} : { endArrowType: arrow[1] }
+		},
+		...lineShadow === void 0 ? {} : { shadow: lineShadow }
+	});
+}
+function renderImage(project, slide, element) {
+	const assetPath = localAssetPath(element.src);
+	const asset = assetPath === void 0 ? void 0 : project.source.assets.get(assetPath);
+	if (asset === void 0) throw new Error(`PPTD image ${String(element.src)} is unavailable`);
+	const objectName = string(element.elementId);
+	const mode = string(record(element.fit)?.mode) ?? "cover";
+	const bounds = frame(element);
+	const cropShape = record(element.cropShape);
+	const imageShadow = shadowOptions(project, element.shadow);
+	slide.addImage({
+		...bounds,
+		...objectName === void 0 ? {} : { objectName },
+		data: `data:${asset.mediaType};base64,${Buffer.from(asset.bytes).toString("base64")}`,
+		rotate: number(element.rotation) ?? 0,
+		...flipOptions(element),
+		transparency: Math.round((1 - (number(element.opacity) ?? 1)) * 100),
+		...mode === "fill" ? {} : { sizing: {
+			type: mode,
+			w: bounds.w,
+			h: bounds.h
+		} },
+		...cropShape?.shapeName === "ellipse" ? { rounding: true } : {},
+		...imageShadow === void 0 ? {} : { shadow: imageShadow }
+	});
+	const imageBorder = border(project, element.border);
+	if (imageBorder !== void 0) slide.addShape(cropShape?.shapeName === "ellipse" ? "ellipse" : "rect", {
+		...bounds,
+		objectName: `${objectName ?? "image"}-border`,
+		fill: {
+			color: "FFFFFF",
+			transparency: 100
+		},
+		line: imageBorder,
+		rotate: number(element.rotation) ?? 0,
+		...flipOptions(element)
+	});
+}
+function mergeCellStyle(project, table, row, column, rowCount, columnCount, cell) {
+	const tableTheme = record(resolveThemeReference(table.style, themeMap(project, "tableStyles"))) ?? {};
+	const baseline = record(tableTheme.cellStyle) ?? {};
+	const bodyStyles = Array.isArray(tableTheme.bodyStyles) ? tableTheme.bodyStyles.map(record).filter((item) => item !== void 0) : [];
+	const body = row > 0 && row < rowCount - 1 && bodyStyles.length > 0 ? bodyStyles[(row - 1) % bodyStyles.length] ?? {} : {};
+	const rowStyle = row === 0 ? record(tableTheme.firstRowStyle) ?? {} : row === rowCount - 1 ? record(tableTheme.lastRowStyle) ?? {} : body;
+	const columnStyle = column === 0 ? record(tableTheme.firstColumnStyle) ?? {} : column === columnCount - 1 ? record(tableTheme.lastColumnStyle) ?? {} : {};
+	return boolean(tableTheme.rowOverColumn) === false ? {
+		...baseline,
+		...rowStyle,
+		...columnStyle,
+		...cell
+	} : {
+		...baseline,
+		...columnStyle,
+		...rowStyle,
+		...cell
+	};
+}
+function tableBorder(project, value) {
+	const none = {
+		color: "FFFFFF",
+		pt: 0
+	};
+	const one = (item) => {
+		const parsed = border(project, item);
+		return parsed === void 0 ? none : {
+			color: parsed.color,
+			pt: parsed.width,
+			...parsed.dash === void 0 ? {} : { dash: parsed.dash }
+		};
+	};
+	if (value === null) return [
+		none,
+		none,
+		none,
+		none
+	];
+	if (Array.isArray(value)) {
+		if (value.length === 2) return [
+			one(value[0]),
+			one(value[1]),
+			one(value[0]),
+			one(value[1])
+		];
+		if (value.length === 4) return [
+			one(value[0]),
+			one(value[1]),
+			one(value[2]),
+			one(value[3])
+		];
+	}
+	return record(value) === void 0 ? void 0 : one(value);
+}
+function renderTable(project, slide, element) {
+	const rows = element.rows;
+	const rowCount = rows.length;
+	const columnCount = Array.isArray(element.columnWidths) ? element.columnWidths.length : rows[0]?.length ?? 0;
+	const tableRows = rows.map((row, rowIndex) => row.map((rawCell, columnIndex) => {
+		const cell = record(rawCell) ?? { text: typeof rawCell === "string" || typeof rawCell === "number" ? String(rawCell) : "" };
+		const style = {
+			...record(resolveThemeReference(cell.textStyle, themeMap(project, "textStyles"))) ?? {},
+			...mergeCellStyle(project, element, rowIndex, columnIndex, rowCount, columnCount, cell)
+		};
+		const align = Array.isArray(style.align) ? style.align : [];
+		const horizontal = horizontalAlign(align[0], "center");
+		const vertical = verticalAlign(align[1], "middle");
+		const fill = solidFill(project, style.fill);
+		const cellBorder = tableBorder(project, style.border);
+		const rowSpan = number(cell.rowSpan);
+		const colSpan = number(cell.colSpan);
+		const options = {
+			fontFace: fontFace(style.fontFamily, "Arial", string(cell.text) ?? ""),
+			fontSize: number(style.fontSize) ?? 10,
+			color: colorOptions(project, style.color).color,
+			bold: boolean(style.bold) ?? false,
+			italic: boolean(style.italic) ?? false,
+			align: horizontal,
+			valign: vertical,
+			margin: .03,
+			...rowSpan === void 0 ? {} : { rowspan: rowSpan },
+			...colSpan === void 0 ? {} : { colspan: colSpan },
+			...fill === void 0 ? {} : { fill },
+			...cellBorder === void 0 ? {} : { border: cellBorder }
+		};
+		return {
+			text: plainText(string(cell.text) ?? ""),
+			options
+		};
+	}));
+	const bounds = frame(element);
+	const colRatios = Array.isArray(element.columnWidths) ? element.columnWidths.map(number).filter((item) => item !== void 0) : [];
+	const rowRatios = Array.isArray(element.rowHeights) ? element.rowHeights.map(number).filter((item) => item !== void 0) : [];
+	const colW = colRatios.length === columnCount ? colRatios.map((value) => value * bounds.w) : void 0;
+	const rowH = rowRatios.length === rowCount ? rowRatios.map((value) => value * bounds.h) : void 0;
+	const objectName = string(element.elementId);
+	slide.addTable(tableRows, {
+		...bounds,
+		...objectName === void 0 ? {} : { objectName },
+		autoPage: false,
+		...colW === void 0 ? {} : { colW },
+		...rowH === void 0 ? {} : { rowH },
+		border: {
+			color: "FFFFFF",
+			pt: 0
+		},
+		margin: 0
+	});
+}
+function legendPosition(value) {
+	return {
+		bottom: "b",
+		left: "l",
+		right: "r",
+		top: "t",
+		topRight: "tr"
+	}[string(value) ?? ""] ?? "r";
+}
+function valueAxisOptions(project, axis) {
+	const label = record(axis.label) ?? {};
+	const grid = record(axis.gridLine);
+	const minimum = number(axis.min);
+	const maximum = number(axis.max);
+	const fontSize = number(label.fontSize);
+	const title = string(axis.title);
+	return {
+		...minimum === void 0 ? {} : { valAxisMinVal: minimum },
+		...maximum === void 0 ? {} : { valAxisMaxVal: maximum },
+		...fontSize === void 0 ? {} : { valAxisLabelFontSize: fontSize },
+		...title === void 0 ? {} : {
+			showValAxisTitle: true,
+			valAxisTitle: title
+		},
+		...axis.gridLine === false ? { valGridLine: { style: "none" } } : grid === void 0 ? {} : { valGridLine: {
+			color: colorOptions(project, grid.color, 1).color,
+			style: dash(grid.style)
+		} }
+	};
+}
+function chartAxisOptions(project, element, horizontal = false) {
+	const xAxis = Array.isArray(element.xAxis) ? record(element.xAxis[0]) ?? {} : record(element.xAxis) ?? {};
+	const yAxis = (Array.isArray(element.yAxis) ? element.yAxis.map(record).filter((item) => item !== void 0) : [record(element.yAxis) ?? {}])[0] ?? {};
+	const valueAxis = horizontal ? xAxis : yAxis;
+	const categoryAxis = horizontal ? yAxis : xAxis;
+	const categoryLabel = record(categoryAxis.label) ?? {};
+	return {
+		...valueAxisOptions(project, valueAxis),
+		...number(categoryLabel.fontSize) === void 0 ? {} : { catAxisLabelFontSize: number(categoryLabel.fontSize) },
+		...number(categoryLabel.rotate) === void 0 ? {} : { catAxisLabelRotate: number(categoryLabel.rotate) },
+		...categoryAxis.gridLine === false ? { catGridLine: { style: "none" } } : {}
+	};
+}
+function renderChart(project, pptx, slide, element, foregroundColor) {
+	const data = record(element.data) ?? {};
+	const columns = (Array.isArray(data.cols) ? data.cols : []).map((value) => String(value));
+	const rows = Array.isArray(data.rows) ? data.rows : [];
+	const columnIsNumeric = (column) => {
+		if (column === void 0) return false;
+		const columnIndex = columns.indexOf(column);
+		if (columnIndex < 0) return false;
+		const values = rows.map((row) => row[columnIndex]).filter((value) => value !== void 0 && value !== null && value !== "");
+		return values.length > 0 && values.every((value) => {
+			if (typeof value === "number") return Number.isFinite(value);
+			return typeof value === "string" && value.trim() !== "" && Number.isFinite(Number(value));
+		});
+	};
+	const seriesDefaults = record(element.seriesDefaults) ?? {};
+	const xAxis = Array.isArray(element.xAxis) ? record(element.xAxis[0]) ?? {} : record(element.xAxis) ?? {};
+	const yAxes = Array.isArray(element.yAxis) ? element.yAxis.map(record).filter((item) => item !== void 0) : [record(element.yAxis) ?? {}];
+	const mergeSeries = (raw) => {
+		const defaults = record(seriesDefaults[string(raw.type) ?? ""]) ?? {};
+		const merged = {
+			...defaults,
+			...raw
+		};
+		for (const key of [
+			"marker",
+			"dataLabels",
+			"border",
+			"upBars",
+			"downBars",
+			"totalBars",
+			"increaseBars",
+			"decreaseBars"
+		]) {
+			const base = record(defaults[key]);
+			const specific = record(raw[key]);
+			if (base !== void 0 || specific !== void 0) merged[key] = {
+				...base ?? {},
+				...specific ?? {}
+			};
+		}
+		return merged;
+	};
+	const series = (Array.isArray(element.series) ? element.series : []).map(record).filter((item) => item !== void 0).map(mergeSeries);
+	const types = [];
+	const mergeableGroups = /* @__PURE__ */ new Map();
+	for (const [index, item] of series.entries()) {
+		const encode = record(item.encode) ?? {};
+		const chartTypeName = string(item.type) ?? "bar";
+		const xColumn = string(encode.x);
+		const yColumn = string(encode.y);
+		const horizontal = chartTypeName === "bar" && columnIsNumeric(xColumn) && !columnIsNumeric(yColumn);
+		const categoryColumn = string(chartTypeName === "pie" || chartTypeName === "radar" ? encode.category : horizontal ? encode.y : encode.x) ?? columns[0] ?? "category";
+		const valueColumn = string(chartTypeName === "pie" ? encode.value : horizontal ? encode.x : encode.y) ?? columns[1] ?? "value";
+		const categoryIndex = columns.indexOf(categoryColumn);
+		const valueIndex = columns.indexOf(valueColumn);
+		const selectedRows = (() => {
+			const filter = record(item.dataFilter);
+			const filterColumn = string(filter?.col);
+			if (filterColumn === void 0) return rows;
+			const filterIndex = columns.indexOf(filterColumn);
+			return rows.filter((row) => row[filterIndex] === filter?.value);
+		})();
+		const filteredRows = horizontal ? [...selectedRows].reverse() : selectedRows;
+		const filteredLabels = filteredRows.map((row) => {
+			const value = row[categoryIndex];
+			return typeof value === "string" || typeof value === "number" || typeof value === "boolean" ? String(value) : "";
+		});
+		const values = filteredRows.map((row) => Number(row[valueIndex] ?? 0));
+		const type = chartTypeName === "line" ? pptx.ChartType.line : chartTypeName === "area" ? pptx.ChartType.area : chartTypeName === "scatter" ? pptx.ChartType.scatter : chartTypeName === "bubble" ? pptx.ChartType.bubble : chartTypeName === "radar" ? pptx.ChartType.radar : chartTypeName === "pie" && (number(item.innerRadius) ?? 0) > 0 ? pptx.ChartType.doughnut : chartTypeName === "pie" ? pptx.ChartType.pie : pptx.ChartType.bar;
+		const chartColors = (resolvePptdChartSeriesColors(project, chartTypeName === "line" || chartTypeName === "area" || chartTypeName === "radar" ? item.lineColor ?? item.areaColor : item.fill) ?? [PPTD_CHART_SERIES_PALETTE[index % PPTD_CHART_SERIES_PALETTE.length] ?? "#2563EB"]).map((value) => colorOptions(project, value, 1).color);
+		const labelsConfig = record(item.dataLabels);
+		const showLabels = boolean(labelsConfig?.show) === true;
+		const showPercent = labelsConfig?.content === "percentage";
+		const dataLabelFontSize = number(labelsConfig?.fontSize);
+		const dataLabelColor = labelsConfig?.color === void 0 ? foregroundColor : colorOptions(project, labelsConfig.color).color;
+		const axisIndex = Math.max(0, Math.trunc(number(item.yAxisIndex) ?? 0));
+		const valueAxis = horizontal ? xAxis : yAxes[axisIndex] ?? yAxes[0] ?? {};
+		const valueAxisLabel = record(valueAxis.label) ?? {};
+		const valueAxisGrid = record(valueAxis.gridLine);
+		const valueAxisMin = number(valueAxis.min);
+		const valueAxisMax = number(valueAxis.max);
+		const valueAxisLabelFontSize = number(valueAxisLabel.fontSize);
+		const valueAxisTitle = string(valueAxis.title);
+		const groupOptions = {
+			...horizontal ? { barDir: "bar" } : chartTypeName === "bar" ? { barDir: "col" } : {},
+			...axisIndex === 1 ? { secondaryValAxis: true } : {},
+			...valueAxisMin === void 0 ? {} : { valAxisMinVal: valueAxisMin },
+			...valueAxisMax === void 0 ? {} : { valAxisMaxVal: valueAxisMax },
+			...valueAxisLabelFontSize === void 0 ? {} : { valAxisLabelFontSize: valueAxisLabelFontSize },
+			...valueAxisTitle === void 0 ? {} : {
+				showValAxisTitle: true,
+				valAxisTitle: valueAxisTitle
+			},
+			...valueAxis.gridLine === false ? { valGridLine: { style: "none" } } : valueAxisGrid === void 0 ? {} : { valGridLine: {
+				color: colorOptions(project, valueAxisGrid.color, 1).color,
+				style: dash(valueAxisGrid.style)
+			} },
+			...showLabels && !showPercent ? { showValue: true } : {},
+			...showLabels && showPercent ? { showPercent: true } : {},
+			dataLabelColor,
+			...dataLabelFontSize === void 0 ? {} : {
+				dataLabelFontSize,
+				dataLabelPosition: "outEnd"
+			},
+			...chartTypeName === "line" ? {
+				lineSize: number(item.width) ?? 2,
+				lineDataSymbol: "circle"
+			} : {},
+			...chartTypeName === "area" ? { lineSize: number(item.width) ?? 2 } : {},
+			...chartTypeName === "radar" ? { radarStyle: item.areaColor === void 0 ? "marker" : "filled" } : {},
+			...(chartTypeName === "line" || chartTypeName === "area") && item.marker === false ? { lineDataSymbol: "none" } : {},
+			...(chartTypeName === "line" || chartTypeName === "area") && record(item.marker) !== void 0 ? {
+				lineDataSymbol: record(item.marker)?.shape === "rect" ? "square" : string(record(item.marker)?.shape) ?? "circle",
+				lineDataSymbolSize: number(record(item.marker)?.size) ?? 6
+			} : {},
+			...item.stack === "percent" ? { barGrouping: "percentStacked" } : item.stack === "value" || item.stack === "stream" ? { barGrouping: "stacked" } : chartTypeName === "bar" ? { barGrouping: "clustered" } : {},
+			...item.nullHandling === "gap" ? { displayBlanksAs: "gap" } : { displayBlanksAs: "span" },
+			...type === pptx.ChartType.doughnut ? { holeSize: Math.round((number(item.innerRadius) ?? .5) * 100) } : {}
+		};
+		const dataSeries = {
+			name: string(item.name) ?? valueColumn ?? `Series ${index + 1}`,
+			labels: filteredLabels,
+			values,
+			...chartTypeName === "bubble" ? { sizes: filteredRows.map((row) => Number(row[columns.indexOf(string(encode.size) ?? "")] ?? 0)) } : {}
+		};
+		const mergeable = type !== pptx.ChartType.pie && type !== pptx.ChartType.doughnut;
+		const groupKey = chartTypeName === "bar" ? `${type}:${horizontal ? "horizontal" : "vertical"}:${axisIndex}:${String(groupOptions.barGrouping)}` : `${type}:${JSON.stringify(groupOptions)}`;
+		const existing = mergeable ? mergeableGroups.get(groupKey) : void 0;
+		if (existing === void 0) {
+			const chartGroup = {
+				type,
+				data: [dataSeries],
+				options: {
+					...groupOptions,
+					chartColors
+				}
+			};
+			types.push(chartGroup);
+			if (mergeable) mergeableGroups.set(groupKey, chartGroup);
+			continue;
+		}
+		existing.data.push(dataSeries);
+		existing.options.chartColors = [...existing.options.chartColors ?? [], ...chartColors];
+		if (groupOptions.showValue === true) existing.options.showValue = true;
+		if (groupOptions.showPercent === true) existing.options.showPercent = true;
+		if (existing.options.dataLabelFontSize === void 0 && groupOptions.dataLabelFontSize !== void 0) existing.options.dataLabelFontSize = groupOptions.dataLabelFontSize;
+	}
+	const legend = typeof element.legend === "boolean" ? { show: element.legend } : record(element.legend) ?? {};
+	const font = fontFace(element.fontFamily, "Arial", JSON.stringify(types.map(group => group.data)));
+	const objectName = string(element.elementId);
+	const title = typeof element.title === "string" ? { text: element.title } : record(element.title) ?? {};
+	const chartFill = solidFill(project, element.fill);
+	const chartBorder = border(project, element.border);
+	const legendFontSize = number(legend.fontSize);
+	const titleFontSize = number(title.fontSize);
+	const titleText = string(title.text);
+	const barGap = number(element.barGap);
+	const valAxes = series.some((item) => Math.trunc(number(item.yAxisIndex) ?? 0) === 1) ? [valueAxisOptions(project, yAxes[0] ?? {}), valueAxisOptions(project, yAxes[1] ?? {})] : void 0;
+	const common = {
+		...frame(element),
+		...objectName === void 0 ? {} : { objectName },
+		showLegend: boolean(legend.show) ?? series.some((item) => ![
+			"waterfall",
+			"heatmap",
+			"treemap",
+			"sunburst",
+			"sankey"
+		].includes(string(item.type) ?? "")),
+		legendPos: legendPosition(legend.position),
+		legendFontFace: fontFace(legend.fontFamily, font),
+		legendColor: colorOptions(project, legend.color ?? `#${foregroundColor}`).color,
+		...legendFontSize === void 0 ? {} : { legendFontSize },
+		catAxisLabelFontFace: font,
+		catAxisLabelColor: foregroundColor,
+		catAxisLineColor: foregroundColor,
+		valAxisLabelFontFace: font,
+		valAxisLabelColor: foregroundColor,
+		valAxisLineColor: foregroundColor,
+		showTitle: titleText !== void 0,
+		...titleText === void 0 ? {} : { title: titleText },
+		titleFontFace: fontFace(title.fontFamily, font),
+		titleColor: colorOptions(project, title.color ?? `#${foregroundColor}`).color,
+		...titleFontSize === void 0 ? {} : { titleFontSize },
+		showValue: false,
+		chartArea: {
+			border: chartBorder === void 0 ? {
+				color: "FFFFFF",
+				pt: 0
+			} : {
+				color: chartBorder.color,
+				pt: chartBorder.width
+			},
+			fill: chartFill ?? {
+				color: "FFFFFF",
+				transparency: 100
+			}
+		},
+		plotArea: {
+			border: {
+				color: "FFFFFF",
+				pt: 0
+			},
+			fill: {
+				color: "FFFFFF",
+				transparency: 100
+			}
+		},
+		...barGap === void 0 ? {} : { barGapWidthPct: Math.round(barGap * 100) },
+		...valAxes === void 0 ? {} : { valAxes },
+		...chartAxisOptions(project, element, series.some((item) => {
+			const encode = record(item.encode) ?? {};
+			return string(item.type) === "bar" && columnIsNumeric(string(encode.x)) && !columnIsNumeric(string(encode.y));
+		}))
+	};
+	slide.addChart(types, common);
+}
+function renderIcon(project, slide, element) {
+	const color = colorOptions(project, element.color).color;
+	const objectName = string(element.elementId);
+	slide.addText(string(element.iconName) ?? "●", {
+		...frame(element),
+		...objectName === void 0 ? {} : { objectName },
+		fontFace: "Arial",
+		fontSize: 18,
+		color,
+		margin: 0,
+		align: "center",
+		valign: "middle",
+		fit: "shrink"
+	});
+}
+function renderElement(project, pptx, slide, element, foregroundColor) {
+	if (element.elementType === "text") {
+		renderText(project, slide, element);
+		return;
+	}
+	if (element.elementType === "shape") {
+		renderShape(project, pptx, slide, element);
+		return;
+	}
+	if (element.elementType === "line") {
+		renderLine(project, pptx, slide, element);
+		return;
+	}
+	if (element.elementType === "image") {
+		renderImage(project, slide, element);
+		return;
+	}
+	if (element.elementType === "table") {
+		renderTable(project, slide, element);
+		return;
+	}
+	if (element.elementType === "chart") {
+		renderChart(project, pptx, slide, element, foregroundColor);
+		return;
+	}
+	if (element.elementType === "icon") {
+		renderIcon(project, slide, element);
+		return;
+	}
+}
+/** Render one checked PPTD AST to editable native PowerPoint objects. */
+async function renderPptdProject(project) {
+	const check = checkPptdProject(project);
+	if (check.status === "fail") {
+		const details = check.issues.filter((issue) => issue.severity === "error").slice(0, 3).map((issue) => `${issue.code}${issue.elementId === void 0 ? "" : `(${issue.elementId})`}: ${issue.message}`).join("; ");
+		throw new Error(`PPTD rendering requires a passing check; received ${check.errorCount} errors${details === "" ? "" : `: ${details}`}`);
+	}
+	const pptx = new PptxGenJS();
+	const layoutName = `DSH_PPTD_${project.width}x${project.height}`;
+	pptx.defineLayout({
+		name: layoutName,
+		width: inches(project.width),
+		height: inches(project.height)
+	});
+	pptx.layout = layoutName;
+	pptx.author = "DSH PPTD";
+	pptx.company = "DeepSeek Harness";
+	pptx.subject = "Local PPTD v2 editable rendering";
+	pptx.title = project.title;
+	const textStyles = themeMap(project, "textStyles");
+	const titleStyle = record(textStyles.title) ?? {};
+	const bodyStyle = record(textStyles.body) ?? {};
+	pptx.theme = {
+		headFontFace: fontFace(titleStyle.fontFamily, "Arial"),
+		bodyFontFace: fontFace(bodyStyle.fontFamily, "Arial")
+	};
+	for (const page of project.pages) {
+		const slide = pptx.addSlide();
+		const background = solidFill(project, page.background);
+		slide.background = background ?? { color: "FFFFFF" };
+		const foregroundColor = readableForeground(background?.color ?? "FFFFFF");
+		for (const element of page.elements) renderElement(project, pptx, slide, element, foregroundColor);
+		if (page.notes.trim() !== "") slide.addNotes(page.notes);
+	}
+	const output = await pptx.write({
+		outputType: "nodebuffer",
+		compression: true
+	});
+	return {
+		bytes: new Uint8Array(output),
+		nativeObjectCount: check.nativeObjectCount,
+		check
+	};
+}
+function mediaType(file, bytes) {
+	const extension = path.extname(file).toLowerCase();
+	if (extension === ".png" && bytes[0] === 137 && bytes[1] === 80) return "image/png";
+	if ((extension === ".jpg" || extension === ".jpeg") && bytes[0] === 255 && bytes[1] === 216) return "image/jpeg";
+	if (extension === ".gif" && Buffer.from(bytes.subarray(0, 3)).toString("ascii") === "GIF") return "image/gif";
+	if (extension === ".webp" && Buffer.from(bytes.subarray(8, 12)).toString("ascii") === "WEBP") return "image/webp";
+	if (extension === ".svg" && Buffer.from(bytes.subarray(0, 512)).toString("utf8").includes("<svg")) return "image/svg+xml";
+}
+async function confinedFile(root, relative, maximumBytes) {
+	const safe = safeProjectPath(relative);
+	if (safe === void 0) throw new Error(`PPTD path is not project-relative: ${relative}`);
+	const target = await realpath(path.join(root, ...safe.split("/")));
+	if (target !== root && !target.startsWith(`${root}${path.sep}`)) throw new Error(`PPTD path escapes the project root: ${relative}`);
+	const metadata = await lstat(target);
+	if (!metadata.isFile() || metadata.size > maximumBytes) throw new Error(`PPTD file is invalid or too large: ${relative}`);
+	return {
+		real: target,
+		bytes: await readFile(target)
+	};
+}
+/** Resolve a PPTD entry file from either the entry itself or its project directory. */
+async function resolvePptdEntry(inputPath) {
+	const input = await realpath(path.resolve(inputPath));
+	const metadata = await lstat(input);
+	if (metadata.isFile()) {
+		if (!input.endsWith(".pptd")) throw new Error("PPTD entry must use the .pptd extension");
+		return input;
+	}
+	if (!metadata.isDirectory()) throw new Error("PPTD input must be an entry file or project directory");
+	const entries = (await readdir(input, { withFileTypes: true })).filter((entry) => entry.isFile() && entry.name.endsWith(".pptd")).map((entry) => entry.name).sort();
+	if (entries.length !== 1) throw new Error(`PPTD project directory must contain exactly one .pptd entry; found ${entries.length}`);
+	const entry = entries.at(0);
+	if (entry === void 0) throw new Error("PPTD project directory must contain one .pptd entry");
+	return path.join(input, entry);
+}
+/** Load a confined local PPTD project. Network resources stay disabled. */
+async function loadPptdProject(entryPath) {
+	const entry = await resolvePptdEntry(entryPath);
+	const metadata = await lstat(entry);
+	if (!metadata.isFile() || metadata.size > MAX_MANIFEST_BYTES) throw new Error("PPTD entry is invalid or too large");
+	const root = path.dirname(entry);
+	const manifest = await readFile(entry, "utf8");
+	const raw = parseYaml(manifest, path.basename(entry), []);
+	if (raw === void 0) return parsePptdProject({
+		entryName: path.basename(entry),
+		manifest,
+		pages: /* @__PURE__ */ new Map(),
+		assets: /* @__PURE__ */ new Map()
+	});
+	const refs = Array.isArray(raw.pages) ? raw.pages.slice(0, MAX_PAGES) : [];
+	const pages = /* @__PURE__ */ new Map();
+	const loadIssues = [];
+	for (const rawRef of refs) {
+		const ref = typeof rawRef === "string" ? safeProjectPath(rawRef) : void 0;
+		if (ref === void 0) continue;
+		try {
+			const file = await confinedFile(root, ref, MAX_PAGE_BYTES);
+			pages.set(ref, Buffer.from(file.bytes).toString("utf8"));
+		} catch (error) {
+			loadIssues.push({
+				code: "file-read",
+				severity: "error",
+				file: ref,
+				message: `无法读取页面文件 ${ref}：${error instanceof Error ? error.message : String(error)}`
+			});
+		}
+	}
+	const partial = parsePptdProject({
+		entryName: path.basename(entry),
+		manifest,
+		pages,
+		assets: /* @__PURE__ */ new Map(),
+		issues: loadIssues
+	});
+	const refsToLoad = /* @__PURE__ */ new Set();
+	for (const page of partial.pages) for (const element of page.elements) if (element.elementType === "image") {
+		const ref = localAssetPath(element.src);
+		if (ref !== void 0) refsToLoad.add(ref);
+	}
+	const assets = /* @__PURE__ */ new Map();
+	let totalBytes = 0;
+	for (const ref of refsToLoad) {
+		let file;
+		try {
+			file = await confinedFile(root, ref, MAX_ASSET_BYTES);
+		} catch (error) {
+			loadIssues.push({
+				code: "file-read",
+				severity: "error",
+				file: ref,
+				message: `无法读取资源 ${ref}：${error instanceof Error ? error.message : String(error)}`
+			});
+			continue;
+		}
+		totalBytes += file.bytes.byteLength;
+		if (totalBytes > MAX_TOTAL_ASSET_BYTES) throw new Error("PPTD image resources exceed the aggregate byte limit");
+		const type = mediaType(ref, file.bytes);
+		if (type === void 0) {
+			loadIssues.push({
+				code: "invalid-resource",
+				severity: "error",
+				file: ref,
+				message: `图片资源格式或内容无效：${ref}`
+			});
+			continue;
+		}
+		assets.set(ref, {
+			path: ref,
+			mediaType: type,
+			bytes: file.bytes,
+			sha256: createHash("sha256").update(file.bytes).digest("hex")
+		});
+	}
+	return parsePptdProject({
+		entryName: path.basename(entry),
+		manifest,
+		pages,
+		assets,
+		issues: loadIssues
+	});
+}
+//#endregion
+export { resolvePptdEntry as a, renderPptdProject as i, loadPptdProject as n, recommendedTextCapacity as o, parsePptdProject as r, checkPptdProject as t };