@epam/ai-dial-chat-hooks 1.3.0-dev.5 → 1.3.0-dev.55

package/usage/useUsageLimitBanner/useUsageLimitBanner.js

@@ -0,0 +1,67 @@
+import { UsagePeriod as e } from "../usage-period.js";
+import { selectUsageBannerSource as t } from "../usage-banner-source.js";
+import { formatUsageResetShort as n } from "../usage-reset-time.js";
+import { useDeploymentUsageLimits as r } from "../useDeploymentUsageLimits/useDeploymentUsageLimits.js";
+import { useRefreshUsageAfterGeneration as i } from "../useRefreshUsageAfterGeneration/useRefreshUsageAfterGeneration.js";
+import { useUsageLimitBannerDismissal as a } from "../useUsageLimitBannerDismissal/useUsageLimitBannerDismissal.js";
+import { useCallback as o, useMemo as s } from "react";
+import { UsageLimitBannerSeverity as c } from "@epam/ai-dial-conversation-input";
+//#region src/usage/useUsageLimitBanner/useUsageLimitBanner.ts
+var l = {
+	warningDay: "conversationInput.usageBanner.warningDay",
+	warningWeek: "conversationInput.usageBanner.warningWeek",
+	warningMonth: "conversationInput.usageBanner.warningMonth",
+	reachedDay: "conversationInput.usageBanner.reachedDay",
+	reachedWeek: "conversationInput.usageBanner.reachedWeek",
+	reachedMonth: "conversationInput.usageBanner.reachedMonth",
+	closeLabel: "conversationInput.usageBanner.closeLabel"
+}, u = {
+	[c.Warning]: {
+		[e.Day]: l.warningDay,
+		[e.Week]: l.warningWeek,
+		[e.Month]: l.warningMonth
+	},
+	[c.Reached]: {
+		[e.Day]: l.reachedDay,
+		[e.Week]: l.reachedWeek,
+		[e.Month]: l.reachedMonth
+	}
+}, d = ({ deploymentId: e, isGenerationInProgress: c = !1, getDeploymentLimits: d, warningThresholdPercent: f, activeLocale: p, t: m }) => {
+	let { limitsDto: h, isLoading: g, refresh: _ } = r(e, d), { isDismissed: v, dismiss: y } = a();
+	i({
+		isGenerationInProgress: c,
+		isLoading: g,
+		refresh: _
+	});
+	let b = s(() => t(h, f), [h, f]), x = s(() => {
+		if (!(b == null || !e)) return {
+			dismissalKey: `${e}:${b.period}:${b.severity}`,
+			limitText: m(u[b.severity][b.period], { percent: b.usedPercent }),
+			reset: n(b.resetsAt, b.period, p, m)
+		};
+	}, [
+		b,
+		e,
+		p,
+		m
+	]), S = x?.dismissalKey, C = o(() => {
+		S != null && y(S);
+	}, [y, S]), w = m(l.closeLabel);
+	return { banner: s(() => {
+		if (!(b == null || x == null || v(x.dismissalKey))) return {
+			severity: b.severity,
+			limitText: x.limitText,
+			reset: x.reset,
+			onClose: C,
+			closeAriaLabel: w
+		};
+	}, [
+		b,
+		x,
+		v,
+		C,
+		w
+	]) };
+};
+//#endregion
+export { l as USAGE_BANNER_I18N_KEYS, d as useUsageLimitBanner };

package/usage/useUsageLimitBannerDismissal/useUsageLimitBannerDismissal.d.ts

@@ -0,0 +1,14 @@
+export interface UseUsageLimitBannerDismissalResult {
+    /** `true` when the banner was dismissed for `key` in this tab. */
+    isDismissed: (key: string) => boolean;
+    /** Records a dismissal for `key`, hiding every banner that shows it. */
+    dismiss: (key: string) => void;
+}
+/**
+ * Tab-lifetime, in-memory record of dismissed usage-banner keys
+ * (`${deploymentId}:${period}:${severity}`), shared by every composer.
+ */
+export declare const useUsageLimitBannerDismissal: () => UseUsageLimitBannerDismissalResult;
+/** Clears every recorded dismissal. Test isolation only. */
+export declare const resetUsageLimitBannerDismissals: () => void;
+//# sourceMappingURL=useUsageLimitBannerDismissal.d.ts.map

