@ssobig/writer-cli 0.3.2 → 0.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ssobig/writer-cli",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Official agent CLI for SSOBIG WRITER",
   "type": "commonjs",
   "license": "UNLICENSED",

package/templates/mystery-v1/authoring-view-preference.js

@@ -7,8 +7,31 @@
 
   const STORAGE_KEY = "somi-workbench-authoring-view";
   const DEFAULT_VIEW = "preview";
-  const VIEWS = Object.freeze(["input", "preview"]);
+  const VIEWS = Object.freeze(["input", "preview", "list"]);
   const STORAGE_VERSION = 1;
+  const PANEL_WIDTH_KEY = "somi-workbench-panel-width";
+  const PANEL_TEMPLATES = new Set(["ssobig.basic", "ssobig.progress", "ssobig.common", "ssobig.character", "ssobig.ending", "ssobig.author-notes"]);
+
+  function normalizePanelWidth(value) { return value === "wide" ? "wide" : "default"; }
+  function supportsPanelWidth(templateId) { return PANEL_TEMPLATES.has(templateId); }
+  function readPanelWidth(storage = deviceStorage()) {
+    try { return normalizePanelWidth(storage?.getItem(PANEL_WIDTH_KEY)); }
+    catch (_) { return "default"; }
+  }
+  function writePanelWidth(value, storage = deviceStorage()) {
+    const width = normalizePanelWidth(value);
+    try { storage?.setItem(PANEL_WIDTH_KEY, width); }
+    catch (_) { /* 보기 설정을 저장할 수 없어도 현재 화면에는 적용한다. */ }
+    return width;
+  }
+  function panelWidthControl(value) {
+    const width = normalizePanelWidth(value);
+    const options = [
+      ["default", "기본", "M2 12h7m-4-4 4 4-4 4M22 12h-7m4-4-4 4 4 4"],
+      ["wide", "와이드", "M3 12h18M7 8l-4 4 4 4M17 8l4 4-4 4"]
+    ];
+    return `<div class="panel-width-buttons" role="group" aria-label="패널 폭">${options.map(([id, label, icon]) => `<button type="button" data-panel-width="${id}" aria-pressed="${width === id}"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="${icon}"/></svg><span>${label}</span></button>`).join("")}</div>`;
+  }
 
   function normalize(value) {
     return VIEWS.includes(value) ? value : DEFAULT_VIEW;
@@ -47,5 +70,5 @@
     return normalized;
   }
 
-  return Object.freeze({ STORAGE_KEY, STORAGE_VERSION, DEFAULT_VIEW, VIEWS, normalize, read, write });
+  return Object.freeze({ STORAGE_KEY, STORAGE_VERSION, DEFAULT_VIEW, VIEWS, normalize, read, write, PANEL_WIDTH_KEY, normalizePanelWidth, supportsPanelWidth, readPanelWidth, writePanelWidth, panelWidthControl });
 });

package/templates/mystery-v1/component-asset-operations.js

@@ -28,11 +28,12 @@
     const clueInstance = active.find(instance => instance.templateId === "ssobig.clues");
     const clueData = dataFor(clueInstance) || clueInstance?.data;
     for (const [index, clue] of (Array.isArray(clueData?.clues) ? clueData.clues : []).entries()) {
-      const assetId = clueAssetId(clue);
-      if (!assetId) continue;
-      if (!result[assetId]) result[assetId] = [];
       const label = clue.name || clue.title || clue.id || index + 1;
-      result[assetId].push(`단서 · ${label}`);
+      for (const [side, sideLabel] of [["back", "단서 이미지(앞면)"], ["front", "단서 이미지(뒷면)"]]) {
+        const assetId = clueAssetId(clue, side);
+        if (!assetId) continue;
+        (result[assetId] ||= []).push(`단서 · ${label} · ${sideLabel}`);
+      }
     }
     for (const instance of active) {
       if (instance.templateId === "ssobig.assets") continue;

package/templates/mystery-v1/component-catalog-contract.js

@@ -56,7 +56,7 @@
       guide: guide("모든 참가자가 공통으로 읽는 규칙과 배경 정보를 작성합니다.", "프롤로그, 조사 규칙, 사건의 전말과 에필로그를 본문과 펼쳐보기로 구성합니다.", "문서의 제목·본문·노출 순서와 문서별 펼쳐보기 항목을 편집합니다.", "integrated", "공통 문서는 펼쳐보기 항목을 포함해 모든 캐릭터 관점의 통합 미리보기에 함께 표시됩니다.", ["ssobig.progress", "ssobig.character", "ssobig.ending"], "공통 문서 제작 화면 예시"),
       defaultData: { documents: [], deletedDocumentIds: [] },
       view: view("ssobig.view.common-workbench", "common-workbench", "공통정보 작업 화면", "ssobig.common", [
-        binding("primary", "ssobig.common", "read_write")
+        binding("primary", "ssobig.common", "read_write"), binding("assets", "ssobig.assets", "read_write")
       ]),
       importProfiles: [IMPORT_PROFILE]
     },
