@goodandready/dsh-image-gen 0.10.3 → 0.10.5

package/README.md

@@ -45,6 +45,8 @@
 ## 🛠️ Complete Tools Reference
 
 * **`generate_image`**: Generate images with pluggable providers, seeds, aspect ratios, and style presets.
+* **`edit_image`**: Targeted inpainting and modification with automatic session reference resolution (#142, #144, #145).
+* **`vary_image`**: Controlled variation generation preserving composition (#143, #144).
 * **`remove_background`**: Extract subject with transparent PNG output (FAL BiRefNet / Rembg).
 * **`upscale_image`**: 2x / 4x super-resolution with clarity reconstruction.
 * **`vectorize_image`**: Convert raster graphics to clean scalable SVG vectors with palette quantization.
@@ -52,9 +54,22 @@
 * **`generate_image_pack`**: Simultaneous multi-aspect ratio rendering with graceful partial recovery.
 * **`compare_images`**: Pixel-level visual difference ratio comparison.
 * **`inspect_image_quality`**: Automated visual audit, Laplacian sharpness scoring, and defect detection.
+* **`extract_design_tokens`**: Extract CSS Variables, Tailwind color palettes, and W3C Design Tokens from concept art (#172).
+* **`image_to_css_gradient`**: Generate lightweight pure CSS Mesh / Radial / Linear gradients (< 1KB) from image colors (#174).
+* **`check_image_contrast`**: Evaluate background luminance and WCAG 2.1 AA/AAA contrast for text with scrim suggestions (#175).
+* **`optimize_vector_svg`**: Clean and sanitize SVG, normalize viewBox, and export ready-to-use React TSX components (#176).
+* **`generate_pwa_icon_suite`**: Generate full PWA icon sets, HTML meta tags, and web app manifest.json (#190).
 
 ---
 
+
+## 🚀 Updates in v0.10.4: Cordis Lifecycle, Full Settings GUI, and i18n
+- **Cordis Lifecycle (#136)**: wrapped all 7 tool registrations in `ctx.effect` for proper disposal on reload.
+- **Settings GUI Completeness (#137)**: exposed fields for Replicate, SeaDream, Gemini, Local ComfyUI/A1111, style presets, and LLM enhancer.
+- **Package Manifest (#138)**: declared kernel `peerDependencies` (`host-webserver`, `settings`, `llm`, `system-prompt`).
+- **React Cleanup (#139)**: removed dead state hooks from `FalImageCard`.
+- **Complete Localization (#140)**: eliminated hardcoded strings, wiring comprehensive dictionaries for en, ru, and zh.
+
 ## 🎨 Supported Generation Backends
 
 * **`fal`** (Default): FAL.ai queue for FLUX.1, SDXL, Clarity Upscaler, and BiRefNet.

package/README.ru.md

@@ -45,6 +45,8 @@ graph LR
         T6[generate_image_pack]
         T7[compare_images]
         T8[inspect_image_quality]
+        T9[edit_image]
+        T10[vary_image]
     end
 
     subgraph Core [🛡️ Ядро надежности и кэша]
@@ -90,6 +92,8 @@ graph LR
 | Инструмент | Назначение | Ключевые параметры |
 |---|---|---|
 | **`generate_image`** | Генерация изображения по тексту | `prompt`, `image_size`, `seed`, `style`, `negative_prompt`, `count` |
+| **`edit_image`** | Направленное редактирование / inpainting с авто-поиском оригинала (#142, #144, #145) | `prompt`, `image` (по умолч. `latest`), `mask`, `strength` |
+| **`vary_image`** | Генерация вариаций существующей картинки (#143, #144) | `image` (по умолч. `latest`), `prompt`, `variation_strength` (0.1–0.9), `count` |
 | **`remove_background`** | Удаление фона с сохранением прозрачного PNG | `image`, `model`, `output_name` |
 | **`upscale_image`** | Увеличение разрешения в 2x / 4x с детализацией | `image`, `scale` (2/4), `prompt`, `creativity` |
 | **`vectorize_image`** | Векторизация растра в чистый SVG с квантованием палитры | `image`, `color_mode`, `paletteSize` |
@@ -111,6 +115,14 @@ graph LR
 
 ---
 
+
+## 🚀 Обновления v0.10.4: жизненный цикл Cordis, полнота настроек и интернационализация
+- **Жизненный цикл Cordis (#136)**: регистрация всех 7 инструментов обёрнута в `ctx.effect` для штатной отписки при перезагрузке плагина.
+- **Полнота настроек в GUI (#137)**: в карточку настроек добавлены поля для Replicate, SeaDream, Gemini, Local ComfyUI/A1111, пресетов стилей и LLM-улучшителя.
+- **Манифест зависимостей (#138)**: в `peerDependencies` задекларированы все используемые службы ядра (`host-webserver`, `settings`, `llm`, `system-prompt`).
+- **Оптимизация компонентов (#139)**: из `FalImageCard` удалён неиспользуемый мёртвый стейт.
+- **100% интернационализация (#140)**: устранены захардкоженные русские строки, добавлены переводы на русский, английский и китайский языки.
+
 ## 🎨 Поддерживаемые провайдеры генерации
 
 * **`fal`** *(дефолт)*: Сверхбыстрая очередь FAL.ai (`FLUX.1-schnell`, `FLUX-dev`, `SDXL`, BiRefNet, Clarity Upscaler).

package/README.zh.md

@@ -37,6 +37,14 @@
 
 ---
 
+
+## 🚀 v0.10.4 更新：Cordis 生命周期、完整设置界面与国际化
+- **Cordis 生命周期 (#136)**：将所有 7 个工具注册包装在 `ctx.effect` 中，以便在热重载时正常释放。
+- **设置界面完整性 (#137)**：添加了 Replicate、SeaDream、Gemini、本地 ComfyUI/A1111、风格预设和 LLM 增强器的配置字段。
+- **包清单依赖 (#138)**：在 `peerDependencies` 中补齐了内核服务依赖。
+- **React 组件优化 (#139)**：从 `FalImageCard` 中移除了未使用的无用状态。
+- **全面国际化 (#140)**：消除了硬编码文本，为中、英、俄语提供完整翻译。
+
 ## 📦 安装
 
 ```bash

package/lib/client.js

@@ -465,22 +465,53 @@ window.__ModuleLoader__.load({
 
     /** Field specs in display order. */
     const booleanField = (name) => ({ name, type: 'boolean', parse: (v) => v === 'true' || v === true, format: (v) => String(!!v) })
+    const STYLE_PRESET_OPTIONS = ['', 'cinematic', 'anime', 'digital_art', 'photographic', 'fantasy', 'isometric', 'cyberpunk', 'watercolor', 'origami', 'oil_painting', 'pixel_art', 'logo']
+
     const FIELDS = [
       { field: 'enabled', spec: booleanField('enabled'), kind: 'select', options: ['true', 'false'], labelKey: 'f.enabled', hintKey: 'f.enabledHint' },
-      { field: 'provider', spec: selectField('provider', PROVIDERS), kind: 'select', options: PROVIDERS, labelKey: 'f.provider', hintKey: 'f.providerHint', providerNeeds: { fal: 'ключ FAL', custom: 'адрес + ключ', codex: 'подписка ChatGPT', grok: 'подписка Grok', local: 'адрес сервера' } },
+      { field: 'provider', spec: selectField('provider', PROVIDERS), kind: 'select', options: PROVIDERS, labelKey: 'f.provider', hintKey: 'f.providerHint', providerNeeds: { fal: 'f.needFal', custom: 'f.needCustom', codex: 'f.needCodex', grok: 'f.needGrok', local: 'f.needLocal', seedream: 'f.needSeedream', gemini: 'f.needGemini', replicate: 'f.needReplicate' } },
+      
+      // FAL
       { field: 'model', spec: textField('model'), kind: 'text', labelKey: 'f.model', hintKey: 'f.modelHint', placeholderKey: 'p.model', when: ['fal'] },
       { field: 'apiKeyEnv', spec: textField('apiKeyEnv'), kind: 'text', labelKey: 'f.apiKeyEnv', hintKey: 'f.apiKeyEnvHint', placeholderKey: 'p.apiKeyEnv', when: ['fal'] },
       { field: 'baseURL', spec: textField('baseURL'), kind: 'text', labelKey: 'f.baseURL', hintKey: 'f.baseURLHint', placeholderKey: 'p.baseURL', when: ['fal'] },
-      { field: 'defaultSize', spec: selectField('defaultSize', IMAGE_SIZES), kind: 'select', options: IMAGE_SIZES, labelKey: 'f.defaultSize', hintKey: 'f.defaultSizeHint', sizePixels: SIZE_PIXELS },
-      { field: 'defaultFormat', spec: selectField('defaultFormat', OUTPUT_FORMATS), kind: 'select', options: OUTPUT_FORMATS, labelKey: 'f.defaultFormat', hintKey: 'f.defaultFormatHint' },
       { field: 'pollIntervalMs', spec: numberField('pollIntervalMs'), kind: 'number', labelKey: 'f.pollIntervalMs', hintKey: 'f.pollIntervalMsHint', placeholderKey: 'p.pollIntervalMs', when: ['fal'] },
       { field: 'timeoutMs', spec: numberField('timeoutMs'), kind: 'number', labelKey: 'f.timeoutMs', hintKey: 'f.timeoutMsHint', placeholderKey: 'p.timeoutMs', when: ['fal'] },
-      { field: 'deliverAs', spec: selectField('deliverAs', DELIVERY_MODES), kind: 'select', options: DELIVERY_MODES, labelKey: 'f.deliverAs', hintKey: 'f.deliverAsHint' },
+
+      // Custom
       { field: 'customBaseURL', spec: textField('customBaseURL'), kind: 'text', labelKey: 'f.customBaseURL', hintKey: 'f.customBaseURLHint', placeholderKey: 'p.customBaseURL', when: ['custom'] },
       { field: 'customModel', spec: textField('customModel'), kind: 'text', labelKey: 'f.customModel', hintKey: 'f.customModelHint', placeholderKey: 'p.customModel', when: ['custom'] },
       { field: 'customKeyEnv', spec: textField('customKeyEnv'), kind: 'text', labelKey: 'f.customKeyEnv', hintKey: 'f.customKeyEnvHint', placeholderKey: 'p.customKeyEnv', when: ['custom'] },
       { field: 'customSize', spec: textField('customSize'), kind: 'text', labelKey: 'f.customSize', hintKey: 'f.customSizeHint', placeholderKey: 'p.customSize', when: ['custom'] },
+
+      // Replicate
+      { field: 'replicateModel', spec: textField('replicateModel'), kind: 'text', labelKey: 'f.replicateModel', hintKey: 'f.replicateModelHint', placeholderKey: 'p.replicateModel', when: ['replicate'] },
+      { field: 'replicateKeyEnv', spec: textField('replicateKeyEnv'), kind: 'text', labelKey: 'f.replicateKeyEnv', hintKey: 'f.replicateKeyEnvHint', placeholderKey: 'p.replicateKeyEnv', when: ['replicate'] },
+
+      // SeaDream
+      { field: 'seedreamModel', spec: textField('seedreamModel'), kind: 'text', labelKey: 'f.seedreamModel', hintKey: 'f.seedreamModelHint', placeholderKey: 'p.seedreamModel', when: ['seedream'] },
+      { field: 'seedreamKeyEnv', spec: textField('seedreamKeyEnv'), kind: 'text', labelKey: 'f.seedreamKeyEnv', hintKey: 'f.seedreamKeyEnvHint', placeholderKey: 'p.seedreamKeyEnv', when: ['seedream'] },
+      { field: 'seedreamBaseURL', spec: textField('seedreamBaseURL'), kind: 'text', labelKey: 'f.seedreamBaseURL', hintKey: 'f.seedreamBaseURLHint', placeholderKey: 'p.seedreamBaseURL', when: ['seedream'] },
+
+      // Gemini
+      { field: 'geminiModel', spec: textField('geminiModel'), kind: 'text', labelKey: 'f.geminiModel', hintKey: 'f.geminiModelHint', placeholderKey: 'p.geminiModel', when: ['gemini'] },
+      { field: 'geminiKeyEnv', spec: textField('geminiKeyEnv'), kind: 'text', labelKey: 'f.geminiKeyEnv', hintKey: 'f.geminiKeyEnvHint', placeholderKey: 'p.geminiKeyEnv', when: ['gemini'] },
+
+      // Local ComfyUI / A1111
+      { field: 'localComfyUrl', spec: textField('localComfyUrl'), kind: 'text', labelKey: 'f.localComfyUrl', hintKey: 'f.localComfyUrlHint', placeholderKey: 'p.localComfyUrl', when: ['local'] },
+      { field: 'localA1111Url', spec: textField('localA1111Url'), kind: 'text', labelKey: 'f.localA1111Url', hintKey: 'f.localA1111UrlHint', placeholderKey: 'p.localA1111Url', when: ['local'] },
+
+      // Common Style & LLM Enhancer
+      { field: 'stylePreset', spec: selectField('stylePreset', STYLE_PRESET_OPTIONS), kind: 'select', options: STYLE_PRESET_OPTIONS, labelKey: 'f.stylePreset', hintKey: 'f.stylePresetHint' },
+      { field: 'enableLlmEnhancer', spec: booleanField('enableLlmEnhancer'), kind: 'select', options: ['true', 'false'], labelKey: 'f.enableLlmEnhancer', hintKey: 'f.enableLlmEnhancerHint' },
+
+      // Output & Defaults
+      { field: 'defaultSize', spec: selectField('defaultSize', IMAGE_SIZES), kind: 'select', options: IMAGE_SIZES, labelKey: 'f.defaultSize', hintKey: 'f.defaultSizeHint', sizePixels: SIZE_PIXELS },
+      { field: 'defaultFormat', spec: selectField('defaultFormat', OUTPUT_FORMATS), kind: 'select', options: OUTPUT_FORMATS, labelKey: 'f.defaultFormat', hintKey: 'f.defaultFormatHint' },
+      { field: 'deliverAs', spec: selectField('deliverAs', DELIVERY_MODES), kind: 'select', options: DELIVERY_MODES, labelKey: 'f.deliverAs', hintKey: 'f.deliverAsHint' },
       { field: 'outputDir', spec: textField('outputDir'), kind: 'text', labelKey: 'f.outputDir', hintKey: 'f.outputDirHint', placeholderKey: 'p.outputDir' },
+      { field: 'cacheTtlDays', spec: numberField('cacheTtlDays'), kind: 'number', labelKey: 'f.cacheTtlDays', hintKey: 'f.cacheTtlDaysHint', placeholderKey: 'p.cacheTtlDays' },
+      { field: 'maxHistoryEntries', spec: numberField('maxHistoryEntries'), kind: 'number', labelKey: 'f.maxHistoryEntries', hintKey: 'f.maxHistoryEntriesHint', placeholderKey: 'p.maxHistoryEntries' },
     ]
 
     function Field(props) {
@@ -501,7 +532,7 @@ window.__ModuleLoader__.load({
       }
       if (entry.kind === 'select') {
         const px = entry.sizePixels && entry.sizePixels[state.text] ? ` — ${entry.sizePixels[state.text]}` : ''
-        const need = entry.providerNeeds && entry.providerNeeds[state.text] ? ` (нужно: ${entry.providerNeeds[state.text]})` : ''
+        const need = entry.providerNeeds && entry.providerNeeds[state.text] ? ` (${t(entry.providerNeeds[state.text])})` : ''
         const hint = base.hint + px + need
         return react_jsx_runtime.jsx(SelectField, { ...base, hint, options: entry.options, inheritLabel: t('f.inherit') })
       }
@@ -828,19 +859,17 @@ function FalImageCard(props) {
         prompt = raw ? (JSON.parse(raw).prompt || '') : ''
       } catch (e) { prompt = '' }
 
+      const t = props.t || ((k) => k)
       const repeatText = (() => {
         const parts = [String(args.prompt || '').trim()]
         const size = args.image_size || args.size
         const seed = args.seed
-        if (size) parts.push(`Размер: ${size}`)
-        if (seed !== undefined) parts.push(`Сид: ${seed}`)
+        if (size) parts.push(`${t('card.sizePrefix')}: ${size}`)
+        if (seed !== undefined) parts.push(`${t('card.seedPrefix')}: ${seed}`)
         return parts.filter(Boolean).join(', ')
       })()
 
       const [editing, setEditing] = react.useState(false)
-      const [inpaintOpen, setInpaintOpen] = react.useState(false)
-      const [compareSlider, setCompareSlider] = react.useState(50)
-      const [showCompare, setShowCompare] = react.useState(false)
       const [editText, setEditText] = react.useState('')
 
       const onEditPrompt = () => {
@@ -862,8 +891,6 @@ function FalImageCard(props) {
       }
 
       const [copied, setCopied] = react.useState(false)
-      const canvasRef = react.useRef(null)
-      const [drawing, setDrawing] = react.useState(false)
 
       const sendActionPrompt = async (text) => {
         try {
@@ -893,23 +920,23 @@ function FalImageCard(props) {
 
       const onReroll = () => {
         const nextSeed = (typeof args.seed === 'number' ? args.seed + 1 : Math.floor(Math.random() * 100000))
-        sendActionPrompt(`Сгенерируй заново с другим сидом (${nextSeed}): ${prompt || repeatText}`)
+        sendActionPrompt(`${t('card.actionReroll')} (${nextSeed}): ${prompt || repeatText}`)
       }
 
       const onUpscale = () => {
         const ref = parsed.attachment ? parsed.attachment.attachmentId : (parsed.url || '')
-        sendActionPrompt(`Увеличь разрешение этого изображения в 2 раза: upscale_image(image: "${ref}")`)
+        sendActionPrompt(`${t('card.actionUpscale')}: upscale_image(image: "${ref}")`)
       }
 
       const onRemoveBg = () => {
         const ref = parsed.attachment ? parsed.attachment.attachmentId : (parsed.url || '')
-        sendActionPrompt(`Удали фон у этого изображения: remove_background(image: "${ref}")`)
+        sendActionPrompt(`${t('card.actionRemoveBg')}: remove_background(image: "${ref}")`)
       }
 
 
 
       const head = react.createElement('div', { className: 'fal-head' },
-        running ? 'Генерирую изображение…' : failed ? 'Генерация не удалась' : 'Изображение')
+        running ? t('card.generating') : failed ? t('card.failed') : t('card.image'))
 
       // «Повторить генерацию»: отправляет в чат новое сообщение с теми же
       // промптом и параметрами, извлечёнными из исходного вызова инструмента.
@@ -933,10 +960,10 @@ function FalImageCard(props) {
       const body = []
       if (prompt) body.push(react.createElement('div', { className: 'fal-prompt', key: 'p' }, prompt))
       if (args.originalPrompt && args.originalPrompt !== prompt) {
-        body.push(react.createElement('div', { className: 'fal-meta', key: 'orig' }, `Исходный запрос: ${args.originalPrompt}`))
+        body.push(react.createElement('div', { className: 'fal-meta', key: 'orig' }, `${t('card.origPrompt')}: ${args.originalPrompt}`))
       }
       if (failed) {
-        body.push(react.createElement('div', { className: 'fal-err', key: 'e' }, parsed.text || 'неизвестная ошибка'))
+        body.push(react.createElement('div', { className: 'fal-err', key: 'e' }, parsed.text || t('card.unknownError')))
       } else if (!parsed.attachment && parsed.url) {
         body.push(react.createElement('img', {
           key: 'i',
@@ -990,7 +1017,7 @@ function FalImageCard(props) {
           type: 'button',
           className: 'fal-action-btn',
           onClick: onReroll,
-          title: 'Перегенерировать со следующим сидом'
+          title: t('card.rerollTitle')
         }, '🔄 Re-roll'))
 
         btns.push(react.createElement('button', {
@@ -998,7 +1025,7 @@ function FalImageCard(props) {
           type: 'button',
           className: 'fal-action-btn',
           onClick: onUpscale,
-          title: 'Увеличить разрешение 2x'
+          title: t('card.upscaleTitle')
         }, '🔍 2x Upscale'))
 
         btns.push(react.createElement('button', {
@@ -1006,7 +1033,7 @@ function FalImageCard(props) {
           type: 'button',
           className: 'fal-action-btn',
           onClick: onRemoveBg,
-          title: 'Удалить фон'
+          title: t('card.removeBgTitle')
         }, '✂️ Remove BG'))
 
         if (prompt) {
@@ -1015,8 +1042,8 @@ function FalImageCard(props) {
             type: 'button',
             className: 'fal-action-btn',
             onClick: onCopyPrompt,
-            title: 'Скопировать промпт'
-          }, copied ? '✓ Скопировано' : '📋 Промпт'))
+            title: t('card.copyPromptTitle')
+          }, copied ? t('card.copied') : t('card.copyPrompt')))
         }
 
         if (args.seed !== undefined) {
@@ -1025,8 +1052,8 @@ function FalImageCard(props) {
             type: 'button',
             className: 'fal-action-btn',
             onClick: onCopySeed,
-            title: 'Скопировать сид'
-          }, `🎲 Сид: ${args.seed}`))
+            title: t('card.copySeedTitle')
+          }, `🎲 ${t('card.seedPrefix')}: ${args.seed}`))
         }
 
         body.push(react.createElement('div', { key: 'action-row', className: 'fal-btn-row' }, btns))
@@ -1042,7 +1069,7 @@ function FalImageCard(props) {
           type: 'button',
           className: 'fal-repeat',
           onClick: repeat,
-        }, 'Повторить генерацию'))
+        }, t('card.repeatGen')))
       }
       if (!running && !failed) {
         if (editing) {
@@ -1051,7 +1078,7 @@ function FalImageCard(props) {
             type: 'text',
             className: 'fal-input',
             value: editText,
-            placeholder: prompt || 'Новый промпт',
+            placeholder: prompt || t('card.newPromptPlaceholder'),
             onChange: (e) => setEditText(e.target.value),
           }))
           body.push(react.createElement('button', {
@@ -1071,14 +1098,14 @@ function FalImageCard(props) {
               setEditing(false)
               setEditText('')
             },
-          }, 'Отправить'))
+          }, t('card.send')))
         } else {
           body.push(react.createElement('button', {
             key: 'edit',
             type: 'button',
             className: 'fal-repeat',
             onClick: () => { setEditText(prompt || ''); setEditing(true) },
-          }, 'Изменить промпт'))
+          }, t('card.editPrompt')))
         }
       }
       if (!running && !failed && downloadUrl) {
@@ -1087,7 +1114,7 @@ function FalImageCard(props) {
           className: 'fal-repeat',
           href: downloadUrl,
           download: 'generated-image.png',
-        }, 'Скачать'))
+        }, t('card.download')))
       }
 
       return react.createElement('div', { className: 'fal-card' }, head, body)