tensorgrid-ui 1.0.0

package/LICENSE

@@ -0,0 +1,95 @@
+TENSOR GRID — Proprietary Software License
+Copyright (c) 2026 TENSOR GRID. All rights reserved.
+
+ENGLISH TEXT GOVERNS. The Russian translation below is informational only.
+
+1. GRANT
+
+   Subject to the terms below, you are granted a non-exclusive,
+   non-transferable, revocable right to install and use this software,
+   unmodified, for your own purposes, including inside a commercial
+   organization.
+
+2. RESTRICTIONS
+
+   You may NOT:
+
+   a) redistribute, publish, sell, rent, lease, or sublicense this
+      software or any part of it, whether modified or not;
+   b) create derivative works for distribution to third parties;
+   c) remove or alter any copyright, trademark, or attribution notice;
+   d) use the name "TENSOR GRID", its logo, or any confusingly similar
+      mark to identify your own product.
+
+   Inspecting the source in order to use the software, verify its
+   behaviour, or ensure its security is expressly permitted.
+
+3. RESERVED RIGHTS
+
+   All rights not expressly granted are reserved by the copyright
+   holder. This license grants no rights in any patent or trademark.
+
+4. THIRD-PARTY SOFTWARE
+
+   This software runs on DeepSeek Harness and other components
+   distributed under their own licenses. Nothing in this license alters
+   the terms of those components, and nothing here grants rights in
+   them.
+
+5. NO WARRANTY
+
+   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 COPYRIGHT HOLDER BE LIABLE
+   FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM THE USE OF
+   THIS SOFTWARE.
+
+6. TERMINATION
+
+   This license terminates automatically if you breach any of its
+   terms. On termination you must stop using the software and remove
+   all copies.
+
+────────────────────────────────────────────────────────────────────────
+
+ПЕРЕВОД (справочный; юридическую силу имеет английский текст выше)
+
+1. ЧТО РАЗРЕШЕНО
+
+   Устанавливать и использовать эту программу в неизменённом виде для
+   своих целей, в том числе внутри коммерческой организации.
+
+2. ЧТО ЗАПРЕЩЕНО
+
+   а) распространять, публиковать, продавать, сдавать в аренду или
+      передавать по сублицензии — как есть или изменённой;
+   б) создавать производные версии для передачи третьим лицам;
+   в) удалять или изменять указания об авторстве и правах;
+   г) использовать название «TENSOR GRID», его логотип или сходное до
+      смешения обозначение для собственного продукта.
+
+   Изучать исходный код, чтобы пользоваться программой, проверять её
+   поведение или убедиться в её безопасности, — разрешено прямо.
+
+3. ОСТАЛЬНЫЕ ПРАВА
+
+   Все права, не переданные явно, сохраняются за правообладателем.
+   Права на патенты и товарные знаки этой лицензией не передаются.
+
+4. ЧУЖИЕ КОМПОНЕНТЫ
+
+   Программа работает поверх DeepSeek Harness и других компонентов,
+   распространяемых по собственным лицензиям. Эта лицензия их условий
+   не меняет и прав на них не даёт.
+
+5. БЕЗ ГАРАНТИЙ
+
+   Программа поставляется «как есть». Правообладатель не отвечает за
+   любые убытки, связанные с её использованием.
+
+6. ПРЕКРАЩЕНИЕ
+
+   Лицензия прекращается автоматически при нарушении любого из её
+   условий. После этого использование должно быть прекращено, а копии
+   удалены.

package/README.md

