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

package/skills-state.d.ts

@@ -1,40 +1,2 @@
-import { SkillCatalogListResponseDto } from '@epam/ai-dial-chat-api-client';
-import { SkillMetadataItemDto } from '@epam/ai-dial-chat-api-client';
-
-/**
- * Fetches all skill namespaces with a gated single request: clears state
- * immediately when `enabled` is false, defers the fetch until `ready` is true,
- * and exposes `refetch` / `mergeSharedSkill` for manual updates.
- * Does not import any feature-flag hook, auth enum, or app context.
- */
-export declare const useSkillsState: ({ listSkills, enabled, ready, }: UseSkillsStateParams) => UseSkillsStateResult;
-
-/** Parameters for {@link useSkillsState}. */
-export declare interface UseSkillsStateParams {
-    /** Fetches the aggregate skill listing from the server. */
-    listSkills: () => Promise<SkillCatalogListResponseDto>;
-    /** Whether the Skills feature is enabled in the current overlay/tenant config. */
-    enabled: boolean;
-    /** Whether the user session is ready for API calls (auth has settled). */
-    ready: boolean;
-}
-
-/** Result returned by {@link useSkillsState}. */
-export declare interface UseSkillsStateResult {
-    /** Skills in the caller's own bucket. */
-    skills: SkillMetadataItemDto[];
-    /** Skills in the organisation bucket. */
-    publicSkills: SkillMetadataItemDto[];
-    /** Skills other users shared with the caller. */
-    sharedWithMe: SkillMetadataItemDto[];
-    /** True until the aggregate listing has settled. */
-    isLoading: boolean;
-    /** Rejection reason of the most recent failed listing, or `null`. */
-    error: unknown;
-    /** Re-reads personal, shared, and organisation skills. */
-    refetch: () => Promise<void>;
-    /** Upserts a single skill into the shared-with-me list by URL identity. */
-    mergeSharedSkill: (item: SkillMetadataItemDto) => void;
-}
-
-export { }
+export * from './entry-points/skills-state.js'
+export {}

package/source-content.d.ts

@@ -1,29 +1,2 @@
-/**
- * Returns the last path segment of `url` — its file name — for both absolute
- * URLs and DIAL-relative resource paths such as
- * `files/<bucket>/qa-routed-source.html`. Any query string or hash is dropped
- * and percent escapes are decoded. Returns an empty string when no segment can
- * be extracted. Used to classify a resource by extension when its display name
- * is a citation title rather than a file name.
- */
-export declare const getUrlFileName: (url: string) => string;
-
-/** Returns true when an external (non-DIAL) source URL should be opened in the canvas rather than a new browser tab. */
-export declare const isExternalSourcePreviewable: (contentType: string, url: string) => boolean;
-
-/**
- * Returns the content type to trust for an external citation source: `contentType`
- * unchanged when it is already an image/audio/PDF/document-renderer marker,
- * otherwise the type implied by `url`'s path extension (`application/pdf` for
- * `.pdf`, the canonical MIME for `.docx`/`.xlsx`/`.pptx`/`.csv`) when that
- * extension is recognized, otherwise `contentType` unchanged.
- *
- * Web-search grounding APIs label every reference — PDFs and Office documents
- * included — as `text/markdown`, so a mislabeled `contentType` must not win
- * over a recognized URL extension: doing so previously sent a PDF's raw bytes
- * into the markdown/text canvas viewer, rendering garbled text instead of
- * opening the PDF/OOXML viewer.
- */
-export declare const resolveExternalSourceContentType: (contentType: string, url: string) => string;
-
-export { }
+export * from './entry-points/source-content.js'
+export {}

package/usage/map-usage-data-to-dashboard.d.ts

