feat(npcs): add campaign NPCs with relation graph and session overlay

Add a dedicated NPC editor window, directed relations, control/presentation avatar overlay, and ru/en help for the new section.

Co-authored-by: Cursor <cursoragent@cursor.com>

app/renderer/editor/i18n/editorMessages.ts

@@ -179,13 +179,17 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
     'help.section.materials.body':
       'Материалы — изображения кампании (карты, записки, чертежи), которые можно показать игрокам поверх сцены во время игры. Они общие для проекта и не привязаны к одной сцене.\n\nВ редакторе:\n\n1) В блоке «Свойства игры» нажмите «Материалы».\n\n2) «Добавить» — укажите уникальное название и изображение (PNG, JPG или WebP): кнопка выбора или перетаскивание файла.\n\n3) В списке можно искать, менять порядок перетаскиванием, править или удалять через меню «⋮» (перед удалением будет подтверждение).\n\n4) Под большим превью — «Повернуть»: поворот на 90° (учитывается и в плитке, и при показе на экране).\n\nВо время сессии:\n\n1) На пульте в «Инструменты» нажмите кнопку материалов (иконка карты сокровищ) — откроется отдельное окно со списком.\n\n2) Клик по плитке показывает материал поверх сцены на пульте и на презентации; повторный клик по той же плитке скрывает его.\n\n3) На предпросмотре пульта материал можно перетаскивать и менять размер за углы; крестик закрывает показ.\n\n4) В окне материалов лупы «+» / «−» — инструменты масштаба: выберите лупу, затем кликните по материалу в предпросмотре пульта.\n\nПри смене сцены показ материала сбрасывается. Описание сцены и эффекты поля с материалами не связаны.',
 
+    'help.section.npcs.title': 'НПС',
+    'help.section.npcs.body':
+      'НПС — персонажи кампании с аватаром, описанием и однонаправленными связями между собой. Они общие для проекта и не привязаны к одной сцене.\n\nВ редакторе:\n\n1) В блоке «Свойства игры» нажмите «НПС» — откроется отдельное окно редактора персонажей.\n\n2) «Добавить» — укажите уникальное имя и обязательный аватар (PNG, JPG или WebP): кнопка выбора или перетаскивание файла. При необходимости сразу заполните описание.\n\n3) Слева — список персонажей: поиск, порядок перетаскиванием; меню «⋮» — только удаление (с подтверждением; все связи с этим персонажем тоже удаляются).\n\n4) В центре — граф связей: протяните стрелку от одного персонажа к другому и укажите обязательное название связи. Связь однонаправленная (А → Б и Б → А — разные). Несколько связей в одном направлении рисуются параллельными дугами. Клик по связи или её подписи выбирает исходного персонажа и подсвечивает его исходящие связи.\n\n5) Справа — карточка выбранного персонажа: аватар, имя, описание (форматированный текст) и список «Отношения» — только исходящие связи («название» + имя цели).\n\n6) Правый клик по связи на графе — «Редактировать» название или «Удалить» (с подтверждением).\n\nВо время сессии:\n\n1) На пульте в «Инструменты» рядом с материалами нажмите кнопку НПС (цветная иконка человека) — откроется отдельное окно.\n\n2) Справа — список персонажей; клик по плитке показывает аватар поверх сцены на пульте и на презентации; повторный клик по той же плитке скрывает его. Слева — описание и исходящие отношения выбранного персонажа (их видите только вы).\n\n3) На предпросмотре пульта аватар можно перетаскивать и менять размер за углы; крестик закрывает показ.\n\n4) В окне НПС лупы «+» / «−» — инструменты масштаба: выберите лупу, затем кликните по аватару в предпросмотре пульта.\n\nПри смене сцены показ НПС сбрасывается. Игроки на презентации видят только аватар.',
+
     'help.section.session.title': 'Запуск сессии',
     'help.section.session.body':
       'Когда кампания готова, можно начать игру.\n\nОбычный запуск:\n\n1) На карте связей щёлкните правой кнопкой по карточке старта → «Начальная сцена».\n\n2) Нажмите «Запустить» в шапке редактора.\n\nБыстрый запуск с любой карточки: правый клик по нужной карточке на карте → «Запустить с этой сцены». Презентация и пульт откроются сразу с выбранного места.\n\nОткроются «Презентация» (для игроков) и «Пульт управления» (для вас). Редактор на время показа затемняется — так и должно быть.\n\nВернуться к подготовке:\n\n1) На пульте нажмите «Выключить демонстрацию» или «Завершить показ» (если дальше некуда переходить).\n\n2) Дождитесь закрытия обоих окон.\n\nОкно «Презентация» перенесите на второй монитор, проектор или ТВ и разверните на весь экран (F11). Игроки увидят только картинку, видео и эффекты — без ваших кнопок.',
 
     'help.section.controlPanel.title': 'Пульт управления',
     'help.section.controlPanel.body':