@@ -103,7 +103,7 @@
       templateId: "ssobig.timeline", defaultInstanceId: "timeline", tabLabel: "타임라인",
       description: "사건이 일어난 시간과 장소, 캐릭터별 기억과 행동을 시간순으로 정리합니다.",
       guide: guide("사건의 객관적 흐름과 인물별 기억을 시간축으로 맞춥니다.", "22시 로비 사건과 각 캐릭터가 기억하는 행동을 나란히 기록합니다.", "시간·장소·진실과 캐릭터별 기억을 사건 단위로 편집합니다.", "context", "캐릭터 정보를 읽어 인물별 기억을 연결하지만 독립 플레이 화면은 제공하지 않습니다.", ["ssobig.character"], "타임라인 제작 화면 예시"),
-      defaultData: { events: [] },
+      defaultData: { timeGroups: [], events: [], places: [] },
       view: view("ssobig.view.timeline-workbench", "timeline-workbench", "타임라인 작업 화면", "ssobig.timeline", [
         binding("primary", "ssobig.timeline", "read_write"), binding("character-context", "ssobig.character", "read", false)
       ]),
@@ -125,7 +125,7 @@
       guide: guide("플레이어에게 공개하지 않을 제작·운영 메모를 보관합니다.", "복선 점검, 진행자 주의사항과 다음 수정 목록을 기록합니다.", "제목과 본문으로 된 자유 메모를 추가하고 정리합니다.", "authoring", "작가 전용 Component로 통합 미리보기에 표시되지 않습니다.", [], "작가노트 제작 화면 예시"),
       defaultData: { notes: [] },
       view: view("ssobig.view.author-notes-workbench", "author-notes-workbench", "작가노트 작업 화면", "ssobig.author-notes", [
-        binding("primary", "ssobig.author-notes", "read_write")
+        binding("primary", "ssobig.author-notes", "read_write"), binding("assets", "ssobig.assets", "read_write")
       ]),
       importProfiles: [IMPORT_PROFILE]
     },

package/templates/mystery-v1/component-field-contracts.js

@@ -312,6 +312,37 @@
     })
   ]);
 