@@ -0,0 +1,39 @@
+import { UserLimitStatsResponseDto } from '@epam/ai-dial-chat-api-client';
+import { UsageLimitCardData } from '@epam/ai-dial-usage-dashboard';
+import { ResetTimeDisplay } from './usage-reset-time';
+/** A translate function compatible with i18next's `TFunction`. */
+type Translate = (key: string, options?: Record<string, unknown>) => string;
+/** Formats a raw `resetsAt` into display strings, or returns `undefined` when it cannot be formatted. */
+export type FormatResetTime = (resetsAt: string | undefined) => ResetTimeDisplay | undefined;
+/**
+ * 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";
+};
+/**
+ * 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[];
+export {};
+//# sourceMappingURL=map-usage-data-to-dashboard.d.ts.map

package/usage/map-usage-data-to-dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-usage-data-to-dashboard.d.ts","sourceRoot":"","sources":["../../src/usage/map-usage-data-to-dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,kEAAkE;AAClE,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;AAE5E,yGAAyG;AACzG,MAAM,MAAM,eAAe,GAAG,CAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,KACzB,gBAAgB,GAAG,SAAS,CAAC;AAElC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;IAC/B,2DAA2D;;IAE3D,kEAAkE;;IAElE,gEAAgE;;IAEhE,mEAAmE;;IAEnE,kEAAkE;;IAElE,oEAAoE;;IAEpE,sEAAsE;;IAEtE,sHAAsH;;CAE9G,CAAC;AA8FX;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,yBAAyB,GAAG,SAAS,EAC5C,GAAG,SAAS,EACZ,iBAAiB,eAAe,KAC/B,kBAAkB,EAoCpB,CAAC"}

package/usage/map-user-usage-to-model-limits.d.ts

@@ -0,0 +1,62 @@
+import { DeploymentItemDto, UserLimitStatsResponseDto } from '@epam/ai-dial-chat-api-client';
+import { ModelLimitPeriodStatuses, ModelLimitRow } from '@epam/ai-dial-usage-dashboard';
+import { FormatResetTime } from './map-usage-data-to-dashboard';
+export type { FormatResetTime } from './map-usage-data-to-dashboard';
+/** A translate function compatible with i18next's `TFunction`. */
+type Translate = (key: string, options?: Record<string, unknown>) => string;
+/** A callback that resolves an icon URL from a deployment's raw `iconUrl` field. */
+type ResolveIconUrl = (iconUrl: string | undefined) => string | undefined;
+/** A callback that resolves a display name from a localized-text value. */
+type ResolveDisplayName = (name: string | Record<string, string> | undefined | null, locale: string) => string;
+/**
+ * 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";
+};
+/**
+ * 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, formatResetTime?: FormatResetTime) => ModelLimitPeriodStatuses;
+/**
+ * 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, resolveIconUrl: ResolveIconUrl, resolveDisplayName: ResolveDisplayName) => ModelLimitRow[];
+//# sourceMappingURL=map-user-usage-to-model-limits.d.ts.map

package/usage/map-user-usage-to-model-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-user-usage-to-model-limits.d.ts","sourceRoot":"","sources":["../../src/usage/map-user-usage-to-model-limits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAGjB,yBAAyB,EAC1B,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAIV,wBAAwB,EACxB,aAAa,EACd,MAAM,+BAA+B,CAAC;AAMvC,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,kEAAkE;AAClE,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;AAE5E,oFAAoF;AACpF,KAAK,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC;AAE1E,2EAA2E;AAC3E,KAAK,kBAAkB,GAAG,CACxB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,IAAI,EACxD,MAAM,EAAE,MAAM,KACX,MAAM,CAAC;AAmBZ;;;;GAIG;AACH,eAAO,MAAM,4BAA4B;IACvC,oEAAoE;;IAEpE,oEAAoE;;IAEpE,oEAAoE;;IAEpE,yFAAyF;;IAEzF,qFAAqF;;IAErF,iDAAiD;;IAEjD,kEAAkE;;IAElE,oEAAoE;;IAEpE,wGAAwG;;IAExG,sEAAsE;;IAEtE,sHAAsH;;IAEtH,oEAAoE;;IAEpE,8EAA8E;;IAE9E,sFAAsF;;CAE9E,CAAC;AA6HX;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,GAC/C,OAAO,yBAAyB,GAAG,SAAS,EAC5C,cAAc,MAAM,EACpB,GAAG,SAAS,EACZ,kBAAiB,eAA6B,KAC7C,wBAsBD,CAAC;AAkMH;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,yBAAyB,GAAG,SAAS,EAC5C,iBAAiB,iBAAiB,EAAE,EACpC,cAAc,MAAM,EACpB,GAAG,SAAS,EACZ,gBAAgB,cAAc,EAC9B,oBAAoB,kBAAkB,KACrC,aAAa,EAgIf,CAAC"}

package/usage/usage-banner-source.d.ts

@@ -0,0 +1,23 @@
+import { DeploymentLimitsResponseDto } from '@epam/ai-dial-chat-api-client';
+import { UsageLimitBannerSeverity } from '@epam/ai-dial-conversation-input';
+import { UsagePeriod } from './usage-period';
+/** The day/week/month usage stat the composer banner reports on, and how close it is to its limit. */
+export interface UsageBannerSource {
+    /** Calendar period of the stat. */
+    period: UsagePeriod;
+    /** `Reached` at or above 100%, otherwise `Warning`. */
+    severity: UsageLimitBannerSeverity;
+    /** Consumed share of the stat's limit, rounded and clamped to 0–100. */
+    usedPercent: number;
+    /** DIAL Core's `resetsAt` for the stat, when it sent one. */
+    resetsAt: string | undefined;
+}
+/** `true` when `total` is a real cap: finite, positive, and below DIAL Core's unlimited sentinel. */
+export declare const isCappedStat: (total: number) => boolean;
+/**
+ * Returns the capped day/week/month token or cost stat with the highest
+ * used/total ratio, classified against `thresholdPercent`, or `undefined` when
+ * no stat is capped or the worst one is below the threshold.
+ */
+export declare const selectUsageBannerSource: (dto: DeploymentLimitsResponseDto | undefined, thresholdPercent: number) => UsageBannerSource | undefined;
+//# sourceMappingURL=usage-banner-source.d.ts.map

