dsh-ds-balance 1.0.0

package/lib/types/client/sidebar/SidebarBalance.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 侧栏左下角的余额条目。
+ *
+ * 两个形态共用同一个状态圆环：展开态是「圆环 + 金额」，折叠态是轨道里居中一个圆环。
+ * 点击条目弹出余额浮层，Escape 或点击外部关闭（刻意不做悬停即开：浮层向上展开，
+ * 会盖住左邻条目；悬停时指针只是路过我们这一行，邻居的图标就被顶开了）。
+ *
+ * 数据默认走真实端点（`GET /api/v1/balance`，按 `clientPollSeconds` 轮询）；
+ * 只有 URL 参数或 localStorage 明确选过场景时才切到 mock 旁路。
+ * 颜色仍只由 `dotStateOf(severity)` 决定。弧长是唯一读阈值的去处，且只当刻度：
+ * 由 `ringRatioOf` 算好交给圆环。组件内不做配色判断、不读 ctx。
+ * @module dsh-ds-balance/client/sidebar/SidebarBalance
+ */
+import { type LocaleKey } from '../locales.ts';
+/** 条目属性。 */
+export interface SidebarBalanceProps {
+    /** 侧栏是否展开（false = 56px 轨道）。 */
+    wide: boolean;
+    /** 词典函数。 */
+    t: (key: LocaleKey) => string;
+    /** 本组件消费的配置切片。 */
+    config: {
+        displayCurrency: string;
+        manualRefreshCooldownSeconds: number;
+        /** 浏览器来取缓存的节奏（秒）。 */
+        clientPollSeconds: number;
+        /**
+         * 配置指纹。任何一项设置改动都会换一个值，用来**立刻**重问一次后端缓存 ——
+         * 改了阈值圆环要当场变，不该等下一轮轮询。
+         */
+        configSignature: string;
+        /**
+         * 读某个币种的 warn 阈值。**只用来定弧长**，颜色不走这里。
+         * 没配的币种给 `undefined`，由 `ringRatioOf` 退回按 severity 定性。
+         */
+        warnThresholdOf: (currency: string) => number | undefined;
+    };
+}
+/**
+ * 渲染侧栏左下角的余额条目。
+ * @param props - 展开态、词典与配置切片。
+ * @returns 条目元素。
+ */
+export declare function SidebarBalance({ wide, t, config }: SidebarBalanceProps): JSX.Element | null;

package/lib/version.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 版本常量。
+ *
+ * `PLUGIN_VERSION` 必须与 `package.json` 的 `version` 逐字一致 —— 由
+ * `test/version.test.ts` 兜底。抄成两份必然漂，所以让它可校验。
+ * @module dsh-ds-balance/version
+ */
+/** 线上 schema 版本。响应里逐条回传，消费方据此判断兼容性。 */
+export declare const SCHEMA_VERSION = 1;
+/** 插件版本。与 `package.json` 的 `version` 一致（有测试兜底）。 */
+export declare const PLUGIN_VERSION = "1.0.0";
+//# sourceMappingURL=version.d.ts.map

package/lib/version.js

@@ -0,0 +1,12 @@
+/**
+ * 版本常量。
+ *
+ * `PLUGIN_VERSION` 必须与 `package.json` 的 `version` 逐字一致 —— 由
+ * `test/version.test.ts` 兜底。抄成两份必然漂，所以让它可校验。
+ * @module dsh-ds-balance/version
+ */
+/** 线上 schema 版本。响应里逐条回传，消费方据此判断兼容性。 */
+export const SCHEMA_VERSION = 1;
+/** 插件版本。与 `package.json` 的 `version` 一致（有测试兜底）。 */
+export const PLUGIN_VERSION = '1.0.0';
+//# sourceMappingURL=version.js.map

package/package.json

@@ -0,0 +1,112 @@
+{
+  "name": "dsh-ds-balance",
+  "version": "1.0.0",
+  "description": "DSH plugin: shows the DeepSeek account balance at the bottom of the sidebar, with a configuration card in settings.",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "dsh-plugin",
+    "deepseek",
+    "balance",
+    "usage"
+  ],
+  "license": "MIT",
+  "author": "zlZayn",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zlZayn/dsh-ds-balance.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zlZayn/dsh-ds-balance/issues"
+  },
+  "homepage": "https://github.com/zlZayn/dsh-ds-balance#readme",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "!lib/**/*.map",
+    "cordis.patch.yml",
+    "README.md",
+    "README_en.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "dsh": "^0.1.6-alpha.1",
+    "node": ">=20"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings-plugins"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "tsc && tsc -p tsconfig.client.json && node scripts/build-client.mjs",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.client.json --noEmit && tsc -p tsconfig.test.json",
+    "test": "npm run build && vitest run",
+    "test:watch": "vitest",
+    "test:contract": "vitest run --config vitest.contract.config.ts",
+    "check:release": "node scripts/check-release.mjs"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-credentials": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-home-paths": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-settings": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.6-alpha.1",
+    "@deepseek-ai/schemastery": "^3.18.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-credentials": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-home-paths": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-settings": "^0.1.6-alpha.1",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.6-alpha.1",
+    "@deepseek-ai/schemastery": "^3.18.2",
+    "@types/node": "^20.0.0",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.1",
+    "clsx": "^2.1.1",
+    "esbuild": "^0.21.5",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0"
+  },
+  "dependencies": {
+    "zod": "^4.6.5"
+  }
+}