@epam/ai-dial-chat-hooks 1.1.0-dev.248 → 1.1.0-dev.249

package/attachment/useAttachmentAction/useAttachmentAction.d.ts

@@ -0,0 +1,34 @@
+import { DisplayAttachment } from '@epam/ai-dial-chat-shared';
+/** Resolves a DIAL Core file id to a downloadable URL. Host-owned — encodes the app's own file-download endpoint. */
+export type ResolveDownloadUrl = (fileId: string) => string | undefined;
+/** Parameters for {@link useAttachmentAction}. */
+export interface UseAttachmentActionParams {
+    /** Resolves a DIAL Core file id to a downloadable URL. */
+    resolveDownloadUrl: ResolveDownloadUrl;
+}
+/** Return value of {@link useAttachmentAction}. */
+export interface UseAttachmentActionResult {
+    /** Default click handler for an attachment tile: download, canvas-preview, or open-in-browser. */
+    handleAttachmentClick: (attachment: DisplayAttachment) => void;
+}
+/** Returns true when a value looks like a DIAL Core file id (`files/{bucket}/{path}`). */
+export declare const isDialFileId: (url: string) => boolean;
+/** Returns true when `downloadAttachment` can trigger a download for `attachment`. */
+export declare const isDownloadableAttachment: (attachment: DisplayAttachment) => boolean;
+/**
+ * Downloads an attachment that carries its own content: a DIAL-hosted file
+ * (`url` resolves to a DIAL file id) or an inline `data` payload. Returns
+ * whether a download was actually triggered, so callers can skip
+ * non-downloadable (reference-only) attachments without duplicating the
+ * DIAL-file-id / URL-resolution checks.
+ */
+export declare const downloadAttachment: (attachment: DisplayAttachment, resolveDownloadUrl: ResolveDownloadUrl) => boolean;
+/**
+ * Default click behavior for a plain attachment tile: downloads DIAL-hosted
+ * and inline (`data`) files, and for reference-only attachments (no `url`/`data`,
+ * only `referenceUrl` — e.g. RAG/search-grounding chunks), opens a PDF
+ * `referenceUrl` in the canvas scrolled to its referenced page when present,
+ * otherwise opens/downloads the `referenceUrl` as-is.
+ */
+export declare const useAttachmentAction: ({ resolveDownloadUrl, }: UseAttachmentActionParams) => UseAttachmentActionResult;
+//# sourceMappingURL=useAttachmentAction.d.ts.map

package/attachment/useAttachmentAction/useAttachmentAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachmentAction.d.ts","sourceRoot":"","sources":["../../../src/attachment/useAttachmentAction/useAttachmentAction.ts"],"names":[],"mappings":"AAKA,OAAO,EAML,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AAInC,qHAAqH;AACrH,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAExE,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,0DAA0D;IAC1D,kBAAkB,EAAE,kBAAkB,CAAC;CACxC;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,kGAAkG;IAClG,qBAAqB,EAAE,CAAC,UAAU,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAChE;AAED,0FAA0F;AAC1F,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,OAAmC,CAAC;AAE/E,sFAAsF;AACtF,eAAO,MAAM,wBAAwB,GACnC,YAAY,iBAAiB,KAC5B,OAEsB,CAAC;AAE1B;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,iBAAiB,EAC7B,oBAAoB,kBAAkB,KACrC,OAuBF,CAAC;AAqDF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,yBAEjC,yBAAyB,KAAG,yBAmC9B,CAAC"}

package/conversation/useAttachmentUpload/useAttachmentUpload.d.ts

@@ -0,0 +1,26 @@
+import { FilesApi } from '@epam/ai-dial-chat-api-client';
+import { Attachment } from '@epam/ai-dial-chat-shared';
+/** Parameters for {@link useAttachmentUpload}. */
+export interface UseAttachmentUploadParams {
+    /** Already-configured generated-client instance used to upload the file. */
+    filesApi: Pick<FilesApi, 'uploadFile'>;
+    /** DIAL Core bucket the file is uploaded into. */
+    bucket: string | undefined;
+    /** Called with batched filenames after a burst of network-error upload failures. */
+    onNetworkError?: (filenames: string[]) => void;
+    /** Debounce window, in ms, for coalescing offline-failure batches. Defaults to `700`. */
+    debounceMs?: number;
+}
+/** Return value of {@link useAttachmentUpload}. */
+export interface UseAttachmentUploadResult {
+    /** Uploads the given attachment's file and resolves to its DIAL Core file URL. */
+    handleUploadAttachment: (attachment: Attachment) => Promise<string>;
+}
+/**
+ * Uploads an attachment's file to DIAL Core storage against an
+ * already-configured `FilesApi` instance, coalescing a burst of
+ * offline/network upload failures into a single debounced callback rather
+ * than firing one notification per failed file.
+ */
+export declare const useAttachmentUpload: ({ filesApi, bucket, onNetworkError, debounceMs, }: UseAttachmentUploadParams) => UseAttachmentUploadResult;
+//# sourceMappingURL=useAttachmentUpload.d.ts.map

