@embedpdf/engine-core 3.0.0-next.13 → 3.0.0-next.14

package/dist/{builders-Bqm8yTpi.cjs → viewport-BWeNHZmb.cjs}

@@ -1,5 +1,5 @@
-const require_fold = require("./fold-2V29cxCV.cjs");
-const require_PageInsertBlankInput = require("./PageInsertBlankInput-CqXBmFhN.cjs");
+const require_derive = require("./derive-BbsDk_Kz.cjs");
+const require_format = require("./format-D_epWlob.cjs");
 const require_resolver = require("./resolver-CYVNV4hn.cjs");
 //#region src/dto/PdfAction.ts
 /**
@@ -30,7 +30,7 @@ function createPageImageHandle(result, blobSource) {
 	return {
 		...result,
 		async objectUrl(signal) {
-			if (typeof Blob === "undefined" || typeof URL === "undefined" || !URL.createObjectURL) throw new require_fold.EngineError(require_PageInsertBlankInput.EngineErrorCode.RuntimeUnavailable, "Object URLs are not available in this environment");
+			if (typeof Blob === "undefined" || typeof URL === "undefined" || !URL.createObjectURL) throw new require_derive.EngineError(require_format.EngineErrorCode.RuntimeUnavailable, "Object URLs are not available in this environment");
 			const blob = await blobSource.blob(signal);
 			const url = URL.createObjectURL(blob);
 			return {
@@ -272,7 +272,7 @@ function parseJpeg(buffer) {
 async function normalizeAttachmentFileSource(file, key) {
 	const resolved = await resolveBinarySource(file.data);
 	const name = file.name ?? resolved.name;
-	if (!name) throw new require_fold.EngineError(require_PageInsertBlankInput.EngineErrorCode.InvalidArg, "attachment file requires a name — pass { data, name } or a File whose name is set");
+	if (!name) throw new require_derive.EngineError(require_format.EngineErrorCode.InvalidArg, "attachment file requires a name — pass { data, name } or a File whose name is set");
 	const mimeType = file.mimeType ?? resolved.mimeType;
 	return {
 		wireFile: {
@@ -310,7 +310,7 @@ async function normalizeFileAttachmentDraft(draft, allocateKey) {
 async function resolveStampSource(source) {
 	const resolved = await resolveBinarySource(source);
 	const meta = sniffBinaryMetadata(resolved.bytes);
-	if (!meta) throw new require_fold.EngineError(require_PageInsertBlankInput.EngineErrorCode.InvalidArg, "stamp source must be PNG, JPEG, or single-page PDF bytes (format is detected from the data, not the declared mime type)");
+	if (!meta) throw new require_derive.EngineError(require_format.EngineErrorCode.InvalidArg, "stamp source must be PNG, JPEG, or single-page PDF bytes (format is detected from the data, not the declared mime type)");
 	return {
 		...resolved,
 		mimeType: meta.mimeType
@@ -373,85 +373,6 @@ async function normalizeAnnotationPatch(patch) {
 	}
 }
 //#endregion
-//#region src/annotation/relationships.ts
-/**
-* Classify one annotation by its relationship edge alone. Mirrors the
-* spec's "practical parser rule": no `/IRT` is top-level; `/RT /Group` is
-* a grouped subordinate; anything else with an `/IRT` is a reply (the
-* engine has already normalized a missing `/RT` to `'reply'`).
-*/
-function classifyRelation(a) {
-	if (!a.inReplyTo) return "top-level";
-	return a.replyType === "group" ? "grouped-subordinate" : "reply";
-}
-/**
-* Stable string key for an {@link AnnotationRef}, used to match a child's
-* `inReplyTo` against a candidate parent's `ref`. Both sides are produced
-* by the engine with the same identity precedence (objectNumber, then nm,
-* then index), so equal keys mean "same annotation".
-*/
-function refKey(ref) {
-	switch (ref.kind) {
-		case "objectNumber": return `obj:${ref.pageObjectNumber}:${ref.annotObjectNumber}`;
-		case "nm": return `nm:${ref.pageObjectNumber}:${ref.nm}`;
-		case "index": return `idx:${ref.pageObjectNumber}:${ref.index}`;
-	}
-}
-/**
-* Compose a flat annotation list (one page, or a whole document via
-* `listRawAll()` flattened) into {@link AnnotationThread}s in primary
-* order.
-*
-* Rules (ISO 32000 §12.5.6.2 + the spec's UI rule):
-*   - Annotations with no `/IRT` become thread primaries, in input order.
-*   - A `/RT /Group` child is attached to its primary's `groupedParts`.
-*   - A `/RT /R` (or default) child is attached to its primary's `replies`.
-*   - A child whose parent is not in the input set is treated as an
-*     orphan primary (defensive — e.g. a partial/filtered page slice).
-*
-* Limitations (v1, matches the legacy stack): threading is one level deep
-* — a reply-to-a-reply is keyed to its direct parent, so it only appears
-* nested if that direct parent is itself a primary. Callers that want a
-* sidebar of "most annotations, not widgets/popups" should pre-filter the
-* input; this helper is intentionally unopinionated about eligibility.
-*/
-function buildThreads(annotations) {
-	const byKey = /* @__PURE__ */ new Map();
-	for (const a of annotations) {
-		byKey.set(refKey(a.ref), a);
-		if (a.nm && a.nm.length > 0) byKey.set(`nm:${a.ref.pageObjectNumber}:${a.nm}`, a);
-	}
-	const threads = [];
-	const threadByPrimaryKey = /* @__PURE__ */ new Map();
-	const primaryThread = (primary) => {
-		const key = refKey(primary.ref);
-		let thread = threadByPrimaryKey.get(key);
-		if (!thread) {
-			thread = {
-				primary,
-				groupedParts: [],
-				replies: []
-			};
-			threadByPrimaryKey.set(key, thread);
-			threads.push(thread);
-		}
-		return thread;
-	};
-	for (const a of annotations) if (!a.inReplyTo) primaryThread(a);
-	for (const a of annotations) {
-		if (!a.inReplyTo) continue;
-		const parent = byKey.get(refKey(a.inReplyTo));
-		if (!parent || parent.inReplyTo) {
-			primaryThread(a);
-			continue;
-		}
-		const thread = primaryThread(parent);
-		if (a.replyType === "group") thread.groupedParts.push(a);
-		else thread.replies.push(a);
-	}
-	return threads;
-}
-//#endregion
 //#region src/annotation/comments.ts
 /** Subtypes that never participate in comment threads. `unsupported`
 *  covers `/Popup` dictionaries (raw code 16) and unreadable foreign
@@ -482,10 +403,10 @@ function buildCommentThreads(annotations, opts = {}) {
 	const eligible = annotations.filter((a) => !EXCLUDED_SUBTYPES.has(a.subtype));
 	const byKey = /* @__PURE__ */ new Map();
 	for (const a of eligible) {
-		const key = refKey(a.ref);
+		const key = require_derive.refKey(a.ref);
 		if (!byKey.has(key)) byKey.set(key, a);
 		if (a.nm) {
-			const aliasKey = refKey({
+			const aliasKey = require_derive.refKey({
 				kind: "nm",
 				pageObjectNumber: a.pageObjectNumber,
 				nm: a.nm
@@ -496,9 +417,9 @@ function buildCommentThreads(annotations, opts = {}) {
 	const children = /* @__PURE__ */ new Map();
 	for (const a of eligible) {
 		if (!a.inReplyTo) continue;
-		const parent = byKey.get(refKey(a.inReplyTo));
+		const parent = byKey.get(require_derive.refKey(a.inReplyTo));
 		if (!parent) continue;
-		const parentKey = refKey(parent.ref);
+		const parentKey = require_derive.refKey(parent.ref);
 		const list = children.get(parentKey);
 		if (list) list.push(a);
 		else children.set(parentKey, [a]);
@@ -509,15 +430,15 @@ function buildCommentThreads(annotations, opts = {}) {
 		const replies = [];
 		const groupedParts = [];
 		const states = [];
-		visited.add(refKey(root.ref));
-		const stack = [...children.get(refKey(root.ref)) ?? []];
+		visited.add(require_derive.refKey(root.ref));
+		const stack = [...children.get(require_derive.refKey(root.ref)) ?? []];
 		while (stack.length > 0) {
 			const a = stack.pop();
-			const key = refKey(a.ref);
+			const key = require_derive.refKey(a.ref);
 			if (visited.has(key)) continue;
 			visited.add(key);
 			if (isStateAnnotation(a)) states.push(a);
-			else if (classifyRelation(a) === "grouped-subordinate") groupedParts.push(a);
+			else if (require_derive.classifyRelation(a) === "grouped-subordinate") groupedParts.push(a);
 			else replies.push(a);
 			stack.push(...children.get(key) ?? []);
 		}
@@ -533,7 +454,7 @@ function buildCommentThreads(annotations, opts = {}) {
 	};
 	for (const a of eligible) if (!a.inReplyTo && !isStateAnnotation(a)) walk(a);
 	for (const a of eligible) {
-		if (visited.has(refKey(a.ref))) continue;
+		if (visited.has(require_derive.refKey(a.ref))) continue;
 		if (isStateAnnotation(a)) continue;
 		walk(a);
 	}
@@ -803,15 +724,22 @@ function appearanceImpactOf(current, patch) {
 	const cur = current;
 	const pat = patch;
 	const subtype = patch.subtype;
+	const caption = pat.caption === void 0 ? cur.caption : pat.caption;
+	const contentsPainted = CONTENTS_PAINTED.has(subtype) || [
+		"line",
+		"polygon",
+		"polyline"
+	].includes(subtype) && !!caption?.enabled;
 	const touched = [];
 	for (const [key, value] of Object.entries(pat)) {
 		if (value === void 0 || INERT_KEYS.has(key)) continue;
-		if (key === "contents" && !CONTENTS_PAINTED.has(subtype)) continue;
+		if (key === "contents" && !contentsPainted) continue;
 		if (key === "rotation" && ADVISORY_ROTATION.has(subtype)) continue;
 		if (!semanticEqual(value, cur[key])) touched.push(key);
 	}
 	if (touched.length === 0) return "inert";
-	const geometryKeys = TRANSLATABLE_GEOMETRY[subtype];
+	const baseGeometryKeys = TRANSLATABLE_GEOMETRY[subtype];
+	const geometryKeys = baseGeometryKeys && (subtype === "polygon" || subtype === "polyline") && cur.caption?.center ? [...baseGeometryKeys, "caption"] : baseGeometryKeys;
 	if (!geometryKeys) return "regenerate";
 	if (!touched.every((k) => geometryKeys.includes(k))) return "regenerate";
 	return isRigidTranslation(cur, pat, subtype, geometryKeys) ? "translation" : "regenerate";
@@ -889,7 +817,7 @@ function parsePdfValue(text) {
 var Parser = class {
 	constructor(text) {
 		this.text = text;
-		require_fold._defineProperty(this, "pos", 0);
+		require_derive._defineProperty(this, "pos", 0);
 	}
 	atEnd() {
 		return this.pos >= this.text.length;
@@ -1466,12 +1394,12 @@ var StepContext = class {
 		this.input = input;
 		this.level = level;
 		this.locks = locks;
-		require_fold._defineProperty(this, "findings", []);
-		require_fold._defineProperty(this, "byNum", /* @__PURE__ */ new Map());
-		require_fold._defineProperty(this, "before", void 0);
-		require_fold._defineProperty(this, "after", void 0);
-		require_fold._defineProperty(this, "claims", /* @__PURE__ */ new Map());
-		require_fold._defineProperty(this, "locked", /* @__PURE__ */ new Set());
+		require_derive._defineProperty(this, "findings", []);
+		require_derive._defineProperty(this, "byNum", /* @__PURE__ */ new Map());
+		require_derive._defineProperty(this, "before", void 0);
+		require_derive._defineProperty(this, "after", void 0);
+		require_derive._defineProperty(this, "claims", /* @__PURE__ */ new Map());
+		require_derive._defineProperty(this, "locked", /* @__PURE__ */ new Set());
 		for (const c of input.changes) this.byNum.set(c.objectNumber, c);
 		this.before = indexRoles(input.before);
 		this.after = indexRoles(input.after);
@@ -2145,9 +2073,9 @@ var EdgeResolver = class {
 		this.read = read;
 		this.anchors = anchors;
 		this.budget = budget;
-		require_fold._defineProperty(this, "memo", /* @__PURE__ */ new Map());
-		require_fold._defineProperty(this, "reads", 0);
-		require_fold._defineProperty(this, "exhausted", false);
+		require_derive._defineProperty(this, "memo", /* @__PURE__ */ new Map());
+		require_derive._defineProperty(this, "reads", 0);
+		require_derive._defineProperty(this, "exhausted", false);
 	}
 	/** Anchored edges of `objectNumber`, or `incomplete` when a budget was exceeded. */
 	resolve(objectNumber) {
@@ -2208,7 +2136,8 @@ var EdgeResolver = class {
 function foldOptionsFor(query) {
 	return {
 		keepCase: !!query.matchCase,
-		keepMarks: !!query.matchDiacritics
+		keepMarks: !!query.matchDiacritics,
+		dropWhitespace: !!query.ignoreWhitespace
 	};
 }
 const WORD_UNIT = /[\p{L}\p{N}_]/u;
@@ -2226,18 +2155,29 @@ function wordAt(text, index) {
 	return WORD_UNIT.test(String.fromCodePoint(text.codePointAt(index)));
 }
 /**
+* Whether the folded hit at `at` sits on word boundaries. Checked on the
+* folded plane, except under `ignoreWhitespace`: dropping whitespace glues
+* neighbouring words together ("i n v o i c e 42" folds to "invoice42"), so there the
+* boundaries are read off the ORIGINAL text around the mapped range.
+*/
+function isWholeWordHit(haystack, at, needleLength, query) {
+	if (!query.ignoreWhitespace) return !wordBefore(haystack.folded, at) && !wordAt(haystack.folded, at + needleLength);
+	const { start, length } = require_derive.toOriginalRange(haystack, at, needleLength);
+	return !wordBefore(haystack.original, start) && !wordAt(haystack.original, start + length);
+}
+/**
 * All non-overlapping literal matches, in original code-unit space.
 * `haystack` must have been folded with `foldOptionsFor(query)`.
 */
 function matchLiteral(haystack, query) {
-	const needle = require_fold.foldText(query.text, foldOptionsFor(query)).folded;
+	const needle = require_derive.foldText(query.text, foldOptionsFor(query)).folded;
 	if (needle.trim().length === 0) return [];
 	const out = [];
 	let from = 0;
 	while (from <= haystack.folded.length - needle.length) {
 		const at = haystack.folded.indexOf(needle, from);
 		if (at < 0) break;
-		if (query.wholeWord && (wordBefore(haystack.folded, at) || wordAt(haystack.folded, at + needle.length))) {
+		if (query.wholeWord && !isWholeWordHit(haystack, at, needle.length, query)) {
 			from = at + 1;
 			continue;
 		}
@@ -2248,7 +2188,7 @@ function matchLiteral(haystack, query) {
 				continue;
 			}
 		}
-		out.push(require_fold.toOriginalRange(haystack, at, needle.length));
+		out.push(require_derive.toOriginalRange(haystack, at, needle.length));
 		from = at + needle.length;
 	}
 	return out;
@@ -2338,6 +2278,11 @@ function validateSearchQuery(query) {
 		issue: "diacritics-with-regex",
 		message: "Diacritic-sensitive matching is not available for regex patterns (regex runs on the raw text plane)."
 	};
+	if (query.ignoreWhitespace) return {
+		ok: false,
+		issue: "ignore-whitespace-with-regex",
+		message: "Whitespace-insensitive matching is not available for regex patterns (regex runs on the raw text plane; use \\s* in the pattern)."
+	};
 	return validateSearchRegex(query.text);
 }
 /**
@@ -2385,7 +2330,7 @@ function matchRegex(text, query) {
 */
 function matchPageText(text, query) {
 	if (query.regex) return matchRegex(text, query);
-	return matchLiteral(require_fold.foldText(text, foldOptionsFor(query)), query);
+	return matchLiteral(require_derive.foldText(text, foldOptionsFor(query)), query);
 }
 //#endregion
 //#region src/search/snippet.ts
@@ -2525,7 +2470,7 @@ function buildPageTextLayout(snapshot) {
 	const runs = [];
 	const frames = [IDENTITY_FRAME];
 	for (const run of snapshot.runs) {
-		if (!require_fold.isRotatedGeometryRun(run)) {
+		if (!require_derive.isRotatedGeometryRun(run)) {
 			for (const g of run.glyphs) glyphs.push({
 				loose: g.looseBox,
 				tight: g.tightBox,
@@ -2921,8 +2866,8 @@ function fnv1a64(input) {
 * untouched (their raw form IS the query).
 */
 function canonicalSearchQuery(query) {
-	if (query.regex || query.matchCase || query.matchDiacritics) return query;
-	const canonical = { text: require_fold.foldText(query.text).folded };
+	if (query.regex || query.matchCase || query.matchDiacritics || query.ignoreWhitespace) return query;
+	const canonical = { text: require_derive.foldText(query.text).folded };
 	if (query.wholeWord) canonical.wholeWord = true;
 	return canonical;
 }
@@ -3116,6 +3061,12 @@ function materializePdfPermissions(b) {
 	return [...out];
 }
 //#endregion
+//#region src/measure/viewport.ts
+/** Last containing viewport wins. A foreign measure still wins; never guess a fallback. */
+function viewportForPoint(viewports, point) {
+	return [...viewports].reverse().find(({ bbox: b }) => point.x >= b.left && point.x <= b.right && point.y >= b.bottom && point.y <= b.top);
+}
+//#endregion
 Object.defineProperty(exports, "DEFAULT_EDGE_RESOLVER_BUDGET", {
 	enumerable: true,
 	get: function() {
@@ -3200,12 +3151,6 @@ Object.defineProperty(exports, "buildSnippet", {
 		return buildSnippet;
 	}
 });
-Object.defineProperty(exports, "buildThreads", {
-	enumerable: true,
-	get: function() {
-		return buildThreads;
-	}
-});
 Object.defineProperty(exports, "canonicalSearchQuery", {
 	enumerable: true,
 	get: function() {
@@ -3230,12 +3175,6 @@ Object.defineProperty(exports, "changesAnnotationList", {
 		return changesAnnotationList;
 	}
 });
-Object.defineProperty(exports, "classifyRelation", {
-	enumerable: true,
-	get: function() {
-		return classifyRelation;
-	}
-});
 Object.defineProperty(exports, "collab", {
 	enumerable: true,
 	get: function() {
@@ -3416,12 +3355,6 @@ Object.defineProperty(exports, "primaryFinding", {
 		return primaryFinding;
 	}
 });
-Object.defineProperty(exports, "refKey", {
-	enumerable: true,
-	get: function() {
-		return refKey;
-	}
-});
 Object.defineProperty(exports, "refsOf", {
 	enumerable: true,
 	get: function() {
@@ -3542,6 +3475,12 @@ Object.defineProperty(exports, "validateSearchRegex", {
 		return validateSearchRegex;
 	}
 });
+Object.defineProperty(exports, "viewportForPoint", {
+	enumerable: true,
+	get: function() {
+		return viewportForPoint;
+	}
+});
 Object.defineProperty(exports, "wordAt", {
 	enumerable: true,
 	get: function() {
@@ -3561,4 +3500,4 @@ Object.defineProperty(exports, "worstVerdict", {
 	}
 });
 
-//# sourceMappingURL=builders-Bqm8yTpi.cjs.map
+//# sourceMappingURL=viewport-BWeNHZmb.cjs.map