dsh-plugin-effort-declare 0.1.2 → 0.1.3

package/src/core/README.en.md

@@ -16,12 +16,13 @@ Canonical level names and `thinkingFormat` values follow `@deepseek-ai/dsh-llm-p
 | File | Role |
 | --- | --- |
 | [`catalog.ts`](./catalog.ts) | Canonical level order, `thinkingFormat` fallback list, `llm-pi-ai` / DeepSeek constants. |
-| [`efforts.ts`](./efforts.ts) | `reasoningEfforts` read/write, Off tri-state, validation (empty object / Off-only / unknown keys return an error code, never throw). |
+| [`efforts.ts`](./efforts.ts) | `reasoningEfforts` read/write, Off tri-state (value mode stores `trim()`), validation (empty object / Off-only / unknown keys return an error code, never throw). |
 | [`presets.ts`](./presets.ts) | DeepSeek, OpenAI, and on/off presets; each states all three dialect keys; spread onto existing model rows and route `compat`. |
 | [`path-ops.ts`](./path-ops.ts) | Same one-level key diff as the official Models page; `buildSaveOps` uses `settingsPath` and only submits that route’s full `models` table and dirty `compat` keys. |
 | [`drafts.ts`](./drafts.ts) | User-layer drafts, dirty aligned with pathOps, post-save revision. On refresh, latest user-layer model membership wins; unsaved `reasoningEfforts` (including a cleared key) overlay by id; `compat` is a per-key 3-way merge. Conflict only when a locally dirty field also moved in originals (revision-only bumps and sibling-card saves do not warn). |
 | [`paths.ts`](./paths.ts) | Nested reads; clones of objects and model tables (non-object rows skipped). |
 | [`filter.ts`](./filter.ts) | Which routes are editable: hand-declared `llm-pi-ai` + openai-completions; skip catalog and official DeepSeek. |
 | [`validate.ts`](./validate.ts) | Per-row `reasoningEfforts` validation. |
+| [`attribution.ts`](./attribution.ts) | Settings footer line: `version © year Stardust`. Start year is 2026; end year is the UTC year at pack time, not the user’s clock when DSH starts. |
 
 An **absent** field means default-off. Do not encode “undeclared” as `reasoningEfforts: false` — in official semantics `false` strips reasoning from a catalog model.

package/src/core/README.md

@@ -16,12 +16,13 @@
 | 文件 | 说明 |
 | --- | --- |
 | [`catalog.ts`](./catalog.ts) | 规范档位顺序、`thinkingFormat` 回退列表、`llm-pi-ai` / DeepSeek 相关常量。 |
-| [`efforts.ts`](./efforts.ts) | `reasoningEfforts` 读写、Off 三态、校验（空对象 / 只开 Off / 未知键返回错误码，不抛异常）。 |
+| [`efforts.ts`](./efforts.ts) | `reasoningEfforts` 读写、Off 三态（value 模式写入 `trim()` 后的字符串）、校验（空对象 / 只开 Off / 未知键返回错误码，不抛异常）。 |
 | [`presets.ts`](./presets.ts) | DeepSeek、OpenAI、仅开/关三套预设；每套对三个方言键都表态；spread 到已有模型行与路由 `compat`。 |
 | [`path-ops.ts`](./path-ops.ts) | 与官方模型页相同的一层键 diff；`buildSaveOps` 使用 `settingsPath`，只提交该路由的 `models` 整表和有差异的 `compat` 键。 |
 | [`drafts.ts`](./drafts.ts) | 用户层草稿、dirty 与 pathOps 一致、保存后 revision。刷新时以最新用户层模型名单为成员真理，按 id 贴回未保存的 `reasoningEfforts`（含已清除=删键）；`compat` 按键三路合并。冲突仅当本地脏字段的 originals 也变了（只 bump revision 或别的卡保存不报）。 |
 | [`paths.ts`](./paths.ts) | 嵌套读取、对象与模型表的 clone（非对象行跳过）。 |
 | [`filter.ts`](./filter.ts) | 哪些路由可编辑：手工 `llm-pi-ai` + openai-completions；排除 catalog 与官方 DeepSeek。 |
 | [`validate.ts`](./validate.ts) | 对单行 `reasoningEfforts` 调用校验。 |
+| [`attribution.ts`](./attribution.ts) | 设置页页脚：`version © 年 Stardust`。首年写死 2026，结束年由打包时的 UTC 年注入，不是用户打开 DSH 的日期。 |
 
 **缺席字段**表示默认关闭。不要把「未声明」写成 `reasoningEfforts: false`——`false` 在官方语义里是从 catalog 模型上剥掉推理。

package/src/core/attribution.ts

@@ -0,0 +1,24 @@
+/**
+ * Plugin footer attribution. Version and end-year are frozen into the client
+ * bundle at pack time; this module only formats the line.
+ */
+
+/** First publication year (LICENSE). Not the user's wall clock. */
+export const COPYRIGHT_FROM = 2026
+
+export const COPYRIGHT_HOLDER = 'Stardust'
+
+/**
+ * `0.1.2 © 2026 Stardust` or `0.1.2 © 2026–2027 Stardust`.
+ * Throws if version is empty or `to < from` — a bad stamp must not render.
+ */
+export function formatAttribution(version: string, from: number, to: number): string {
+  if (version.trim() === '') {
+    throw new Error('plugin version must be a non-empty string')
+  }
+  if (!Number.isInteger(from) || !Number.isInteger(to) || to < from) {
+    throw new Error(`invalid copyright range: ${String(from)}\u2013${String(to)}`)
+  }
+  const years = to === from ? String(from) : `${String(from)}\u2013${String(to)}`
+  return `${version} \u00a9 ${years} ${COPYRIGHT_HOLDER}`
+}

package/src/core/efforts.ts

@@ -26,7 +26,10 @@ export function writeOff(
   const next: ReasoningEfforts = { ...efforts }
   delete next.off
   if (mode === 'empty') next.off = null
-  else if (mode === 'value') next.off = value.trim().length > 0 ? value : 'none'
+  else if (mode === 'value') {
+    const trimmed = value.trim()
+    next.off = trimmed.length > 0 ? trimmed : 'none'
+  }
   return next
 }