@epam/ai-dial-quotations 1.1.0-dev.413 → 1.1.0-dev.420

package/index.d.ts

@@ -12,7 +12,7 @@ export { useCitationMarkdownComponents } from './hooks/useCitationMarkdownCompon
 export type { UseCitationMarkdownComponentsCallbacks } from './hooks/useCitationMarkdownComponents/useCitationMarkdownComponents';
 export { groupAnnotations, groupAnnotationsByCitId, groupAnnotationsBySource, } from './utils/group-annotations-by-source';
 export type { AnnotationGroup } from './utils/group-annotations-by-source';
-export { annotationsToPdfHighlights, annotationHighlightId, normalizeRawAnnotations, resolveMessageAnnotations, } from './utils/annotation';
+export { annotationsToPdfHighlights, annotationHighlightId, getAnnotationPdfPage, normalizeRawAnnotations, resolveMessageAnnotations, } from './utils/annotation';
 export { injectCitationSentinels, replaceSentinelsInChildren, stripCitTagsWhileStreaming, } from './utils/citation-injection';
 export { isReferenceOnlyAttachment, parsePdfPageReference, getReferenceAttachmentGroups, } from './utils/reference-attachment';
 export type { PdfPageReference } from './utils/reference-attachment';

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AACtE,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAClF,YAAY,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAG5F,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,qEAAqE,CAAC;AACpH,YAAY,EAAE,sCAAsC,EAAE,MAAM,qEAAqE,CAAC;AAGlI,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3E,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AACtE,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAClF,YAAY,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAG5F,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,qEAAqE,CAAC;AACpH,YAAY,EAAE,sCAAsC,EAAE,MAAM,qEAAqE,CAAC;AAGlI,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3E,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC"}

package/index.js

