@epam/ai-dial-quotations 1.1.0-dev.488 → 1.1.0-dev.491

package/index.js

@@ -148,53 +148,93 @@ var w = {
 	borderWidth: "2px",
 	opacity: .5,
 	hoverOpacity: .5
-}, N = (e) => e.flatMap((e, t) => {
+}, N = (e) => {
+	if (typeof e != "object" || !e) return;
+	let t = e, { lt: n, wh: r } = t;
+	if (Array.isArray(n) && Array.isArray(r) && n.length >= 2 && r.length >= 2) {
+		let [e, t] = n, [i, a] = r;
+		if (typeof e == "number" && typeof t == "number" && typeof i == "number" && typeof a == "number") return {
+			x1: e,
+			y1: t,
+			x2: e + i,
+			y2: t + a
+		};
+	}
+	let { left: i, top: a, width: o, height: s } = t;
+	if (typeof i == "number" && typeof a == "number" && typeof o == "number" && typeof s == "number") return {
+		x1: i,
+		y1: a,
+		x2: i + o,
+		y2: a + s
+	};
+}, P = (e) => {
+	if (!r(e)) return;
+	let t = e, n;
+	if (t.type === "pdf_bbox") {
+		let { x1: e, y1: r, x2: i, y2: a } = t;
+		typeof e == "number" && typeof r == "number" && typeof i == "number" && typeof a == "number" && (n = {
+			x1: e,
+			y1: r,
+			x2: i,
+			y2: a
+		});
+	} else t.type === "pdf_region" && (n = N(t.bbox));
+	if (n == null) return;
+	let i = t.page;
+	if (!(typeof i != "number" || !Number.isInteger(i) || i < 1) && [
+		n.x1,
+		n.y1,
+		n.x2,
+		n.y2
+	].every(Number.isFinite)) return {
+		page: i,
+		x1: n.x1,
+		y1: n.y1,
+		x2: n.x2,
+		y2: n.y2
+	};
+}, ee = (e) => e.flatMap((e, t) => {
 	let n = e.body?.selector;
 	if (n == null) return [];
 	let i = (Array.isArray(n) ? n : [n]).flatMap((e) => {
-		if (!r(e) || e.type !== "pdf_bbox") return [];
-		let { page: t, x1: n, y1: i, x2: a, y2: o } = e;
-		return !Number.isInteger(t) || t < 1 || ![
-			n,
-			i,
-			a,
-			o
-		].every(Number.isFinite) ? [] : [{
-			page: t,
-			x1: n,
-			y1: i,
-			x2: a,
-			y2: o
-		}];
+		if (!r(e)) return [];
+		let t = P(e);
+		return t == null ? [] : [t];
 	});
 	return i.length === 0 ? [] : [{
 		id: String(e.index ?? t),
 		bboxes: i,
 		style: M
 	}];
-}), ee = (e, t) => String(e.index ?? t), te = (e) => {
+}), te = (e, t) => String(e.index ?? t), ne = (e) => {
 	let t = e.body?.selector;
-	if (t != null) return (Array.isArray(t) ? t : [t]).find((e) => r(e) && e.type === "pdf_bbox" && typeof e.page == "number" && Number.isInteger(e.page) && e.page >= 1)?.page;
-}, P = (e) => {
+	if (t == null) return;
+	let n = Array.isArray(t) ? t : [t];
+	for (let e of n) {
+		if (!r(e)) continue;
+		let t = P(e);
+		if (t != null) return t.page;
+	}
+}, F = (e) => {
 	let t = e.custom_content?.annotations;
 	if (t?.length) return t.filter((e) => e != null && e.body?.source?.attachment?.url != null).map(a);
 	let n = e.custom_fields;
 	if (typeof n != "object" || !n) return [];
 	let r = n.annotations;
 	return !Array.isArray(r) || r.length === 0 ? [] : o(r, e.custom_content?.attachments ?? []).map(a);
-}, F = (e) => {
+}, I = (e) => {
 	if (e.type !== "docx_text_range") return !1;
 	let t = e;
 	return typeof t.story == "string" && Array.isArray(t.path) && t.path.every((e) => typeof e == "number") && typeof t.start == "number" && typeof t.end == "number" && typeof t.text == "string";
-}, I = (e) => {
+}, L = (e) => {
 	if (e.type !== "pptx_text_range") return !1;
 	let t = e;
 	return typeof t.slide == "number" && typeof t.shape_id == "string" && typeof t.start == "number" && typeof t.end == "number" && typeof t.text == "string";
-}, L = (e) => typeof e == "object" && !!e && typeof e.row == "number" && typeof e.col == "number", R = (e) => {
+}, R = (e) => typeof e == "object" && !!e && typeof e.row == "number" && typeof e.col == "number", z = (e) => {
 	if (e.type !== "excel_rc_range") return !1;
 	let t = e;
-	return typeof t.sheet == "string" && L(t.start) && (t.end === void 0 || t.end === null || L(t.end));
-}, ne = (e) => {
+	return typeof t.sheet == "string" && R(t.start) && (t.end === void 0 || t.end === null || R(t.end));
+}, re = (e) => {
 	let { story: t, path: n, start: r, end: i, text: a } = e;
 	if (!(!n.every((e) => Number.isInteger(e)) || !Number.isInteger(r) || !Number.isInteger(i) || r < 0 || i < r)) return {
 		type: "docx_text_range",
@@ -204,7 +244,7 @@ var w = {
 		endExclusive: i,
 		text: a
 	};
-}, re = (e) => {
+}, ie = (e) => {
 	let { slide: t, shape_id: n, start: r, end: i, text: a } = e;
 	if (!(!Number.isInteger(t) || t < 1 || !Number.isInteger(r) || !Number.isInteger(i) || r < 0 || i < r)) return {
 		type: "pptx_text_range",
@@ -214,7 +254,7 @@ var w = {
 		endExclusive: i,
 		text: a
 	};
-}, ie = (e) => {
+}, ae = (e) => {
 	let { sheet: t, start: n, end: r } = e;
 	if (!(t.length === 0 || !Number.isInteger(n.row) || !Number.isInteger(n.col) || n.row < 1 || n.col < 1)) {
 		if (r == null) return {
@@ -229,29 +269,29 @@ var w = {
 			end: r
 		};
 	}
-}, ae = (e) => {
+}, oe = (e) => {
 	let t = e.body?.selector;
 	return t == null ? [] : (Array.isArray(t) ? t : [t]).flatMap((e) => {
 		if (!r(e)) return [];
-		if (F(e)) {
-			let t = ne(e);
-			return t ? [t] : [];
-		}
 		if (I(e)) {
 			let t = re(e);
 			return t ? [t] : [];
 		}
-		if (R(e)) {
+		if (L(e)) {
 			let t = ie(e);
 			return t ? [t] : [];
 		}
+		if (z(e)) {
+			let t = ae(e);
+			return t ? [t] : [];
+		}
 		return [];
 	});
-}, oe = (e, t) => S(() => t ? [] : P(e), [t, e]), se = {
+}, se = (e, t) => S(() => t ? [] : F(e), [t, e]), ce = {
 	openGroupKey: null,
 	activeIndexByGroup: {}
-}, ce = () => {
-	let [e, t] = C(se), n = b((e) => {
+}, le = () => {
+	let [e, t] = C(ce), n = b((e) => {
 		t((t) => ({
 			...t,
 			openGroupKey: e
@@ -282,7 +322,7 @@ var w = {
 		i,
 		e
 	]);
-}, le = /⟦C(\d+)⟧/g, z = (e, t) => {
+}, ue = /⟦C(\d+)⟧/g, B = (e, t) => {
 	let n = t.map((e, t) => ({
 		g: e,
 		idx: t
@@ -295,9 +335,9 @@ var w = {
 	}).sort((e, t) => t.pos - e.pos), r = e;
 	for (let { idx: e, pos: t } of n) r = `${r.slice(0, t)}⟦C${e}⟧${r.slice(t)}`;
 	return r;
-}, B = /<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>/g, V = /^<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>$/, H = /<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>|<\/?cit\b[^>]*>|<\/?cit\b[^>]*$/gi, U = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), W = (e) => e.replace(H, (e) => V.test(e) ? e : U(e)), G = (e) => W(e).replace(B, ""), K = (e, t) => {
+}, V = /<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>/g, H = /^<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>$/, de = /<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>|<\/?cit\b[^>]*>|<\/?cit\b[^>]*$/gi, fe = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), U = (e) => e.replace(de, (e) => H.test(e) ? e : fe(e)), W = (e) => U(e).replace(V, ""), G = (e, t) => {
 	if (typeof e == "string") {
-		let n = e.split(le);
+		let n = e.split(ue);
 		if (n.length === 1) return e;
 		let r = [];
 		return n.forEach((e, n) => {
@@ -305,18 +345,18 @@ var w = {
 		}), r;
 	}
 	return Array.isArray(e) ? e.flatMap((e) => {
-		let n = K(e, t);
+		let n = G(e, t);
 		return Array.isArray(n) ? n : [n];
 	}) : e;
-}, ue = (e) => {
+}, pe = (e) => {
 	let t = e.primaryAnnotation.target?.selector;
 	return t?.type === "html_tag" ? t.id : void 0;
-}, de = (e, t) => /* @__PURE__ */ v(g, { children: [
+}, me = (e, t) => /* @__PURE__ */ v(g, { children: [
 	e == null ? "<cit>" : `<cit data-id="${e}">`,
 	t,
 	"</cit>"
-] }), fe = (e, t, n, r = !1, a = !1) => {
-	let { onPreview: o, onOpenInBrowser: s, buildLabels: c } = n, l = S(() => r ? G(e) : W(t.length > 0 ? z(e, t) : e), [
+] }), he = (e, t, n, r = !1, a = !1) => {
+	let { onPreview: o, onOpenInBrowser: s, buildLabels: c } = n, l = S(() => r ? W(e) : U(t.length > 0 ? B(e, t) : e), [
 		e,
 		t,
 		r
@@ -326,7 +366,7 @@ var w = {
 		markdownComponents: S(() => {
 			let e = /* @__PURE__ */ new Map();
 			for (let n of t) {
-				let t = ue(n);
+				let t = pe(n);
 				t != null && e.set(t, n);
 			}
 			let n = (e) => {
@@ -343,19 +383,19 @@ var w = {
 				return r ? n(r) : null;
 			}, l = { cit: (t) => {
 				let r = t["data-id"] == null ? void 0 : e.get(t["data-id"]);
-				return r ? n(r) : de(t["data-id"], t.children);
+				return r ? n(r) : me(t["data-id"], t.children);
 			} };
 			return t.length === 0 ? u ? l : {} : {
 				...l,
 				p: ({ children: e, ...t }) => /* @__PURE__ */ _("p", {
 					...t,
 					className: i(a ? "dial-small-paragraph-text" : "dial-body-paragraph-text", "mb-3 [overflow-wrap:anywhere] [text-wrap:pretty] last:mb-0"),
-					children: K(e, r)
+					children: G(e, r)
 				}),
 				li: ({ children: e, ...t }) => /* @__PURE__ */ _("li", {
 					...t,
 					className: "mb-1.5 last:mb-0",
-					children: K(e, r)
+					children: G(e, r)
 				})
 			};
 		}, [
@@ -367,42 +407,42 @@ var w = {
 			u
 		])
 	};
-}, q = (e) => {
+}, K = (e) => {
 	try {
 		return decodeURIComponent(e);
 	} catch {
 		return e;
 	}
-}, pe = (e) => {
+}, ge = (e) => {
 	try {
 		let t = new URL(e);
-		return t.pathname.split("/").map((e) => q(e)).filter(Boolean).at(-1) ?? t.hostname;
+		return t.pathname.split("/").map((e) => K(e)).filter(Boolean).at(-1) ?? t.hostname;
 	} catch {
-		return e.split("/").map((e) => q(e)).filter(Boolean).at(-1) ?? e;
+		return e.split("/").map((e) => K(e)).filter(Boolean).at(-1) ?? e;
 	}
-}, J = (e, t) => e.body?.source?.attachment?.title ?? pe(t), Y = (e) => {
+}, q = (e, t) => e.body?.source?.attachment?.title ?? ge(t), J = (e) => {
 	let t = e.target?.selector;
 	return t?.type === "html_tag" ? t : void 0;
-}, me = (e) => Y(e) != null, X = (e) => {
+}, _e = (e) => J(e) != null, Y = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
-		if (me(n)) continue;
+		if (_e(n)) continue;
 		let e = n.body?.source?.attachment?.url;
 		if (e == null) continue;
 		let r = t.get(e);
 		r ? r.annotations.push(n) : t.set(e, {
 			groupKey: e,
 			sourceUrl: e,
-			sourceName: J(n, e),
+			sourceName: q(n, e),
 			annotations: [n],
 			primaryAnnotation: n
 		});
 	}
 	return Array.from(t.values());
-}, Z = (e) => {
+}, X = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
-		let e = Y(n)?.id;
+		let e = J(n)?.id;
 		if (e == null) continue;
 		let r = n.body?.source?.attachment?.url;
 		if (r == null) continue;
@@ -410,22 +450,22 @@ var w = {
 		i ? i.annotations.push(n) : t.set(e, {
 			groupKey: `cit:${e}`,
 			sourceUrl: r,
-			sourceName: J(n, r),
+			sourceName: q(n, r),
 			annotations: [n],
 			primaryAnnotation: n
 		});
 	}
 	return Array.from(t.values());
-}, he = (e) => [...Z(e), ...X(e)], ge = (e, t) => {
+}, ve = (e) => [...X(e), ...Y(e)], Z = (e, t) => {
 	let n = e.body?.source?.attachment?.url;
 	return n == null || !t.includes(e) ? [e] : t.filter((e) => e.body?.source?.attachment?.url === n);
-}, Q = (e) => e.url == null && e.reference_url != null, _e = /^(.*\.pdf)(?:#page=(\d+))?$/i, $ = (e) => {
-	let t = _e.exec(e);
+}, Q = (e) => e.url == null && e.reference_url != null, ye = /^(.*\.pdf)(?:#page=(\d+))?$/i, $ = (e) => {
+	let t = ye.exec(e);
 	return t ? {
 		baseUrl: t[1],
 		page: t[2] == null ? null : Number(t[2])
 	} : null;
-}, ve = (t) => X((t ?? []).filter(Q).map((t) => {
+}, be = (t) => Y((t ?? []).filter(Q).map((t) => {
 	let n = t.reference_url, r = $(n) != null;
 	return { body: {
 		quote: t.data,
@@ -440,4 +480,4 @@ var w = {
 	} };
 }));
 //#endregion
-export { T as CitationCard, O as CitationCardProvider, j as CitationDropdown, E as CitationMarker, ee as annotationHighlightId, ae as annotationToOfficeHighlightLocations, N as annotationsToPdfHighlights, ge as gatherSameSourceAnnotations, te as getAnnotationPdfPage, ve as getReferenceAttachmentGroups, he as groupAnnotations, Z as groupAnnotationsByCitId, X as groupAnnotationsBySource, z as injectCitationSentinels, F as isDocxRangeSelector, R as isExcelRcRangeSelector, I as isPptxRangeSelector, Q as isReferenceOnlyAttachment, $ as parsePdfPageReference, K as replaceSentinelsInChildren, P as resolveMessageAnnotations, G as stripCitTagsWhileStreaming, oe as useAnnotations, ce as useCitationCard, k as useCitationCardContext, fe as useCitationMarkdownComponents };
+export { T as CitationCard, O as CitationCardProvider, j as CitationDropdown, E as CitationMarker, te as annotationHighlightId, oe as annotationToOfficeHighlightLocations, ee as annotationsToPdfHighlights, Z as gatherSameSourceAnnotations, ne as getAnnotationPdfPage, be as getReferenceAttachmentGroups, ve as groupAnnotations, X as groupAnnotationsByCitId, Y as groupAnnotationsBySource, B as injectCitationSentinels, I as isDocxRangeSelector, z as isExcelRcRangeSelector, L as isPptxRangeSelector, Q as isReferenceOnlyAttachment, $ as parsePdfPageReference, G as replaceSentinelsInChildren, F as resolveMessageAnnotations, W as stripCitTagsWhileStreaming, se as useAnnotations, le as useCitationCard, k as useCitationCardContext, he as useCitationMarkdownComponents };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@epam/ai-dial-quotations",
   "description": "Citation and annotation components, hooks, and utilities for AI DIAL conversations",
-  "version": "1.1.0-dev.488",
+  "version": "1.1.0-dev.491",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -23,7 +23,7 @@
   },
   "peerDependencies": {
     "react": "^19.2.8",
-    "@epam/ai-dial-chat-shared": "1.1.0-dev.488",
+    "@epam/ai-dial-chat-shared": "1.1.0-dev.491",
     "@epam/ai-dial-ui-kit": "^0.14.2"
   },
   "repository": {

package/utils/annotation.d.ts

@@ -3,16 +3,19 @@ import { InputHighlightData } from '@epam/pdf-highlighter-kit';
 import { OfficeHighlightLocation } from '../models/office-highlight';
 /**
  * Maps a list of annotations to `InputHighlightData` entries for the PDF viewer.
- * Annotations whose `body.selector` contains no `pdf_bbox` selectors are skipped.
- * The highlight `id` is `annotation.index` when present, otherwise the position
- * in the input array.
+ * Recognizes `pdf_bbox` selectors and both `pdf_region` coordinate forms
+ * (`lt`/`wh` and legacy `left`/`top`/`width`/`height`); annotations whose
+ * `body.selector` contains none of these are skipped. The highlight `id` is
+ * `annotation.index` when present, otherwise the position in the input array.
  */
 export declare const annotationsToPdfHighlights: (annotations: Annotation[]) => InputHighlightData[];
 /** Returns a stable string ID for a given annotation, matching the IDs produced by `annotationsToPdfHighlights`. */
 export declare const annotationHighlightId: (annotation: Annotation, fallbackIndex: number) => string;
 /**
  * Returns the first positive integer PDF page in the annotation's body selectors,
- * or `undefined` when none exists. Independent of bounding-box coordinates.
+ * or `undefined` when none exists. Recognizes `pdf_bbox` selectors and both
+ * `pdf_region` coordinate forms; a page is returned only for a selector whose
+ * geometry also validates (see `readPdfSelectorBox`).
  */
 export declare const getAnnotationPdfPage: (annotation: Annotation) => number | undefined;
 /**

package/utils/annotation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotation.d.ts","sourceRoot":"","sources":["../../src/utils/annotation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,OAAO,EAEP,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAMnC,OAAO,KAAK,EAEV,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAU1E;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GACrC,aAAa,UAAU,EAAE,KACxB,kBAAkB,EA0BjB,CAAC;AAEL,oHAAoH;AACpH,eAAO,MAAM,qBAAqB,GAChC,YAAY,UAAU,EACtB,eAAe,MAAM,KACpB,MAAmD,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,UAAU,KACrB,MAAM,GAAG,SAcX,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAS,OAAO,KAAG,UAAU,EAoBtE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,kBAAkB,KAC3B,QAAQ,IAAI,iBAWd,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,kBAAkB,KAC3B,QAAQ,IAAI,iBAUd,CAAC;AAUF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,kBAAkB,KAC3B,QAAQ,IAAI,oBAQd,CAAC;AA8FF;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,GAC/C,YAAY,UAAU,KACrB,uBAAuB,EAsBzB,CAAC"}
+{"version":3,"file":"annotation.d.ts","sourceRoot":"","sources":["../../src/utils/annotation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,OAAO,EACP,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAMnC,OAAO,KAAK,EAGV,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAqG1E;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACrC,aAAa,UAAU,EAAE,KACxB,kBAAkB,EAoBjB,CAAC;AAEL,oHAAoH;AACpH,eAAO,MAAM,qBAAqB,GAChC,YAAY,UAAU,EACtB,eAAe,MAAM,KACpB,MAAmD,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,UAAU,KACrB,MAAM,GAAG,SAWX,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAS,OAAO,KAAG,UAAU,EAoBtE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,kBAAkB,KAC3B,QAAQ,IAAI,iBAWd,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,kBAAkB,KAC3B,QAAQ,IAAI,iBAUd,CAAC;AAUF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,kBAAkB,KAC3B,QAAQ,IAAI,oBAQd,CAAC;AA8FF;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,GAC/C,YAAY,UAAU,KACrB,uBAAuB,EAsBzB,CAAC"}