-      'Пульт — ваш стол во время игры. Игроки смотрят на презентацию, вы управляете всем отсюда.\n\nСлева сверху — «Инструменты», затем эффекты и ход сюжета; справа — мини-копия экрана игроков, варианты переходов и музыка.\n\nВ «Инструменты» кнопка с книгой открывает отдельное окно с оформленным описанием текущей сцены. Если описания нет, кнопка неактивна — при наведении подсказка «Описание отсутствует». Кнопка материалов (иконка карты) открывает окно со списком материалов кампании — подробнее в разделе «Материалы».\n\n«Предпросмотр экрана» показывает то же, что видят игроки. На сценах с картинкой здесь же рисуют эффекты — они сразу появляются на большом экране.\n\n«Сюжетная линия» — цепочка пройденных эпизодов. Текущая сцена помечена «ТЕКУЩАЯ СЦЕНА». Клик по прошлому шагу переносит партию к тому месту на карте и добавляет новый шаг в историю.\n\n«Выключить демонстрацию» — закончить показ и вернуться в редактор.',
+      'Пульт — ваш стол во время игры. Игроки смотрят на презентацию, вы управляете всем отсюда.\n\nСлева сверху — «Инструменты», затем эффекты и ход сюжета; справа — мини-копия экрана игроков, варианты переходов и музыка.\n\nВ «Инструменты» кнопка с книгой открывает отдельное окно с оформленным описанием текущей сцены. Если описания нет, кнопка неактивна — при наведении подсказка «Описание отсутствует». Кнопка материалов (иконка карты) открывает окно со списком материалов кампании — подробнее в разделе «Материалы». Кнопка НПС (цветная иконка человека) открывает окно персонажей — см. раздел «НПС».\n\n«Предпросмотр экрана» показывает то же, что видят игроки. На сценах с картинкой здесь же рисуют эффекты — они сразу появляются на большом экране.\n\n«Сюжетная линия» — цепочка пройденных эпизодов. Текущая сцена помечена «ТЕКУЩАЯ СЦЕНА». Клик по прошлому шагу переносит партию к тому месту на карте и добавляет новый шаг в историю.\n\n«Выключить демонстрацию» — закончить показ и вернуться в редактор.',
 
     'help.section.transitions.title': 'Переходы между сценами',
     'help.section.transitions.body':
@@ -360,6 +364,54 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
     'materials.zoomOutHint': 'Кликните по материалу в предпросмотре пульта, чтобы уменьшить.',
     'materials.zoomIdleHint': 'Выберите лупу, затем кликните по материалу в предпросмотре пульта.',
 
