@rayadesu/dsh-client-ui-billing 0.3.11 → 0.3.13

package/lib/types/client/BalanceBadge.d.ts

@@ -1,11 +1,12 @@
 /**
  * Session-header billing badge: balance plus the current conversation's billed
- * spend. Composition root: the data lifecycle lives in {@link useBillingData},
- * and the trigger / detail panel are pure views. The badge renders null until
- * the first balance fetch settles, and a refresh keeps the last values
- * visible rather than blanking them.
+ * spend, both carrying the detail panel's own labels (`API 剩余金额` /
+ * `本会话花费`). Composition root: the data lifecycle lives in
+ * {@link useBillingData}, and the trigger / detail panel are pure views. The
+ * badge renders null until the first balance fetch settles, and a refresh keeps
+ * the last values visible rather than blanking them.
  */
-import type { DeepSeekBalance, DeepSeekSessionSpend, DeepSeekTodaySessionsSpend, DeepSeekTodaySpend } from '@rayadesu/dsh-llm-billing/types';
+import type { DeepSeekBalance, DeepSeekDelegatedSpend, DeepSeekSessionSpend, DeepSeekTodaySessionsSpend, DeepSeekTodaySpend } from '@rayadesu/dsh-llm-billing/types';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import { NS } from './locales.ts';
@@ -28,6 +29,13 @@ export interface BalanceBadgeInjected {
     getCachedBalance: () => DeepSeekBalance | null;
     /** Read one session's billed spend; rejects with the Remote error message. */
     getSessionSpend: (sessionId: SessionId) => Promise<DeepSeekSessionSpend>;
+    /**
+     * Read the subagent part of one conversation's billed spend: every subagent
+     * session that session delegated, transitively, across every day. The badge
+     * adds it to the live own-session value, so the amount it shows is the whole
+     * conversation's. `force` behaves as in {@link getTodaySpend}.
+     */
+    getDelegatedSpend: (sessionId: SessionId, force?: boolean) => Promise<DeepSeekDelegatedSpend>;
     /**
      * Read today's billed spend across every session; rejects with the Remote
      * error message. `force` bypasses the host-side cache — the manual refresh
@@ -36,7 +44,9 @@ export interface BalanceBadgeInjected {
     getTodaySpend: (force?: boolean) => Promise<DeepSeekTodaySpend>;
     /**
      * Read today's billed spend per session, sorted by cost descending; rejects
-     * with the Remote error message. `force` behaves as in {@link getTodaySpend}.
+     * with the Remote error message. One row per top-level conversation: the host
+     * merges every subagent session's spend into the row of the session that
+     * delegated it. `force` behaves as in {@link getTodaySpend}.
      */
     getTodaySessionsSpend: (force?: boolean) => Promise<DeepSeekTodaySessionsSpend>;
 }
@@ -50,5 +60,5 @@ export type BalanceBadgeProps = PropsRuntime<'conversation.session.header.utilit
  * @param props - Remote face, locale, and the standard session-header runtime share.
  * @returns the badge, or null until the first balance fetch settles.
  */
-export declare function BalanceBadge({ getBalance, getCachedBalance, getSessionSpend, getTodaySpend, getTodaySessionsSpend, sessionId, useSession, useProjection, t }: BalanceBadgeProps): import("react").JSX.Element | null;
+export declare function BalanceBadge({ getBalance, getCachedBalance, getSessionSpend, getTodaySpend, getTodaySessionsSpend, getDelegatedSpend, sessionId, useSession, useProjection, t }: BalanceBadgeProps): import("react").JSX.Element | null;
 //# sourceMappingURL=BalanceBadge.d.ts.map

package/lib/types/client/BalancePanel.d.ts

