kingkont 0.20.12 → 0.20.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kingkont",
-  "version": "0.20.12",
+  "version": "0.20.14",
   "description": "KingKont \u00b7 Chatium \u2014 \u043d\u043e\u0434-\u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440 \u0441\u0446\u0435\u043d \u0441 AI-\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0435\u0439 (\u043a\u0430\u0440\u0442\u0438\u043d\u043a\u0438/\u0432\u0438\u0434\u0435\u043e/\u0433\u043e\u043b\u043e\u0441/SFX/\u043c\u0443\u0437\u044b\u043a\u0430/\u0442\u0435\u043a\u0441\u0442)",
   "main": "main.js",
   "bin": {

package/renderer/board.js

@@ -3144,6 +3144,65 @@ $('newLocation').addEventListener('click', async () => {
     }
 });
 // =================== Board (универсально для серии и персонажа) ===================
+// === Link-to-scene: нода может содержать ссылку на другую сцену/борд. ====
+// Юзер: «из ноды можно сделать ссылку на сцену; ПКМ — сделать ссылку,
+// убрать ссылку; если есть ссылка — показываем значком, дабл-клик
+// открывает нужную сцену».
+//   node.linkedBoard = { kind: 'episode'|'character'|'location', name: '<имя>' }
+//   handle резолвится в момент перехода (через listEpisodes/listCharacters
+//   /listLocations), хранить нельзя — FSAH-handle не сериализуется в JSON.
+function refreshNodeLinkBadge(el, node) {
+    const badge = el.querySelector('.link-badge');
+    if (!badge) return;
+    if (node.linkedBoard?.name) {
+        badge.style.display = '';
+        badge.title = `Дабл-клик / клик: открыть → ${node.linkedBoard.name}`;
+    } else {
+        badge.style.display = 'none';
+    }
+}
+async function _resolveLinkedBoardHandle(target) {
+    if (!state.filmHandle || !target?.name) return null;
+    const list = target.kind === 'character' ? await listCharacters(state.filmHandle)
+               : target.kind === 'location'  ? await listLocations(state.filmHandle)
+               : await listEpisodes(state.filmHandle);
+    return list.find(b => b.name === target.name) || null;
+}
+async function goToLinkedBoard(node) {
+    const t = node.linkedBoard;
+    if (!t?.name) return;
+    const found = await _resolveLinkedBoardHandle(t);
+    if (!found) {
+        alert(`Целевая сцена не найдена: ${t.name} (возможно, переименована или удалена)`);
+        return;
+    }
+    await selectBoard({ kind: t.kind || 'episode', ...found });
+}
+async function pickBoardForLink(node) {
+    if (!state.filmHandle) { alert('Сначала откройте проект'); return; }
+    const eps = await listEpisodes(state.filmHandle);
+    const chars = await listCharacters(state.filmHandle).catch(() => []);
+    const locs = await listLocations(state.filmHandle).catch(() => []);
+    // Объединённый picker: «Сцены» сверху (основной кейс), потом chars/locs.
+    // Excluding текущей доски — линковать саму на себя бессмысленно.
+    const items = [];
+    const curKey = state.currentBoard ? `${state.currentBoard.kind}::${state.currentBoard.name}` : '';
+    for (const b of eps)   if (`episode::${b.name}` !== curKey) items.push({ kind: 'episode', name: b.name, label: '🎬 ' + b.name });
+    for (const b of chars) if (`character::${b.name}` !== curKey) items.push({ kind: 'character', name: b.name, label: '👤 ' + b.name });
+    for (const b of locs)  if (`location::${b.name}` !== curKey) items.push({ kind: 'location', name: b.name, label: '📍 ' + b.name });
+    if (!items.length) { alert('Нет других досок для ссылки'); return; }
+    const choice = await askChoice('Куда ведёт ссылка?', items.map(i => i.label), null, { vertical: true });
+    if (!choice) return;
+    const picked = items.find(i => i.label === choice);
+    if (!picked) return;
+    node.linkedBoard = { kind: picked.kind, name: picked.name };
+    scheduleSave();
+    const el = canvas.querySelector(`.node[data-id="${node.id}"]`);
+    if (el) refreshNodeLinkBadge(el, node);
+}
+window.goToLinkedBoard = goToLinkedBoard;
+window.pickBoardForLink = pickBoardForLink;
+
 // Выделить ноду + проскроллить view так, чтобы она была в центре viewport'а.
 // Юзер: «после создания ноды (любой) нужно её выделять и перемещаться к ней».
 // Используется после addText/addLabel/genNode'а — иначе если spot оказался
