@sequent-org/moodboard 1.4.45 → 1.4.48

package/src/services/ai/VideoSessionController.js

@@ -0,0 +1,175 @@
+/**
+ * Контроллер сессии генерации видео.
+ *
+ * Одна ответственность: оркестрирует submit -> poll-цикл через AiClient,
+ * держит состояние джоба и уведомляет подписчиков об изменениях.
+ * Не знает про DOM, доску и UI.
+ *
+ * Состояние:
+ *   - status:   'idle' | 'submitting' | 'polling' | 'done' | 'error'
+ *   - progress: number (0–100)
+ *   - error:    string | null
+ *   - jobId:    string | null
+ *   - result:   { videoUrl: string, mimeType: string } | null
+ */
+
+const POLL_INTERVAL_MS = 3000;
+const JOB_TIMEOUT_MS   = 300_000; // 300с — видео генерируется до нескольких минут
+
+export class VideoSessionController {
+    /**
+     * @param {object} deps
+     * @param {import('./AiClient.js').AiClient} deps.aiClient
+     */
+    constructor({ aiClient }) {
+        this._client    = aiClient;
+        this._listeners = new Set();
+        this._abort     = null;
+
+        this._state = {
+            status:   'idle',
+            progress: 0,
+            error:    null,
+            jobId:    null,
+            result:   null,
+        };
+    }
+
+    getState() {
+        return this._state;
+    }
+
+    /**
+     * @param {function} listener
+     * @returns {function} unsubscribe
+     */
+    subscribe(listener) {
+        this._listeners.add(listener);
+        return () => this._listeners.delete(listener);
+    }
+
+    /**
+     * Запускает джоб генерации видео.
+     * @param {object} args
+     * @param {string} [args.provider='gemini-video']
+     * @param {string} args.prompt
+     * @param {string} [args.negativePrompt]
+     * @param {string} [args.model]
+     * @param {string} [args.ratio]
+     * @param {string} [args.resolution]
+     * @param {number} [args.duration]
+     * @param {number} [args.seed]
+     * @param {File[]} [args.referenceImages]
+     * @param {AbortSignal} [args.signal]
+     * @returns {Promise<void>}
+     */
+    async start({ provider = 'gemini-video', signal: externalSignal, ...rest } = {}) {
+        if (this._abort) this.abort();
+
+        const abort = new AbortController();
+        this._abort = abort;
+        const { signal } = abort;
+
+        if (externalSignal) {
+            if (externalSignal.aborted) { abort.abort(); return; }
+            externalSignal.addEventListener('abort', () => abort.abort(), { once: true });
+        }
+
+        this._setState({ status: 'submitting', progress: 0, error: null, jobId: null, result: null });
+
+        const timeoutId = setTimeout(() => {
+            if (this._abort === abort) {
+                abort.abort();
+                this._setState({ status: 'error', error: 'Таймаут: джоб превысил 300 секунд' });
+            }
+        }, JOB_TIMEOUT_MS);
+
+        try {
+            const { jobId } = await this._client.submitVideo({ provider, signal, ...rest });
+            if (signal.aborted) return;
+
+            this._setState({ status: 'polling', jobId });
+
+            const result = await this._pollLoop(jobId, signal, provider);
+            if (!result || signal.aborted) return;
+
+            const { videoUrl, mimeType } = result;
+            this._setState({ status: 'done', progress: 100, result: { videoUrl, mimeType } });
+        } catch (err) {
+            if (err?.name === 'AbortError' || signal.aborted) return;
+            this._setState({ status: 'error', error: err?.message || 'Ошибка запроса' });
+        } finally {
+            clearTimeout(timeoutId);
+            if (this._abort === abort) this._abort = null;
+        }
+    }
+
+    /** Прерывает submit или поллинг. */
+    abort() {
+        if (this._abort) {
+            try { this._abort.abort(); } catch { /* noop */ }
+            this._abort = null;
+        }
+    }
+
+    async _pollLoop(jobId, signal, provider) {
+        while (!signal.aborted) {
+            await sleep(POLL_INTERVAL_MS, signal);
+            if (signal.aborted) return null;
+
+            let data;
+            try {
+                data = await this._client.pollVideo(jobId, signal, provider);
+            } catch (err) {
+                if (err?.name === 'AbortError' || signal.aborted) return null;
+                this._setState({ status: 'error', error: err?.message || 'Ошибка поллинга' });
+                return null;
+            }
+
+            const { status, progress, error } = data;
+
+            if (status === 'done') return data;
+
+            if (status === 'error') {
+                this._setState({ status: 'error', error: error || 'Ошибка джоба' });
+                return null;
+            }
+
+            // 'pending' | 'running' — обновляем прогресс
+            this._setState({ progress: progress ?? this._state.progress });
+        }
+        return null;
+    }
+
+    _setState(patch) {
+        this._state = { ...this._state, ...patch };
+        this._emit();
+    }
+
+    _emit() {
+        for (const listener of this._listeners) {
+            try { listener(this._state); } catch (err) {
+                console.error('[VideoSession] listener error:', err);
+            }
+        }
+    }
+}
+
+/**
+ * Promise, который разрешается через ms миллисекунд или отклоняется по AbortSignal.
+ * @param {number} ms
+ * @param {AbortSignal} [signal]
+ */
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new DOMException('Aborted', 'AbortError'));
+            return;
+        }
+        const id = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => {
+            clearTimeout(id);
+            reject(new DOMException('Aborted', 'AbortError'));
+        }, { once: true });
+    });
+}

