narraeon 0.1.0

package/dist/node/shared/first-party-action-choices.js

@@ -0,0 +1,164 @@
+import { defaultNarrationPromptForLocale } from "./default-play-prompts.js";
+import { defaultPresetHostFilesForLocale } from "./default-preset-host.js";
+import { defaultSettingImprovementPromptForLocale, defaultSettingImprovementPromptPath, } from "./default-setting-improvement-prompt.js";
+/**
+ * An ordinary, portable play-preset asset. Runtime treats this exactly like
+ * any author-supplied file map. The export is only a convenient workbench
+ * starting point and may be copied, edited, exported, or deleted.
+ */
+export function firstPartyActionChoicesPresetFilesForLocale(locale) {
+    const displayName = locale === "zh-CN" ? "下一步建议" : "Next-step ideas";
+    return {
+        "preset.yaml": `format: narraeon.play-preset/v1
+name: action-choices-recommended
+callChain: call-chain.yaml
+settingImprovement:
+  markdown: prompts/setting-improvement.md
+mounts:
+  player.options: composer_below
+extensions:
+  - renderers/player-options.html
+  - scripts/player-options.js
+  - assets/player-options.css
+`,
+        "call-chain.yaml": `format: narraeon.play-call-chain/v1
+narrative:
+  - markdown: prompts/narrate.md
+followups:
+  - id: player_options
+    displayName: ${displayName}
+    prompt:
+      role: author_instruction
+      markdown: prompts/options.md
+    maxArtifactBytes: 32768
+    artifacts:
+      - name: player_options
+        channel: player.options
+        strategy: replace
+        contentType: application/json
+        renderer: renderers/player-options.html
+        rendererRevision: v1
+        rendererMode: app
+        scripts:
+          - scripts/player-options.js
+        assets:
+          - assets/player-options.css
+        save: commit
+        invalidation: new_operation
+        required: true
+        maxEmits: 1
+        payloadContract:
+          type: array
+          minItems: 4
+          maxItems: 4
+          uniqueBy: id
+          items:
+            type: object
+            additionalProperties: false
+            required:
+              - id
+              - label
+              - prompt
+            properties:
+              id:
+                type: string
+                minLength: 1
+                maxLength: 64
+              label:
+                type: string
+                minLength: 1
+                maxLength: 80
+              description:
+                type: string
+                maxLength: 240
+              prompt:
+                type: string
+                minLength: 1
+                maxLength: 1000
+`,
+        ...defaultPresetHostFilesForLocale(locale),
+        "prompts/narrate.md": defaultNarrationPromptForLocale(locale),
+        [defaultSettingImprovementPromptPath]: defaultSettingImprovementPromptForLocale(locale),
+        "prompts/options.md": locale === "zh-CN"
+            ? `# 提交后下一步建议
+
+根据玩家刚刚看到的决策点，给出四种短而具体、彼此有实质差异的下一步建议。差异应体现在目标、方法、风险或态度上，而不是只替换近义词。
+
+建议只能使用玩家已经能够知道的信息，并且必须是玩家角色此刻有条件尝试的行动。每项建议只是可以填入输入框的草稿：表达玩家准备做什么，不宣称行动已经发生，不预先写定结果，也不替玩家选择或发送。字段、数量和提交方式服从当前后置请求的 Runtime 产物说明。
+`
+            : `# Next-step ideas after the commit
+
+At the decision point the player has just seen, provide four short, concrete next-step ideas that differ meaningfully from one another. Vary the goal, method, risk, or attitude rather than swapping synonyms.
+
+Use only information the player can already know, and suggest only actions the player character could attempt now. Each idea is a draft that may be placed in the input box: it expresses what the player is preparing to do, never claims the action has happened, predetermines an outcome, chooses for the player, or sends the input. Follow the current follow-up request's Runtime artifact contract for fields, count, and submission.
+`,
+        "renderers/player-options.html": `<!doctype html>
+<html><head><meta charset="utf-8"><title>${displayName}</title></head><body>
+<main id="player-options-root" aria-label="${displayName}"></main>
+</body></html>
+`,
+        "scripts/player-options.js": `(function () {
+  var root = document.getElementById("player-options-root");
+  var pending = new Map();
+  var styleSource = window.__NARRAEON_ASSETS__ && window.__NARRAEON_ASSETS__["assets/player-options.css"];
+  if (typeof styleSource === "string") {
+    var style = document.createElement("style");
+    style.textContent = styleSource;
+    document.head.append(style);
+  }
+  function post(command, payload) {
+    var requestId = "draft-" + Math.random().toString(36).slice(2);
+    parent.postMessage({
+      namespace: "narraeon.extension.v1",
+      command: command,
+      instanceId: document.documentElement.dataset.narraeonInstance,
+      nonce: document.documentElement.dataset.narraeonNonce,
+      requestId: requestId,
+      payload: payload
+    }, "*");
+    pending.set(requestId, true);
+  }
+  function draw(raw, disabled) {
+    root.replaceChildren();
+    var options;
+    try { options = JSON.parse(raw); } catch (_) { return; }
+    if (!Array.isArray(options)) return;
+    options.forEach(function (option) {
+      var button = document.createElement("button");
+      button.type = "button";
+      button.className = "player-option";
+      button.dataset.optionId = option.id;
+      button.disabled = Boolean(disabled);
+      var label = document.createElement("strong");
+      label.textContent = option.label;
+      button.append(label);
+      if (option.description) {
+        var detail = document.createElement("small");
+        detail.textContent = option.description;
+        button.append(detail);
+      }
+      button.addEventListener("click", function () {
+        post("composer.set_draft", { text: option.prompt });
+      });
+      root.append(button);
+    });
+  }
+  window.addEventListener("message", function (event) {
+    if (!event.data || event.data.namespace !== "narraeon.extension.v1") return;
+    if (event.data.type === "render.update") {
+      draw(event.data.payload && event.data.payload.content, event.data.payload && event.data.payload.interactionDisabled);
+      return;
+    }
+    if (event.data.type === "bridge.response") pending.delete(event.data.requestId);
+  });
+}());
+`,
+        "assets/player-options.css": `body { margin: 0; font: 14px/1.45 system-ui, sans-serif; color: #202020; }
+#player-options-root { display: grid; gap: .5rem; }
+.player-option { display: grid; gap: .15rem; padding: .65rem .75rem; border: 1px solid #c9c0b1; border-radius: .65rem; background: #fffaf1; color: inherit; text-align: left; cursor: pointer; }
+.player-option:hover { border-color: #a66a42; }
+.player-option small { color: #6c6259; }
+`,
+    };
+}
+export const firstPartyActionChoicesPresetFiles = firstPartyActionChoicesPresetFilesForLocale("en");