@@ -3776,9 +3835,25 @@ async function createNodeEl(node) {
     el.appendChild(anchor);
     attachAnchor(node, el, anchor);
     attachDrag(el, node);
+    // Link-badge: показывает 🔗 если у ноды есть linkedBoard (ссылка на сцену).
+    // Сам badge кликабельный — переход выполняется также через dblclick по ноде.
+    const linkBadge = document.createElement('div');
+    linkBadge.className = 'link-badge';
+    linkBadge.textContent = '🔗';
+    el.appendChild(linkBadge);
+    linkBadge.addEventListener('click', e => {
+        e.stopPropagation();
+        if (node.linkedBoard?.name) goToLinkedBoard(node);
+    });
+    refreshNodeLinkBadge(el, node);
     el.addEventListener('dblclick', e => {
         if (e.target.closest('textarea, input, video, button, .delete, .anchor, .resize-handle, [contenteditable]'))
             return;
+        // Если у ноды есть link на сцену — переход важнее остальных действий.
+        if (node.linkedBoard?.name) {
+            goToLinkedBoard(node);
+            return;
+        }
         if (node.type === 'audio' && node.file) {
             regenerateNode(node);
             return;
@@ -3985,6 +4060,18 @@ function showNodeContextMenu(node, clientX, clientY) {
             loadAllCharactersInfo().catch(() => { });
         });
     }
+    // Link-to-scene
+    if (node.linkedBoard?.name) {
+        add(`🔗 Перейти → ${node.linkedBoard.name}`, () => goToLinkedBoard(node));
+        add('⛓️‍💥 Убрать ссылку', () => {
+            delete node.linkedBoard;
+            scheduleSave();
+            const el = canvas.querySelector(`.node[data-id="${node.id}"]`);
+            if (el) refreshNodeLinkBadge(el, node);
+        });
+    } else {
+        add('🔗 Сделать ссылку на сцену…', () => pickBoardForLink(node));
+    }
     add('⎘ Скопировать (Cmd+C)', () => copyNodeToClipboard(node));
     add('✂ Вырезать (Cmd+X)', async () => {
         await copyNodeToClipboard(node);

package/renderer/cloudProjects.js

@@ -351,9 +351,11 @@
             // canModify. Юзер видит лишние edit-кнопки на view-only-link.
             if (typeof window.renderTemplateOverlay === 'function') window.renderTemplateOverlay();
             if (window.__KINGKONT_WEB__ && !/^#template=/.test(location.hash)) location.hash = '#project=' + projectId;
-            // Background — узнаём актуальный canModify. Если расширились
-            // shared-edit права или наоборот отозвали — обновится здесь.
-            fetch('/api/projects/' + encodeURIComponent(projectId)).then(r => r.ok ? r.json() : null).then(p => {
+            // Background — узнаём актуальный canModify + докачиваем тексты
+            // (если кэш был «частичный» из view-only-сессии, .md мог не быть).
+            // После download'а перечитываем text-ноды из FS и обновляем
+            // currentBoard, чтобы textarea-ноды показали свежий контент.
+            fetch('/api/projects/' + encodeURIComponent(projectId)).then(r => r.ok ? r.json() : null).then(async p => {
               if (!p) return;
               state.cloudPermission = p.permission || (p.mine ? 'owner' : null);
               state.cloudMine = !!p.mine;
@@ -361,6 +363,10 @@
               state.cloudIsPublic = !!p.isPublic;
               setCloudButtonsVisibility();
               if (typeof window.renderTemplateOverlay === 'function') window.renderTemplateOverlay();
+              const bgBoards = Array.isArray(p.manifest?.boards) ? p.manifest.boards : [];
+              await _downloadAllTexts(projectId, bgBoards).catch(() => {});
+              // Перечитываем тексты ТЕКУЩЕЙ доски (другие — при switchBoard).
+              await _refreshCurrentBoardTexts().catch(() => {});
             }).catch(() => {});
             return;
           }
@@ -399,6 +405,11 @@
             new TextEncoder().encode(JSON.stringify(board.scene, null, 2)));
         }
       }
+      // a.5) Тексты (texts/*.md) — тоже синхронно ДО openFilm. loadBoardMetadata
+      // при открытии доски ходит к каждому n.file через resolveBoardFile —
+      // если файла нет локально, n.text=''. View-only (canModify=false) раньше
+      // вообще не докачивал → юзер видел пустые text-ноды.
+      await _downloadAllTexts(projectId, boards);
       // CDN-карта — будет и в state, и в meta (чтобы пережила reload).
       // Конвертируем /get/<hash> → /thumbnail/<hash>/1024x для лучшего
       // кеширования на CDN (юзер: «/get плохо кешируется, /thumbnail
@@ -461,6 +472,60 @@
     }
   }
 
+  // Параллельная синхронная загрузка всех .md-контентов всех бордов.
+  // Тексты маленькие (1-10KB обычно), качаем сразу — иначе при открытии
+  // доски юзер видит пустые text-ноды до завершения _backgroundDownload
+  // (который не запускается в view-only).
+  async function _downloadAllTexts(projectId, boards) {
+    const tasks = [];
+    for (const board of boards) {
+      const boardDir = boardKindToDir(board.kind, board.name);
+      for (const [relPath, textId] of Object.entries(board.texts || {})) {
+        tasks.push({ boardDir, relPath, textId });
+      }
+    }
+    if (!tasks.length) return;
+    const CONCURRENCY = 8;
+    let i = 0;
+    async function worker() {
+      while (i < tasks.length) {
+        const t = tasks[i++];
+        try {
+          const tr = await fetch('/api/project-texts/' + encodeURIComponent(t.textId));
+          if (!tr.ok) continue;
+          const td = await tr.json();
+          const buf = new TextEncoder().encode(td.content || '');
+          await writeCloudFile(projectId, joinPath(t.boardDir, t.relPath), buf);
+        } catch {}
+      }
+    }
+    await Promise.all(Array.from({ length: CONCURRENCY }, worker));
+  }
+
+  // Перечитать .md-контент text-нод текущей доски из FS и обновить DOM.
+  // Используется после фонового _downloadAllTexts — если тексты пришли
+  // ПОСЛЕ openFilm, ноды показывают пустые textarea, пока этот хук не
+  // обновит node.text + refreshNodeDOM.
+  async function _refreshCurrentBoardTexts() {
+    const board = state.currentBoard;
+    if (!board?.handle) return;
+    const nodes = board.metadata?.nodes || [];
+    let changed = 0;
+    for (const n of nodes) {
+      if (n.type !== 'text' || !n.file) continue;
+      try {
+        const fh = await resolveBoardFile(board.handle, n.file);
+        const content = await (await fh.getFile()).text();
+        if (n.text !== content) {
+          n.text = content;
+          changed++;
+          if (typeof refreshNodeDOM === 'function') await refreshNodeDOM(n.id);
+        }
+      } catch {}
+    }
+    if (changed) console.log('[cloudProjects] refreshed', changed, 'text-нод после фоновой загрузки');
+  }
+
   // Подложить CDN-URL'ы под state.currentBoard.urls — рендеру медиа-нод
   // в settings.js достаточно непустого `urls[node.file]`, чтобы не лезть
   // в FS (см. settings.js:405).

package/renderer/styles.css

@@ -110,6 +110,24 @@
     width: 36px; height: 36px; flex-shrink: 0; object-fit: contain;
     background: #1a1a1a; border-radius: 8px; padding: 4px;
   }