+    'npcs.open': 'НПС',
+    'npcs.editorTitle': 'НПС',
+    'npcs.add': 'Добавить',
+    'npcs.addTitle': 'Новый НПС',
+    'npcs.editTitle': 'Изменить НПС',
+    'npcs.edit': 'Изменить',
+    'npcs.tileMenu': 'Меню НПС',
+    'npcs.search': 'Поиск НПС…',
+    'npcs.searchEmpty': 'Ничего не найдено.',
+    'npcs.empty': 'НПС пока нет.',
+    'npcs.selectPrompt': 'Выберите НПС в списке или на графе.',
+    'npcs.name': 'ИМЯ',
+    'npcs.namePlaceholder': 'Имя персонажа…',
+    'npcs.nameRequired': 'Укажите имя.',
+    'npcs.nameDup': 'НПС с таким именем уже есть.',
+    'npcs.avatar': 'АВАТАР',
+    'npcs.avatarEmpty': 'Аватар не выбран',
+    'npcs.avatarRequired': 'Выберите аватар.',
+    'npcs.chooseAvatar': 'Выбрать аватар',
+    'npcs.dropHint': 'Перетащите изображение (PNG, JPG, WebP)',
+    'npcs.description': 'ОПИСАНИЕ',
+    'npcs.descriptionPlaceholder': 'Описание персонажа…',
+    'npcs.descriptionEmpty': 'Описание отсутствует',
+    'npcs.relations': 'Отношения',
+    'npcs.untitled': 'Без имени',
+    'npcs.deleteTitle': 'Удаление НПС',
+    'npcs.deleteConfirm': 'Вы уверены, что хотите удалить НПС «{name}»? Все связи с ним будут удалены.',
+    'npcs.relationCreateTitle': 'Название связи',
+    'npcs.relationEditTitle': 'Название связи',
+    'npcs.relationLabel': 'НАЗВАНИЕ',
+    'npcs.relationLabelPlaceholder': 'Например: друзья, враги…',
+    'npcs.relationLabelRequired': 'Укажите название связи.',
+    'npcs.relationEdit': 'Редактировать',
+    'npcs.relationDelete': 'Удалить',
+    'npcs.relationDeleteTitle': 'Удаление связи',
+    'npcs.relationDeleteConfirm': 'Удалить связь «{name}»?',
+    'npcs.graphZoomBar': 'Масштаб графа',
+    'npcs.graphZoomIn': 'Увеличить',
+    'npcs.graphZoomOut': 'Уменьшить',
+    'npcs.graphFitAll': 'Показать всё',
+    'npcs.windowEmpty': 'Добавьте НПС в редакторе.',
+    'npcs.closeOverlay': 'Закрыть НПС',
+    'npcs.zoomIn': 'Увеличить',
+    'npcs.zoomOut': 'Уменьшить',
+    'npcs.zoomInHint': 'Кликните по аватару в предпросмотре пульта, чтобы увеличить.',
+    'npcs.zoomOutHint': 'Кликните по аватару в предпросмотре пульта, чтобы уменьшить.',
+    'npcs.zoomIdleHint': 'Выберите лупу, затем кликните по аватару в предпросмотре пульта.',
+
     'scene.title': 'НАЗВАНИЕ СЦЕНЫ',
     'scene.description': 'ОПИСАНИЕ',
     'scene.descriptionEmpty': 'описание отсутствует',
@@ -423,6 +475,7 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
     'control.instruments': 'ИНСТРУМЕНТЫ',
     'control.descriptionTool': 'Описание',
     'control.materialsTool': 'Материалы',
+    'control.npcsTool': 'НПС',
     'control.descriptionMissing': 'Описание отсутствует',
     'control.effects': 'ЭФФЕКТЫ',
     'control.tools': 'Очистка',
@@ -618,13 +671,17 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
     'help.section.materials.body':
       'Materials are campaign images (maps, notes, sketches) you can show players on top of the scene during play. They belong to the project and are not tied to one scene.\n\nIn the editor:\n\n1) Under Game properties, click Materials.\n\n2) Add — enter a unique name and an image (PNG, JPG, or WebP) via Choose image or by dropping a file.\n\n3) In the list you can search, reorder by drag-and-drop, and edit or delete via the ⋮ menu (delete asks for confirmation).\n\n4) Under the large preview, Rotate turns the image by 90° (applied in the tile and when shown on screen).\n\nDuring a session:\n\n1) On the control panel under Tools, click the materials button (treasure-map icon) to open a separate window with the list.\n\n2) Click a tile to show the material over the scene on the control preview and presentation; click the same tile again to hide it.\n\n3) On the control preview you can drag the material and resize it from the corners; the × button closes the overlay.\n\n4) In the materials window, the + / − magnifiers are zoom tools: pick one, then click the material on the control preview.\n\nChanging scenes clears the material overlay. Scene description and field effects are separate from materials.',
 
