@epam/ai-dial-quotations 1.1.0-dev.267 → 1.1.0-dev.268

package/hooks/useCitationMarkdownComponents/useCitationMarkdownComponents.d.ts

@@ -0,0 +1,41 @@
+import { Annotation } from '@epam/ai-dial-chat-shared';
+import { Components } from 'react-markdown';
+import { CitationCardLabels } from '../../components/CitationCard/CitationCard';
+import { CitationMarkerLabels } from '../../components/CitationMarker/CitationMarker';
+import { AnnotationGroup } from '../../utils/group-annotations-by-source';
+/** Host-supplied callbacks and label builder consumed by `useCitationMarkdownComponents`. */
+export interface UseCitationMarkdownComponentsCallbacks {
+    /** Called when a citation marker's preview action is invoked, with the clicked annotation and its group. */
+    onPreview(annotation: Annotation, group: AnnotationGroup): void;
+    /** Called when a citation marker's open-in-browser action is invoked. */
+    onOpenInBrowser(annotation: Annotation): void;
+    /** Builds the translated label bundles used by a given citation group's card and marker. */
+    buildLabels(group: AnnotationGroup): {
+        cardLabels: CitationCardLabels;
+        markerLabels: CitationMarkerLabels;
+    };
+}
+/**
+ * Builds react-markdown component overrides that inject citation markers into
+ * rendered paragraph text at the character offsets stored in each annotation
+ * group's primary selector.
+ *
+ * The `p` and `li` component overrides are stable references — they only
+ * change when `groups` transitions between empty and non-empty. Citation card
+ * open/close state is provided via `CitationCardContext` so that state changes
+ * do not recreate the component functions, preventing ReactMarkdown from
+ * unmounting and remounting the paragraph subtree on every interaction.
+ *
+ * Returns both the pre-processed content string (with sentinel placeholders
+ * injected at the right offsets) and the `Components` map to pass to the
+ * markdown renderer.
+ *
+ * `isCompactTypography` drops the paragraph class one type-scale step, matching
+ * `COMPACT_MARKDOWN_CLASS_NAMES` so cited and uncited paragraphs stay the same
+ * size.
+ */
+export declare const useCitationMarkdownComponents: (content: string, groups: AnnotationGroup[], callbacks: UseCitationMarkdownComponentsCallbacks, isCompactTypography?: boolean) => {
+    processedContent: string;
+    markdownComponents: Components;
+};
+//# sourceMappingURL=useCitationMarkdownComponents.d.ts.map

package/hooks/useCitationMarkdownComponents/useCitationMarkdownComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCitationMarkdownComponents.d.ts","sourceRoot":"","sources":["../../../src/hooks/useCitationMarkdownComponents/useCitationMarkdownComponents.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAK3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE/E,6FAA6F;AAC7F,MAAM,WAAW,sCAAsC;IACrD,4GAA4G;IAC5G,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAChE,yEAAyE;IACzE,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9C,4FAA4F;IAC5F,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG;QACnC,UAAU,EAAE,kBAAkB,CAAC;QAC/B,YAAY,EAAE,oBAAoB,CAAC;KACpC,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,6BAA6B,GACxC,SAAS,MAAM,EACf,QAAQ,eAAe,EAAE,EACzB,WAAW,sCAAsC,EACjD,6BAA2B,KAC1B;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,UAAU,CAAA;CAsD5D,CAAC"}

package/index.d.ts

@@ -8,6 +8,8 @@ export { CitationCardProvider, useCitationCardContext, } from './context/Citatio
 export type { CitationCardHook } from './context/CitationCardContext';
 export { useAnnotations } from './utils/useAnnotations';
 export { useCitationCard } from './utils/useCitationCard';
+export { useCitationMarkdownComponents } from './hooks/useCitationMarkdownComponents/useCitationMarkdownComponents';
+export type { UseCitationMarkdownComponentsCallbacks } from './hooks/useCitationMarkdownComponents/useCitationMarkdownComponents';
 export { groupAnnotationsBySource } from './utils/group-annotations-by-source';
 export type { AnnotationGroup } from './utils/group-annotations-by-source';
 export { annotationsToPdfHighlights, annotationHighlightId, normalizeRawAnnotations, resolveMessageAnnotations, } from './utils/annotation';

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;AAG1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,YAAY,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3E,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EACL,uBAAuB,EACvB,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,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,YAAY,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3E,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EACL,uBAAuB,EACvB,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

@@ -258,20 +258,81 @@ var D = {
 		i,
 		e
 	]);
