modern-pdf-lib 0.36.0 → 0.37.0

package/dist/{src-MIBq9xGq.cjs → src-CbPUzRbg.cjs}

@@ -19503,15 +19503,15 @@ const D50_WHITE_POINT = [
 	.8249
 ];
 /** CIE constant δ = 6/29; the linear/cubic break is at t ≤ δ. */
-const LAB_DELTA = 6 / 29;
+const LAB_DELTA$2 = 6 / 29;
 /** 3δ² — slope of the inverse linear branch. */
-const LAB_3_DELTA_SQUARED = 3 * LAB_DELTA * LAB_DELTA;
+const LAB_3_DELTA_SQUARED$1 = 3 * LAB_DELTA$2 * LAB_DELTA$2;
 /** Inverse of the CIE L*a*b* nonlinearity f(t). */
 function labInverseF(t) {
-	return t > LAB_DELTA ? t * t * t : LAB_3_DELTA_SQUARED * (t - 4 / 29);
+	return t > LAB_DELTA$2 ? t * t * t : LAB_3_DELTA_SQUARED$1 * (t - 4 / 29);
 }
 /** Apply the sRGB transfer function (linear → companded), input clamped 0..1. */
-function linearToSrgb(c) {
+function linearToSrgb$1(c) {
 	const clamped = c < 0 ? 0 : c > 1 ? 1 : c;
 	const v = clamped <= .0031308 ? 12.92 * clamped : 1.055 * clamped ** (1 / 2.4) - .055;
 	return v < 0 ? 0 : v > 1 ? 1 : v;
@@ -19545,9 +19545,9 @@ function labToRgb(L, a, b, whitePoint = D50_WHITE_POINT) {
 	const gLin = -.9787684 * X + 1.9161415 * Y + .033454 * Z;
 	const bLin = .0719453 * X - .2289914 * Y + 1.4052427 * Z;
 	return [
-		linearToSrgb(rLin),
-		linearToSrgb(gLin),
-		linearToSrgb(bLin)
+		linearToSrgb$1(rLin),
+		linearToSrgb$1(gLin),
+		linearToSrgb$1(bLin)
 	];
 }
 //#endregion
@@ -20153,7 +20153,7 @@ function breakLongWord$1(word, font, size, limit) {
 //#endregion
 //#region src/core/pdfFunctions.ts
 /** Clamp `x` into the inclusive `[lo, hi]` interval. */
-function clamp(x, lo, hi) {
+function clamp$1(x, lo, hi) {
 	if (x < lo) return lo;
 	if (x > hi) return hi;
 	return x;
@@ -20173,14 +20173,14 @@ function clampToRange(out, range) {
 	for (let i = 0; i < out.length; i++) {
 		const lo = range[2 * i];
 		const hi = range[2 * i + 1];
-		if (lo !== void 0 && hi !== void 0) out[i] = clamp(out[i], lo, hi);
+		if (lo !== void 0 && hi !== void 0) out[i] = clamp$1(out[i], lo, hi);
 	}
 	return out;
 }
 function evaluateExponential(fn, inputs) {
 	const c0 = fn.c0 ?? [0];
 	const c1 = fn.c1 ?? [1];
-	const x = clamp(inputs[0] ?? 0, fn.domain[0] ?? 0, fn.domain[1] ?? 1);
+	const x = clamp$1(inputs[0] ?? 0, fn.domain[0] ?? 0, fn.domain[1] ?? 1);
 	const xn = fn.n === 1 ? x : x ** fn.n;
 	const count = Math.max(c0.length, c1.length);
 	const out = [];
@@ -20194,7 +20194,7 @@ function evaluateExponential(fn, inputs) {
 function evaluateStitching(fn, inputs) {
 	const d0 = fn.domain[0] ?? 0;
 	const d1 = fn.domain[1] ?? 1;
-	const x = clamp(inputs[0] ?? 0, d0, d1);
+	const x = clamp$1(inputs[0] ?? 0, d0, d1);
 	const k = fn.functions.length;
 	let i = 0;
 	while (i < fn.bounds.length && x >= fn.bounds[i]) i++;
@@ -20212,10 +20212,10 @@ function evaluateSampled(fn, inputs) {
 	for (let j = 0; j < m; j++) {
 		const dMin = fn.domain[2 * j] ?? 0;
 		const dMax = fn.domain[2 * j + 1] ?? 1;
-		const x = clamp(inputs[j] ?? 0, dMin, dMax);
+		const x = clamp$1(inputs[j] ?? 0, dMin, dMax);
 		const size = fn.size[j] ?? 1;
 		const enc = interpolate(x, dMin, dMax, fn.encode ? fn.encode[2 * j] ?? 0 : 0, fn.encode ? fn.encode[2 * j + 1] ?? size - 1 : size - 1);
-		e.push(clamp(enc, 0, size - 1));
+		e.push(clamp$1(enc, 0, size - 1));
 	}
 	const lower = [];
 	const frac = [];
@@ -20561,7 +20561,7 @@ function evaluatePostScript(fn, inputs) {
 	for (let j = 0; j < m; j++) {
 		const dMin = fn.domain[2 * j] ?? 0;
 		const dMax = fn.domain[2 * j + 1] ?? 1;
-		stack.push(clamp(inputs[j] ?? 0, dMin, dMax));
+		stack.push(clamp$1(inputs[j] ?? 0, dMin, dMax));
 	}
 	execPostScript(program, stack);
 	const nOut = Math.floor(fn.range.length / 2);
@@ -30527,6 +30527,865 @@ function getColorGlyphLayers(fontData, glyphId, paletteIndex = 0) {
 	return layers;
 }
 //#endregion
+//#region src/core/meshShading.ts
+/**
+* @module core/meshShading
+*
+* Mesh shadings — ShadingType 4, 5, 6 and 7 (ISO 32000-2:2020 §8.7.4.5.5–.8).
+*
+* Mesh shadings define colour over a 2-D region by tessellating it into either
+* Gouraud-shaded triangles (types 4 and 5) or parametric patches (types 6 and
+* 7). Unlike the dictionary-only shadings (types 1–3), a mesh shading's data is
+* carried in a **stream** whose body is a packed sequence of binary records.
+*
+* Bit-packing rule (ISO 32000-2 §8.7.4.5.5, "All vertex coordinates and colour
+* values shall be encoded as ... a sequence of bits ... most significant bit
+* first"): every value — flag, coordinate and colour component — is written
+* big-endian, MSB-first, into a continuous bit stream with **no padding between
+* values**. Only the very end of the stream is padded with zero bits up to the
+* next byte boundary. (§8.7.4.5.5 further notes each value may begin at any bit
+* position; there is no per-record byte alignment.)
+*
+* Numeric mapping (ISO 32000-2 §8.7.4.5.5, Table 84 /Decode semantics): a
+* coordinate or colour value is stored as an unsigned integer `v` in the range
+* `[0, 2^bits − 1]` and decoded as
+*   `decoded = Dmin + v · (Dmax − Dmin) / (2^bits − 1)`
+* where `[Dmin, Dmax]` is the matching pair in the shading's /Decode array. The
+* /Decode layout is `[xmin xmax ymin ymax c1min c1max … cnmin cnmax]` (or, when
+* /Function is present, a single `[tmin tmax]` colour pair). The builders here
+* take **decoded** user values and invert that mapping to obtain the raw
+* integers to pack, rounding to nearest.
+*
+* Record layouts verified against ISO 32000-2:2020:
+*  - Type 4 (§8.7.4.5.5): per vertex → flag (BitsPerFlag) · x · y · colour[n].
+*  - Type 5 (§8.7.4.5.6): per vertex → x · y · colour[n]; NO flag; adds
+*    /VerticesPerRow (≥ 2). Vertices are given row by row.
+*  - Type 6 (§8.7.4.5.7): per patch → flag (BitsPerFlag) · coordinate pairs ·
+*    colours. Flag 0 (new patch) = 12 coordinate pairs + 4 colours; flags 1–3
+*    (shared edge) = 8 coordinate pairs + 2 colours.
+*  - Type 7 (§8.7.4.5.8): like type 6 but flag 0 = 16 coordinate pairs +
+*    4 colours; flags 1–3 = 12 coordinate pairs + 2 colours.
+*
+* No Buffer — uses Uint8Array exclusively.
+*/
+/**
+* Accumulates unsigned integer values of arbitrary bit width into a byte
+* stream, big-endian and most-significant-bit-first, with no inter-value
+* padding. The final byte is zero-padded to the byte boundary on
+* {@link BitPacker.finish}.
+*
+* @internal
+*/
+var BitPacker = class {
+	bytes = [];
+	/** Bits already filled in the current (pending) byte, 0–7. */
+	bitPos = 0;
+	/** The partially filled current byte (high bits set first). */
+	current = 0;
+	/**
+	* Append `bits`-wide unsigned integer `value`, MSB first.
+	*
+	* @param value - non-negative integer in `[0, 2^bits − 1]`.
+	* @param bits - field width (1–32).
+	*/
+	push(value, bits) {
+		for (let i = bits - 1; i >= 0; i--) {
+			const bit = value >>> i & 1;
+			this.current = this.current << 1 | bit;
+			this.bitPos++;
+			if (this.bitPos === 8) {
+				this.bytes.push(this.current & 255);
+				this.current = 0;
+				this.bitPos = 0;
+			}
+		}
+	}
+	/**
+	* Flush the pending partial byte (zero-padded on the low bits) and return the
+	* packed buffer.
+	*/
+	finish() {
+		if (this.bitPos > 0) {
+			this.bytes.push(this.current << 8 - this.bitPos & 255);
+			this.current = 0;
+			this.bitPos = 0;
+		}
+		return Uint8Array.from(this.bytes);
+	}
+};
+/**
+* Invert the /Decode mapping for one value: given a decoded user value and its
+* `[min, max]` pair, return the raw unsigned integer in `[0, 2^bits − 1]`.
+*
+* `raw = round((decoded − min) / (max − min) · (2^bits − 1))`, clamped to the
+* representable range (ISO 32000-2 §8.7.4.5.5, /Decode semantics). A degenerate
+* `min == max` pair maps everything to 0.
+*
+* @internal
+*/
+function encodeValue(decoded, min, max, bits) {
+	const maxRaw = bits >= 32 ? 4294967295 : (1 << bits) - 1;
+	if (max === min) return 0;
+	const t = (decoded - min) / (max - min);
+	const raw = Math.round(t * maxRaw);
+	if (raw < 0) return 0;
+	if (raw > maxRaw) return maxRaw;
+	return raw;
+}
+/**
+* Number of colour components carried per vertex/corner:
+* 1 when a /Function is present (parametric `t`), else the count implied by the
+* colour /Decode pairs.
+*
+* @internal
+*/
+function colorComponentCount(common) {
+	if (common.function !== void 0) return 1;
+	const colorPairs = (common.decode.length - 4) / 2;
+	return Math.max(1, Math.trunc(colorPairs));
+}
+/**
+* Pack one vertex's coordinates then its colours (no flag) into `packer`.
+*
+* @internal
+*/
+function packVertexData(packer, vertex, common, nColor) {
+	const { decode, bitsPerCoordinate: bpcoord, bitsPerComponent: bpcomp } = common;
+	packer.push(encodeValue(vertex.x, decode[0] ?? 0, decode[1] ?? 1, bpcoord), bpcoord);
+	packer.push(encodeValue(vertex.y, decode[2] ?? 0, decode[3] ?? 1, bpcoord), bpcoord);
+	for (let k = 0; k < nColor; k++) {
+		const cmin = decode[4 + 2 * k] ?? 0;
+		const cmax = decode[5 + 2 * k] ?? 1;
+		const comp = vertex.color[k] ?? 0;
+		packer.push(encodeValue(comp, cmin, cmax, bpcomp), bpcomp);
+	}
+}
+/**
+* Pack a single `[x, y]` control point (coordinates only) into `packer`.
+*
+* @internal
+*/
+function packPoint(packer, point, common) {
+	const { decode, bitsPerCoordinate: bpcoord } = common;
+	packer.push(encodeValue(point[0], decode[0] ?? 0, decode[1] ?? 1, bpcoord), bpcoord);
+	packer.push(encodeValue(point[1], decode[2] ?? 0, decode[3] ?? 1, bpcoord), bpcoord);
+}
+/**
+* Pack one colour (n components) into `packer`.
+*
+* @internal
+*/
+function packColor(packer, color, common, nColor) {
+	const { decode, bitsPerComponent: bpcomp } = common;
+	for (let k = 0; k < nColor; k++) {
+		const cmin = decode[4 + 2 * k] ?? 0;
+		const cmax = decode[5 + 2 * k] ?? 1;
+		const comp = color[k] ?? 0;
+		packer.push(encodeValue(comp, cmin, cmax, bpcomp), bpcomp);
+	}
+}
+/**
+* Build the dictionary shared by every mesh shading and set the common keys.
+*
+* @internal
+*/
+function buildCommonDict(shadingType, common, includeFlag) {
+	const dict = new require_pdfObjects.PdfDict();
+	dict.set("/ShadingType", require_pdfObjects.PdfNumber.of(shadingType));
+	dict.set("/ColorSpace", common.colorSpace);
+	dict.set("/BitsPerCoordinate", require_pdfObjects.PdfNumber.of(common.bitsPerCoordinate));
+	dict.set("/BitsPerComponent", require_pdfObjects.PdfNumber.of(common.bitsPerComponent));
+	if (includeFlag) dict.set("/BitsPerFlag", require_pdfObjects.PdfNumber.of(common.bitsPerFlag));
+	dict.set("/Decode", require_pdfObjects.PdfArray.fromNumbers([...common.decode]));
+	if (common.function !== void 0) dict.set("/Function", common.function);
+	return dict;
+}
+/**
+* Build a free-form Gouraud-shaded triangle mesh shading
+* (ISO 32000-2 §8.7.4.5.5, /ShadingType 4).
+*
+* Each vertex is packed as `flag · x · y · colour[n]`, MSB-first, with the flag
+* `bitsPerFlag` wide.
+*
+* @param options - the common mesh keys plus the triangle/vertex data.
+* @returns a {@link PdfStream} whose dict has /ShadingType 4 and whose body is
+*          the packed vertex stream.
+*/
+function buildFreeFormGouraudShading(options) {
+	const dict = buildCommonDict(4, options, true);
+	const nColor = colorComponentCount(options);
+	const packer = new BitPacker();
+	for (const tri of options.triangles) for (const vertex of tri.vertices) {
+		packer.push(vertex.flag, options.bitsPerFlag);
+		packVertexData(packer, vertex, options, nColor);
+	}
+	const data = packer.finish();
+	return require_pdfObjects.PdfStream.fromBytes(data, dict);
+}
+/**
+* Build a lattice-form Gouraud-shaded triangle mesh shading
+* (ISO 32000-2 §8.7.4.5.6, /ShadingType 5).
+*
+* Vertices carry **no** flag; the mesh topology is implied by /VerticesPerRow.
+* Each vertex is packed as `x · y · colour[n]`, MSB-first.
+*
+* @param options - the common mesh keys (sans /BitsPerFlag) plus
+*                   /VerticesPerRow and the row-major vertex list.
+* @returns a {@link PdfStream} with /ShadingType 5 and /VerticesPerRow.
+*/
+function buildLatticeFormGouraudShading(options) {
+	const common = {
+		colorSpace: options.colorSpace,
+		bitsPerCoordinate: options.bitsPerCoordinate,
+		bitsPerComponent: options.bitsPerComponent,
+		bitsPerFlag: 8,
+		decode: options.decode,
+		function: options.function
+	};
+	const dict = buildCommonDict(5, common, false);
+	dict.set("/VerticesPerRow", require_pdfObjects.PdfNumber.of(options.verticesPerRow));
+	const nColor = colorComponentCount(common);
+	const packer = new BitPacker();
+	for (const vertex of options.vertices) packVertexData(packer, vertex, common, nColor);
+	const data = packer.finish();
+	return require_pdfObjects.PdfStream.fromBytes(data, dict);
+}
+/**
+* Build a Coons patch mesh shading
+* (ISO 32000-2 §8.7.4.5.7, /ShadingType 6).
+*
+* Each patch is packed as `flag · points · colours`. A flag-0 patch carries 12
+* control points and 4 corner colours; flags 1–3 carry 8 control points and 2
+* colours (the rest are inherited from the shared edge of the previous patch).
+*
+* @param options - the common mesh keys plus the patch list.
+* @returns a {@link PdfStream} with /ShadingType 6.
+*/
+function buildCoonsPatchShading(options) {
+	const dict = buildCommonDict(6, options, true);
+	const nColor = colorComponentCount(options);
+	const packer = new BitPacker();
+	for (const patch of options.patches) {
+		packer.push(patch.flag, options.bitsPerFlag);
+		for (const point of patch.points) packPoint(packer, point, options);
+		for (const color of patch.colors) packColor(packer, color, options, nColor);
+	}
+	const data = packer.finish();
+	return require_pdfObjects.PdfStream.fromBytes(data, dict);
+}
+/**
+* Build a tensor-product patch mesh shading
+* (ISO 32000-2 §8.7.4.5.8, /ShadingType 7).
+*
+* Identical packing to type 6 but a flag-0 patch carries 16 control points (the
+* 4 internal tensor points in addition to the 12 boundary points) plus 4 corner
+* colours; flags 1–3 carry 12 control points and 2 colours.
+*
+* @param options - the common mesh keys plus the patch list.
+* @returns a {@link PdfStream} with /ShadingType 7.
+*/
+function buildTensorPatchShading(options) {
+	const dict = buildCommonDict(7, options, true);
+	const nColor = colorComponentCount(options);
+	const packer = new BitPacker();
+	for (const patch of options.patches) {
+		packer.push(patch.flag, options.bitsPerFlag);
+		for (const point of patch.points) packPoint(packer, point, options);
+		for (const color of patch.colors) packColor(packer, color, options, nColor);
+	}
+	const data = packer.finish();
+	return require_pdfObjects.PdfStream.fromBytes(data, dict);
+}
+//#endregion
+//#region src/color/iccTransform.ts
+/**
+* ICC PCS reference white, D50, in XYZ (ICC.1:2010 §6.3.4.3 / Annex A,
+* encoded white point `[0.9642, 1.0000, 0.8249]`).
+*/
+const D50_WHITE = [
+	.9642,
+	1,
+	.8249
+];
+/** CIE L\*a\*b\* threshold δ = 6/29 (CIE 15:2004 §8.2.1). */
+const LAB_DELTA$1 = 6 / 29;
+/** δ³ — the f(t) breakpoint in the t domain. */
+const LAB_DELTA_CUBED$1 = LAB_DELTA$1 * LAB_DELTA$1 * LAB_DELTA$1;
+/** 1 / (3·δ²) — slope of the linear segment of f(t). */
+const LAB_LINEAR_SLOPE = 1 / (3 * LAB_DELTA$1 * LAB_DELTA$1);
+/** 4/29 — intercept of the linear segment of f(t). */
+const LAB_LINEAR_INTERCEPT = 4 / 29;
+const HEADER_SIZE = 128;
+const TAG_COUNT_OFFSET = 128;
+const TAG_TABLE_OFFSET = 132;
+const TAG_RECORD_SIZE = 12;
+/** Decode a 4-byte ASCII signature at `off`. */
+function readSig(data, off) {
+	return String.fromCharCode(data[off], data[off + 1], data[off + 2], data[off + 3]);
+}
+/** s15Fixed16Number → JS number (ICC.1:2010 §4.2): signed int32 / 65536. */
+function readS15Fixed16(view, off) {
+	return view.getInt32(off, false) / 65536;
+}
+/**
+* Read the tag table into a `sig → {offset,size}` map.
+*
+* @throws if the profile is shorter than a header + tag count, or the tag
+*         table extends past the end of the data.
+*/
+function readTagTable(data) {
+	if (data.length < TAG_TABLE_OFFSET) throw new Error(`ICC profile too short: ${data.length} bytes (need at least ${TAG_TABLE_OFFSET}).`);
+	const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+	const count = view.getUint32(TAG_COUNT_OFFSET, false);
+	if (TAG_TABLE_OFFSET + count * TAG_RECORD_SIZE > data.length) throw new Error(`ICC tag table (${count} tags) overruns profile of ${data.length} bytes.`);
+	const table = /* @__PURE__ */ new Map();
+	for (let i = 0; i < count; i++) {
+		const rec = TAG_TABLE_OFFSET + i * TAG_RECORD_SIZE;
+		const sig = readSig(data, rec);
+		const offset = view.getUint32(rec + 4, false);
+		const size = view.getUint32(rec + 8, false);
+		table.set(sig, {
+			offset,
+			size
+		});
+	}
+	return table;
+}
+/**
+* Parse the matrix/TRC-relevant header fields and detect whether the profile
+* carries a complete matrix/TRC model.
+*
+* Reads the 128-byte ICC header (ICC.1:2010 §7.2): version (offset 8),
+* deviceClass (offset 12), data colour space (offset 16) and PCS (offset 20),
+* then inspects the tag table (§7.3) for the colorant + TRC tags.
+*
+* @param profile - Raw ICC profile bytes.
+* @returns Parsed {@link IccTransformInfo}.
+* @throws if the profile is too short to contain a header and tag table.
+*
+* @example
+* ```ts
+* import { parseIccTransform } from 'modern-pdf-lib';
+*
+* const info = parseIccTransform(profileBytes);
+* if (info.hasMatrixTrc && info.colorSpace === 'RGB ') {
+*   // safe to call deviceRgbToXyz
+* }
+* ```
+*/
+function parseIccTransform(profile) {
+	if (profile.length < HEADER_SIZE) throw new Error(`ICC profile too short: ${profile.length} bytes (need at least ${HEADER_SIZE}).`);
+	const version = new DataView(profile.buffer, profile.byteOffset, profile.byteLength).getUint32(8, false);
+	const deviceClass = readSig(profile, 12);
+	const colorSpace = readSig(profile, 16);
+	const pcs = readSig(profile, 20);
+	const table = readTagTable(profile);
+	let hasMatrixTrc;
+	if (colorSpace === "GRAY") hasMatrixTrc = table.has("kTRC");
+	else hasMatrixTrc = table.has("rXYZ") && table.has("gXYZ") && table.has("bXYZ") && table.has("rTRC") && table.has("gTRC") && table.has("bTRC");
+	return {
+		version,
+		deviceClass,
+		colorSpace,
+		pcs,
+		hasMatrixTrc
+	};
+}
+/**
+* Evaluate a TRC tag (`curv` or `para`) at a normalised input `x ∈ [0,1]`,
+* returning the linearised value in `[0,1]`.
+*
+*  - `curv` (ICC.1:2010 §10.6): `count` u16 follows the 8-byte type header.
+*    `count == 0` → identity; `count == 1` → a single u8Fixed8Number gamma
+*    (Y = X^g); `count >= 2` → a uInt16 sampled curve over the input domain
+*    [0,1], linearly interpolated, output normalised by 65535.
+*  - `para` (ICC.1:2010 §10.18): a u16 function type + s15Fixed16 parameters.
+*    Implements function types 0–4 from the spec.
+*
+* @throws if the tag type is neither `curv` nor `para`, or is truncated.
+*/
+function evalTrc(data, tag, x) {
+	const start = tag.offset;
+	const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+	const type = readSig(data, start);
+	const xi = x < 0 ? 0 : x > 1 ? 1 : x;
+	if (type === "curv") {
+		const count = view.getUint32(start + 8, false);
+		if (count === 0) return xi;
+		if (count === 1) return xi ** (view.getUint16(start + 12, false) / 256);
+		const lutStart = start + 12;
+		const pos = xi * (count - 1);
+		const i0 = Math.floor(pos);
+		const i1 = i0 >= count - 1 ? count - 1 : i0 + 1;
+		const frac = pos - i0;
+		const v0 = view.getUint16(lutStart + i0 * 2, false);
+		return (v0 + (view.getUint16(lutStart + i1 * 2, false) - v0) * frac) / 65535;
+	}
+	if (type === "para") {
+		const funcType = view.getUint16(start + 8, false);
+		const p = (i) => readS15Fixed16(view, start + 12 + i * 4);
+		const g = p(0);
+		switch (funcType) {
+			case 0: return xi ** g;
+			case 1: {
+				const a = p(1);
+				const b = p(2);
+				return a * xi + b >= 0 ? (a * xi + b) ** g : 0;
+			}
+			case 2: {
+				const a = p(1);
+				const b = p(2);
+				const c = p(3);
+				return (a * xi + b >= 0 ? (a * xi + b) ** g : 0) + c;
+			}
+			case 3: {
+				const a = p(1);
+				const b = p(2);
+				const c = p(3);
+				return xi >= p(4) ? (a * xi + b) ** g : c * xi;
+			}
+			case 4: {
+				const a = p(1);
+				const b = p(2);
+				const c = p(3);
+				const d = p(4);
+				const e = p(5);
+				const f = p(6);
+				return xi >= d ? (a * xi + b) ** g + e : c * xi + f;
+			}
+			default: throw new Error(`Unsupported parametricCurveType function type ${funcType} (ICC.1:2010 §10.18 defines 0–4).`);
+		}
+	}
+	throw new Error(`Unsupported TRC tag type '${type}': only 'curv' and 'para' are matrix/TRC curves (got a LUT/other type).`);
+}
+/** Read a 3-component colorant XYZ from an 'XYZ ' tag. */
+function readXyzTag(data, tag) {
+	const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+	const type = readSig(data, tag.offset);
+	if (type !== "XYZ ") throw new Error(`Expected an 'XYZ ' colorant tag but found '${type}' (ICC.1:2010 §10.31).`);
+	return [
+		readS15Fixed16(view, tag.offset + 8),
+		readS15Fixed16(view, tag.offset + 12),
+		readS15Fixed16(view, tag.offset + 16)
+	];
+}
+/**
+* Transform a device colour through a **matrix/TRC** ICC profile into the
+* D50-relative PCS XYZ.
+*
+* For RGB (`colorSpace === 'RGB '`): each channel is linearised through its
+* `rTRC`/`gTRC`/`bTRC` curve, then multiplied by the colorant matrix whose
+* columns are the `rXYZ`/`gXYZ`/`bXYZ` tags (ICC.1:2010 §E.1.1).
+*
+* For GRAY (`colorSpace === 'GRAY'`): the single value is linearised through
+* `kTRC` and scaled by the media white point (`wtpt`, defaulting to D50).
+*
+* The result is **D50-relative XYZ**, matching the ICC PCS reference
+* illuminant; feed it directly to {@link xyzToLab} (whose default white point
+* is D50).
+*
+* @param profile - Raw ICC profile bytes.
+* @param rgb     - Device colour in `[0,1]`. For gray profiles only the first
+*                  component is used.
+* @returns PCS XYZ `[X, Y, Z]`, D50-relative.
+* @throws if the profile is **not** matrix/TRC (i.e. it is LUT-based —
+*         `mft1`/`mft2`/`mAB `/`mBA `), or its colour space is unsupported.
+*
+* @example
+* ```ts
+* import { deviceRgbToXyz } from 'modern-pdf-lib';
+*
+* const xyz = deviceRgbToXyz(srgbProfileBytes, [1, 1, 1]);
+* // ~ [0.9642, 1.0, 0.8249]  (D50 white)
+* ```
+*/
+function deviceRgbToXyz(profile, rgb) {
+	const info = parseIccTransform(profile);
+	const table = readTagTable(profile);
+	if (info.colorSpace === "GRAY") {
+		const kTrc = table.get("kTRC");
+		if (!kTrc) throw new Error("Gray ICC profile lacks a 'kTRC' tag; not a matrix/TRC profile.");
+		const lin = evalTrc(profile, kTrc, rgb[0]);
+		const wtptRec = table.get("wtpt");
+		const white = wtptRec ? readXyzTag(profile, wtptRec) : [
+			D50_WHITE[0],
+			D50_WHITE[1],
+			D50_WHITE[2]
+		];
+		return [
+			lin * white[0],
+			lin * white[1],
+			lin * white[2]
+		];
+	}
+	if (info.colorSpace !== "RGB ") throw new Error(`deviceRgbToXyz supports 'RGB ' and 'GRAY' profiles; got '${info.colorSpace}'.`);
+	if (!info.hasMatrixTrc) throw new Error("ICC profile is not matrix/TRC (LUT-based: mft1/mft2/mAB /mBA ); matrix/TRC transform cannot be applied. Use a CMM/LUT evaluator instead.");
+	const rTrc = table.get("rTRC");
+	const gTrc = table.get("gTRC");
+	const bTrc = table.get("bTRC");
+	const rLin = evalTrc(profile, rTrc, rgb[0]);
+	const gLin = evalTrc(profile, gTrc, rgb[1]);
+	const bLin = evalTrc(profile, bTrc, rgb[2]);
+	const rCol = readXyzTag(profile, table.get("rXYZ"));
+	const gCol = readXyzTag(profile, table.get("gXYZ"));
+	const bCol = readXyzTag(profile, table.get("bXYZ"));
+	return [
+		rCol[0] * rLin + gCol[0] * gLin + bCol[0] * bLin,
+		rCol[1] * rLin + gCol[1] * gLin + bCol[1] * bLin,
+		rCol[2] * rLin + gCol[2] * gLin + bCol[2] * bLin
+	];
+}
+/**
+* CIE L\*a\*b\* nonlinearity f(t) (CIE 15:2004 §8.2.1.1):
+*
+* ```
+*   f(t) = t^(1/3)                       for t >  δ³
+*   f(t) = t / (3·δ²) + 4/29             for t <= δ³,   δ = 6/29
+* ```
+*/
+function labF$1(t) {
+	return t > LAB_DELTA_CUBED$1 ? Math.cbrt(t) : t * LAB_LINEAR_SLOPE + LAB_LINEAR_INTERCEPT;
+}
+/**
+* Convert PCS XYZ to CIE L\*a\*b\* (CIE 15:2004 §8.2.1 / ICC PCS):
+*
+* ```
+*   L* = 116·f(Y/Yn) − 16
+*   a* = 500·(f(X/Xn) − f(Y/Yn))
+*   b* = 200·(f(Y/Yn) − f(Z/Zn))
+* ```
+*
+* with f as in {@link labF}. The default reference white is **D50**
+* `[0.9642, 1.0000, 0.8249]`, matching the ICC PCS (ICC.1:2010 §6.3.4.3), so
+* XYZ produced by {@link deviceRgbToXyz} maps straight through.
+*
+* @param xyz        - XYZ tristimulus, relative to `whitePoint`.
+* @param whitePoint - Reference white `[Xn, Yn, Zn]`. Defaults to D50.
+* @returns `[L*, a*, b*]`.
+*
+* @example
+* ```ts
+* import { xyzToLab } from 'modern-pdf-lib';
+*
+* xyzToLab([0.9642, 1.0, 0.8249]); // ~ [100, 0, 0]  (D50 white)
+* ```
+*/
+function xyzToLab(xyz, whitePoint = [
+	D50_WHITE[0],
+	D50_WHITE[1],
+	D50_WHITE[2]
+]) {
+	const fx = labF$1(xyz[0] / whitePoint[0]);
+	const fy = labF$1(xyz[1] / whitePoint[1]);
+	const fz = labF$1(xyz[2] / whitePoint[2]);
+	return [
+		116 * fy - 16,
+		500 * (fx - fy),
+		200 * (fy - fz)
+	];
+}
+//#endregion
+//#region src/color/colorConvert.ts
+/**
+* @module color/colorConvert
+*
+* Pure **device** colour-space conversions — no ICC, no chromatic adaptation
+* beyond what each standard formula already bakes in. These are the textbook
+* conversions used for previewing, picking and authoring colour; they are not
+* a substitute for ICC-based colour management.
+*
+* All channels are normalised to `0..1`, with two exceptions that follow the
+* natural ranges of their spaces:
+*  - **Hue** is in degrees `[0, 360)`.
+*  - **CIE L\*a\*b\*** uses its native ranges: `L ∈ [0, 100]`, `a`/`b`
+*    unbounded (typically `[-128, 127]`).
+*
+* ## Verified reference constants
+*
+* **sRGB transfer function** — IEC 61966-2-1:1999 (sRGB). The companded↔linear
+* piecewise curve:
+*  - expand (companded→linear): `c ≤ 0.04045 → c/12.92`,
+*    else `((c + 0.055)/1.055)^2.4`.
+*  - compress (linear→companded): `c ≤ 0.0031308 → 12.92·c`,
+*    else `1.055·c^(1/2.4) − 0.055`.
+*
+* **sRGB ↔ XYZ (D65) matrices** — IEC 61966-2-1, as tabulated by Bruce
+* Lindbloom (sRGB, reference white D65). Forward (linear sRGB → XYZ):
+* ```
+*   X = 0.4124564 R + 0.3575761 G + 0.1804375 B
+*   Y = 0.2126729 R + 0.7151522 G + 0.0721750 B
+*   Z = 0.0193339 R + 0.1191920 G + 0.9503041 B
+* ```
+* Inverse (XYZ → linear sRGB):
+* ```
+*   R =  3.2404542 X − 1.5371385 Y − 0.4985314 Z
+*   G = −0.9692660 X + 1.8760108 Y + 0.0415560 Z
+*   B =  0.0556434 X − 0.2040259 Y + 1.0572252 Z
+* ```
+*
+* **D65 reference white** — CIE 1931 2° observer, normalised to `Y = 1`:
+* `Xn = 0.95047, Yn = 1.00000, Zn = 1.08883`.
+*
+* **CIE L\*a\*b\*** — CIE 15 colorimetry, using the rational `δ = 6/29`
+* formulation (numerically identical to the `0.008856 / 903.3` form but
+* continuous at the join):
+* ```
+*   f(t) = t^(1/3)              if t > δ³
+*        = t/(3δ²) + 4/29       otherwise
+*   L = 116·f(Y/Yn) − 16
+*   a = 500·(f(X/Xn) − f(Y/Yn))
+*   b = 200·(f(Y/Yn) − f(Z/Zn))
+* ```
+* with the inverse `f⁻¹(t) = t³` if `t > δ` else `3δ²·(t − 4/29)`.
+*
+* > **Note on Lab white point.** This module's `rgbToLab` / `labToRgb` use the
+* > **D65** PCS that matches the sRGB→XYZ pipeline, per this module's spec.
+* > That differs from {@link module:core/colorSpacesCIE}'s `labToRgb`, which
+* > targets the **D50** ICC profile-connection-space convention. The two are
+* > intentionally distinct and should not be confused.
+*
+* No `Buffer` — plain `number` arithmetic and tuples only.
+*/
+/**
+* CIE 1931 2° D65 reference white, normalised so `Yn = 1`.
+* (IEC 61966-2-1 / CIE 15.)
+*/
+const D65_WHITE = [
+	.95047,
+	1,
+	1.08883
+];
+/** CIE Lab constant `δ = 6/29`. */
+const LAB_DELTA = 6 / 29;
+/** `δ³` — the linear/cubic break point for the forward nonlinearity `f(t)`. */
+const LAB_DELTA_CUBED = LAB_DELTA * LAB_DELTA * LAB_DELTA;
+/** `3δ²` — slope of the linear branch. */
+const LAB_3_DELTA_SQUARED = 3 * LAB_DELTA * LAB_DELTA;
+/** Clamp `x` to the closed interval `[lo, hi]`. */
+function clamp(x, lo, hi) {
+	return x < lo ? lo : x > hi ? hi : x;
+}
+/** Normalise a hue in degrees into `[0, 360)`. */
+function normalizeHue(h) {
+	const m = h % 360;
+	return m < 0 ? m + 360 : m;
+}
+/**
+* Convert device RGB to HSL.
+*
+* @param r - Red,   0..1.
+* @param g - Green, 0..1.
+* @param b - Blue,  0..1.
+* @returns `[h, s, l]` with `h` in `[0, 360)`, `s`/`l` in `0..1`.
+*/
+function rgbToHsl(r, g, b) {
+	const max = Math.max(r, g, b);
+	const min = Math.min(r, g, b);
+	const delta = max - min;
+	const l = (max + min) / 2;
+	if (delta === 0) return [
+		0,
+		0,
+		l
+	];
+	const s = delta / (1 - Math.abs(2 * l - 1));
+	let h;
+	if (max === r) h = (g - b) / delta % 6;
+	else if (max === g) h = (b - r) / delta + 2;
+	else h = (r - g) / delta + 4;
+	h *= 60;
+	return [
+		normalizeHue(h),
+		s,
+		l
+	];
+}
+/**
+* Convert HSL to device RGB.
+*
+* @param h - Hue in degrees (any real; wrapped into `[0, 360)`).
+* @param s - Saturation, 0..1.
+* @param l - Lightness,  0..1.
+* @returns `[r, g, b]`, each 0..1.
+*/
+function hslToRgb(h, s, l) {
+	const hue = normalizeHue(h);
+	const c = (1 - Math.abs(2 * l - 1)) * s;
+	const x = c * (1 - Math.abs(hue / 60 % 2 - 1));
+	const mAdd = l - c / 2;
+	let r1 = 0;
+	let g1 = 0;
+	let b1 = 0;
+	if (hue < 60) {
+		r1 = c;
+		g1 = x;
+	} else if (hue < 120) {
+		r1 = x;
+		g1 = c;
+	} else if (hue < 180) {
+		g1 = c;
+		b1 = x;
+	} else if (hue < 240) {
+		g1 = x;
+		b1 = c;
+	} else if (hue < 300) {
+		r1 = x;
+		b1 = c;
+	} else {
+		r1 = c;
+		b1 = x;
+	}
+	return [
+		r1 + mAdd,
+		g1 + mAdd,
+		b1 + mAdd
+	];
+}
+/**
+* Convert device RGB to HSV.
+*
+* @param r - Red,   0..1.
+* @param g - Green, 0..1.
+* @param b - Blue,  0..1.
+* @returns `[h, s, v]` with `h` in `[0, 360)`, `s`/`v` in `0..1`.
+*/
+function rgbToHsv(r, g, b) {
+	const max = Math.max(r, g, b);
+	const delta = max - Math.min(r, g, b);
+	const v = max;
+	if (delta === 0) return [
+		0,
+		0,
+		v
+	];
+	const s = max === 0 ? 0 : delta / max;
+	let h;
+	if (max === r) h = (g - b) / delta % 6;
+	else if (max === g) h = (b - r) / delta + 2;
+	else h = (r - g) / delta + 4;
+	h *= 60;
+	return [
+		normalizeHue(h),
+		s,
+		v
+	];
+}
+/**
+* Convert HSV to device RGB.
+*
+* @param h - Hue in degrees (any real; wrapped into `[0, 360)`).
+* @param s - Saturation, 0..1.
+* @param v - Value,      0..1.
+* @returns `[r, g, b]`, each 0..1.
+*/
+function hsvToRgb(h, s, v) {
+	const hue = normalizeHue(h);
+	const c = v * s;
+	const x = c * (1 - Math.abs(hue / 60 % 2 - 1));
+	const mAdd = v - c;
+	let r1 = 0;
+	let g1 = 0;
+	let b1 = 0;
+	if (hue < 60) {
+		r1 = c;
+		g1 = x;
+	} else if (hue < 120) {
+		r1 = x;
+		g1 = c;
+	} else if (hue < 180) {
+		g1 = c;
+		b1 = x;
+	} else if (hue < 240) {
+		g1 = x;
+		b1 = c;
+	} else if (hue < 300) {
+		r1 = x;
+		b1 = c;
+	} else {
+		r1 = c;
+		b1 = x;
+	}
+	return [
+		r1 + mAdd,
+		g1 + mAdd,
+		b1 + mAdd
+	];
+}
+/** Gamma-expand a companded sRGB channel to linear (IEC 61966-2-1). */
+function srgbToLinear(c) {
+	return c <= .04045 ? c / 12.92 : ((c + .055) / 1.055) ** 2.4;
+}
+/** Gamma-compress a linear channel to companded sRGB (IEC 61966-2-1). */
+function linearToSrgb(c) {
+	return c <= .0031308 ? 12.92 * c : 1.055 * c ** (1 / 2.4) - .055;
+}
+/**
+* Convert device (sRGB) RGB to CIE XYZ relative to the D65 white point.
+*
+* Gamma-expands each channel, then applies the IEC 61966-2-1 sRGB→XYZ D65
+* matrix. The returned `Y` is `1.0` for input white `(1, 1, 1)`.
+*
+* @param r - Red,   0..1.
+* @param g - Green, 0..1.
+* @param b - Blue,  0..1.
+* @returns `[X, Y, Z]` (D65, `Y = 1` for white).
+*/
+function rgbToXyz(r, g, b) {
+	const rl = srgbToLinear(r);
+	const gl = srgbToLinear(g);
+	const bl = srgbToLinear(b);
+	return [
+		.4124564 * rl + .3575761 * gl + .1804375 * bl,
+		.2126729 * rl + .7151522 * gl + .072175 * bl,
+		.0193339 * rl + .119192 * gl + .9503041 * bl
+	];
+}
+/**
+* Convert CIE XYZ (D65) to device (sRGB) RGB.
+*
+* Applies the inverse sRGB matrix, then gamma-companding. Results are clamped
+* to `0..1` to keep them in the displayable device gamut.
+*
+* @param x - CIE X (D65).
+* @param y - CIE Y (D65).
+* @param z - CIE Z (D65).
+* @returns `[r, g, b]`, each clamped to 0..1.
+*/
+function xyzToRgb(x, y, z) {
+	const rl = 3.2404542 * x - 1.5371385 * y - .4985314 * z;
+	const gl = -.969266 * x + 1.8760108 * y + .041556 * z;
+	const bl = .0556434 * x - .2040259 * y + 1.0572252 * z;
+	return [
+		clamp(linearToSrgb(rl), 0, 1),
+		clamp(linearToSrgb(gl), 0, 1),
+		clamp(linearToSrgb(bl), 0, 1)
+	];
+}
+/** Forward CIE Lab nonlinearity `f(t)`. */
+function labF(t) {
+	return t > LAB_DELTA_CUBED ? Math.cbrt(t) : t / LAB_3_DELTA_SQUARED + 4 / 29;
+}
+/**
+* Convert device (sRGB) RGB to CIE L\*a\*b\* via XYZ, using the D65 white
+* point.
+*
+* @param r - Red,   0..1.
+* @param g - Green, 0..1.
+* @param b - Blue,  0..1.
+* @returns `[L, a, b]` with `L ∈ [0, 100]`, `a`/`b` in their natural ranges.
+*/
+function rgbToLab(r, g, b) {
+	const [x, y, z] = rgbToXyz(r, g, b);
+	const fx = labF(x / D65_WHITE[0]);
+	const fy = labF(y / D65_WHITE[1]);
+	const fz = labF(z / D65_WHITE[2]);
+	return [
+		116 * fy - 16,
+		500 * (fx - fy),
+		200 * (fy - fz)
+	];
+}
+//#endregion
 //#region src/render/matrix.ts
 /** The identity transform. */
 function identity() {
@@ -34876,6 +35735,12 @@ Object.defineProperty(exports, "buildColorKeyMask", {
 		return buildColorKeyMask;
 	}
 });
+Object.defineProperty(exports, "buildCoonsPatchShading", {
+	enumerable: true,
+	get: function() {
+		return buildCoonsPatchShading;
+	}
+});
 Object.defineProperty(exports, "buildDPartRoot", {
 	enumerable: true,
 	get: function() {
@@ -34924,6 +35789,12 @@ Object.defineProperty(exports, "buildFieldLockDict", {
 		return buildFieldLockDict;
 	}
 });
+Object.defineProperty(exports, "buildFreeFormGouraudShading", {
+	enumerable: true,
+	get: function() {
+		return buildFreeFormGouraudShading;
+	}
+});
 Object.defineProperty(exports, "buildFunctionShading", {
 	enumerable: true,
 	get: function() {
@@ -34948,6 +35819,12 @@ Object.defineProperty(exports, "buildLab", {
 		return buildLab;
 	}
 });
+Object.defineProperty(exports, "buildLatticeFormGouraudShading", {
+	enumerable: true,
+	get: function() {
+		return buildLatticeFormGouraudShading;
+	}
+});
 Object.defineProperty(exports, "buildNamespace", {
 	enumerable: true,
 	get: function() {
@@ -35056,6 +35933,12 @@ Object.defineProperty(exports, "buildStencilMask", {
 		return buildStencilMask;
 	}
 });
+Object.defineProperty(exports, "buildTensorPatchShading", {
+	enumerable: true,
+	get: function() {
+		return buildTensorPatchShading;
+	}
+});
 Object.defineProperty(exports, "buildThresholdHalftone", {
 	enumerable: true,
 	get: function() {
@@ -35272,6 +36155,12 @@ Object.defineProperty(exports, "detectTransparency", {
 		return detectTransparency;
 	}
 });
+Object.defineProperty(exports, "deviceRgbToXyz", {
+	enumerable: true,
+	get: function() {
+		return deviceRgbToXyz;
+	}
+});
 Object.defineProperty(exports, "didYouMean", {
 	enumerable: true,
 	get: function() {
@@ -35746,6 +36635,18 @@ Object.defineProperty(exports, "hasLtvData", {
 		return hasLtvData;
 	}
 });
+Object.defineProperty(exports, "hslToRgb", {
+	enumerable: true,
+	get: function() {
+		return hslToRgb;
+	}
+});
+Object.defineProperty(exports, "hsvToRgb", {
+	enumerable: true,
+	get: function() {
+		return hsvToRgb;
+	}
+});
 Object.defineProperty(exports, "identityTransferFunction", {
 	enumerable: true,
 	get: function() {
@@ -35938,6 +36839,12 @@ Object.defineProperty(exports, "parseExistingTrailer", {
 		return parseExistingTrailer;
 	}
 });
+Object.defineProperty(exports, "parseIccTransform", {
+	enumerable: true,
+	get: function() {
+		return parseIccTransform;
+	}
+});
 Object.defineProperty(exports, "parseTileInfo", {
 	enumerable: true,
 	get: function() {
@@ -36172,6 +37079,30 @@ Object.defineProperty(exports, "resolveInstanceCoordinates", {
 		return resolveInstanceCoordinates;
 	}
 });
+Object.defineProperty(exports, "rgbToHsl", {
+	enumerable: true,
+	get: function() {
+		return rgbToHsl;
+	}
+});
+Object.defineProperty(exports, "rgbToHsv", {
+	enumerable: true,
+	get: function() {
+		return rgbToHsv;
+	}
+});
+Object.defineProperty(exports, "rgbToLab", {
+	enumerable: true,
+	get: function() {
+		return rgbToLab;
+	}
+});
+Object.defineProperty(exports, "rgbToXyz", {
+	enumerable: true,
+	get: function() {
+		return rgbToXyz;
+	}
+});
 Object.defineProperty(exports, "sampleShadingColor", {
 	enumerable: true,
 	get: function() {
@@ -36514,5 +37445,17 @@ Object.defineProperty(exports, "wrapText", {
 		return wrapText$2;
 	}
 });
+Object.defineProperty(exports, "xyzToLab", {
+	enumerable: true,
+	get: function() {
+		return xyzToLab;
+	}
+});
+Object.defineProperty(exports, "xyzToRgb", {
+	enumerable: true,
+	get: function() {
+		return xyzToRgb;
+	}
+});
 
-//# sourceMappingURL=src-MIBq9xGq.cjs.map
+//# sourceMappingURL=src-CbPUzRbg.cjs.map