@yadsh/dsh-l10n-overrides 0.1.0 → 0.1.2

package/LICENSE

@@ -1,21 +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.
+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

@@ -10,21 +10,21 @@ Runtime localization overrides for [DeepSeek Harness](https://github.com/deepsee
 
 `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)
+[Specification](SPEC.md) · [Roadmap](ROADMAP.md)
 
 ## Installation
 
-The package is not published yet. Build and install it from a local monorepo checkout:
+Install it by package name:
 
 ```bash
-pnpm --filter @yadsh/dsh-l10n-overrides build
-dsh plugin --profile web add ./plugins/dsh-l10n-overrides
+dsh plugin --profile web add @yadsh/dsh-l10n-overrides
 ```
 
-Once a public release is available, install it by package name:
+To build and install from a local monorepo checkout instead:
 
 ```bash
-dsh plugin --profile web add @yadsh/dsh-l10n-overrides
+pnpm --filter @yadsh/dsh-l10n-overrides build
+dsh plugin --profile web add ./plugins/dsh-l10n-overrides
 ```
 
 To remove the plugin:

package/ROADMAP.md

@@ -1,35 +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.
+# 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/compatibility.json

@@ -0,0 +1,13 @@
+{
+  "deepseekHarness": {
+    "channel": "next",
+    "range": ">=0.1.1-rc.2 <0.2.0",
+    "testedReleases": [
+      "0.1.1-rc.2"
+    ],
+    "requiredClientFeatures": [
+      "client-locale"
+    ]
+  },
+  "node": "^22.19.0 || >=24.0.0"
+}

package/lib/client.js

@@ -1,5 +1,5 @@
 window.__ModuleLoader__.load({
-	id: "dsh-l10n-overrides",
+	id: "@yadsh/dsh-l10n-overrides",
 	factory: (require) => {
 		var module = { exports: {} };
 		var exports = module.exports;
@@ -372,16 +372,7 @@ window.__ModuleLoader__.load({
 			}
 		};
 		//#endregion
-		//#region src/runtime/dom-translator.ts
-		const DOM_TRANSLATION_ATTRIBUTES = /* @__PURE__ */ new Set([
-			"placeholder",
-			"title",
-			"aria-label",
-			"alt"
-		]);
-		const ELEMENT_NODE = 1;
-		const TEXT_NODE = 3;
-		const SHOW_ELEMENT_AND_TEXT = 5;
+		//#region src/runtime/protected-surfaces.ts
 		const KNOWN_PROTECTION_ATTRIBUTES = /* @__PURE__ */ new Set([
 			"class",
 			"contenteditable",
@@ -429,6 +420,8 @@ window.__ModuleLoader__.load({
 			...SHARED_PROTECTED_SURFACES
 		].join(",");
 		const ATTRIBUTE_PROTECTED_SURFACE_SELECTOR = [...CODE_LIKE_PROTECTED_SURFACES, ...SHARED_PROTECTED_SURFACES].join(",");
+		//#endregion
+		//#region src/runtime/scope-selector.ts
 		function isScopeIdentifierStart(character) {
 			return character !== void 0 && /[A-Z_a-z\u0080-\uFFFF]/.test(character);
 		}
@@ -521,6 +514,17 @@ window.__ModuleLoader__.load({
 			}
 			return components > 0 ? { dependencies } : void 0;
 		}
+		//#endregion
+		//#region src/runtime/dom-translator.ts
+		const DOM_TRANSLATION_ATTRIBUTES = /* @__PURE__ */ new Set([
+			"placeholder",
+			"title",
+			"aria-label",
+			"alt"
+		]);
+		const ELEMENT_NODE = 1;
+		const TEXT_NODE = 3;
+		const SHOW_ELEMENT_AND_TEXT = 5;
 		var DomTranslator = class {
 			document;
 			diagnostics;

package/lib/index.js

@@ -1,4 +1,13 @@
+import { createHostLoggerSink, getPluginLogger } from "@yadsh/dsh-plugin-log";
 //#region src/index.ts
-function apply() {}
+/** Host lifecycle companion; translation diagnostics remain browser-local. */
+function apply(ctx) {
+	const logger = getPluginLogger({
+		pluginId: "dsh-l10n-overrides",
+		consoleSink: createHostLoggerSink(ctx.logger)
+	});
+	logger.info("plugin.ready");
+	return async () => logger.close();
+}
 //#endregion
 export { apply };

package/lib/types/index.d.ts

@@ -1 +1,3 @@
-export declare function apply(): void;
+import type { Context } from "@deepseek-ai/cordis";
+/** Host lifecycle companion; translation diagnostics remain browser-local. */
+export declare function apply(ctx: Context): () => Promise<void>;

package/lib/types/runtime/protected-surfaces.d.ts

@@ -0,0 +1,8 @@
+export declare const KNOWN_PROTECTION_ATTRIBUTES: Set<string>;
+export declare const CLASS_PROTECTION_PATTERN: RegExp;
+export declare const TEST_ID_PROTECTION_PATTERN: RegExp;
+export declare const SCOPE_AND_PROTECTION_ATTRIBUTES: string[];
+export declare const SHARED_PROTECTED_SURFACES: string[];
+export declare const CODE_LIKE_PROTECTED_SURFACES: string[];
+export declare const TEXT_PROTECTED_SURFACE_SELECTOR: string;
+export declare const ATTRIBUTE_PROTECTED_SURFACE_SELECTOR: string;

package/lib/types/runtime/scope-selector.d.ts

@@ -0,0 +1,4 @@
+export interface ParsedScopeSelector {
+    readonly dependencies: ReadonlySet<string>;
+}
+export declare function parseSupportedScopeSelector(scope: string): ParsedScopeSelector | undefined;

package/package.json

@@ -1,95 +1,98 @@
-{
-  "name": "@yadsh/dsh-l10n-overrides",
-  "version": "0.1.0",
-  "description": "English localization overrides for DeepSeek Harness plugins",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/xarleyn/dsh-plugins.git",
-    "directory": "plugins/dsh-l10n-overrides"
-  },
-  "homepage": "https://github.com/xarleyn/dsh-plugins/tree/main/plugins/dsh-l10n-overrides#readme",
-  "bugs": {
-    "url": "https://github.com/xarleyn/dsh-plugins/issues"
-  },
-  "type": "module",
-  "main": "./lib/index.js",
-  "types": "./lib/types/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/types/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./client": {
-      "types": "./lib/types/client/index.d.ts",
-      "default": "./lib/client.js"
-    },
-    "./types": {
-      "types": "./lib/types/types.d.ts"
-    },
-    "./package.json": "./package.json"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "platform": "web",
-      "inject": [
-        "@deepseek-ai/dsh-client-locale"
-      ]
-    }
-  },
-  "files": [
-    "lib/**/*.js",
-    "lib/types/**/*.d.ts",
-    "cordis.patch.yml",
-    "README.md",
-    "ROADMAP.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "clean": "node -e \"require('node:fs').rmSync('lib', { recursive: true, force: true })\"",
-    "lint": "eslint src tests scripts",
-    "format": "prettier --check . --end-of-line auto",
-    "format:write": "prettier --write . --end-of-line auto",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "build": "pnpm run clean && tsdown && tsc -p tsconfig.build.json",
-    "test:package": "node scripts/verify-package.mjs && node scripts/verify-client-bundle.mjs",
-    "verify": "pnpm run test:package",
-    "check": "pnpm run format && pnpm run typecheck && pnpm run test && pnpm run build && pnpm run test:package",
-    "prepare": "tsdown && tsc -p tsconfig.build.json",
-    "prepublishOnly": "pnpm run check"
-  },
-  "keywords": [
-    "deepseek",
-    "deepseek-harness",
-    "dsh",
-    "dsh-plugin",
-    "localization",
-    "web-ui"
-  ],
-  "license": "MIT",
-  "engines": {
-    "node": "^22.19.0 || >=24.0.0"
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "catalog:dsh",
-    "@deepseek-ai/dsh-client-locale": "catalog:dsh"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "catalog:dsh-dev",
-    "@deepseek-ai/dsh-client-locale": "catalog:dsh-dev",
-    "@types/node": "catalog:tooling",
-    "eslint": "catalog:tooling",
-    "jsdom": "^26.1.0",
-    "prettier": "catalog:tooling",
-    "tsdown": "catalog:tooling",
-    "typescript": "catalog:plugin-tooling",
-    "vitest": "catalog:tooling"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  }
-}
+{
+  "name": "@yadsh/dsh-l10n-overrides",
+  "version": "0.1.2",
+  "description": "English localization overrides for DeepSeek Harness plugins",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xarleyn/dsh-plugins.git",
+    "directory": "plugins/dsh-l10n-overrides"
+  },
+  "homepage": "https://github.com/xarleyn/dsh-plugins/tree/main/plugins/dsh-l10n-overrides#readme",
+  "bugs": {
+    "url": "https://github.com/xarleyn/dsh-plugins/issues"
+  },
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./types": {
+      "types": "./lib/types/types.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale"
+      ]
+    }
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/types/**/*.d.ts",
+    "cordis.patch.yml",
+    "compatibility.json",
+    "README.md",
+    "ROADMAP.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "localization",
+    "web-ui"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.1-rc.2 <0.2.0"
+  },
+  "dependencies": {
+    "@yadsh/dsh-plugin-log": "^0.2.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/dsh-client-locale": "0.1.1-rc.2",
+    "@types/node": "^26.4.0",
+    "eslint": "10.9.1",
+    "jsdom": "^26.1.0",
+    "prettier": "^3.6.2",
+    "tsdown": "^0.22.14",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11",
+    "@yadsh/dsh-config": "^0.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('lib', { recursive: true, force: true })\"",
+    "lint": "eslint src tests scripts",
+    "format": "prettier --check . --end-of-line auto",
+    "format:write": "prettier --write . --end-of-line auto",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "build": "pnpm run clean && tsdown && tsc -p tsconfig.build.json",
+    "test:package": "node scripts/verify-package.mjs && node scripts/verify-client-bundle.mjs",
+    "verify": "pnpm run test:package",
+    "check": "pnpm run format && pnpm run typecheck && pnpm run test && pnpm run build && pnpm run test:package"
+  }
+}