package/usage/usage-banner-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-banner-source.d.ts","sourceRoot":"","sources":["../../src/usage/usage-banner-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAE5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,sGAAsG;AACtG,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,uDAAuD;IACvD,QAAQ,EAAE,wBAAwB,CAAC;IACnC,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAQD,qGAAqG;AACrG,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OAC4B,CAAC;AA8B1E;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,KAAK,2BAA2B,GAAG,SAAS,EAC5C,kBAAkB,MAAM,KACvB,iBAAiB,GAAG,SAoCtB,CAAC"}

package/usage/usage-banner-source.js

@@ -0,0 +1,36 @@
+import { UsagePeriod as e } from "./usage-period.js";
+import { UsageLimitBannerSeverity as t } from "@epam/ai-dial-conversation-input";
+//#region src/usage/usage-banner-source.ts
+var n = 2 ** 53 - 1, r = (e) => Number.isFinite(e) && e > 0 && e < n, i = [
+	["monthTokenStats", e.Month],
+	["monthCostStats", e.Month],
+	["weekTokenStats", e.Week],
+	["weekCostStats", e.Week],
+	["dayTokenStats", e.Day],
+	["dayCostStats", e.Day]
+], a = (e, n) => {
+	let a;
+	for (let [t, n] of i) {
+		let i = e?.[t];
+		if (i == null || !r(i.total)) continue;
+		let o = Math.max(i.used, 0) / i.total;
+		(a == null || o > a.ratio) && (a = {
+			stat: i,
+			period: n,
+			ratio: o
+		});
+	}
+	if (a == null) return;
+	let o = Math.min(100, Math.round(a.ratio * 100)), s;
+	if (a.ratio >= 1) s = t.Reached;
+	else if (o >= n) s = t.Warning;
+	else return;
+	return {
+		period: a.period,
+		severity: s,
+		usedPercent: o,
+		resetsAt: a.stat.resetsAt
+	};
+};
+//#endregion
+export { r as isCappedStat, a as selectUsageBannerSource };

package/usage/usage-period.d.ts

@@ -0,0 +1,7 @@
+/** A calendar usage period the composer usage banner can report on. */
+export declare enum UsagePeriod {
+    Day = "day",
+    Week = "week",
+    Month = "month"
+}
+//# sourceMappingURL=usage-period.d.ts.map

package/usage/usage-period.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-period.d.ts","sourceRoot":"","sources":["../../src/usage/usage-period.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,oBAAY,WAAW;IACrB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,KAAK,UAAU;CAChB"}

package/usage/usage-period.js

@@ -0,0 +1,6 @@
+//#region src/usage/usage-period.ts
+var e = /* @__PURE__ */ function(e) {
+	return e.Day = "day", e.Week = "week", e.Month = "month", e;
+}({});
+//#endregion
+export { e as UsagePeriod };