package/src/services/ai/imageModelCapabilities.js

@@ -0,0 +1,130 @@
+/**
+ * Конфигурация возможностей моделей генерации изображений.
+ *
+ * Одна ответственность: данные и чистые helper-функции.
+ * Никакого DOM, никаких импортов UI.
+ *
+ * @typedef {Object} ImageModelCapability
+ * @property {string}   id               - уникальный идентификатор
+ * @property {string}   label            - подпись в UI (бренд/название модели)
+ * @property {string}   description      - описание (провайдер · техническое имя)
+ * @property {string}   provider         - идентификатор провайдера для бэкенда
+ * @property {string}   model            - код модели для бэкенда
+ * @property {string|undefined} quality  - 'high' | 'medium' | 'low' | undefined
+ * @property {string[]} ratios           - поддерживаемые соотношения сторон (id из FORMAT_OPTIONS)
+ * @property {string[]} resolutions      - допустимые разрешения; [] = выбор не нужен
+ * @property {string|null} defaultResolution - дефолтное разрешение или null
+ * @property {number}   maxCount         - максимальное количество изображений в одном запросе
+ * @property {{
+ *   seed:           boolean,
+ *   negativePrompt: boolean,
+ *   background:     boolean,
+ *   outputFormat:   boolean,
+ *   promptExtend:   boolean,
+ *   watermark:      boolean
+ * }} supports - флаги поддерживаемых доп-настроек
+ */
+
+/** @type {ImageModelCapability[]} */
+export const IMAGE_MODELS = [
+    {
+        id: 'yandex-art',
+        label: 'Yandex GPT',
+        description: 'Yandex · Шедеврум',
+        provider: 'yandex-art',
+        model: 'yandex-art',
+        quality: undefined,
+        ratios: ['1:1', '16:9', '9:16', '3:4', '4:3'],
+        resolutions: [],
+        defaultResolution: null,
+        maxCount: 1,
+        supports: { seed: true, negativePrompt: true, background: false, outputFormat: false, promptExtend: false, watermark: false }
+    },
+    {
+        id: 'nano-banana-pro',
+        label: 'Nano Banana Pro',
+        description: 'Google · Gemini 3 Pro Image',
+        provider: 'gemini-image',
+        model: 'gemini-3-pro-image',
+        quality: undefined,
+        ratios: ['1:1', '2:3', '3:2', '3:4', '4:3', '4:5', '5:4', '9:16', '16:9', '21:9'],
+        resolutions: ['1K', '2K', '4K'],
+        defaultResolution: '1K',
+        maxCount: 4,
+        supports: { seed: false, negativePrompt: false, background: false, outputFormat: false, promptExtend: false, watermark: false }
+    },
+    {
+        id: 'nano-banana-2',
+        label: 'Nano Banana 2',
+        description: 'Google · Gemini 3.1 Flash Image',
+        provider: 'gemini-image',
+        model: 'gemini-3.1-flash-image',
+        quality: undefined,
+        ratios: ['1:1', '2:3', '3:2', '3:4', '4:3', '4:5', '5:4', '9:16', '16:9', '21:9', '1:4', '4:1', '1:8', '8:1'],
+        resolutions: ['512', '1K', '2K', '4K'],
+        defaultResolution: '1K',
+        maxCount: 4,
+        supports: { seed: false, negativePrompt: false, background: false, outputFormat: false, promptExtend: false, watermark: false }
+    },
+    {
+        id: 'gpt-image-2-high',
+        label: 'GPT-Image-2 High',
+        description: 'OpenAI · gpt-image-2 · High',
+        provider: 'openai-image',
+        model: 'gpt-image-2',
+        quality: 'high',
+        ratios: ['1:1', '3:2', '2:3', '16:9', '9:16'],
+        resolutions: ['1K', '2K', '4K'],
+        defaultResolution: '1K',
+        maxCount: 1,
+        supports: { seed: false, negativePrompt: false, background: true, outputFormat: true, promptExtend: false, watermark: false }
+    },
+    {
+        id: 'gpt-image-2-medium',
+        label: 'GPT-Image-2 Medium',
+        description: 'OpenAI · gpt-image-2 · Medium',
+        provider: 'openai-image',
+        model: 'gpt-image-2',
+        quality: 'medium',
+        ratios: ['1:1', '3:2', '2:3', '16:9', '9:16'],
+        resolutions: ['1K', '2K', '4K'],
+        defaultResolution: '1K',
+        maxCount: 1,
+        supports: { seed: false, negativePrompt: false, background: true, outputFormat: true, promptExtend: false, watermark: false }
+    },
+    {
+        id: 'gpt-image-2-low',
+        label: 'GPT-Image-2 Low',
+        description: 'OpenAI · gpt-image-2 · Low',
+        provider: 'openai-image',
+        model: 'gpt-image-2',
+        quality: 'low',
+        ratios: ['1:1', '3:2', '2:3', '16:9', '9:16'],
+        resolutions: ['1K', '2K', '4K'],
+        defaultResolution: '1K',
+        maxCount: 1,
+        supports: { seed: false, negativePrompt: false, background: true, outputFormat: true, promptExtend: false, watermark: false }
+    },
+    {
+        id: 'qwen-image-2-pro',
+        label: 'Qwen Image 2 Pro',
+        description: 'Alibaba · qwen-image-2.0-pro',
+        provider: 'qwen-image',
+        model: 'qwen-image-2.0-pro',
+        quality: undefined,
+        ratios: ['1:1', '16:9', '9:16', '4:3', '3:4', '2:3', '3:2', '21:9'],
+        resolutions: [],
+        defaultResolution: null,
+        maxCount: 6,
+        supports: { seed: true, negativePrompt: true, background: false, outputFormat: false, promptExtend: true, watermark: true }
+    }
+];
+
+/**
+ * Возвращает объект возможностей модели по id или null, если модель не найдена.
+ * @param {string} id
+ * @returns {ImageModelCapability|null}
+ */
+export function getImageModelCapability(id) {
+    return IMAGE_MODELS.find((m) => m.id === id) ?? null;
+}