@@ -12,13 +12,18 @@ export interface BalancePanelProps {
     amount: string;
     /** The session this panel belongs to: the row looked up in today's ranking. */
     sessionId: SessionId;
+    /** The WHOLE conversation's billed spend (this session plus the subagents it delegated). */
     spend: DeepSeekSessionSpend | null;
     todaySpend: DeepSeekTodaySpend | null;
     sessionsSpend: DeepSeekTodaySessionsSpend | null;
+    /** Whether this session is itself a delegated subagent child (so it has no ranking row of its own). */
+    isSubagent: boolean;
+    /** Whether this session started on an earlier Beijing day (the only time a today share is shown). */
+    crossedDay: boolean;
     refreshing: boolean;
     onRefresh: () => void;
     t: PropsLocale<typeof NS>['t'];
 }
 /** The detail box opened from the badge trigger. */
-export declare function BalancePanel({ amount, sessionId, spend, todaySpend, sessionsSpend, refreshing, onRefresh, t }: BalancePanelProps): import("react").JSX.Element;
+export declare function BalancePanel({ amount, sessionId, spend, todaySpend, sessionsSpend, isSubagent, crossedDay, refreshing, onRefresh, t }: BalancePanelProps): import("react").JSX.Element;
 //# sourceMappingURL=BalancePanel.d.ts.map

package/lib/types/client/SpendCard.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Composer spend card: the money-bag pill under the input box that opens this
+ * conversation's billed-cost card. The card reproduces DSH's own token-usage
+ * dialog skin row for row (same surface, radius, elevation, title rule, and
+ * right-aligned tabular amounts) with the spend's three billing buckets where
+ * that card shows its token buckets: uncached input, cache read, output.
+ *
+ * The amounts ride the host-pushed `billingTodaySpend` projection, so the card
+ * is live with zero Remote calls; `billing/getSessionSpend` is the fallback for
+ * an assembly whose projection registry is absent (the same ladder the header
+ * badge walks in `useBillingData`).
+ * @module @rayadesu/dsh-client-ui-billing/SpendCard
+ */
+import type { DeepSeekSessionSpend } from '@rayadesu/dsh-llm-billing/types';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { NS } from './locales.ts';
+/** Injected face: this conversation's priced spend, for the projection-less fallback. */
+export interface SpendCardInjected {
+    /** Read one session's billed spend across its own events (Remote fallback). */
+    getSessionSpend: (sessionId: SessionId) => Promise<DeepSeekSessionSpend>;
+}
+/**
+ * Full props of the composer spend entry. The owner share arrives from
+ * ui-conversation's declared `conversation.composer.dock` list slot (it passes
+ * no owner values); the session runtime share adds the identity and the
+ * projection reader, as it does for every session-scoped slot.
+ */
+export type SpendCardProps = PropsRuntime<'conversation.composer.dock'> & InjectFace<SpendCardInjected> & PropsLocale<typeof NS>;
+/**
+ * Render the composer spend pill, and the cost card it opens.
+ *
+ * The pill mirrors DSH's own composer stat pills (14px glyph, tertiary tone,
+ * tabular amount, hover pill) in its own row under the input box, because the
+ * composer dock is a list slot whose entries the composer stacks. A session
+ * that priced nothing renders no row at all.
+ * @param props - the session identity, the projection reader, the Remote fallback, and the locale seat.
+ * @returns the pill plus its portaled card, or null when there is nothing to show.
+ */
+export declare function SpendCard({ sessionId, useProjection, getSessionSpend, t }: SpendCardProps): import("react").JSX.Element | null;
+//# sourceMappingURL=SpendCard.d.ts.map

package/lib/types/client/format.d.ts

@@ -1,8 +1,8 @@
 /**
  * Shared display formatting for the billing badges: the balance-line currency
- * prefix and the CNY spend amount renderer. Both the header badge and the
- * per-turn cost label format through these, so the two entries cannot drift
- * apart.
+ * prefix, the CNY spend amount renderer, the token-count renderer, and the
+ * cache-hit percentage. Both the header badge and the per-turn cost label
+ * format through these, so the two entries cannot drift apart.
  */
 import type { DeepSeekBalance } from '@rayadesu/dsh-llm-billing/types';
 /** Currency prefix for one balance line; unknown codes render as a literal prefix. */
@@ -12,6 +12,83 @@ export declare function primaryLine(balance: DeepSeekBalance): {
     symbol: string;
     total: string;
 } | undefined;
