@jingyi0605/codingns4dsh 0.2.1-rc.2 → 0.2.1-rc.3

package/data/build/dist/client/features/subscription-quota-groups.d.ts

@@ -0,0 +1,193 @@
+import type { ReactElement } from 'react';
+import type { MagpieQuota, MagpieQuotaCheckin, MagpieQuotaWindow } from '../../shared/contracts/subscription.js';
+import type { CodingNsTranslator } from '../locale.js';
+/**
+ * 同一厂商的多个账号在订阅弹层里归成一组。
+ *
+ * 分组键只用上游的 `provider`，不合并 `plan` 或显示名：WorkBuddy 与 WorkBuddy AI 是
+ * 两个独立产品，账号之间也不共享额度，按显示名合并会把不同账户体系的余额混在一起。
+ */
+export interface SubscriptionQuotaGroup {
+    readonly provider: string;
+    readonly name: string;
+    readonly icon?: string;
+    readonly logoDataUrl?: string;
+    /** 该厂商的账号；会话实际使用过的账号排在第一位。 */
+    readonly accounts: readonly MagpieQuota[];
+    /** 组内是否有本会话确认使用过的账号。 */
+    readonly hasActive: boolean;
+}
+/**
+ * 按厂商分组，保持上游首次出现的顺序。
+ *
+ * 组内把 `active` 账号提到最前，其余沿用上游顺序；没有 `active` 标记时完全保持原顺序，
+ * 不对"哪个账号正在使用"做任何猜测。
+ */
+export declare function groupQuotasByProvider(quotas: readonly MagpieQuota[]): readonly SubscriptionQuotaGroup[];
+/** 账号在组内的显示名：用户起的别名优先，其次上游账号名，最后回退到厂商名。 */
+export declare function quotaAccountLabel(quota: MagpieQuota, fallback: string): string;
+/** 单个窗口的剩余百分比；上游只给 `used` 时反推，两者都没有时返回 null。 */
+export declare function quotaWindowRemaining(window: MagpieQuotaWindow): number | null;
+/** 窗口余量的可读数值：优先上游的 `display`，其次 `amount / limit unit`。 */
+export declare function quotaWindowAmount(window: MagpieQuotaWindow): string | null;
+/** 四舍五入到两位小数；整数不补 `.00`，避免 2400 显示成 2400.00。 */
+export declare function formatQuotaNumber(value: number): string;
+export interface QuotaBalance {
+    /** 上游原始 `balance` 文本（如 `$74.40`、`12.5 USD`）。 */
+    readonly raw: string;
+    /** 规范化后的币种符号：`$`、`€`、`¥`、`£`、`₹`、`₩`、`₽` 或大写的三位币种代码。 */
+    readonly unit: string;
+    readonly amount: number;
+    /**
+     * 是否为可读金额：带币种符号、小数或币种代码的余额才作为金额展示。
+     * 纯整数或 `available` 这类状态词不是金额，不能猜成美元。
+     */
+    readonly money: boolean;
+}
+/**
+ * 解析 Magpie 账号余额文本。
+ *
+ * Magpie 的 `balance` 是厂商原样文本（Codex 为 `69643.12 credits`，New-API 为
+ * `$74.40`），既可能是金额也可能是积分。这里按明确出现的币种符号与小数位识别
+ * 金额，`credits` 之类的单位保留原样，避免把积分当成美元。
+ */
+export declare function parseQuotaBalance(value: string | null | undefined): QuotaBalance | null;
+/** 金额的展示文本：小数保留到两位，极小金额保留有效位而不是舍成 0.00。 */
+export declare function formatQuotaBalance(balance: QuotaBalance): string;
+/**
+ * 上游按积分（而非货币）计量时的余额。
+ *
+ * WorkBuddy、WorkBuddy AI 这类厂商只提供 `Credits` 窗口，`0 / 350` 就是全部余额，
+ * 既没有金额 `balance` 也没有百分比可算（剩余量恒为 0%）。这里把这类"计数额度"
+ * 单独读出来，让底部栏显示 `350` 而不是一个永远空着的 `0%` 环。
+ */
+export interface QuotaCreditBalance {
+    /** 剩余可用的积分。 */
+    readonly remaining: number;
+    /** 额度上限；上游只给百分比或总数时可能缺失。 */
+    readonly limit: number | null;
+    /** 上游单位（`credits`、`points` 等）；只有窗口名时可退回窗口名。 */
+    readonly unit: string;
+    /** 上游给出的展示原文（如 `0 / 350`），用于 tooltip 与弹层。 */
+    readonly display: string | null;
+}
+/** 单个窗口是否按积分计量，以及它的余量读数；普通百分比窗口返回 null。 */
+export declare function readWindowCreditBalance(window: MagpieQuotaWindow): QuotaCreditBalance | null;
+/**
+ * 读取账号的积分余额。
+ *
+ * 只认带积分含义的窗口或单位，普通的百分比窗口（`5 hours`、`7 days`）不参与，
+ * 避免把"剩余 73%"说成"73 积分"。
+ */
+export declare function resolveQuotaCreditBalance(quota: {
+    readonly windows: readonly MagpieQuotaWindow[];
+}): QuotaCreditBalance | null;
+/**
+ * 弹层里的积分文本：`剩余 / 上限 + 单位`。
+ *
+ * 只在窗口没有百分比时使用（百分比仍是更直接的读法）；上游给了 `0 / 350`
+ * 这类 display 原文时优先照抄，避免自己再算一遍四舍五入。
+ */
+export declare function formatQuotaCredits(credits: QuotaCreditBalance): string;
+/**
+ * 底部栏触发按钮上要显示的余额文本。
+ *
+ * 优先展示金额余额（如 New-API 的 `$74.40`）；没有金额但上游按积分计量时展示积分
+ * （如 WorkBuddy 的 `350`）。状态词之类的伪余额不显示，由圆形额度环承担。
+ * 多个账号时展示会话实际使用的账号，否则取第一个有余额的账号。
+ */
+export declare function resolveQuotaBalanceLabel(quotas: readonly MagpieQuota[] | null | undefined): string | null;
+/**
+ * 签到状态的语义分类。
+ *
+ * 只把上游明确表示成功的 `claimed` / `done` 算作已签到；未知枚举按"未签到"处理，
+ * 这样新厂商状态不会在界面上被当成成功。
+ */
+export type CheckinState = 'claimed' | 'failed' | 'ineligible' | 'inactive' | 'captcha' | 'own-app' | 'pending' | 'unknown';
+export declare function classifyCheckin(quota: MagpieQuota, today: string): CheckinState;
+/** 用本地时区算出"今天"，与上游的 `day` 字段比较时必须用同一时区。 */
+export declare function localDayKey(nowMs: number): string;
+/** 签到状态的本地化文案；参数为空对象时表示"今天还没有签到记录"。 */
+export declare function describeCheckin(state: CheckinState, checkin: MagpieQuotaCheckin | null | undefined, t: CodingNsTranslator): string;
+export declare function formatLocalTime(value: string): string;
+/** 一个账号的详情块：窗口条、签到、重置卡、每日消耗与错误摘要。 */
+export declare function createQuotaAccountBlock(quota: MagpieQuota, options: {
+    readonly t: CodingNsTranslator;
+    readonly nowMs: number;
+    /** 组内账号数 > 1 时显示账号名，单账号时由组头承担。 */
+    readonly showAccountName: boolean;
+    /** 折叠态只画进度条，不画签到、明细与每日用量。 */
+    readonly compact: boolean;
+    readonly fallbackName: string;
+}): ReactElement;
+/** 厂商组头：图标、名称、账号数与被使用的账号。 */
+export declare function createQuotaGroupHeader(input: {
+    readonly group: SubscriptionQuotaGroup;
+    readonly t: CodingNsTranslator;
+    readonly expanded: boolean;
+    readonly onToggle: (() => void) | null;
+}): ReactElement;
+/**
+ * 把 Magpie 用量页的配额行按厂商归组。
+ *
+ * 与订阅弹层共用同一个分组键（只有 `provider`），但保留各自的行类型：
+ * 用量页还需要每行自己的 `daily` 明细与历史线。
+ */
+export declare function groupQuotaRowsByProvider<T extends {
+    readonly provider: string;
+    readonly name: string;
+    readonly icon?: string;
+    readonly logoDataUrl?: string;
+    readonly user: string | null;
+}>(rows: readonly T[]): readonly {
+    readonly provider: string;
+    readonly name: string;
+    readonly logoDataUrl?: string;
+    readonly accounts: readonly T[];
+}[];
+/**
+ * 余额解析只需要账号的 `balance` 与 `windows`。
+ *
+ * 订阅弹层的 `MagpieQuota` 与用量页的 `MagpieDashboardQuota` 窗口结构略有差异
+ * （后者没有 `startsAt`），因此这里只约束实际用到的字段，两处共用同一个解析器。
+ */
+export interface QuotaAccountBalanceSource {
+    readonly balance: string | null;
+    readonly windows: readonly MagpieQuotaWindowLike[];
+}
+/** 余额解析用到的窗口字段；其余字段（`startsAt`、`runsOut` 等）与本逻辑无关。 */
+export interface MagpieQuotaWindowLike {
+    readonly name: string;
+    readonly usedPercent: number | null;
+    readonly remainingPercent: number | null;
+    readonly display: string | null;
+    readonly amount: number | null;
+    readonly limit: number | null;
+    readonly unit: string | null;
+}
+/** 账号余额的读法：金额（`$74.14`）或计数额度（`2,077.75 / 2,400 积分`）。 */
+export interface QuotaAccountBalance {
+    /** 展示文本；金额已带币种符号。 */
+    readonly text: string;
+    /** 是否为货币金额；用于决定是否按金额样式（等宽数字、较大字号）渲染。 */
+    readonly money: boolean;
+    /** 上游原文，放在 tooltip 里供追溯。 */
+    readonly raw: string;
+}
+/**
+ * 读取一个账号在"没有百分比可言"时的余额。
+ *
+ * 订阅页的额度卡过去只画百分比进度条，New-API（`$74.14`）、Sub2api（钱包余额
+ * `$88018.15`）和按积分计量的 WorkBuddy（`2,077.75 / 2,400 积分`）这类账号
+ * 就只剩一条空进度条，看不到真正的余额。这里按 Magpie 原生卡片的顺序取数：
+ *
+ * 1. 上游给出带币种的 `balance` → 直接就是金额；
+ * 2. 某个窗口带明确的币种单位且给了 `amount / limit`（如 Command Code 的
+ *    `$8.04 / $10.00`）→ 按币种拼成金额文本，符号与原生写法一样放在数值前；
+ * 3. 账号上有按积分计量的窗口 → `剩余 / 上限 + 单位`；
+ * 4. 只有 `amount / limit` 而没有币种 → 原样拼上单位。
+ *
+ * 都没有时返回 null，交给调用方显示"未报告额度上限"。
+ */
+export declare function resolveQuotaAccountBalance(quota: QuotaAccountBalanceSource): QuotaAccountBalance | null;
+//# sourceMappingURL=subscription-quota-groups.d.ts.map

package/data/build/dist/client/features/subscription-quota-groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-quota-groups.d.ts","sourceRoot":"","sources":["../../../../../src/client/features/subscription-quota-groups.ts"],"names":[],"mappings":"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"}