package/dist/node/shared/first-party-generic-panels.js

@@ -0,0 +1,105 @@
+import { defaultNarrationPromptForLocale } from "./default-play-prompts.js";
+import { defaultPresetHostFilesForLocale } from "./default-preset-host.js";
+import { defaultSettingImprovementPromptForLocale, defaultSettingImprovementPromptPath, } from "./default-setting-improvement-prompt.js";
+/**
+ * Ordinary copyable examples for the generic artifact seam. Runtime does not
+ * privilege these output names or channels; authors may replace every file.
+ */
+export function firstPartyGenericPanelsPresetFilesForLocale(locale) {
+    const displayName = locale === "zh-CN" ? "发布通用面板" : "Publish generic panels";
+    const panelTitle = locale === "zh-CN" ? "通用 HTML 面板" : "Generic HTML panel";
+    return {
+        "preset.yaml": `format: narraeon.play-preset/v1
+name: generic-panels-recommended
+callChain: call-chain.yaml
+settingImprovement:
+  markdown: prompts/setting-improvement.md
+mounts:
+  generic.markdown: story
+  generic.html: sidebar
+  generic.debug: debug
+extensions:
+  - renderers/generic-html.html
+  - scripts/generic-html.js
+  - assets/generic-html.css
+`,
+        "call-chain.yaml": `format: narraeon.play-call-chain/v1
+narrative:
+  - markdown: prompts/narrate.md
+followups:
+  - id: publish_panels
+    displayName: ${displayName}
+    prompt:
+      role: author_instruction
+      markdown: prompts/panels.md
+    maxArtifactBytes: 65536
+    artifacts:
+      - name: markdown_panel
+        channel: generic.markdown
+        strategy: replace
+        contentType: text/markdown
+        save: commit
+        invalidation: new_operation
+        required: false
+        maxEmits: 1
+      - name: html_panel
+        channel: generic.html
+        strategy: replace
+        contentType: text/html
+        renderer: renderers/generic-html.html
+        rendererRevision: v1
+        rendererMode: app
+        scripts:
+          - scripts/generic-html.js
+        assets:
+          - assets/generic-html.css
+        save: commit
+        invalidation: new_operation
+        required: false
+        maxEmits: 1
+      - name: debug_panel
+        channel: generic.debug
+        strategy: append
+        contentType: text/markdown
+        save: operation
+        invalidation: operation_end
+        required: false
+        maxEmits: 8
+`,
+        ...defaultPresetHostFilesForLocale(locale),
+        "prompts/narrate.md": defaultNarrationPromptForLocale(locale),
+        [defaultSettingImprovementPromptPath]: defaultSettingImprovementPromptForLocale(locale),
+        "prompts/panels.md": locale === "zh-CN"
+            ? `# 通用面板
+
+核心叙事已经提交。只有面板能为当前局面提供额外价值时才生成它；没有合适内容时可以不生成。
+
+面板只能整理已经成立且适合玩家看见的信息，不得发明世界事实、替玩家作决定、偷偷保存状态，或把未向玩家揭示的信息当作提示。它是非权威的界面补充，不应复制或改写由玩家视图负责的固定状态展示。各输出的格式、保存方式和提交方法服从当前后置请求的 Runtime 产物说明。
+`
+            : `# Generic panels
+
+The core narrative has already been committed. Generate a panel only when it adds value to the current situation; emit nothing when there is no suitable content.
+
+A panel may organize only established information that is appropriate for the player to see. It must not invent world facts, decide for the player, save state covertly, or turn unrevealed information into hints. It is a non-authoritative interface supplement and must not duplicate or rewrite fixed state display owned by player views. Follow the current follow-up request's Runtime artifact contract for each output's format, retention, and submission.
+`,
+        "renderers/generic-html.html": `<!doctype html>
+<html><head><meta charset="utf-8"><title>${panelTitle}</title></head><body>
+<main id="generic-html-root" aria-label="${panelTitle}"></main>
+</body></html>
+`,
+        "scripts/generic-html.js": `(function () {
+  var root = document.getElementById("generic-html-root");
+  window.addEventListener("message", function (event) {
+    if (!event.data || event.data.namespace !== "narraeon.extension.v1") return;
+    if (event.data.type !== "render.update") return;
+    var payload = event.data.payload || {};
+    root.innerHTML = typeof payload.content === "string" ? payload.content : "";
+  });
+}());
+`,
+        "assets/generic-html.css": `body { margin: 0; font: 14px/1.45 system-ui, sans-serif; color: #202020; }
+#generic-html-root { padding: .75rem; }
+`,
+    };
+}
+export const firstPartyGenericPanelsPresetFiles = firstPartyGenericPanelsPresetFilesForLocale("en");

