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

package/usage/useUsageData/useUsageData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUsageData.d.ts","sourceRoot":"","sources":["../../../src/usage/useUsageData/useUsageData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAG/E,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,8PAA8P;IAC9P,KAAK,EAAE,yBAAyB,GAAG,SAAS,CAAC;IAC7C,wFAAwF;IACxF,SAAS,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,UAAU,EAAE,KAAK,GAAG,SAAS,CAAC;CAC/B;AAKD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY,GACvB,cAAc,MAAM,OAAO,CAAC,yBAAyB,CAAC,EACtD,iBAAc,EACd,qBAAgB,KACf,kBAmCF,CAAC"}

package/usage/useUsageLimitBanner/useUsageLimitBanner.d.ts

@@ -0,0 +1,58 @@
+import { UsageLimitBannerViewProps } from '@epam/ai-dial-conversation-input';
+import { TranslateFn } from '../usage-reset-time';
+import { UsageLimitsApi } from '../useDeploymentUsageLimits/useDeploymentUsageLimits';
+/**
+ * i18n key strings the consuming app's translation bundle must define for
+ * `useUsageLimitBanner` to produce translated strings, in addition to
+ * `USAGE_RESET_I18N_KEYS`. The values are the default key paths used by AI
+ * DIAL Chat.
+ */
+export declare const USAGE_BANNER_I18N_KEYS: {
+    /** Warning sentence for a daily limit. Receives `{ percent: number }`. */
+    readonly warningDay: "conversationInput.usageBanner.warningDay";
+    /** Warning sentence for a weekly limit. Receives `{ percent: number }`. */
+    readonly warningWeek: "conversationInput.usageBanner.warningWeek";
+    /** Warning sentence for a monthly limit. Receives `{ percent: number }`. */
+    readonly warningMonth: "conversationInput.usageBanner.warningMonth";
+    /** Reached sentence for a daily limit. Receives `{ percent: number }`. */
+    readonly reachedDay: "conversationInput.usageBanner.reachedDay";
+    /** Reached sentence for a weekly limit. Receives `{ percent: number }`. */
+    readonly reachedWeek: "conversationInput.usageBanner.reachedWeek";
+    /** Reached sentence for a monthly limit. Receives `{ percent: number }`. */
+    readonly reachedMonth: "conversationInput.usageBanner.reachedMonth";
+    /** Accessible name of the close button. */
+    readonly closeLabel: "conversationInput.usageBanner.closeLabel";
+};
+/** Inputs of {@link useUsageLimitBanner}. */
+export interface UseUsageLimitBannerOptions {
+    /** ID of the currently selected deployment. */
+    deploymentId: string | undefined;
+    /** Whether the selected deployment is currently generating a response. Defaults to `false`. */
+    isGenerationInProgress?: boolean;
+    /** Host-configured call that fetches one deployment's own usage. */
+    getDeploymentUsage: UsageLimitsApi['getDeploymentUsage'];
+    /** Host-configured call that fetches the caller's account usage. */
+    getAccountUsage: UsageLimitsApi['getAccountUsage'];
+    /** Used percentage at or above which a not-yet-exhausted limit raises a warning. */
+    warningThresholdPercent: number;
+    /** Active UI locale, used to format the reset time. */
+    activeLocale: string;
+    /** Translate function compatible with i18next's `TFunction`. */
+    t: TranslateFn;
+}
+/** The part of `UsageLimitBannerViewProps` the hook decides. */
+export type UsageLimitBannerState = Pick<UsageLimitBannerViewProps, 'severity' | 'limitText' | 'reset' | 'onClose' | 'closeAriaLabel'>;
+/** Return shape of {@link useUsageLimitBanner}. */
+export interface UseUsageLimitBannerResult {
+    /** Props for `UsageLimitBannerView`, or `undefined` when no banner should render (no deployment, below the threshold, or dismissed). */
+    banner: UsageLimitBannerState | undefined;
+}
+/**
+ * Everything the composer usage banner needs except its rendering: fetches the
+ * selected deployment's own usage and the account usage, refreshes both after
+ * each generation, picks the limit worth reporting, formats its sentences, and
+ * tracks tab-lifetime dismissal. Spread `banner` onto `UsageLimitBannerView`
+ * from `@epam/ai-dial-conversation-input`.
+ */
+export declare const useUsageLimitBanner: ({ deploymentId, isGenerationInProgress, getDeploymentUsage, getAccountUsage, warningThresholdPercent, activeLocale, t, }: UseUsageLimitBannerOptions) => UseUsageLimitBannerResult;
+//# sourceMappingURL=useUsageLimitBanner.d.ts.map