package/src/services/ai/videoModelCapabilities.js

@@ -0,0 +1,120 @@
+/**
+ * Конфигурация возможностей моделей генерации видео.
+ *
+ * Одна ответственность: данные и чистые helper-функции.
+ * Никакого DOM, никаких импортов UI.
+ *
+ * ВНИМАНИЕ: provider-id (gemini-video, seedance, veo, kling, openai-video) — предварительные;
+ * подлежат сверке с бэкендом Futurello перед включением в prod.
+ *
+ * @typedef {Object} VideoModelCapability
+ * @property {string}      id              - уникальный идентификатор
+ * @property {string}      label           - подпись в UI
+ * @property {string}      description     - описание (провайдер · техническое имя)
+ * @property {string}      provider        - идентификатор провайдера для бэкенда
+ * @property {string}      model           - код модели для бэкенда
+ * @property {string[]}    ratios          - поддерживаемые соотношения сторон
+ * @property {string[]}    resolutions     - допустимые разрешения; [] = выбор не нужен
+ * @property {number[]}    durations       - допустимые длительности в секундах
+ * @property {number|null} defaultDuration - дефолтная длительность или null
+ * @property {number}      maxCount        - максимальное количество видео в одном запросе
+ * @property {{
+ *   seed:             boolean,
+ *   negativePrompt:   boolean,
+ *   audio:            boolean,
+ *   watermark:        boolean,
+ *   personGeneration: boolean,
+ *   cfgScale:         boolean
+ * }} supports
+ */
+
+/** @type {VideoModelCapability[]} */
+export const VIDEO_MODELS = [
+    {
+        id: 'gemini-omni-flash',
+        label: 'Gemini-Omni-Flash',
+        description: 'Google · gemini-omni-flash',
+        provider: 'gemini-video',
+        model: 'gemini-omni-flash',
+        ratios: ['16:9', '9:16'],
+        resolutions: [],
+        durations: [4, 6, 8, 10],
+        defaultDuration: 4,
+        maxCount: 1,
+        supports: { seed: true, negativePrompt: false, audio: true, watermark: false, personGeneration: false, cfgScale: false },
+    },
+    {
+        id: 'seedance-2',
+        label: 'Seedance 2.0',
+        description: 'ByteDance · doubao-seedance-2-0',
+        provider: 'seedance',
+        model: 'doubao-seedance-2-0',
+        ratios: ['16:9', '9:16', '4:3', '3:4', '1:1', '21:9'],
+        resolutions: ['480p', '720p', '1080p'],
+        durations: [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
+        defaultDuration: 5,
+        maxCount: 1,
+        supports: { seed: true, negativePrompt: true, audio: true, watermark: true, personGeneration: false, cfgScale: false },
+    },
+    {
+        id: 'veo-3-1',
+        label: 'Veo 3.1',
+        description: 'Google · veo-3.1-generate-preview',
+        provider: 'veo',
+        model: 'veo-3.1-generate-preview',
+        ratios: ['16:9', '9:16'],
+        resolutions: ['720p', '1080p'],
+        durations: [4, 6, 8],
+        defaultDuration: 4,
+        maxCount: 1,
+        supports: { seed: false, negativePrompt: true, audio: false, watermark: false, personGeneration: true, cfgScale: false },
+    },
+    {
+        id: 'kling-3-pro',
+        label: 'Kling 3.0 Pro',
+        description: 'Kuaishou · kling-v3-pro',
+        provider: 'kling',
+        model: 'kling-v3-pro',
+        ratios: ['16:9', '9:16', '1:1'],
+        resolutions: ['720p', '1080p', '4K'],
+        durations: [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
+        defaultDuration: 5,
+        maxCount: 1,
+        supports: { seed: false, negativePrompt: true, audio: true, watermark: false, personGeneration: false, cfgScale: true },
+    },
+    {
+        id: 'kling-2-5-turbo-pro',
+        label: 'Kling 2.5 Turbo Pro',
+        description: 'Kuaishou · kling-v2.5-turbo-pro',
+        provider: 'kling',
+        model: 'kling-v2.5-turbo-pro',
+        ratios: ['16:9', '9:16', '1:1'],
+        resolutions: [],
+        durations: [5, 10],
+        defaultDuration: 5,
+        maxCount: 1,
+        supports: { seed: false, negativePrompt: true, audio: false, watermark: false, personGeneration: false, cfgScale: true },
+    },
+    {
+        id: 'sora-2',
+        label: 'Sora 2',
+        description: 'OpenAI · sora-2',
+        provider: 'openai-video',
+        model: 'sora-2',
+        ratios: ['16:9', '9:16'],
+        resolutions: [],
+        durations: [4, 8, 12],
+        defaultDuration: 4,
+        maxCount: 1,
+        supports: { seed: false, negativePrompt: false, audio: false, watermark: false, personGeneration: false, cfgScale: false },
+    },
+];
+
+/**
+ * Возвращает объект возможностей видео-модели по id или null, если модель не найдена.
+ * @param {string} id
+ * @returns {VideoModelCapability|null}
+ */
+export function getVideoModelCapability(id) {
+    return VIDEO_MODELS.find((m) => m.id === id) ?? null;
+}

package/src/ui/ImagePropertiesPanel.js

@@ -0,0 +1,8 @@
+/**
+ * Панель свойств изображения.
+ * Stub — заглушка, реализация будет добавлена отдельной задачей.
+ */
+export class ImagePropertiesPanel {
+    constructor(_eventBus, _container, _core = null) {}
+    destroy() {}
+}

package/src/ui/chat/ChatComposer.js

@@ -32,6 +32,14 @@ export class ChatComposer {
          * @type {{ file: File, sourceObjectId: string|null }[]}
          */
         this._attachments = [];
+        this._attachmentLabelProvider = null;
+        /**
+         * Жёстко зафиксированный placeholder. Когда задан, логика вложений
+         * (`_renderAttachmentsPreview`) не перетирает текст. Нужно для 3D-режима
+         * «Изображение», где описание не требуется.
+         * @type {string|null}
+         */
+        this._placeholderOverride = null;
     }
 
     attach() {
@@ -135,6 +143,39 @@ export class ChatComposer {
         this._attachments = [];
     }
 
+    /**
+     * Включает/выключает поле ввода текста.
+     * В 3D-режимах image/multi textarea должна быть заблокирована.
+     * @param {boolean} enabled
+     */
+    setInputEnabled(enabled) {
+        this._textarea.disabled = !enabled;
+        this._textarea.style.opacity = enabled ? '' : '0.4';
+        this._textarea.style.cursor = enabled ? '' : 'not-allowed';
+    }
+
+    /**
+     * Фиксирует placeholder, который не перетирается логикой вложений.
+     * `null` — вернуть обычное поведение (текст зависит от наличия вложений).
+     * @param {string|null} text
+     */
+    setPlaceholderOverride(text) {
+        this._placeholderOverride = text ?? null;
+        if (this._placeholderOverride != null) {
+            this._textarea.placeholder = this._placeholderOverride;
+        }
+    }
+
+    /**
+     * Устанавливает провайдер пользовательских лейблов для превью вложений.
+     * Используется в мультивью: i===0 → 'Фронт', i>0 → ракурс по порядку.
+     * @param {((index: number) => string) | null} fn
+     */
+    setAttachmentLabelProvider(fn) {
+        this._attachmentLabelProvider = fn ?? null;
+        this._renderAttachmentsPreview();
+    }
+
     _submit() {
         const text = this._textarea.value;
         const trimmed = text.trim();
@@ -180,13 +221,17 @@ export class ChatComposer {
         if (this._attachments.length === 0) {
             container.classList.remove('is-visible');
             inputRow?.classList.remove('has-attachments');
-            this._textarea.placeholder = 'Опишите то, что хотите сгенерировать';
+            if (this._placeholderOverride == null) {
+                this._textarea.placeholder = 'Опишите то, что хотите сгенерировать';
+            }
             return;
         }
 
         container.classList.add('is-visible');
         inputRow?.classList.add('has-attachments');
-        this._textarea.placeholder = 'Опишите правку, изменение или стилевое направление эталонного изображения';
+        if (this._placeholderOverride == null) {
+            this._textarea.placeholder = 'Опишите правку, изменение или стилевое направление эталонного изображения';
+        }
         for (let i = 0; i < this._attachments.length; i++) {
             const entry = this._attachments[i];
             const item = this._buildAttachmentItem(entry.file, i);
@@ -219,7 +264,9 @@ export class ChatComposer {
 
         const badge = document.createElement('div');
         badge.className = 'moodboard-chat__attachment-badge';
-        badge.textContent = String(index + 1);
+        badge.textContent = this._attachmentLabelProvider
+            ? (this._attachmentLabelProvider(index) ?? String(index + 1))
+            : String(index + 1);
         item.appendChild(badge);
 
         const remove = document.createElement('button');