@@ -169,13 +169,18 @@ var j = {
 	if (t != null) return t;
 	let n = e.split(/[?#]/)[0], i = n.lastIndexOf(".");
 	if (i !== -1) return M[n.slice(i + 1).toLowerCase()];
-}, P = (e) => e.flatMap((e, t) => {
+}, P = (e) => typeof e == "object" && !!e && !Array.isArray(e) && "type" in e && typeof e.type == "string", ee = (e) => Array.isArray(e) ? e.filter(P) : P(e) ? e : void 0, F = (e) => e.flatMap((e, t) => {
 	let n = e.body?.selector;
 	if (n == null) return [];
 	let r = (Array.isArray(n) ? n : [n]).flatMap((e) => {
-		if (e.type !== "pdf_bbox") return [];
+		if (!P(e) || e.type !== "pdf_bbox") return [];
 		let { page: t, x1: n, y1: r, x2: i, y2: a } = e;
-		return [{
+		return !Number.isInteger(t) || t < 1 || ![
+			n,
+			r,
+			i,
+			a
+		].every(Number.isFinite) ? [] : [{
 			page: t,
 			x1: n,
 			y1: r,
@@ -188,7 +193,10 @@ var j = {
 		bboxes: r,
 		style: j
 	}];
-}), F = (e, t) => String(e.index ?? t), I = (e) => typeof e == "number" ? e : null, L = (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) => P(e) && e.type === "pdf_bbox" && typeof e.page == "number" && Number.isInteger(e.page) && e.page >= 1)?.page;
+}, I = (e) => typeof e == "number" ? e : null, re = (e) => {
 	if (typeof e != "object" || !e) return null;
 	let t = e;
 	if (t.type !== "pdf_region") return null;
@@ -203,7 +211,7 @@ var j = {
 		x2: i + o,
 		y2: a + s
 	};
-}, ee = (t, n) => {
+}, ie = (t, n) => {
 	let r = t.target;
 	if (typeof r != "object" || !r) return null;
 	let i = r, a = i.source;
@@ -212,7 +220,7 @@ var j = {
 	if (o === null) return null;
 	let s = n.find((e) => e.index === o);
 	if (s?.url == null) return null;
-	let c = L(i.selector);
+	let c = re(i.selector);
 	if (c === null) return null;
 	let l = t.body, u = typeof l == "object" && l ? l : {}, d = typeof u.title == "string" ? u.title : void 0, f = typeof u.quote == "string" ? u.quote : void 0;
 	return {
@@ -231,7 +239,7 @@ var j = {
 			selector: c
 		}
 	};
-}, te = (t) => {
+}, ae = (t) => {
 	let n = t.target;
 	if (typeof n != "object" || !n) return null;
 	let r = n.selector;
@@ -250,12 +258,14 @@ var j = {
 	if (l.type !== "attachment") return null;
 	let u = l.url;
 	if (typeof u != "string") return null;
-	let d = typeof s.title == "string" ? s.title : void 0, f = typeof s.quote == "string" ? s.quote : void 0;
+	let d = typeof s.title == "string" ? s.title : void 0, f = typeof s.quote == "string" ? s.quote : void 0, p = ee(s.selector);
 	return {
+		index: I(t.index) ?? void 0,
 		target: { selector: a },
 		body: {
 			title: d,
 			quote: f,
+			...p === void 0 ? {} : { selector: p },
 			source: {
 				type: "attachment",
 				attachment: {
@@ -266,7 +276,7 @@ var j = {
 			}
 		}
 	};
-}, R = (e) => {
+}, L = (e) => {
 	if (e.target?.selector?.type !== "html_tag") return e;
 	let t = e.body?.source?.attachment;
 	if (t?.url == null) return e;
@@ -285,24 +295,24 @@ var j = {
 			}
 		}
 	};
-}, z = (e, t) => e.flatMap((e) => {
+}, R = (e, t) => e.flatMap((e) => {
 	if (typeof e != "object" || !e) return [];
-	let n = e, r = te(n);
+	let n = e, r = ae(n);
 	if (r) return [r];
-	let i = ee(n, t);
+	let i = ie(n, t);
 	return i ? [i] : [];
-}), B = (e) => {
+}), z = (e) => {
 	let t = e.custom_content?.annotations;
-	if (t?.length) return t.filter((e) => e != null && e.body?.source?.attachment?.url != null).map(R);
+	if (t?.length) return t.filter((e) => e != null && e.body?.source?.attachment?.url != null).map(L);
 	let n = e.custom_fields;
 	if (typeof n != "object" || !n) return [];
 	let r = n.annotations;
-	return !Array.isArray(r) || r.length === 0 ? [] : z(r, e.custom_content?.attachments ?? []).map(R);
-}, ne = (e, t) => v(() => t ? [] : B(e), [t, e]), re = {
+	return !Array.isArray(r) || r.length === 0 ? [] : R(r, e.custom_content?.attachments ?? []).map(L);
+}, oe = (e, t) => v(() => t ? [] : z(e), [t, e]), se = {
 	openGroupKey: null,
 	activeIndexByGroup: {}
-}, ie = () => {
-	let [e, t] = y(re), n = g((e) => {
+}, ce = () => {
+	let [e, t] = y(se), n = g((e) => {
 		t((t) => ({
 			...t,
 			openGroupKey: e
@@ -333,7 +343,7 @@ var j = {
 		i,
 		e
 	]);
-}, ae = /⟦C(\d+)⟧/g, V = (e, t) => {
+}, le = /⟦C(\d+)⟧/g, B = (e, t) => {
 	let n = t.map((e, t) => ({
 		g: e,
 		idx: t
@@ -346,9 +356,9 @@ var j = {
 	}).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;
-}, oe = /<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>/g, se = /^<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) => se.test(e) ? e : U(e)), G = (e) => W(e).replace(oe, ""), K = (e, t) => {
+}, V = /<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>/g, H = /^<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>$/, U = /<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>|<\/?cit\b[^>]*>|<\/?cit\b[^>]*$/gi, ue = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), W = (e) => e.replace(U, (e) => H.test(e) ? e : ue(e)), G = (e) => W(e).replace(V, ""), K = (e, t) => {
 	if (typeof e == "string") {
-		let n = e.split(ae);
+		let n = e.split(le);
 		if (n.length === 1) return e;
 		let r = [];
 		return n.forEach((e, n) => {
@@ -359,15 +369,15 @@ var j = {
 		let n = K(e, t);
 		return Array.isArray(n) ? n : [n];
 	}) : e;
-}, ce = (e) => {
+}, de = (e) => {
 	let t = e.primaryAnnotation.target?.selector;
 	return t?.type === "html_tag" ? t.id : void 0;
-}, le = (e, t) => /* @__PURE__ */ S(b, { children: [
+}, fe = (e, t) => /* @__PURE__ */ S(b, { children: [
 	e == null ? "<cit>" : `<cit data-id="${e}">`,
 	t,
 	"</cit>"
-] }), ue = (e, t, n, r = !1, a = !1) => {
-	let { onPreview: o, onOpenInBrowser: s, buildLabels: c } = n, l = v(() => r ? G(e) : W(t.length > 0 ? V(e, t) : e), [
+] }), pe = (e, t, n, r = !1, a = !1) => {
+	let { onPreview: o, onOpenInBrowser: s, buildLabels: c } = n, l = v(() => r ? G(e) : W(t.length > 0 ? B(e, t) : e), [
 		e,
 		t,
 		r
@@ -377,7 +387,7 @@ var j = {
 		markdownComponents: v(() => {
 			let e = /* @__PURE__ */ new Map();
 			for (let n of t) {
-				let t = ce(n);
+				let t = de(n);
 				t != null && e.set(t, n);
 			}
 			let n = (e) => {
@@ -394,7 +404,7 @@ var j = {
 				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) : le(t["data-id"], t.children);
+				return r ? n(r) : fe(t["data-id"], t.children);
 			} };
 			return t.length === 0 ? u ? l : {} : {
 				...l,
@@ -424,20 +434,20 @@ var j = {
 	} catch {
 		return e;
 	}
-}, de = (e) => {
+}, me = (e) => {
 	try {
 		let t = new URL(e);
 		return t.pathname.split("/").map((e) => q(e)).filter(Boolean).at(-1) ?? t.hostname;
 	} catch {
 		return e.split("/").map((e) => q(e)).filter(Boolean).at(-1) ?? e;
 	}
-}, J = (e, t) => e.body?.source?.attachment?.title ?? de(t), Y = (e) => {
+}, J = (e, t) => e.body?.source?.attachment?.title ?? me(t), Y = (e) => {
 	let t = e.target?.selector;
 	return t?.type === "html_tag" ? t : void 0;
-}, fe = (e) => Y(e) != null, X = (e) => {
+}, he = (e) => Y(e) != null, X = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
-		if (fe(n)) continue;
+		if (he(n)) continue;
 		let e = n.body?.source?.attachment?.url;
 		if (e == null) continue;
 		let r = t.get(e);
@@ -467,13 +477,13 @@ var j = {
 		});
 	}
 	return Array.from(t.values());
-}, pe = (e) => [...Z(e), ...X(e)], Q = (e) => e.url == null && e.reference_url != null, me = /^(.*\.pdf)(?:#page=(\d+))?$/i, $ = (e) => {
-	let t = me.exec(e);
+}, ge = (e) => [...Z(e), ...X(e)], Q = (e) => e.url == null && e.reference_url != null, _e = /^(.*\.pdf)(?:#page=(\d+))?$/i, $ = (e) => {
+	let t = _e.exec(e);
 	return t ? {
 		baseUrl: t[1],
 		page: t[2] == null ? null : Number(t[2])
 	} : null;
-}, he = (t) => X((t ?? []).filter(Q).map((t) => {
+}, ve = (t) => X((t ?? []).filter(Q).map((t) => {
 	let n = t.reference_url, r = $(n) != null;
 	return { body: {
 		quote: t.data,
@@ -488,4 +498,4 @@ var j = {
 	} };
 }));
 //#endregion
-export { w as CitationCard, D as CitationCardProvider, A as CitationDropdown, T as CitationMarker, F as annotationHighlightId, P as annotationsToPdfHighlights, he as getReferenceAttachmentGroups, pe as groupAnnotations, Z as groupAnnotationsByCitId, X as groupAnnotationsBySource, V as injectCitationSentinels, Q as isReferenceOnlyAttachment, z as normalizeRawAnnotations, $ as parsePdfPageReference, K as replaceSentinelsInChildren, B as resolveMessageAnnotations, G as stripCitTagsWhileStreaming, ne as useAnnotations, ie as useCitationCard, O as useCitationCardContext, ue as useCitationMarkdownComponents };
+export { w as CitationCard, D as CitationCardProvider, A as CitationDropdown, T as CitationMarker, te as annotationHighlightId, F as annotationsToPdfHighlights, ne as getAnnotationPdfPage, ve as getReferenceAttachmentGroups, ge as groupAnnotations, Z as groupAnnotationsByCitId, X as groupAnnotationsBySource, B as injectCitationSentinels, Q as isReferenceOnlyAttachment, R as normalizeRawAnnotations, $ as parsePdfPageReference, K as replaceSentinelsInChildren, z as resolveMessageAnnotations, G as stripCitTagsWhileStreaming, oe as useAnnotations, ce as useCitationCard, O as useCitationCardContext, pe 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.413",
+  "version": "1.1.0-dev.420",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -19,7 +19,7 @@
     "react": "^19.0.0",
     "react-markdown": "^10.1.0",
     "@tabler/icons-react": "^3.0.0",
-    "@epam/ai-dial-chat-shared": "1.1.0-dev.413",
+    "@epam/ai-dial-chat-shared": "1.1.0-dev.420",
     "@epam/ai-dial-ui-kit": "*",
     "@epam/pdf-highlighter-kit": ">=0.0.14"
   },

package/utils/annotation.d.ts

@@ -9,6 +9,11 @@ import { InputHighlightData } from '@epam/pdf-highlighter-kit';
 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.
+ */
+export declare const getAnnotationPdfPage: (annotation: Annotation) => number | undefined;
 /**
  * Normalizes raw annotations from the API wire format (stored in
  * `message.custom_fields.annotations`) to the internal `Annotation` model.
@@ -21,7 +26,7 @@ export declare const annotationHighlightId: (annotation: Annotation, fallbackInd
  * - `target.selector` of type `html_tag` (`{ tag, id }`) with a flat
  *   `body.source = { type: 'attachment', url }` — normalized to
  *   `body.source.attachment.url`/`.title` directly, with no attachment-list
- *   lookup and no `index`.
+ *   lookup, preserving optional indexes and document selectors.
  *
  * Annotations matching neither shape are omitted from the result.
  */

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,EAEV,OAAO,EACP,iBAAiB,EAElB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAEV,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AA2BnC;;;;;GAKG;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;AAyKvD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,GAClC,gBAAgB,OAAO,EAAE,EACzB,aAAa,iBAAiB,EAAE,KAC/B,UAAU,EAeT,CAAC;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAS,OAAO,KAAG,UAAU,EAoBtE,CAAC"}
+{"version":3,"file":"annotation.d.ts","sourceRoot":"","sources":["../../src/utils/annotation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAGV,OAAO,EACP,iBAAiB,EAElB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAEV,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAyCnC;;;;;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;AA4KF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,GAClC,gBAAgB,OAAO,EAAE,EACzB,aAAa,iBAAiB,EAAE,KAC/B,UAAU,EAeT,CAAC;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAS,OAAO,KAAG,UAAU,EAoBtE,CAAC"}