@@ -0,0 +1,486 @@
+# Obsidian / Ion
+
+Клиентский UI-пакет для веб-клиента DeepSeek Harness: футуристичная палитра
+из 13 токенов темы плюс живой ambient-слой над фреймом.
+
+Это **долговечная** форма дизайна. Динамический Cordis-плагин (`obsid-1`)
+существует только в текущем процессе и исчезает при перезапуске; этот пакет
+живёт файлом и монтируется при каждом старте профиля.
+
+## Из чего состоит
+
+| Файл | Роль |
+|---|---|
+| `package.json` | секция `dsh.client` — по ней рантайм понимает, что у пакета есть браузерная половина |
+| `lib/index.js` | host-половина: пустая по существу, нужна как строка композиции |
+| `lib/client.js` | браузерная половина: палитра, стили, компонент слоя |
+
+`lib/client.js` написан руками в том же формате, что и поставочные
+`@deepseek-ai/dsh-client-ui-*`: регистрация в `window.__ModuleLoader__`,
+зависимости через `require`, экспорт `apply` и `inject`. Сборщик не нужен.
+
+## Что пакет занимает
+
+Только **аддитивные** слоты — те, у которых `replaceRisk: none`. Ни один
+поставочный компонент не замещается, поэтому улучшения dsh продолжают
+доезжать до интерфейса. Это условие закреплено в тесте белым списком.
+
+| Слот | Вид | Что даёт |
+|---|---|---|
+| `shell.overlay` | list | ambient-слой: сферы, проход, кромка, зерно, виньетка, отклик |
+| `settings.general.item` | list | строка «Атмосфера» — регулятор интенсивности |
+| `settings.general.item` | list | строка «Акцент» — выбор ведущего тона |
+| `conversation.input.dock` | list | невидимый драйвер отклика на работу агента |
+| `conversation.hero.brand.mark` | single | знак на экране пустой сессии |
+
+Плюс слой переопределения токенов через `theme.overrideTokens` — публичный
+метод сервиса темы.
+
+### Две CSS-переменные вместо связи компонентов
+
+- `--dsx-intensity` — пользовательский регулятор (0 / 0.5 / 1 / 1.7),
+  умножает непрозрачность всех слоёв. Хранится в `localStorage`.
+- `--dsx-activity` — 0 в покое, 1 пока идёт ход агента.
+- `--dsx-accent-rgb` и `--dsx-accent2-rgb` — ведущий тон и контрапункт
+  выбранного акцента, тройками каналов для `rgba(var(…), α)`.
+
+Смена акцента бьёт по двум сторонам сразу: свечение ведут переменные, а
+`--dsw-alias-brand-primary` переписывается повторным вызовом
+`overrideTokens` с тем же источником — служба документирует это как замену
+всего слоя целиком.
+
+Переменная на `documentElement` — единственный мост между двумя поддеревьями:
+ambient-слой живёт в корневом `shell.overlay`, у которого нет сессии, а хук
+`useSession` раздаётся только сессионным слотам. Драйвер сидит в сессионном
+слоте, ничего не рисует и лишь ведёт переменную.
+
+### Почему нет своих карточек инструментов
+
+`tool.call.toolview` ключуется именем инструмента, и механизм сохранения
+дочерних слотов существует: в опциях регистрации есть `children`, а
+компонент получает `renderSlot` — так поставочная строка `read_image`
+объявляет себе `tool.call.images`. То есть технически заменить карточку,
+ничего не потеряв, можно.
+
+Отказ по другой причине. Владельческие пропсы — `{ callId, toolName, block,
+openFile, cwd, home, loadImage, inspect }`, и вся суть карточки в разборе
+`block`: варианты, заголовок, вывод, ошибки, diff, терминал, поиск, файл.
+Своя карточка обязана воспроизвести этот разбор и застывает на сегодняшней
+форме внутренней структуры. Это ровно тот случай замороженной копии, ради
+исключения которого пакет и держится аддитивных слотов.
+
+### Почему тема не регистрируется через theme.register
+
+`ThemeDefinition` пиннит одну `colorScheme`, поэтому выбор такой темы ломает
+режим «следовать системе». Слой переопределения несёт пару значений на
+каждый токен и переключение схемы переживает сам. Вдобавок поставочная
+строка «Оформление» знает ровно три значения — `appearance.light`,
+`appearance.dark`, `appearance.system` — и отрисовать стороннюю тему не
+может. Регистрация темы была бы регрессом, а не улучшением.
+
+## Установка одной командой
+
+```powershell
+git clone https://github.com/tayyarg07/tensorgrid-ui.git
+cd tensorgrid-ui
+.\install.ps1
+```
+
+Установщик проверит Node.js и dsh (поставит, если нет), создаст профиль,
+разложит пакет, патч-слой и агент-пресет, заведёт автозапуск и проверит,
+что всё на месте. Тем же файлом обновляют: он повторно запускаемый и
+чужого не трогает — настройки, ключи и историю сессий не переписывает.
+
+| Ключ | Что делает |
+|---|---|
+| `-DryRun` | показать план, ничего не меняя |
+| `-NoAutostart` | не заводить автозапуск при входе в Windows |
+| `-ProfileId <имя>` | другой идентификатор профиля и пресета |
+
+Ниже — то же самое вручную, если нужно понимать каждый шаг.
+
+## Что у меня стоит и не отстало ли
+
+```powershell
+.\status.ps1
+```
+
+Ничего не меняет, только смотрит. Отвечает на четыре вопроса, которые
+иначе выясняются перепиской: версия dsh и есть ли новее, версия продукта и
+не отстала ли от репозитория, все ли части на месте, работает ли
+приложение прямо сейчас и на том ли профиле.
+
+Ключ `-Offline` пропускает обращение к npm.
+
+### Про метку `latest` в npm
+
+Она указывает на `0.1.5-rc.1`, тогда как `0.1.5-rc.2` опубликован позже, —
+обычное дело для предрелизов. Поэтому установщик ставит **закреплённую**
+версию из `env/snapshot.json`, а не `latest`: иначе сотрудник получил бы
+версию старше той, на которой продукт проверялся.
+
+`status.ps1` показывает обе и подсвечивает расхождение.
+
+### Обновления приходят с двух сторон
+
+| Откуда | Что | Как применяется |
+|---|---|---|
+| **от вас** | новый коммит в репозитории | `git pull` + `install.ps1` |
+| **от DeepSeek** | новая версия dsh в npm | `npm install -g "@deepseek-ai/dsh@X"` |
+
+Каналы независимы, но не безобидны по отдельности. Опасен **второй без
+первого**: пакет опирается на контракты dsh — имена слотов, методы
+сервисов, пространства имён перевода. Если обновить dsh, не переснимая
+снимок и не прогоняя тест, поломка обнаружится у сотрудника.
+
+Поэтому **обновление dsh должно приходить через вас**: вы проверяете новую
+версию и выпускаете версию продукта с отметкой «проверено на такой-то».
+Установщик ставит закреплённую версию из `env/snapshot.json`, а не
+`latest`, — сотрудник не получит непроверенный dsh случайно.
+
+### Порядок выпуска
+
+Когда вышла новая версия dsh:
+
+```powershell
+npm install -g "@deepseek-ai/dsh@<новая>"   # 1. поставить у себя
+.\verify.ps1                                 # 2. прогнать всю цепочку
+git diff env/snapshot.json                   # 3. посмотреть, что изменилось
+# 4. починить, если что-то отвалилось
+git commit -am "проверено на dsh <новая>"    # 5. зафиксировать
+git push                                     # 6. выпустить
+```
+
+`verify.ps1` — единственная проверка, которую нужно помнить перед
+выпуском. Она прогоняет всё в правильном порядке и **останавливается на
+первом провале**: сверяет версию dsh со снимком, переснимает окружение,
+обновляет эталон строк, проверяет связность перевода, пересобирает
+словари, гоняет 143 проверки контракта и смотрит, всё ли зафиксировано.
+
+Порядок шагов не случаен: снимок снимается **до** проверки контракта,
+потому что тест сверяется именно с ним.
+
+### Обновление без новой версии dsh
+
+Автоматического обновления нет ни у dsh, ни у продукта, и никто не
+уведомляет о новых версиях — это проверено, а не предположено.
+
+```powershell
+git pull          # забрать новую версию продукта
+.\install.ps1     # применить; профиль и настройки не трогаются
+```
+
+Обновление самого dsh — отдельно и вручную:
+
+```powershell
+npm install -g "@deepseek-ai/dsh@<версия>"
+```
+
+После него стоит переснять снимок окружения и посмотреть, что изменилось
+(см. раздел «После обновления dsh»).
+
+## Установка вручную
+
+Единица приложения — **профиль**, а не пакет. Профиль задаёт, какие бандлы
+составляют сборку, и добавляет поверх них свои строки. Поставочный профиль
+`web` при этом не трогается и остаётся запасным вариантом.
+
+Всё лежит в `~/.dsh/`, который не перезаписывается обновлением dsh —
+в отличие от каталога установки `node_modules/@deepseek-ai/dsh`.
+
+1. Создать профиль из поставочного шаблона. Флаг `--dump-config` заставляет
+   команду создать профиль и выйти, не поднимая сервер:
+
+   ```
+   dsh --profile tensorgrid --from-default-profile web --dump-config
+   ```
+
+2. Скопировать пакет (каталоги разработки в рантайме не нужны):
+
+   ```powershell
+   robocopy <источник> "$env:USERPROFILE\.dsh\profiles\tensorgrid\packages\dsh-ui-obsidian-ion" `
+     /MIR /XD locale test tools /NFL /NDL /NJH /NJS
+   ```
+
+3. Положить патч-слой профиля — готовый файл лежит в репозитории:
+
+   ```
+   profile/cordis.patch.yml  →  ~/.dsh/profiles/tensorgrid/cordis.patch.yml
+   ```
+
+   Его содержимое:
+
+   ```yaml
+   - insert:
+       - id: ui-obsidian-ion
+         name: './packages/dsh-ui-obsidian-ion/lib/index.js'
+   ```
+
+   Указывать нужно **файл host-половины, а не каталог**: спецификатор
+   разрешается штатным ESM-резолвом, а тот не умеет импортировать каталог.
+   Прецедент такого подключения есть и в поставке — профиль `claude`
+   монтирует локальный пакет строкой
+   `name: './packages/dsh-claude-subscription/index.mjs'`.
+
+4. Положить агент-пресет:
+
+   ```
+   preset/  →  ~/.dsh/.agent-presets/tensorgrid/
+   ```
+
+   Профиль задаёт **приложение** — какие бандлы его составляют. Пресет
+   задаёт **агента** — его персону, набор инструментов и делегирование.
+   Это две разные плоскости, и живут они в разных местах.
+
+5. Запустить:
+
+   ```
+   dsh --profile tensorgrid
+   ```
+
+   Пресет выбирается в интерфейсе, в настройках агента: в списке появится
+   «TENSOR GRID» рядом с поставочными.
+
+### Проверка установки
+
+Профиль можно поднять на свободном порту, не мешая уже запущенному:
+
+```
+dsh --profile tensorgrid --port 3081 --no-open
+```
+
+Команда напечатает адрес с токеном. Две проверки по нему:
+
+- `GET /favicon.svg` обязан вернуть SVG с `aria-label="TENSOR GRID"` —
+  значит host-половина заняла маршрут;
+- в HTML страницы (с токеном) обязано встречаться `dsh-ui-obsidian-ion` —
+  значит пакет попал в загрузочный граф `__DSH_BOOT__` и клиентская
+  половина будет загружена.
+
+### Откат
+
+`dsh web` поднимает стоковый интерфейс. Удаление продукта — удалить каталог
+`~/.dsh/profiles/tensorgrid`.
+
+## Что проверено, а что нет
+
+**Проверено по живому рантайму:**
+
+- контракт `window.__ModuleLoader__.load({ id, factory })` и экспорт
+  `apply`/`inject` — снято с `@deepseek-ai/dsh-client-ui-brand-official`;
+- способ вставки CSS тегом `<style data-plugin-css>` — снят с
+  `@deepseek-ai/dsh-client-ui-layout`;
+- имена и требования всех 13 токенов — через `Theme.listTokens`;
+- контракт слота `shell.overlay` (list, `replaceRisk: none`) — через
+  `Slots.listSubTree`;
+- сам дизайн работает: он уже запущен как динамический Package `obsid-1/pkg-2`.
+
+- **обнаружение пакета** — прослежено по коду
+  `@deepseek-ai/dsh-client-modules` (`lib/index.js`, `locatePkgJson` /
+  `nearestPackage` / `resolveMeta`). Цепочка для нашей строки:
+
+  1. спецификатор начинается с `.` → считается путём;
+  2. резолвится через ту же ESM-резолюцию, что импортировала host-половину;
+  3. `nearestPackage()` идёт вверх от файла до ближайшего `package.json`.
+     Имя заранее не ожидается, поэтому подходит **любое** — пакету не нужно
+     быть разрешимым в `node_modules`, workspace и `dependencies` не нужны;
+  4. `dsh.client.platform` должен быть ровно `"web"`;
+  5. `exports["./client"]` принимается и строкой, и объектом с `default`;
+  6. путь бандла = `dirname(package.json) + exports["./client"]`.
+
+- **исполнение бандла** — `node test/smoke.mjs`, 47 проверок. Секция про
+  манифест проверена негативным контролем: при `platform: "node"` и снятом
+  `exports["./client"]` тест валится на четырёх проверках.
+
+**Не проверено запуском:**
+
+- фактическая отрисовка в браузере.
+
+### Почему загрузку нельзя проверить со стороны Host
+
+Хотелось бы спросить рантайм «применились ли мои токены», но такого ответа
+нет:
+
+- маршрут `/plugins/<id>/client.js` требует токен авторизации, снаружи
+  отдаёт 401/404;
+- `theme.getTheme()` возвращает `{ preference, fontSize, active, themes,
+  revision }`, где `active.tokens` — карта токенов *определения темы*
+  (у встроенных тем пустая). Переопределения из `overrideTokens` лежат
+  отдельным слоем, который снимок не публикует;
+- динамический клиентский плагин по устройству песочницы не имеет ни
+  `document`, ни `window`, поэтому прочитать вычисленную CSS-переменную
+  или найти вставленный тег стилей нельзя.
+
+Что проверяется со стороны Host — это регистрация: сервис `clientModules`,
+метод `clientPath(id)`. Если он возвращает путь к `lib/client.js` внутри
+профиля, значит манифест найден и принят. Остальное показывает только
+перезагрузка страницы.
+
+## Агент-пресет
+
+`preset/` — копия поставочного `standard`, сделанная штатной службой
+`agentPresets`. Поставочные пресеты править нельзя: их затирает обновление
+dsh, а порча `cordis` отключила бы саму возможность авторства пресетов.
+
+Отличий от поставки немного — 47 добавленных строк и 3 убранных:
+
+- **persona** брендирована и задаёт язык ответа;
+- **делегирование в Codex и Claude Code** снабжено инструкцией включения.
+
+Всё остальное дословно как в поставке — чтобы при обновлении dsh diff
+показал ровно то, что изменили авторы, и это было легко перенести.
+
+### Переключение харнесса
+
+Агент может отдавать задачу наружу — в Codex или Claude Code, которые
+работают под капотом как отдельные продукты. Интерфейс, история сессий и
+брендинг остаются нашими.
+
+Заменить **главный** цикл агента так нельзя: `agent-loop` регистрирует одну
+фабрику и падает на второй. Это делегирование, а не подмена.
+
+Включается в таком порядке:
+
+```
+dsh plugin --profile tensorgrid add @deepseek-ai/dsh-subagent-codex
+dsh plugin --profile tensorgrid add @deepseek-ai/dsh-subagent-claude-code
+```
+
+затем перезапуск dsh, затем снять `disabled: true` с нужной строки в
+`preset/agent.cordis.yml`, затем авторизоваться в самом продукте —
+установка бандла аккаунт не заводит.
+
+Порядок не случаен: наличие провайдера на Host само по себе прав не даёт, а
+снятый `disabled` без установленного бандла уронит ряд.
+
+### Проверка пресета
+
+Композиция проверяется до запуска сессии — через `agentPresets.resolve()` и
+`standingKeyFor()`. Если пресет сломан, они скажут об этом сразу, а не
+молчаливым отсутствием инструментов в сессии.
+
+## Эксплуатация
+
+### Запуск и перезапуск
+
+```
+dsh web
+```
+
+Перезапуск — закрыть окно (или `Ctrl+C`) и запустить снова. Автозапуск при
+входе в Windows настроен файлом `DeepSeek Harness.cmd` в папке
+`shell:startup`; чтобы отключить — удалить его.
+
+| Команда | Что делает |
+|---|---|
+| `dsh --profile web --dump-config` | показать собранное дерево плагинов |
+| `dsh plugin --profile web add <пакет>` | поставить плагин в профиль |
+| `dsh --version` | версия |
+
+### После обновления dsh
+
+Переустанавливать ничего не нужно: `npm update -g @deepseek-ai/dsh` меняет
+только каталог установки, а пакет и строка композиции лежат в `~/.dsh/`.
+При первом же запуске всё смонтируется само.
+
+Но контракты, на которые опирается пакет, могли сдвинуться. Проверка:
+
+```
+cd C:\тест\dsh-ui-obsidian-ion
+node tools/extract-locales.mjs   # обновить эталон, увидеть новые ключи
+node tools/audit-ru.mjs          # связность перевода
+node tools/build-ru.mjs          # пересобрать словари
+node test/smoke.mjs              # 139 проверок контракта
+```
+
+Новые строки интерфейса, которых нет в русском словаре, покажутся
+по-английски — это штатный фолбэк, а не поломка.
+
+### Синхронизация в профиль
+
+```powershell
+robocopy C:\тест\dsh-ui-obsidian-ion `
+  "$env:USERPROFILE\.dsh\profiles\web\packages\dsh-ui-obsidian-ion" `
+  /MIR /XD locale test tools /NFL /NDL /NJH /NJS
+```
+
+Каталоги `locale`, `test` и `tools` в рантайме не нужны и исключены.
+Правка `lib/client.js` подхватывается обновлением страницы; правка
+`lib/index.js` (host-половина) требует перезапуска `dsh` — модуль кешируется.
+
+## Цикл правок
+
+Источник истины — копия в рабочем каталоге; в профиле лежит рабочая копия.
+
+1. Править `lib/client.js` здесь.
+2. Прогнать `node test/smoke.mjs`. Файл уезжает в браузер как есть — ни
+   сборщик, ни тайпчекер его не смотрят, поэтому опечатка ломает загрузку
+   молча. Тест исполняет бандл в Node с подставными `window`, `document` и
+   `require` и проверяет: регистрацию в `__ModuleLoader__`, экспорт
+   `apply`/`inject`, вставку тега стилей, все 13 токенов со светлой и тёмной
+   парой, занятие слота `shell.overlay`, гашение `pointer-events` на слоях,
+   совпадение имён классов в разметке и CSS, определённость всех
+   `@keyframes` и отсутствие неиспользуемых.
+3. Скопировать каталог в профиль (каталог `test/` в рантайме не нужен).
+4. Обновить страницу. Путь к бандлу кэшируется, содержимое — нет: граф
+   пересобирается на загрузке страницы и отдаёт свежий файл.
+
+Перезапуск профиля не нужен даже при правке `cordis.patch.yml`: у профиля
+`web` выставлен `patchReload: live`.
+
+## Откат
+
+### Вернуть предыдущую установку
+
+```powershell
+.\rollback.ps1 -List    # какие копии есть
+.\rollback.ps1          # вернуть самую свежую
+.\rollback.ps1 -To 2026-09-14_22-32-41
+```
+
+`install.ps1` перед каждой перезаписью складывает текущее состояние в
+`~/.dsh/profiles/<id>/.backup/<дата>/` — пакет, патч-слой, пресет и отметку
+об установке. Хранятся три последние копии.
+
+**Git для этого не нужен.** Если обновление сломало интерфейс, чинить надо
+быстро, а не разбираться с репозиторием; у сотрудника git может быть вовсе
+не настроен.
+
+Откат возвращает ровно три вещи: пакет, патч-слой и пресет. Настройки,
+ключи и история сессий не трогаются — они не входят в установку и от неё
+сломаться не могли.
+
+**Версию dsh откат не меняет**: она глобальная и общая для всех профилей,
+включая стоковый `web`. Скрипт лишь сообщит, если сохранённая копия
+ставилась на другой версии, и подскажет команду.
+
+### Выключить продукт целиком
+
+Убрать строку из `cordis.patch.yml` — перезапуск не нужен. Оба эффекта
+(токены и слой) сняты диспозерами, следов не остаётся.
+
+Стоковый интерфейс всегда доступен командой `dsh web`.
+
+### Удалить полностью
+
+Удалить каталог профиля `~/.dsh/profiles/<id>` и каталог пресета
+`~/.dsh/.agent-presets/<id>`.
+
+## Почему здесь нет mix-blend-mode
+
+Первая версия полагалась на `mix-blend-mode: screen`, рассчитывая, что
+свечение сложится с фоном приложения и само погаснет на светлой теме. Это
+не работает: контейнер слота `shell.overlay` объявлен с `z-index: 20`,
+то есть создаёт изолированный контекст наложения, и смешивание происходит
+не с приложением, а с прозрачным фоном самого контейнера.
+
+Поэтому режимы наложения убраны как мёртвый код, а различие тем берётся из
+штатного контракта самой темы — атрибута `data-ds-dark-theme` на `body`.
+Его выставляет bootstrap-скрипт `ui-theme` ещё до монтирования плагинов и
+дальше поддерживает `ThemePresenter` из `ui-layout`. Базовые правила в
+`client.js` рассчитаны на светлую тему и сдержанны; селекторы
+`body[data-ds-dark-theme] …` поднимают интенсивность для тёмной.
+
+Это единственная опора на DOM приложения, и она сознательная: атрибут —
+объявленный интерфейс темы, а не внутреннее имя класса, которое сменится
+при следующей сборке.