package/conversation/useAttachmentUpload/useAttachmentUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachmentUpload.d.ts","sourceRoot":"","sources":["../../../src/conversation/useAttachmentUpload/useAttachmentUpload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,2BAA2B,CAAC;AAKnC,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,4EAA4E;IAC5E,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACvC,kDAAkD;IAClD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,oFAAoF;IACpF,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC/C,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,kFAAkF;IAClF,sBAAsB,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACrE;AAgBD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,mDAKjC,yBAAyB,KAAG,yBA0C9B,CAAC"}

package/conversation/useConversationScroll/useConversationScroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationScroll.d.ts","sourceRoot":"","sources":["../../../src/conversation/useConversationScroll/useConversationScroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAMf,+HAA+H;AAC/H,MAAM,WAAW,2BAA2B,CAAC,CAAC;IAC5C,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,EAAE,CAAC;IACd,+DAA+D;IAC/D,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C,qDAAqD;IACrD,YAAY,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC/C,4FAA4F;IAC5F,UAAU,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC7C;;;;OAIG;IACH,SAAS,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC5C,kFAAkF;IAClF,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAC;IAClE,2DAA2D;IAC3D,qBAAqB,EAAE,OAAO,CAAC;IAC/B,4EAA4E;IAC5E,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B;;;;OAIG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,EAAE,kDAItC,2BAA2B,CAAC,CAAC,CAAC,KAAG,2BAySnC,CAAC"}

package/conversation-sources/useConversationSources/useConversationSources.d.ts

@@ -0,0 +1,20 @@
+import { AttachmentDisplayResolvers, DisplayAttachment, Message } from '@epam/ai-dial-chat-shared';
+import { QuotationSource } from '@epam/ai-dial-source-panel';
+/** Return value of {@link useConversationSources}. */
+export interface UseConversationSourcesResult {
+    /** Deduplicated attachments the user uploaded across the conversation. */
+    uploaded: DisplayAttachment[];
+    /** Deduplicated attachments the assistant generated across the conversation. */
+    generated: DisplayAttachment[];
+    /** Quotation sources referenced by assistant messages, deduplicated by URL. */
+    sources: QuotationSource[];
+}
+/**
+ * Derives uploaded (user), generated (assistant) attachment lists, and
+ * quotation sources from a conversation's message array. All lists are
+ * memoised on the `messages` reference. `resolvers` are forwarded to
+ * `@epam/ai-dial-chat-shared`'s attachment mapper for preview/play URL
+ * resolution — pass an empty object when the host has no such resolution.
+ */
+export declare const useConversationSources: (messages: Message[], resolvers?: AttachmentDisplayResolvers) => UseConversationSourcesResult;
+//# sourceMappingURL=useConversationSources.d.ts.map

package/conversation-sources/useConversationSources/useConversationSources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConversationSources.d.ts","sourceRoot":"","sources":["../../../src/conversation-sources/useConversationSources/useConversationSources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,OAAO,EACR,MAAM,2BAA2B,CAAC;AASnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AASlE,sDAAsD;AACtD,MAAM,WAAW,4BAA4B;IAC3C,0EAA0E;IAC1E,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,gFAAgF;IAChF,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,+EAA+E;IAC/E,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,OAAO,EAAE,EACnB,YAAW,0BAA4C,KACtD,4BA2DF,CAAC"}

package/index.d.ts

@@ -1,2 +1,10 @@
-export * from './useConversationScroll/useConversationScroll';
+export * from './attachment/useAttachmentAction/useAttachmentAction';
+export * from './conversation/useAttachmentUpload/useAttachmentUpload';
+export * from './conversation/useConversationScroll/useConversationScroll';
+export * from './conversation-sources/useConversationSources/useConversationSources';
+export * from './usePageFileDrag/usePageFileDrag';
+export * from './usePanelMaxWidth/usePanelMaxWidth';
+export * from './useShareLink/useShareLink';
+export * from './useShareRecipientsCount/useShareRecipientsCount';
+export * from './useViewportWidth/useViewportWidth';
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+CAA+C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sDAAsD,CAAC;AACrE,cAAc,wDAAwD,CAAC;AACvE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,sEAAsE,CAAC;AACrF,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mDAAmD,CAAC;AAClE,cAAc,qCAAqC,CAAC"}