package/usage/useUsageLimitBannerDismissal/useUsageLimitBannerDismissal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUsageLimitBannerDismissal.d.ts","sourceRoot":"","sources":["../../../src/usage/useUsageLimitBannerDismissal/useUsageLimitBannerDismissal.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,kCAAkC;IACjD,kEAAkE;IAClE,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,wEAAwE;IACxE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,QACnC,kCAWH,CAAC;AAEJ,4DAA4D;AAC5D,eAAO,MAAM,+BAA+B,QAAO,IAElD,CAAC"}

package/usage/useUsageLimitBannerDismissal/useUsageLimitBannerDismissal.js

@@ -0,0 +1,19 @@
+import { useCallback as e, useSyncExternalStore as t } from "react";
+//#region src/usage/useUsageLimitBannerDismissal/useUsageLimitBannerDismissal.ts
+var n = /* @__PURE__ */ new Set(), r = /* @__PURE__ */ new Set(), i = (e) => {
+	n = e, r.forEach((e) => e());
+}, a = (e) => (r.add(e), () => {
+	r.delete(e);
+}), o = () => n, s = () => {
+	let r = t(a, o, o);
+	return {
+		isDismissed: e((e) => r.has(e), [r]),
+		dismiss: e((e) => {
+			n.has(e) || i(new Set([...n, e]));
+		}, [])
+	};
+}, c = () => {
+	i(/* @__PURE__ */ new Set());
+};
+//#endregion
+export { c as resetUsageLimitBannerDismissals, s as useUsageLimitBannerDismissal };

package/usage-limits.d.ts

@@ -0,0 +1,2 @@
+export * from './entry-points/usage-limits.js'
+export {}

package/usage-limits.js

@@ -0,0 +1,8 @@
+import { UsagePeriod as e } from "./usage/usage-period.js";
+import { isCappedStat as t, selectUsageBannerSource as n } from "./usage/usage-banner-source.js";
+import { USAGE_RESET_I18N_KEYS as r, formatUsageResetShort as i, formatUsageResetTime as a } from "./usage/usage-reset-time.js";
+import { useDeploymentUsageLimits as o } from "./usage/useDeploymentUsageLimits/useDeploymentUsageLimits.js";
+import { useRefreshUsageAfterGeneration as s } from "./usage/useRefreshUsageAfterGeneration/useRefreshUsageAfterGeneration.js";
+import { resetUsageLimitBannerDismissals as c, useUsageLimitBannerDismissal as l } from "./usage/useUsageLimitBannerDismissal/useUsageLimitBannerDismissal.js";
+import { USAGE_BANNER_I18N_KEYS as u, useUsageLimitBanner as d } from "./usage/useUsageLimitBanner/useUsageLimitBanner.js";
+export { u as USAGE_BANNER_I18N_KEYS, r as USAGE_RESET_I18N_KEYS, e as UsagePeriod, i as formatUsageResetShort, a as formatUsageResetTime, t as isCappedStat, c as resetUsageLimitBannerDismissals, n as selectUsageBannerSource, o as useDeploymentUsageLimits, s as useRefreshUsageAfterGeneration, d as useUsageLimitBanner, l as useUsageLimitBannerDismissal };

package/usage.d.ts