package/dist/node/shared/first-party-play-preset-templates.js

@@ -0,0 +1,41 @@
+import { firstPartyActionChoicesPresetFilesForLocale } from "./first-party-action-choices.js";
+import { firstPartyGenericPanelsPresetFilesForLocale } from "./first-party-generic-panels.js";
+import { firstPartyStatusPanelPresetFilesForLocale } from "./first-party-player-view.js";
+/** Optional workbench registry; each entry is ordinary portable file content. */
+export function firstPartyPlayPresetTemplatesForLocale(locale) {
+    return [
+        {
+            id: "action-choices",
+            label: locale === "zh-CN" ? "行动选项" : "Action choices",
+            name: locale === "zh-CN"
+                ? "下一步建议（可编辑副本）"
+                : "Next-step ideas (editable copy)",
+            files: firstPartyActionChoicesPresetFilesForLocale(locale),
+        },
+        {
+            id: "status-panel",
+            label: locale === "zh-CN" ? "状态栏" : "Status panel",
+            name: locale === "zh-CN"
+                ? "状态栏（可编辑副本）"
+                : "Status panel (editable copy)",
+            files: firstPartyStatusPanelPresetFilesForLocale(locale),
+        },
+        {
+            id: "generic-panels",
+            label: locale === "zh-CN" ? "Markdown / HTML 面板" : "Markdown / HTML panels",
+            name: locale === "zh-CN"
+                ? "通用面板（可编辑副本）"
+                : "Generic panels (editable copy)",
+            files: firstPartyGenericPanelsPresetFilesForLocale(locale),
+        },
+        {
+            id: "artifact-debugger",
+            label: locale === "zh-CN" ? "产物调试器" : "Artifact debugger",
+            name: locale === "zh-CN"
+                ? "产物调试器（可编辑副本）"
+                : "Artifact debugger (editable copy)",
+            files: firstPartyGenericPanelsPresetFilesForLocale(locale),
+        },
+    ];
+}
+export const firstPartyPlayPresetTemplates = firstPartyPlayPresetTemplatesForLocale("en");