-/** CNY amount, up to four decimals with trailing zeros trimmed. */
+/**
+ * CNY amount, up to four decimals with trailing zeros trimmed. The balance line's
+ * renderer; spend figures go through {@link formatSpendSignificant} instead.
+ */
 export declare function formatSpend(amount: number): string;
+/**
+ * CNY spend amount at a fixed number of SIGNIFICANT digits (default three),
+ * trailing zeros trimmed, prefixed with `¥` — and never finer than the panel's
+ * own four-decimal resolution.
+ *
+ * Every spend figure the plugin renders goes through this: the day's own amount
+ * and its three bucket costs, this session's spend and the parenthesized today
+ * share after it, the per-model rows and their bucket breakdowns, the ranking
+ * amounts, and the badge's own spend line. Four decimals are noise at these
+ * magnitudes — their last digits move with every request (`¥0.5068` → `¥0.507`)
+ * — while the four-decimal bound keeps a microscopic amount from growing a long
+ * `¥0.00002` string that would widen its column: an amount that rounds to zero
+ * there reads `¥0`. Only the BALANCE line keeps {@link formatSpend}'s plain four
+ * decimals, because remaining credit is a balance, not a spend measurement.
+ * @param amount - the amount to render.
+ * @param digits - significant digits to keep (default 3).
+ * @returns the rendered amount, e.g. `¥9.58`, `¥0.507`, `¥1230`, `¥0`.
+ */
+export declare function formatSpendSignificant(amount: number, digits?: number): string;
+/**
+ * A token count in DSH's own compact notation: `517` / `12.2K` / `517K` / `1.2M`.
+ *
+ * Mirrors ui-chat's `formatTokens` (`packages/client/ui-chat/src/client/chat/
+ * token-format.ts`) rule for rule, so one shell never renders the same count two
+ * ways. That rule reads: below 1e3 the plain integer (no digit grouping); below
+ * 1e6 the shared `number.thousand` unit (`{value}K`); otherwise the shared
+ * `number.million` unit (`{value}M`). A scaled value keeps one decimal while it
+ * is below 100 and rounds to a whole number from 100 up (`12.2K`, but `517K`),
+ * and there is no third unit, so 1.2e9 renders as `1200M` — exactly as DSH
+ * renders it. The unit letters are identical in both DSH dictionaries, so they
+ * are literals here rather than a locale lookup into the shared vocabulary.
+ * @param count - the token count to render.
+ * @returns the compact count, without the label's own ` tok` suffix.
+ */
+export declare function formatTokens(count: number): string;
+/**
+ * The cache-hit share of one prompt, in DSH's own percentage rule.
+ *
+ * Mirrors ui-chat's `formatCacheHitPercent`
+ * (`packages/client/ui-chat/src/client/chat/token-format.ts`) rule for rule, so
+ * one shell never prints the same ratio two ways: an integer percentage by
+ * default, and — because a partial hit must never round up to a full one — just
+ * enough extra decimals to stay below 100 when integer rounding would reach it
+ * (`99`, `99.5`, `99.95`, …). The rounding runs in integer arithmetic with
+ * positive ties going up, so it does not ride on binary-float precision.
+ *
+ * The ratio is over PROMPT-side tokens only (cache read over cache read plus
+ * uncached input, the split DSH's own `billedInputTokens` makes); output tokens
+ * never enter the denominator.
+ * @param cacheReadTokens - exact prompt tokens served from cache.
+ * @param promptTokens - exact aggregate prompt-side tokens.
+ * @param decimalPlaces - ordinary-ratio precision; a partial hit that would
+ * round to 100 automatically uses enough additional precision to stay honest.
+ * @returns percentage text without its `%`, or null when there was no prompt input.
+ */
+export declare function formatCacheHitPercent(cacheReadTokens: number, promptTokens: number, decimalPlaces?: 0 | 1): string | null;
+/** Every billed token bucket of one priced model row. */
+export interface TokenBuckets {
+    /** Cache-hit input tokens. */
+    cacheHitInputTokens: number;
+    /** Cache-miss input tokens (uncached input plus cache writes). */
+    cacheMissInputTokens: number;
+    /** Output tokens (reasoning included). */
+    outputTokens: number;
+}
+/**
+ * The total billed tokens of a priced row: the three buckets summed. Tokens are
+ * already counted per bucket when they were priced, so a cache-hit input token
+ * and an output token are both one token here — the number answers "how many
+ * tokens did this cost", not "how many characters were sent".
+ * @param row - one priced model row.
+ * @returns the row's total token count.
+ */
+export declare function rowTokens(row: TokenBuckets): number;
 //# sourceMappingURL=format.d.ts.map