@@ -1,125 +1,2 @@
-import { DeploymentItemDto } from '@epam/ai-dial-chat-api-client';
-import { ModelLimitPeriodStatuses } from '@epam/ai-dial-usage-dashboard';
-import { ModelLimitRow } from '@epam/ai-dial-usage-dashboard';
-import { UsageLimitCardData } from '@epam/ai-dial-usage-dashboard';
-import { UserLimitStatsResponseDto } from '@epam/ai-dial-chat-api-client';
-
-/** Formats a raw `resetsAt` into display strings, or returns `undefined` when it cannot be formatted. */
-export declare type FormatResetTime = (resetsAt: string | undefined) => ResetTimeDisplay | undefined;
-
-/**
- * Maps the same top-level Cost budgets used by the aggregate cards into table-header state.
- *
- * @param formatResetTime - Formats each period's top-level `resetsAt` into the header's reset trio. Omit it to produce statuses with no reset fields.
- */
-export declare const mapOverallCostLimitsToPeriodStatuses: (usage: UserLimitStatsResponseDto | undefined, activeLocale: string, t: Translate_2, formatResetTime?: FormatResetTime) => ModelLimitPeriodStatuses;
-
-/**
- * Maps a `UserLimitStatsResponseDto` into `UsageLimitCardGroup`'s `cards` prop,
- * in Today / This week / This month order. A period is omitted entirely when
- * the response carries no usable stat for it. Each card's reset trio comes from
- * `formatResetTime`, and is absent when that callback returns `undefined`.
- */
-export declare const mapUsageDataToDashboard: (usage: UserLimitStatsResponseDto | undefined, t: Translate, formatResetTime: FormatResetTime) => UsageLimitCardData[];
-
-/**
- * Maps `usage.deployments` into `ModelLimitsSection`'s `rows` prop, joined with model or application
- * identity from `deploymentItems`. Rows are included only when any displayed period stat has nonzero
- * usage (Cost stats only, for an application). Order follows `Object.keys(deployments)` —
- * `deploymentItems` is enrichment-only.
- *
- * @param resolveIconUrl - Resolves a deployment's raw `iconUrl` to the URL the avatar should load.
- * @param resolveDisplayName - Resolves a localized-text map or plain string to the display name for `activeLocale`.
- */
-export declare const mapUserUsageToModelLimits: (usage: UserLimitStatsResponseDto | undefined, deploymentItems: DeploymentItemDto[], activeLocale: string, t: Translate_2, resolveIconUrl: ResolveIconUrl, resolveDisplayName: ResolveDisplayName) => ModelLimitRow[];
-
-/**
- * One reset time, already parsed and formatted by the host. Declared
- * structurally here so this library never imports an application type; the
- * host passes a value that satisfies this shape (e.g. `apps/chat`'s own
- * `ResetTimeDisplay`).
- */
-export declare interface ResetTimeDisplay {
-    /** Exclusive end of the period as an epoch ms value, for the host's boundary scheduling. */
-    resetsAtMs: number;
-    /** Machine-readable instant for a `<time dateTime>` attribute. */
-    isoValue: string;
-    /** Visible reset line. */
-    label: string;
-    /** Accessible expansion of the reset line. */
-    ariaLabel: string;
-}
-
-/** A callback that resolves a display name from a localized-text value. */
-declare type ResolveDisplayName = (name: string | Record<string, string> | undefined | null, locale: string) => string;
-
-/** A callback that resolves an icon URL from a deployment's raw `iconUrl` field. */
-declare type ResolveIconUrl = (iconUrl: string | undefined) => string | undefined;
-
-/** A translate function compatible with i18next's `TFunction`. */
-declare type Translate = (key: string, options?: Record<string, unknown>) => string;
-
-/** A translate function compatible with i18next's `TFunction`. */
-declare type Translate_2 = (key: string, options?: Record<string, unknown>) => string;
-
-/**
- * i18n key strings that the consuming app's translation bundle must define for
- * `mapUsageDataToDashboard` to produce correctly translated strings. The
- * values are the default key paths used by AI DIAL Chat.
- */
-export declare const USAGE_DATA_I18N_KEYS: {
-    /** Title for the current-UTC-day card (e.g. `'Today'`). */
-    readonly todayTitle: "usage.todayTitle";
-    /** Accessible period description for the current-UTC-day card. */
-    readonly todayPeriodDescription: "usage.todayPeriodDescription";
-    /** Title for the current-UTC-week card (e.g. `'This week'`). */
-    readonly thisWeekTitle: "usage.thisWeekTitle";
-    /** Accessible period description for the current-UTC-week card. */
-    readonly thisWeekPeriodDescription: "usage.thisWeekPeriodDescription";
-    /** Title for the current-UTC-month card (e.g. `'This month'`). */
-    readonly thisMonthTitle: "usage.thisMonthTitle";
-    /** Accessible period description for the current-UTC-month card. */
-    readonly thisMonthPeriodDescription: "usage.thisMonthPeriodDescription";
-    /** Aria label when there is no limit. Receives `{ used: string }`. */
-    readonly unlimitedProgressAriaLabel: "usage.unlimitedProgressAriaLabel";
-    /** Aria label for a progress bar with a finite limit. Receives `{ used: string, total: string, percent: number }`. */
-    readonly progressAriaLabel: "usage.progressAriaLabel";
-};
-
-/**
- * i18n key strings that the consuming app's translation bundle must define for
- * `mapUserUsageToModelLimits` and `mapOverallCostLimitsToPeriodStatuses` to produce
- * correctly translated strings. The values are the default key paths used by AI DIAL Chat.
- */
-export declare const USAGE_MODEL_LIMITS_I18N_KEYS: {
-    /** Period label used in tooltip text. Receives no interpolation. */
-    readonly todayPeriodDescription: "usage.todayPeriodDescription";
-    /** Period label used in tooltip text. Receives no interpolation. */
-    readonly thisWeekPeriodDescription: "usage.thisWeekPeriodDescription";
-    /** Period label used in tooltip text. Receives no interpolation. */
-    readonly thisMonthPeriodDescription: "usage.thisMonthPeriodDescription";
-    /** Tooltip when the overall cost limit is running low. Receives `{ period: string }`. */
-    readonly overallCostLimitRunningLowTooltip: "usage.overallCostLimitRunningLowTooltip";
-    /** Tooltip when the overall cost limit is reached. Receives `{ period: string }`. */
-    readonly overallCostLimitReachedTooltip: "usage.overallCostLimitReachedTooltip";
-    /** Aria label for a metric cell with no data. */
-    readonly unavailableLabel: "usage.unavailableLabel";
-    /** Supporting label when a token limit follows the cost limit. */
-    readonly followsCostLimitLabel: "usage.followsCostLimitLabel";
-    /** Supporting label when there is no per-deployment token limit. */
-    readonly noLimitLabel: "usage.noLimitLabel";
-    /** Aria label when token usage has no limit but follows the cost limit. Receives `{ used: string }`. */
-    readonly followsCostLimitAriaLabel: "usage.followsCostLimitAriaLabel";
-    /** Aria label when there is no limit. Receives `{ used: string }`. */
-    readonly unlimitedProgressAriaLabel: "usage.unlimitedProgressAriaLabel";
-    /** Aria label for a progress bar with a finite limit. Receives `{ used: string, total: string, percent: number }`. */
-    readonly progressAriaLabel: "usage.progressAriaLabel";
-    /** Label for the spent-cost cell. Receives `{ amount: string }`. */
-    readonly spentLabel: "usage.spentLabel";
-    /** Type caption for an application (agent) row. Receives no interpolation. */
-    readonly applicationTypeLabel: "usage.applicationTypeLabel";
-    /** Supporting label on an application row's spent cost. Receives no interpolation. */
-    readonly includesCalledModelsLabel: "usage.includesCalledModelsLabel";
-};
-
-export { }
+export * from './entry-points/usage.js'
+export {}

