@yadsh/dsh-l10n-overrides 0.1.0

package/lib/index.js

@@ -0,0 +1,4 @@
+//#region src/index.ts
+function apply() {}
+//#endregion
+export { apply };

package/lib/types/adapters/dsh-locale-runtime.d.ts

@@ -0,0 +1,26 @@
+export type LocaleTranslateArguments = [
+    namespace: string,
+    key: string,
+    params?: Record<string, unknown>
+];
+export type LocaleTranslate = (...args: LocaleTranslateArguments) => unknown;
+export type AdapterResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+};
+export type LocaleInstallResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly runtimeMayBePatched: boolean;
+};
+export interface DshLocaleRuntimeAdapter {
+    readonly runtime: object;
+    getActiveLocale(): AdapterResult<string>;
+    callOriginal(args: LocaleTranslateArguments): unknown;
+    install(wrapper: LocaleTranslate): LocaleInstallResult;
+    restoreOriginalIfCurrent(wrapper: LocaleTranslate): AdapterResult<"restored" | "replaced">;
+}
+export declare function adaptDshLocaleRuntime(value: unknown): DshLocaleRuntimeAdapter | undefined;

package/lib/types/client/index.d.ts

@@ -0,0 +1,15 @@
+import type { Context } from "@deepseek-ai/cordis";
+export type { DomTranslationAttribute, DomTranslationRule, TranslationPack, } from "../types.js";
+export interface ClientLogger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+}
+export interface ClientOptions {
+    readonly debug?: boolean;
+    readonly document?: Document | null;
+    readonly logger?: ClientLogger;
+}
+export declare const inject: string[];
+export declare function apply(ctx: Context, options?: ClientOptions): () => void;

package/lib/types/index.d.ts

@@ -0,0 +1 @@
+export declare function apply(): void;

package/lib/types/packs/example.d.ts

@@ -0,0 +1,25 @@
+declare const example: Readonly<{
+    id: "example-plugin-en";
+    target: Readonly<{
+        package: "dsh-example-plugin";
+        versions: ">=0.4.0 <1.0.0";
+    }>;
+    en: Readonly<{
+        "example.settings": Readonly<{
+            title: "Settings";
+            enabled: "Enabled";
+            server: "Server address";
+            save: "Save";
+        }>;
+    }>;
+    dom: readonly Readonly<{
+        scope: "[data-plugin=\"example-plugin\"]";
+        source: "设置";
+        target: "Settings";
+    }>[];
+    metadata: Readonly<{
+        sourceLanguage: "zh";
+        description: "Example English translation pack";
+    }>;
+}>;
+export default example;

package/lib/types/packs/index.d.ts

@@ -0,0 +1,24 @@
+export declare const translationPacks: readonly Readonly<{
+    id: "example-plugin-en";
+    target: Readonly<{
+        package: "dsh-example-plugin";
+        versions: ">=0.4.0 <1.0.0";
+    }>;
+    en: Readonly<{
+        "example.settings": Readonly<{
+            title: "Settings";
+            enabled: "Enabled";
+            server: "Server address";
+            save: "Save";
+        }>;
+    }>;
+    dom: readonly Readonly<{
+        scope: "[data-plugin=\"example-plugin\"]";
+        source: "设置";
+        target: "Settings";
+    }>[];
+    metadata: Readonly<{
+        sourceLanguage: "zh";
+        description: "Example English translation pack";
+    }>;
+}>[];

package/lib/types/registry/diagnostics.d.ts

@@ -0,0 +1,15 @@
+import type { DiagnosticEntry } from "../types.js";
+type DiagnosticLogger = Pick<Console, "info" | "warn" | "error" | "debug">;
+export declare class Diagnostics {
+    #private;
+    private readonly logger;
+    constructor(logger?: DiagnosticLogger, options?: {
+        readonly debug?: boolean;
+    });
+    info(code: string, message: string): void;
+    warning(code: string, message: string): void;
+    error(code: string, message: string): void;
+    debug(code: string, message: string): void;
+    snapshot(): readonly DiagnosticEntry[];
+}
+export {};

package/lib/types/registry/translation-registry.d.ts

@@ -0,0 +1,21 @@
+import { Diagnostics } from "./diagnostics.js";
+import type { DomTranslationRule, TranslationPack } from "../types.js";
+export interface TranslationRegistryEntry {
+    readonly value: string;
+    readonly packId: string;
+}
+export interface TranslationRegistryStats {
+    readonly packs: number;
+    readonly localeOverrides: number;
+    readonly domRules: number;
+}
+export declare class TranslationPackRegistry {
+    #private;
+    private readonly diagnostics;
+    constructor(diagnostics: Diagnostics);
+    register(pack: TranslationPack): void;
+    resolve(locale: string, namespace: string, key: string): string | undefined;
+    resolveEntry(locale: string, namespace: string, key: string): TranslationRegistryEntry | undefined;
+    getStats(): TranslationRegistryStats;
+    getDomRules(locale: string): readonly DomTranslationRule[];
+}

package/lib/types/runtime/dom-translator.d.ts

@@ -0,0 +1,10 @@
+import type { Diagnostics } from "../registry/diagnostics.js";
+import type { DomTranslationRule } from "../types.js";
+export declare class DomTranslator {
+    #private;
+    private readonly document;
+    private readonly diagnostics;
+    constructor(document: Document, rules: readonly DomTranslationRule[], diagnostics: Diagnostics);
+    setLocale(locale: string): void;
+    dispose(): void;
+}

package/lib/types/runtime/interpolate.d.ts

@@ -0,0 +1 @@
+export declare function interpolate(template: string, params?: Record<string, unknown>): string;

package/lib/types/runtime/locale-hook.d.ts

@@ -0,0 +1,3 @@
+import { Diagnostics } from "../registry/diagnostics.js";
+import { TranslationPackRegistry } from "../registry/translation-registry.js";
+export declare function installLocaleHook(runtime: unknown, registry: TranslationPackRegistry, diagnostics: Diagnostics): () => boolean;

package/lib/types/types.d.ts

@@ -0,0 +1,28 @@
+export type DomTranslationAttribute = "placeholder" | "title" | "aria-label" | "alt";
+export interface DomTranslationRule {
+    readonly source: string;
+    readonly target: string;
+    readonly scope: string;
+    readonly mode?: "exact";
+    readonly attributes?: readonly DomTranslationAttribute[];
+}
+export interface TranslationPack {
+    readonly id: string;
+    readonly target: {
+        readonly package: string;
+        readonly versions?: string;
+    };
+    readonly en: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    readonly dom?: readonly DomTranslationRule[];
+    readonly metadata?: {
+        readonly sourceLanguage?: string;
+        readonly description?: string;
+        readonly upstream?: string;
+    };
+}
+export type DiagnosticLevel = "info" | "warning" | "error" | "debug";
+export interface DiagnosticEntry {
+    readonly level: DiagnosticLevel;
+    readonly code: string;
+    readonly message: string;
+}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "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/"
+  }
+}