@ragnoryok1/dsh-client-locale-ru 0.1.7 → 0.1.8

package/CHANGELOG.md

@@ -6,6 +6,27 @@
 Пакет следует за харнессом: целевая версия — `dsh 0.1.7-rc.2` и новее
 (`>=0.1.0-rc.2 <0.2.0` для `@deepseek-ai/dsh-client-locale`).
 
+## [0.1.8] — 2026-09-27
+
+### Добавлено
+
+- **Русская экранная типографика** (`src/client/typography.ts`): «ёлочки» вместо прямых
+  кавычек, длинное тире между словами, многоточие, неразрывный пробел между числом и
+  следующим словом или единицей измерения. Правила осторожные: код, поля ввода,
+  редактируемый текст и `[data-typography="off"]` не трогаются, повторный проход ничего не
+  меняет. Работает как `ctx.effect`, поэтому выгружается вместе с плагином.
+- **Проверки в CI** (`.github/workflows/verify.yml`): сборка, 12 правил типографики
+  (`scripts/check-typography.mjs`) и аудит локали (`scripts/audit.mjs`) против
+  **закреплённого тега** харнеса. Новые npm-скрипты: `check:typography`, `audit`, `verify`.
+- Раздел README **«Область покрытия»** с измерением: из 17 самых скачиваемых плагинов
+  экосистемы 11 не поставляют собственных строк, поэтому их русский интерфейс обеспечивают
+  словари харнеса; словари сторонних плагинов в область пакета не входят.
+
+### Исправлено
+
+- **Число переводов в документации**: 2598 → **2304**. Прежняя цифра считала повторяющиеся
+  имена ключей в разных namespace дважды.
+
 ## [0.1.7] — 2026-09-27
 
 ### Исправлено
@@ -48,7 +69,7 @@
 
 ### Состояние
 
-52 namespace, 2598 переводов, ~2700 строк. Проверки: 0 отсутствующих ключей против
+52 namespace, 2304 перевода, ~2700 строк. Проверки: 0 отсутствующих ключей против
 `dsh 0.1.7-rc.2`, 0 мёртвых namespace, 45/45 пар ключей с формами числа.
 
 ## [0.1.6] — 2026-09-25

package/README.md