package/useChatSettingsFormConfig/useChatSettingsFormConfig.d.ts

@@ -0,0 +1,128 @@
+import { ResponseFormat, Conversation, DeploymentFeatures } from '@epam/ai-dial-chat-shared';
+/** Values emitted by the chat-settings modal when the user clicks Save. */
+export interface ChatSettingsValues {
+    /** Updated response format, present when the response-format field was shown. */
+    responseFormat?: ResponseFormat;
+    /** Updated system prompt, present when the system-prompt field was shown. */
+    systemPrompt?: string;
+    /** Updated temperature, present when the temperature field was shown. */
+    temperature?: number;
+}
+/**
+ * Translatable strings the chat-settings form surfaces. Every field defaults
+ * to an English fallback inside the hook; pass translated values from the
+ * consuming app (e.g. via a `useTranslation`-backed labels hook).
+ */
+export interface ChatSettingsFormLabels {
+    /** Dropdown item label and modal title. */
+    settings: string;
+    /** Toast/message text announced after a successful save. */
+    savedNotification: string;
+    /** Label for the response-format field. */
+    responseFormatLabel: string;
+    /** Helper text shown below the response-format field. */
+    responseFormatHint: string;
+    /** Label for the Markdown radio option. */
+    responseFormatMarkdown: string;
+    /** Label for the plain-text radio option. */
+    responseFormatPlainText: string;
+    /** Label for the system-prompt field. */
+    systemPromptLabel: string;
+    /** Tooltip for the system-prompt field. */
+    systemPromptTooltip: string;
+    /** Label for the temperature field. */
+    temperatureLabel: string;
+    /** Label for the precise end of the temperature slider. */
+    temperaturePrecise: string;
+    /** Label for the neutral midpoint of the temperature slider. */
+    temperatureNeutral: string;
+    /** Label for the creative end of the temperature slider. */
+    temperatureCreative: string;
+    /** Hint text shown below the temperature field. */
+    temperatureHint: string;
+    /** Save button label. */
+    saveLabel: string;
+    /** Tooltip shown on the disabled Save button. */
+    saveDisabledTooltip: string;
+}
+/** Configuration the chat-settings popover/modal consumes. */
+export type UseChatSettingsFormConfigResult = {
+    /** Feature flags controlling which fields appear. */
+    features: {
+        systemPrompt: boolean;
+        temperature: boolean;
+        responseFormat: boolean;
+    };
+    /** Current response format pre-selected in the modal. */
+    responseFormat: ResponseFormat;
+    /** Current system prompt pre-populated in the modal. */
+    systemPrompt: string;
+    /** Current temperature pre-populated in the modal. */
+    temperature: number;
+    /** Called with updated values when the user clicks Save. */
+    onSave: (values: ChatSettingsValues) => void;
+    /** Label for the dropdown menu item. */
+    menuItemLabel: string;
+    /** Modal title. */
+    title: string;
+    /** Label for the response-format field. */
+    responseFormatLabel: string;
+    /** Helper text shown below the response-format field. */
+    responseFormatHint: string;
+    /** Label for the Markdown radio option. */
+    responseFormatMarkdownLabel: string;
+    /** Label for the plain-text radio option. */
+    responseFormatPlainTextLabel: string;
+    /** Label for the system-prompt field. */
+    systemPromptLabel: string;
+    /** Tooltip for the system-prompt field. */
+    systemPromptTooltip: string;
+    /** Label for the temperature field. */
+    temperatureLabel: string;
+    /** Slider endpoint labels, in `[precise, neutral, creative]` order. */
+    temperatureLabels: [string, string, string];
+    /** Hint text shown below the temperature field. */
+    temperatureHint: string;
+    /** Save button label. */
+    saveLabel: string;
+    /** Tooltip shown on the disabled Save button. */
+    saveDisabledTooltip: string;
+};
+interface LocalModeValues {
+    responseFormat: ResponseFormat;
+    systemPrompt: string;
+    temperature: number;
+}
+interface LocalModeParams {
+    mode: 'local';
+    values: LocalModeValues;
+    onValuesChange: (values: LocalModeValues) => void;
+    deploymentFeatures?: DeploymentFeatures;
+    /** True when the selected deployment is a Quick App. Its orchestrator sets its own fixed temperature, so the temperature field is forced off regardless of `deploymentFeatures`. */
+    isQuickApp?: boolean;
+}
+interface ConversationModeParams {
+    mode: 'conversation';
+    conversation: Conversation;
+    onConversationChange: (conversation: Conversation) => void;
+    deploymentFeatures?: DeploymentFeatures;
+    /** True when the conversation's deployment is a Quick App. Its orchestrator sets its own fixed temperature, so the temperature field is forced off regardless of `deploymentFeatures`. */
+    isQuickApp?: boolean;
+}
+type Params = LocalModeParams | ConversationModeParams;
+/** Common, host-injected options shared by both modes. */
+interface Options {
+    /** Translatable labels. Fields not provided fall back to English defaults. */
+    labels?: Partial<ChatSettingsFormLabels>;
+    /** Called after a successful save so the host can surface its own toast/notification. */
+    onSaved?: () => void;
+}
+/**
+ * Assembles the chat-settings form config (feature flags, current values, save
+ * handler, labels) for either an in-flight local composer or a persisted
+ * conversation. Headless: translation and notifications are the host's
+ * responsibility, supplied via `labels` and `onSaved`.
+ */
+export declare const useChatSettingsFormConfig: (params: Params & Options) => UseChatSettingsFormConfigResult;
+export {};
+//# sourceMappingURL=useChatSettingsFormConfig.d.ts.map

