@kenz1117/dsh-ui-usage-billing 1.1.7 → 1.1.8

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

@@ -106,6 +106,16 @@ export declare function lastSevenDays(byDay: Record<string, {
     date: string;
     cost: number;
 }[];
+/**
+ * 本自然周（周一起算）到 `today` 的累计值（issue #39）：标签「本周」的语义是
+ * 自然周，近 7 天滚动窗口会在周一把上周用量卷进来（周一时它与当月几乎相等，
+ * 用户误解为统计错误）。周一 = `getDay() === 1`；`pick` 决定日行取哪个维度。
+ * @param byDay - 按日聚合表（key = `YYYY-MM-DD` 本地时区）。
+ * @param today - 今天的本地日期戳。
+ * @param pick - 日行取值（缺省取 cost；token 视角传 input+output 合计）。
+ * @returns 本周一到今天的合计；`today` 本身不在表里（无调用）时为 0。
+ */
+export declare function sinceMondayOf<T>(byDay: Record<string, T>, today: string, pick?: (row: T) => number): number;
 /** 会话明细行（与服务端 SessionUsageRow 同形；旧快照可能缺失整个 bySession）。 */
 interface SessionBillingRow {
     id: string;

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

@@ -129,9 +129,15 @@ export declare function isPeakHour(beijingHour: number): boolean;
  */
 export declare function tierAt(timeMs: number | null | undefined): PriceTierId;
 /**
- * 当前峰谷档位与距下次切换的时长。导出供测试：纯函数。
+ * 当前峰谷档位与距下一切换的时长。导出供测试：纯函数。
+ *
+ * 下一切换点统一定义为档位真正变化的最近边界：自当前时刻起逐天扫描工作日的
+ * 09:00 / 12:00 / 14:00 / 18:00，候选时刻的档位由 {@link tierAt} 判定——
+ * 周末（周六/周日）北京全天低谷、没有边界，扫描自然跳过；工作日深夜跨周末
+ * 时落到周一 09:00 而非周末伪边界（issue #33）。
+ * 最坏情形（周五 18:00 后 → 周一 09:00）约 63h，7 天窗口必然覆盖。
  * @param nowMs - 当前时刻（epoch 毫秒）。
- * @returns 当前档位与到下一个切换边界的毫秒数。
+ * @returns 当前档位与到下一切换边界的毫秒数。
  */
 export declare function tierCountdown(nowMs: number): {
     tier: PriceTierId;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kenz1117/dsh-ui-usage-billing",
   "description": "Usage billing dashboard for DeepSeek Harness: sidebar cost metrics plus a full dashboard modal, priced from a current multi-provider catalog with real usage aggregated from session logs.",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "publishConfig": {
     "access": "public"
   },