package/usage/useUsageLimitBanner/useUsageLimitBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUsageLimitBanner.d.ts","sourceRoot":"","sources":["../../../src/usage/useUsageLimitBanner/useUsageLimitBanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,kCAAkC,CAAC;AAI1C,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,sDAAsD,CAAC;AAI9D;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;IACjC,0EAA0E;;IAE1E,2EAA2E;;IAE3E,4EAA4E;;IAE5E,0EAA0E;;IAE1E,2EAA2E;;IAE3E,4EAA4E;;IAE5E,2CAA2C;;CAEnC,CAAC;AAkBX,6CAA6C;AAC7C,MAAM,WAAW,0BAA0B;IACzC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,+FAA+F;IAC/F,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,oEAAoE;IACpE,kBAAkB,EAAE,cAAc,CAAC,oBAAoB,CAAC,CAAC;IACzD,oEAAoE;IACpE,eAAe,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IACnD,oFAAoF;IACpF,uBAAuB,EAAE,MAAM,CAAC;IAChC,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,CAAC,EAAE,WAAW,CAAC;CAChB;AAED,gEAAgE;AAChE,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,yBAAyB,EACzB,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,gBAAgB,CAClE,CAAC;AAEF,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,wIAAwI;IACxI,MAAM,EAAE,qBAAqB,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,0HAQjC,0BAA0B,KAAG,yBAqE/B,CAAC"}

package/usage/useUsageLimitBanner/useUsageLimitBanner.js