+    'help.section.npcs.title': 'NPCs',
+    'help.section.npcs.body':
+      'NPCs are campaign characters with an avatar, description, and one-way relations between them. They belong to the project and are not tied to one scene.\n\nIn the editor:\n\n1) Under Game properties, click NPCs — a separate character editor window opens.\n\n2) Add — enter a unique name and a required avatar (PNG, JPG, or WebP) via Choose avatar or by dropping a file. You can fill in the description right away if you want.\n\n3) Left: character list with search and drag reorder; the ⋮ menu is delete only (with confirmation; all relations involving that character are removed too).\n\n4) Center: relationship graph — drag an arrow from one character to another and enter a required relation name. Relations are one-way (A → B and B → A are different). Multiple relations in the same direction are drawn as parallel curves. Click a relation or its label to select the source character and highlight their outgoing links.\n\n5) Right: the selected character’s card — avatar, name, description (rich text), and a Relations list of outgoing links only (“name” + target name).\n\n6) Right-click a relation on the graph to Edit the name or Delete (with confirmation).\n\nDuring a session:\n\n1) On the control panel under Tools, next to materials, click the NPCs button (colored person icon) to open a separate window.\n\n2) Right: character list; click a tile to show the avatar over the scene on the control preview and presentation; click the same tile again to hide it. Left: description and outgoing relations for the selected character (visible only to you).\n\n3) On the control preview you can drag the avatar and resize it from the corners; the × button closes the overlay.\n\n4) In the NPCs window, the + / − magnifiers are zoom tools: pick one, then click the avatar on the control preview.\n\nChanging scenes clears the NPC overlay. Players on presentation see only the avatar.',
+
     'help.section.session.title': 'Starting a session',
     'help.section.session.body':
       'When your campaign is ready, you can start playing.\n\nStandard start:\n\n1) On the story map, right-click the starting card → Start scene.\n\n2) Click Run in the editor header.\n\nQuick start from any card: right-click the card on the map → Start from this scene. Presentation and the control panel open at that spot right away.\n\nPresentation (for players) and the Control panel (for you) open. The editor dims while the show runs — that is expected.\n\nReturn to prep:\n\n1) On the control panel, click Stop presentation or End presentation (when there is nowhere left to go).\n\n2) Wait until both windows close.\n\nMove the Presentation window to a second monitor, projector, or TV and go fullscreen (F11). Players see only the image, video, and effects — not your buttons.',
 
     'help.section.controlPanel.title': 'Control panel',
     'help.section.controlPanel.body':
-      'The control panel is your desk during play. Players watch presentation; you run everything from here.\n\nTop-left: Tools, then effects and storyline. On the right: a mini copy of the player screen, branch options, and music.\n\nUnder Tools, the book button opens a separate window with the current scene’s formatted description. If there is no description, the button is disabled — the tooltip reads “No description”. The materials button (map icon) opens a window with the campaign materials list — see the Materials section for details.\n\nScreen preview shows what players see. On image scenes, paint effects here — they appear on the big screen right away.\n\nStoryline lists episodes you have visited. The current scene is marked CURRENT SCENE. Click an earlier step to move the party back to that spot and add a new history entry.\n\nStop presentation ends the show and unlocks the editor.',
+      'The control panel is your desk during play. Players watch presentation; you run everything from here.\n\nTop-left: Tools, then effects and storyline. On the right: a mini copy of the player screen, branch options, and music.\n\nUnder Tools, the book button opens a separate window with the current scene’s formatted description. If there is no description, the button is disabled — the tooltip reads “No description”. The materials button (map icon) opens a window with the campaign materials list — see the Materials section for details. The NPCs button (colored person icon) opens the characters window — see the NPCs section.\n\nScreen preview shows what players see. On image scenes, paint effects here — they appear on the big screen right away.\n\nStoryline lists episodes you have visited. The current scene is marked CURRENT SCENE. Click an earlier step to move the party back to that spot and add a new history entry.\n\nStop presentation ends the show and unlocks the editor.',
 
     'help.section.transitions.title': 'Scene transitions',
     'help.section.transitions.body':