package/usage/usage-reset-time.d.ts

@@ -0,0 +1,69 @@
+import { UsagePeriod } from './usage-period';
+/**
+ * i18n key strings the consuming app's translation bundle must define for the
+ * reset-time formatters to produce translated strings. The values are the
+ * default key paths used by AI DIAL Chat.
+ */
+export declare const USAGE_RESET_I18N_KEYS: {
+    /** Visible label for a full reset time. Receives `{ dateTime: string }`. */
+    readonly resetsAtLabel: "usage.resetsAtLabel";
+    /** Spoken label for a full reset time. Receives `{ dateTime: string }`. */
+    readonly resetsAtAriaLabel: "usage.resetsAtAriaLabel";
+    /** Short daily reset sentence. Receives `{ time: string }`. */
+    readonly resetsAtTime: "conversationInput.usageBanner.resetsAtTime";
+    /** Short weekly/monthly reset sentence. Receives `{ date: string }`. */
+    readonly resetsOnDate: "conversationInput.usageBanner.resetsOnDate";
+};
+/**
+ * A DIAL Core `resetsAt` instant, normalized into the preformatted strings the
+ * usage dashboard renders. Every `Date` and `Intl` call for reset times lives
+ * in this module: the display components receive only these strings
+ * and never sees a raw timestamp, a locale, or a timezone.
+ */
+export interface ResetTimeDisplay {
+    /** Exclusive end of the period, as an epoch ms value, for boundary scheduling. */
+    resetsAtMs: number;
+    /** Machine-readable instant for a `<time dateTime>` attribute, e.g. '2026-09-16T00:00:00Z'. */
+    isoValue: string;
+    /** Visible label, e.g. 'Resets 16 Sept 2026, 03:00 GMT+3'. */
+    label: string;
+    /** Accessible expansion naming the timezone in full, e.g. 'Usage resets Sep 16, 2026 at 2:00 AM Central European Summer Time'. */
+    ariaLabel: string;
+}
+/** A translate function compatible with i18next's `TFunction`. */
+export type TranslateFn = (key: string, options?: Record<string, unknown>) => string;
+/**
+ * Formats DIAL Core's `resetsAt` for display in the viewer's locale and
+ * timezone, always stating the zone so a UTC boundary shown in local time is
+ * never ambiguous.
+ *
+ * Returns `undefined` on every failure path — an absent, empty, or
+ * unparseable value, or an `Intl` implementation that throws (embedded and
+ * restricted runtimes expose incomplete ones, which is why the resolution is
+ * wrapped, matching `getBrowserTimezone` in `@epam/ai-dial-chat-hooks`). A
+ * reset time is decoration on a usage figure and never a gate on it, so the
+ * caller renders the rest of the card unchanged when this returns nothing.
+ *
+ * The boundary is never derived from the browser's own calendar — no local
+ * midnight, no start-of-week, no arithmetic on `new Date()`.
+ */
+export declare const formatUsageResetTime: (resetsAt: string | undefined, activeLocale: string, t: TranslateFn) => ResetTimeDisplay | undefined;
+/** A `resetsAt` instant as the one-sentence reset notice the composer usage banner renders. */
+export interface ShortResetTimeDisplay {
+    /** Machine-readable instant for a `<time dateTime>` attribute, e.g. '2026-10-13T00:00:00Z'. */
+    isoValue: string;
+    /** Visible sentence, e.g. 'Resets at 3:00 AM GMT+3.' or 'Resets on Oct 19.'. */
+    label: string;
+    /** Accessible expansion with the full date, time and zone name, from `formatUsageResetTime`. */
+    ariaLabel: string;
+}
+/**
+ * Formats DIAL Core's `resetsAt` as the banner's reset sentence: a time with
+ * its zone offset for a daily period, a short date (with the year only when it
+ * is not the current one) for a weekly or monthly period.
+ *
+ * Returns `undefined` on the same failure paths as `formatUsageResetTime`,
+ * whose spoken form it reuses, so the caller renders the period sentence alone.
+ */
+export declare const formatUsageResetShort: (resetsAt: string | undefined, period: UsagePeriod, activeLocale: string, t: TranslateFn) => ShortResetTimeDisplay | undefined;
+//# sourceMappingURL=usage-reset-time.d.ts.map

