ooxml.js 2.4.0 → 2.5.0

package/dist/typed/pptx/read.js

@@ -0,0 +1,362 @@
+import { base64ToBytes } from "../../util/base64.js";
+import { attr, childrenWithTag, elementsWithTag, resolveRelationships, rootElement, textContent } from "../util.js";
+import { DocumentMetadataSchema, readCoreProperties } from "../shared/metadata.js";
+import { sniffImageFormat } from "../../image/sniff.js";
+import { drawingMlFontSizeToPt, emuToPt } from "../shared/units.js";
+import { applyGroupTransform, readGroupXfrm, readSolidFillColor, readXfrm } from "../shared/drawingml.js";
+import { assignSourcePaths } from "../shared/source-path.js";
+import { readPlaceholderKey, readRunPropertiesFromElement, resolveDefaultRunProperties, resolvePlaceholderXfrm, resolveSlideInheritance } from "./inherit.js";
+import { z } from "zod";
+import { ContentSlideSchema, SLIDE_SIZE_WIDESCREEN } from "document-schema.js";
+//#region src/typed/pptx/read.ts
+const PptxDocumentSchema = z.object({
+	metadata: DocumentMetadataSchema,
+	slides: z.array(ContentSlideSchema)
+});
+const PRESENTATION_PATH = "ppt/presentation.xml";
+const TABLE_GRAPHIC_URI = "http://schemas.openxmlformats.org/drawingml/2006/table";
+function readSlideSize(presentationRoot) {
+	const sldSz = presentationRoot === void 0 ? void 0 : childrenWithTag(presentationRoot, "p:sldSz")[0];
+	const cx = sldSz === void 0 ? void 0 : attr(sldSz, "cx");
+	const cy = sldSz === void 0 ? void 0 : attr(sldSz, "cy");
+	return cx === void 0 || cy === void 0 ? SLIDE_SIZE_WIDESCREEN : {
+		widthPt: emuToPt(Number(cx)),
+		heightPt: emuToPt(Number(cy))
+	};
+}
+function readSlidePathsInOrder(pkg, presentationRoot) {
+	if (presentationRoot === void 0) return [];
+	const sldIdLst = childrenWithTag(presentationRoot, "p:sldIdLst")[0];
+	if (sldIdLst === void 0) return [];
+	const presentationRels = resolveRelationships(pkg, PRESENTATION_PATH);
+	const paths = [];
+	for (const sldId of childrenWithTag(sldIdLst, "p:sldId")) {
+		const rId = attr(sldId, "r:id");
+		const rel = rId === void 0 ? void 0 : presentationRels.get(rId);
+		if (rel !== void 0) paths.push(rel.target);
+	}
+	return paths;
+}
+function shapeName(shape) {
+	const cNvPr = elementsWithTag([shape], "p:cNvPr")[0];
+	return cNvPr === void 0 ? void 0 : attr(cNvPr, "name");
+}
+function mergeRunProperties(base, override) {
+	return {
+		fontFamily: override.fontFamily ?? base.fontFamily,
+		sizePt: override.sizePt ?? base.sizePt,
+		bold: override.bold ?? base.bold,
+		italic: override.italic ?? base.italic,
+		color: override.color ?? base.color
+	};
+}
+function isUnderlined(rPr) {
+	if (rPr === void 0) return;
+	const u = attr(rPr, "u");
+	return u === void 0 ? void 0 : u !== "none";
+}
+function isStrikethrough(rPr) {
+	if (rPr === void 0) return;
+	const strike = attr(rPr, "strike");
+	return strike === void 0 ? void 0 : strike !== "noStrike";
+}
+function readHyperlink(rPr, slideRels) {
+	if (rPr === void 0) return;
+	const hlink = childrenWithTag(rPr, "a:hlinkClick")[0];
+	const rId = hlink === void 0 ? void 0 : attr(hlink, "r:id");
+	const rel = rId === void 0 ? void 0 : slideRels.get(rId);
+	return rel?.targetMode === "External" ? rel.target : void 0;
+}
+function readRun(runEl, cascadeBase, context, slideRels) {
+	const rPr = childrenWithTag(runEl, "a:rPr")[0];
+	const merged = mergeRunProperties(cascadeBase, rPr === void 0 ? {} : readRunPropertiesFromElement(rPr, context));
+	const tEl = childrenWithTag(runEl, "a:t")[0];
+	return {
+		text: tEl === void 0 ? "" : textContent(tEl),
+		bold: merged.bold,
+		italic: merged.italic,
+		underline: isUnderlined(rPr),
+		strike: isStrikethrough(rPr),
+		fontFamily: merged.fontFamily,
+		sizePt: merged.sizePt,
+		color: merged.color,
+		hyperlink: readHyperlink(rPr, slideRels)
+	};
+}
+function readAlignment(algn) {
+	if (algn === "l") return "left";
+	if (algn === "ctr") return "center";
+	if (algn === "r") return "right";
+	if (algn === "just" || algn === "justLow") return "justify";
+}
+function readAbsoluteSpacingPt(spc) {
+	if (spc === void 0) return;
+	const pts = childrenWithTag(spc, "a:spcPts")[0];
+	const val = pts === void 0 ? void 0 : attr(pts, "val");
+	return val === void 0 ? void 0 : drawingMlFontSizeToPt(Number(val));
+}
+function readLineSpacingMultiplier(pPr) {
+	const lnSpc = pPr === void 0 ? void 0 : childrenWithTag(pPr, "a:lnSpc")[0];
+	const pct = lnSpc === void 0 ? void 0 : childrenWithTag(lnSpc, "a:spcPct")[0];
+	const val = pct === void 0 ? void 0 : attr(pct, "val");
+	return val === void 0 ? void 0 : Number(val) / 1e5;
+}
+function readParagraph(pEl, placeholderType, context, slideRels) {
+	const pPr = childrenWithTag(pEl, "a:pPr")[0];
+	const masterDefaults = resolveDefaultRunProperties(placeholderType, pPr === void 0 ? 0 : Number(attr(pPr, "lvl") ?? "0"), context);
+	const pPrDefRPr = pPr === void 0 ? void 0 : childrenWithTag(pPr, "a:defRPr")[0];
+	const paragraphDefaults = pPrDefRPr === void 0 ? masterDefaults : mergeRunProperties(masterDefaults, readRunPropertiesFromElement(pPrDefRPr, context));
+	const runs = [];
+	for (const child of pEl.children) {
+		if (child.type !== "element") continue;
+		if (child.tag === "a:r" || child.tag === "a:fld") runs.push(readRun(child, paragraphDefaults, context, slideRels));
+		else if (child.tag === "a:br") runs.push({ text: "\n" });
+	}
+	const marL = pPr === void 0 ? void 0 : attr(pPr, "marL");
+	const indent = pPr === void 0 ? void 0 : attr(pPr, "indent");
+	return {
+		kind: "paragraph",
+		runs,
+		alignment: pPr === void 0 ? void 0 : readAlignment(attr(pPr, "algn")),
+		spacingBeforePt: readAbsoluteSpacingPt(pPr === void 0 ? void 0 : childrenWithTag(pPr, "a:spcBef")[0]),
+		spacingAfterPt: readAbsoluteSpacingPt(pPr === void 0 ? void 0 : childrenWithTag(pPr, "a:spcAft")[0]),
+		lineSpacing: readLineSpacingMultiplier(pPr),
+		indentLeftPt: marL === void 0 ? void 0 : emuToPt(Number(marL)),
+		indentFirstLinePt: indent === void 0 ? void 0 : emuToPt(Number(indent))
+	};
+}
+function textBodyParagraphs(txBody, placeholderType, context, slideRels) {
+	return txBody === void 0 ? [] : childrenWithTag(txBody, "a:p").map((p) => readParagraph(p, placeholderType, context, slideRels));
+}
+const DEFAULT_INSET_LEFT_RIGHT_EMU = 91440;
+const DEFAULT_INSET_TOP_BOTTOM_EMU = 45720;
+const NO_TEXT_BODY_EXTRAS = {
+	insetLeftPt: 0,
+	insetTopPt: 0,
+	insetRightPt: 0,
+	insetBottomPt: 0,
+	fontScale: void 0,
+	lineSpacingReduction: void 0
+};
+function readShapeTextExtras(txBody) {
+	if (txBody === void 0) return NO_TEXT_BODY_EXTRAS;
+	const bodyPr = childrenWithTag(txBody, "a:bodyPr")[0];
+	const lIns = bodyPr === void 0 ? void 0 : attr(bodyPr, "lIns");
+	const tIns = bodyPr === void 0 ? void 0 : attr(bodyPr, "tIns");
+	const rIns = bodyPr === void 0 ? void 0 : attr(bodyPr, "rIns");
+	const bIns = bodyPr === void 0 ? void 0 : attr(bodyPr, "bIns");
+	const normAutofit = bodyPr === void 0 ? void 0 : childrenWithTag(bodyPr, "a:normAutofit")[0];
+	const fontScale = normAutofit === void 0 ? void 0 : attr(normAutofit, "fontScale");
+	const lnSpcReduction = normAutofit === void 0 ? void 0 : attr(normAutofit, "lnSpcReduction");
+	return {
+		insetLeftPt: emuToPt(lIns === void 0 ? DEFAULT_INSET_LEFT_RIGHT_EMU : Number(lIns)),
+		insetTopPt: emuToPt(tIns === void 0 ? DEFAULT_INSET_TOP_BOTTOM_EMU : Number(tIns)),
+		insetRightPt: emuToPt(rIns === void 0 ? DEFAULT_INSET_LEFT_RIGHT_EMU : Number(rIns)),
+		insetBottomPt: emuToPt(bIns === void 0 ? DEFAULT_INSET_TOP_BOTTOM_EMU : Number(bIns)),
+		fontScale: fontScale === void 0 ? void 0 : Number(fontScale) / 1e5,
+		lineSpacingReduction: lnSpcReduction === void 0 ? void 0 : Number(lnSpcReduction) / 1e5
+	};
+}
+function resolveShapeFrame(shape, context, parentTransform) {
+	const key = readPlaceholderKey(shape);
+	const spPr = childrenWithTag(shape, "p:spPr")[0];
+	const xfrm = (spPr === void 0 ? void 0 : readXfrm(childrenWithTag(spPr, "a:xfrm")[0])) ?? (key === void 0 ? void 0 : resolvePlaceholderXfrm(key, context));
+	if (xfrm === void 0) return;
+	const localFrame = {
+		xPt: xfrm.xPt,
+		yPt: xfrm.yPt,
+		widthPt: xfrm.widthPt,
+		heightPt: xfrm.heightPt
+	};
+	return {
+		frame: parentTransform === void 0 ? localFrame : applyGroupTransform(parentTransform, localFrame),
+		rotationDeg: xfrm.rotationDeg === 0 ? void 0 : xfrm.rotationDeg
+	};
+}
+function readSpShape(sp, context, slideRels, parentTransform) {
+	const resolved = resolveShapeFrame(sp, context, parentTransform);
+	if (resolved === void 0) return;
+	const key = readPlaceholderKey(sp);
+	const txBody = childrenWithTag(sp, "p:txBody")[0];
+	const blocks = textBodyParagraphs(txBody, key?.type, context, slideRels);
+	const extras = readShapeTextExtras(txBody);
+	return {
+		name: shapeName(sp),
+		frame: resolved.frame,
+		rotationDeg: resolved.rotationDeg,
+		...extras,
+		blocks
+	};
+}
+function readPicShape(pic, context, slideRels, pkg, parentTransform) {
+	const resolved = resolveShapeFrame(pic, context, parentTransform);
+	if (resolved === void 0) return;
+	const blipFill = childrenWithTag(pic, "p:blipFill")[0];
+	const blip = blipFill === void 0 ? void 0 : childrenWithTag(blipFill, "a:blip")[0];
+	const rId = blip === void 0 ? void 0 : attr(blip, "r:embed");
+	const rel = rId === void 0 ? void 0 : slideRels.get(rId);
+	const mediaPart = rel === void 0 ? void 0 : pkg.parts[rel.target];
+	const blocks = [];
+	if (mediaPart?.kind === "binary") {
+		const format = sniffImageFormat(base64ToBytes(mediaPart.base64));
+		if (format !== void 0) {
+			const image = {
+				kind: "image",
+				format,
+				base64: mediaPart.base64,
+				widthPt: resolved.frame.widthPt,
+				heightPt: resolved.frame.heightPt
+			};
+			blocks.push(image);
+		}
+	}
+	return {
+		name: shapeName(pic),
+		frame: resolved.frame,
+		rotationDeg: resolved.rotationDeg,
+		...NO_TEXT_BODY_EXTRAS,
+		blocks
+	};
+}
+function readTableCell(tc, context, slideRels) {
+	const hMerge = attr(tc, "hMerge");
+	const vMerge = attr(tc, "vMerge");
+	if (hMerge === "1" || vMerge === "1") return { blocks: [] };
+	const tcPr = childrenWithTag(tc, "a:tcPr")[0];
+	const background = readSolidFillColor(tcPr === void 0 ? void 0 : childrenWithTag(tcPr, "a:solidFill")[0], context.colorMap, context.theme);
+	const txBody = childrenWithTag(tc, "a:txBody")[0];
+	const gridSpan = attr(tc, "gridSpan");
+	const rowSpan = attr(tc, "rowSpan");
+	return {
+		blocks: textBodyParagraphs(txBody, void 0, context, slideRels),
+		colSpan: gridSpan === void 0 ? void 0 : Number(gridSpan),
+		rowSpan: rowSpan === void 0 ? void 0 : Number(rowSpan),
+		background
+	};
+}
+function readTable(tbl, context, slideRels) {
+	const tblGrid = childrenWithTag(tbl, "a:tblGrid")[0];
+	const columnWidthsPt = tblGrid === void 0 ? [] : childrenWithTag(tblGrid, "a:gridCol").map((col) => emuToPt(Number(attr(col, "w") ?? "0")));
+	return {
+		kind: "table",
+		rows: childrenWithTag(tbl, "a:tr").map((tr) => {
+			const h = attr(tr, "h");
+			return {
+				cells: childrenWithTag(tr, "a:tc").map((tc) => readTableCell(tc, context, slideRels)),
+				heightPt: h === void 0 ? void 0 : emuToPt(Number(h))
+			};
+		}),
+		columnWidthsPt
+	};
+}
+function readGraphicFrameShape(gf, context, slideRels, parentTransform) {
+	const xfrm = readXfrm(childrenWithTag(gf, "p:xfrm")[0]);
+	if (xfrm === void 0) return;
+	const localFrame = {
+		xPt: xfrm.xPt,
+		yPt: xfrm.yPt,
+		widthPt: xfrm.widthPt,
+		heightPt: xfrm.heightPt
+	};
+	const frame = parentTransform === void 0 ? localFrame : applyGroupTransform(parentTransform, localFrame);
+	const rotationDeg = xfrm.rotationDeg === 0 ? void 0 : xfrm.rotationDeg;
+	const graphic = childrenWithTag(gf, "a:graphic")[0];
+	const graphicData = graphic === void 0 ? void 0 : childrenWithTag(graphic, "a:graphicData")[0];
+	const tbl = (graphicData === void 0 ? void 0 : attr(graphicData, "uri")) === TABLE_GRAPHIC_URI && graphicData !== void 0 ? childrenWithTag(graphicData, "a:tbl")[0] : void 0;
+	const blocks = tbl === void 0 ? [] : [readTable(tbl, context, slideRels)];
+	return {
+		name: shapeName(gf),
+		frame,
+		rotationDeg,
+		...NO_TEXT_BODY_EXTRAS,
+		blocks
+	};
+}
+function walkShapeTreeChildren(children, parentTransform, context, slideRels, pkg, out) {
+	for (const node of children) {
+		if (node.type !== "element") continue;
+		if (node.tag === "p:sp") {
+			const shape = readSpShape(node, context, slideRels, parentTransform);
+			if (shape !== void 0) out.push(shape);
+		} else if (node.tag === "p:pic") {
+			const shape = readPicShape(node, context, slideRels, pkg, parentTransform);
+			if (shape !== void 0) out.push(shape);
+		} else if (node.tag === "p:graphicFrame") {
+			const shape = readGraphicFrameShape(node, context, slideRels, parentTransform);
+			if (shape !== void 0) out.push(shape);
+		} else if (node.tag === "p:grpSp") {
+			const grpSpPr = childrenWithTag(node, "p:grpSpPr")[0];
+			const composed = composeGroupTransform(readGroupXfrm(grpSpPr === void 0 ? void 0 : childrenWithTag(grpSpPr, "a:xfrm")[0]), parentTransform);
+			walkShapeTreeChildren(node.children, composed, context, slideRels, pkg, out);
+		}
+	}
+}
+function composeGroupTransform(own, parent) {
+	if (own === void 0) return;
+	if (parent === void 0) return own;
+	const absolute = applyGroupTransform(parent, {
+		xPt: own.offXPt,
+		yPt: own.offYPt,
+		widthPt: own.extWidthPt,
+		heightPt: own.extHeightPt
+	});
+	return {
+		...own,
+		offXPt: absolute.xPt,
+		offYPt: absolute.yPt,
+		extWidthPt: absolute.widthPt,
+		extHeightPt: absolute.heightPt
+	};
+}
+const NOTES_SLIDE_REL_SUFFIX = "/notesSlide";
+function readNotes(pkg, slidePath) {
+	let notesPath;
+	for (const rel of resolveRelationships(pkg, slidePath).values()) if (rel.type.endsWith(NOTES_SLIDE_REL_SUFFIX)) {
+		notesPath = rel.target;
+		break;
+	}
+	if (notesPath === void 0) return "";
+	const notesRoot = rootElement(pkg.parts[notesPath]);
+	if (notesRoot === void 0) return "";
+	const bodyShape = elementsWithTag([notesRoot], "p:sp").find((shape) => {
+		const key = readPlaceholderKey(shape);
+		return key !== void 0 && (key.type === void 0 || key.type === "body");
+	});
+	if (bodyShape !== void 0) {
+		const txBody = childrenWithTag(bodyShape, "p:txBody")[0];
+		if (txBody !== void 0) return elementsWithTag(txBody.children, "a:t").map(textContent).join("");
+	}
+	return elementsWithTag([notesRoot], "a:t").map(textContent).join("");
+}
+function readSlide(pkg, slidePath, size) {
+	const slideRoot = rootElement(pkg.parts[slidePath]);
+	const context = resolveSlideInheritance(pkg, slidePath);
+	const slideRels = resolveRelationships(pkg, slidePath);
+	const cSld = slideRoot === void 0 ? void 0 : childrenWithTag(slideRoot, "p:cSld")[0];
+	const spTree = cSld === void 0 ? void 0 : childrenWithTag(cSld, "p:spTree")[0];
+	const shapes = [];
+	if (spTree !== void 0) walkShapeTreeChildren(spTree.children, void 0, context, slideRels, pkg, shapes);
+	return {
+		size,
+		shapes,
+		notes: readNotes(pkg, slidePath)
+	};
+}
+function readPptx(pkg) {
+	const presentationRoot = rootElement(pkg.parts[PRESENTATION_PATH]);
+	const size = readSlideSize(presentationRoot);
+	const slides = readSlidePathsInOrder(pkg, presentationRoot).map((slidePath) => readSlide(pkg, slidePath, size));
+	slides.forEach((slide, slideIndex) => {
+		slide.shapes.forEach((shape, shapeIndex) => {
+			const shapePath = `slides[${slideIndex}].shapes[${shapeIndex}]`;
+			shape.sourcePath = shapePath;
+			assignSourcePaths(shape.blocks, shapePath);
+		});
+	});
+	return {
+		metadata: readCoreProperties(pkg),
+		slides
+	};
+}
+//#endregion
+export { PptxDocumentSchema, readPptx };