@@ -800,6 +857,54 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
     'materials.zoomOutHint': 'Click the material on the control preview to zoom out.',
     'materials.zoomIdleHint': 'Pick a magnifier, then click the material on the control preview.',
 
+    'npcs.open': 'NPCs',
+    'npcs.editorTitle': 'NPCs',
+    'npcs.add': 'Add',
+    'npcs.addTitle': 'New NPC',
+    'npcs.editTitle': 'Edit NPC',
+    'npcs.edit': 'Edit',
+    'npcs.tileMenu': 'NPC menu',
+    'npcs.search': 'Search NPCs…',
+    'npcs.searchEmpty': 'No matches.',
+    'npcs.empty': 'No NPCs yet.',
+    'npcs.selectPrompt': 'Select an NPC in the list or on the graph.',
+    'npcs.name': 'NAME',
+    'npcs.namePlaceholder': 'Character name…',
+    'npcs.nameRequired': 'Name is required.',
+    'npcs.nameDup': 'An NPC with this name already exists.',
+    'npcs.avatar': 'AVATAR',
+    'npcs.avatarEmpty': 'No avatar selected',
+    'npcs.avatarRequired': 'Choose an avatar.',
+    'npcs.chooseAvatar': 'Choose avatar',
+    'npcs.dropHint': 'Drop an image (PNG, JPG, WebP)',
+    'npcs.description': 'DESCRIPTION',
+    'npcs.descriptionPlaceholder': 'Character description…',
+    'npcs.descriptionEmpty': 'No description',
+    'npcs.relations': 'Relations',
+    'npcs.untitled': 'Untitled',
+    'npcs.deleteTitle': 'Delete NPC',
+    'npcs.deleteConfirm': 'Are you sure you want to delete NPC “{name}”? All of their relations will be removed.',
+    'npcs.relationCreateTitle': 'Relation name',
+    'npcs.relationEditTitle': 'Relation name',
+    'npcs.relationLabel': 'NAME',
+    'npcs.relationLabelPlaceholder': 'e.g. friends, rivals…',
+    'npcs.relationLabelRequired': 'Relation name is required.',
+    'npcs.relationEdit': 'Edit',
+    'npcs.relationDelete': 'Delete',
+    'npcs.relationDeleteTitle': 'Delete relation',
+    'npcs.relationDeleteConfirm': 'Delete relation “{name}”?',
+    'npcs.graphZoomBar': 'Graph zoom',
+    'npcs.graphZoomIn': 'Zoom in',
+    'npcs.graphZoomOut': 'Zoom out',
+    'npcs.graphFitAll': 'Fit view',
+    'npcs.windowEmpty': 'Add NPCs in the editor.',
+    'npcs.closeOverlay': 'Close NPC',
+    'npcs.zoomIn': 'Zoom in',
+    'npcs.zoomOut': 'Zoom out',
+    'npcs.zoomInHint': 'Click the avatar on the control preview to zoom in.',
+    'npcs.zoomOutHint': 'Click the avatar on the control preview to zoom out.',
+    'npcs.zoomIdleHint': 'Pick a magnifier, then click the avatar on the control preview.',
+
     'scene.title': 'SCENE TITLE',
     'scene.description': 'DESCRIPTION',
     'scene.descriptionEmpty': 'no description',
@@ -862,6 +967,7 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
     'control.instruments': 'TOOLS',
     'control.descriptionTool': 'Description',
     'control.materialsTool': 'Materials',
+    'control.npcsTool': 'NPCs',
     'control.descriptionMissing': 'No description',
     'control.effects': 'EFFECTS',
     'control.tools': 'Cleanup',