@pptx-studio/model 0.3.0 → 0.4.0

package/dist/index.js

@@ -44,6 +44,7 @@ const MODEL_ERROR_CODES = [
 	"MODEL_TEXT_TYPEFACE",
 	"MODEL_TABLE_ATTR",
 	"MODEL_TABLE_STYLE",
+	"MODEL_TABLE_POSITION",
 	"BLIP_NO_EMBED",
 	"BLIP_DUOTONE",
 	"BLIP_CLR_CHANGE",
@@ -3502,15 +3503,11 @@ function terminusOf(context) {
 	};
 }
 /**
-* The list styles a shape reads, nearest first, ending at whichever terminus it
-* reaches.
-*
-* Exported because it *is* the finding: a caller that wants to show the user
-* where a value could have come from - the inspector's Overrides panel, layout
-* compatibility scoring - needs the same list the resolver walks, not a second
-* opinion about it.
+* The list styles a shape or a table cell reads, nearest first, ending at whichever terminus it
+* reaches. Exported so a caller that shows where a value could come from walks the same list.
 */
 function textLevels(context) {
+	if (context.cell !== void 0) return cellLevels(context, context.cell);
 	const levels = inheritanceChain(context.shape, context.sheet).map((link, index) => ({
 		style: link.shape.text?.lstStyle,
 		origin: index === 0 ? "shape" : link.origin,
@@ -3536,18 +3533,40 @@ function textLevels(context) {
 	return levels;
 }
 /**
-* The values left when every level has been asked and none of them said.
-*
-* Two quite different things, and which applies turns on one question: does the
-* master declare `p:txStyles` at all? If it does not, PowerPoint substitutes its
-* whole built-in set, and a body placeholder is 28 points with a hanging bullet
-* indent. If it does, there is no per-property backstop underneath it and what
-* remains is the floor - 18 points, no margin, no indent. Measured as two
-* separate probes precisely because the two are easy to conflate and differ on
-* every partially-specified master.
+* A table cell's walk (C9): its own list style, the table's style, then the master's `p:otherStyle`.
+* `p:defaultTextStyle` and the frame's placeholder chain are never read, as a shape's walk is.
+*/
+function cellLevels(context, cell) {
+	const { master } = terminusOf(context);
+	return [
+		{
+			style: cell.lstStyle,
+			origin: "cell",
+			sheet: context.sheet,
+			shape: context.shape
+		},
+		{
+			style: void 0,
+			run: cell.layer,
+			origin: "tableStyle",
+			sheet: context.sheet,
+			shape: context.shape
+		},
+		{
+			style: master?.txStyles?.other,
+			origin: "txStyles",
+			sheet: master,
+			shape: null
+		}
+	];
+}
+/**
+* The values left when every level has been asked and none of them said (ADR 0027).
+* A master with `p:txStyles` leaves `TEXT_FLOOR`; one without substitutes PowerPoint's built-ins.
 */
 function floorOf(context, level) {
-	const { bucket, master } = terminusOf(context);
+	const { bucket: frame, master } = terminusOf(context);
+	const bucket = context.cell === void 0 ? frame : null;
 	if (master?.txStyles !== void 0) return TEXT_FLOOR;
 	return BUILTIN_TEXT_STYLES[bucket ?? "other"][clampLevel(level)] ?? TEXT_FLOOR;
 }
@@ -3555,7 +3574,9 @@ function clampLevel(level) {
 	if (!Number.isInteger(level)) throw new ModelError("MODEL_TEXT_LEVEL", `paragraph level ${String(level)} is not an integer`);
 	return Math.max(0, Math.min(8, level));
 }
-function resolvedAt(value, level, explicit) {
+/** A value found at `level`: explicit when the text's own shape or table cell wrote that level. */
+function resolvedAt(value, level) {
+	const explicit = level.origin === "shape" || level.origin === "cell";
 	return {
 		value,
 		origin: level.origin,
@@ -3588,7 +3609,7 @@ function resolveParagraph(context, paragraph, pick) {
 		const props = entry.style?.levels[level];
 		if (props === void 0) continue;
 		const value = pick(props);
-		if (value !== void 0) return resolvedAt(value, entry, entry.origin === "shape");
+		if (value !== void 0) return resolvedAt(value, entry);
 	}
 }
 /**
@@ -3621,10 +3642,10 @@ function resolveRun(context, paragraph, run, pick) {
 	}
 	const level = clampLevel(paragraph.level);
 	for (const entry of textLevels(context)) {
-		const defRPr = entry.style?.levels[level]?.defRPr;
+		const defRPr = entry.run ?? entry.style?.levels[level]?.defRPr;
 		if (defRPr === void 0) continue;
 		const value = pick(defRPr);
-		if (value !== void 0) return resolvedAt(value, entry, entry.origin === "shape");
+		if (value !== void 0) return resolvedAt(value, entry);
 	}
 }
 /**
@@ -3822,8 +3843,8 @@ function resolveInsets(shape, sheet) {
 //#endregion
 //#region src/resolve/table.ts
 /**
-* Which style PowerPoint draws a table with. C8 measured one rule (ADR 0063): the built-in its
-* GUID names, in any case, and otherwise none; `ppt/tableStyles.xml` never changes the drawing.
+* Which style PowerPoint draws a table with (C8, ADR 0063), and what that style, the cells' own
+* `a:tcPr` and the table's `a:tblPr` give each cell and grid edge (C9, ADR 0064).
 */
 const NS_A = "http://schemas.openxmlformats.org/drawingml/2006/main";
 /** The part name a built-in's errors carry: it comes from no package. */
@@ -3846,7 +3867,305 @@ function tableStyleOf(table) {
 	const ref = table.props?.style;
 	return ref === void 0 ? null : builtinTableStyle(ref.id) ?? null;
 }
+/** The order the parts compose in, lowest first: C9 on every drawable table (ADR 0064). */
+const TABLE_PART_ORDER = [
+	"wholeTbl",
+	"band1H",
+	"band2H",
+	"band1V",
+	"band2V",
+	"lastCol",
+	"firstCol",
+	"lastRow",
+	"seCell",
+	"swCell",
+	"firstRow",
+	"neCell",
+	"nwCell"
+];
+const RANK = new Map(TABLE_PART_ORDER.map((p, i) => [p, i]));
+/**
+* The parts reaching grid position (row, col), highest first: ECMA-376's reading, which C9 found
+* alone fits (ADR 0064). Bands skip the rows and columns their end flags take, and a corner part
+* needs both of its flags.
+*/
+function tablePartsAt(props, rows, cols, row, col) {
+	const within = (n, size) => Number.isInteger(n) && n >= 0 && n < size;
+	if (!within(row, rows) || !within(col, cols)) throw new ModelError("MODEL_TABLE_POSITION", `no grid position ${String(row)},${String(col)} in ${String(rows)}x${String(cols)}`);
+	const parts = ["wholeTbl"];
+	const firstRow = props?.firstRow === true && row === 0;
+	const lastRow = props?.lastRow === true && row === rows - 1;
+	const firstCol = props?.firstCol === true && col === 0;
+	const lastCol = props?.lastCol === true && col === cols - 1;
+	if (props?.bandRow === true && !firstRow && !lastRow) parts.push((row - (props.firstRow ? 1 : 0)) % 2 === 0 ? "band1H" : "band2H");
+	if (props?.bandCol === true && !firstCol && !lastCol) parts.push((col - (props.firstCol ? 1 : 0)) % 2 === 0 ? "band1V" : "band2V");
+	if (firstRow) parts.push("firstRow");
+	if (lastRow) parts.push("lastRow");
+	if (firstCol) parts.push("firstCol");
+	if (lastCol) parts.push("lastCol");
+	if (firstRow && firstCol) parts.push("nwCell");
+	if (firstRow && lastCol) parts.push("neCell");
+	if (lastRow && firstCol) parts.push("swCell");
+	if (lastRow && lastCol) parts.push("seCell");
+	return parts.sort((a, b) => (RANK.get(b) ?? 0) - (RANK.get(a) ?? 0));
+}
+/** The grid cell at (row, col), or `null` beyond the table. */
+function cellAt(grid, row, col) {
+	return grid.positions[row]?.[col] ?? null;
+}
+/** The grid cell at (row, col); a position beyond the table throws. */
+function cellOf(grid, row, col) {
+	const cell = cellAt(grid, row, col);
+	if (cell === null) throw new ModelError("MODEL_TABLE_POSITION", `no grid position ${String(row)},${String(col)}`);
+	return cell;
+}
+/** A merged cell's parts, highest first: its anchor's, and every covered position's ends and corners (C9). */
+function partsOf(table, grid, cell) {
+	const pooled = new Set(tablePartsAt(table.props, grid.rows, grid.cols, cell.row, cell.col));
+	for (let row = cell.row; row < cell.row + cell.rows; row++) for (let col = cell.col; col < cell.col + cell.cols; col++) for (const part of tablePartsAt(table.props, grid.rows, grid.cols, row, col)) if (!BANDS.has(part)) pooled.add(part);
+	return [...pooled].sort((a, b) => (RANK.get(b) ?? 0) - (RANK.get(a) ?? 0));
+}
+const BANDS = /* @__PURE__ */ new Set([
+	"band1H",
+	"band2H",
+	"band1V",
+	"band2V"
+]);
+/** The edge an end part offers any cell outside it, whichever way the edge runs (C9, merged cells). */
+const KIND_EDGE = {
+	firstRow: "bottom",
+	lastRow: "top",
+	firstCol: "right",
+	lastCol: "left"
+};
+/**
+* The fill of the cell at grid position (row, col): its own `a:tcPr` fill, else the highest part
+* that states one. Parts compose per property (C9); `null` paints nothing, and one translucent fill
+* is painted alone, never over another part's.
+*/
+function tableCellFill(table, style, grid, row, col) {
+	const cell = cellOf(grid, row, col);
+	const own = cell.cell?.props?.fill;
+	if (own !== void 0) return {
+		value: {
+			kind: "value",
+			value: own
+		},
+		source: "tcPr"
+	};
+	if (style === null) return null;
+	for (const part of partsOf(table, grid, cell)) {
+		const fill = style.parts[part]?.cell?.fill;
+		if (fill !== void 0) return {
+			value: fill,
+			source: part
+		};
+	}
+	return null;
+}
+/** What paints under the cells: `a:tblPr`'s own fill in place of the style's `tblBg` (C9). */
+function tableBackground(table, style) {
+	const own = table.props?.fill;
+	if (own !== void 0) return {
+		value: {
+			kind: "value",
+			value: own
+		},
+		source: "tblPr"
+	};
+	const background = style?.background?.fill;
+	return background === void 0 ? null : {
+		value: background,
+		source: "tblBg"
+	};
+}
+/** PowerPoint's default grid: a 1-pt black line on every edge of a table that names no built-in (C8). */
+const DEFAULT_GRID_LINE = {
+	w: 12700,
+	cap: null,
+	cmpd: null,
+	algn: null,
+	fill: {
+		type: "solid",
+		color: {
+			space: "srgb",
+			hex: "000000",
+			transforms: []
+		}
+	},
+	dash: null,
+	join: null,
+	headEnd: null,
+	tailEnd: null
+};
+/** The side of the cell before (above, left of) and after an edge that faces it. */
+const FACING = {
+	h: {
+		before: "bottom",
+		after: "top",
+		inside: "insideH"
+	},
+	v: {
+		before: "right",
+		after: "left",
+		inside: "insideV"
+	}
+};
+/**
+* The line a grid edge draws: its owner's `a:tcPr` line, else the highest part of either cell that
+* states it, a part reaching both offering its inside edge (C9).
+* The owner is the cell before (above, left) where its anchor is level with the edge, else the cell
+* after where its anchor is, else the cell before; `null` inside a merged cell.
+*/
+function tableEdgeLine(table, style, grid, edge) {
+	const facing = FACING[edge.axis];
+	const before = edge.axis === "h" ? cellAt(grid, edge.row - 1, edge.col) : cellAt(grid, edge.row, edge.col - 1);
+	const after = edge.row < grid.rows && edge.col < grid.cols ? cellAt(grid, edge.row, edge.col) : null;
+	if (before === null && after === null) throw new ModelError("MODEL_TABLE_POSITION", `no grid edge ${edge.axis}${String(edge.row)},${String(edge.col)}`);
+	if (before !== null && before === after) return null;
+	const level = (cell) => cell !== null && (edge.axis === "h" ? edge.col === cell.col : edge.row === cell.row);
+	const direct = before !== null && (level(before) || !level(after)) ? before.cell?.props?.borders[facing.before] : after?.cell?.props?.borders[facing.after];
+	if (direct !== void 0) return {
+		value: {
+			kind: "value",
+			value: direct
+		},
+		source: "tcPr"
+	};
+	if (style === null) return {
+		value: {
+			kind: "value",
+			value: DEFAULT_GRID_LINE
+		},
+		source: "grid"
+	};
+	const partsBefore = before === null ? [] : partsOf(table, grid, before);
+	const partsAfter = after === null ? [] : partsOf(table, grid, after);
+	const all = [.../* @__PURE__ */ new Set([...partsBefore, ...partsAfter])].sort((a, b) => (RANK.get(b) ?? 0) - (RANK.get(a) ?? 0));
+	for (const part of all) {
+		const inBefore = partsBefore.includes(part);
+		const inAfter = partsAfter.includes(part);
+		const geometric = inBefore && inAfter ? facing.inside : inBefore ? facing.before : facing.after;
+		const role = (before !== null && after !== null && inBefore !== inAfter ? KIND_EDGE[part] : void 0) ?? geometric;
+		const stated = style.parts[part]?.cell?.borders?.[role];
+		if (stated !== void 0) return {
+			value: stated,
+			source: part
+		};
+	}
+	return null;
+}
+const themeFace = (typeface) => ({
+	typeface,
+	panose: void 0,
+	pitchFamily: void 0,
+	charset: void 0
+});
+function runProps(node, fields) {
+	return {
+		sz: void 0,
+		b: void 0,
+		i: void 0,
+		u: void 0,
+		strike: void 0,
+		cap: void 0,
+		spc: void 0,
+		kern: void 0,
+		baseline: void 0,
+		noProof: void 0,
+		lang: void 0,
+		altLang: void 0,
+		latin: void 0,
+		ea: void 0,
+		cs: void 0,
+		sym: void 0,
+		fill: void 0,
+		line: void 0,
+		effects: void 0,
+		highlight: void 0,
+		node,
+		...fields
+	};
+}
+/**
+* What the style gives the text of the cell at (row, col): bold, italic, face and colour, each from
+* the highest part that states it (C9), as run properties for the text cascade.
+* The default grid gives `tx1` in the minor face whatever the flags; `node` is the style's element,
+* or the table's for the grid.
+*/
+function tableTextLayer(table, style, grid, row, col) {
+	const cell = cellOf(grid, row, col);
+	const minor = {
+		latin: themeFace("+mn-lt"),
+		ea: themeFace("+mn-ea"),
+		cs: themeFace("+mn-cs")
+	};
+	if (style === null) return runProps(table.node, {
+		...minor,
+		fill: {
+			type: "solid",
+			color: {
+				space: "scheme",
+				name: "tx1",
+				transforms: []
+			}
+		}
+	});
+	const texts = partsOf(table, grid, cell).map((part) => style.parts[part]?.text).filter((t) => t !== void 0);
+	const b = texts.find((t) => t.b !== void 0)?.b;
+	const i = texts.find((t) => t.i !== void 0)?.i;
+	const color = texts.find((t) => t.color !== void 0)?.color;
+	const font = texts.find((t) => t.font !== void 0)?.font;
+	const onOff = (v) => v === "on" ? true : v === "off" ? false : void 0;
+	let faces = {};
+	if (font?.kind === "ref" && font.ref.idx !== "none") {
+		const key = font.ref.idx === "major" ? "mj" : "mn";
+		faces = {
+			latin: themeFace(`+${key}-lt`),
+			ea: themeFace(`+${key}-ea`),
+			cs: themeFace(`+${key}-cs`)
+		};
+	} else if (font?.kind === "value") {
+		const face = (name) => name === null ? void 0 : themeFace(name);
+		faces = {
+			latin: face(font.value.latin),
+			ea: face(font.value.ea),
+			cs: face(font.value.cs)
+		};
+	}
+	return runProps(style.node, {
+		b: onOff(b),
+		i: onOff(i),
+		...faces,
+		...color === void 0 ? {} : { fill: {
+			type: "solid",
+			color
+		} }
+	});
+}
+/** A style fill with a `fillRef` followed into the theme, and the colour `phClr` takes in it. */
+function themedFill(fill, theme, colors) {
+	if (fill.kind === "value") return {
+		fill: fill.value,
+		phClr: null
+	};
+	return {
+		fill: styleMatrixFill(fill.ref, theme),
+		phClr: fill.ref.color === null ? null : resolveColor(fill.ref.color, colors)
+	};
+}
+/** A style line with an `lnRef` followed into the theme, and the colour `phClr` takes in it. */
+function themedLine(line, theme, colors) {
+	if (line.kind === "value") return {
+		line: line.value,
+		phClr: null
+	};
+	return {
+		line: styleMatrixLine(line.ref, theme),
+		phClr: line.ref.color === null ? null : resolveColor(line.ref.color, colors)
+	};
+}
 //#endregion
-export { BUILTIN_TABLE_STYLES, BUILTIN_TEXT_STYLES, COLOR_TRANSFORM_OPS, DEFAULT_PLACEHOLDER_IDX, DEFAULT_PLACEHOLDER_TYPE, INVENTED_COLUMN_WIDTH, LEVELS, MASTER_PLACEHOLDER_TYPES, MODEL_ERROR_CODES, ModelError, ORPHAN_RECT, PLACEHOLDER_TYPES, STYLE_MATRIX_OFFSET, TABLE_URI, TEXT_FLOOR, backgroundSheet, bucketOf, builtinTableStyle, colorContextOf, colorMapOf, floorOf, inheritanceChain, isModelError, loadDocument, masterOf, masterPlaceholderType, matchInLayout, matchInMaster, normalizePlaceholder, parseBodyProps, parseBodyPropsChild, parseClrMap, parseColorChild, parseColorElement, parseDefaultTextStyle, parseEffects, parseFill, parseFillElement, parseGeometry, parseLine, parseLineElement, parseListStyle, parseParaProps, parseRunProps, parseSheet, parseTable, parseTableChild, parseTableStyle, parseTextBody, parseTextBodyChild, parseTextStyles, parseTheme, phClrOf, placeholders, requestedTypefaces, resolve, resolveAnchor, resolveAnchorCtr, resolveAppearance, resolveBackground, resolveBackgroundColor, resolveBody, resolveBulletAutoNum, resolveBulletBlip, resolveBulletChar, resolveBulletColor, resolveBulletFont, resolveBulletKind, resolveBulletSize, resolveColumns, resolveIndent, resolveInsets, resolveLatinTypeface, resolveMarginLeft, resolveOnSheet, resolveParagraph, resolveRun, resolveSize, resolveSolidFill, resolveTypeface, resolveTypefaceOf, resolveVertical, resolveWrap, resolveXfrm, schemeOf, sheetChain, styleMatrixEffects, styleMatrixFill, styleMatrixLine, styleMatrixTarget, tableGrid, tableStyleOf, textLevels, themeFontRef, themeOf };
+export { BUILTIN_TABLE_STYLES, BUILTIN_TEXT_STYLES, COLOR_TRANSFORM_OPS, DEFAULT_GRID_LINE, DEFAULT_PLACEHOLDER_IDX, DEFAULT_PLACEHOLDER_TYPE, INVENTED_COLUMN_WIDTH, LEVELS, MASTER_PLACEHOLDER_TYPES, MODEL_ERROR_CODES, ModelError, ORPHAN_RECT, PLACEHOLDER_TYPES, STYLE_MATRIX_OFFSET, TABLE_PART_ORDER, TABLE_URI, TEXT_FLOOR, backgroundSheet, bucketOf, builtinTableStyle, colorContextOf, colorMapOf, floorOf, inheritanceChain, isModelError, loadDocument, masterOf, masterPlaceholderType, matchInLayout, matchInMaster, normalizePlaceholder, parseBodyProps, parseBodyPropsChild, parseClrMap, parseColorChild, parseColorElement, parseDefaultTextStyle, parseEffects, parseFill, parseFillElement, parseGeometry, parseLine, parseLineElement, parseListStyle, parseParaProps, parseRunProps, parseSheet, parseTable, parseTableChild, parseTableStyle, parseTextBody, parseTextBodyChild, parseTextStyles, parseTheme, phClrOf, placeholders, requestedTypefaces, resolve, resolveAnchor, resolveAnchorCtr, resolveAppearance, resolveBackground, resolveBackgroundColor, resolveBody, resolveBulletAutoNum, resolveBulletBlip, resolveBulletChar, resolveBulletColor, resolveBulletFont, resolveBulletKind, resolveBulletSize, resolveColumns, resolveIndent, resolveInsets, resolveLatinTypeface, resolveMarginLeft, resolveOnSheet, resolveParagraph, resolveRun, resolveSize, resolveSolidFill, resolveTypeface, resolveTypefaceOf, resolveVertical, resolveWrap, resolveXfrm, schemeOf, sheetChain, styleMatrixEffects, styleMatrixFill, styleMatrixLine, styleMatrixTarget, tableBackground, tableCellFill, tableEdgeLine, tableGrid, tablePartsAt, tableStyleOf, tableTextLayer, textLevels, themeFontRef, themeOf, themedFill, themedLine };
 
 //# sourceMappingURL=index.js.map