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

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/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"}

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

@@ -5,13 +5,13 @@ import { includesIgnoreCase as o, safeDecodeURI as s, safeDecodeURIComponent as
 import { appendLocaleCode as d, buildAdditionalLocaleOptions as f, composeLocalePayload as p, decomposeLocalizedFields as m, resolveLocalizedText as h, toBaseLocale as g } from "./shared/locale.js";
 import { formatCalendarDate as _, padTwoDigits as v } from "./shared/formatting.js";
 import { PromptSource as y, parsePromptResourceUrl as b } from "./prompt/prompt-resource.js";
-import { getRunnerSchemas as x, isCustomAppSchema as S, isQuickAppSchema as C } from "./shared/application-schema.js";
-import { buildPromptExportEnvelope as w, buildPromptExportFileName as T, serializePromptExport as E } from "./prompt/export-prompt.js";
-import { PROMPT_CONTENT_MAX_LENGTH as D, PROMPT_COUNTER_ANNOUNCE_THRESHOLD as O, PROMPT_DESCRIPTION_MAX_LENGTH as k, PROMPT_NAME_MAX_LENGTH as A, PromptFieldError as j, buildPromptPath as M, getRemainingCharacters as N, validatePromptContent as P, validatePromptDescription as F, validatePromptName as I } from "./prompt/prompt.js";
-import { usePromptsState as L } from "./prompt/usePromptsState/usePromptsState.js";
-import { apSchedulerDayToJsDay as R, jsDayToApSchedulerDay as z } from "./shared/cron-weekday.js";
-import { getBrowserTimezone as B } from "./shared/browser-timezone.js";
-import { isValidAbsoluteUrl as V, isValidFeaturesData as H, parseFeaturesData as U } from "./shared/custom-apps.js";
-import { buildExternalServiceScopeId as W, getExternalServiceFallbackName as G, parseExternalServiceUrl as K } from "./shared/external-services.js";
-import { useUsageData as q } from "./usage/useUsageData/useUsageData.js";
-export { D as PROMPT_CONTENT_MAX_LENGTH, O as PROMPT_COUNTER_ANNOUNCE_THRESHOLD, k as PROMPT_DESCRIPTION_MAX_LENGTH, A as PROMPT_NAME_MAX_LENGTH, j as PromptFieldError, y as PromptSource, R as apSchedulerDayToJsDay, d as appendLocaleCode, f as buildAdditionalLocaleOptions, W as buildExternalServiceScopeId, w as buildPromptExportEnvelope, T as buildPromptExportFileName, M as buildPromptPath, p as composeLocalePayload, i as createCsrfMiddleware, a as createUnauthorizedMiddleware, m as decomposeLocalizedFields, _ as formatCalendarDate, e as getApiErrorDetails, t as getApiErrorMessage, n as getApiErrorStatus, B as getBrowserTimezone, G as getExternalServiceFallbackName, N as getRemainingCharacters, x as getRunnerSchemas, o as includesIgnoreCase, r as isConversationNotFoundError, S as isCustomAppSchema, C as isQuickAppSchema, V as isValidAbsoluteUrl, H as isValidFeaturesData, z as jsDayToApSchedulerDay, v as padTwoDigits, K as parseExternalServiceUrl, U as parseFeaturesData, b as parsePromptResourceUrl, h as resolveLocalizedText, s as safeDecodeURI, c as safeDecodeURIComponent, E as serializePromptExport, l as stripSurroundingSlashes, u as stripTrailingSlashes, g as toBaseLocale, L as usePromptsState, q as useUsageData, P as validatePromptContent, F as validatePromptDescription, I as validatePromptName };
+import { getRunnerSchemas as x, isCustomAppSchema as S, isMindMapSchema as C, isQuickAppSchema as w } from "./shared/application-schema.js";
+import { buildPromptExportEnvelope as T, buildPromptExportFileName as E, serializePromptExport as D } from "./prompt/export-prompt.js";
+import { PROMPT_CONTENT_MAX_LENGTH as O, PROMPT_COUNTER_ANNOUNCE_THRESHOLD as k, PROMPT_DESCRIPTION_MAX_LENGTH as A, PROMPT_NAME_MAX_LENGTH as j, PromptFieldError as M, buildPromptPath as N, getRemainingCharacters as P, validatePromptContent as F, validatePromptDescription as I, validatePromptName as L } from "./prompt/prompt.js";
+import { usePromptsState as R } from "./prompt/usePromptsState/usePromptsState.js";
+import { apSchedulerDayToJsDay as z, jsDayToApSchedulerDay as B } from "./shared/cron-weekday.js";
+import { getBrowserTimezone as V } from "./shared/browser-timezone.js";
+import { isValidAbsoluteUrl as H, isValidFeaturesData as U, parseFeaturesData as W } from "./shared/custom-apps.js";
+import { buildExternalServiceScopeId as G, getExternalServiceFallbackName as K, parseExternalServiceUrl as q } from "./shared/external-services.js";
+import { useUsageData as J } from "./usage/useUsageData/useUsageData.js";
+export { O as PROMPT_CONTENT_MAX_LENGTH, k as PROMPT_COUNTER_ANNOUNCE_THRESHOLD, A as PROMPT_DESCRIPTION_MAX_LENGTH, j as PROMPT_NAME_MAX_LENGTH, M as PromptFieldError, y as PromptSource, z as apSchedulerDayToJsDay, d as appendLocaleCode, f as buildAdditionalLocaleOptions, G as buildExternalServiceScopeId, T as buildPromptExportEnvelope, E as buildPromptExportFileName, N as buildPromptPath, p as composeLocalePayload, i as createCsrfMiddleware, a as createUnauthorizedMiddleware, m as decomposeLocalizedFields, _ as formatCalendarDate, e as getApiErrorDetails, t as getApiErrorMessage, n as getApiErrorStatus, V as getBrowserTimezone, K as getExternalServiceFallbackName, P as getRemainingCharacters, x as getRunnerSchemas, o as includesIgnoreCase, r as isConversationNotFoundError, S as isCustomAppSchema, C as isMindMapSchema, w as isQuickAppSchema, H as isValidAbsoluteUrl, U as isValidFeaturesData, B as jsDayToApSchedulerDay, v as padTwoDigits, q as parseExternalServiceUrl, W as parseFeaturesData, b as parsePromptResourceUrl, h as resolveLocalizedText, s as safeDecodeURI, c as safeDecodeURIComponent, D as serializePromptExport, l as stripSurroundingSlashes, u as stripTrailingSlashes, g as toBaseLocale, R as usePromptsState, J as useUsageData, F as validatePromptContent, I as validatePromptDescription, L as validatePromptName };