package/lib/types/client/icons.d.ts

@@ -0,0 +1,20 @@
+/**
+ * In-house glyphs shared by this plugin's entries. Today's only member is the
+ * money bag the composer spend card and the per-turn cost label both lead with,
+ * so the two spend surfaces cannot drift apart iconographically.
+ * @module @rayadesu/dsh-client-ui-billing/icons
+ */
+/**
+ * In-house money-bag glyph in the hollow-outline style (16px viewBox, stroke
+ * currentColor, fill none), referencing the 💰 emoji: a bag outline with a
+ * tie knot at the neck and a centered yuan mark on the body. The drawing
+ * fills the 16px box like the other glyphs; a host that renders it at 14px
+ * (the DSH glyph tier) keeps the same geometry and only scales down.
+ * @param props - optional size and class.
+ * @returns the money-bag icon.
+ */
+export declare function WalletIcon({ size, className }: {
+    size?: number;
+    className?: string;
+}): import("react").JSX.Element;
+//# sourceMappingURL=icons.d.ts.map

package/lib/types/client/index.d.ts

@@ -2,6 +2,7 @@
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
 import { type BillingKey } from './locales.ts';
 export type { BalanceBadgeInjected, BalanceBadgeProps } from './BalanceBadge.tsx';
+export type { SpendCardInjected, SpendCardProps } from './SpendCard.tsx';
 export type { TurnCostActionInjected, TurnCostActionProps } from './TurnCostAction.tsx';
 export { createTurnCostStore, TURN_COST_STORE_LIMIT, type TurnCostStore } from './turnCostStore.ts';
 export type { BillingKey } from './locales.ts';

package/lib/types/client/locales.d.ts