package/usage/usage-reset-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-reset-time.d.ts","sourceRoot":"","sources":["../../src/usage/usage-reset-time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;IAChC,4EAA4E;;IAE5E,2EAA2E;;IAE3E,+DAA+D;;IAE/D,wEAAwE;;CAEhE,CAAC;AAEX;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,+FAA+F;IAC/F,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,kIAAkI;IAClI,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG,CACxB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,MAAM,CAAC;AAEZ;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,MAAM,GAAG,SAAS,EAC5B,cAAc,MAAM,EACpB,GAAG,WAAW,KACb,gBAAgB,GAAG,SA+DrB,CAAC;AAEF,+FAA+F;AAC/F,MAAM,WAAW,qBAAqB;IACpC,+FAA+F;IAC/F,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,UAAU,MAAM,GAAG,SAAS,EAC5B,QAAQ,WAAW,EACnB,cAAc,MAAM,EACpB,GAAG,WAAW,KACb,qBAAqB,GAAG,SAiD1B,CAAC"}

package/usage/usage-reset-time.js

@@ -0,0 +1,72 @@
+import { UsagePeriod as e } from "./usage-period.js";
+//#region src/usage/usage-reset-time.ts
+var t = {
+	resetsAtLabel: "usage.resetsAtLabel",
+	resetsAtAriaLabel: "usage.resetsAtAriaLabel",
+	resetsAtTime: "conversationInput.usageBanner.resetsAtTime",
+	resetsOnDate: "conversationInput.usageBanner.resetsOnDate"
+}, n = (e, n, r) => {
+	if (!e) return;
+	let i = Date.parse(e);
+	if (!Number.isNaN(i)) try {
+		let a = Intl.DateTimeFormat().resolvedOptions().timeZone, o = new Date(i), s = a ? { timeZone: a } : {}, c = {
+			year: "numeric",
+			month: "short",
+			day: "numeric",
+			hour: "numeric",
+			minute: "2-digit"
+		}, l = new Intl.DateTimeFormat(n, {
+			...c,
+			timeZoneName: "shortOffset",
+			...s
+		}).format(o), u = new Intl.DateTimeFormat(n, {
+			...c,
+			timeZoneName: "long",
+			...s
+		}).format(o);
+		return {
+			resetsAtMs: i,
+			isoValue: e,
+			label: r(t.resetsAtLabel, { dateTime: l }),
+			ariaLabel: r(t.resetsAtAriaLabel, { dateTime: u })
+		};
+	} catch {
+		return;
+	}
+}, r = (r, i, a, o) => {
+	let s = n(r, a, o);
+	if (s != null) try {
+		let n = Intl.DateTimeFormat().resolvedOptions().timeZone, r = n ? { timeZone: n } : {}, c = new Date(s.resetsAtMs);
+		if (i === e.Day) {
+			let e = new Intl.DateTimeFormat(a, {
+				hour: "numeric",
+				minute: "2-digit",
+				timeZoneName: "shortOffset",
+				...r
+			}).format(c);
+			return {
+				isoValue: s.isoValue,
+				label: o(t.resetsAtTime, { time: e }),
+				ariaLabel: s.ariaLabel
+			};
+		}
+		let l = new Intl.DateTimeFormat("en-US", {
+			year: "numeric",
+			...r
+		}), u = l.format(c) !== l.format(/* @__PURE__ */ new Date()), d = new Intl.DateTimeFormat(a, {
+			month: "short",
+			day: "numeric",
+			...u ? { year: "numeric" } : {},
+			...r
+		}).format(c);
+		return {
+			isoValue: s.isoValue,
+			label: o(t.resetsOnDate, { date: d }),
+			ariaLabel: s.ariaLabel
+		};
+	} catch {
+		return;
+	}
+};
+//#endregion
+export { t as USAGE_RESET_I18N_KEYS, r as formatUsageResetShort, n as formatUsageResetTime };

package/usage/useDeploymentUsageLimits/useDeploymentUsageLimits.d.ts

