kingkont 0.20.13 → 0.20.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kingkont",
-  "version": "0.20.13",
+  "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/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/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/<уникальное-имя>`.