+  const EVENT_TIMELINE_CONTRACT = component({
+    templateId: "ssobig.timeline",
+    root: shape({ timeGroups: field("array", { item: "group" }), events: field("array", { item: "event" }), places: field("array", { item: "place" }) }),
+    items: {
+      group: shape({ id: field("uuid"), name: field("non-empty-string"), type: field("enum", { values: ["text", "timeline"] }) }),
+      place: shape({ id: field("uuid"), name: field("non-empty-string") }),
+      event: shape({ id: field("uuid"), description: field("string"), timeGroupId: field("uuid"),
+        placeId: field("nullable-uuid"), characterId: field("nullable-stable-key")
+      }, { timeRange: field("object", { item: "range" }), included: field("boolean") }),
+      range: shape({ start: field("object", { item: "point" }), end: field("object", { item: "point" }) }),
+      point: shape({ day: field("integer", { minimum: 0, maximum: 999999 }), hour: field("integer", { minimum: 0, maximum: 23 }), minute: field("integer", { minimum: 0, maximum: 59 }) })
+    }
+  });
+  function eventTimelineError(data) {
+    const invalid = validateShape(data, EVENT_TIMELINE_CONTRACT.root, EVENT_TIMELINE_CONTRACT, "$");
+    if (invalid) return invalid;
+    const groups = new Map(data.timeGroups.map(group => [group.id, group]));
+    const places = new Set(data.places.map(place => place.id));
+    const minutes = point => point.day * 1440 + point.hour * 60 + point.minute;
+    for (const event of data.events) {
+      const group = groups.get(event.timeGroupId);
+      if (!group) return "사건의 시간 그룹이 존재하지 않습니다.";
+      if (event.placeId !== null && !places.has(event.placeId)) return "사건의 장소가 존재하지 않습니다.";
+      if (group.type === "timeline") {
+        if (!event.timeRange) return "타임라인 그룹의 사건에는 시작·종료 시간이 필수입니다.";
+        if (minutes(event.timeRange.end) <= minutes(event.timeRange.start)) return "종료는 시작 이후여야 합니다.";
+      } else if (Object.hasOwn(event, "timeRange")) return "텍스트 그룹의 사건에는 시간 범위를 저장하지 않습니다.";
+    }
+    return null;
+  }
+
   const BY_ID = new Map(CONTRACTS.map(contract => [contract.templateId, contract]));
   const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
   const STABLE_KEY_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/;
@@ -352,6 +383,8 @@
       case "non-empty-string": return { type: "string", minLength: 1, pattern: "\\S" };
       case "stable-key": return { type: "string", pattern: STABLE_KEY_PATTERN.source };
       case "uuid": return { type: "string", format: "uuid" };
+      case "nullable-uuid": return { anyOf: [{ type: "null" }, { type: "string", format: "uuid" }] };
+      case "nullable-stable-key": return { anyOf: [{ type: "null" }, { type: "string", pattern: STABLE_KEY_PATTERN.source }] };
       case "hex-color": return { type: "string", pattern: HEX_COLOR_PATTERN.source };
       case "hex-color-or-empty": return { type: "string", pattern: `^(?:|#[0-9a-fA-F]{6})$` };
       case "safe-storage-relative-path": return { type: "string", minLength: 1 };
@@ -397,6 +430,7 @@
   }
   function jsonSchemaFor(templateId) {
     const contract = getContract(templateId);
+    if (templateId === "ssobig.timeline") return { oneOf: [clone(schemaForShape(contract.root, contract)), clone(schemaForShape(EVENT_TIMELINE_CONTRACT.root, EVENT_TIMELINE_CONTRACT))] };
     return contract ? clone(schemaForShape(contract.root, contract)) : null;
   }
 
