@goodandready/dsh-tts 0.3.0 → 0.3.2

package/lib/client.js

@@ -239,6 +239,8 @@ window.__ModuleLoader__.load({
     }
 
     function ChainEditor(props) {
+      // Переводчик приходит от карточки: слот отдаёт props.t только ей.
+      const t = props.t || ((key) => key)
       const rows = Array.isArray(props.value) ? props.value : []
       const change = (i, patch) => {
         const next = rows.map((r, k) => (k === i ? Object.assign({}, r, patch) : r))
@@ -259,7 +261,7 @@ window.__ModuleLoader__.load({
           const cred = credOf(props.credentials, row.provider)
           const draft = (props.keyDrafts && props.keyDrafts[row.provider]) || ''
           const badge = !cloud ? null
-            : (!cred.writable ? 'Set in environment' : (cred.configured ? 'Configured' : 'Not set'))
+            : (!cred.writable ? t('fromEnv') : (cred.configured ? t('configured') : t('notSet')))
           return React.createElement('div', { className: 'dts-entry', key: i },
             React.createElement('div', { className: 'dts-row' },
               React.createElement('select', {
@@ -274,9 +276,9 @@ window.__ModuleLoader__.load({
                 className: 'dts-model', value: row.voice || '', disabled: !props.writable,
                 placeholder: 'voice', onChange: (e) => change(i, { voice: e.target.value }),
               }),
-              React.createElement('button', { type: 'button', className: 'dts-mini', title: 'Up', disabled: !props.writable, onClick: () => move(i, -1) }, '\u2191'),
-              React.createElement('button', { type: 'button', className: 'dts-mini', title: 'Down', disabled: !props.writable, onClick: () => move(i, 1) }, '\u2193'),
-              React.createElement('button', { type: 'button', className: 'dts-mini', title: 'Remove', disabled: !props.writable, onClick: () => remove(i) }, '\u00d7'),
+              React.createElement('button', { type: 'button', className: 'dts-mini', title: t('up'), disabled: !props.writable, onClick: () => move(i, -1) }, '\u2191'),
+              React.createElement('button', { type: 'button', className: 'dts-mini', title: t('down'), disabled: !props.writable, onClick: () => move(i, 1) }, '\u2193'),
+              React.createElement('button', { type: 'button', className: 'dts-mini', title: t('remove'), disabled: !props.writable, onClick: () => remove(i) }, '\u00d7'),
             ),
             cloud ? React.createElement('div', { className: 'dts-row' },
               React.createElement('input', {
@@ -290,19 +292,121 @@ window.__ModuleLoader__.load({
               cred.configured && cred.writable ? React.createElement('button', {
                 type: 'button', className: 'dts-link', disabled: !props.writable,
                 onClick: () => props.onClearKey(row.provider),
-              }, 'Clear') : null,
-            ) : React.createElement('span', { className: 'dts-sub' }, 'Local / CLI provider — no API key'),
+              }, t('clear')) : null,
+            ) : React.createElement('span', { className: 'dts-sub' }, t('localProvider')),
             cloud && cred.ref ? React.createElement('span', { className: 'dts-sub' }, 'Stored as ' + cred.ref) : null,
           )
         }),
         React.createElement('div', { className: 'dts-row' },
-          React.createElement('button', { type: 'button', className: 'dts-mini', title: 'Add provider', disabled: !props.writable, onClick: add }, '+'),
-          React.createElement('span', { className: 'dts-sub' }, 'Top to bottom is the fallback order. Cloud keys are saved to the host credentials store, never into plugin settings.'),
+          React.createElement('button', { type: 'button', className: 'dts-mini', title: t('addProvider'), disabled: !props.writable, onClick: add }, '+'),
+          React.createElement('span', { className: 'dts-sub' }, t('chainHint')),
         ),
       )
     }
 
-    function TtsSection() {
+    // Строки карточки живут в реестре локалей: так их переводит отдельный
+    // пакет, не трогая код этого плагина. Английский — язык по умолчанию,
+    // на него же приходится откат, если перевода нет.
+    const en = {
+      'general': 'General',
+      'loading': 'Loading\u2026',
+      'chainHintCard': 'Pick a provider, paste its API key, and Save (or leave the key field). The key is written to the host credentials store immediately. The browser never reads it back.',
+      'speakRepliesHint': 'When on, each finished reply is synthesized on the host and played in this browser. Audio is not sent back to the model.',
+      'chainHint': 'Top to bottom is the fallback order. Cloud keys are saved to the host credentials store, never into plugin settings.',
+      'title': 'Speech',
+      'speakReplies': 'Speak agent replies',
+      'speakAsItGoes': 'Speak as it goes',
+      'speakAsItGoesHint': 'Read each reply the moment it lands, sentence by sentence, instead of waiting for the whole turn.',
+      'rate': 'Playback speed',
+      'rateHint': '0.5 to 2. Synthesis is untouched; the browser plays faster or slower.',
+      'bargeIn': 'Fall silent when you speak',
+      'bargeInHint': 'Stop reading the moment the microphone opens.',
+      'announce': 'Announce approvals',
+      'announceHint': 'Say it out loud and play a chime when the agent stops for an approval or asks a question.',
+      'approvalText': 'Approval wording',
+      'approvalHint': 'Said when an approval is asked for; the tool name is appended.',
+      'questionText': 'Question wording',
+      'questionHint': 'Said when the agent asks a question. Empty disables it.',
+      'chime': 'Chime',
+      'chimeHint': 'ding, beep or none.',
+      'language': 'Language',
+      'languageHint': 'Hint for voices that need a locale (eSpeak, Azure SSML).',
+      'piperModel': 'Piper model path',
+      'piperModelHint': 'Absolute path to an ONNX model. Leave empty to skip Piper.',
+      'piperBin': 'Piper binary',
+      'binHint': 'Looked up in PATH unless absolute.',
+      'espeakBin': 'eSpeak binary',
+      'espeakHint': 'Usually espeak-ng.',
+      'edgeBin': 'edge-tts binary',
+      'edgeHint': 'Python CLI from the edge-tts package.',
+      'azureRegion': 'Azure region',
+      'azureHint': 'Required for the azure provider, e.g. eastus.',
+      'chainTitle': 'Provider chain',
+      'addProvider': 'Add provider',
+      'localProvider': 'Local / CLI provider — no API key',
+      'configured': 'Configured',
+      'notSet': 'Not set',
+      'fromEnv': 'Set in environment',
+      'clear': 'Clear',
+      'remove': 'Remove',
+      'up': 'Up',
+      'down': 'Down',
+      'save': 'Save',
+      'saved': 'Saved',
+      'cardHint': 'Provider chain, voices and playback options.',
+    }
+    const ru = {
+      'general': 'Общее',
+      'loading': 'Загрузка…',
+      'chainHintCard': 'Выберите провайдера, вставьте ключ и нажмите «Сохранить» (или просто уйдите из поля). Ключ сразу попадает в хранилище учётных данных харнесса; браузер его обратно не читает.',
+      'speakRepliesHint': 'Каждый законченный ответ озвучивается на стороне харнесса и играет в этом браузере. Звук модели не отправляется.',
+      'chainHint': 'Порядок сверху вниз — порядок отката. Ключи облачных провайдеров попадают в хранилище учётных данных харнесса, а не в настройки плагина.',
+      'title': 'Озвучка',
+      'speakReplies': 'Читать ответы агента',
+      'speakAsItGoes': 'Читать по ходу',
+      'speakAsItGoesHint': 'Читать каждый ответ, как только он пришёл, предложениями, не дожидаясь конца хода.',
+      'rate': 'Скорость чтения',
+      'rateHint': 'От 0.5 до 2. Синтез не меняется — быстрее или медленнее играет браузер.',
+      'bargeIn': 'Замолкать, когда вы заговорили',
+      'bargeInHint': 'Прекращать чтение, как только открылся микрофон.',
+      'announce': 'Объявлять запрос подтверждения',
+      'announceHint': 'Говорить вслух и подавать сигнал, когда агент остановился ради подтверждения или задал вопрос.',
+      'approvalText': 'Что говорить о подтверждении',
+      'approvalHint': 'Произносится при запросе подтверждения; имя инструмента добавляется следом.',
+      'questionText': 'Что говорить о вопросе',
+      'questionHint': 'Произносится, когда агент задал вопрос. Пусто — не произносить.',
+      'chime': 'Сигнал',
+      'chimeHint': 'ding, beep или none.',
+      'language': 'Язык',
+      'languageHint': 'Подсказка для голосов, которым нужен язык (eSpeak, Azure SSML).',
+      'piperModel': 'Piper: путь к модели',
+      'piperModelHint': 'Абсолютный путь к модели ONNX. Пусто — Piper пропускается.',
+      'piperBin': 'Piper: бинарь',
+      'binHint': 'Ищется в PATH, если путь не абсолютный.',
+      'espeakBin': 'eSpeak: бинарь',
+      'espeakHint': 'Обычно espeak-ng.',
+      'edgeBin': 'edge-tts: бинарь',
+      'edgeHint': 'Консольная утилита из пакета edge-tts.',
+      'azureRegion': 'Azure: регион',
+      'azureHint': 'Нужен провайдеру azure, например eastus.',
+      'chainTitle': 'Цепочка провайдеров',
+      'addProvider': 'Добавить провайдера',
+      'localProvider': 'Локальный провайдер — ключ не нужен',
+      'configured': 'Ключ задан',
+      'notSet': 'Ключа нет',
+      'fromEnv': 'Задан в окружении',
+      'clear': 'Убрать',
+      'remove': 'Удалить',
+      'up': 'Выше',
+      'down': 'Ниже',
+      'save': 'Сохранить',
+      'saved': 'Сохранено',
+      'cardHint': 'Цепочка провайдеров, голоса и параметры чтения.',
+    }
+
+    function TtsSection(props) {
+      // Переводчик приходит от слота, потому что в его записи указан locale.
+      const t = (props && props.t) || ((key) => key)
       const [draft, setDraft] = React.useState(null)
       const [credentials, setCredentials] = React.useState({})
       const [keyDrafts, setKeyDrafts] = React.useState({})
@@ -326,7 +430,7 @@ window.__ModuleLoader__.load({
         return () => { alive = false }
       }, [])
 
-      if (!draft) return React.createElement('div', { className: 'dts-wrap' }, 'Loading\u2026')
+      if (!draft) return React.createElement('div', { className: 'dts-wrap' }, t('loading'))
 
       const setTop = (key, v) => setDraft((d) => Object.assign({}, d || {}, { [key]: v }))
       const setDraftKey = (provider, value) => setKeyDrafts((d) => Object.assign({}, d, { [provider]: value }))
@@ -411,22 +515,23 @@ window.__ModuleLoader__.load({
 
       return React.createElement('div', { className: 'dts-wrap' },
         React.createElement('div', { className: 'dts-block' },
-          React.createElement('div', { className: 'dts-h' }, 'Speech'),
+          React.createElement('div', { className: 'dts-h' }, t('title')),
           React.createElement('label', { className: 'dts-row' },
             React.createElement('input', {
               type: 'checkbox', checked: !!(draft && draft.speakReplies), disabled: !writable,
               onChange: (e) => setTop('speakReplies', e.target.checked),
             }),
-            React.createElement('span', null, 'Speak agent replies'),
+            React.createElement('span', null, t('speakReplies')),
           ),
           React.createElement('div', { className: 'dts-sub' },
-            'When on, each finished reply is synthesized on the host and played in this browser. Audio is not sent back to the model.'),
+            t('speakRepliesHint')),
         ),
         React.createElement('div', { className: 'dts-block' },
-          React.createElement('div', { className: 'dts-h' }, 'Provider chain'),
+          React.createElement('div', { className: 'dts-h' }, t('chainTitle')),
           React.createElement('div', { className: 'dts-sub' },
-            'Pick a provider, paste its API key, and Save (or leave the key field). The key is written to the host credentials store immediately. The browser never reads it back.'),
+            t('chainHintCard')),
           React.createElement(ChainEditor, {
+            t: t,
             value: draft && draft.chain ? draft.chain : [], writable: writable,
             credentials: credentials, keyDrafts: keyDrafts,
             onChange: (v) => setTop('chain', v),
@@ -436,32 +541,58 @@ window.__ModuleLoader__.load({
           }),
         ),
         React.createElement('div', { className: 'dts-block' },
-          React.createElement('div', { className: 'dts-h' }, 'General'),
-          boolField('speakAsItGoes', 'Speak as it goes',
-            'Read each reply the moment it lands, sentence by sentence, instead of waiting for the whole turn.'),
-          numberField('rate', 'Playback speed', '0.5 to 2. Synthesis is untouched; the browser plays faster or slower.', 0.1),
-          boolField('bargeIn', 'Fall silent when you speak',
-            'Stop reading the moment the microphone opens.'),
-          boolField('announceApproval', 'Announce approvals',
-            'Say it out loud and play a chime when the agent stops for an approval or asks a question.'),
-          textField('approvalText', 'Approval wording', 'Said when an approval is asked for; the tool name is appended.'),
-          textField('questionText', 'Question wording', 'Said when the agent asks a question. Empty disables it.'),
-          textField('chime', 'Chime', 'ding, beep or none.'),
-          textField('language', 'Language', 'Hint for voices that need a locale (eSpeak, Azure SSML).'),
-          textField('piperModel', 'Piper model path', 'Absolute path to an ONNX model. Leave empty to skip Piper.'),
-          textField('piperBin', 'Piper binary', 'Looked up in PATH unless absolute.'),
-          textField('espeakBin', 'eSpeak binary', 'Usually espeak-ng.'),
-          textField('edgeBin', 'edge-tts binary', 'Python CLI from the edge-tts package.'),
-          textField('azureRegion', 'Azure region', 'Required for the azure provider, e.g. eastus.'),
+          React.createElement('div', { className: 'dts-h' }, t('general')),
+          boolField('speakAsItGoes', t('speakAsItGoes'),
+            t('speakAsItGoesHint')),
+          numberField('rate', t('rate'), t('rateHint'), 0.1),
+          boolField('bargeIn', t('bargeIn'),
+            t('bargeInHint')),
+          boolField('announceApproval', t('announce'),
+            t('announceHint')),
+          textField('approvalText', t('approvalText'), t('approvalHint')),
+          textField('questionText', t('questionText'), t('questionHint')),
+          textField('chime', t('chime'), t('chimeHint')),
+          textField('language', t('language'), t('languageHint')),
+          textField('piperModel', t('piperModel'), t('piperModelHint')),
+          textField('piperBin', t('piperBin'), t('binHint')),
+          textField('espeakBin', t('espeakBin'), t('espeakHint')),
+          textField('edgeBin', t('edgeBin'), t('edgeHint')),
+          textField('azureRegion', t('azureRegion'), t('azureHint')),
         ),
         React.createElement('div', { className: 'dts-row' },
-          React.createElement('button', { type: 'button', className: 'dts-save', disabled: !writable, onClick: save }, 'Save'),
-          saved ? React.createElement('span', { className: 'dts-ok' }, 'Saved') : null,
+          React.createElement('button', { type: 'button', className: 'dts-save', disabled: !writable, onClick: save }, t('save')),
+          saved ? React.createElement('span', { className: 'dts-ok' }, t('saved')) : null,
           err ? React.createElement('span', { className: 'dts-bad' }, err) : null,
         ),
       )
     }
 
+
+    // Карточка настроек во вкладке «Плагины»: заголовок, пояснение и
+    // сворачивание рисуем сами — ядро даёт только рамку списка.
+    function TtsCard(props) {
+      const t = (props && props.t) || ((key) => key)
+      const [open, setOpen] = React.useState(false)
+      return React.createElement('div',
+        {
+          className: 'dts-wrap',
+          style: { border: '1px solid var(--dsw-alias-border-l2)', borderRadius: '8px', marginBottom: '10px' },
+        },
+        React.createElement('button',
+          {
+            type: 'button',
+            'aria-expanded': open ? 'true' : 'false',
+            onClick: () => setOpen((v) => !v),
+            style: { display: 'flex', width: '100%', gap: '8px', alignItems: 'baseline', background: 'none', border: 'none', padding: '10px 12px', cursor: 'pointer', textAlign: 'left' },
+          },
+          React.createElement('strong', null, t('title')),
+          React.createElement('span', { className: 'dts-sub' }, t('cardHint')),
+          React.createElement('span', { style: { marginLeft: 'auto', color: 'var(--dsw-alias-label-secondary)' } }, open ? '\u25be' : '\u25b8'),
+        ),
+        open ? React.createElement(TtsSection, props) : null,
+      )
+    }
+
     // Кнопка в строке ввода: видно, что сейчас читается, и можно остановить.
     function SpeakerControl() {
       const p = usePlayer()
@@ -491,18 +622,51 @@ window.__ModuleLoader__.load({
     }
 
     function registerSettings(ctx) {
+      ctx.effect(() => ctx.locale.register(NS, { en, ru }), 'dsh-tts: словари')
+      // Подпись раздела рисует боковой список, а не наш компонент: props.t
+      // туда не доходит, поэтому берём переводчик, привязанный к namespace.
+      const t = ctx.locale.bind(NS)
+      // Штатное место настроек — карточка во вкладке «Настройки плагинов».
+      // Вкладка перебирает пространства настроек и ищет слот по entryKey,
+      // равному имени пространства: ключ обязан равняться NS, иначе карточка
+      // не появится молча, без единой ошибки в журнале.
+      let moved = false
+      try {
+        moved = !!ctx.slots.inject('settings.plugin.item', () => ctx.slots.register(
+          {
+            name: 'settings.plugin.item',
+            key: NS,
+            locale: NS,
+            inject: () => ({ ctx: ctx }),
+          },
+          TtsCard,
+        ))
+      } catch (noPluginItemSlot) { moved = false }
+      if (moved) return
+      // Запасной путь для сборок без settings.plugin.item: прежний раздел
+      // в боковом списке, чтобы настройки не пропали.
       ctx.slots.inject('settings.section', () => ctx.slots.register(
-        { name: 'settings.section', id: '@goodandready/dsh-tts', order: 32, label: () => 'Speech', inject: () => ({ ctx: ctx }) },
+        {
+          name: 'settings.section',
+          id: '@goodandready/dsh-tts',
+          order: 32,
+          locale: NS,
+          label: () => t('title'),
+          inject: () => ({ ctx: ctx }),
+        },
         TtsSection,
       ))
     }
 
-    exports.inject = ['slots']
+    exports.inject = ['slots', 'locale']
     exports.apply = function apply(ctx) {
       registerSettings(ctx)
       registerSpeaker(ctx)
       ctx.effect(() => listenForVoice(), 'dsh-tts: замолкать, когда человек заговорил')
-      setInterval(pollPending, 1000)
+      ctx.effect(() => {
+        const timer = setInterval(pollPending, 1000)
+        return () => clearInterval(timer)
+      }, 'dsh-tts: опрос готовых озвучек')
     }
     return module.exports
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-tts",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Text-to-speech for DeepSeek Harness: speak agent replies in the Web UI with a provider fallback chain (OpenAI, ElevenLabs, Google, Azure, Groq, Deepgram, OpenRouter, Edge, Piper, eSpeak).",
   "license": "MIT",
   "type": "module",