+  /* Link-badge: значок 🔗 на ноде когда у неё есть linkedBoard. Лежит в
+     правом-верхнем углу, кликабельный (= dblclick: открыть target-сцену).
+     По умолчанию скрыт (display:none); refreshNodeLinkBadge показывает. */
+  .node .link-badge {
+    position: absolute; top: -10px; right: 8px;
+    width: 22px; height: 22px;
+    background: #2a3854; border: 1px solid #4a6a9a;
+    border-radius: 50%; cursor: pointer;
+    font-size: 12px; line-height: 20px; text-align: center;
+    box-shadow: 0 1px 4px rgba(0,0,0,0.4);
+    z-index: 5;
+    transition: background 0.12s, transform 0.12s;
+  }
+  .node .link-badge:hover { background: #3a5a8a; transform: scale(1.1); }
+  /* В drawing-нодах кружок поверх stroke'а смотрится плохо — смещаем
+     к левому-верху самой bbox'ы. */
+  .node.drawing-node .link-badge { top: 4px; right: 4px; }
+
   /* Brand-logo и welcome-logo всегда кликабельны (на главной → ничего,
      в проекте → возврат на welcome, dblclick → настройки). cursor:pointer
      ставится и в HTML inline, но в web chatium-минифайер иногда срывает

package/skill/SKILL.md

@@ -395,6 +395,10 @@ open -a "Google Chrome" "http://localhost:17893/"
       },
       "status": "generating" | "draft" | "error",  // отсутствует если нода готова
       "error": "...",
+      "linkedBoard": {                       // опц., ссылка на другую доску
+        "kind": "episode" | "character" | "location",
+        "name": "Сцена 2"                    // имя целевой доски (handle резолвится в runtime)
+      },
       "history": [...],                      // история правок (через ⇄ Заменить)
       "historyIndex": 0
     }
@@ -475,6 +479,35 @@ open -a "Google Chrome" "http://localhost:17893/"
    }
    ```
 
+## Ссылки на доски (link-to-scene)
+
+Нода может содержать ссылку на другую сцену/персонажа/локацию того же
+проекта. Используется для нелинейной навигации — например, story-board
+с миниатюрами сцен, по которым юзер кликает чтобы перейти.
+
+**Формат** (поле в ноде):
+```json5
+"linkedBoard": {
+  "kind": "episode" | "character" | "location",
+  "name": "Сцена 2"
+}
+```
+
+**UI**:
+- ПКМ на ноде → «🔗 Сделать ссылку на сцену…» (picker всех досок проекта,
+  кроме текущей). Меняется на «🔗 Перейти → <имя>» + «⛓️‍💥 Убрать ссылку»
+  когда ссылка уже есть.
+- На ноде со ссылкой — значок 🔗 в правом-верхнем углу.
+- Дабл-клик на ноде = переход (перебивает обычное действие dblclick типа
+  fullscreen-просмотра).
+- Если целевая доска переименована/удалена — алерт «не найдена».
+
+**Handle не сериализуется** — хранится только `{kind, name}`. При переходе
+редактор резолвит через `listEpisodes/listCharacters/listLocations`.
+Поэтому ссылка переживает clone-проекта (новые директории, та же
+структура). Но переименование целевой доски ломает ссылку — нужно
+обновлять вручную в scene.json или пересоздавать через ПКМ.
+
 ## Файловые операции
 
 - **Удаление ноды**: файл переезжает в `<root>/_deleted/<уникальное-имя>`.