@epam/ai-dial-chat-hooks 1.3.0-dev.28 → 1.3.0-dev.288

package/shared/locale.d.ts

@@ -0,0 +1,45 @@
+import { LocaleTextEntryDto } from '@epam/ai-dial-chat-api-client';
+import { LocaleOption, LocalizedTextEntry } from '@epam/ai-dial-chat-shared';
+/** Lowercased base language of a BCP-47 tag, e.g. `'en-US'` -> `'en'`. */
+export declare const toBaseLocale: (locale: string) => string;
+/**
+ * DIAL Core's shape for a user-facing text field: either a plain string (no
+ * localized variants — displayed identically for every locale) or a map of
+ * locale code to translated value.
+ */
+export type LocalizedText = string | Record<string, string>;
+/**
+ * Resolves a `LocalizedText` value to a single display string for
+ * `activeLocale`: exact locale match, then base-language match, then
+ * `primaryLocale`, then the first defined value in the map, then `''`. A
+ * plain string is returned unchanged — it has no locale variants.
+ */
+export declare const resolveLocalizedText: (value: LocalizedText | undefined | null, activeLocale: string, primaryLocale: string) => string;
+/** Appends a locale's uppercased code to a field label, e.g. `'Name [EN]'`. */
+export declare const appendLocaleCode: (label: string, locale: string) => string;
+/**
+ * Composes the "Add locale" popup's entries into the write-payload shape:
+ * strips the popup's client-only `id`, drops rows with no `language`, drops
+ * rows with neither `name` nor `description`, drops rows colliding with
+ * `primaryLocale` (that content belongs in the primary field, not here), and
+ * dedupes by `language` (last row for a given language wins). Returns
+ * `undefined` (not `[]`) when nothing remains, so a request untouched by
+ * this feature stays byte-identical to today.
+ */
+export declare const composeLocalePayload: (otherLocales: LocalizedTextEntry[], primaryLocale: string) => LocaleTextEntryDto[] | undefined;
+/**
+ * Inverse of {@link composeLocalePayload}: builds the popup's `otherLocales`
+ * entries from a `displayName`/`description` pair as read from DIAL Core.
+ * A plain string on both (or both absent) means no additional locales exist
+ * yet, so this returns `[]`. Otherwise one entry is built per locale key
+ * present in either map, excluding `primaryLocale` — that key is already the
+ * primary Name/Description field, not a row in the popup.
+ */
+export declare const decomposeLocalizedFields: (displayName: LocalizedText | undefined, description: LocalizedText | undefined, primaryLocale: string) => LocalizedTextEntry[];
+/**
+ * Selectable additional-locale options for a locale-picker popup, drawn from
+ * `additionalLocaleCodes` and excluding whichever code is already the
+ * primary Name/Description field.
+ */
+export declare const buildAdditionalLocaleOptions: (additionalLocaleCodes: string[], primaryLocale: string) => LocaleOption[];
+//# sourceMappingURL=locale.d.ts.map

package/shared/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/shared/locale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAEnC,0EAA0E;AAC1E,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,KAAG,MACV,CAAC;AAErC;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,aAAa,GAAG,SAAS,GAAG,IAAI,EACvC,cAAc,MAAM,EACpB,eAAe,MAAM,KACpB,MAWF,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,MACb,CAAC;AAErD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAC/B,cAAc,kBAAkB,EAAE,EAClC,eAAe,MAAM,KACpB,kBAAkB,EAAE,GAAG,SAczB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GACnC,aAAa,aAAa,GAAG,SAAS,EACtC,aAAa,aAAa,GAAG,SAAS,EACtC,eAAe,MAAM,KACpB,kBAAkB,EAgBpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GACvC,uBAAuB,MAAM,EAAE,EAC/B,eAAe,MAAM,KACpB,YAAY,EAG0C,CAAC"}

package/shared/locale.js