@@ -0,0 +1,70 @@
+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, getDeploymentUsage: d, getAccountUsage: f, warningThresholdPercent: p, activeLocale: m, t: h }) => {
+	let g = s(() => ({
+		getDeploymentUsage: d,
+		getAccountUsage: f
+	}), [d, f]), { sources: _, isLoading: v, refresh: y } = r(e, g), { isDismissed: b, dismiss: x } = a();
+	i({
+		isGenerationInProgress: c,
+		isLoading: v,
+		refresh: y
+	});
+	let S = s(() => t(_, p), [_, p]), C = s(() => {
+		if (S != null && e) return {
+			dismissalKey: `${e}:${S.period}:${S.severity}`,
+			limitText: h(u[S.severity][S.period], { percent: S.usedPercent }),
+			reset: n(S.resetsAt, S.period, m, h)
+		};
+	}, [
+		S,
+		e,
+		m,
+		h
+	]), w = C?.dismissalKey, T = o(() => {
+		w != null && x(w);
+	}, [x, w]), E = h(l.closeLabel);
+	return { banner: s(() => {
+		if (!(S == null || C == null || b(C.dismissalKey))) return {
+			severity: S.severity,
+			limitText: C.limitText,
+			reset: C.reset,
+			onClose: T,
+			closeAriaLabel: E
+		};
+	}, [
+		S,
+		C,
+		b,
+		T,
+		E
+	]) };
+};
+//#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(/* @__PURE__ */ 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,9 @@
+import { isCappedStat as e } from "./shared/usage-stat.js";
+import { UsagePeriod as t } from "./usage/usage-period.js";
+import { selectUsageBannerSource as n } from "./usage/usage-banner-source.js";
+import { USAGE_RESET_I18N_KEYS as r, UsageResetOffsetPolicy as i, formatUsageResetShort as a, formatUsageResetTime as o } from "./usage/usage-reset-time.js";
+import { useDeploymentUsageLimits as s } from "./usage/useDeploymentUsageLimits/useDeploymentUsageLimits.js";
+import { useRefreshUsageAfterGeneration as c } from "./usage/useRefreshUsageAfterGeneration/useRefreshUsageAfterGeneration.js";
+import { resetUsageLimitBannerDismissals as l, useUsageLimitBannerDismissal as u } from "./usage/useUsageLimitBannerDismissal/useUsageLimitBannerDismissal.js";
+import { USAGE_BANNER_I18N_KEYS as d, useUsageLimitBanner as f } from "./usage/useUsageLimitBanner/useUsageLimitBanner.js";
+export { d as USAGE_BANNER_I18N_KEYS, r as USAGE_RESET_I18N_KEYS, t as UsagePeriod, i as UsageResetOffsetPolicy, a as formatUsageResetShort, o as formatUsageResetTime, e as isCappedStat, l as resetUsageLimitBannerDismissals, n as selectUsageBannerSource, s as useDeploymentUsageLimits, c as useRefreshUsageAfterGeneration, f as useUsageLimitBanner, u 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,130 @@
+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;
+}
+/** Chat settings a conversation starts with before the user changes any: Markdown, no system prompt, temperature `0.5`. */
+export declare const DEFAULT_CHAT_SETTINGS: Readonly<Required<ChatSettingsValues>>;
+/**
+ * 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/useChatSettingsFormConfig/useChatSettingsFormConfig.js

@@ -2,6 +2,10 @@ import { ResponseFormat as e } from "@epam/ai-dial-chat-shared";
 import { useCallback as t, useMemo as n } from "react";
 //#region src/useChatSettingsFormConfig/useChatSettingsFormConfig.ts
 var r = {
+	responseFormat: e.Markdown,
+	systemPrompt: "",
+	temperature: .5
+}, i = {
 	settings: "Settings",
 	savedNotification: "Chat settings have been saved",
 	responseFormatLabel: "Response format",
@@ -17,11 +21,11 @@ var r = {
 	temperatureHint: "Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic.",
 	saveLabel: "Apply changes",
 	saveDisabledTooltip: "Please select a response format"
-}, i = (t) => (t ?? "").toLowerCase().replace(/[^a-z]/g, "") === "plaintext" ? e.PlainText : e.Markdown, a = (e) => {
-	let a = n(() => ({
-		...r,
+}, a = (t) => (t ?? "").toLowerCase().replace(/[^a-z]/g, "") === "plaintext" ? e.PlainText : e.Markdown, o = (e) => {
+	let r = n(() => ({
+		...i,
 		...e.labels
-	}), [e.labels]), { onSaved: o } = e, s = e.mode === "local" ? e.values.responseFormat : i(e.conversation.responseFormat), c = e.mode === "local" ? e.values.systemPrompt : e.conversation.prompt ?? "", l = e.mode === "local" ? e.values.temperature : e.conversation.temperature ?? .5, u = t((t) => {
+	}), [e.labels]), { onSaved: o } = e, s = e.mode === "local" ? e.values.responseFormat : a(e.conversation.responseFormat), c = e.mode === "local" ? e.values.systemPrompt : e.conversation.prompt ?? "", l = e.mode === "local" ? e.values.temperature : e.conversation.temperature ?? .5, u = t((t) => {
 		e.mode === "local" ? e.onValuesChange({
 			responseFormat: t.responseFormat ?? e.values.responseFormat,
 			systemPrompt: t.systemPrompt ?? e.values.systemPrompt,
@@ -43,32 +47,32 @@ var r = {
 		systemPrompt: c,
 		temperature: l,
 		onSave: u,
-		menuItemLabel: a.settings,
-		title: a.settings,
-		responseFormatLabel: a.responseFormatLabel,
-		responseFormatHint: a.responseFormatHint,
-		responseFormatMarkdownLabel: a.responseFormatMarkdown,
-		responseFormatPlainTextLabel: a.responseFormatPlainText,
-		systemPromptLabel: a.systemPromptLabel,
-		systemPromptTooltip: a.systemPromptTooltip,
-		temperatureLabel: a.temperatureLabel,
+		menuItemLabel: r.settings,
+		title: r.settings,
+		responseFormatLabel: r.responseFormatLabel,
+		responseFormatHint: r.responseFormatHint,
+		responseFormatMarkdownLabel: r.responseFormatMarkdown,
+		responseFormatPlainTextLabel: r.responseFormatPlainText,
+		systemPromptLabel: r.systemPromptLabel,
+		systemPromptTooltip: r.systemPromptTooltip,
+		temperatureLabel: r.temperatureLabel,
 		temperatureLabels: [
-			a.temperaturePrecise,
-			a.temperatureNeutral,
-			a.temperatureCreative
+			r.temperaturePrecise,
+			r.temperatureNeutral,
+			r.temperatureCreative
 		],
-		temperatureHint: a.temperatureHint,
-		saveLabel: a.saveLabel,
-		saveDisabledTooltip: a.saveDisabledTooltip
+		temperatureHint: r.temperatureHint,
+		saveLabel: r.saveLabel,
+		saveDisabledTooltip: r.saveDisabledTooltip
 	}), [
 		u,
 		d,
 		f,
-		a,
+		r,
 		s,
 		c,
 		l
 	]);
 };
 //#endregion
-export { a as useChatSettingsFormConfig };
+export { r as DEFAULT_CHAT_SETTINGS, o as useChatSettingsFormConfig };

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/usePageFileDrag/usePageFileDrag.js

@@ -10,13 +10,13 @@ var a = (a = !0, o = !0) => {
 	}, [l]);
 	return t(() => {
 		let e = (e) => !!e.dataTransfer?.types.includes("Files"), t = (t) => {
-			!p.current || !e(t) || (d.current += 1, c(!0));
+			p.current && e(t) && (d.current += 1, c(!0));
 		}, n = (t) => {
-			!p.current || !e(t) || (--d.current, d.current <= 0 && (d.current = 0, c(!1)));
+			p.current && e(t) && (--d.current, d.current <= 0 && (d.current = 0, c(!1)));
 		}, r = (t) => {
 			e(t) && (t.preventDefault(), p.current);
 		}, i = (t) => {
-			if (!(!e(t) || !p.current) && (t.preventDefault(), d.current = 0, c(!1), f.current)) {
+			if (e(t) && p.current && (t.preventDefault(), d.current = 0, c(!1), f.current)) {
 				let e = Array.from(t.dataTransfer?.files ?? []);
 				e.length > 0 && u((t) => [...t, ...e]);
 			}

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,kBAyDF,CAAC"}

package/useShareLink/useShareLink.js

@@ -17,6 +17,7 @@ var o = (e) => e.map((e) => e === i.Edit ? a.Edit : a.View), s = (e, t) => {
 			g.current === t && d({
 				url: s(n.url, l),
 				expiresInDays: n.expiresInDays,
+				expiresInHours: n.expiresInHours,
 				access: o(n.access)
 			});
 		} catch (e) {