package/index.js

@@ -1,122 +1,369 @@
-import { useCallback as e, useEffect as t, useLayoutEffect as n, useRef as r, useState as i } from "react";
-//#region src/useConversationScroll/useConversationScroll.ts
-var a = 80, o = 1, s = ({ messages: s, isAssistantTyping: c, conversationId: l }) => {
-	let [u, d] = i(!1), f = r(null), p = r(null), m = r(null), h = r(!1), g = r(!1), _ = r(null), v = r(/* @__PURE__ */ new Map()), y = e((e, t) => {
-		t ? v.current.set(e, t) : v.current.delete(e);
-	}, []), b = r(null), x = e((e) => {
-		b.current = e;
-	}, []), S = e((e, t) => {
-		let n = f.current;
+import { AttachmentContentType as e, useAttachmentCanvas as t } from "@epam/ai-dial-attachment-canvas";
+import { AttachmentErrorReason as n, MIMEType as r, MessageRole as i, base64ToBlob as a, messageAttachmentToDisplayAttachment as o, triggerAnchorDownload as s, triggerBlobDownload as c } from "@epam/ai-dial-chat-shared";
+import { isReferenceOnlyAttachment as l, parsePdfPageReference as u, resolveMessageAnnotations as d } from "@epam/ai-dial-quotations";
+import { useCallback as f, useEffect as p, useLayoutEffect as m, useMemo as h, useRef as g, useState as _ } from "react";
+import { ShareLinkResponseDtoAccessEnum as v } from "@epam/ai-dial-chat-api-client";
+import { ShareLinkAccess as y } from "@epam/ai-dial-share";
+//#region src/attachment/useAttachmentAction/useAttachmentAction.ts
+var b = (e) => e.startsWith("files/"), x = (e) => e.url != null && b(e.url) || e.data != null, S = (e, t) => {
+	let { url: n, name: i, contentType: o, data: l } = e;
+	if (n != null && b(n)) {
+		let e = t(n);
+		return e == null ? !1 : (s(e, i), !0);
+	}
+	return l == null ? !1 : (c(a(l, o || r.Plain), i), !0);
+}, C = (e, t) => {
+	let { url: n } = e;
+	if (n == null) return;
+	let r = n.split("#")[0];
+	if (b(r)) {
+		let n = t(r);
+		if (n == null) return;
+		s(n, e.title ?? r.split("/").pop() ?? "");
+	} else window.open(n, "_blank", "noopener,noreferrer");
+}, w = (t, n) => {
+	let r = u(t.url);
+	if (r == null) return null;
+	let i = b(r.baseUrl) ? n(r.baseUrl) : r.baseUrl;
+	if (i == null) return null;
+	if (r.page == null) return {
+		type: e.Pdf,
+		url: i
+	};
+	let a = `reference-page-${r.page}`;
+	return {
+		type: e.Pdf,
+		url: i,
+		highlights: [{
+			id: a,
+			bboxes: [{
+				page: r.page,
+				x1: 0,
+				y1: 0,
+				x2: 0,
+				y2: 0
+			}],
+			style: {
+				backgroundColor: "transparent",
+				opacity: 0
+			}
+		}],
+		selectedHighlightId: a
+	};
+}, T = ({ resolveDownloadUrl: e }) => {
+	let { openCanvas: n } = t();
+	return { handleAttachmentClick: f((t) => {
+		let { url: r, referenceUrl: i, data: a, name: o } = t;
+		if (r != null || a != null) {
+			S(t, e);
+			return;
+		}
+		if (i == null) return;
+		let s = {
+			type: t.contentType,
+			url: i,
+			title: o
+		}, c = w(s, e);
+		if (c) {
+			n(c, o);
+			return;
+		}
+		C(s, e);
+	}, [n, e]) };
+}, E = 700, D = (e) => (e.split(/[\\/]/).filter(Boolean).pop() ?? "file").replace(/\.\.+/g, ".").replace(/^\.+/, "") || "file", O = (e, t = /* @__PURE__ */ new Date()) => `uploads/${t.getFullYear()}-${String(t.getMonth() + 1).padStart(2, "0")}/${encodeURIComponent(D(e))}`, k = ({ filesApi: e, bucket: t, onNetworkError: r, debounceMs: i = E }) => {
+	let a = g([]), o = g(null);
+	return { handleUploadAttachment: f(async (s) => {
+		if (!t) throw Error("User bucket is not available");
+		try {
+			return (await e.uploadFile({
+				bucket: t,
+				path: O(s.name),
+				file: s.file
+			})).url;
+		} catch (e) {
+			if (!navigator.onLine) {
+				a.current.push(s.name), o.current != null && clearTimeout(o.current), o.current = setTimeout(() => {
+					let e = a.current.splice(0);
+					r?.(e), o.current = null;
+				}, i);
+				let t = e instanceof Error ? e : /* @__PURE__ */ Error("Network upload failed");
+				throw t.errorReason = n.Network, t;
+			}
+			throw e;
+		}
+	}, [
+		t,
+		i,
+		e,
+		r
+	]) };
+}, A = 80, j = 1, M = ({ messages: e, isAssistantTyping: t, conversationId: n }) => {
+	let [r, i] = _(!1), a = g(null), o = g(null), s = g(null), c = g(!1), l = g(!1), u = g(null), d = g(/* @__PURE__ */ new Map()), h = f((e, t) => {
+		t ? d.current.set(e, t) : d.current.delete(e);
+	}, []), v = g(null), y = f((e) => {
+		v.current = e;
+	}, []), b = f((e, t) => {
+		let n = a.current;
 		n && n.scrollTo({
 			top: e,
 			behavior: t ? "instant" : "smooth"
 		});
-	}, []), C = e(() => {
-		m.current && (m.current.style.height = "0px"), h.current = !1, g.current = !1, _.current = null;
-	}, []), w = e(() => {
-		let e = f.current, t = p.current;
+	}, []), x = f(() => {
+		s.current && (s.current.style.height = "0px"), c.current = !1, l.current = !1, u.current = null;
+	}, []), S = f(() => {
+		let e = a.current, t = o.current;
 		if (!e || !t) return null;
 		let n = e.getBoundingClientRect(), r = t.getBoundingClientRect();
 		return e.scrollTop + (r.bottom - n.top) - e.clientHeight;
-	}, []), T = e((e = !1) => {
-		let t = w();
-		t != null && S(Math.max(t, 0), e);
-	}, [S, w]), E = e(() => {
-		let e = f.current, t = p.current;
+	}, []), C = f((e = !1) => {
+		let t = S();
+		t != null && b(Math.max(t, 0), e);
+	}, [b, S]), w = f(() => {
+		let e = a.current, t = o.current;
 		if (!e || !t) return null;
 		let n = e.getBoundingClientRect();
 		return t.getBoundingClientRect().bottom - n.top - e.clientHeight;
-	}, []), D = e(() => {
-		if (!g.current) return;
-		let e = E();
-		e == null || e < -1 || C();
-	}, [C, E]), O = e((e) => {
-		let t = f.current, n = v.current.get(e);
-		if (!t || !n) return null;
-		let r = t.getBoundingClientRect(), i = n.getBoundingClientRect(), a = t.scrollTop + (i.top - r.top);
-		return Math.max(a, 0);
-	}, []), k = e((e, t = !1) => {
-		let n = O(e);
-		n != null && S(n, t);
-	}, [O, S]), A = e(() => {
+	}, []), T = f(() => {
+		if (!l.current) return;
 		let e = w();
+		e == null || e < -1 || x();
+	}, [x, w]), E = f((e) => {
+		let t = a.current, n = d.current.get(e);
+		if (!t || !n) return null;
+		let r = t.getBoundingClientRect(), i = n.getBoundingClientRect(), o = t.scrollTop + (i.top - r.top);
+		return Math.max(o, 0);
+	}, []), D = f((e, t = !1) => {
+		let n = E(e);
+		n != null && b(n, t);
+	}, [E, b]), O = f(() => {
+		let e = S();
 		return e == null ? null : Math.max(e, 0);
-	}, [w]), j = e(() => {
-		if (!h.current) return null;
-		let e = _.current, t = A();
+	}, [S]), k = f(() => {
+		if (!c.current) return null;
+		let e = u.current, t = O();
 		return e == null || t == null ? null : Math.max(e, t);
-	}, [A]), M = e(() => {
-		let e = f.current, t = j();
-		!e || t == null || e.scrollTop > t + o && (e.scrollTop = t);
-	}, [j]), N = e((e) => {
-		let t = m.current, n = A();
+	}, [O]), M = f(() => {
+		let e = a.current, t = k();
+		!e || t == null || e.scrollTop > t + j && (e.scrollTop = t);
+	}, [k]), N = f((e) => {
+		let t = s.current, n = O();
 		if (!t || n == null) return;
 		let r = Math.max(e - n, 0);
-		t.style.height = `${r}px`, h.current = r > 0, g.current = !1, _.current = r > 0 ? e : null;
-	}, [A]), P = e((e) => {
-		let t = O(e);
-		t != null && (N(t), k(e, !1));
+		t.style.height = `${r}px`, c.current = r > 0, l.current = !1, u.current = r > 0 ? e : null;
+	}, [O]), P = f((e) => {
+		let t = E(e);
+		t != null && (N(t), D(e, !1));
 	}, [
 		N,
-		O,
-		k
-	]), F = e(() => {
-		let e = E();
-		e != null && d(e >= a);
-	}, [E]), I = r(s.length), L = r(null);
-	n(() => {
-		let e = s.length !== I.current, t = l !== L.current, n = () => {
-			I.current = s.length, L.current = l;
+		E,
+		D
+	]), F = f(() => {
+		let e = w();
+		e != null && i(e >= A);
+	}, [w]), I = g(e.length), L = g(null);
+	m(() => {
+		let r = e.length !== I.current, i = n !== L.current, a = () => {
+			I.current = e.length, L.current = n;
 		};
-		t && C();
-		let r = b.current;
-		if (r != null && v.current.has(r)) {
-			b.current = null, P(r), n();
+		i && x();
+		let o = v.current;
+		if (o != null && d.current.has(o)) {
+			v.current = null, P(o), a();
 			return;
 		}
-		c || ((e || t) && T(!1), n());
+		t || ((r || i) && C(!1), a());
 	}, [
-		s,
-		c,
-		l,
-		T,
+		e,
+		t,
+		n,
+		C,
 		P,
-		C
-	]), n(() => {
-		!c && h.current && (g.current = !0, D());
-	}, [c, D]);
-	let R = e(() => {
-		M(), D(), F();
+		x
+	]), m(() => {
+		!t && c.current && (l.current = !0, T());
+	}, [t, T]);
+	let R = f(() => {
+		M(), T(), F();
 	}, [
 		M,
-		D,
+		T,
 		F
 	]);
-	return t(() => {
-		let e = f.current;
+	return p(() => {
+		let e = a.current;
 		if (e) return e.addEventListener("scroll", R, { passive: !0 }), () => e.removeEventListener("scroll", R);
-	}, [R]), t(() => {
-		let e = p.current;
+	}, [R]), p(() => {
+		let e = o.current;
 		if (!e) return;
 		let t = new ResizeObserver(() => {
-			M(), D(), F();
+			M(), T(), F();
 		});
 		return t.observe(e), () => t.disconnect();
 	}, [
 		M,
-		D,
+		T,
 		F
 	]), {
-		containerRef: f,
-		contentRef: p,
-		spacerRef: m,
-		setMessageRef: y,
-		isScrollButtonVisible: u,
-		scrollToBottom: e(() => {
-			T(!1);
-		}, [T]),
-		armAnchor: x
+		containerRef: a,
+		contentRef: o,
+		spacerRef: s,
+		setMessageRef: h,
+		isScrollButtonVisible: r,
+		scrollToBottom: f(() => {
+			C(!1);
+		}, [C]),
+		armAnchor: y
+	};
+}, N = {}, P = (e, t = N) => h(() => {
+	let n = [], r = [], a = [], s = /* @__PURE__ */ new Set(), c = /* @__PURE__ */ new Set(), u = /* @__PURE__ */ new Set();
+	for (let f of e) {
+		let e = f.custom_content?.attachments;
+		if (f.role === i.User) for (let r of e ?? []) {
+			let e = o(r, t);
+			c.has(e.id) || (c.add(e.id), n.push(e));
+		}
+		else if (f.role === i.Assistant) {
+			let n = e?.filter((e) => !l(e));
+			for (let e of n ?? []) {
+				let n = o(e, t);
+				u.has(n.id) || (u.add(n.id), r.push(n));
+			}
+			for (let t of e ?? []) {
+				if (!l(t)) continue;
+				let e = t.reference_url;
+				s.has(e) || (s.add(e), a.push({
+					url: e,
+					title: t.title ?? e,
+					contentType: t.reference_type ?? t.type ?? "",
+					quote: t.data
+				}));
+			}
+			for (let e of d(f)) {
+				let t = e?.body?.source?.attachment, n = t?.url;
+				!n || s.has(n) || (s.add(n), a.push({
+					url: n,
+					title: t?.title ?? n.split("/").pop() ?? n,
+					contentType: t?.type ?? "",
+					quote: e.body?.quote
+				}));
+			}
+		}
+	}
+	return {
+		uploaded: n,
+		generated: r,
+		sources: a
+	};
+}, [e, t]), F = (e = !0, t = !0) => {
+	let [n, r] = _(!1), [i, a] = _([]), o = g(0), s = g(e), c = g(t);
+	m(() => {
+		s.current = e, c.current = t, t || (o.current = 0, r(!1));
+	}, [e, t]);
+	let l = f(() => {
+		a([]);
+	}, []);
+	return p(() => {
+		let e = (e) => !!e.dataTransfer?.types.includes("Files"), t = (t) => {
+			!c.current || !e(t) || (o.current += 1, r(!0));
+		}, n = (t) => {
+			!c.current || !e(t) || (--o.current, o.current <= 0 && (o.current = 0, r(!1)));
+		}, i = (t) => {
+			e(t) && (t.preventDefault(), c.current);
+		}, l = (t) => {
+			if (!(!e(t) || !c.current) && (t.preventDefault(), o.current = 0, r(!1), s.current)) {
+				let e = Array.from(t.dataTransfer?.files ?? []);
+				e.length > 0 && a(e);
+			}
+		};
+		return document.addEventListener("dragenter", t), document.addEventListener("dragleave", n), document.addEventListener("dragover", i), document.addEventListener("drop", l), () => {
+			document.removeEventListener("dragenter", t), document.removeEventListener("dragleave", n), document.removeEventListener("dragover", i), document.removeEventListener("drop", l);
+		};
+	}, []), {
+		isDragging: n,
+		pendingFiles: i,
+		onFilesConsumed: l
+	};
+}, I = () => typeof window < "u" ? window.innerWidth : 1024, L = () => {
+	let [e, t] = _(I);
+	return p(() => {
+		if (typeof window > "u") return;
+		let e = () => t(window.innerWidth);
+		return window.addEventListener("resize", e), () => window.removeEventListener("resize", e);
+	}, []), e;
+}, R = (e) => {
+	let t = L();
+	return Math.max(0, t - e);
+}, z = (e) => e.map((e) => e === v.Edit ? y.Edit : y.View), B = (e, t) => {
+	let n = new URL(e, t);
+	return `${t}${n.pathname}${n.search}${n.hash}`;
+}, V = (e, t, n, r = window.location.origin) => {
+	let [i, a] = _(), [o, s] = _(!0), [c, l] = _(null), u = g(0), d = f(async (i = [y.View]) => {
+		let o = ++u.current;
+		s(!0), l(null);
+		try {
+			let s = await e.createShareLink({ createShareLinkDto: {
+				itemId: t,
+				resourceKind: n,
+				access: i
+			} });
+			u.current === o && a({
+				url: B(s.url, r),
+				expiresInDays: s.expiresInDays,
+				access: z(s.access)
+			});
+		} catch (e) {
+			u.current === o && l(e instanceof Error ? e : /* @__PURE__ */ Error("Failed to create share link"));
+		} finally {
+			u.current === o && s(!1);
+		}
+	}, [
+		t,
+		r,
+		n,
+		e
+	]);
+	return p(() => {
+		a(void 0), d();
+	}, [t, d]), {
+		data: i,
+		isLoading: o,
+		error: c,
+		setAccess: f((e) => {
+			d(e);
+		}, [d])
+	};
+}, H = /* @__PURE__ */ function(e) {
+	return e.Idle = "idle", e.Loading = "loading", e.Resolved = "resolved", e.Unknown = "unknown", e;
+}({}), U = { status: "idle" }, W = (e) => {
+	let [t, n] = _({}), r = g(/* @__PURE__ */ new Set());
+	return {
+		requestRecipientsCount: f((t) => {
+			r.current.has(t) || (r.current.add(t), n((e) => ({
+				...e,
+				[t]: { status: "loading" }
+			})), (async () => {
+				try {
+					let { recipientsCount: r } = await e.getShareRecipientsCount({ itemId: t });
+					n((e) => ({
+						...e,
+						[t]: {
+							status: "resolved",
+							count: r
+						}
+					}));
+				} catch {
+					n((e) => ({
+						...e,
+						[t]: { status: "unknown" }
+					}));
+				}
+			})());
+		}, [e]),
+		getRecipientsCount: f((e) => t[e] ?? U, [t]),
+		invalidateRecipientsCount: f((e) => {
+			r.current.delete(e), n(({ [e]: t, ...n }) => n);
+		}, [])
 	};
 };
 //#endregion
-export { s as useConversationScroll };
+export { H as RecipientsCountStatus, S as downloadAttachment, b as isDialFileId, x as isDownloadableAttachment, T as useAttachmentAction, k as useAttachmentUpload, M as useConversationScroll, P as useConversationSources, F as usePageFileDrag, R as usePanelMaxWidth, V as useShareLink, W as useShareRecipientsCount, L as useViewportWidth };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@epam/ai-dial-chat-hooks",
   "description": "Framework-level React hooks extracted from AI DIAL Chat for building custom chat interfaces",
-  "version": "1.1.0-dev.248",
+  "version": "1.1.0-dev.249",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -16,11 +16,17 @@
     }
   },
   "peerDependencies": {
-    "react": "^19.2.6"
+    "react": "^19.2.6",
+    "@epam/ai-dial-attachment-canvas": "1.1.0-dev.249",
+    "@epam/ai-dial-chat-api-client": "1.1.0-dev.249",
+    "@epam/ai-dial-chat-shared": "1.1.0-dev.249",
+    "@epam/ai-dial-quotations": "1.1.0-dev.249",
+    "@epam/ai-dial-share": "1.1.0-dev.249",
+    "@epam/ai-dial-source-panel": "1.1.0-dev.249"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/epam/ai-dial-chat.git",
-    "directory": "libs/ai-dial-chat-hooks"
+    "directory": "libs/chat-hooks"
   }
 }

package/test-setup.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test-setup.d.ts.map

package/test-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../src/test-setup.ts"],"names":[],"mappings":""}

package/usePageFileDrag/usePageFileDrag.d.ts

@@ -0,0 +1,16 @@
+/** Return value of {@link usePageFileDrag}. */
+export interface UsePageFileDragResult {
+    /** Whether a file drag is currently over the page. */
+    isDragging: boolean;
+    /** Files dropped on the page, pending consumption by the caller. */
+    pendingFiles: File[];
+    /** Clears `pendingFiles` after the caller has processed them. */
+    onFilesConsumed: () => void;
+}
+/**
+ * Detects files being dragged over the whole page and exposes the dropped
+ * files, using only `document`-level drag events with an enter/leave
+ * counter to avoid flicker from child-element boundary crossings.
+ */
+export declare const usePageFileDrag: (isAttachmentsAllowed?: boolean, isEnabled?: boolean) => UsePageFileDragResult;
+//# sourceMappingURL=usePageFileDrag.d.ts.map

package/usePageFileDrag/usePageFileDrag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePageFileDrag.d.ts","sourceRoot":"","sources":["../../src/usePageFileDrag/usePageFileDrag.ts"],"names":[],"mappings":"AAQA,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,UAAU,EAAE,OAAO,CAAC;IACpB,oEAAoE;IACpE,YAAY,EAAE,IAAI,EAAE,CAAC;IACrB,iEAAiE;IACjE,eAAe,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,8BAA2B,EAC3B,mBAAgB,KACf,qBAwEF,CAAC"}

package/usePanelMaxWidth/usePanelMaxWidth.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns the maximum pixel width a resizable side panel may occupy without
+ * collapsing the main content area below `minContentAreaWidth`.
+ */
+export declare const usePanelMaxWidth: (minContentAreaWidth: number) => number;
+//# sourceMappingURL=usePanelMaxWidth.d.ts.map

package/usePanelMaxWidth/usePanelMaxWidth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePanelMaxWidth.d.ts","sourceRoot":"","sources":["../../src/usePanelMaxWidth/usePanelMaxWidth.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,qBAAqB,MAAM,KAAG,MAG9D,CAAC"}

package/useShareLink/useShareLink.d.ts

@@ -0,0 +1,23 @@
+import { CreateShareLinkDtoResourceKindEnum, ShareApi } from '@epam/ai-dial-chat-api-client';
+import { ShareLinkAccess, ShareLinkData } from '@epam/ai-dial-share';
+/** Result returned by {@link useShareLink}. */
+export interface UseShareLinkResult {
+    /** Resolved share-link data, or `undefined` while loading or on error. */
+    data: ShareLinkData | undefined;
+    /** Whether the share link is still being created. */
+    isLoading: boolean;
+    /** Set when the share link could not be created. */
+    error: Error | null;
+    /** Requests a new share link for the given access levels. */
+    setAccess: (access: ShareLinkAccess[]) => void;
+}
+/**
+ * Resolves and manages share-link data for a DIAL Core resource.
+ *
+ * Accepts an already-configured `ShareApi` instance — this hook owns only
+ * the request lifecycle (loading/error, a stale-response guard, and
+ * re-fetch on access change), not the client's base URL, auth, or CSRF
+ * setup, which stay the caller's responsibility.
+ */
+export declare const useShareLink: (shareApi: Pick<ShareApi, "createShareLink">, itemId: string, resourceKind?: CreateShareLinkDtoResourceKindEnum, origin?: string) => UseShareLinkResult;
+//# sourceMappingURL=useShareLink.d.ts.map

package/useShareLink/useShareLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShareLink.d.ts","sourceRoot":"","sources":["../../src/useShareLink/useShareLink.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kCAAkC,EACvC,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAYrE,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,6DAA6D;IAC7D,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;CAChD;AAcD;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GACvB,UAAU,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,EAC3C,QAAQ,MAAM,EACd,eAAe,kCAAkC,EACjD,SAAQ,MAA+B,KACtC,kBAwDF,CAAC"}

package/useShareRecipientsCount/useShareRecipientsCount.d.ts

@@ -0,0 +1,36 @@
+import { ShareApi } from '@epam/ai-dial-chat-api-client';
+/** Lifecycle of an on-demand recipient-count lookup for one resource. */
+export declare enum RecipientsCountStatus {
+    /** Nothing requested yet for this resource. */
+    Idle = "idle",
+    /** A lookup is in flight. */
+    Loading = "loading",
+    /** A count came back and is known exactly. */
+    Resolved = "resolved",
+    /** The lookup failed, so the count is unknown. */
+    Unknown = "unknown"
+}
+/** State of one resource's recipient-count lookup. */
+export interface RecipientsCountEntry {
+    /** Where the lookup for this resource currently stands. */
+    status: RecipientsCountStatus;
+    /** Number of users holding access; present only once the status is `Resolved`. */
+    count?: number;
+}
+/** Per-resource recipient-count lookups resolved on demand. */
+export interface UseShareRecipientsCountResult {
+    /** Starts a lookup for the resource unless one already ran for it. */
+    requestRecipientsCount: (itemId: string) => void;
+    /** Current lookup state for the resource. */
+    getRecipientsCount: (itemId: string) => RecipientsCountEntry;
+    /** Drops the resource's cached result so the next request fetches it again. */
+    invalidateRecipientsCount: (itemId: string) => void;
+}
+/**
+ * Resolves how many users hold shared access to a resource, one resource at
+ * a time and only when asked. Accepts an already-configured `ShareApi`
+ * instance — this hook owns only the dedup/cache state machine, not the
+ * client's base URL, auth, or CSRF setup.
+ */
+export declare const useShareRecipientsCount: (shareApi: Pick<ShareApi, "getShareRecipientsCount">) => UseShareRecipientsCountResult;
+//# sourceMappingURL=useShareRecipientsCount.d.ts.map

package/useShareRecipientsCount/useShareRecipientsCount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShareRecipientsCount.d.ts","sourceRoot":"","sources":["../../src/useShareRecipientsCount/useShareRecipientsCount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAG9D,yEAAyE;AACzE,oBAAY,qBAAqB;IAC/B,+CAA+C;IAC/C,IAAI,SAAS;IACb,6BAA6B;IAC7B,OAAO,YAAY;IACnB,8CAA8C;IAC9C,QAAQ,aAAa;IACrB,kDAAkD;IAClD,OAAO,YAAY;CACpB;AAED,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,MAAM,EAAE,qBAAqB,CAAC;IAC9B,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,+DAA+D;AAC/D,MAAM,WAAW,6BAA6B;IAC5C,sEAAsE;IACtE,sBAAsB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,6CAA6C;IAC7C,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,oBAAoB,CAAC;IAC7D,+EAA+E;IAC/E,yBAAyB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD;AAMD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,IAAI,CAAC,QAAQ,EAAE,yBAAyB,CAAC,KAClD,6BA0DF,CAAC"}

package/useViewportWidth/useViewportWidth.d.ts

@@ -0,0 +1,3 @@
+/** Tracks `window.innerWidth`, updating on the browser `resize` event. */
+export declare const useViewportWidth: () => number;
+//# sourceMappingURL=useViewportWidth.d.ts.map

package/useViewportWidth/useViewportWidth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewportWidth.d.ts","sourceRoot":"","sources":["../../src/useViewportWidth/useViewportWidth.ts"],"names":[],"mappings":"AAKA,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,QAAO,MAYnC,CAAC"}

package/useConversationScroll/useConversationScroll.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useConversationScroll.d.ts","sourceRoot":"","sources":["../../src/useConversationScroll/useConversationScroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAMf,+HAA+H;AAC/H,MAAM,WAAW,2BAA2B,CAAC,CAAC;IAC5C,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,EAAE,CAAC;IACd,+DAA+D;IAC/D,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C,qDAAqD;IACrD,YAAY,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC/C,4FAA4F;IAC5F,UAAU,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC7C;;;;OAIG;IACH,SAAS,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC5C,kFAAkF;IAClF,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAC;IAClE,2DAA2D;IAC3D,qBAAqB,EAAE,OAAO,CAAC;IAC/B,4EAA4E;IAC5E,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B;;;;OAIG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,EAAE,kDAItC,2BAA2B,CAAC,CAAC,CAAC,KAAG,2BAySnC,CAAC"}