dsh-unitverse 0.1.0

package/CHANGELOG.en.md

@@ -0,0 +1,29 @@
+# Changelog
+
+This project follows [Semantic Versioning](https://semver.org/). Chinese version: [CHANGELOG.md](CHANGELOG.md).
+
+## [0.1.0] - 2026-09-10
+
+First release.
+
+### Added
+
+- **`convert` tool**: converts across ten categories — length, area, volume, time, angle, speed, temperature, pressure, energy/heat and power — with 80+ common units (metric, imperial/US customary, common Chinese units).
+- **Lenient unit spelling**: `km` / `KM` / `kilometer` / `千米` / `公里` all resolve; matching is case-insensitive and accepts symbols, English full names and Chinese names.
+- **Two temperature modes**: absolute scales (°C / °F / K / °R) and temperature differences (`Δ°C` ↔ `Δ°F`); mixing the two is rejected with a clear error.
+- **Web converter view** "单位换算 / Unit Converter": renders next to Conversation / Trajectory in the session view tab bar and runs purely in the browser (the conversion core is bundled into `lib/client.js`, so no model or server round-trip is involved).
+  - One module per category: ten category tabs, and each module **only lists its own category's units**, so units are never mixed.
+  - Units are picked from dropdowns (`symbol · name`) — nothing has to be typed; one-click swap and one-click copy of the result.
+  - The temperature module adds a **difference Δ switch**; recent conversions are stored per category in browser localStorage.
+  - All copy, **unit names included**, follows the DSH zh/en UI language and refreshes the moment the language changes.
+- Results are rounded to ~10 significant digits by default; unknown units and cross-category requests return structured errors (`unknown-unit` / `category-mismatch` / `bad-value` / `mixed-delta`).
+
+### Changed
+
+- Renamed the plugin to **`dsh-unitverse`** (formerly `dsh-unit-conversion`; unit + universe). The tool is still `convert` and the view tab is still "单位换算 / Unit Converter".
+
+### Release
+
+- npm: `dsh-unitverse@0.1.0` (first publish; previously GitHub source only)
+- GitHub: https://github.com/runcat-tommy/dsh-unitverse
+- The browser half ships through the `dsh.client` declaration plus `exports["./client"]`; when it is not loaded, the tool keeps working unchanged.

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# 更新日志
+
+本项目遵循[语义化版本](https://semver.org/lang/zh-CN/)。英文版见 [CHANGELOG.en.md](CHANGELOG.en.md)。
+
+## [0.1.0] - 2026-09-10
+
+首次发布。
+
+### 新增
+
+- **`convert` 工具**：在十大类单位之间换算 —— 长度、面积、体积、时间、角度、速度、温度、压力、热量/能量、功率，共 80+ 个常用单位（公制、英制/美制、常用中国市制）。
+- **单位写法宽容**：`km` / `KM` / `kilometer` / `千米` / `公里` 均可识别，大小写不敏感，同时接受符号、英文全称与中文名称。
+- **温度双模式**：绝对温标换算（°C / °F / K / °R）与温差换算（`Δ°C` ↔ `Δ°F`），两者不可混用并给出明确报错。
+- **Web 换算视图**「单位换算 / Unit Converter」：与「对话」「轨迹」并列显示在会话视图标签栏中，纯前端运行（换算核心打包进 `lib/client.js`，不经过模型或服务器）。
+  - 按类别分模块：10 个类别标签，每个模块**只显示本类别的单位**，不会把不同类别的单位混在一起。
+  - 单位用下拉选择（`符号 · 单位名称`），无需手打；支持一键 ⇄ 交换、结果一键复制。
+  - 温度模块提供**温差 Δ 开关**；最近换算按类别分别保存在浏览器 localStorage。
+  - 界面文案与**单位名称**完整跟随 DSH 中/英文界面语言，切换语言即时刷新。
+- 结果默认保留约 10 位有效数字，避免浮点噪声；非法单位与跨类换算返回结构化错误（`unknown-unit` / `category-mismatch` / `bad-value` / `mixed-delta`）。
+
+### 变更
+
+- 插件更名为 **`dsh-unitverse`**（原名 `dsh-unit-conversion`，unit + universe）。工具名仍为 `convert`，视图标签仍为「单位换算 / Unit Converter」。
+
+### 发布
+
+- npm：`dsh-unitverse@0.1.0`（首次发布，此前仅提供 GitHub 源码）
+- GitHub：https://github.com/runcat-tommy/dsh-unitverse
+- 浏览器端（client）部分由 `dsh.client` 声明 + `exports["./client"]` 提供，卸载/未启用时不影响工具功能。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 runcat-tommy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,217 @@
+# dsh-unitverse · Unit Converter
+
+English | [中文](README.md) · [Changelog](CHANGELOG.en.md)
+
+> The name reads **unit + universe**: ten categories of units in one universe.
+> The GUI view tab is still called **单位换算 / Unit Converter**, and the
+> model-facing tool is still `convert`.
+
+A **DeepSeek Harness (DSH) unit conversion plugin** exposing one `convert` tool
+across **length, area, volume, time, angle, speed, temperature, pressure,
+energy/heat and power**, with case-insensitive English and Chinese unit names,
+plus both absolute-temperature and temperature-difference (Δ) modes.
+
+## Preview
+
+English UI — one independent module per category, listing only that category's units:
+
+![Unit Converter view (English UI)](assets/preview-en.jpg)
+
+Chinese UI — all copy, category names and unit names in Chinese:
+
+![单位换算视图（中文界面）](assets/preview-zh.jpg)
+
+## Features
+
+- ✅ 10 categories, 80+ common units (metric, imperial/US customary, common Chinese units)
+- ✅ Lenient unit spelling: `km` / `KM` / `kilometer` / `千米` / `公里` all resolve
+- ✅ Absolute temperature (°C / °F / K / °R) and temperature difference (`Δ°C` ↔ `Δ°F`)
+- ✅ Pure TypeScript, zero runtime dependencies, side-effect free and unit-testable
+- ✅ Results rounded to ~10 significant digits by default
+- ✅ Clear errors for unknown units or cross-category requests
+- ✅ **Web UI view**: a "Unit Converter" tab next to Conversation / Trajectory
+  in the session view bar; the panel is split into ten independent category
+  modules (units are never mixed), and all copy — **unit names included** —
+  follows the DSH zh/en UI language (since v0.1.0, requires the DSH Web GUI,
+  0.1.0-rc.6+)
+
+## Supported categories and units
+
+| Category | Base | Units (symbols) |
+| --- | --- | --- |
+| length | m | nm, μm, mm, cm, m, km, in, ft, yd, mi, nmi, 里 (li), 尺 (chi) |
+| area | m² | mm², cm², m², km², ha, 亩 (mu), in², ft², yd², acre, mi² |
+| volume | m³ | mL, L, m³, cm³, in³, ft³, yd³, gal (US), gal (UK), qt (US), bbl |
+| time | s | ms, s, min, h, d, wk, mo, yr |
+| angle | rad | rad, ° (deg), grad, ′ (arcmin), ″ (arcsec), turn |
+| speed | m/s | m/s, km/h, mph, kn (knot), ft/s |
+| temperature | K | °C, °F, K, °R (Δ prefix available for differences) |
+| pressure | Pa | Pa, kPa, MPa, hPa, bar, atm, psi, Torr, mmHg, inHg |
+| energy | J | J, kJ, MJ, cal, kcal, Wh, kWh, BTU |
+| power | W | W, kW, MW, GW, hp, PS |
+
+Every unit also accepts its **English full name (including plurals) and its
+Chinese name** as aliases — e.g. `ft`, `foot`, `feet` and `英尺` are the same unit.
+
+## Installation
+
+Install it as a DSH bundle (local checkout, tarball or GitHub all work):
+
+```bash
+# From a local checkout
+dsh plugin --profile <profile-name> add ./dsh-unitverse
+
+# Or from GitHub (build artifacts are committed, so no allowBuilds needed)
+dsh plugin --profile <profile-name> add github:runcat-tommy/dsh-unitverse
+```
+
+`package.json` declares `dsh.bundle`, so `dsh plugin add` registers the plugin
+row from `cordis.patch.yml` automatically.
+
+> The package also ships a browser half: the `dsh.client` declaration plus
+> `lib/client.js` behind the `exports["./client"]` entry. Installed into a
+> profile that runs the Web GUI, a "Unit Converter" tab appears in the session
+> view bar (see **Web converter view** below). In CLI-only profiles the client
+> part is simply never loaded and the tool keeps working.
+
+## Web converter view (v0.1.0+)
+
+After installing and restarting the DSH GUI process (`dsh web` etc.), open any
+session: the view tab bar now shows **"Unit Converter"** next to Conversation /
+Trajectory (the Chinese UI shows 单位换算):
+
+- **One module per category**: the panel opens with ten category tabs — Length,
+  Area, Volume, Time, Angle, Speed, Temperature, Pressure, Heat / Energy and
+  Power. Switching a tab switches the module, and a module **only ever lists its
+  own units**, so units from different categories are never mixed and a
+  cross-category conversion cannot be produced. Each module starts from a common
+  unit pair (e.g. Length → km ↔ mi).
+- **Unit dropdowns**: source and target units are picked from a list showing
+  `symbol · name` — no unit name has to be typed, so nothing can be misspelled.
+- **Instant result**: typing a value updates the result immediately, shown as a
+  large number + unit, the full equation and a category badge, with one-click
+  **copy**.
+- One-click **⇄ swap** of source and target.
+- The **Temperature** module adds a **Difference Δ** switch: off converts
+  absolute scales (`°C → °F`), on converts intervals (`Δ°C → Δ°F`), with an
+  explanatory hint.
+- **Recent conversions are kept per category** (browser localStorage); click any
+  row to restore it, or clear the current category’s rows in one click.
+- **Fully follows the DSH UI language**: in a Chinese environment every string —
+  including **unit names** such as 千米 / 摄氏度 — is Chinese; in an English
+  environment everything is English ("kilometer", "degree Celsius"), category
+  names and tabs included. Switching the language refreshes the panel and the
+  history immediately.
+- The view is **pure front-end**: the conversion core is bundled into
+  `lib/client.js`, so conversions run locally in the browser — no model or
+  server round-trip involved.
+
+## Usage
+
+Once installed, the model can call the `convert` tool:
+
+```text
+convert(value=100, from="km", to="mi")   -> 62.13711922 mi
+```
+
+Tool parameters:
+
+| Parameter | Type | Required | Description |
+| --- | --- | --- | --- |
+| `value` | number | yes | The numeric amount (finite number) |
+| `from` | string | yes | Source unit: symbol / English / Chinese, case-insensitive |
+| `to` | string | yes | Target unit: symbol / English / Chinese, case-insensitive |
+
+Returns a structured result: `{ value, from, to, result, category, categoryZh, summary }`.
+
+### Examples
+
+```
+"Convert 100 km to miles"
+→ convert(100, "km", "mi") → summary: "100 km = 62.13711922 mi (length)"
+
+"How many cm is 5 feet?"
+→ convert(5, "feet", "cm") → summary: "5 feet = 152.4 cm (length)"
+
+"36 km/h to m/s"     → convert(36, "km/h", "m/s")     → 10
+"1 atm to kPa"       → convert(1, "atm", "kPa")       → 101.325
+"212 °F to °C"       → convert(212, "°F", "°C")       → 100
+```
+
+### Temperature differences (Δ)
+
+Temperature converts as an **absolute scale** by default. For a temperature
+*difference*, prefix BOTH units with `Δ` or `delta`:
+
+```
+"What is a 1 °C temperature interval in °F?"
+→ convert(1, "Δ°C", "Δ°F") → 1.8
+```
+
+Mixing an absolute and a Δ unit (e.g. `Δ°C` → `K`) is rejected to avoid
+ambiguous "degrees Kelvin"-style semantics.
+
+## Precision and conventions
+
+- Results round to ~**10 significant digits** by default; the core `convert()`
+  accepts a `significantDigits` option (1–15).
+- `cal` is the thermochemical calorie (1 cal = 4.184 J); use `kcal` / `大卡`
+  for the food "Calorie".
+- `BTU` is the International Table BTU (1 BTU = 1055.05585262 J).
+- `yr` (year) is the Julian year of 365.25 days; `mo` (month) = year / 12.
+- The Chinese character 度 means degrees (angle); write 千瓦时 for kWh
+  (avoid ambiguity with 度).
+- Chinese 分/秒 in a time context map to `min`/`s`; use `arcmin`/`arcsec`
+  (角分/角秒) for angular minutes/seconds.
+
+## Using the core library directly
+
+The conversion core is a zero-dependency pure module:
+
+```ts
+import { convert, convertDetailed } from 'dsh-unitverse'
+
+convert(100, 'km', 'mi')                 // 62.13711922
+convert(25, '°C', '°F')                  // 77
+convert(1, 'Δ°C', 'Δ°F')                 // 1.8 (temperature difference)
+convertDetailed(3, 'km/h', 'm/s')        // { result: 0.833..., summary: '...' }
+```
+
+> `src/index.ts` is the DSH plugin entry (depends on `@deepseek-ai/cordis` and
+> `@deepseek-ai/dsh-tools`); `src/convert.ts` + `src/units.ts` form the
+> host-independent core library.
+
+## Development
+
+```bash
+npm install
+npm test          # full vitest suite (conversions, aliases, temperature, edges,
+                  # plugin registration, lib/client.js smoke tests)
+npm run typecheck # tsc --noEmit
+npm run build     # tsup -> lib/ (ESM + CJS + d.ts), then scripts/build-client.mjs
+                  # emits lib/client.js (the ModuleLoader lazy-CJS bundle)
+```
+
+## Repository layout
+
+```
+src/units.ts             unit tables and alias index (single source of truth)
+src/convert.ts           conversion engine: parsing, converting, temperature/Δ, precision, errors
+src/index.ts             DSH plugin entry (server/CLI side): registers the convert tool
+src/client/              Web client plugin (browser side):
+                           index.tsx          registers the conversation.view entry
+                           UnitConvertView.tsx  converter panel (pure front-end core)
+                           locales.ts         zh/en UI copy
+scripts/build-client.mjs esbuild wrapper that emits lib/client.js (ModuleLoader lazy-CJS format)
+test/                    Vitest tests (incl. lib/client.js smoke tests)
+cordis.patch.yml         DSH bundle patch layer
+lib/                     build output (committed so GitHub installs need no build)
+```
+
+`src/convert.ts` + `src/units.ts` form the host-independent core library: the
+server tool imports it, and the same code is bundled into the browser-side
+`lib/client.js`, so conversions in the Web view happen entirely locally.
+
+## License
+
+[MIT](LICENSE)

package/README.md

@@ -0,0 +1,217 @@
+# dsh-unitverse · Unit Converter
+
+English | [中文](https://github.com/runcat-tommy/dsh-unitverse/blob/main/README.md) · [Changelog](https://github.com/runcat-tommy/dsh-unitverse/blob/main/CHANGELOG.en.md)
+
+> The name reads **unit + universe**: ten categories of units in one universe.
+> The GUI view tab is still called **单位换算 / Unit Converter**, and the
+> model-facing tool is still `convert`.
+
+A **DeepSeek Harness (DSH) unit conversion plugin** exposing one `convert` tool
+across **length, area, volume, time, angle, speed, temperature, pressure,
+energy/heat and power**, with case-insensitive English and Chinese unit names,
+plus both absolute-temperature and temperature-difference (Δ) modes.
+
+## Preview
+
+English UI — one independent module per category, listing only that category's units:
+
+![Unit Converter view (English UI)](https://raw.githubusercontent.com/runcat-tommy/dsh-unitverse/main/assets/preview-en.jpg)
+
+Chinese UI — all copy, category names and unit names in Chinese:
+
+![单位换算视图（中文界面）](https://raw.githubusercontent.com/runcat-tommy/dsh-unitverse/main/assets/preview-zh.jpg)
+
+## Features
+
+- ✅ 10 categories, 80+ common units (metric, imperial/US customary, common Chinese units)
+- ✅ Lenient unit spelling: `km` / `KM` / `kilometer` / `千米` / `公里` all resolve
+- ✅ Absolute temperature (°C / °F / K / °R) and temperature difference (`Δ°C` ↔ `Δ°F`)
+- ✅ Pure TypeScript, zero runtime dependencies, side-effect free and unit-testable
+- ✅ Results rounded to ~10 significant digits by default
+- ✅ Clear errors for unknown units or cross-category requests
+- ✅ **Web UI view**: a "Unit Converter" tab next to Conversation / Trajectory
+  in the session view bar; the panel is split into ten independent category
+  modules (units are never mixed), and all copy — **unit names included** —
+  follows the DSH zh/en UI language (since v0.1.0, requires the DSH Web GUI,
+  0.1.0-rc.6+)
+
+## Supported categories and units
+
+| Category | Base | Units (symbols) |
+| --- | --- | --- |
+| length | m | nm, μm, mm, cm, m, km, in, ft, yd, mi, nmi, 里 (li), 尺 (chi) |
+| area | m² | mm², cm², m², km², ha, 亩 (mu), in², ft², yd², acre, mi² |
+| volume | m³ | mL, L, m³, cm³, in³, ft³, yd³, gal (US), gal (UK), qt (US), bbl |
+| time | s | ms, s, min, h, d, wk, mo, yr |
+| angle | rad | rad, ° (deg), grad, ′ (arcmin), ″ (arcsec), turn |
+| speed | m/s | m/s, km/h, mph, kn (knot), ft/s |
+| temperature | K | °C, °F, K, °R (Δ prefix available for differences) |
+| pressure | Pa | Pa, kPa, MPa, hPa, bar, atm, psi, Torr, mmHg, inHg |
+| energy | J | J, kJ, MJ, cal, kcal, Wh, kWh, BTU |
+| power | W | W, kW, MW, GW, hp, PS |
+
+Every unit also accepts its **English full name (including plurals) and its
+Chinese name** as aliases — e.g. `ft`, `foot`, `feet` and `英尺` are the same unit.
+
+## Installation
+
+Install it as a DSH bundle (local checkout, tarball or GitHub all work):
+
+```bash
+# From a local checkout
+dsh plugin --profile <profile-name> add ./dsh-unitverse
+
+# Or from GitHub (build artifacts are committed, so no allowBuilds needed)
+dsh plugin --profile <profile-name> add github:runcat-tommy/dsh-unitverse
+```
+
+`package.json` declares `dsh.bundle`, so `dsh plugin add` registers the plugin
+row from `cordis.patch.yml` automatically.
+
+> The package also ships a browser half: the `dsh.client` declaration plus
+> `lib/client.js` behind the `exports["./client"]` entry. Installed into a
+> profile that runs the Web GUI, a "Unit Converter" tab appears in the session
+> view bar (see **Web converter view** below). In CLI-only profiles the client
+> part is simply never loaded and the tool keeps working.
+
+## Web converter view (v0.1.0+)
+
+After installing and restarting the DSH GUI process (`dsh web` etc.), open any
+session: the view tab bar now shows **"Unit Converter"** next to Conversation /
+Trajectory (the Chinese UI shows 单位换算):
+
+- **One module per category**: the panel opens with ten category tabs — Length,
+  Area, Volume, Time, Angle, Speed, Temperature, Pressure, Heat / Energy and
+  Power. Switching a tab switches the module, and a module **only ever lists its
+  own units**, so units from different categories are never mixed and a
+  cross-category conversion cannot be produced. Each module starts from a common
+  unit pair (e.g. Length → km ↔ mi).
+- **Unit dropdowns**: source and target units are picked from a list showing
+  `symbol · name` — no unit name has to be typed, so nothing can be misspelled.
+- **Instant result**: typing a value updates the result immediately, shown as a
+  large number + unit, the full equation and a category badge, with one-click
+  **copy**.
+- One-click **⇄ swap** of source and target.
+- The **Temperature** module adds a **Difference Δ** switch: off converts
+  absolute scales (`°C → °F`), on converts intervals (`Δ°C → Δ°F`), with an
+  explanatory hint.
+- **Recent conversions are kept per category** (browser localStorage); click any
+  row to restore it, or clear the current category’s rows in one click.
+- **Fully follows the DSH UI language**: in a Chinese environment every string —
+  including **unit names** such as 千米 / 摄氏度 — is Chinese; in an English
+  environment everything is English ("kilometer", "degree Celsius"), category
+  names and tabs included. Switching the language refreshes the panel and the
+  history immediately.
+- The view is **pure front-end**: the conversion core is bundled into
+  `lib/client.js`, so conversions run locally in the browser — no model or
+  server round-trip involved.
+
+## Usage
+
+Once installed, the model can call the `convert` tool:
+
+```text
+convert(value=100, from="km", to="mi")   -> 62.13711922 mi
+```
+
+Tool parameters:
+
+| Parameter | Type | Required | Description |
+| --- | --- | --- | --- |
+| `value` | number | yes | The numeric amount (finite number) |
+| `from` | string | yes | Source unit: symbol / English / Chinese, case-insensitive |
+| `to` | string | yes | Target unit: symbol / English / Chinese, case-insensitive |
+
+Returns a structured result: `{ value, from, to, result, category, categoryZh, summary }`.
+
+### Examples
+
+```
+"Convert 100 km to miles"
+→ convert(100, "km", "mi") → summary: "100 km = 62.13711922 mi (length)"
+
+"How many cm is 5 feet?"
+→ convert(5, "feet", "cm") → summary: "5 feet = 152.4 cm (length)"
+
+"36 km/h to m/s"     → convert(36, "km/h", "m/s")     → 10
+"1 atm to kPa"       → convert(1, "atm", "kPa")       → 101.325
+"212 °F to °C"       → convert(212, "°F", "°C")       → 100
+```
+
+### Temperature differences (Δ)
+
+Temperature converts as an **absolute scale** by default. For a temperature
+*difference*, prefix BOTH units with `Δ` or `delta`:
+
+```
+"What is a 1 °C temperature interval in °F?"
+→ convert(1, "Δ°C", "Δ°F") → 1.8
+```
+
+Mixing an absolute and a Δ unit (e.g. `Δ°C` → `K`) is rejected to avoid
+ambiguous "degrees Kelvin"-style semantics.
+
+## Precision and conventions
+
+- Results round to ~**10 significant digits** by default; the core `convert()`
+  accepts a `significantDigits` option (1–15).
+- `cal` is the thermochemical calorie (1 cal = 4.184 J); use `kcal` / `大卡`
+  for the food "Calorie".
+- `BTU` is the International Table BTU (1 BTU = 1055.05585262 J).
+- `yr` (year) is the Julian year of 365.25 days; `mo` (month) = year / 12.
+- The Chinese character 度 means degrees (angle); write 千瓦时 for kWh
+  (avoid ambiguity with 度).
+- Chinese 分/秒 in a time context map to `min`/`s`; use `arcmin`/`arcsec`
+  (角分/角秒) for angular minutes/seconds.
+
+## Using the core library directly
+
+The conversion core is a zero-dependency pure module:
+
+```ts
+import { convert, convertDetailed } from 'dsh-unitverse'
+
+convert(100, 'km', 'mi')                 // 62.13711922
+convert(25, '°C', '°F')                  // 77
+convert(1, 'Δ°C', 'Δ°F')                 // 1.8 (temperature difference)
+convertDetailed(3, 'km/h', 'm/s')        // { result: 0.833..., summary: '...' }
+```
+
+> `src/index.ts` is the DSH plugin entry (depends on `@deepseek-ai/cordis` and
+> `@deepseek-ai/dsh-tools`); `src/convert.ts` + `src/units.ts` form the
+> host-independent core library.
+
+## Development
+
+```bash
+npm install
+npm test          # full vitest suite (conversions, aliases, temperature, edges,
+                  # plugin registration, lib/client.js smoke tests)
+npm run typecheck # tsc --noEmit
+npm run build     # tsup -> lib/ (ESM + CJS + d.ts), then scripts/build-client.mjs
+                  # emits lib/client.js (the ModuleLoader lazy-CJS bundle)
+```
+
+## Repository layout
+
+```
+src/units.ts             unit tables and alias index (single source of truth)
+src/convert.ts           conversion engine: parsing, converting, temperature/Δ, precision, errors
+src/index.ts             DSH plugin entry (server/CLI side): registers the convert tool
+src/client/              Web client plugin (browser side):
+                           index.tsx          registers the conversation.view entry
+                           UnitConvertView.tsx  converter panel (pure front-end core)
+                           locales.ts         zh/en UI copy
+scripts/build-client.mjs esbuild wrapper that emits lib/client.js (ModuleLoader lazy-CJS format)
+test/                    Vitest tests (incl. lib/client.js smoke tests)
+cordis.patch.yml         DSH bundle patch layer
+lib/                     build output (committed so GitHub installs need no build)
+```
+
+`src/convert.ts` + `src/units.ts` form the host-independent core library: the
+server tool imports it, and the same code is bundled into the browser-side
+`lib/client.js`, so conversions in the Web view happen entirely locally.
+
+## License
+
+[MIT](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# Bundle layer contributed by dsh-unitverse.
+# Inserts the plugin row that loads the package's tool module.
+- insert:
+    - id: unitverse
+      name: dsh-unitverse