-}, L = (e) => {
+}, L = /⟦C(\d+)⟧/g, R = (e, t) => {
+	let n = t.map((t, n) => {
+		let r = t.primaryAnnotation.target?.selector, i = typeof r == "object" && r && "type" in r && r.type === "text_character_range" ? r.end : e.length;
+		return {
+			idx: n,
+			pos: Math.min(i, e.length)
+		};
+	}).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;
+}, z = (e, t) => {
+	if (typeof e == "string") {
+		let n = e.split(L);
+		if (n.length === 1) return e;
+		let r = [];
+		return n.forEach((e, n) => {
+			n % 2 == 1 ? r.push(t(parseInt(e, 10))) : e && r.push(e);
+		}), r;
+	}
+	return Array.isArray(e) ? e.flatMap((e) => {
+		let n = z(e, t);
+		return Array.isArray(n) ? n : [n];
+	}) : e;
+}, B = (e, t, n, i = !1) => {
+	let { onPreview: a, onOpenInBrowser: o, buildLabels: s } = n;
+	return {
+		processedContent: g(() => t.length > 0 ? R(e, t) : e, [e, t]),
+		markdownComponents: g(() => {
+			if (t.length === 0) return {};
+			let e = (e) => {
+				let n = t[e];
+				if (!n) return null;
+				let { cardLabels: r, markerLabels: i } = s(n);
+				return /* @__PURE__ */ v(E, {
+					group: n,
+					onPreview: (e) => a(e, n),
+					onOpenInBrowser: o,
+					cardLabels: r,
+					markerLabels: i
+				}, `citation-${n.sourceUrl}`);
+			};
+			return {
+				p: ({ children: t, ...n }) => /* @__PURE__ */ v("p", {
+					...n,
+					className: r(i ? "dial-small-paragraph-text" : "dial-body-paragraph-text", "mb-3 [overflow-wrap:anywhere] [text-wrap:pretty] last:mb-0"),
+					children: z(t, e)
+				}),
+				li: ({ children: t, ...n }) => /* @__PURE__ */ v("li", {
+					...n,
+					className: "mb-1.5 last:mb-0",
+					children: z(t, e)
+				})
+			};
+		}, [
+			t,
+			a,
+			o,
+			s,
+			i
+		])
+	};
+}, V = (e) => {
 	try {
 		return decodeURIComponent(e);
 	} catch {
 		return e;
 	}
-}, R = (e) => {
+}, H = (e) => {
 	try {
 		let t = new URL(e);
-		return t.pathname.split("/").map((e) => L(e)).filter(Boolean).at(-1) ?? t.hostname;
+		return t.pathname.split("/").map((e) => V(e)).filter(Boolean).at(-1) ?? t.hostname;
 	} catch {
-		return e.split("/").map((e) => L(e)).filter(Boolean).at(-1) ?? e;
+		return e.split("/").map((e) => V(e)).filter(Boolean).at(-1) ?? e;
 	}
-}, z = (e) => {
+}, U = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
 		let e = n.body?.source?.attachment?.url;
@@ -279,43 +340,20 @@ var D = {
 		let r = t.get(e);
 		r ? r.annotations.push(n) : t.set(e, {
 			sourceUrl: e,
-			sourceName: n.body?.source?.attachment?.title ?? R(e),
+			sourceName: n.body?.source?.attachment?.title ?? H(e),
 			annotations: [n],
 			primaryAnnotation: n
 		});
 	}
 	return Array.from(t.values());
-}, B = /⟦C(\d+)⟧/g, V = (e, t) => {
-	let n = t.map((t, n) => {
-		let r = t.primaryAnnotation.target?.selector, i = typeof r == "object" && r && "type" in r && r.type === "text_character_range" ? r.end : e.length;
-		return {
-			idx: n,
-			pos: Math.min(i, e.length)
-		};
-	}).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;
-}, H = (e, t) => {
-	if (typeof e == "string") {
-		let n = e.split(B);
-		if (n.length === 1) return e;
-		let r = [];
-		return n.forEach((e, n) => {
-			n % 2 == 1 ? r.push(t(parseInt(e, 10))) : e && r.push(e);
-		}), r;
-	}
-	return Array.isArray(e) ? e.flatMap((e) => {
-		let n = H(e, t);
-		return Array.isArray(n) ? n : [n];
-	}) : e;
-}, U = (e) => e.url == null && e.reference_url != null, W = /^(.*\.pdf)(?:#page=(\d+))?$/i, G = (e) => {
-	let t = W.exec(e);
+}, W = (e) => e.url == null && e.reference_url != null, G = /^(.*\.pdf)(?:#page=(\d+))?$/i, K = (e) => {
+	let t = G.exec(e);
 	return t ? {
 		baseUrl: t[1],
 		page: t[2] == null ? null : Number(t[2])
 	} : null;
-}, K = (t) => z((t ?? []).filter(U).map((t) => {
-	let n = t.reference_url, r = G(n) != null;
+}, q = (t) => U((t ?? []).filter(W).map((t) => {
+	let n = t.reference_url, r = K(n) != null;
 	return { body: {
 		quote: t.data,
 		source: {
@@ -329,4 +367,4 @@ var D = {
 	} };
 }));
 //#endregion
-export { x as CitationCard, w as CitationCardProvider, E as CitationDropdown, S as CitationMarker, k as annotationHighlightId, O as annotationsToPdfHighlights, K as getReferenceAttachmentGroups, z as groupAnnotationsBySource, V as injectCitationSentinels, U as isReferenceOnlyAttachment, M as normalizeRawAnnotations, G as parsePdfPageReference, H as replaceSentinelsInChildren, N as resolveMessageAnnotations, P as useAnnotations, I as useCitationCard, T as useCitationCardContext };
+export { x as CitationCard, w as CitationCardProvider, E as CitationDropdown, S as CitationMarker, k as annotationHighlightId, O as annotationsToPdfHighlights, q as getReferenceAttachmentGroups, U as groupAnnotationsBySource, R as injectCitationSentinels, W as isReferenceOnlyAttachment, M as normalizeRawAnnotations, K as parsePdfPageReference, z as replaceSentinelsInChildren, N as resolveMessageAnnotations, P as useAnnotations, I as useCitationCard, T as useCitationCardContext, B 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.267",
+  "version": "1.1.0-dev.268",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -17,8 +17,9 @@
   },
   "peerDependencies": {
     "react": "^19.0.0",
+    "react-markdown": "^10.1.0",
     "@tabler/icons-react": "^3.0.0",
-    "@epam/ai-dial-chat-shared": "1.1.0-dev.267",
+    "@epam/ai-dial-chat-shared": "1.1.0-dev.268",
     "@epam/ai-dial-ui-kit": "*",
     "@epam/pdf-highlighter-kit": ">=0.0.14"
   },