@@ -433,6 +467,8 @@
   }
   function validateField(value, definition, contract, path) {
     switch (definition.type) {
+      case "nullable-uuid": return value === null || (typeof value === "string" && UUID_PATTERN.test(value)) ? null : `${path} 값은 UUID 또는 null이어야 합니다.`;
+      case "nullable-stable-key": return value === null || (typeof value === "string" && STABLE_KEY_PATTERN.test(value)) ? null : `${path} 값은 캐릭터 ID 또는 null이어야 합니다.`;
       case "string": return typeof value === "string" ? null : `${path} 값은 문자열이어야 합니다.`;
       case "non-empty-string": return typeof value === "string" && value.trim() ? null : `${path} 값은 비어 있지 않은 문자열이어야 합니다.`;
       case "stable-key": return typeof value === "string" && STABLE_KEY_PATTERN.test(value) ? null : `${path} 값은 안정 식별자 형식이어야 합니다.`;
@@ -658,6 +694,7 @@
     }
   }
   function validateTargetData(templateId, data) {
+    if (templateId === "ssobig.timeline" && isObject(data) && Object.hasOwn(data, "timeGroups")) return eventTimelineError(data);
     const contract = getContract(templateId);
     if (!contract) return `지원하지 않는 Component 계약입니다: ${templateId}`;
     const invalid = validateShape(data, contract.root, contract, "$");

package/templates/mystery-v1/component-renderers.js

@@ -88,7 +88,7 @@
   }
   function applyRendererView(markup, view) {
     return String(markup)
-      .replace(/data-renderer-view="(?:input|preview)"/, `data-renderer-view="${view}"`);
+      .replace(/data-renderer-view="(?:input|preview|list)"/, `data-renderer-view="${view}"`);
   }
   function renderAuthoring(instance, data, extra) {
     const renderer = resolve(instance);

package/templates/mystery-v1/component-storage-contract.js

@@ -152,7 +152,9 @@
       // 타임라인의 모양 배타, 시간 레벨 참조, lane/when 종류별 규칙은 validateComponentData가 이미 검증한다.
       // 여기서는 다른 Component를 봐야 판정할 수 있는 character 참조만 확인한다.
       for (const timeline of instances.filter(instance => instance.templateId === "ssobig.timeline")) {
-        const invalid = Array.isArray(timeline.data.events)
+        const invalid = Array.isArray(timeline.data.timeGroups)
+          ? (timeline.data.events.some(event => event.characterId !== null && !characterIds.has(event.characterId)) ? `${timeline.instanceId} 사건이 존재하지 않는 캐릭터를 가리킵니다.` : null)
+          : Array.isArray(timeline.data.events)
           ? legacyTimelineError(timeline, characterIds)
           : timelineLaneCharacterError(timeline, characterIds);
         if (invalid) return invalid;

package/templates/mystery-v1/markdown-document-model.js

@@ -34,6 +34,7 @@
 
   function parseLine(text, index = 0, from = 0) {
     const source = String(text ?? "");
+    const horizontalRule = /^ {0,3}-(?:[ \t]*-){2,}[ \t]*$/.test(source);
     const heading = source.match(/^( {0,3})(#{1,4})(?:[ \t]+)(.*)$/);
     const quote = source.match(/^( {0,3})>[ \t]?(.*)$/);
     const unordered = source.match(/^( {0,3})([-*])([ \t]+)(.*)$/);
@@ -46,6 +47,7 @@
     const body = unordered ? unordered[4] : ordered ? ordered[5] : "";
     const markerFrom = list ? indent.length : -1;
     const markerTo = list ? markerFrom + marker.length : -1;
+    const task = unordered ? body.match(/^\[([ xX])\](?:[ \t]+|$)/) : null;
 
     return Object.freeze({
       index,
@@ -53,6 +55,7 @@
       from,
       to: from + source.length,
       empty: !source.trim(),
+      horizontalRule,
       headingLevel: heading ? heading[2].length : 0,
       headingMarkerFrom: heading ? heading[1].length : -1,
       headingMarkerTo: heading ? source.length - heading[3].length : -1,
@@ -68,7 +71,10 @@
       listMarkerTo: markerTo,
       listPrefixTo: list ? markerTo + separator.length : -1,
       listSeparator: separator,
-      listBody: body,
+      listBody: task ? body.slice(task[0].length) : body,
+      taskChecked: task ? task[1].toLowerCase() === "x" : null,
+      taskStateFrom: task ? markerTo + separator.length + 1 : -1,
+      taskMarkerTo: task ? markerTo + separator.length + 3 : -1,
       listNumberText: ordered ? ordered[2] : "",
       listNumber: ordered ? Number.parseInt(ordered[2], 10) : null,
       listDelimiter: ordered ? ordered[3] : unordered ? unordered[2] : ""
@@ -360,6 +366,13 @@
         continue;
       }
 
+      if (line.horizontalRule) {
+        closeAll();
+        blocks.push({ type: "horizontalRule", lineIndex: line.index });
+        lineIndex += 1;
+        continue;
+      }
+
       if (line.quoteMarkerFrom >= 0) {
         closeParagraph();
         if (list?.items.length) {
@@ -408,6 +421,7 @@
           indent: line.listIndent,
           separator: line.listSeparator,
           body: line.listBody,
+          taskChecked: line.taskChecked,
           numberText: line.listNumberText,
           lineIndex: line.index,
           children: []

package/templates/mystery-v1/markdown-image-editor.js

@@ -18,6 +18,7 @@
     const doc = parent.ownerDocument;
     let view = null;
     let disposed = false;
+    let picker = null;
     let serial = Promise.resolve();
     const jobs = new Map();
     const fileInputs = new Set();
@@ -243,13 +244,24 @@
       input.click();
     }
     function chooseAsset() {
+      if (picker || disposed) return;
       const mark = { from: view.state.selection.main.head, to: view.state.selection.main.head };
       if (!allowed(mark)) return;
       const id = addBookmark(mark);
       const dialog = doc.createElement("dialog");
+      picker = dialog;
       dialog.className = "writer-md-image-picker";
-      dialog.setAttribute("aria-label", "에셋 이미지 선택");
-      const heading = doc.createElement("h3"); heading.textContent = "에셋에서 이미지 선택";
+      dialog.setAttribute("aria-label", "이미지 삽입");
+      if (assets?.upload) {
+        const find = button("이미지 찾기", () => {
+          const current = view.state.field(bookmarks).get(id);
+          if (current) chooseFiles(current);
+          dialog.close();
+        });
+        find.className = "writer-md-image-picker-upload";
+        dialog.append(find);
+      }
+      const heading = doc.createElement("h3"); heading.textContent = "에셋 리스트";
       dialog.append(heading);
       const list = doc.createElement("div"); list.className = "writer-md-image-picker-list";
       const entries = (assets.list?.() || []).filter(entry => IMAGE_TYPES.includes(entry.type));
@@ -262,9 +274,9 @@
         if (url) { const image = doc.createElement("img"); image.src = url; image.alt = ""; item.prepend(image); }
         list.append(item);
       });
-      if (!entries.length) list.textContent = "등록된 이미지가 없습니다. 이미지 업로드를 이용해주세요.";
+      if (!entries.length) list.textContent = "등록된 이미지가 없습니다. 위의 이미지 찾기로 추가해주세요.";
       dialog.append(list, button("닫기", () => dialog.close()));
-      dialog.addEventListener("close", () => { dialog.remove(); if (!disposed) { view.dispatch({ effects: bookmarkEffect.of({ id }) }); view.focus(); } }, { once: true });
+      dialog.addEventListener("close", () => { picker = null; dialog.remove(); if (!disposed) { view.dispatch({ effects: bookmarkEffect.of({ id }) }); view.focus(); onIdle?.(); } }, { once: true });
       parent.append(dialog);
       dialog.showModal();
     }
@@ -300,7 +312,9 @@
       };
     }
     return {
-      hasPending: () => jobs.size > 0 || fileInputs.size > 0,
+      chooseFiles,
+      chooseAsset,
+      hasPending: () => jobs.size > 0 || fileInputs.size > 0 || picker !== null,
       extensions: [bookmarks, decorations, events, cm.keymap.of([
         { key: "Backspace", run: protectBoundary(true) },
         { key: "Delete", run: protectBoundary(false) }
@@ -308,12 +322,14 @@
       attach(editor) {
         view = editor;
         if (assets?.upload) {
-          toolbar.append(button("이미지 업로드", () => chooseFiles()), button("에셋에서 선택", chooseAsset));
-          parent.prepend(toolbar);
+          if (!doc.defaultView.WriterMarkdownToolbar) {
+            toolbar.append(button("이미지 업로드", () => chooseFiles()), button("에셋에서 선택", chooseAsset));
+            parent.prepend(toolbar);
+          }
           parent.append(feedback);
         }
       },
-      destroy() { disposed = true; jobs.clear(); fileInputs.forEach(input => input.remove()); fileInputs.clear(); toolbar.remove(); feedback.remove(); parent.querySelectorAll(".writer-md-image-picker").forEach(dialog => dialog.remove()); }
+      destroy() { disposed = true; picker = null; jobs.clear(); fileInputs.forEach(input => input.remove()); fileInputs.clear(); toolbar.remove(); feedback.remove(); parent.querySelectorAll(".writer-md-image-picker").forEach(dialog => dialog.remove()); }
     };
   }
   return Object.freeze({ create, insertion });