@burdenoff/fe-libs 2026.1028.5 → 2026.1028.6

package/dist/shared/assistant/index.d.ts

@@ -134,6 +134,7 @@ export * from './ui/AssistantMessageAttachments';
 export * from './ui/AssistantPendingWriteCard';
 export * from './ui/AssistantWriteProposalCard';
 export * from './ui/AssistantAiDisclaimer';
+export * from './ui/AiCreditBalance';
 export * from './ui/AssistantWriteConfirmDialog';
 export * from './ui/useWriteProposalConfirm';
 export * from './ui/writeProposalPresentation';
@@ -305,6 +306,7 @@ export * from './appControls/text';
 export * from './turnOutcomeCopy';
 export * from './aiCredits';
 export * from './productAiCredits';
+export * from './useAiCreditStatus';
 export * from './usageReporting';
 export * from './writeProposals';
 export * from './writeReplyBinder';

package/dist/shared/assistant/ui/AiCreditBalance.d.ts

@@ -0,0 +1,36 @@
+import { FC } from 'react';
+import { AiCreditStatus } from '../productAiCredits';
+export interface AiCreditBalanceViewProps {
+    /** The workspace's standing; null renders nothing. */
+    status: AiCreditStatus | null;
+    /** Extra layout classes from the mount point. */
+    className?: string;
+    /** Distinguishes the mounts in tests and in Playwright checks. */
+    testId?: string;
+    /** Number formatting locale. Defaults to the browser's. */
+    locale?: string;
+}
+/**
+ * Pure presentation of a credit status: nothing for an unknown or unmetered
+ * workspace (never a guessed "0 left"), the remaining credits otherwise.
+ */
+export declare const AiCreditBalanceView: FC<AiCreditBalanceViewProps>;
+export interface AiCreditBalanceProps extends Omit<AiCreditBalanceViewProps, 'status'> {
+    /** Product registry key, for example `fluidgrids`. Reads `<productKey>.ai.credits`. */
+    productKey: string;
+    /** Workspace to read. Defaults to the shell's active workspace. */
+    workspaceId?: string;
+    /** False renders nothing and reads nothing (a product that does not meter AI). */
+    enabled?: boolean;
+}
+/**
+ * The remaining AI credits for a product, shown before an AI action
+ * (BOFF-3732): under the assistant composer and on a product's own AI surfaces.
+ *
+ * Re-reads after every charged turn and after a quota wall, so the number
+ * follows spend without a reload. Renders nothing while loading, when the read
+ * fails, or when the workspace is not metered for the product.
+ *
+ * Semantic tokens only (`text-text-muted`, `text-status-error-text`).
+ */
+export declare const AiCreditBalance: FC<AiCreditBalanceProps>;

package/dist/shared/assistant/ui/AiCreditBalance.js

@@ -0,0 +1,32 @@
+import { useAiCreditBalanceLabels as e } from "../../providers/shell/useAssistantShellLabels.js";
+import { useAiCreditStatus as t } from "../useAiCreditStatus.js";
+import { jsx as n } from "react/jsx-runtime";
+//#region src/shared/assistant/ui/AiCreditBalance.tsx
+var r = ({ status: t, className: r, testId: i = "ai-credit-balance", locale: a }) => {
+	let o = e();
+	if (!t?.provisioned) return null;
+	let s, c = "normal";
+	if (t.noLimit) s = o.unlimited;
+	else if (t.exhausted || t.remaining !== null && t.remaining <= 0) c = "exhausted", s = o.exhausted;
+	else if (t.remaining !== null) s = o.remaining(new Intl.NumberFormat(a, { maximumFractionDigits: 0 }).format(Math.floor(t.remaining)));
+	else return null;
+	return /* @__PURE__ */ n("p", {
+		className: `text-[11px] leading-snug ${c === "exhausted" ? "text-status-error-text" : "text-text-muted"}${r ? ` ${r}` : ""}`,
+		"data-testid": i,
+		"data-tone": c,
+		role: "status",
+		"aria-live": "polite",
+		children: s
+	});
+}, i = ({ productKey: e, workspaceId: i, enabled: a = !0, ...o }) => {
+	let { status: s } = t(e, {
+		enabled: a,
+		...i ? { workspaceId: i } : {}
+	});
+	return /* @__PURE__ */ n(r, {
+		status: a ? s : null,
+		...o
+	});
+};
+//#endregion
+export { i as AiCreditBalance, r as AiCreditBalanceView };