package/dist/node/shared/first-party-player-view.js

@@ -0,0 +1,179 @@
+import { defaultNarrationPromptForLocale } from "./default-play-prompts.js";
+import { defaultPresetHostFilesForLocale } from "./default-preset-host.js";
+import { defaultSettingImprovementPromptForLocale, defaultSettingImprovementPromptPath, } from "./default-setting-improvement-prompt.js";
+/**
+ * Ordinary, copyable player-view panel assets. Runtime understands only the
+ * generic playerViewPanels contract; this is not a privileged status system.
+ */
+export function firstPartyStatusPanelPresetFilesForLocale(locale) {
+    const currentStatus = locale === "zh-CN" ? "当前状态" : "Current status";
+    const playerView = locale === "zh-CN" ? "玩家视图" : "Player view";
+    const emptyMessage = locale === "zh-CN" ? "当前没有可显示内容。" : "Nothing to display yet.";
+    const emptyPrefix = locale === "zh-CN" ? "暂无项目：" : "No items: ";
+    const diagnosticsSuffix = locale === "zh-CN" ? " 项视图诊断" : " player-view diagnostics";
+    return {
+        "preset.yaml": `format: narraeon.play-preset/v1
+name: status-panel-recommended
+callChain: call-chain.yaml
+settingImprovement:
+  markdown: prompts/setting-improvement.md
+mounts: []
+playerViewPanels:
+  - id: current_view
+    source:
+      kind: player_view
+      view: status
+    channel: player.view.current
+    key: current
+    mount: sidebar
+    renderer: renderers/player-view-status.html
+    rendererRevision: v1
+    rendererMode: app
+    scripts:
+      - scripts/player-view-status.js
+    assets:
+      - assets/player-view-status.css
+    config:
+      title: ${currentStatus}
+      layout: stack
+      theme: parchment
+      empty: message
+      emptyMessage: ${emptyMessage}
+      groups: []
+extensions:
+  - renderers/player-view-status.html
+  - scripts/player-view-status.js
+  - assets/player-view-status.css
+`,
+        "call-chain.yaml": `format: narraeon.play-call-chain/v1
+narrative:
+  - markdown: prompts/narrate.md
+followups: []
+`,
+        ...defaultPresetHostFilesForLocale(locale),
+        "prompts/narrate.md": defaultNarrationPromptForLocale(locale),
+        [defaultSettingImprovementPromptPath]: defaultSettingImprovementPromptForLocale(locale),
+        "renderers/player-view-status.html": `<!doctype html>
+<html><head><meta charset="utf-8"><title>${currentStatus}</title></head><body>
+<main id="player-view-panel-root" aria-label="${currentStatus}"></main>
+</body></html>
+`,
+        "scripts/player-view-status.js": `(function () {
+  var root = document.getElementById("player-view-panel-root");
+  var styleSource = window.__NARRAEON_ASSETS__ && window.__NARRAEON_ASSETS__["assets/player-view-status.css"];
+  if (typeof styleSource === "string") {
+    var style = document.createElement("style");
+    style.textContent = styleSource;
+    document.head.append(style);
+  }
+  function valueNode(value) {
+    if (value === null || value === undefined) return document.createTextNode("—");
+    if (typeof value === "object") {
+      var wrapper = document.createElement(Array.isArray(value) ? "ul" : "dl");
+      Object.keys(value).forEach(function (key, index) {
+        var entry = document.createElement(Array.isArray(value) ? "li" : "div");
+        if (!Array.isArray(value)) {
+          var term = document.createElement("dt");
+          term.textContent = key;
+          entry.append(term);
+        }
+        entry.append(valueNode(Array.isArray(value) ? value[index] : value[key]));
+        wrapper.append(entry);
+      });
+      return wrapper;
+    }
+    return document.createTextNode(String(value));
+  }
+  function draw(raw) {
+    root.replaceChildren();
+    var payload;
+    try { payload = JSON.parse(raw || "{}"); } catch (_) { return; }
+    var config = payload.config || {};
+    root.dataset.theme = config.theme || "default";
+    root.dataset.layout = config.layout || "stack";
+    root.dataset.emptyState = config.empty || "message";
+    var heading = document.createElement("h3");
+    heading.textContent = payload.title || payload.viewId || ${JSON.stringify(playerView)};
+    root.append(heading);
+    var items = Array.isArray(payload.items) ? payload.items : [];
+    if (items.length === 0) {
+      if (config.empty === "message" || config.empty === "show") {
+        var empty = document.createElement("p");
+        empty.className = config.empty === "show"
+          ? "player-view-empty player-view-empty-value"
+          : "player-view-empty player-view-empty-message";
+        empty.textContent = config.empty === "show"
+          ? ${JSON.stringify(emptyPrefix)} + (config.emptyMessage || ${JSON.stringify(emptyMessage)})
+          : (config.emptyMessage || ${JSON.stringify(emptyMessage)});
+        root.append(empty);
+      }
+    } else {
+      var byId = new Map(items.map(function (item) { return [item.id, item]; }));
+      var groups = Array.isArray(config.groups) ? config.groups : [];
+      var renderItems = function (list, selected) {
+        selected.forEach(function (item) {
+          var row = document.createElement("div");
+          var label = document.createElement("dt");
+          label.textContent = item.label || item.id;
+          var value = document.createElement("dd");
+          value.append(valueNode(item.value));
+          row.append(label, value);
+          list.append(row);
+        });
+      };
+      if (groups.length === 0) {
+        var list = document.createElement("dl");
+        renderItems(list, items);
+        root.append(list);
+      } else {
+        groups.forEach(function (group) {
+          var selected = (Array.isArray(group.itemIds) ? group.itemIds : [])
+            .map(function (id) { return byId.get(id); })
+            .filter(Boolean);
+          if (selected.length === 0) return;
+          var section = document.createElement("section");
+          var groupHeading = document.createElement("h4");
+          groupHeading.textContent = group.label || group.id;
+          var groupList = document.createElement("dl");
+          renderItems(groupList, selected);
+          section.append(groupHeading, groupList);
+          root.append(section);
+        });
+      }
+    }
+    var diagnostics = Array.isArray(payload.diagnostics) ? payload.diagnostics : [];
+    if (diagnostics.length > 0) {
+      var details = document.createElement("details");
+      var summary = document.createElement("summary");
+      summary.textContent = diagnostics.length + ${JSON.stringify(diagnosticsSuffix)};
+      details.append(summary);
+      var diagnosticList = document.createElement("ul");
+      diagnostics.forEach(function (diagnostic) {
+        var item = document.createElement("li");
+        item.textContent = diagnostic.message;
+        diagnosticList.append(item);
+      });
+      details.append(diagnosticList);
+      root.append(details);
+    }
+  }
+  window.addEventListener("message", function (event) {
+    if (!event.data || event.data.namespace !== "narraeon.extension.v1") return;
+    if (event.data.type === "render.update") draw(event.data.payload && event.data.payload.content);
+  });
+}());
+`,
+        "assets/player-view-status.css": `body { margin: 0; font: 14px/1.45 system-ui, sans-serif; color: #202020; }
+#player-view-panel-root { display: grid; gap: .5rem; }
+#player-view-panel-root[data-theme="parchment"] { color: #4a382b; background: #fffaf1; padding: .75rem; border-radius: .65rem; }
+#player-view-panel-root dl { display: grid; gap: .45rem; margin: 0; }
+#player-view-panel-root[data-layout="grid"] dl { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+#player-view-panel-root dl > div { display: grid; gap: .15rem; }
+#player-view-panel-root dt { font-weight: 650; }
+#player-view-panel-root dd { margin: 0; }
+#player-view-panel-root ul, #player-view-panel-root dl dl { margin: .25rem 0 0 1rem; padding-left: 1rem; }
+.player-view-empty { color: #6c6259; }
+`,
+    };
+}
+export const firstPartyStatusPanelPresetFiles = firstPartyStatusPanelPresetFilesForLocale("en");

package/dist/node/shared/play-preset-prompt-roles.js

@@ -0,0 +1,4 @@
+export const playPresetPromptRoles = ["author_instruction"];
+export function isPlayPresetPromptRole(value) {
+    return playPresetPromptRoles.some((role) => role === value);
+}