package/dist/typed/shared/color.cjs

@@ -0,0 +1,85 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/typed/shared/color.ts
+const OOXML_PERCENT_SCALE = 1e5;
+function clamp01(x) {
+	return Math.max(0, Math.min(1, x));
+}
+function srgbToLinear(c) {
+	return c <= .04045 ? c / 12.92 : ((c + .055) / 1.055) ** 2.4;
+}
+function linearToSrgb(c) {
+	return c <= .0031308 ? c * 12.92 : 1.055 * c ** (1 / 2.4) - .055;
+}
+function applyShadeOrTint(color, kind, value) {
+	const pct = value / OOXML_PERCENT_SCALE;
+	const transform = kind === "shade" ? (linear) => linear * pct : (linear) => 1 - (1 - linear) * pct;
+	return {
+		r: clamp01(linearToSrgb(transform(srgbToLinear(color.r)))),
+		g: clamp01(linearToSrgb(transform(srgbToLinear(color.g)))),
+		b: clamp01(linearToSrgb(transform(srgbToLinear(color.b))))
+	};
+}
+function rgbToHsl(color) {
+	const { r, g, b } = color;
+	const max = Math.max(r, g, b);
+	const min = Math.min(r, g, b);
+	const l = (max + min) / 2;
+	if (max === min) return {
+		h: 0,
+		s: 0,
+		l
+	};
+	const d = max - min;
+	const s = l > .5 ? d / (2 - max - min) : d / (max + min);
+	let h;
+	if (max === r) h = (g - b) / d + (g < b ? 6 : 0);
+	else if (max === g) h = (b - r) / d + 2;
+	else h = (r - g) / d + 4;
+	return {
+		h: h * 60,
+		s,
+		l
+	};
+}
+function hueToRgbComponent(p, q, hue) {
+	let t = hue;
+	if (t < 0) t += 1;
+	if (t > 1) t -= 1;
+	if (t < 1 / 6) return p + (q - p) * 6 * t;
+	if (t < 1 / 2) return q;
+	if (t < 2 / 3) return p + (q - p) * (2 / 3 - t) * 6;
+	return p;
+}
+function hslToRgb(hsl) {
+	const { h, s, l } = hsl;
+	if (s === 0) return {
+		r: l,
+		g: l,
+		b: l
+	};
+	const q = l < .5 ? l * (1 + s) : l + s - l * s;
+	const p = 2 * l - q;
+	const hk = h / 360;
+	return {
+		r: clamp01(hueToRgbComponent(p, q, hk + 1 / 3)),
+		g: clamp01(hueToRgbComponent(p, q, hk)),
+		b: clamp01(hueToRgbComponent(p, q, hk - 1 / 3))
+	};
+}
+function applyLumModOrOff(color, kind, value) {
+	const hsl = rgbToHsl(color);
+	const pct = value / OOXML_PERCENT_SCALE;
+	const l = clamp01(kind === "lumMod" ? hsl.l * pct : hsl.l + pct);
+	return hslToRgb({
+		...hsl,
+		l
+	});
+}
+function applyColorTransforms(base, transforms) {
+	let color = base;
+	for (const t of transforms) if (t.kind === "shade" || t.kind === "tint") color = applyShadeOrTint(color, t.kind, t.value);
+	for (const t of transforms) if (t.kind === "lumMod" || t.kind === "lumOff") color = applyLumModOrOff(color, t.kind, t.value);
+	return color;
+}
+//#endregion
+exports.applyColorTransforms = applyColorTransforms;