@@ -2,11 +2,12 @@
 
 [![npm](https://img.shields.io/npm/v/%40ragnoryok1%2Fdsh-client-locale-ru)](https://www.npmjs.com/package/@ragnoryok1/dsh-client-locale-ru)
 [![license](https://img.shields.io/npm/l/%40ragnoryok1%2Fdsh-client-locale-ru)](LICENSE)
+[![verify](https://github.com/Ragnoryok1/dsh-client-locale-ru/actions/workflows/verify.yml/badge.svg)](https://github.com/Ragnoryok1/dsh-client-locale-ru/actions/workflows/verify.yml)
 [![dsh](https://img.shields.io/badge/dsh-0.1.7--rc.2%2B-6366f1)](https://github.com/deepseek-ai/deepseek-harness)
 [![namespaces](https://img.shields.io/badge/namespaces-52-6466f1)](https://github.com/Ragnoryok1/dsh-client-locale-ru)
-[![strings](https://img.shields.io/badge/strings-2%2C598-6466f1)](https://github.com/Ragnoryok1/dsh-client-locale-ru)
+[![strings](https://img.shields.io/badge/strings-2%2C304-6466f1)](https://github.com/Ragnoryok1/dsh-client-locale-ru)
 
-**In English.** Russian (`ru`) language pack for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) web GUI (`dsh`). It registers `ru` as a selectable client language through the locale service (`ctx.locale.addLanguage`) plus one dictionary per namespace — 52 namespaces, 2,598 strings, built against dsh `0.1.7-rc.2`. Install with `dsh plugin --profile web add @ragnoryok1/dsh-client-locale-ru`, then pick **Русский** in Settings → General. Missing keys fall back to English, so a newer harness keeps working. MIT, community-maintained, not affiliated with DeepSeek. Details below are in Russian.
+**In English.** Russian (`ru`) language pack for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) web GUI (`dsh`). It registers `ru` as a selectable client language through the locale service (`ctx.locale.addLanguage`) plus one dictionary per namespace — 52 namespaces, 2,304 strings, built against dsh `0.1.7-rc.2`. Install with `dsh plugin --profile web add @ragnoryok1/dsh-client-locale-ru`, then pick **Русский** in Settings → General. Missing keys fall back to English, so a newer harness keeps working. The scope is the harness's own client interface only — third-party plugin dictionaries are deliberately out of scope, and 11 of the 17 most-downloaded ecosystem plugins ship no strings of their own, so they are already Russian through these namespaces. MIT, community-maintained, not affiliated with DeepSeek. Details below are in Russian.
 
 ---
 
@@ -54,6 +55,68 @@ dsh plugin --profile web add @ragnoryok1/dsh-client-locale-ru
   «ещё 3 стр.»). Ни одна видимая строка не показывает неверную форму числа.
 - **Фолбэк** — отсутствующий русский ключ падает на `en` (настроенный `fallback`).
 
+## Типографика
+
+Пакет приводит уже отрисованный русский текст к типографским правилам: «ёлочки» вместо
+прямых кавычек, длинное тире вместо дефиса между словами, многоточие вместо трёх точек и
+неразрывный пробел между числом и следующим словом или единицей измерения (чтобы «187
+плагинов» не разрывалось на две строки). Правила намеренно осторожны: срабатывают только
+на однозначных шаблонах, а код, поля ввода, редактируемый текст и элементы с
+`data-typography="off"` не трогаются вообще. Повторный проход ничего не меняет.
+
+Правила проверяются скриптом, а не на глаз: `npm run check:typography`.
+
+## Проверки
+
+```sh
+npm run build             # сборка трёх выходов
+npm run check:typography  # 12 правил типографики, включая «не трогать»
+npm run audit -- <дерево харнеса>   # аудит локали
+npm run verify -- <дерево харнеса>  # всё вместе
+```
+
+Аудит выполняется в CI (`.github/workflows/verify.yml`) против **закреплённого тега**
+харнеса, а не против случайного локального чекаута. Гейтом проверяются две вещи, и обе
+уже ловили настоящие дефекты:
+
+- **мёртвые namespace** — каждый namespace, который регистрирует пакет, обязан
+  существовать в харнессе. В 0.1.6 переводы каталога расписания были зарегистрированы
+  под именем `schedule.manager`, тогда как читает их `schedule.catalog`: проверка покрытия
+  по ключам при этом рапортовала «всё переведено»;
+- **пары форм числа** — множества `.one`/`.other` должны совпадать, потому что клиент
+  выбирает форму как `count === 1 ? '.one' : '.other'`.
+
+Число покрытия выводится, но не является гейтом: точный список «добавить / удалить»
+требует сравнения ключей **по namespace** (это делает релизная оснастка), а сравнение имён
+ключей глобально отметило бы разделы, которые пакет сознательно оставляет на английском.
+
+## Область покрытия: только официальный интерфейс
+
+Пакет переводит **собственные namespace клиента харнеса** — 52 namespace, сверенные с
+закреплённым тегом. Словари сторонних плагинов в область сознательно не входят, и вот
+почему.
+
+Мы проверили 17 самых скачиваемых плагинов экосистемы (npm, `keywords:dsh-plugin`,
+скачивания за месяц) и посмотрели, какие из них вообще поставляют собственные строки:
+
+| Что обнаружено | Плагинов |
+|---|---|
+| **Своих строк нет** — интерфейс берёт текст из namespace харнеса | **11 из 17** |
+| Крупный собственный словарь (подтверждено вручную) | 2 — `dshmarket` (~1262 ключа), `@nanmicoder/dsh-agent-teams` (420) |
+| Только типы `.d.ts`, строк нет | 1 — `dsh-plugin-model-proxy` |
+| Требует отдельной проверки | 3 |
+
+Практическое следствие: у **11 из 17** популярнейших плагинов русский интерфейс уже
+работает — их текст лежит в общих namespace харнеса, которые пакет переводит полностью.
+Отдельный словарь нужен только там, где плагин везёт свои строки, а такой словарь — это
+обязательство следить за чужими релизами: у `dshmarket` уже версия 1.66.3, и её ключи
+меняются независимо от харнеса.
+
+Поэтому здесь один пакет и одно обязательство: **официальный интерфейс, переведённый и
+проверенный**, без гонки за чужими словарями. Нужен конкретный плагин — заведите issue:
+словарь для него возможен как отдельный слой, привязанный к версии, а не как молчаливое
+обещание «покрыто всё».
+
 ## Разработка
 
 ```sh
@@ -66,7 +129,7 @@ npm pack           # -> ragnoryok1-dsh-client-locale-ru-<version>.tgz
 
 ## Содержимое
 
-- `src/client/dicts.ts` — русские словари (52 namespace, 2598 переводов, ~2700 строк). Это и есть основная ценность.
+- `src/client/dicts.ts` — русские словари (52 namespace, 2304 перевода, ~2700 строк). Это и есть основная ценность.
 - `src/client/index.ts` — точка входа клиентского плагина (регистрация `ru` + словарей).
 - `src/index.ts` — пустая host-половина (`apply()`).
 - `cordis.patch.yml` — профиль-патч (`- insert:` клиентской строки `locale-ru`).

package/lib/client.js

@@ -2703,14 +2703,103 @@ window.__ModuleLoader__.load({
 			}
 		};
 		//#endregion
+		//#region src/client/typography.ts
+		/**
+		* Russian screen typography for translated strings.
+		*
+		* The harness locale contract is a flat `Record<string, string>`, so a
+		* language pack cannot reach the composed sentences a component builds from
+		* several keys, and cannot ask the host to insert typography. The rendered DOM
+		* is the one place where every translated string passes through, so this module
+		* rewrites text nodes in place. The rules are deliberately conservative: they
+		* only fire on unambiguous straight-quote and spaced-hyphen patterns, and the
+		* DOM pass skips code, form fields and editable content.
+		*/
+		/** Straight double quotes around a span become Russian guillemets. */
+		const QUOTED = /"([^"\n]{1,200})"/g;
+		/** A spaced hyphen between two words is an em dash in Russian typography. */
+		const SPACED_HYPHEN = /(?<=[\p{L}\p{N}»\)]) - (?=[\p{L}\p{N}«\(])/gu;
+		/** Three dots in running text are an ellipsis. */
+		const ELLIPSIS = /\.{3}(?=\s|$)/g;
+		/** A digit followed by a lowercase letter keeps a non-breaking space. */
+		const NUMBER_UNIT = /(\d) ([а-яё]{1,24})(?![а-яё])/giu;
+		/** Non-breaking space keeps a number attached to a short unit-like token. */
+		const NUMBER_SYMBOL = /(\d) ([%°₽$€£]|кб|КБ|МБ|ГБ)(?=\s|$)/giu;
+		/** Guillemets, em dash, ellipsis, and non-breaking spaces in running text. */
+		function applyRussianTypography(text) {
+			return text.replace(QUOTED, "«$1»").replace(SPACED_HYPHEN, " — ").replace(ELLIPSIS, "…").replace(NUMBER_UNIT, "$1\xA0$2").replace(NUMBER_SYMBOL, "$1\xA0$2");
+		}
+		/** Elements whose text is code, data or user input and must stay verbatim. */
+		const SKIP_SELECTOR = [
+			"code",
+			"pre",
+			"kbd",
+			"samp",
+			"var",
+			"textarea",
+			"input",
+			"select",
+			"option",
+			"[contenteditable]:not([contenteditable=\"false\"])",
+			"[data-typography=\"off\"]"
+		].join(",");
+		/** Text nodes already rewritten, so a later pass leaves them alone. */
+		const processed = /* @__PURE__ */ new WeakSet();
+		/** Whether the node sits inside content that must not be rewritten. */
+		function isSkipped(node) {
+			const element = node.nodeType === Node.ELEMENT_NODE ? node : node.parentElement;
+			return element === null || element.closest(SKIP_SELECTOR) !== null;
+		}
+		function rewriteNode(node) {
+			if (node.nodeType === Node.TEXT_NODE) {
+				if (processed.has(node)) return;
+				processed.add(node);
+				const before = node.data;
+				const after = applyRussianTypography(before);
+				if (after !== before) node.data = after;
+				return;
+			}
+			if (node.nodeType !== Node.ELEMENT_NODE || isSkipped(node)) return;
+			for (const child of node.childNodes) rewriteNode(child);
+		}
+		/**
+		* Start the typography pass on a document and keep it current as the app
+		* renders. Returns a disposer that stops observing.
+		*
+		* @param doc - document whose body carries the rendered interface.
+		* @returns disposer removing the observer.
+		*/
+		function startRussianTypography(doc) {
+			const root = doc.body;
+			if (root === null) return () => {};
+			rewriteNode(root);
+			const observer = new MutationObserver((records) => {
+				for (const record of records) {
+					if (record.type === "characterData") {
+						if (isSkipped(record.target)) continue;
+						rewriteNode(record.target);
+						continue;
+					}
+					for (const added of record.addedNodes) rewriteNode(added);
+				}
+			});
+			observer.observe(root, {
+				childList: true,
+				characterData: true,
+				subtree: true
+			});
+			return () => observer.disconnect();
+		}
+		//#endregion
 		//#region src/client/index.ts
 		/** Required service: the locale registry that owns languages and dictionaries. */
 		const inject = ["locale"];
 		/**
-		* Client plugin body: add `ru` to the selectable language catalog and register
-		* a ru dictionary for every namespace this pack contributes. Registration is
-		* an effect, so the contributed language and dictionaries are torn down with
-		* this plugin's fiber.
+		* Client plugin body: add `ru` to the selectable language catalog, register
+		* a ru dictionary for every namespace this pack contributes, and start the
+		* Russian typography pass. Registration is an effect, so the contributed
+		* language, dictionaries and the typography observer are torn down with this
+		* plugin's fiber.
 		* @param ctx - client root context.
 		*/
 		function apply(ctx) {
@@ -2720,6 +2809,7 @@ window.__ModuleLoader__.load({
 				fallback: "en"
 			}), "locale-ru: language");
 			for (const [ns, dict] of Object.entries(RU_DICTS)) ctx.effect(() => ctx.locale.register(ns, "ru", dict), `locale-ru: ${ns} dictionary`);
+			ctx.effect(() => startRussianTypography(document), "locale-ru: typography");
 		}
 		//#endregion
 		exports.apply = apply;