package/useChatSettingsFormConfig/useChatSettingsFormConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatSettingsFormConfig.d.ts","sourceRoot":"","sources":["../../src/useChatSettingsFormConfig/useChatSettingsFormConfig.ts"],"names":[],"mappings":"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"}

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,qBA0EF,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 { 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, 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,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,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/useToolsMenu/useToolsMenu.d.ts

@@ -0,0 +1,31 @@
+import { DeploymentConfigurationSchema, ToolMenuItem } from '@epam/ai-dial-chat-shared';
+import { ReactNode } from 'react';
+/** Host-supplied inputs to {@link useToolsMenu}. */
+export interface UseToolsMenuParams {
+    /** Id of the currently selected deployment, or `null` when none is selected. */
+    selectedItemId: string | null;
+    /** JSON-schema configuration for the selected deployment, or `null` when none. */
+    selectedDeploymentConfiguration: DeploymentConfigurationSchema | null;
+    /** Icon element rendered on every tool menu item. Defaults to `null`. */
+    toolIcon?: ReactNode;
+}
+/** Result returned by {@link useToolsMenu}. */
+export type UseToolsMenuResult = {
+    /** One item per boolean property of the deployment configuration schema, in schema order. */
+    toolsMenuItems: ToolMenuItem[];
+    /** Toggles the tool with the given id; ignores unknown ids. */
+    onToolToggle: (id: string) => void;
+    /** Stable record of tool ids to their current on/off state, for completion requests. */
+    toolConfigurationValue: Record<string, boolean>;
+    /** Restores toggle state from a persisted tool configuration record. */
+    restoreToolConfiguration: (configurationValue: Record<string, unknown> | undefined) => void;
+};
+/**
+ * Derives the tools submenu from the active deployment's configuration schema:
+ * every boolean property becomes a toggle. Manages toggle state locally, resets
+ * on deployment change, and exposes a stable `toolConfigurationValue` record for
+ * inclusion in completion requests. Headless: the tool icon is the host's
+ * responsibility, supplied via `toolIcon`.
+ */
+export declare const useToolsMenu: (params: UseToolsMenuParams) => UseToolsMenuResult;
+//# sourceMappingURL=useToolsMenu.d.ts.map

package/useToolsMenu/useToolsMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToolsMenu.d.ts","sourceRoot":"","sources":["../../src/useToolsMenu/useToolsMenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAE7B,YAAY,EACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAEf,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kFAAkF;IAClF,+BAA+B,EAAE,6BAA6B,GAAG,IAAI,CAAC;IACtE,yEAAyE;IACzE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,6FAA6F;IAC7F,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,+DAA+D;IAC/D,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,wFAAwF;IACxF,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,wEAAwE;IACxE,wBAAwB,EAAE,CACxB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KACpD,IAAI,CAAC;CACX,CAAC;AAuCF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,kBAAkB,KACzB,kBAuFF,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"}