@@ -6,14 +6,14 @@ var e = (e) => e.split("-")[0].toLowerCase(), t = (t, n, r) => {
 	return t[n] ?? t[i] ?? t[r] ?? Object.values(t).find((e) => e !== void 0) ?? "";
 }, n = (t, n) => `${t} [${e(n).toUpperCase()}]`, r = (e, t) => {
 	let n = /* @__PURE__ */ new Map();
-	for (let r of e) !r.language || r.language === t || !r.name && !r.description || n.set(r.language, {
+	for (let r of e) r.language && r.language !== t && (r.name || r.description) && n.set(r.language, {
 		language: r.language,
 		name: r.name || void 0,
 		description: r.description || void 0
 	});
 	return n.size > 0 ? Array.from(n.values()) : void 0;
 }, i = (e, t, n) => {
-	let r = typeof e == "object" ? e : {}, i = typeof t == "object" ? t : {}, a = new Set([...Object.keys(r), ...Object.keys(i)]);
+	let r = typeof e == "object" ? e : {}, i = typeof t == "object" ? t : {}, a = /* @__PURE__ */ new Set([...Object.keys(r), ...Object.keys(i)]);
 	a.delete(n);
 	let o = 0;
 	return Array.from(a, (e) => ({

package/shared/read-sse-events.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Reads a newline-delimited SSE stream, JSON-decoding each `data:` line and
+ * passing it to `onEvent`. Stops reading — and always releases the reader —
+ * as soon as `onEvent` returns `true`, when the stream ends, or when
+ * `reader.read()` rejects (a network error, or the caller aborting the
+ * stream's own `AbortSignal`, e.g. on timeout). Malformed lines and
+ * non-`data:` lines (comments, keepalives) are skipped silently.
+ */
+export declare const readSseEvents: <TEvent>(stream: ReadableStream<Uint8Array>, onEvent: (event: TEvent) => Promise<boolean> | boolean) => Promise<void>;
+//# sourceMappingURL=read-sse-events.d.ts.map

package/shared/read-sse-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-sse-events.d.ts","sourceRoot":"","sources":["../../src/shared/read-sse-events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAU,MAAM,EACxC,QAAQ,cAAc,CAAC,UAAU,CAAC,EAClC,SAAS,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,KACrD,OAAO,CAAC,IAAI,CAyCd,CAAC"}

package/shared/read-sse-events.js

@@ -0,0 +1,33 @@
+//#region src/shared/read-sse-events.ts
+var e = async (e, t) => {
+	let n = e.getReader(), r = new TextDecoder(), i = "";
+	try {
+		for (;;) {
+			let { done: e, value: a } = await n.read();
+			if (e) break;
+			i += r.decode(a, { stream: !0 });
+			let o = i.split("\n");
+			i = o.pop() ?? "";
+			let s = !1;
+			for (let e of o) {
+				let n = e.trim();
+				if (!n.startsWith("data:")) continue;
+				let r = n.slice(5).trim(), i;
+				try {
+					i = JSON.parse(r);
+				} catch {
+					continue;
+				}
+				if (await t(i)) {
+					s = !0;
+					break;
+				}
+			}
+			if (s) break;
+		}
+	} catch {} finally {
+		n.releaseLock();
+	}
+};
+//#endregion
+export { e as readSseEvents };

package/shared/serialized-writer.d.ts

@@ -0,0 +1,10 @@
+/** A write queue that runs one write at a time, in call order, and never queues a key twice. */
+export interface SerializedKeyedWriter {
+    /** Queues a write for `key`, or joins the one already queued; settles when that write ran or was dropped. */
+    enqueue: (key: string) => Promise<void>;
+    /** Drops the write queued for `key` if it has not started; its promise resolves without writing. */
+    drop: (key: string) => void;
+}
+/** Returns a {@link SerializedKeyedWriter} over `write`; a failed write rejects only its own callers. */
+export declare const createSerializedKeyedWriter: (write: (key: string) => Promise<void>) => SerializedKeyedWriter;
+//# sourceMappingURL=serialized-writer.d.ts.map

package/shared/serialized-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialized-writer.d.ts","sourceRoot":"","sources":["../../src/shared/serialized-writer.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,WAAW,qBAAqB;IACpC,6GAA6G;IAC7G,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,oGAAoG;IACpG,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAQD,yGAAyG;AACzG,eAAO,MAAM,2BAA2B,GACtC,OAAO,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,KACpC,qBAuCF,CAAC"}

package/shared/serialized-writer.js

@@ -0,0 +1,35 @@
+//#region src/shared/serialized-writer.ts
+var e = (e) => {
+	let t = /* @__PURE__ */ new Map(), n = Promise.resolve();
+	return {
+		enqueue: (r) => {
+			let i = t.get(r);
+			if (i) return i.promise;
+			let a, o, s = new Promise((e, t) => {
+				a = e, o = t;
+			}), c = {
+				promise: s,
+				resolve: a,
+				reject: o
+			};
+			t.set(r, c);
+			let l = n;
+			return n = (async () => {
+				if (await l, t.get(r) !== c) c.resolve();
+				else {
+					t.delete(r);
+					try {
+						await e(r), c.resolve();
+					} catch (e) {
+						c.reject(e);
+					}
+				}
+			})(), s;
+		},
+		drop: (e) => {
+			t.delete(e);
+		}
+	};
+};
+//#endregion
+export { e as createSerializedKeyedWriter };

package/shared/string-utils.d.ts

@@ -0,0 +1,11 @@
+/** Case-insensitive substring match. */
+export declare const includesIgnoreCase: (str: string, query: string) => boolean;
+/** Decodes a URI-encoded path segment, returning the original string if decoding fails. */
+export declare const safeDecodeURI: (path: string) => string;
+/** Alias of {@link safeDecodeURI} for call sites decoding a URI component rather than a path. */
+export declare const safeDecodeURIComponent: (path: string) => string;
+/** Strips trailing slashes from a path segment. */
+export declare const stripTrailingSlashes: (path: string) => string;
+/** Strips leading and trailing slashes from a path segment. */
+export declare const stripSurroundingSlashes: (path: string) => string;
+//# sourceMappingURL=string-utils.d.ts.map

package/shared/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/shared/string-utils.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,OACf,CAAC;AAElD,2FAA2F;AAC3F,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAM5C,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,SATC,MAAM,KAAG,MASM,CAAC;AAUpD,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,MAInD,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,MAMtD,CAAC"}

package/shared/theme-colors.d.ts

@@ -0,0 +1,16 @@
+/** Colour scheme the operating system reports through `prefers-color-scheme`. */
+export declare enum ColorScheme {
+    /** The OS asks for a dark scheme. */
+    Dark = "dark",
+    /** The OS asks for a light scheme, or states no preference. */
+    Light = "light"
+}
+/** Returns the colour scheme the OS currently prefers. */
+export declare const getOsPreferredTheme: () => ColorScheme;
+/**
+ * Writes `colors` to `element` as `--<key>` custom properties after removing
+ * the ones the previous call wrote to that element. Without `colors` it only
+ * removes them; properties it never wrote are left alone.
+ */
+export declare const applyThemeColors: (element: HTMLElement, colors?: Readonly<Record<string, string>>) => void;
+//# sourceMappingURL=theme-colors.d.ts.map

package/shared/theme-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-colors.d.ts","sourceRoot":"","sources":["../../src/shared/theme-colors.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,oBAAY,WAAW;IACrB,qCAAqC;IACrC,IAAI,SAAS;IACb,+DAA+D;IAC/D,KAAK,UAAU;CAChB;AAED,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,QAAO,WAGhB,CAAC;AAWxB;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,WAAW,EACpB,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KACxC,IAkBF,CAAC"}

package/shared/theme-colors.js

@@ -0,0 +1,14 @@
+//#region src/shared/theme-colors.ts
+var e = /* @__PURE__ */ function(e) {
+	return e.Dark = "dark", e.Light = "light", e;
+}({}), t = () => window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light", n = /* @__PURE__ */ new WeakMap(), r = (e, t) => {
+	let r = n.get(e);
+	if (r && (r.forEach((t) => e.style.removeProperty(t)), n.delete(e)), !t) return;
+	let i = Object.entries(t).map(([t, n]) => {
+		let r = `--${t}`;
+		return e.style.setProperty(r, n), r;
+	});
+	i.length > 0 && n.set(e, i);
+};
+//#endregion
+export { e as ColorScheme, r as applyThemeColors, t as getOsPreferredTheme };

package/shared/toolset-login-events.d.ts

@@ -0,0 +1,15 @@
+/** Detail payload for a successful toolset login, generic over the app's own credentials-level type. */
+export interface ToolsetLoginSuccessDetail<T> {
+    /** Already-encoded toolset id/url, as passed into `useToolsetLogin`'s `login`. */
+    toolsetId: string;
+    credentialsLevel: T;
+}
+/**
+ * Broadcasts a successful toolset login to any listener within the current
+ * window — host-to-host, not `postMessage`, since this notifies other React
+ * trees in the same document (e.g. a mounted `AppEditorIframe`), not an
+ * embedded cross-origin iframe.
+ */
+export declare const emitToolsetLoginSuccess: <T>(detail: ToolsetLoginSuccessDetail<T>) => void;
+export declare const subscribeToolsetLoginSuccess: <T>(listener: (detail: ToolsetLoginSuccessDetail<T>) => void) => (() => void);
+//# sourceMappingURL=toolset-login-events.d.ts.map

package/shared/toolset-login-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolset-login-events.d.ts","sourceRoot":"","sources":["../../src/shared/toolset-login-events.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,CAAC,CAAC;CACrB;AAMD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,CAAC,EACvC,QAAQ,yBAAyB,CAAC,CAAC,CAAC,KACnC,IAMF,CAAC;AAMF,eAAO,MAAM,4BAA4B,GAAI,CAAC,EAC5C,UAAU,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,CAAC,KAAK,IAAI,KACvD,CAAC,MAAM,IAAI,CAcb,CAAC"}

package/shared/usage-stat.d.ts

@@ -0,0 +1,3 @@
+/** `true` when `total` is a real cap: finite, positive, and below DIAL Core's unlimited sentinel. */
+export declare const isCappedStat: (total: number) => boolean;
+//# sourceMappingURL=usage-stat.d.ts.map

package/shared/usage-stat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-stat.d.ts","sourceRoot":"","sources":["../../src/shared/usage-stat.ts"],"names":[],"mappings":"AAMA,qGAAqG;AACrG,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OAC4B,CAAC"}

package/shared/usage-stat.js

@@ -0,0 +1,4 @@
+//#region src/shared/usage-stat.ts
+var e = 2 ** 53 - 1, t = (t) => Number.isFinite(t) && t > 0 && t < e;
+//#endregion
+export { t as isCappedStat };

package/shared/usePersistedState/usePersistedState.d.ts

@@ -0,0 +1,28 @@
+/** Host storage operations; a nullish read means no stored value. */
+export interface PersistedStateStorage<TStored> {
+    /** Reads a host-owned key. */
+    read: (key: string) => TStored | null | undefined;
+    /** Writes a host-owned key. */
+    write: (key: string, value: TStored) => void;
+}
+/** Host serialization policy. */
+export interface PersistedStateCodec<T, TStored> {
+    /** Converts storage data into state. */
+    decode: (value: TStored) => T;
+    /** Converts state into storage data. */
+    encode: (value: T) => TStored;
+}
+/** Inputs for mount-initialized persisted state. */
+export interface UsePersistedStateOptions<T, TStored> {
+    /** Host-owned storage key. */
+    key: string;
+    /** Fallback when reading or decoding fails. */
+    initialValue: T;
+    /** Host storage implementation. */
+    storage: PersistedStateStorage<TStored>;
+    /** Host serialization implementation. */
+    codec: PersistedStateCodec<T, TStored>;
+}
+/** Initializes once from storage and preserves in-memory updates when persistence fails. */
+export declare const usePersistedState: <T, TStored>({ key, initialValue, storage, codec, }: UsePersistedStateOptions<T, TStored>) => [T, (value: T) => void];
+//# sourceMappingURL=usePersistedState.d.ts.map

package/shared/usePersistedState/usePersistedState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePersistedState.d.ts","sourceRoot":"","sources":["../../../src/shared/usePersistedState/usePersistedState.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,MAAM,WAAW,qBAAqB,CAAC,OAAO;IAC5C,8BAA8B;IAC9B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IAClD,+BAA+B;IAC/B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC9C;AACD,iCAAiC;AACjC,MAAM,WAAW,mBAAmB,CAAC,CAAC,EAAE,OAAO;IAC7C,wCAAwC;IACxC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,CAAC;IAC9B,wCAAwC;IACxC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;CAC/B;AACD,oDAAoD;AACpD,MAAM,WAAW,wBAAwB,CAAC,CAAC,EAAE,OAAO;IAClD,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,YAAY,EAAE,CAAC,CAAC;IAChB,mCAAmC;IACnC,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACxC,yCAAyC;IACzC,KAAK,EAAE,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;CACxC;AACD,4FAA4F;AAC5F,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAAE,OAAO,EAAE,wCAK3C,wBAAwB,CAAC,CAAC,EAAE,OAAO,CAAC,KAAG,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAuB/D,CAAC"}

package/shared/usePersistedState/usePersistedState.js

@@ -0,0 +1,24 @@
+import { useCallback as e, useState as t } from "react";
+//#region src/shared/usePersistedState/usePersistedState.ts
+var n = ({ key: n, initialValue: r, storage: i, codec: a }) => {
+	let [o, s] = t(() => {
+		try {
+			let e = i.read(n);
+			return e == null ? r : a.decode(e);
+		} catch {
+			return r;
+		}
+	}), c = i.write, l = a.encode;
+	return [o, e((e) => {
+		s(e);
+		try {
+			c(n, l(e));
+		} catch {}
+	}, [
+		n,
+		c,
+		l
+	])];
+};
+//#endregion
+export { n as usePersistedState };

package/sharing.d.ts

@@ -1,65 +1,2 @@
-import { ShareApi } from '@epam/ai-dial-chat-api-client';
-import { ShareLinkAccess } from '@epam/ai-dial-share';
-import { ShareLinkData } from '@epam/ai-dial-share';
-
-/** State of one resource's recipient-count lookup. */
-export declare 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;
-}
-
-/** 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"
-}
-
-/**
- * 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, origin?: string) => UseShareLinkResult;
-
-/** Result returned by {@link useShareLink}. */
-export declare 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 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;
-
-/** Per-resource recipient-count lookups resolved on demand. */
-export declare 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;
-}
-
-export { }
+export * from './entry-points/sharing.js'
+export {}

package/skill/skill-archive.d.ts

@@ -0,0 +1,7 @@
+import { SkillFileSourceEntry } from '@epam/ai-dial-skill-editor';
+/**
+ * Expands a `.zip` into one entry per file, with `/`-separated paths as stored
+ * in the archive; rejects when the input is not a readable zip.
+ */
+export declare const extractSkillArchive: (archive: File) => Promise<SkillFileSourceEntry[]>;
+//# sourceMappingURL=skill-archive.d.ts.map

package/skill/skill-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-archive.d.ts","sourceRoot":"","sources":["../../src/skill/skill-archive.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AA2BvE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,SAAS,IAAI,KACZ,OAAO,CAAC,oBAAoB,EAAE,CAmBhC,CAAC"}

package/skill/skill-file-batch-validation.d.ts

@@ -0,0 +1,74 @@
+import { SkillFileBatchError, SkillFileUploadCandidate, SkillFileValidationResult } from '@epam/ai-dial-skill-editor';
+/** A recognized, structurally valid manifest candidate from a staged batch. */
+export interface SkillManifestImportCandidate {
+    /** The `SkillFileUploadCandidate.id` this manifest came from. */
+    candidateId: string;
+    /** The imported manifest's `name` field. */
+    name: string;
+    /** The imported manifest's `description` field. */
+    description: string;
+    /** The imported manifest's full parsed frontmatter, including unknown fields. */
+    frontmatter: Record<string, unknown>;
+    /** The imported manifest's instructions body. */
+    instructions: string;
+}
+/** Localized messages the batch validator needs, resolved by the caller. */
+export interface SkillFileBatchValidationMessages {
+    /** Shown when a required field (e.g. a candidate's path) is empty. */
+    required: string;
+    /** Shown when a candidate's path collides with a reserved entry name. */
+    pathReserved: string;
+    /** Shown when a candidate's path fails DIAL's relative-path rules. */
+    pathInvalid: string;
+    /** Shown when a candidate's path duplicates another candidate or an existing file. */
+    pathDuplicate: string;
+    /** Shown when a candidate exceeds the per-file size limit; receives the formatted limit. */
+    fileTooLarge: (maxSize: string) => string;
+    /** Shown when a root-level `SKILL.md`-like path has the wrong casing. */
+    manifestCasingInvalid: string;
+    /** Shown when the batch stages more than one root `SKILL.md`. */
+    manifestDuplicate: string;
+    /** Shown when a root `SKILL.md`'s bytes are not valid UTF-8. */
+    manifestInvalidUtf8: string;
+    /** Shown when a root `SKILL.md`'s frontmatter is missing or missing `name`/`description`. */
+    manifestInvalidFrontmatter: string;
+    /** Shown when the batch's projected total package size exceeds the limit. */
+    totalSizeExceeded: string;
+    /** Shown when the batch's projected total file count exceeds the limit. */
+    totalCountExceeded: string;
+}
+/** Snapshot of editor state the batch validator projects new totals against. */
+export interface SkillFileBatchValidationContext {
+    /** Paths already present in the editor's supporting-file tree. */
+    existingPaths: string[];
+    /** Sum of the bytes already held for existing supporting files. */
+    existingTotalBytes: number;
+    /** Bytes held for each existing supporting file, keyed by path; a replacing upload frees its target's share. Defaults to none. */
+    existingFileBytes?: ReadonlyMap<string, number>;
+    /** Paths of the folders in the tree; a file can never take one over, so a candidate at such a path is a duplicate. Defaults to none. */
+    existingFolderPaths?: string[];
+    /** UTF-8 byte length of the currently generated/loaded root `SKILL.md`. */
+    manifestByteLength: number;
+    /** Localized messages. */
+    messages: SkillFileBatchValidationMessages;
+}
+/** Result of validating a whole staged batch. */
+export interface SkillFileBatchValidationOutcome {
+    /** One result per candidate, in the same order as the input. */
+    results: SkillFileValidationResult[];
+    /** Batch-level errors (projected total size/count, multiple manifests). */
+    batchErrors: SkillFileBatchError[];
+    /** The single accepted manifest import, when the batch has exactly one valid `SKILL.md`. */
+    manifestCandidate?: SkillManifestImportCandidate;
+}
+/**
+ * Validates a whole staged upload batch against per-file limits, path
+ * safety, in-batch/against-existing duplicates, and projected total
+ * size/count — mirroring the BFF's authoritative `SkillsPackageService`
+ * limits for immediate feedback (the server remains the final gate). Reads
+ * each candidate's bytes only where required (the root `SKILL.md` manifest,
+ * to decode and parse its frontmatter) — never for an ordinary supporting
+ * file, whose size is checked via `File.size` alone.
+ */
+export declare const validateSkillFileBatch: (candidates: SkillFileUploadCandidate[], context: SkillFileBatchValidationContext) => Promise<SkillFileBatchValidationOutcome>;
+//# sourceMappingURL=skill-file-batch-validation.d.ts.map

package/skill/skill-file-batch-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-file-batch-validation.d.ts","sourceRoot":"","sources":["../../src/skill/skill-file-batch-validation.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,4BAA4B,CAAC;AAUpC,+EAA+E;AAC/E,MAAM,WAAW,4BAA4B;IAC3C,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,4EAA4E;AAC5E,MAAM,WAAW,gCAAgC;IAC/C,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,aAAa,EAAE,MAAM,CAAC;IACtB,4FAA4F;IAC5F,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1C,yEAAyE;IACzE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6FAA6F;IAC7F,0BAA0B,EAAE,MAAM,CAAC;IACnC,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,gFAAgF;AAChF,MAAM,WAAW,+BAA+B;IAC9C,kEAAkE;IAClE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mEAAmE;IACnE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kIAAkI;IAClI,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,wIAAwI;IACxI,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0BAA0B;IAC1B,QAAQ,EAAE,gCAAgC,CAAC;CAC5C;AAED,iDAAiD;AACjD,MAAM,WAAW,+BAA+B;IAC9C,gEAAgE;IAChE,OAAO,EAAE,yBAAyB,EAAE,CAAC;IACrC,2EAA2E;IAC3E,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,4FAA4F;IAC5F,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;CAClD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GACjC,YAAY,wBAAwB,EAAE,EACtC,SAAS,+BAA+B,KACvC,OAAO,CAAC,+BAA+B,CAgJzC,CAAC"}

package/skill/skill-file-batch-validation.js

@@ -3,45 +3,46 @@ import { formatFileSize as r } from "@epam/ai-dial-chat-shared";
 import { SkillFileCandidateKind as i, SkillFileValidationStatus as a } from "@epam/ai-dial-skill-editor";
 //#region src/skill/skill-file-batch-validation.ts
 var o = async (o, s) => {
-	let { existingPaths: c, existingTotalBytes: l, manifestByteLength: u, messages: d } = s, f = [], p = [], m = new Set(c), h = /* @__PURE__ */ new Map();
-	for (let { path: e } of o) e !== "SKILL.md" && h.set(e, (h.get(e) ?? 0) + 1);
-	let g = 0, _ = /* @__PURE__ */ new Set(), v, y = u, b = 0;
+	let { existingPaths: c, existingTotalBytes: l, existingFileBytes: u, existingFolderPaths: d, manifestByteLength: f, messages: p } = s, m = [], h = [], g = new Set(c), _ = new Set(d), v = /* @__PURE__ */ new Map();
+	for (let { path: e } of o) e !== "SKILL.md" && v.set(e, (v.get(e) ?? 0) + 1);
+	let y = 0, b = 0, x = /* @__PURE__ */ new Set(), S, C = f, w = 0;
 	for (let s of o) {
-		let { id: o, file: c, path: l } = s, u, p = i.SupportingFile;
-		if (l.toLowerCase() === "skill.md" && l !== "SKILL.md") u = d.manifestCasingInvalid;
-		else if (l === "SKILL.md") if (p = i.Manifest, b += 1, c.size > 1048576) u = d.fileTooLarge(r(e));
-		else try {
-			let e = await c.text();
-			if (e.includes("�")) u = d.manifestInvalidUtf8;
-			else {
-				let { frontmatter: t, instructions: r } = n(e), i = typeof t.name == "string" ? t.name : "", a = typeof t.description == "string" ? t.description : "";
-				!i.trim() || !a.trim() ? u = d.manifestInvalidFrontmatter : b === 1 && (v = {
-					candidateId: o,
-					name: i,
-					description: a,
-					frontmatter: t,
-					instructions: r
-				}, y = c.size);
+		let { id: o, file: c, path: l } = s, d = s.replacesExisting === !0 && g.has(l), f, h = i.SupportingFile;
+		if (l.toLowerCase() === "skill.md" && l !== "SKILL.md") f = p.manifestCasingInvalid;
+		else if (l === "SKILL.md") {
+			if (h = i.Manifest, w += 1, c.size > 1048576) f = p.fileTooLarge(r(e));
+			else try {
+				let e = await c.text();
+				if (e.includes("�")) f = p.manifestInvalidUtf8;
+				else {
+					let { frontmatter: t, instructions: r } = n(e), i = typeof t.name == "string" ? t.name : "", a = typeof t.description == "string" ? t.description : "";
+					!i.trim() || !a.trim() ? f = p.manifestInvalidFrontmatter : w === 1 && (S = {
+						candidateId: o,
+						name: i,
+						description: a,
+						frontmatter: t,
+						instructions: r
+					}, C = c.size);
+				}
+			} catch {
+				f = p.manifestInvalidFrontmatter;
 			}
-		} catch {
-			u = d.manifestInvalidFrontmatter;
-		}
-		else l ? t(l) ? m.has(l) || (h.get(l) ?? 0) > 1 ? u = d.pathDuplicate : c.size > 1048576 && (u = d.fileTooLarge(r(e))) : u = d.pathInvalid : u = d.required;
-		!u && p === i.SupportingFile && (_.add(l), g += c.size), f.push({
+		} else l ? t(l) ? g.has(l) && !d || _.has(l) || (v.get(l) ?? 0) > 1 ? f = p.pathDuplicate : c.size > 1048576 && (f = p.fileTooLarge(r(e))) : f = p.pathInvalid : f = p.required;
+		!f && h === i.SupportingFile && (x.add(l), y += c.size, d && (b += u?.get(l) ?? 0)), m.push({
 			candidateId: o,
-			status: u ? a.Invalid : a.Valid,
-			kind: p,
-			error: u
+			status: f ? a.Invalid : a.Valid,
+			kind: h,
+			error: f
 		});
 	}
-	if (b > 1) {
-		p.push({ message: d.manifestDuplicate }), v = void 0, y = u;
-		for (let e of f) e.kind === i.Manifest && !e.error && (e.status = a.Invalid, e.error = d.manifestDuplicate);
+	if (w > 1) {
+		h.push({ message: p.manifestDuplicate }), S = void 0, C = f;
+		for (let e of m) e.kind === i.Manifest && !e.error && (e.status = a.Invalid, e.error = p.manifestDuplicate);
 	}
-	return l + g + y > 16777216 && p.push({ message: d.totalSizeExceeded }), m.size + _.size + 1 > 100 && p.push({ message: d.totalCountExceeded }), {
-		results: f,
-		batchErrors: p,
-		manifestCandidate: v
+	return l - b + y + C > 16777216 && h.push({ message: p.totalSizeExceeded }), (/* @__PURE__ */ new Set([...g, ...x])).size + 1 > 100 && h.push({ message: p.totalCountExceeded }), {
+		results: m,
+		batchErrors: h,
+		manifestCandidate: S
 	};
 };
 //#endregion

package/skill/skill-file-preview.d.ts

@@ -0,0 +1,25 @@
+import { Attachment } from '@epam/ai-dial-chat-shared';
+import { SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
+/**
+ * In-memory bytes for a Skill supporting file, plus its MIME type when known
+ * (e.g. from a browser upload's `File.type`).
+ */
+export interface SkillFileContent {
+    /** The file's raw bytes. */
+    bytes: Uint8Array;
+    /**
+     * MIME type from the original browser `File.type`. Omit for edit-mode ZIP
+     * entries, which carry no MIME metadata — the type is then inferred from
+     * the file's path.
+     */
+    mimeType?: string;
+}
+/**
+ * Converts a Skill supporting file's in-memory bytes into the `Attachment`
+ * shape the chat attachment-canvas pipeline expects, so it can be previewed
+ * with `useOpenAttachmentCanvas` exactly like a chat attachment. The id is
+ * the file's full relative path (not its basename), so two files with the
+ * same name in different folders never collide.
+ */
+export declare const skillFileToAttachment: (node: SkillFileTreeNode, content: SkillFileContent) => Attachment;
+//# sourceMappingURL=skill-file-preview.d.ts.map

package/skill/skill-file-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-file-preview.d.ts","sourceRoot":"","sources":["../../src/skill/skill-file-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAM5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,iBAAiB,EACvB,SAAS,gBAAgB,KACxB,UAiBF,CAAC"}

package/skill/skill-lookup.d.ts

@@ -0,0 +1,20 @@
+import { SkillMetadataItemDto } from '@epam/ai-dial-chat-api-client';
+/** Skill listings a URL is looked up in, as a host's skills state exposes them. */
+export interface SkillListingPools {
+    /** Skills the user owns. */
+    skills: SkillMetadataItemDto[];
+    /** Skills shared with the user. */
+    sharedWithMe?: SkillMetadataItemDto[];
+    /** Organisation-published skills. */
+    publicSkills?: SkillMetadataItemDto[];
+}
+/**
+ * Finds the listed skill a resource URL names, across the personal, shared and
+ * organisation listings. Both sides are compared per-segment normalized, so a
+ * URL that arrives decoded (e.g. read from a query string) still matches the
+ * percent-encoded `url` DIAL Core lists.
+ * @param pools - the skill listings to search
+ * @param url - `skills/{bucket}/{path}` resource URL, encoded or decoded
+ */
+export declare const findSkillByUrl: ({ skills, sharedWithMe, publicSkills }: SkillListingPools, url: string) => SkillMetadataItemDto | undefined;
+//# sourceMappingURL=skill-lookup.d.ts.map

package/skill/skill-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-lookup.d.ts","sourceRoot":"","sources":["../../src/skill/skill-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAG1E,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,mCAAmC;IACnC,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,qCAAqC;IACrC,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,wCAAwC,iBAAiB,EACzD,KAAK,MAAM,KACV,oBAAoB,GAAG,SAKzB,CAAC"}

package/skill/skill-lookup.js

@@ -0,0 +1,12 @@
+import { normalizeDeploymentId as e } from "../catalog/deployment-id.js";
+//#region src/skill/skill-lookup.ts
+var t = ({ skills: t, sharedWithMe: n, publicSkills: r }, i) => {
+	let a = e(i);
+	return [
+		...t,
+		...n ?? [],
+		...r ?? []
+	].find((t) => e(t.url) === a);
+};
+//#endregion
+export { t as findSkillByUrl };