package/dist/typed/shared/color.d.cts

@@ -0,0 +1,9 @@
+import { Color } from "document-schema.js";
+//#region src/typed/shared/color.d.ts
+interface ColorTransform {
+  readonly kind: 'shade' | 'tint' | 'lumMod' | 'lumOff';
+  readonly value: number;
+}
+declare function applyColorTransforms(base: Color, transforms: readonly ColorTransform[]): Color;
+//#endregion
+export { ColorTransform, applyColorTransforms };

package/dist/typed/shared/color.d.ts

@@ -0,0 +1,9 @@
+import { Color } from "document-schema.js";
+//#region src/typed/shared/color.d.ts
+interface ColorTransform {
+  readonly kind: 'shade' | 'tint' | 'lumMod' | 'lumOff';
+  readonly value: number;
+}
+declare function applyColorTransforms(base: Color, transforms: readonly ColorTransform[]): Color;
+//#endregion
+export { ColorTransform, applyColorTransforms };

package/dist/typed/shared/color.js

@@ -0,0 +1,84 @@
+//#region src/typed/shared/color.ts
+const OOXML_PERCENT_SCALE = 1e5;
+function clamp01(x) {
+	return Math.max(0, Math.min(1, x));
+}
+function srgbToLinear(c) {
+	return c <= .04045 ? c / 12.92 : ((c + .055) / 1.055) ** 2.4;
+}
+function linearToSrgb(c) {
+	return c <= .0031308 ? c * 12.92 : 1.055 * c ** (1 / 2.4) - .055;
+}
+function applyShadeOrTint(color, kind, value) {
+	const pct = value / OOXML_PERCENT_SCALE;
+	const transform = kind === "shade" ? (linear) => linear * pct : (linear) => 1 - (1 - linear) * pct;
+	return {
+		r: clamp01(linearToSrgb(transform(srgbToLinear(color.r)))),
+		g: clamp01(linearToSrgb(transform(srgbToLinear(color.g)))),
+		b: clamp01(linearToSrgb(transform(srgbToLinear(color.b))))
+	};
+}
+function rgbToHsl(color) {
+	const { r, g, b } = color;
+	const max = Math.max(r, g, b);
+	const min = Math.min(r, g, b);
+	const l = (max + min) / 2;
+	if (max === min) return {
+		h: 0,
+		s: 0,
+		l
+	};
+	const d = max - min;
+	const s = l > .5 ? d / (2 - max - min) : d / (max + min);
+	let h;
+	if (max === r) h = (g - b) / d + (g < b ? 6 : 0);
+	else if (max === g) h = (b - r) / d + 2;
+	else h = (r - g) / d + 4;
+	return {
+		h: h * 60,
+		s,
+		l
+	};
+}
+function hueToRgbComponent(p, q, hue) {
+	let t = hue;
+	if (t < 0) t += 1;
+	if (t > 1) t -= 1;
+	if (t < 1 / 6) return p + (q - p) * 6 * t;
+	if (t < 1 / 2) return q;
+	if (t < 2 / 3) return p + (q - p) * (2 / 3 - t) * 6;
+	return p;
+}
+function hslToRgb(hsl) {
+	const { h, s, l } = hsl;
+	if (s === 0) return {
+		r: l,
+		g: l,
+		b: l
+	};
+	const q = l < .5 ? l * (1 + s) : l + s - l * s;
+	const p = 2 * l - q;
+	const hk = h / 360;
+	return {
+		r: clamp01(hueToRgbComponent(p, q, hk + 1 / 3)),
+		g: clamp01(hueToRgbComponent(p, q, hk)),
+		b: clamp01(hueToRgbComponent(p, q, hk - 1 / 3))
+	};
+}
+function applyLumModOrOff(color, kind, value) {
+	const hsl = rgbToHsl(color);
+	const pct = value / OOXML_PERCENT_SCALE;
+	const l = clamp01(kind === "lumMod" ? hsl.l * pct : hsl.l + pct);
+	return hslToRgb({
+		...hsl,
+		l
+	});
+}
+function applyColorTransforms(base, transforms) {
+	let color = base;
+	for (const t of transforms) if (t.kind === "shade" || t.kind === "tint") color = applyShadeOrTint(color, t.kind, t.value);
+	for (const t of transforms) if (t.kind === "lumMod" || t.kind === "lumOff") color = applyLumModOrOff(color, t.kind, t.value);
+	return color;
+}
+//#endregion
+export { applyColorTransforms };