@epam/ai-dial-chat-hooks 1.3.0-dev.34 → 1.3.0-dev.342

package/catalog/usePublishFolders/usePublishFolders.js

@@ -1,40 +1,43 @@
-import { useCallback as e, useEffect as t, useMemo as n, useState as r } from "react";
-import { ListFilesItemDtoNodeTypeEnum as i } from "@epam/ai-dial-chat-api-client";
+import { ListFilesItemDtoNodeTypeEnum as e } from "@epam/ai-dial-chat-api-client";
+import { useCallback as t, useEffect as n, useMemo as r, useState as i } from "react";
 import { fromFolderPathKey as a, mergeFolderPaths as o, toFolderPathKey as s } from "@epam/ai-dial-publish-panel";
 //#region src/catalog/usePublishFolders/usePublishFolders.ts
-var c = "Production", l = 50, u = (e, t, n) => {
-	let r = e.get(t);
-	return r == null ? [] : r.filter((e) => e.nodeType === i.Folder).map((r) => {
-		let i = r.name, a = [...n, i], o = `${t}${r.name}/`;
+var c = "Production", l = 50, u = (e) => !e.includes(c), d = (e, t) => {
+	let n = Array.isArray(e) ? e.filter((e) => typeof e == "string") : [];
+	if (t && n[0] !== t) return [t, ...n.filter((e) => e !== t)].slice(0, l);
+}, f = (t, n, r) => {
+	let i = t.get(n);
+	return i == null ? [] : i.filter((t) => t.nodeType === e.Folder).map((e) => {
+		let i = e.name, a = [...r, i], o = `${n}${e.name}/`;
 		return {
 			path: a,
 			name: i,
-			children: e.has(o) ? u(e, o, a) : void 0
+			children: t.has(o) ? f(t, o, a) : void 0
 		};
 	});
-}, d = ({ listPublicFiles: i, rememberedFolderKeys: d, onRememberedFolderKeysChange: f }) => {
-	let [p, m] = r(() => /* @__PURE__ */ new Map()), [h, g] = r(() => /* @__PURE__ */ new Set()), [_, v] = r(() => /* @__PURE__ */ new Set()), [y, b] = r([]), x = n(() => {
+}, p = ({ listPublicFiles: e, rememberedFolderKeys: c, onRememberedFolderKeysChange: l }) => {
+	let [p, m] = i(() => /* @__PURE__ */ new Map()), [h, g] = i(() => /* @__PURE__ */ new Set()), [_, v] = i(() => /* @__PURE__ */ new Set()), [y, b] = i([]), x = r(() => {
 		let e = /* @__PURE__ */ new Set();
 		return h.forEach((t) => {
 			let n = t ? `${t}/` : "";
 			p.has(n) && e.add(t);
 		}), e;
-	}, [h, p]), S = e(async (e) => {
-		v((t) => new Set(t).add(e));
+	}, [h, p]), S = t(async (t) => {
+		v((e) => new Set(e).add(t));
 		try {
-			let { items: t } = await i({ path: e || void 0 });
-			m((n) => new Map(n).set(e, t));
+			let { items: n } = await e({ path: t || void 0 });
+			m((e) => new Map(e).set(t, n));
 		} finally {
-			v((t) => {
-				let n = new Set(t);
-				return n.delete(e), n;
+			v((e) => {
+				let n = new Set(e);
+				return n.delete(t), n;
 			});
 		}
-	}, [i]);
-	t(() => {
+	}, [e]);
+	n(() => {
 		S("");
 	}, []);
-	let C = e((e) => {
+	let C = t((e) => {
 		g(e), e.forEach((e) => {
 			let t = `${e}/`;
 			!p.has(t) && !_.has(t) && S(t);
@@ -43,20 +46,20 @@ var c = "Production", l = 50, u = (e, t, n) => {
 		p,
 		_,
 		S
-	]), w = e((e, t) => {
+	]), w = t((e, t) => {
 		let n = s([...e, t]);
 		return b((e) => e.includes(n) ? e : [...e, n]), Promise.resolve();
-	}, []), T = e((e) => {
-		let t = s(e), n = Array.isArray(d) ? d : [];
-		!t || n[0] === t || f?.([t, ...n.filter((e) => e !== t)].slice(0, l));
-	}, [d, f]), E = e((e) => !e.includes(c), []);
+	}, []), T = t((e) => {
+		let t = d(c, s(e));
+		t && l?.(t);
+	}, [c, l]), E = u;
 	return {
-		folderItems: n(() => {
-			let e = Array.isArray(d) ? d.filter((e) => typeof e == "string") : [];
-			return o(u(p, "", []), [...e.map(a), ...y.map(a)]);
+		folderItems: r(() => {
+			let e = Array.isArray(c) ? c.filter((e) => typeof e == "string") : [];
+			return o(f(p, "", []), [...e.map(a), ...y.map(a)]);
 		}, [
 			p,
-			d,
+			c,
 			y
 		]),
 		expandedPaths: h,
@@ -69,4 +72,4 @@ var c = "Production", l = 50, u = (e, t, n) => {
 	};
 };
 //#endregion
-export { d as usePublishFolders };
+export { u as hasPublishFolderWriteAccess, d as rememberPublishFolderKey, p as usePublishFolders };

package/catalog/useResourceFolders/useResourceFolders.d.ts

@@ -0,0 +1,33 @@
+import { ResourceFoldersResponseDto } from '@epam/ai-dial-chat-api-client';
+import { PublishFolderNode } from '@epam/ai-dial-publish-panel';
+/** Parameters for {@link useResourceFolders}. */
+export interface UseResourceFoldersParams {
+    /** Lists the folders directly under a plain-text folder path; `''` is the root. */
+    listFolders: (path: string) => Promise<ResourceFoldersResponseDto>;
+    /** Whether to load at all; the root is fetched the first time this is `true`. Defaults to `true`. */
+    isEnabled?: boolean;
+}
+/** Result returned by {@link useResourceFolders}. */
+export interface UseResourceFoldersResult {
+    /** Folder tree loaded so far, plus folders created locally this session. */
+    folderItems: PublishFolderNode[];
+    /** Folder path keys currently expanded. */
+    expandedPaths: Set<string>;
+    /** Folder path keys currently being fetched. */
+    loadingPaths: Set<string>;
+    /** Called by the folder tree when the expanded folders change; fetches newly expanded ones. */
+    onExpandedPathsChange: (paths: Set<string>) => void;
+    /** Adds a folder under `parentPath` to the in-memory tree only; it is never created on the backend. */
+    onCreateFolder: (parentPath: string[], name: string) => Promise<void>;
+    /** Whether the last fetch of any folder failed. */
+    hasError: boolean;
+    /** Re-fetches every folder whose last fetch failed. */
+    retry: () => void;
+}
+/**
+ * Lazily loads one resource type's personal folder tree, one listing per
+ * expanded folder, for a destination picker. The listing operation is passed
+ * in already bound to the host's client, so the hook knows no endpoint.
+ */
+export declare const useResourceFolders: ({ listFolders, isEnabled, }: UseResourceFoldersParams) => UseResourceFoldersResult;
+//# sourceMappingURL=useResourceFolders.d.ts.map

package/catalog/useResourceFolders/useResourceFolders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceFolders.d.ts","sourceRoot":"","sources":["../../../src/catalog/useResourceFolders/useResourceFolders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,6BAA6B,CAAC;AAGrC,iDAAiD;AACjD,MAAM,WAAW,wBAAwB;IACvC,mFAAmF;IACnF,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACnE,qGAAqG;IACrG,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qDAAqD;AACrD,MAAM,WAAW,wBAAwB;IACvC,4EAA4E;IAC5E,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,2CAA2C;IAC3C,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,gDAAgD;IAChD,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,+FAA+F;IAC/F,qBAAqB,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACpD,uGAAuG;IACvG,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,mDAAmD;IACnD,QAAQ,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAcD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,6BAGhC,wBAAwB,KAAG,wBA2F7B,CAAC"}

package/catalog/useResourceFolders/useResourceFolders.js

@@ -0,0 +1,58 @@
+import { useCallback as e, useEffect as t, useMemo as n, useState as r } from "react";
+import { fromFolderPathKey as i, mergeFolderPaths as a, toFolderPathKey as o } from "@epam/ai-dial-publish-panel";
+//#region src/catalog/useResourceFolders/useResourceFolders.ts
+var s = (e, t) => (e.get(t) ?? []).map((t) => ({
+	path: i(t.path),
+	name: t.name,
+	children: e.has(t.path) ? s(e, t.path) : void 0
+})), c = ({ listFolders: c, isEnabled: l = !0 }) => {
+	let [u, d] = r(() => /* @__PURE__ */ new Map()), [f, p] = r(() => /* @__PURE__ */ new Set()), [m, h] = r(() => /* @__PURE__ */ new Set()), [g, _] = r(() => /* @__PURE__ */ new Set()), [v, y] = r([]), b = e(async (e) => {
+		h((t) => new Set(t).add(e)), _((t) => {
+			let n = new Set(t);
+			return n.delete(e), n;
+		});
+		try {
+			let { folders: t } = await c(e);
+			d((n) => new Map(n).set(e, t));
+		} catch {
+			_((t) => new Set(t).add(e));
+		} finally {
+			h((t) => {
+				let n = new Set(t);
+				return n.delete(e), n;
+			});
+		}
+	}, [c]), [x, S] = r(!1);
+	t(() => {
+		l && !x && (S(!0), b(""));
+	}, [
+		l,
+		x,
+		b
+	]);
+	let C = e((e) => {
+		p(e), e.forEach((e) => {
+			!u.has(e) && !m.has(e) && b(e);
+		});
+	}, [
+		u,
+		m,
+		b
+	]), w = e((e, t) => {
+		let n = o([...e, t]);
+		return y((e) => e.includes(n) ? e : [...e, n]), Promise.resolve();
+	}, []), T = e(() => {
+		g.forEach((e) => void b(e));
+	}, [g, b]);
+	return {
+		folderItems: n(() => a(s(u, ""), v.map(i)), [u, v]),
+		expandedPaths: f,
+		loadingPaths: m,
+		onExpandedPathsChange: C,
+		onCreateFolder: w,
+		hasError: g.size > 0,
+		retry: T
+	};
+};
+//#endregion
+export { c as useResourceFolders };

package/catalog/useResourceSavePanel/useResourceSavePanel.d.ts

@@ -0,0 +1,64 @@
+import { ResourceFoldersResponseDto } from '@epam/ai-dial-chat-api-client';
+import { PublishAccessRulesLabels, StandaloneSaveToFolderPanelProps } from '@epam/ai-dial-publish-panel';
+import { PublishApiClient } from '../create-publish-api';
+import { ResourceSaveVersionError, ResourceSaveAdapter, ResourceSaveChoice, ResourceSaveResult } from '../resource-save';
+import { UsePublishFoldersResult } from '../usePublishFolders/usePublishFolders';
+/** Translated copy the Save flow puts into the panel's state; the panel's own labels stay with the host. */
+export interface UseResourceSavePanelLabels {
+    /** Name of the Personal root node. */
+    personalRoot: string;
+    /** Name of the Organization root node. */
+    organizationRoot: string;
+    /** Error shown above the tree when the Personal folders fail to load. */
+    foldersLoadError: string;
+    /** Submit error used when a failed save carries no backend message. */
+    saveError: string;
+    /** Returns the error shown under the new version input for `error` and the typed `version`. */
+    getVersionError: (error: ResourceSaveVersionError, version: string) => string;
+    /** Text overrides for the access-rules section. */
+    accessRules?: PublishAccessRulesLabels;
+}
+/** Parameters for {@link useResourceSavePanel}. */
+export interface UseResourceSavePanelParams {
+    /** Whether the panel is open; every opening starts from the resource's current location and version. */
+    isOpen: boolean;
+    /** The resource-specific save operations. */
+    adapter: ResourceSaveAdapter;
+    /** Full id of the resource being edited. */
+    resourceId: string;
+    /** Its current Personal folder. */
+    currentFolderPath: string[];
+    /** Current version; omit for an unversioned resource. */
+    currentVersion?: string;
+    /** Pattern a new version must match. */
+    versionPattern: RegExp;
+    /** Lists one level of the resource type's Personal folders. */
+    listPersonalFolders: (path: string) => Promise<ResourceFoldersResponseDto>;
+    /** The Organization folder tree state; omit when the user may not publish, which hides that root. */
+    organizationFolders?: UsePublishFoldersResult;
+    /** Publish operations used for an Organization destination. */
+    publishClient: Pick<PublishApiClient, 'publishCatalogEntity' | 'getPublishRules'>;
+    /** Options offered in the access-rules editor's source picker. */
+    ruleSourceOptions: string[];
+    /** Translated copy. */
+    labels: UseResourceSavePanelLabels;
+    /** Called once a save whose first step succeeded has finished, with the choice it ran. */
+    onSaved: (result: ResourceSaveResult, choice: ResourceSaveChoice) => void;
+}
+/** The {@link StandaloneSaveToFolderPanelProps} the Save flow owns; the host adds the open state, resource summary and labels. */
+export type ResourceSavePanelStateProps = Pick<StandaloneSaveToFolderPanelProps, 'onSubmit' | 'isSubmitDisabled' | 'isSubmitting' | 'submitError' | 'roots' | 'destination' | 'onDestinationChange' | 'onCreateFolder' | 'version' | 'accessRules' | 'onPendingDestinationChange' | 'foldersError' | 'onRetryFolders'>;
+/** Result of {@link useResourceSavePanel}. */
+export interface UseResourceSavePanelResult {
+    /** Props to spread on `StandaloneSaveToFolderPanel`. */
+    panelProps: ResourceSavePanelStateProps;
+    /** Runs the save for the current choice. */
+    submit: () => Promise<void>;
+}
+/**
+ * Owns the Save panel's flow for one resource — the Personal and
+ * Organization destination tree, the version choice, the Organization
+ * folder's access rules — and runs the choice through the resource's
+ * adapter. Notifications stay with the host through `onSaved`.
+ */
+export declare const useResourceSavePanel: ({ isOpen, adapter, resourceId, currentFolderPath, currentVersion, versionPattern, listPersonalFolders, organizationFolders, publishClient, ruleSourceOptions, labels, onSaved, }: UseResourceSavePanelParams) => UseResourceSavePanelResult;
+//# sourceMappingURL=useResourceSavePanel.d.ts.map

package/catalog/useResourceSavePanel/useResourceSavePanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceSavePanel.d.ts","sourceRoot":"","sources":["../../../src/catalog/useResourceSavePanel/useResourceSavePanel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAML,KAAK,wBAAwB,EAG7B,KAAK,gCAAgC,EACtC,MAAM,6BAA6B,CAAC;AAGrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAGL,wBAAwB,EAGxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAGtF,4GAA4G;AAC5G,MAAM,WAAW,0BAA0B;IACzC,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,gBAAgB,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,+FAA+F;IAC/F,eAAe,EAAE,CAAC,KAAK,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9E,mDAAmD;IACnD,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACxC;AAED,mDAAmD;AACnD,MAAM,WAAW,0BAA0B;IACzC,wGAAwG;IACxG,MAAM,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,OAAO,EAAE,mBAAmB,CAAC;IAC7B,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC3E,qGAAqG;IACrG,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;IAC9C,+DAA+D;IAC/D,aAAa,EAAE,IAAI,CACjB,gBAAgB,EAChB,sBAAsB,GAAG,iBAAiB,CAC3C,CAAC;IACF,kEAAkE;IAClE,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,uBAAuB;IACvB,MAAM,EAAE,0BAA0B,CAAC;IACnC,0FAA0F;IAC1F,OAAO,EAAE,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC3E;AAED,kIAAkI;AAClI,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,gCAAgC,EAC9B,UAAU,GACV,kBAAkB,GAClB,cAAc,GACd,aAAa,GACb,OAAO,GACP,aAAa,GACb,qBAAqB,GACrB,gBAAgB,GAChB,SAAS,GACT,aAAa,GACb,4BAA4B,GAC5B,cAAc,GACd,gBAAgB,CACnB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,WAAW,0BAA0B;IACzC,wDAAwD;IACxD,UAAU,EAAE,2BAA2B,CAAC;IACxC,4CAA4C;IAC5C,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAMD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,kLAalC,0BAA0B,KAAG,0BA+R/B,CAAC"}

package/catalog/useResourceSavePanel/useResourceSavePanel.js

@@ -0,0 +1,173 @@
+import { getApiErrorDetails as e } from "../../api-error/api-error.js";
+import { useResourceFolders as t } from "../useResourceFolders/useResourceFolders.js";
+import { ResourceSaveError as n } from "../resource-save-adapter.js";
+import { ResourceSaveVersionError as r, SaveDestinationRoot as i, createPublishSavedResource as ee, runResourceSave as te } from "../resource-save.js";
+import { useCallback as a, useEffect as ne, useMemo as o, useRef as re, useState as s } from "react";
+import { SaveVersionMode as c, toFolderPathKey as ie } from "@epam/ai-dial-publish-panel";
+//#region src/catalog/useResourceSavePanel/useResourceSavePanel.ts
+var ae = (e) => new Set([...e].map((e) => e.replace(/\/$/, ""))), l = ({ isOpen: l, adapter: u, resourceId: d, currentFolderPath: f, currentVersion: p, versionPattern: m, listPersonalFolders: oe, organizationFolders: h, publishClient: g, ruleSourceOptions: _, labels: v, onSaved: y }) => {
+	let b = t({
+		listFolders: oe,
+		isEnabled: l
+	}), { getPublishRules: se } = g, x = o(() => ee(g), [g]), S = o(() => ({
+		rootKey: i.Personal,
+		path: f
+	}), [f]), [C, w] = s(S), [T, ce] = s(c.Keep), [E, D] = s(""), [O, k] = s(!1), [A, j] = s(), [le, M] = s(!1), [ue, N] = s(), [P, F] = s([]), [I, L] = s(!1), [R, z] = s(!1), B = re(void 0), de = a((e) => {
+		if (e?.rootKey !== i.Organization) return;
+		let t = ie(e.path);
+		t !== B.current && (B.current = t, F([]), z(!1), L(!0), (async () => {
+			try {
+				let n = await se(e.path.join("/"));
+				B.current === t && F(n);
+			} catch {
+				B.current === t && z(!0);
+			} finally {
+				B.current === t && L(!1);
+			}
+		})());
+	}, [se]);
+	ne(() => {
+		l && (B.current = void 0, F([]), L(!1), z(!1), w(S), ce(c.Keep), D(""), k(!1), j(void 0), N(void 0));
+	}, [l]);
+	let V = u.isVersioned && T === c.New, H = E.trim(), U = o(() => {
+		if (V) {
+			if (!m.test(H)) return r.Invalid;
+			if (H === p) return r.Unchanged;
+			if (H === A) return r.Exists;
+		}
+	}, [
+		V,
+		m,
+		H,
+		p,
+		A
+	]), W = C.rootKey === i.Organization && (I || R), G = a((e) => {
+		D(e), N(void 0);
+	}, []), K = a(() => k(!0), []), q = h?.rememberPublishFolder, { saveError: J } = v, Y = a(async () => {
+		if (k(!0), U || W) return;
+		M(!0), N(void 0);
+		let t = {
+			resourceId: d,
+			currentFolderPath: f,
+			currentVersion: p,
+			destination: C,
+			versionMode: T,
+			newVersion: H,
+			rules: P
+		};
+		try {
+			let e = await te(u, t, x);
+			e.isPublished && q?.(C.path), y(e, t);
+		} catch (t) {
+			if (t instanceof n) {
+				N(t.message);
+				return;
+			}
+			let { message: r, status: i } = await e(t);
+			if (V && i === 409) {
+				j(H);
+				return;
+			}
+			N(r ?? J);
+		} finally {
+			M(!1);
+		}
+	}, [
+		u,
+		f,
+		p,
+		C,
+		V,
+		W,
+		y,
+		x,
+		q,
+		d,
+		P,
+		J,
+		H,
+		T,
+		U
+	]), fe = a(() => void Y(), [Y]), X = o(() => h ? ae(h.loadingPaths) : void 0, [h]), { personalRoot: Z, organizationRoot: Q } = v, pe = o(() => {
+		let e = {
+			key: i.Personal,
+			label: Z,
+			items: b.folderItems,
+			expandedPaths: b.expandedPaths,
+			onExpandedPathsChange: b.onExpandedPathsChange,
+			loadingPaths: b.loadingPaths
+		};
+		return h ? [e, {
+			key: i.Organization,
+			label: Q,
+			items: h.folderItems,
+			expandedPaths: h.expandedPaths,
+			onExpandedPathsChange: h.onExpandedPathsChange,
+			loadingPaths: X,
+			hasAccessRules: !0
+		}] : [e];
+	}, [
+		h,
+		X,
+		Q,
+		b.expandedPaths,
+		b.folderItems,
+		b.loadingPaths,
+		b.onExpandedPathsChange,
+		Z
+	]), { onCreateFolder: $ } = b, me = h?.onCreatePublishFolder, he = a(async (e, t, n) => {
+		e === i.Organization ? await me?.(t, n) : await $(t, n);
+	}, [$, me]), { getVersionError: ge } = v, _e = o(() => u.isVersioned && p != null ? {
+		versionMode: T,
+		onVersionModeChange: ce,
+		currentVersion: p,
+		newVersion: E,
+		onNewVersionChange: G,
+		onNewVersionBlur: K,
+		newVersionError: O && U ? ge(U, H) : void 0
+	} : void 0, [
+		u.isVersioned,
+		p,
+		ge,
+		O,
+		K,
+		E,
+		G,
+		H,
+		U,
+		T
+	]), { accessRules: ve } = v, ye = o(() => ({
+		rules: P,
+		onRulesChange: F,
+		sourceOptions: _,
+		isLoading: I,
+		hasLoadError: R,
+		labels: ve
+	}), [
+		ve,
+		R,
+		I,
+		_,
+		P
+	]);
+	return {
+		panelProps: {
+			onSubmit: fe,
+			isSubmitDisabled: V && !!U || W,
+			isSubmitting: le,
+			submitError: ue,
+			roots: pe,
+			destination: C,
+			onDestinationChange: w,
+			onCreateFolder: he,
+			version: _e,
+			accessRules: ye,
+			onPendingDestinationChange: de,
+			foldersError: b.hasError ? v.foldersLoadError : void 0,
+			onRetryFolders: b.retry
+		},
+		submit: Y
+	};
+};
+//#endregion
+export { l as useResourceSavePanel };

package/catalog/useSkillDetailsPanelData/useSkillDetailsPanelData.d.ts

@@ -0,0 +1,54 @@
+import { CatalogItem } from '@epam/ai-dial-catalog';
+import { SkillMetadataItemDto } from '@epam/ai-dial-chat-api-client';
+import { SkillFileContent } from '../../skill/skill-file-preview';
+import { DeploymentFolderLabels } from '../map-deployment-to-catalog-item';
+import { SkillOverviewLabels } from '../map-skill-to-catalog-item';
+import { SkillDetailsApi } from '../useSkillItemDetails';
+/** Options accepted by `useSkillDetailsPanelData`. */
+export interface UseSkillDetailsPanelDataOptions {
+    /** Configured API adapter used for all network calls. */
+    api: SkillDetailsApi;
+    /** The user's own skills. */
+    skills: SkillMetadataItemDto[];
+    /** Skills shared with the user. */
+    sharedWithMe?: SkillMetadataItemDto[];
+    /** Public skills. */
+    publicSkills?: SkillMetadataItemDto[];
+    /**
+     * Resource URL (`skills/{bucket}/{path}`) of the skill whose details are
+     * shown; `null` when the panel is closed, which resolves no item.
+     */
+    skillId: string | null;
+    /** Personal/Shared/Public folder labels for the mapped item's folder path. */
+    folderLabels: DeploymentFolderLabels;
+    /** Labels for the skill overview section headers. */
+    skillOverviewLabels: SkillOverviewLabels;
+    /** Favorited resource ids, keyed by skill resource URL. */
+    favoriteIds: ReadonlySet<string>;
+}
+/** Returned by `useSkillDetailsPanelData`. */
+export interface UseSkillDetailsPanelDataResult {
+    /**
+     * The selected skill as a catalog item with its fetched details merged in;
+     * `null` while no skill is selected or the skill is not in the listings.
+     */
+    detailsPanelItem: CatalogItem | null;
+    /** Whether the details fetch for the current item is in flight. */
+    isDetailsLoading: boolean;
+    /** Whether the resolved skill is currently favorited. */
+    isStarred: boolean;
+    /**
+     * Downloads and returns preview bytes for a file inside the open skill's
+     * package. Throws on HTTP errors, unparseable ids, and size-limit
+     * violations.
+     */
+    onLoadSkillDetailsFile(fileId: string): Promise<SkillFileContent>;
+}
+/**
+ * Headless data pipeline behind a skill details side panel: resolves the
+ * selected skill from the listings, maps it to a catalog item with its
+ * ownership flags and folder prefix, fetches its details with cancellation,
+ * and merges the fetch result into the item.
+ */
+export declare const useSkillDetailsPanelData: ({ api, skills, sharedWithMe, publicSkills, skillId, folderLabels, skillOverviewLabels, favoriteIds, }: UseSkillDetailsPanelDataOptions) => UseSkillDetailsPanelDataResult;
+//# sourceMappingURL=useSkillDetailsPanelData.d.ts.map

package/catalog/useSkillDetailsPanelData/useSkillDetailsPanelData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillDetailsPanelData.d.ts","sourceRoot":"","sources":["../../../src/catalog/useSkillDetailsPanelData/useSkillDetailsPanelData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,sDAAsD;AACtD,MAAM,WAAW,+BAA+B;IAC9C,yDAAyD;IACzD,GAAG,EAAE,eAAe,CAAC;IACrB,6BAA6B;IAC7B,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,mCAAmC;IACnC,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,qBAAqB;IACrB,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,8EAA8E;IAC9E,YAAY,EAAE,sBAAsB,CAAC;IACrC,qDAAqD;IACrD,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,2DAA2D;IAC3D,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,8CAA8C;AAC9C,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,gBAAgB,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,mEAAmE;IACnE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,yDAAyD;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACnE;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,uGAStC,+BAA+B,KAAG,8BAqGpC,CAAC"}

package/catalog/useSkillItemDetails.d.ts

@@ -0,0 +1,64 @@
+import { CatalogItem, CatalogItemDetailsFetchResult } from '@epam/ai-dial-catalog';
+import { SkillFileListResponseDto, SkillMetadataItemDto } from '@epam/ai-dial-chat-api-client';
+import { SkillFileContent } from '../skill/skill-file-preview';
+import { SkillOverviewLabels } from './map-skill-to-catalog-item';
+/** Injected API port for skill detail fetching. Mirrors exact server-api wrapper signatures. */
+export interface SkillDetailsApi {
+    /** Downloads a raw skill file, returning the raw fetch `Response`. */
+    downloadSkillFile(bucket: string, path: string, filePath: string, signal?: AbortSignal): Promise<Response>;
+    /** Lists files inside a skill package. */
+    listSkillFiles(params: {
+        bucket: string;
+        filePath: string;
+        path?: string;
+        token?: string;
+        limit?: number;
+        recursive?: boolean;
+    }, signal?: AbortSignal): Promise<SkillFileListResponseDto>;
+    /**
+     * Fetches a single skill's own authoritative metadata (`author`,
+     * `updatedAt`, and the rest of `SkillMetadataItemDto`) — not the catalog
+     * listing entry, which may be sparse for a shared skill.
+     */
+    getSkillMetadata(bucket: string, path: string, signal?: AbortSignal): Promise<SkillMetadataItemDto>;
+}
+/** Options accepted by `useSkillItemDetails`. */
+export interface UseSkillItemDetailsOptions {
+    /** Configured API adapter used for all network calls. */
+    api: SkillDetailsApi;
+    /**
+     * Combined array of all skills visible to this user
+     * (personal + shared + public) for overview metadata lookup.
+     */
+    skills: SkillMetadataItemDto[];
+    /** Labels for skill overview section headers. */
+    skillOverviewLabels: SkillOverviewLabels;
+}
+/** Returned callbacks from `useSkillItemDetails`. All callbacks are stable for stable inputs. */
+export interface UseSkillItemDetailsResult {
+    /**
+     * Fetches full detail data for a skill catalog item.
+     * Returns `undefined` on failure (error handled by caller).
+     */
+    onFetchSkillDetails(item: CatalogItem): Promise<CatalogItemDetailsFetchResult | undefined>;
+    /**
+     * Loads the text content of a file inside the currently open skill's package.
+     * Returns `undefined` when the file cannot be read or is a directory.
+     */
+    onLoadContentFile(fileId: string): Promise<string | undefined>;
+    /**
+     * Downloads and returns preview bytes for a file inside the currently open skill's package.
+     * Throws on HTTP errors, unparseable ids, and size-limit violations.
+     */
+    onLoadSkillDetailsFile(fileId: string): Promise<SkillFileContent>;
+}
+/**
+ * Headless hook that encapsulates skill detail fetching: manifest download and
+ * parse, package file listing, authoritative metadata fetching, overview
+ * construction, and in-package file loads. `useCatalogItemDetails` delegates
+ * its skill branch here; hosts that only surface skill details consume this
+ * hook directly, without the deployment and prompt ports the full catalog
+ * pipeline requires.
+ */
+export declare const useSkillItemDetails: ({ api, skills, skillOverviewLabels, }: UseSkillItemDetailsOptions) => UseSkillItemDetailsResult;
+//# sourceMappingURL=useSkillItemDetails.d.ts.map

package/catalog/useSkillItemDetails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSkillItemDetails.d.ts","sourceRoot":"","sources":["../../src/catalog/useSkillItemDetails.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,6BAA6B,EAC9B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAYpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,gGAAgG;AAChG,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrB,0CAA0C;IAC1C,cAAc,CACZ,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrC;;;;OAIG;IACH,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC;AAED,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC,yDAAyD;IACzD,GAAG,EAAE,eAAe,CAAC;IACrB;;;OAGG;IACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,iDAAiD;IACjD,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C;AAED,iGAAiG;AACjG,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,mBAAmB,CACjB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,6BAA6B,GAAG,SAAS,CAAC,CAAC;IACtD;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/D;;;OAGG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACnE;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,uCAIjC,0BAA0B,KAAG,yBA4I/B,CAAC"}

package/catalog/useSkillItemDetails.js

@@ -22,7 +22,7 @@ var d = ({ api: d, skills: f, skillOverviewLabels: p }) => {
 				}),
 				d.getSkillMetadata(l, u)
 			]), v = h.status === "fulfilled" && h.value != null ? c(h.value) : void 0, y = _.status === "fulfilled" ? _.value : f.find((e) => e.url === i.id), b = g.status === "fulfilled" ? r(y, g.value.items, v?.about, p) : void 0, x = g.status === "fulfilled" ? n(g.value.items, u) : [], S = g.status === "fulfilled" ? s(g.value.items, u) : e;
-			if (!(v == null && b == null)) return {
+			if (v != null || b != null) return {
 				...v == null ? {} : { promptContent: {
 					content: v.body,
 					...v.description == null ? {} : { description: v.description },
@@ -41,8 +41,8 @@ var d = ({ api: d, skills: f, skillOverviewLabels: p }) => {
 			if (t == null) return;
 			let n = o(e, t.path);
 			if (n == null) return;
-			let r = await a(await d.downloadSkillFile(t.bucket, t.path, n));
-			if (r != null) return n === "SKILL.md" ? c(r).body : r;
+			let r = await d.downloadSkillFile(t.bucket, t.path, n), i = await a(r);
+			if (i != null) return n === "SKILL.md" ? c(i).body : i;
 		}, [d]),
 		onLoadSkillDetailsFile: l(async (e) => {
 			let t = m.current;