@@ -0,0 +1,32 @@
+import { DeploymentLimitsResponseDto } from '@epam/ai-dial-chat-api-client';
+/** Host-configured call that fetches the limits of one deployment. */
+export type GetDeploymentLimits = (deploymentId: string) => Promise<DeploymentLimitsResponseDto>;
+/** Return shape of {@link useDeploymentUsageLimits}. */
+export interface UseDeploymentUsageLimitsResult {
+    /** Raw limits response for the selected deployment, or `undefined` before the first success. */
+    limitsDto: DeploymentLimitsResponseDto | undefined;
+    /** `true` while a fetch is in flight. */
+    isLoading: boolean;
+    /** `true` after the most recent fetch rejected. */
+    hasError: boolean;
+    /** Re-fetches the current deployment when no request is in flight. */
+    refresh: () => void;
+}
+/**
+ * Fetches the selected deployment's usage limits via the provided
+ * `getDeploymentLimits` function. The hook accepts the fetch function as a
+ * parameter so the caller supplies an already-configured API client — the hook
+ * never constructs or imports one itself. The function's identity is not a
+ * re-fetch trigger; only `deploymentId` and `refresh()` are.
+ *
+ * A monotonic request ID prevents a slower response for a previous deployment
+ * from replacing the current value. Refresh failures preserve the last known
+ * response so the open popover can surface a non-blocking error.
+ *
+ * The raw response is returned rather than a mapped display model: mapping
+ * needs the caller's translated labels and locale-bound reset formatter, and
+ * holding the mapped value in state here would leave it stale after a language
+ * change until the next fetch.
+ */
+export declare const useDeploymentUsageLimits: (deploymentId: string | undefined, getDeploymentLimits: GetDeploymentLimits) => UseDeploymentUsageLimitsResult;
+//# sourceMappingURL=useDeploymentUsageLimits.d.ts.map

package/usage/useDeploymentUsageLimits/useDeploymentUsageLimits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeploymentUsageLimits.d.ts","sourceRoot":"","sources":["../../../src/usage/useDeploymentUsageLimits/useDeploymentUsageLimits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAGjF,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,CAChC,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC,2BAA2B,CAAC,CAAC;AAE1C,wDAAwD;AACxD,MAAM,WAAW,8BAA8B;IAC7C,gGAAgG;IAChG,SAAS,EAAE,2BAA2B,GAAG,SAAS,CAAC;IACnD,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,QAAQ,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,wBAAwB,GACnC,cAAc,MAAM,GAAG,SAAS,EAChC,qBAAqB,mBAAmB,KACvC,8BAgEF,CAAC"}

package/usage/useDeploymentUsageLimits/useDeploymentUsageLimits.js

@@ -0,0 +1,39 @@
+import { useCallback as e, useEffect as t, useRef as n, useState as r } from "react";
+//#region src/usage/useDeploymentUsageLimits/useDeploymentUsageLimits.ts
+var i = (i, a) => {
+	let [o, s] = r(), [c, l] = r(!1), [u, d] = r(!1), [f, p] = r(0), m = n(0), h = n(!1), g = n(void 0), _ = n(a);
+	_.current = a;
+	let v = e(() => {
+		h.current || p((e) => e + 1);
+	}, []);
+	return t(() => {
+		let e = g.current !== i;
+		if (g.current = i, !i) {
+			m.current += 1, s(void 0), l(!1), d(!1), h.current = !1;
+			return;
+		}
+		e && s(void 0);
+		let t = ++m.current, n = !1;
+		return l(!0), d(!1), h.current = !0, (async () => {
+			try {
+				let e = await _.current(i);
+				if (n || t !== m.current) return;
+				s(e);
+			} catch {
+				if (n || t !== m.current) return;
+				d(!0);
+			} finally {
+				!n && t === m.current && (l(!1), h.current = !1);
+			}
+		})(), () => {
+			n = !0;
+		};
+	}, [i, f]), {
+		limitsDto: o,
+		isLoading: c,
+		hasError: u,
+		refresh: v
+	};
+};
+//#endregion
+export { i as useDeploymentUsageLimits };

package/usage/useRefreshUsageAfterGeneration/useRefreshUsageAfterGeneration.d.ts

