@dsh-plugin/dsh-loader 1.0.0 → 1.1.0-dev.32287576957

package/LICENSE

@@ -0,0 +1,160 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, functions and templates (ten
+or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are covered
+   by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License.  Such a combined library, if distributed, must be subject to
+this License for the portions of the combined library that are based
+on the Library, and the other library facilities combined with it must
+be subject to terms that permit the user to relink the combined
+library with a modified version of the Library.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

package/README.md

@@ -1,226 +1,251 @@
-# dshloader
-
-[English](#english) | [中文](README.zh-CN.md)
-
----
-
-## English
-
-A runtime compatibility shim for **dsh** (DeepSeek Harness) cordis bundle
-plugins. dshloader decouples third-party plugins from dsh's internal service
-names, module paths, package names, and RPC details through a version-aware
-**adapter registry**, so that when dsh upgrades and breaks internal APIs, you
-only upgrade dshloader — plugins keep working unchanged.
-
-### Why
-
-dsh is moving fast and its internal surface changes between releases:
-
-- `httpServer` was renamed to `webServer` — old plugins that inject
-  `httpServer` hang forever.
-- Deep source imports like
-  `@deepseek-ai/dsh-client-runtime/src/client/sessions/context-provenance.ts`
-  break when dsh ships no `src/`.
-- Client UI packages like `@deepseek-ai/dsh-client-ui-primitives` could be
-  renamed in future dsh versions, breaking every plugin that imports them
-  directly.
-- The official `dsh-host-apiproxy` hardcodes a settings namespace whitelist,
-  so third-party settings cards never appear in the Web UI.
-
-dshloader absorbs these (and future) breaks behind a **stable API**:
-`ctx.dshLoader` on the host, `window.__dshLoader__` in the browser, and
-`@dsh-plugin/dsh-loader/*` stable subpaths for package imports.
-
-### Quick start
-
-#### 1. Install dshloader into a profile
-
-```sh
-dsh plugin --profile <name> add /path/to/dshloader
-# or
-DSH_HOME=~/.dsh npx dshloader setup <name>
-```
-
-#### 2. Plugin `package.json` — only depend on dshloader
-
-```json
-{
-  "dependencies": {
-    "@dsh-plugin/dsh-loader": "link:..."
-  }
-}
-```
-
-> **Plugins must NOT declare any `@deepseek-ai/*` dependency.** All dsh
-> packages are accessed through dshloader's stable subpaths.
-
-#### 3. Host side — use `ctx.dshLoader`
-
-```js
-export const inject = ['dshLoader'];
-
-export async function apply(ctx) {
-  // Settings: register a namespace
-  const scope = ctx.dshLoader.settings.register('my-plugin', schema);
-
-  // Web: register routes and WebSocket upgrades
-  ctx.dshLoader.web.get('/api/my-plugin/status', (req, res) => res.json({ ok: true }));
-  ctx.dshLoader.web.registerUpgrade({ path: '/ws/my-plugin', handler: fn });
-
-  // Services: read cordis services
-  const sessions = ctx.dshLoader.services.get('sessions');
-}
-```
-
-#### 4. Import dsh packages via stable subpaths
-
-```js
-// Host packages
-const { defineTool } = require('@dsh-plugin/dsh-loader/tools');
-
-// Client UI packages (in client bundle source)
-import { IconCloseFill14 } from '@dsh-plugin/dsh-loader/ui-primitives';
-```
-
-**Stable subpath → real dsh package mapping (dsh 1.x):**
-
-| Stable subpath | Real dsh package |
-|---|---|
-| `@dsh-plugin/dsh-loader/tools` | `@deepseek-ai/dsh-tools` |
-| `@dsh-plugin/dsh-loader/llm` | `@deepseek-ai/dsh-llm` |
-| `@dsh-plugin/dsh-loader/agent` | `@deepseek-ai/dsh-agent` |
-| `@dsh-plugin/dsh-loader/settings` | `@deepseek-ai/dsh-settings` |
-| `@dsh-plugin/dsh-loader/ui-primitives` | `@deepseek-ai/dsh-client-ui-primitives` |
-| `@dsh-plugin/dsh-loader/ui-slots` | `@deepseek-ai/dsh-client-ui-slots` |
-| `@dsh-plugin/dsh-loader/ui-settings` | `@deepseek-ai/dsh-client-ui-settings/client` |
-| `@dsh-plugin/dsh-loader/web-react` | `@deepseek-ai/dsh-client-web-react` |
-| `@dsh-plugin/dsh-loader/schema-form` | `@deepseek-ai/dsh-client-schema-form` |
-| `@dsh-plugin/dsh-loader/runtime` | `@deepseek-ai/dsh-client-runtime/client` |
-
-When dsh renames a package, only the dshloader adapter changes — plugin
-source and bundle stay the same.
-
-#### 5. Client side — use `window.__dshLoader__`
-
-```js
-// Read cordis client services
-const conv = window.__dshLoader__.services.get('conversation');
-
-// Register a package alias at runtime (fallback)
-window.__dshLoader__.registerPackageAlias('@old/pkg', '@new/pkg');
-```
-
-#### 6. Build config — mark stable subpaths as external
-
-```ts
-const CLIENT_EXTERNALS = [
-  'react', 'react/jsx-runtime', 'react-dom', 'react-dom/client', 'cordis',
-  '@dsh-plugin/dsh-loader/ui-primitives',
-  '@dsh-plugin/dsh-loader/ui-slots',
-  '@dsh-plugin/dsh-loader/ui-settings',
-  '@dsh-plugin/dsh-loader/web-react',
-  '@dsh-plugin/dsh-loader/schema-form',
-  '@dsh-plugin/dsh-loader/runtime',
-]
-```
-
-### How it works
-
-```
-plugin ──▶ ctx.dshLoader.{settings,web,services} ──▶ dshloader adapter
-                                                         │
-                                                         ▼
-                                               real dsh (current version)
-
-plugin bundle ──▶ require('@dsh-plugin/dsh-loader/ui-primitives')
-                         │
-                         ▼ (__ModuleLoader__ wrapper maps stable name)
-                   require('@deepseek-ai/dsh-client-ui-primitives')
-                         │
-                         ▼
-                   dsh module table
-```
-
-1. **Version detection** reads `node_modules/@deepseek-ai/dsh/package.json`
-   (or `DSHLOADER_DSH_VERSION` for tests/override).
-2. **AdapterRegistry** selects the best adapter for the detected version
-   (exact → range → nearest-low fallback → clear error).
-3. The selected **adapter** registers service aliases, installs package-name
-   mapping hooks (host: `Module._resolveFilename`; client:
-   `__ModuleLoader__.load` wrapper), and (only when opted in) the settings
-   whitelist bypass bridge. All registrations use `ctx.reflect.provide` /
-   `ctx.effect`, so cordis auto-recycles them on fiber unload.
-
-> **Load order does not matter.** cordis is reactive dependency injection:
-> plugins declaring `inject: [...]` stay `PENDING` until the alias is
-> provided, regardless of where dshloader sits in `cordis.patch.yml`.
-
-### Settings whitelist bypass (`exposeAllNamespaces`)
-
-By default dshloader **does not** bypass the official settings namespace
-whitelist. Opt in explicitly:
-
-- env: `DSHLOADER_EXPOSE_ALL_SETTINGS=1`
-- profile `package.json`: `dsh.dshloader.exposeAllNamespaces: true`
-
-> **Security trade-off**: enabling this removes the official default-deny
-> boundary for browser settings access. Only enable it in profiles where you
-> trust every installed plugin.
-
-### CLI
-
-```
-dshloader setup <profile>        Inject dshloader into a profile (dep + patch).
-dshloader dump-config <profile>  Run `dsh --profile <name> --dump-config`.
-dshloader info [profile]         Print loader version, detected dsh version,
-                                 selected adapter.
-```
-
-### Rollback / disable
-
-- Disable per launch: `DSHLOADER_DISABLE=1 dsh web`
-- Remove: `dsh plugin --profile <name> rm @dsh-plugin/dsh-loader`
-
-### Project layout
-
-```
-src/
-  index.js            host bundle entry (name / inject / apply)
-  client.js           client bundle entry (immediately tier)
-  api.js              DshLoaderHostAPI construction
-  registry.js         AdapterRegistry + version detection
-  version.js          loader version + log prefix
-  stable/             stable subpath re-exports (ui-primitives, tools, ...)
-  services/
-    settings.js       settings stable API
-    web.js            web stable API
-    services.js       services stable API (get / alias)
-  adapters/
-    dsh-1-x.js        dsh 1.x adapter
-    index.js          adapter registration
-  setup.mjs           profile injection + dump-config + info
-bin/dshloader.mjs     CLI entry
-docs/
-  api.md              full API reference (Chinese)
-  design.md           design document (Chinese)
-tests/                L1 (unit) / module (L2) / integration (L3)
-examples/
-  sample-plugin/      minimal example plugin
-  dsh-aux-state/      example using ctx.dshLoader only
-```
-
-### Develop
-
-```sh
-pnpm install
-npm test            # all tests
-npm run test:l1     # unit
-npm run test:l2     # module
-npm run test:l3     # integration
-```
-
-Node.js >= 18, `node --test`, no extra test framework.
-
-### License
-
-BSD-3-Clause
+<div align="center">
+
+![Banner](./docs/banner.png)
+
+# dshloader
+
+**A version-aware runtime compatibility shim that keeps third-party plugins working unchanged across dsh (DeepSeek Harness) upgrades.**
+
+[English](#english) | [简体中文](README.zh_CN.md)
+
+[![DSH Plugin](https://img.shields.io/badge/DeepSeek%20Harness-plugin-4f7cff)](https://github.com/topics/dsh-plugin)
+<a href="https://github.com/dsh-plugins/dsh-loader/actions/workflows/npm-publish.yml">
+  <img src="https://github.com/dsh-plugins/dsh-loader/actions/workflows/npm-publish.yml/badge.svg" alt="Build Status">
+</a>
+<a href="https://www.npmjs.com/package/@dsh-plugin/dsh-loader">
+  <img src="https://img.shields.io/npm/v/@dsh-plugin/dsh-loader.svg?sanitize=true" alt="Version">
+</a>
+<a href="https://www.npmjs.com/package/@dsh-plugin/dsh-loader">
+  <img src="https://img.shields.io/npm/l/@dsh-plugin/dsh-loader.svg?sanitize=true" alt="License">
+</a>
+
+</div>
+
+## English
+
+A runtime compatibility shim for **dsh** (DeepSeek Harness) cordis bundle
+plugins. dshloader decouples third-party plugins from dsh's internal service
+names, module paths, package names, and RPC details through a version-aware
+**adapter registry**, so that when dsh upgrades and breaks internal APIs, you
+only upgrade dshloader — plugins keep working unchanged.
+
+### Why
+
+dsh is moving fast and its internal surface changes between releases:
+
+- `httpServer` was renamed to `webServer` — old plugins that inject
+  `httpServer` hang forever.
+- Deep source imports like
+  `@deepseek-ai/dsh-client-runtime/src/client/sessions/context-provenance.ts`
+  break when dsh ships no `src/`.
+- Client UI packages like `@deepseek-ai/dsh-client-ui-primitives` could be
+  renamed in future dsh versions, breaking every plugin that imports them
+  directly.
+- The official `dsh-host-apiproxy` hardcodes a settings namespace whitelist,
+  so third-party settings cards never appear in the Web UI.
+
+dshloader absorbs these (and future) breaks behind a **stable API**:
+`ctx.dshLoader` on the host, `window.__dshLoader__` in the browser, and
+`@dsh-plugin/dsh-loader/*` stable subpaths for package imports.
+
+### Quick start
+
+#### 1. Install dshloader into a profile
+
+```sh
+dsh plugin --profile <name> add /path/to/dshloader
+# or
+DSH_HOME=~/.dsh npx dshloader setup <name>
+```
+
+#### 2. Plugin `package.json` — only depend on dshloader
+
+```json
+{
+  "dependencies": {
+    "@dsh-plugin/dsh-loader": "link:..."
+  }
+}
+```
+
+> **Plugins must NOT declare any `@deepseek-ai/*` dependency.** All dsh
+> packages are accessed through dshloader's stable subpaths.
+
+#### 3. Host side — use `ctx.dshLoader`
+
+```js
+export const inject = ['dshLoader'];
+
+export async function apply(ctx) {
+  // Settings: register a namespace
+  const scope = ctx.dshLoader.settings.register('my-plugin', schema);
+
+  // Web: register routes and WebSocket upgrades
+  ctx.dshLoader.web.get('/api/my-plugin/status', (req, res) => res.json({ ok: true }));
+  ctx.dshLoader.web.registerUpgrade({ path: '/ws/my-plugin', handler: fn });
+
+  // Services: read cordis services
+  const sessions = ctx.dshLoader.services.get('sessions');
+}
+```
+
+#### 4. Import dsh packages via stable subpaths
+
+```js
+// Host packages
+const { defineTool } = require('@dsh-plugin/dsh-loader/tools');
+
+// Client UI packages (in client bundle source)
+import { IconCloseFill14 } from '@dsh-plugin/dsh-loader/ui-primitives';
+```
+
+**Stable subpath → real dsh package mapping (dsh 1.x):**
+
+| Stable subpath | Real dsh package |
+|---|---|
+| `@dsh-plugin/dsh-loader/tools` | `@deepseek-ai/dsh-tools` |
+| `@dsh-plugin/dsh-loader/llm` | `@deepseek-ai/dsh-llm` |
+| `@dsh-plugin/dsh-loader/agent` | `@deepseek-ai/dsh-agent` |
+| `@dsh-plugin/dsh-loader/settings` | `@deepseek-ai/dsh-settings` |
+| `@dsh-plugin/dsh-loader/ui-primitives` | `@deepseek-ai/dsh-client-ui-primitives` |
+| `@dsh-plugin/dsh-loader/ui-slots` | `@deepseek-ai/dsh-client-ui-slots` |
+| `@dsh-plugin/dsh-loader/ui-settings` | `@deepseek-ai/dsh-client-ui-settings/client` |
+| `@dsh-plugin/dsh-loader/web-react` | `@deepseek-ai/dsh-client-web-react` |
+| `@dsh-plugin/dsh-loader/schema-form` | `@deepseek-ai/dsh-client-schema-form` |
+| `@dsh-plugin/dsh-loader/runtime` | `@deepseek-ai/dsh-client-runtime/client` |
+
+When dsh renames a package, only the dshloader adapter changes — plugin
+source and bundle stay the same.
+
+#### 5. Client side — use `window.__dshLoader__`
+
+```js
+// Read cordis client services
+const conv = window.__dshLoader__.services.get('conversation');
+
+// Register a package alias at runtime (fallback)
+window.__dshLoader__.registerPackageAlias('@old/pkg', '@new/pkg');
+```
+
+#### 6. Build config — mark stable subpaths as external
+
+```ts
+const CLIENT_EXTERNALS = [
+  'react', 'react/jsx-runtime', 'react-dom', 'react-dom/client', 'cordis',
+  '@dsh-plugin/dsh-loader/ui-primitives',
+  '@dsh-plugin/dsh-loader/ui-slots',
+  '@dsh-plugin/dsh-loader/ui-settings',
+  '@dsh-plugin/dsh-loader/web-react',
+  '@dsh-plugin/dsh-loader/schema-form',
+  '@dsh-plugin/dsh-loader/runtime',
+]
+```
+
+### How it works
+
+```
+plugin ──▶ ctx.dshLoader.{settings,web,services} ──▶ dshloader adapter
+                                                         │
+                                                         ▼
+                                               real dsh (current version)
+
+plugin bundle ──▶ require('@dsh-plugin/dsh-loader/ui-primitives')
+                         │
+                         ▼ (__ModuleLoader__ wrapper maps stable name)
+                   require('@deepseek-ai/dsh-client-ui-primitives')
+                         │
+                         ▼
+                   dsh module table
+```
+
+1. **Version detection** reads `node_modules/@deepseek-ai/dsh/package.json`
+   (or `DSHLOADER_DSH_VERSION` for tests/override).
+2. **AdapterRegistry** selects the best adapter for the detected version
+   (exact → range → nearest-low fallback → clear error).
+3. The selected **adapter** registers service aliases, installs package-name
+   mapping hooks (host: `Module._resolveFilename`; client:
+   `__ModuleLoader__.load` wrapper), and (only when opted in) the settings
+   whitelist bypass bridge. All registrations use `ctx.reflect.provide` /
+   `ctx.effect`, so cordis auto-recycles them on fiber unload.
+
+> **Load order does not matter.** cordis is reactive dependency injection:
+> plugins declaring `inject: [...]` stay `PENDING` until the alias is
+> provided, regardless of where dshloader sits in `cordis.patch.yml`.
+
+### Settings whitelist bypass (`exposeAllNamespaces`)
+
+By default dshloader **does not** bypass the official settings namespace
+whitelist. Opt in explicitly:
+
+- env: `DSHLOADER_EXPOSE_ALL_SETTINGS=1`
+- profile `package.json`: `dsh.dshloader.exposeAllNamespaces: true`
+
+> **Security trade-off**: enabling this removes the official default-deny
+> boundary for browser settings access. Only enable it in profiles where you
+> trust every installed plugin.
+
+### CLI
+
+```
+dshloader setup <profile>        Inject dshloader into a profile (dep + patch).
+dshloader dump-config <profile>  Run `dsh --profile <name> --dump-config`.
+dshloader info [profile]         Print loader version, detected dsh version,
+                                 selected adapter.
+```
+
+### Rollback / disable
+
+- Disable per launch: `DSHLOADER_DISABLE=1 dsh web`
+- Remove: `dsh plugin --profile <name> rm @dsh-plugin/dsh-loader`
+
+### Project layout
+
+```
+src/
+  index.ts            host bundle entry (name / inject / apply)
+  client.ts           client bundle entry (immediately tier)
+  api.ts              DshLoaderHostAPI construction
+  registry.ts         AdapterRegistry + version detection
+  types.ts            shared host/client TypeScript types
+  version.ts          loader version + log prefix
+  stable/             stable subpath re-exports (ui-primitives, tools, ...)
+  services/
+    settings.ts       settings stable API
+    web.ts            web stable API
+    services.ts       services stable API (get / alias)
+  adapters/
+    dsh-1-x.ts        dsh 1.x adapter
+    index.ts          adapter registration
+  setup.ts            profile injection + dump-config + info
+bin/dshloader.mjs     CLI entry
+dist/                 compiled host build (tsc output, git-ignored)
+lib/                  compiled client bundle (tsdown output, git-ignored)
+tsconfig.json         typecheck config
+tsconfig.build.json   host build config (emits dist/)
+tsdown.client.config.mjs  client bundle build config
+docs/
+  api.md              full API reference (Chinese)
+  design.md           design document (Chinese)
+tests/                L1 (unit) / module (L2) / integration (L3)
+examples/
+  sample-plugin/      minimal example plugin
+  dsh-aux-state/      example using ctx.dshLoader only
+```
+
+### Develop
+
+```sh
+pnpm install
+npm run typecheck   # type-check src/**/*.ts
+npm run build       # compile host (dist/) + client bundle (lib/)
+npm test            # all tests
+npm run test:l1     # unit
+npm run test:l2     # module
+npm run test:l3     # integration
+```
+
+Node.js >= 18, `node --test`, no extra test framework.
+
+### License
+
+LGPL-3.0-only (GNU Lesser General Public License v3 only). See [LICENSE](./LICENSE).