@yadsh/dsh-l10n-overrides 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xarleyn
+
+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.md

@@ -0,0 +1,83 @@
+# dsh-l10n-overrides
+
+[![CI](https://github.com/xarleyn/dsh-plugins/actions/workflows/ci.yml/badge.svg)](https://github.com/xarleyn/dsh-plugins/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/%40yadsh%2Fdsh-l10n-overrides.svg)](https://www.npmjs.com/package/@yadsh/dsh-l10n-overrides)
+[![npm downloads](https://img.shields.io/npm/dm/%40yadsh%2Fdsh-l10n-overrides.svg)](https://www.npmjs.com/package/@yadsh/dsh-l10n-overrides)
+[![Node.js](https://img.shields.io/node/v/%40yadsh%2Fdsh-l10n-overrides.svg)](package.json)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Runtime localization overrides for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) plugins.
+
+`dsh-l10n-overrides` overlays missing or incorrect locale entries without replacing the host locale service. Translation packs can also provide narrowly scoped DOM fallbacks for text and selected accessibility attributes.
+
+[Specification](docs/SPEC.md) · [Roadmap](ROADMAP.md)
+
+## Installation
+
+The package is not published yet. Build and install it from a local monorepo checkout:
+
+```bash
+pnpm --filter @yadsh/dsh-l10n-overrides build
+dsh plugin --profile web add ./plugins/dsh-l10n-overrides
+```
+
+Once a public release is available, install it by package name:
+
+```bash
+dsh plugin --profile web add @yadsh/dsh-l10n-overrides
+```
+
+To remove the plugin:
+
+```bash
+dsh plugin --profile web remove @yadsh/dsh-l10n-overrides
+```
+
+Restart the DeepSeek Harness host if bundle hot reload does not pick up the newly installed browser client.
+
+## What works now
+
+- validated and indexed translation packs;
+- locale-key overlays that preserve the host locale service;
+- optional package-version compatibility ranges;
+- exact-match DOM fallbacks for text content;
+- scoped fallbacks for `placeholder`, `title`, `aria-label`, and `alt` attributes;
+- package and browser-bundle verification.
+
+The implementation is tested, but it is not considered ready for a public release until it has real translation packs and integration coverage in a live DSH browser session. See the [roadmap](ROADMAP.md).
+
+## Translation packs
+
+Packs live in `src/packs` and conform to the exported `TranslationPack` type. Each pack declares its target package, optional compatible version range, locale-key overrides, and optional exact-match DOM fallback rules.
+
+DOM rules must use a non-empty CSS scope. They are deliberately conservative: substring and regular-expression replacements are not supported, and fallback rules only touch explicitly supported text or accessibility attributes.
+
+## Requirements
+
+- Node.js `^22.19.0` or `>=24.0.0`
+- pnpm 10.4.1 for development
+- DeepSeek Harness `>=0.1.1-rc.2 <0.2.0`
+- Cordis `^4.0.1`
+
+## Development
+
+From the monorepo root:
+
+```bash
+pnpm install --frozen-lockfile
+pnpm --filter @yadsh/dsh-l10n-overrides check
+```
+
+The package check runs formatting, type checking, tests, production builds, and package smoke checks. CI runs the same quality gate through the monorepo.
+
+## Releases
+
+This package uses independent Nx Version Plans from the monorepo. Add a plan with `pnpm release:plan`; maintainers publish verified tarballs through the shared [release workflow](../../docs/RELEASING.md).
+
+## Contributing
+
+Issues, translation packs, and focused pull requests are welcome. Read the monorepo [contribution guide](../../CONTRIBUTING.md) and run the package check before submitting a change.
+
+## License
+
+[MIT](LICENSE). This is an independent community project and is not affiliated with or endorsed by DeepSeek.

package/ROADMAP.md

@@ -0,0 +1,35 @@
+# Roadmap
+
+## Implemented foundation
+
+- Translation pack contracts, validation, diagnostics, precedence, and lookup.
+- Safe interpolation for named and positional placeholders.
+- Reversible locale-runtime hook with shared-installation lifecycle handling.
+- Scoped, exact-match DOM translation with mutation observation and restoration.
+- DSH client composition and module-loader bundle generation.
+- Unit, integration, build, and package smoke checks.
+
+## Required before the first public release
+
+- Run an end-to-end smoke test inside a real DSH browser session, including
+  plugin reload and disposal.
+- Harden duplicate installation under real Cordis fibers: keep locale listeners
+  owned per fiber, DOM translators per document, and prevent a partially drained
+  installation from being leased again.
+- Replace the example pack with reviewed translations for actual target plugins
+  and record their supported version ranges.
+- Verify the packed npm tarball contents and imports from a clean consumer
+  project, not only from the repository build output.
+- Confirm compatibility against the supported DSH and locale-plugin versions.
+- Document installation and enablement once the real DSH loading path is
+  verified.
+
+## Follow-up work
+
+- Add optional settings and debug diagnostics UI.
+- Support external or user-authored pack loading after defining a trust model.
+- Add more target locales without changing the English-first core semantics.
+- Split the DOM translation engine into smaller parsing, matching, and ownership
+  modules as its rule surface grows.
+- Evaluate broader selector and SVG attribute support only with explicit tests;
+  the current HTML-oriented scope and attribute rules remain intentional.

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# The DSH plugin manager discovers this bundle through package.json.
+- insert:
+    - id: dsh-l10n-overrides
+      name: "@yadsh/dsh-l10n-overrides"