@@ -0,0 +1,16 @@
+export interface UseRefreshUsageAfterGenerationOptions {
+    /** Whether the selected deployment is currently generating a response. */
+    isGenerationInProgress: boolean;
+    /** `true` while the usage fetch is in flight; a pending refresh waits for it. */
+    isLoading: boolean;
+    /** Re-fetches the usage limits. */
+    refresh: () => void;
+}
+/**
+ * Refreshes usage limits once after a response finishes streaming
+ * (`isGenerationInProgress` `true` → `false`), deferring the refresh while a
+ * fetch is still in flight. Shared by the usage dial and the usage banner so
+ * the two cannot drift.
+ */
+export declare const useRefreshUsageAfterGeneration: ({ isGenerationInProgress, isLoading, refresh, }: UseRefreshUsageAfterGenerationOptions) => void;
+//# sourceMappingURL=useRefreshUsageAfterGeneration.d.ts.map

package/usage/useRefreshUsageAfterGeneration/useRefreshUsageAfterGeneration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRefreshUsageAfterGeneration.d.ts","sourceRoot":"","sources":["../../../src/usage/useRefreshUsageAfterGeneration/useRefreshUsageAfterGeneration.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qCAAqC;IACpD,0EAA0E;IAC1E,sBAAsB,EAAE,OAAO,CAAC;IAChC,iFAAiF;IACjF,SAAS,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,GAAI,iDAI5C,qCAAqC,KAAG,IAe1C,CAAC"}

package/usage/useRefreshUsageAfterGeneration/useRefreshUsageAfterGeneration.js

@@ -0,0 +1,14 @@
+import { useEffect as e, useRef as t } from "react";
+//#region src/usage/useRefreshUsageAfterGeneration/useRefreshUsageAfterGeneration.ts
+var n = ({ isGenerationInProgress: n, isLoading: r, refresh: i }) => {
+	let a = t(n), o = t(!1);
+	e(() => {
+		a.current && !n && (o.current = !0), a.current = n, o.current && !r && (o.current = !1, i());
+	}, [
+		n,
+		r,
+		i
+	]);
+};
+//#endregion
+export { n as useRefreshUsageAfterGeneration };

package/usage/useUsageData/useUsageData.d.ts

@@ -0,0 +1,28 @@
+import { UserLimitStatsResponseDto } from '@epam/ai-dial-chat-api-client';
+/** Return shape of {@link useUsageData}. */
+export interface UseUsageDataResult {
+    /** Calendar-period usage and rate-limit stats for every deployment the caller has used in the current UTC day, week, and month, plus the caller's global cost budget. Retained across a `refreshToken`-triggered re-fetch until the new response resolves. */
+    usage: UserLimitStatsResponseDto | undefined;
+    /** `true` while a fetch is in flight, including a `refreshToken`-triggered re-fetch. */
+    isLoading: boolean;
+    /** Set when the `getUserUsage` call rejects. */
+    usageError: Error | undefined;
+}
+/**
+ * Fetches usage stats via the provided `getUserUsage` function on mount, and
+ * again whenever `refreshToken` changes.
+ *
+ * `enabled` (default `true`) lets callers behind a feature flag skip the fetch
+ * entirely. The hook accepts the fetch function as a parameter so the caller
+ * supplies an already-configured API client — the hook never constructs or
+ * imports one itself.
+ *
+ * `refreshToken` (default `0`) is a caller-driven re-fetch trigger, subject to
+ * the same `enabled` gate. The hook owns no timer and reads no clock: the
+ * caller decides when to change the token. A previously resolved `usage` value
+ * is retained while a token-triggered re-fetch is in flight, so the consumer
+ * can keep rendering the last known figures and suppress a full-page loading
+ * state for a refresh.
+ */
+export declare const useUsageData: (getUserUsage: () => Promise<UserLimitStatsResponseDto>, enabled?: boolean, refreshToken?: number) => UseUsageDataResult;
+//# sourceMappingURL=useUsageData.d.ts.map

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,56 @@
+import { UsageLimitBannerViewProps } from '@epam/ai-dial-conversation-input';
+import { TranslateFn } from '../usage-reset-time';
+import { GetDeploymentLimits } 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 limits. */
+    getDeploymentLimits: GetDeploymentLimits;
+    /** 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 limits, refreshes them 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, getDeploymentLimits, 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,mBAAmB,EAEzB,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,iEAAiE;IACjE,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,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,0GAOjC,0BAA0B,KAAG,yBAiE/B,CAAC"}