@@ -3,21 +3,28 @@
 export declare const NS = "billing";
 /** Simplified Chinese dictionary (the key-set source of truth). */
 export declare const zh: {
-    readonly 'trigger.balance': "剩余额度：{amount}";
-    readonly 'trigger.conversationSpend': "本轮对话花费：{amount}";
+    readonly 'trigger.balance': "剩余金额：{amount}";
     readonly 'label.amount': "API 剩余金额：{amount}";
     readonly 'label.sessionSpend': "本会话花费：{amount}";
-    readonly 'label.sessionSpend.today': "（{amount}）";
-    readonly 'label.todaySpend': "今日：{amount}";
-    readonly 'label.cost.hit': "缓存命中 {amount}";
-    readonly 'label.cost.input': "未命中输入 {amount}";
+    readonly 'label.sessionSpend.today': " {amount}";
+    readonly 'label.todaySpend': "今日花费：{amount}";
+    readonly 'label.todayTokens': "今日 Token：{count}";
+    readonly 'label.todayTokens.hit': " {percent}%";
+    readonly 'unit.tokens': "{count} tok";
+    readonly 'label.cost.input': "未缓存输入 {amount}";
+    readonly 'label.cost.cacheRead': "缓存读取 {amount}";
     readonly 'label.cost.output': "输出 {amount}";
+    readonly 'card.title': "花费金额";
+    readonly 'card.aria': "本轮对话花费：{amount}";
+    readonly 'label.bucket.input': "未缓存输入";
+    readonly 'label.bucket.cacheRead': "缓存读取";
+    readonly 'label.bucket.output': "输出";
     readonly 'stat.none': "暂无消耗记录";
     readonly 'stat.untitled': "未命名";
     readonly 'state.unavailable': "额度不可用";
     readonly 'action.refresh': "刷新";
     readonly 'info.aria': "花费说明";
-    readonly 'info.hint': "估算：仅 DeepSeek 与 MiMo 模型，按每条消息自身时刻的峰谷官方单价计价（高峰：工作日 9:00–12:00、14:00–18:00）。\nv{version}";
+    readonly 'info.hint': "估算：仅 DeepSeek 与 MiMo 模型，按每条消息自身时刻的峰谷官方单价计价（高峰：工作日 9:00–12:00、14:00–18:00）。\n金额含本会话委派的子代理会话。\n紧跟的数字为本会话今日花费。\nv{version}";
     readonly 'badge.aria': "DeepSeek 额度：{amount}";
     readonly 'panel.aria': "DeepSeek 额度详情";
     readonly 'label.sessionRanking': "今日会话花费";

package/lib/types/client/spendBuckets.d.ts

@@ -0,0 +1,68 @@
+/**
+ * The composer spend card's three bucket amounts, derived from the pushed
+ * `billingTodaySpend` projection. The host fold already prices every sample
+ * into the three disjoint billing buckets (cache-hit input, cache-miss input —
+ * which includes cache writes, output including reasoning), so the card sums
+ * the session's priced model rows instead of adding a Remote call or a second
+ * fold. Keeping the derivation here (pure, no React) lets the sum and its
+ * float reconciliation be tested on their own.
+ * @module @rayadesu/dsh-client-ui-billing/spendBuckets
+ */
+import type { DeepSeekTodaySpend } from '@rayadesu/dsh-llm-billing/types';
+/** One priced row's cost split across the three billing buckets, in CNY. */
+export interface SpendBuckets {
+    /** Uncached (cache-miss) input cost, cache writes included. */
+    uncachedInput: number;
+    /** Cache-hit (cache-read) input cost. */
+    cacheRead: number;
+    /** Output cost, reasoning included. */
+    output: number;
+    /** Billed total the three rows must add up to. */
+    total: number;
+}
+/**
+ * Fold one spend's model rows into the card's three bucket amounts.
+ *
+ * The rows carry float costs, so the three independently rendered values can
+ * miss the displayed total by one unit in the last rendered decimal after each
+ * is formatted to four decimals. The residual is absorbed by the largest
+ * bucket — the only one where a 1e-4 nudge cannot be seen — so the card's rows
+ * always add up to the total it shows in its header.
+ * @param spend - the session bucket of the `billingTodaySpend` projection
+ *   (the session's own events, every Beijing day).
+ * @returns the three bucket totals plus the billed total.
+ */
+export declare function spendBucketsOf(spend: DeepSeekTodaySpend): SpendBuckets;
+/** Whether a spend has any priced amount to show (a zero card stays hidden). */
+export declare function hasBilledSpend(spend: DeepSeekTodaySpend): boolean;
+/** One spend's three bucket TOKEN counts, in DSH's row order. */
+export interface TokenBucketCounts {
+    /** Uncached (cache-miss) input tokens, cache writes included. */
+    uncachedInput: number;
+    /** Cache-hit (cache-read) input tokens. */
+    cacheRead: number;
+    /** Output tokens, reasoning included. */
+    output: number;
+}
+/**
+ * Fold one spend's model rows into the three bucket TOKEN counts — the token
+ * side of {@link spendBucketsOf}, so a surface that shows both (the panel's
+ * today rows) reads one bucket's tokens and its cost from the same rows.
+ *
+ * No reconciliation is needed here: tokens are integers, so the three counts
+ * always add up to the total the token line shows.
+ * @param spend - the day's (or one session's) priced rows.
+ * @returns the three bucket token counts.
+ */
+export declare function tokenBucketsOf(spend: DeepSeekTodaySpend): TokenBucketCounts;
+/**
+ * The cache-hit share of one spend, in DSH's own percentage rule — the ratio of
+ * the cache-read bucket to every PROMPT-side bucket (uncached input with cache
+ * writes folded in, plus cache read), output excluded, exactly the split DSH's
+ * `billedInputTokens` makes. Rendered by {@link formatCacheHitPercent}, i.e. an
+ * integer percent that grows decimals only to keep a partial hit below 100.
+ * @param spend - the day's priced rows.
+ * @returns the percentage text without its `%`, or null when the spend billed no prompt input.
+ */
+export declare function cacheHitPercentOf(spend: DeepSeekTodaySpend): string | null;
+//# sourceMappingURL=spendBuckets.d.ts.map

package/lib/types/client/spends.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Additive merge of a conversation's two spend halves: the session's OWN billed
+ * spend (live, from the pushed `billingTodaySpend` projection or the
+ * `billing/getSessionSpend` fallback) and the delegated-subagent subtotal
+ * (`billing/getDelegatedSpend`). The panel shows one amount for the whole
+ * conversation, so the two must be summed before rendering — and the per-model
+ * rows must be summed the same way, or the breakdown would no longer add up to
+ * the amount above it.
+ *
+ * Pure addition only: no pricing, no timezone, no fork-boundary knowledge lives
+ * here (the host owns all of that), so this cannot drift from the host's own
+ * sums.
+ */
+import type { DeepSeekSessionSpend } from '@rayadesu/dsh-llm-billing/types';
+/**
+ * Sum one conversation's own spend and its delegated-subagent subtotal.
+ * @param own - the session's own billed spend.
+ * @param delegated - the delegated subtotal from the last `getDelegatedSpend` read.
+ * @returns the merged spend (own model order first, then newly seen models).
+ */
+export declare function sumSpends(own: DeepSeekSessionSpend, delegated: DeepSeekSessionSpend): DeepSeekSessionSpend;
+//# sourceMappingURL=spends.d.ts.map

package/lib/types/client/useBillingData.d.ts

@@ -6,9 +6,24 @@ export declare const TURN_SETTLE_DEBOUNCE_MS = 2000;
 /** The data surface the trigger and the panel render from. */
 export interface BillingData {
     balance: DeepSeekBalance | null;
+    /**
+     * The WHOLE conversation's billed spend: this session's own spend (live, from
+     * the pushed projection or the `getSessionSpend` fallback) plus the subagent
+     * sessions it delegated (the last `getDelegatedSpend` read), so the amount a
+     * user reads is the conversation's, not just its own log's.
+     */
     spend: DeepSeekSessionSpend | null;
     todaySpend: DeepSeekTodaySpend | null;
     sessionsSpend: DeepSeekTodaySessionsSpend | null;
+    /** Whether the current session is itself a delegated subagent child. */
+    isSubagent: boolean;
+    /**
+     * Whether the current session started on an EARLIER Beijing day — the only
+     * case in which the panel's parenthesized today share is meaningful.
+     * `false` until the delegated read settles (an unproven crossing stays
+     * hidden) and for every session created today.
+     */
+    crossedDay: boolean;
     /** Balance fetch failure while no value is present yet. */
     error: string | null;
     refreshing: boolean;
@@ -19,12 +34,14 @@ export interface BillingData {
 }
 /**
  * Start the badge's data lifecycle for one session. The spend follows the
- * conversation: the host-pushed `billingTodaySpend` projection drives the
- * session line live (zero Remote calls), with `getSessionSpend` as the
- * bootstrap/fallback when the projection key is absent; today's spend is
- * recomputed through `getTodaySpend` when a turn settles; the balance stays a
- * manual-refresh snapshot and is never refetched on its own.
+ * conversation: the host-pushed `billingTodaySpend` projection drives this
+ * session's own part live (zero Remote calls), with `getSessionSpend` as the
+ * bootstrap/fallback when the projection key is absent; the delegated-subagent
+ * subtotal comes from `getDelegatedSpend` on mount, on refresh, and when a turn
+ * settles; today's spend is recomputed through `getTodaySpend` on the same
+ * events; the balance stays a manual-refresh snapshot and is never refetched on
+ * its own.
  * @param props - the badge's injected face and session runtime share.
  */
-export declare function useBillingData({ getBalance, getCachedBalance, getSessionSpend, getTodaySpend, getTodaySessionsSpend, sessionId, useSession, useProjection, }: Pick<BalanceBadgeProps, 'getBalance' | 'getCachedBalance' | 'getSessionSpend' | 'getTodaySpend' | 'getTodaySessionsSpend' | 'sessionId' | 'useSession' | 'useProjection'>): BillingData;
+export declare function useBillingData({ getBalance, getCachedBalance, getSessionSpend, getTodaySpend, getTodaySessionsSpend, getDelegatedSpend, sessionId, useSession, useProjection, }: Pick<BalanceBadgeProps, 'getBalance' | 'getCachedBalance' | 'getSessionSpend' | 'getTodaySpend' | 'getTodaySessionsSpend' | 'getDelegatedSpend' | 'sessionId' | 'useSession' | 'useProjection'>): BillingData;
 //# sourceMappingURL=useBillingData.d.ts.map

package/lib/types/client/useCardDialog.d.ts

@@ -0,0 +1,34 @@
+/**
+ * One trigger-anchored dialog seat for the composer spend card, mirroring the
+ * behaviour of DSH's own composer stat dialogs: the panel portals above the
+ * trigger, the position is clamped inside the viewport, an outside pointerdown
+ * or Escape closes it.
+ *
+ * DSH's `ui-chat` keeps its equivalent seat in its own private client bundle,
+ * so this plugin cannot import it; the two primitives it is built from are
+ * public (`@deepseek-ai/dsh-client-ui-primitives`), and the CSS skin they are
+ * paired with is reproduced in `SpendCard.module.css` from the same tokens.
+ * @module @rayadesu/dsh-client-ui-billing/useCardDialog
+ */
+import { type CSSProperties, type MutableRefObject } from 'react';
+/**
+ * Unplaced portal panel: hidden but laid out, so the clamp's measure pass sees
+ * the panel's real dimensions instead of clamping a zero-size box.
+ */
+export declare const MEASURE_STYLE: CSSProperties;
+/** Open state, the two refs, and the clamped placement of one card dialog. */
+export interface CardDialogSeat {
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    /** Anchor: wraps the trigger pill so the clamp measures the pill, not the page. */
+    rootRef: MutableRefObject<HTMLSpanElement | null>;
+    panelRef: MutableRefObject<HTMLDivElement | null>;
+    /** Clamped placement; `null` during the measure pass (use {@link MEASURE_STYLE}). */
+    pos: CSSProperties | null;
+}
+/**
+ * Own the card's open state, placement, and dismissal.
+ * @returns the seat; spread `pos ?? MEASURE_STYLE` onto the portaled panel.
+ */
+export declare function useCardDialog(): CardDialogSeat;
+//# sourceMappingURL=useCardDialog.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rayadesu/dsh-client-ui-billing",
   "description": "Session-header DeepSeek account-balance and conversation-spend badge over the billing Remote",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -47,38 +47,58 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@rayadesu/dsh-llm-billing": "^0.3.11",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.5",
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.5"
+    "@rayadesu/dsh-llm-billing": "^0.3.13",
+    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.6-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1"
   },
   "devDependencies": {
-    "@rayadesu/dsh-llm-billing": "^0.3.11",
-    "@deepseek-ai/dsh-api-gateway": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-chat": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.5",
+    "@rayadesu/dsh-llm-billing": "^0.3.13",
+    "@deepseek-ai/dsh-api-gateway": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.6-alpha.1",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "use-sync-external-store": "^1.2.0",
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.5",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.5"
+    "zustand": "~4.4.7",
+    "immer": "^10.1.1",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
+    "@shikijs/langs": "^4.3.1",
+    "anser": "^2.3.5",
+    "clsx": "^2.0.0",
+    "diff": "^9.0.0",
+    "katex": "^0.16.47",
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-gfm": "^3.1.0",
+    "mdast-util-math": "^3.0.0",
+    "micromark-core-commonmark": "^2.0.3",
+    "micromark-extension-gfm": "^3.0.0",
+    "micromark-extension-math": "^3.1.0",
+    "micromark-factory-space": "^2.0.1",
+    "micromark-util-character": "^2.1.1",
+    "micromark-util-classify-character": "^2.0.1",
+    "micromark-util-sanitize-uri": "^2.0.1",
+    "micromark-util-symbol": "^2.0.1",
+    "shiki": "^4.3.1"
   },
   "files": [
     "lib/index.js",