BlueGit

timfa questward

Merge branch 'feature/dialogue-text-replacements'

timfa Tim Falken · pushed by timfa

Authored 2026-09-07 · 2 months ago

Hash
05f23aa92206219293e7cc4a01e54c08e2d06de9
8 files changed +450 −11
client/editor.html +30 −1
@@ -118,7 +118,10 @@
118 118 <div id="dialogues-backdrop" hidden></div>
119 119 <div id="dialogues-modal" hidden>
120 120 <header>
121 <h2>Dialogues</h2>
121 <div class="dialogues-header-title">
122 <h2>Dialogues</h2>
123 <button id="dialogues-tokens-help" type="button" title="Text replacements" aria-label="Text replacements help">?</button>
124 </div>
122 125 <button id="dialogues-close" type="button">Close</button>
123 126 </header>
124 127 <div class="content-editor-layout">
@@ -135,6 +138,32 @@
135 138 </footer>
136 139 </div>
137 140
141 <div id="dialogue-tokens-backdrop" hidden></div>
142 <div id="dialogue-tokens-modal" hidden>
143 <header>
144 <h2>Dialogue text replacements</h2>
145 <button id="dialogue-tokens-close" type="button">Close</button>
146 </header>
147 <div class="dialogue-tokens-body">
148 <ul id="dialogue-tokens-list" class="dialogue-tokens-list"></ul>
149 <label class="dialogue-tokens-preview-label">
150 <span>Try a line</span>
151 <input id="dialogue-tokens-preview-input" type="text" autocomplete="off"
152 placeholder="Hello [Mr] [playername], how is [his] day?" />
153 </label>
154 <div class="dialogue-tokens-preview-row">
155 <div class="dialogue-tokens-preview-col">
156 <strong>Male</strong>
157 <p id="dialogue-tokens-preview-male" class="dialogue-tokens-preview-out"></p>
158 </div>
159 <div class="dialogue-tokens-preview-col">
160 <strong>Female</strong>
161 <p id="dialogue-tokens-preview-female" class="dialogue-tokens-preview-out"></p>
162 </div>
163 </div>
164 </div>
165 </div>
166
138 167 <div id="dialogue-simulate-backdrop" hidden></div>
139 168 <aside id="dialogue-simulate-panel" hidden>
140 169 <header>
@@ -118,7 +118,10 @@
118 <div id="dialogues-backdrop" hidden></div>
118 <div id="dialogues-backdrop" hidden></div>
119 <div id="dialogues-modal" hidden>
119 <div id="dialogues-modal" hidden>
120 <header>
120 <header>
121 <h2>Dialogues</h2>
121 <div class="dialogues-header-title">
122 <h2>Dialogues</h2>
123 <button id="dialogues-tokens-help" type="button" title="Text replacements" aria-label="Text replacements help">?</button>
124 </div>
122 <button id="dialogues-close" type="button">Close</button>
125 <button id="dialogues-close" type="button">Close</button>
123 </header>
126 </header>
124 <div class="content-editor-layout">
127 <div class="content-editor-layout">
@@ -135,6 +138,32 @@
135 </footer>
138 </footer>
136 </div>
139 </div>
137
140
141 <div id="dialogue-tokens-backdrop" hidden></div>
142 <div id="dialogue-tokens-modal" hidden>
143 <header>
144 <h2>Dialogue text replacements</h2>
145 <button id="dialogue-tokens-close" type="button">Close</button>
146 </header>
147 <div class="dialogue-tokens-body">
148 <ul id="dialogue-tokens-list" class="dialogue-tokens-list"></ul>
149 <label class="dialogue-tokens-preview-label">
150 <span>Try a line</span>
151 <input id="dialogue-tokens-preview-input" type="text" autocomplete="off"
152 placeholder="Hello [Mr] [playername], how is [his] day?" />
153 </label>
154 <div class="dialogue-tokens-preview-row">
155 <div class="dialogue-tokens-preview-col">
156 <strong>Male</strong>
157 <p id="dialogue-tokens-preview-male" class="dialogue-tokens-preview-out"></p>
158 </div>
159 <div class="dialogue-tokens-preview-col">
160 <strong>Female</strong>
161 <p id="dialogue-tokens-preview-female" class="dialogue-tokens-preview-out"></p>
162 </div>
163 </div>
164 </div>
165 </div>
166
138 <div id="dialogue-simulate-backdrop" hidden></div>
167 <div id="dialogue-simulate-backdrop" hidden></div>
139 <aside id="dialogue-simulate-panel" hidden>
168 <aside id="dialogue-simulate-panel" hidden>
140 <header>
169 <header>
client/src/editor/dialogueSimulate.js +11 −2
@@ -9,8 +9,14 @@ import {
9 9 formatDialogueQuestRewardMessage,
10 10 formatDialogueTakeMessage
11 11 } from "/shared/quests/dialogueRewards.js";
12 import { applyDialogueTextReplacements } from "/shared/speech/dialogueText.js";
12 13
13 14 const ICON = 48;
15 const SIM_IDENTITY = Object.freeze({
16 firstName: "Ada",
17 lastName: "Worker",
18 sex: "male"
19 });
14 20
15 21 /**
16 22 * @param {{
@@ -212,7 +218,10 @@ export function initDialogueSimulate ({ getTree, getQuestTitle = null } = {})
212 218 {
213 219 const btn = document.createElement("button");
214 220 btn.type = "button";
215 btn.textContent = trig.text || trig.trigger || "…";
221 btn.textContent = applyDialogueTextReplacements(
222 trig.text || trig.trigger || "…",
223 SIM_IDENTITY
224 );
216 225 btn.addEventListener("click", () =>
217 226 {
218 227 if (trig.nextStepId)
@@ -308,7 +317,7 @@ export function initDialogueSimulate ({ getTree, getQuestTitle = null } = {})
308 317 row.className = `dialogue-simulate-line dialogue-simulate-${speaker}`;
309 318 row.append(speakerIcon(speaker));
310 319 const text = document.createElement("span");
311 text.textContent = line.text ?? "";
320 text.textContent = applyDialogueTextReplacements(line.text ?? "", SIM_IDENTITY);
312 321 row.append(text);
313 322 linesEl.append(row);
314 323 }
@@ -9,8 +9,14 @@ import {
9 formatDialogueQuestRewardMessage,
9 formatDialogueQuestRewardMessage,
10 formatDialogueTakeMessage
10 formatDialogueTakeMessage
11} from "/shared/quests/dialogueRewards.js";
11} from "/shared/quests/dialogueRewards.js";
12import { applyDialogueTextReplacements } from "/shared/speech/dialogueText.js";
12
13
13const ICON = 48;
14const ICON = 48;
15const SIM_IDENTITY = Object.freeze({
16 firstName: "Ada",
17 lastName: "Worker",
18 sex: "male"
19});
14
20
15/**
21/**
16 * @param {{
22 * @param {{
@@ -212,7 +218,10 @@ export function initDialogueSimulate ({ getTree, getQuestTitle = null } = {})
212 {
218 {
213 const btn = document.createElement("button");
219 const btn = document.createElement("button");
214 btn.type = "button";
220 btn.type = "button";
215 btn.textContent = trig.text || trig.trigger || "…";
221 btn.textContent = applyDialogueTextReplacements(
222 trig.text || trig.trigger || "…",
223 SIM_IDENTITY
224 );
216 btn.addEventListener("click", () =>
225 btn.addEventListener("click", () =>
217 {
226 {
218 if (trig.nextStepId)
227 if (trig.nextStepId)
@@ -308,7 +317,7 @@ export function initDialogueSimulate ({ getTree, getQuestTitle = null } = {})
308 row.className = `dialogue-simulate-line dialogue-simulate-${speaker}`;
317 row.className = `dialogue-simulate-line dialogue-simulate-${speaker}`;
309 row.append(speakerIcon(speaker));
318 row.append(speakerIcon(speaker));
310 const text = document.createElement("span");
319 const text = document.createElement("span");
311 text.textContent = line.text ?? "";
320 text.textContent = applyDialogueTextReplacements(line.text ?? "", SIM_IDENTITY);
312 row.append(text);
321 row.append(text);
313 linesEl.append(row);
322 linesEl.append(row);
314 }
323 }
client/src/editor/dialoguesModal.js +74 −1
@@ -4,6 +4,10 @@ import {
4 4 dialogueTakeIsUnguaranteed,
5 5 unguaranteedDialogueTakes
6 6 } from "/shared/quests/dialoguePathTakes.js";
7 import {
8 applyDialogueTextReplacements,
9 dialogueReplacementCatalog
10 } from "/shared/speech/dialogueText.js";
7 11 import { itemDefinition, listAllItemPickerEntries } from "/shared/definitions/items.js";
8 12 import { renderConditionSet } from "./conditionSetEditor.js";
9 13 import { initDialogueSimulate } from "./dialogueSimulate.js";
@@ -23,7 +27,14 @@ export function initDialoguesModal ({
23 27 const saveBtn = document.getElementById("dialogues-save");
24 28 const deleteBtn = document.getElementById("dialogues-delete");
25 29 const simulateBtn = document.getElementById("dialogues-simulate");
30 const tokensBackdrop = document.getElementById("dialogue-tokens-backdrop");
31 const tokensModal = document.getElementById("dialogue-tokens-modal");
32 const tokensList = document.getElementById("dialogue-tokens-list");
33 const tokensPreviewInput = document.getElementById("dialogue-tokens-preview-input");
34 const tokensPreviewMale = document.getElementById("dialogue-tokens-preview-male");
35 const tokensPreviewFemale = document.getElementById("dialogue-tokens-preview-female");
26 36 let open = false;
37 let tokensHelpOpen = false;
27 38 /** @type {any[]} */
28 39 let dialogues = [];
29 40 /** @type {ReturnType<typeof normalizeQuestDef>[]} */
@@ -51,10 +62,65 @@ export function initDialoguesModal ({
51 62 draft = null;
52 63 selectedId = null;
53 64 closeInlineItemSearch();
65 showTokensHelp(false);
54 66 simulate.close();
55 67 }
56 68 }
57 69
70 function showTokensHelp (visible)
71 {
72 tokensHelpOpen = visible;
73 if (tokensBackdrop)
74 { tokensBackdrop.hidden = !visible; }
75 if (tokensModal)
76 { tokensModal.hidden = !visible; }
77 if (visible)
78 {
79 renderTokensHelp();
80 tokensPreviewInput?.focus();
81 }
82 }
83
84 function renderTokensHelp ()
85 {
86 if (tokensList)
87 {
88 tokensList.replaceChildren();
89 for (const entry of dialogueReplacementCatalog())
90 {
91 const li = document.createElement("li");
92 const code = document.createElement("code");
93 code.textContent = entry.token;
94 li.append(code, document.createTextNode(` — ${entry.meaning}`));
95 tokensList.append(li);
96 }
97 }
98 updateTokensPreview();
99 }
100
101 function updateTokensPreview ()
102 {
103 const sample = tokensPreviewInput?.value
104 || "Hello [Mr] [playername]. May [he] bring [his] [man]’s courage?";
105 if (tokensPreviewInput && !tokensPreviewInput.value)
106 { tokensPreviewInput.placeholder = sample; }
107 const text = tokensPreviewInput?.value || sample;
108 const male = applyDialogueTextReplacements(text, {
109 firstName: "Ada",
110 lastName: "Worker",
111 sex: "male"
112 });
113 const female = applyDialogueTextReplacements(text, {
114 firstName: "Ada",
115 lastName: "Worker",
116 sex: "female"
117 });
118 if (tokensPreviewMale)
119 { tokensPreviewMale.textContent = male; }
120 if (tokensPreviewFemale)
121 { tokensPreviewFemale.textContent = female; }
122 }
123
58 124 /** @type {null | {
59 125 * step: object,
60 126 * field: "itemRewards" | "itemTakes",
@@ -644,6 +710,13 @@ export function initDialoguesModal ({
644 710 });
645 711 document.getElementById("dialogues-close").addEventListener("click", () => show(false));
646 712 backdrop.addEventListener("click", () => show(false));
713 document.getElementById("dialogues-tokens-help")?.addEventListener("click", () =>
714 {
715 showTokensHelp(true);
716 });
717 document.getElementById("dialogue-tokens-close")?.addEventListener("click", () => showTokensHelp(false));
718 tokensBackdrop?.addEventListener("click", () => showTokensHelp(false));
719 tokensPreviewInput?.addEventListener("input", () => updateTokensPreview());
647 720 simulateBtn?.addEventListener("click", () =>
648 721 {
649 722 if (!draft)
@@ -677,7 +750,7 @@ export function initDialoguesModal ({
677 750 });
678 751
679 752 return {
680 isOpen: () => open || simulate.isOpen(),
753 isOpen: () => open || tokensHelpOpen || simulate.isOpen(),
681 754 getDialogues: () => dialogues,
682 755 handleMessage (message)
683 756 {
@@ -4,6 +4,10 @@ import {
4 dialogueTakeIsUnguaranteed,
4 dialogueTakeIsUnguaranteed,
5 unguaranteedDialogueTakes
5 unguaranteedDialogueTakes
6} from "/shared/quests/dialoguePathTakes.js";
6} from "/shared/quests/dialoguePathTakes.js";
7import {
8 applyDialogueTextReplacements,
9 dialogueReplacementCatalog
10} from "/shared/speech/dialogueText.js";
7import { itemDefinition, listAllItemPickerEntries } from "/shared/definitions/items.js";
11import { itemDefinition, listAllItemPickerEntries } from "/shared/definitions/items.js";
8import { renderConditionSet } from "./conditionSetEditor.js";
12import { renderConditionSet } from "./conditionSetEditor.js";
9import { initDialogueSimulate } from "./dialogueSimulate.js";
13import { initDialogueSimulate } from "./dialogueSimulate.js";
@@ -23,7 +27,14 @@ export function initDialoguesModal ({
23 const saveBtn = document.getElementById("dialogues-save");
27 const saveBtn = document.getElementById("dialogues-save");
24 const deleteBtn = document.getElementById("dialogues-delete");
28 const deleteBtn = document.getElementById("dialogues-delete");
25 const simulateBtn = document.getElementById("dialogues-simulate");
29 const simulateBtn = document.getElementById("dialogues-simulate");
30 const tokensBackdrop = document.getElementById("dialogue-tokens-backdrop");
31 const tokensModal = document.getElementById("dialogue-tokens-modal");
32 const tokensList = document.getElementById("dialogue-tokens-list");
33 const tokensPreviewInput = document.getElementById("dialogue-tokens-preview-input");
34 const tokensPreviewMale = document.getElementById("dialogue-tokens-preview-male");
35 const tokensPreviewFemale = document.getElementById("dialogue-tokens-preview-female");
26 let open = false;
36 let open = false;
37 let tokensHelpOpen = false;
27 /** @type {any[]} */
38 /** @type {any[]} */
28 let dialogues = [];
39 let dialogues = [];
29 /** @type {ReturnType<typeof normalizeQuestDef>[]} */
40 /** @type {ReturnType<typeof normalizeQuestDef>[]} */
@@ -51,10 +62,65 @@ export function initDialoguesModal ({
51 draft = null;
62 draft = null;
52 selectedId = null;
63 selectedId = null;
53 closeInlineItemSearch();
64 closeInlineItemSearch();
65 showTokensHelp(false);
54 simulate.close();
66 simulate.close();
55 }
67 }
56 }
68 }
57
69
70 function showTokensHelp (visible)
71 {
72 tokensHelpOpen = visible;
73 if (tokensBackdrop)
74 { tokensBackdrop.hidden = !visible; }
75 if (tokensModal)
76 { tokensModal.hidden = !visible; }
77 if (visible)
78 {
79 renderTokensHelp();
80 tokensPreviewInput?.focus();
81 }
82 }
83
84 function renderTokensHelp ()
85 {
86 if (tokensList)
87 {
88 tokensList.replaceChildren();
89 for (const entry of dialogueReplacementCatalog())
90 {
91 const li = document.createElement("li");
92 const code = document.createElement("code");
93 code.textContent = entry.token;
94 li.append(code, document.createTextNode(` — ${entry.meaning}`));
95 tokensList.append(li);
96 }
97 }
98 updateTokensPreview();
99 }
100
101 function updateTokensPreview ()
102 {
103 const sample = tokensPreviewInput?.value
104 || "Hello [Mr] [playername]. May [he] bring [his] [man]’s courage?";
105 if (tokensPreviewInput && !tokensPreviewInput.value)
106 { tokensPreviewInput.placeholder = sample; }
107 const text = tokensPreviewInput?.value || sample;
108 const male = applyDialogueTextReplacements(text, {
109 firstName: "Ada",
110 lastName: "Worker",
111 sex: "male"
112 });
113 const female = applyDialogueTextReplacements(text, {
114 firstName: "Ada",
115 lastName: "Worker",
116 sex: "female"
117 });
118 if (tokensPreviewMale)
119 { tokensPreviewMale.textContent = male; }
120 if (tokensPreviewFemale)
121 { tokensPreviewFemale.textContent = female; }
122 }
123
58 /** @type {null | {
124 /** @type {null | {
59 * step: object,
125 * step: object,
60 * field: "itemRewards" | "itemTakes",
126 * field: "itemRewards" | "itemTakes",
@@ -644,6 +710,13 @@ export function initDialoguesModal ({
644 });
710 });
645 document.getElementById("dialogues-close").addEventListener("click", () => show(false));
711 document.getElementById("dialogues-close").addEventListener("click", () => show(false));
646 backdrop.addEventListener("click", () => show(false));
712 backdrop.addEventListener("click", () => show(false));
713 document.getElementById("dialogues-tokens-help")?.addEventListener("click", () =>
714 {
715 showTokensHelp(true);
716 });
717 document.getElementById("dialogue-tokens-close")?.addEventListener("click", () => showTokensHelp(false));
718 tokensBackdrop?.addEventListener("click", () => showTokensHelp(false));
719 tokensPreviewInput?.addEventListener("input", () => updateTokensPreview());
647 simulateBtn?.addEventListener("click", () =>
720 simulateBtn?.addEventListener("click", () =>
648 {
721 {
649 if (!draft)
722 if (!draft)
@@ -677,7 +750,7 @@ export function initDialoguesModal ({
677 });
750 });
678
751
679 return {
752 return {
680 isOpen: () => open || simulate.isOpen(),
753 isOpen: () => open || tokensHelpOpen || simulate.isOpen(),
681 getDialogues: () => dialogues,
754 getDialogues: () => dialogues,
682 handleMessage (message)
755 handleMessage (message)
683 {
756 {
client/src/play/dialogue.js +19 −2
@@ -3,6 +3,8 @@
3 3 * Speaker icons are live WebGL portraits from WorldView (same stack as the world).
4 4 */
5 5
6 import { applyDialogueTextReplacements } from "/shared/speech/dialogueText.js";
7
6 8 const SPEAKER_ICON_SIZE = 64;
7 9
8 10 export function initDialogue ({ socket, MessageType, getEntity, captureSpeakerIcon })
@@ -32,6 +34,21 @@ export function initDialogue ({ socket, MessageType, getEntity, captureSpeakerIc
32 34 { current = null; }
33 35 }
34 36
37 function localIdentity ()
38 {
39 const entity = getEntity?.("local") ?? null;
40 return {
41 firstName: String(entity?.firstName ?? "").trim(),
42 lastName: String(entity?.lastName ?? "").trim(),
43 sex: entity?.sex === "female" ? "female" : "male"
44 };
45 }
46
47 function formatDialogueText (text)
48 {
49 return applyDialogueTextReplacements(text, localIdentity());
50 }
51
35 52 function speakerEntity (speaker)
36 53 {
37 54 if (speaker === "player")
@@ -137,7 +154,7 @@ export function initDialogue ({ socket, MessageType, getEntity, captureSpeakerIc
137 154 row.append(speakerIconCanvas(speaker));
138 155 const text = document.createElement("span");
139 156 text.className = "dialogue-line-text";
140 text.textContent = line.text ?? "";
157 text.textContent = formatDialogueText(line.text ?? "");
141 158 row.append(text);
142 159 linesEl?.append(row);
143 160 }
@@ -194,7 +211,7 @@ export function initDialogue ({ socket, MessageType, getEntity, captureSpeakerIc
194 211 {
195 212 const btn = document.createElement("button");
196 213 btn.type = "button";
197 btn.textContent = trig.text || trig.trigger || "…";
214 btn.textContent = formatDialogueText(trig.text || trig.trigger || "…");
198 215 btn.addEventListener("click", () =>
199 216 {
200 217 socket.send({
@@ -3,6 +3,8 @@
3 * Speaker icons are live WebGL portraits from WorldView (same stack as the world).
3 * Speaker icons are live WebGL portraits from WorldView (same stack as the world).
4 */
4 */
5
5
6import { applyDialogueTextReplacements } from "/shared/speech/dialogueText.js";
7
6const SPEAKER_ICON_SIZE = 64;
8const SPEAKER_ICON_SIZE = 64;
7
9
8export function initDialogue ({ socket, MessageType, getEntity, captureSpeakerIcon })
10export function initDialogue ({ socket, MessageType, getEntity, captureSpeakerIcon })
@@ -32,6 +34,21 @@ export function initDialogue ({ socket, MessageType, getEntity, captureSpeakerIc
32 { current = null; }
34 { current = null; }
33 }
35 }
34
36
37 function localIdentity ()
38 {
39 const entity = getEntity?.("local") ?? null;
40 return {
41 firstName: String(entity?.firstName ?? "").trim(),
42 lastName: String(entity?.lastName ?? "").trim(),
43 sex: entity?.sex === "female" ? "female" : "male"
44 };
45 }
46
47 function formatDialogueText (text)
48 {
49 return applyDialogueTextReplacements(text, localIdentity());
50 }
51
35 function speakerEntity (speaker)
52 function speakerEntity (speaker)
36 {
53 {
37 if (speaker === "player")
54 if (speaker === "player")
@@ -137,7 +154,7 @@ export function initDialogue ({ socket, MessageType, getEntity, captureSpeakerIc
137 row.append(speakerIconCanvas(speaker));
154 row.append(speakerIconCanvas(speaker));
138 const text = document.createElement("span");
155 const text = document.createElement("span");
139 text.className = "dialogue-line-text";
156 text.className = "dialogue-line-text";
140 text.textContent = line.text ?? "";
157 text.textContent = formatDialogueText(line.text ?? "");
141 row.append(text);
158 row.append(text);
142 linesEl?.append(row);
159 linesEl?.append(row);
143 }
160 }
@@ -194,7 +211,7 @@ export function initDialogue ({ socket, MessageType, getEntity, captureSpeakerIc
194 {
211 {
195 const btn = document.createElement("button");
212 const btn = document.createElement("button");
196 btn.type = "button";
213 btn.type = "button";
197 btn.textContent = trig.text || trig.trigger || "…";
214 btn.textContent = formatDialogueText(trig.text || trig.trigger || "…");
198 btn.addEventListener("click", () =>
215 btn.addEventListener("click", () =>
199 {
216 {
200 socket.send({
217 socket.send({
client/ui/editor.css +116 −3
@@ -1285,16 +1285,29 @@ label {
1285 1285
1286 1286 #quests-backdrop,
1287 1287 #dialogues-backdrop,
1288 #gifts-backdrop {
1288 #gifts-backdrop,
1289 #dialogue-tokens-backdrop {
1289 1290 position: fixed;
1290 1291 inset: 0;
1291 1292 background: rgba(0, 0, 0, 0.62);
1292 1293 z-index: 19;
1293 1294 }
1294 1295
1296 #dialogue-tokens-backdrop {
1297 z-index: 21;
1298 }
1299
1300 #dialogue-tokens-modal {
1301 z-index: 22;
1302 inset: 12vh 18vw;
1303 max-width: 720px;
1304 margin: 0 auto;
1305 }
1306
1295 1307 #quests-modal,
1296 1308 #dialogues-modal,
1297 #gifts-modal {
1309 #gifts-modal,
1310 #dialogue-tokens-modal {
1298 1311 position: fixed;
1299 1312 inset: 5vh 5vw;
1300 1313 z-index: 20;
@@ -1310,13 +1323,16 @@ label {
1310 1323 #dialogues-modal[hidden],
1311 1324 #dialogues-backdrop[hidden],
1312 1325 #gifts-modal[hidden],
1313 #gifts-backdrop[hidden] {
1326 #gifts-backdrop[hidden],
1327 #dialogue-tokens-modal[hidden],
1328 #dialogue-tokens-backdrop[hidden] {
1314 1329 display: none !important;
1315 1330 }
1316 1331
1317 1332 #quests-modal>header,
1318 1333 #dialogues-modal>header,
1319 1334 #gifts-modal>header,
1335 #dialogue-tokens-modal>header,
1320 1336 #quests-modal>footer,
1321 1337 #dialogues-modal>footer {
1322 1338 display: flex;
@@ -1728,3 +1744,100 @@ label {
1728 1744 .dialogue-item-take-unguaranteed .spawner-sells-name {
1729 1745 color: #e8c84a;
1730 1746 }
1747
1748 .dialogues-header-title {
1749 display: flex;
1750 align-items: center;
1751 gap: 0.55rem;
1752 }
1753
1754 .dialogues-header-title h2 {
1755 margin: 0;
1756 }
1757
1758 #dialogues-tokens-help {
1759 width: 1.55rem;
1760 height: 1.55rem;
1761 border-radius: 999px;
1762 border: 1px solid #5a6578;
1763 background: #1c2230;
1764 color: #d6d1c4;
1765 font: inherit;
1766 font-size: 0.85rem;
1767 font-weight: 700;
1768 line-height: 1;
1769 cursor: pointer;
1770 padding: 0;
1771 }
1772
1773 #dialogues-tokens-help:hover {
1774 border-color: #e0a84a;
1775 color: #e8c84a;
1776 }
1777
1778 .dialogue-tokens-body {
1779 padding: 0.85rem 1rem 1.1rem;
1780 overflow: auto;
1781 display: flex;
1782 flex-direction: column;
1783 gap: 0.85rem;
1784 }
1785
1786 .dialogue-tokens-list {
1787 margin: 0;
1788 padding-left: 1.15rem;
1789 display: grid;
1790 gap: 0.25rem;
1791 color: #c5d4e8;
1792 font-size: 0.92rem;
1793 }
1794
1795 .dialogue-tokens-list code {
1796 color: #e8c84a;
1797 font-size: 0.88rem;
1798 }
1799
1800 .dialogue-tokens-preview-label {
1801 display: flex;
1802 flex-direction: column;
1803 gap: 0.35rem;
1804 color: #d6d1c4;
1805 font-size: 0.9rem;
1806 }
1807
1808 .dialogue-tokens-preview-label input {
1809 font: inherit;
1810 padding: 0.45rem 0.6rem;
1811 border: 1px solid #3a4250;
1812 border-radius: 4px;
1813 background: #12151c;
1814 color: #f0ebe0;
1815 }
1816
1817 .dialogue-tokens-preview-row {
1818 display: grid;
1819 grid-template-columns: 1fr 1fr;
1820 gap: 0.75rem;
1821 }
1822
1823 .dialogue-tokens-preview-col {
1824 border: 1px solid #2c3340;
1825 border-radius: 4px;
1826 padding: 0.55rem 0.65rem;
1827 background: #12151c;
1828 }
1829
1830 .dialogue-tokens-preview-col strong {
1831 display: block;
1832 margin-bottom: 0.35rem;
1833 color: #d6d1c4;
1834 font-size: 0.85rem;
1835 }
1836
1837 .dialogue-tokens-preview-out {
1838 margin: 0;
1839 min-height: 2.4rem;
1840 color: #f0ebe0;
1841 white-space: pre-wrap;
1842 word-break: break-word;
1843 }
@@ -1285,16 +1285,29 @@ label {
1285
1285
1286#quests-backdrop,
1286#quests-backdrop,
1287#dialogues-backdrop,
1287#dialogues-backdrop,
1288#gifts-backdrop {
1288#gifts-backdrop,
1289#dialogue-tokens-backdrop {
1289 position: fixed;
1290 position: fixed;
1290 inset: 0;
1291 inset: 0;
1291 background: rgba(0, 0, 0, 0.62);
1292 background: rgba(0, 0, 0, 0.62);
1292 z-index: 19;
1293 z-index: 19;
1293}
1294}
1294
1295
1296#dialogue-tokens-backdrop {
1297 z-index: 21;
1298}
1299
1300#dialogue-tokens-modal {
1301 z-index: 22;
1302 inset: 12vh 18vw;
1303 max-width: 720px;
1304 margin: 0 auto;
1305}
1306
1295#quests-modal,
1307#quests-modal,
1296#dialogues-modal,
1308#dialogues-modal,
1297#gifts-modal {
1309#gifts-modal,
1310#dialogue-tokens-modal {
1298 position: fixed;
1311 position: fixed;
1299 inset: 5vh 5vw;
1312 inset: 5vh 5vw;
1300 z-index: 20;
1313 z-index: 20;
@@ -1310,13 +1323,16 @@ label {
1310#dialogues-modal[hidden],
1323#dialogues-modal[hidden],
1311#dialogues-backdrop[hidden],
1324#dialogues-backdrop[hidden],
1312#gifts-modal[hidden],
1325#gifts-modal[hidden],
1313#gifts-backdrop[hidden] {
1326#gifts-backdrop[hidden],
1327#dialogue-tokens-modal[hidden],
1328#dialogue-tokens-backdrop[hidden] {
1314 display: none !important;
1329 display: none !important;
1315}
1330}
1316
1331
1317#quests-modal>header,
1332#quests-modal>header,
1318#dialogues-modal>header,
1333#dialogues-modal>header,
1319#gifts-modal>header,
1334#gifts-modal>header,
1335#dialogue-tokens-modal>header,
1320#quests-modal>footer,
1336#quests-modal>footer,
1321#dialogues-modal>footer {
1337#dialogues-modal>footer {
1322 display: flex;
1338 display: flex;
@@ -1728,3 +1744,100 @@ label {
1728.dialogue-item-take-unguaranteed .spawner-sells-name {
1744.dialogue-item-take-unguaranteed .spawner-sells-name {
1729 color: #e8c84a;
1745 color: #e8c84a;
1730}
1746}
1747
1748.dialogues-header-title {
1749 display: flex;
1750 align-items: center;
1751 gap: 0.55rem;
1752}
1753
1754.dialogues-header-title h2 {
1755 margin: 0;
1756}
1757
1758#dialogues-tokens-help {
1759 width: 1.55rem;
1760 height: 1.55rem;
1761 border-radius: 999px;
1762 border: 1px solid #5a6578;
1763 background: #1c2230;
1764 color: #d6d1c4;
1765 font: inherit;
1766 font-size: 0.85rem;
1767 font-weight: 700;
1768 line-height: 1;
1769 cursor: pointer;
1770 padding: 0;
1771}
1772
1773#dialogues-tokens-help:hover {
1774 border-color: #e0a84a;
1775 color: #e8c84a;
1776}
1777
1778.dialogue-tokens-body {
1779 padding: 0.85rem 1rem 1.1rem;
1780 overflow: auto;
1781 display: flex;
1782 flex-direction: column;
1783 gap: 0.85rem;
1784}
1785
1786.dialogue-tokens-list {
1787 margin: 0;
1788 padding-left: 1.15rem;
1789 display: grid;
1790 gap: 0.25rem;
1791 color: #c5d4e8;
1792 font-size: 0.92rem;
1793}
1794
1795.dialogue-tokens-list code {
1796 color: #e8c84a;
1797 font-size: 0.88rem;
1798}
1799
1800.dialogue-tokens-preview-label {
1801 display: flex;
1802 flex-direction: column;
1803 gap: 0.35rem;
1804 color: #d6d1c4;
1805 font-size: 0.9rem;
1806}
1807
1808.dialogue-tokens-preview-label input {
1809 font: inherit;
1810 padding: 0.45rem 0.6rem;
1811 border: 1px solid #3a4250;
1812 border-radius: 4px;
1813 background: #12151c;
1814 color: #f0ebe0;
1815}
1816
1817.dialogue-tokens-preview-row {
1818 display: grid;
1819 grid-template-columns: 1fr 1fr;
1820 gap: 0.75rem;
1821}
1822
1823.dialogue-tokens-preview-col {
1824 border: 1px solid #2c3340;
1825 border-radius: 4px;
1826 padding: 0.55rem 0.65rem;
1827 background: #12151c;
1828}
1829
1830.dialogue-tokens-preview-col strong {
1831 display: block;
1832 margin-bottom: 0.35rem;
1833 color: #d6d1c4;
1834 font-size: 0.85rem;
1835}
1836
1837.dialogue-tokens-preview-out {
1838 margin: 0;
1839 min-height: 2.4rem;
1840 color: #f0ebe0;
1841 white-space: pre-wrap;
1842 word-break: break-word;
1843}
server/src/quests/runtime.js +21 −2
@@ -14,6 +14,7 @@ import {
14 14 formatDialogueQuestRewardMessage,
15 15 formatDialogueTakeMessage
16 16 } from "../../../shared/quests/dialogueRewards.js";
17 import { applyDialogueTextReplacements } from "../../../shared/speech/dialogueText.js";
17 18 import {
18 19 formatQuestBankRewardLetterBody,
19 20 QUESTWARD_GIFT_AUTHOR,
@@ -286,11 +287,15 @@ export class QuestRuntime
286 287 return { ok: false, error: "Broken dialogue.", events: priorEvents };
287 288 }
288 289 const events = [...priorEvents];
290 const identity = this.#playerDialogueIdentity(characterId);
289 291 const linePayloads = [];
290 292 for (const line of step.lines)
291 293 {
292 294 this.#applyEffects(characterId, line.effects, playerView, events);
293 linePayloads.push({ speaker: line.speaker, text: line.text });
295 linePayloads.push({
296 speaker: line.speaker,
297 text: applyDialogueTextReplacements(line.text, identity)
298 });
294 299 }
295 300 // Stay open while the client pages lines; resolve exit only on dialogueAdvance.
296 301 // dialogueHeard is marked only when the step fully completes (after rewards).
@@ -389,9 +394,13 @@ export class QuestRuntime
389 394 if (exit.kind === "triggers")
390 395 {
391 396 const ctx = this.buildConditionContext(characterId, playerView);
397 const identity = this.#playerDialogueIdentity(characterId);
392 398 const triggers = (exit.triggers ?? [])
393 399 .filter((t) => evaluateConditionSet(t.when, ctx))
394 .map((t) => ({ trigger: t.trigger, text: t.text }));
400 .map((t) => ({
401 trigger: t.trigger,
402 text: applyDialogueTextReplacements(t.text, identity)
403 }));
395 404 if (triggers.length === 0)
396 405 {
397 406 const npcEntityId = session.entityId;
@@ -541,6 +550,16 @@ export class QuestRuntime
541 550 return bag;
542 551 }
543 552
553 #playerDialogueIdentity (characterId)
554 {
555 const row = this.stateDb.getCharacter(characterId | 0);
556 return {
557 firstName: String(row?.first_name ?? "").trim(),
558 lastName: String(row?.last_name ?? "").trim(),
559 sex: row?.sex === "female" ? "female" : "male"
560 };
561 }
562
544 563 #persistBag (characterId, bag)
545 564 {
546 565 this.stateDb.saveBag(characterId, bag);
@@ -14,6 +14,7 @@ import {
14 formatDialogueQuestRewardMessage,
14 formatDialogueQuestRewardMessage,
15 formatDialogueTakeMessage
15 formatDialogueTakeMessage
16} from "../../../shared/quests/dialogueRewards.js";
16} from "../../../shared/quests/dialogueRewards.js";
17import { applyDialogueTextReplacements } from "../../../shared/speech/dialogueText.js";
17import {
18import {
18 formatQuestBankRewardLetterBody,
19 formatQuestBankRewardLetterBody,
19 QUESTWARD_GIFT_AUTHOR,
20 QUESTWARD_GIFT_AUTHOR,
@@ -286,11 +287,15 @@ export class QuestRuntime
286 return { ok: false, error: "Broken dialogue.", events: priorEvents };
287 return { ok: false, error: "Broken dialogue.", events: priorEvents };
287 }
288 }
288 const events = [...priorEvents];
289 const events = [...priorEvents];
290 const identity = this.#playerDialogueIdentity(characterId);
289 const linePayloads = [];
291 const linePayloads = [];
290 for (const line of step.lines)
292 for (const line of step.lines)
291 {
293 {
292 this.#applyEffects(characterId, line.effects, playerView, events);
294 this.#applyEffects(characterId, line.effects, playerView, events);
293 linePayloads.push({ speaker: line.speaker, text: line.text });
295 linePayloads.push({
296 speaker: line.speaker,
297 text: applyDialogueTextReplacements(line.text, identity)
298 });
294 }
299 }
295 // Stay open while the client pages lines; resolve exit only on dialogueAdvance.
300 // Stay open while the client pages lines; resolve exit only on dialogueAdvance.
296 // dialogueHeard is marked only when the step fully completes (after rewards).
301 // dialogueHeard is marked only when the step fully completes (after rewards).
@@ -389,9 +394,13 @@ export class QuestRuntime
389 if (exit.kind === "triggers")
394 if (exit.kind === "triggers")
390 {
395 {
391 const ctx = this.buildConditionContext(characterId, playerView);
396 const ctx = this.buildConditionContext(characterId, playerView);
397 const identity = this.#playerDialogueIdentity(characterId);
392 const triggers = (exit.triggers ?? [])
398 const triggers = (exit.triggers ?? [])
393 .filter((t) => evaluateConditionSet(t.when, ctx))
399 .filter((t) => evaluateConditionSet(t.when, ctx))
394 .map((t) => ({ trigger: t.trigger, text: t.text }));
400 .map((t) => ({
401 trigger: t.trigger,
402 text: applyDialogueTextReplacements(t.text, identity)
403 }));
395 if (triggers.length === 0)
404 if (triggers.length === 0)
396 {
405 {
397 const npcEntityId = session.entityId;
406 const npcEntityId = session.entityId;
@@ -541,6 +550,16 @@ export class QuestRuntime
541 return bag;
550 return bag;
542 }
551 }
543
552
553 #playerDialogueIdentity (characterId)
554 {
555 const row = this.stateDb.getCharacter(characterId | 0);
556 return {
557 firstName: String(row?.first_name ?? "").trim(),
558 lastName: String(row?.last_name ?? "").trim(),
559 sex: row?.sex === "female" ? "female" : "male"
560 };
561 }
562
544 #persistBag (characterId, bag)
563 #persistBag (characterId, bag)
545 {
564 {
546 this.stateDb.saveBag(characterId, bag);
565 this.stateDb.saveBag(characterId, bag);
server/tests/dialogue-text.test.js added +81 −0
@@ -0,0 +1,81 @@
1 import test from "node:test";
2 import assert from "node:assert/strict";
3 import {
4 applyDialogueTextReplacements,
5 applyTokenCasing,
6 dialogueReplacementCatalog
7 } from "../../shared/speech/dialogueText.js";
8 import { makeCharacter, makeSimulation } from "./helpers/simulationHarness.js";
9 import { normalizeDialogueTree } from "../../shared/quests/normalize.js";
10
11 test("applyTokenCasing follows placeholder case", () =>
12 {
13 assert.equal(applyTokenCasing("mr", "ms"), "ms");
14 assert.equal(applyTokenCasing("Mr", "ms"), "Ms");
15 assert.equal(applyTokenCasing("MR", "ms"), "MS");
16 assert.equal(applyTokenCasing("He", "she"), "She");
17 });
18
19 test("dialogue text replacements cover names and gendered forms", () =>
20 {
21 const male = applyDialogueTextReplacements(
22 "Hello [Mr] [playername] [playersurname]. [He] brings [his] bag, [playerfullname].",
23 { firstName: "Ada", lastName: "Worker", sex: "male" }
24 );
25 assert.equal(male, "Hello Mr Ada Worker. He brings his bag, Ada Worker.");
26
27 const female = applyDialogueTextReplacements(
28 "Hello [Mr] [playername]. [He] / [him] / [his] / [man] / [himself].",
29 { firstName: "Bea", lastName: "Smith", sex: "female" }
30 );
31 assert.equal(female, "Hello Ms Bea. She / her / her / woman / herself.");
32 });
33
34 test("dialogueReplacementCatalog lists player and gender tokens", () =>
35 {
36 const tokens = dialogueReplacementCatalog().map((row) => row.token);
37 assert.ok(tokens.includes("[playername]"));
38 assert.ok(tokens.includes("[playerfullname]"));
39 assert.ok(tokens.includes("[playersurname]"));
40 assert.ok(tokens.includes("[he]"));
41 assert.ok(tokens.includes("[mr]"));
42 });
43
44 test("dialogue step lines are substituted for the player identity", () =>
45 {
46 const harness = makeSimulation({ workerCount: 1 });
47 try
48 {
49 const character = makeCharacter(harness.stateDb, {
50 tileX: 8,
51 tileY: 8,
52 firstName: "Ada",
53 lastName: "Worker",
54 sex: "female"
55 });
56 harness.simulation.spawnCharacter(1, character);
57 harness.simulation.step();
58
59 const tree = normalizeDialogueTree({
60 dialogueId: "greet-name",
61 steps: [{
62 stepId: "hi",
63 lines: [{ speaker: "npc", text: "Welcome, [Mr] [playername]." }]
64 }]
65 });
66 const revisionId = harness.worldDb.getActiveRevisionId();
67 harness.worldDb.saveDialogueTree(revisionId, tree);
68 harness.simulation.questContent.reload();
69
70 const opened = harness.simulation.quests.tryOpenDialogue(
71 character.character_id,
72 9100,
73 "greet-name"
74 );
75 assert.equal(opened.ok, true);
76 const step = (opened.events ?? []).find((e) => e.type === "dialogueStep");
77 assert.equal(step.lines[0].text, "Welcome, Ms Ada.");
78 }
79 finally
80 { harness.close(); }
81 });
@@ -0,0 +1,81 @@
1import test from "node:test";
2import assert from "node:assert/strict";
3import {
4 applyDialogueTextReplacements,
5 applyTokenCasing,
6 dialogueReplacementCatalog
7} from "../../shared/speech/dialogueText.js";
8import { makeCharacter, makeSimulation } from "./helpers/simulationHarness.js";
9import { normalizeDialogueTree } from "../../shared/quests/normalize.js";
10
11test("applyTokenCasing follows placeholder case", () =>
12{
13 assert.equal(applyTokenCasing("mr", "ms"), "ms");
14 assert.equal(applyTokenCasing("Mr", "ms"), "Ms");
15 assert.equal(applyTokenCasing("MR", "ms"), "MS");
16 assert.equal(applyTokenCasing("He", "she"), "She");
17});
18
19test("dialogue text replacements cover names and gendered forms", () =>
20{
21 const male = applyDialogueTextReplacements(
22 "Hello [Mr] [playername] [playersurname]. [He] brings [his] bag, [playerfullname].",
23 { firstName: "Ada", lastName: "Worker", sex: "male" }
24 );
25 assert.equal(male, "Hello Mr Ada Worker. He brings his bag, Ada Worker.");
26
27 const female = applyDialogueTextReplacements(
28 "Hello [Mr] [playername]. [He] / [him] / [his] / [man] / [himself].",
29 { firstName: "Bea", lastName: "Smith", sex: "female" }
30 );
31 assert.equal(female, "Hello Ms Bea. She / her / her / woman / herself.");
32});
33
34test("dialogueReplacementCatalog lists player and gender tokens", () =>
35{
36 const tokens = dialogueReplacementCatalog().map((row) => row.token);
37 assert.ok(tokens.includes("[playername]"));
38 assert.ok(tokens.includes("[playerfullname]"));
39 assert.ok(tokens.includes("[playersurname]"));
40 assert.ok(tokens.includes("[he]"));
41 assert.ok(tokens.includes("[mr]"));
42});
43
44test("dialogue step lines are substituted for the player identity", () =>
45{
46 const harness = makeSimulation({ workerCount: 1 });
47 try
48 {
49 const character = makeCharacter(harness.stateDb, {
50 tileX: 8,
51 tileY: 8,
52 firstName: "Ada",
53 lastName: "Worker",
54 sex: "female"
55 });
56 harness.simulation.spawnCharacter(1, character);
57 harness.simulation.step();
58
59 const tree = normalizeDialogueTree({
60 dialogueId: "greet-name",
61 steps: [{
62 stepId: "hi",
63 lines: [{ speaker: "npc", text: "Welcome, [Mr] [playername]." }]
64 }]
65 });
66 const revisionId = harness.worldDb.getActiveRevisionId();
67 harness.worldDb.saveDialogueTree(revisionId, tree);
68 harness.simulation.questContent.reload();
69
70 const opened = harness.simulation.quests.tryOpenDialogue(
71 character.character_id,
72 9100,
73 "greet-name"
74 );
75 assert.equal(opened.ok, true);
76 const step = (opened.events ?? []).find((e) => e.type === "dialogueStep");
77 assert.equal(step.lines[0].text, "Welcome, Ms Ada.");
78 }
79 finally
80 { harness.close(); }
81});
shared/speech/dialogueText.js added +98 −0
@@ -0,0 +1,98 @@
1 /**
2 * Dialogue line / choice text placeholders:
3 * [playername], [playerfullname], [playersurname], and gendered forms ([he]/[Mr], …).
4 * Gender tokens keep the casing of the placeholder ([He] → She).
5 */
6
7 const NAME_TOKENS = Object.freeze({
8 playername: "firstName",
9 playerfullname: "fullName",
10 playersurname: "lastName"
11 });
12
13 /** Male form → [male, female] lowercase pair. Lookup is case-insensitive. */
14 const GENDERED_TOKENS = Object.freeze({
15 mr: ["mr", "ms"],
16 he: ["he", "she"],
17 him: ["him", "her"],
18 his: ["his", "her"],
19 hers: ["his", "hers"],
20 himself: ["himself", "herself"],
21 man: ["man", "woman"],
22 men: ["men", "women"],
23 male: ["male", "female"],
24 boy: ["boy", "girl"],
25 lad: ["lad", "lass"],
26 brother: ["brother", "sister"],
27 sir: ["sir", "ma'am"],
28 lord: ["lord", "lady"],
29 king: ["king", "queen"],
30 husband: ["husband", "wife"],
31 son: ["son", "daughter"],
32 father: ["father", "mother"],
33 uncle: ["uncle", "aunt"],
34 nephew: ["nephew", "niece"]
35 });
36
37 /**
38 * Catalog for the editor help modal.
39 * @returns {{ token: string, meaning: string }[]}
40 */
41 export function dialogueReplacementCatalog ()
42 {
43 return [
44 { token: "[playername]", meaning: "Player’s first name" },
45 { token: "[playerfullname]", meaning: "Player’s first and last name" },
46 { token: "[playersurname]", meaning: "Player’s last name" },
47 ...Object.entries(GENDERED_TOKENS).map(([key, [male, female]]) => ({
48 token: `[${key}]`,
49 meaning: `${male} / ${female} (casing follows the tag, e.g. [He] → She)`
50 }))
51 ];
52 }
53
54 /**
55 * Apply name + gendered replacements to dialogue text.
56 * @param {string} text
57 * @param {{ firstName?: string, lastName?: string, sex?: string }} identity
58 */
59 export function applyDialogueTextReplacements (text, identity = {})
60 {
61 const raw = String(text ?? "");
62 if (!raw.includes("["))
63 { return raw; }
64 const firstName = String(identity.firstName ?? "").trim() || "Adventurer";
65 const lastName = String(identity.lastName ?? "").trim();
66 const fullName = lastName ? `${firstName} ${lastName}` : firstName;
67 const female = identity.sex === "female";
68 const names = { firstName, lastName: lastName || firstName, fullName };
69
70 return raw.replace(/\[([^\]]+)\]/g, (match, inner) =>
71 {
72 const key = String(inner).trim().toLowerCase();
73 const nameField = NAME_TOKENS[key];
74 if (nameField)
75 { return names[nameField]; }
76 const pair = GENDERED_TOKENS[key];
77 if (!pair)
78 { return match; }
79 const word = female ? pair[1] : pair[0];
80 return applyTokenCasing(inner.trim(), word);
81 });
82 }
83
84 /** Copy casing style from the placeholder body onto the replacement word. */
85 export function applyTokenCasing (template, word)
86 {
87 const src = String(template ?? "");
88 const dest = String(word ?? "");
89 if (!src || !dest)
90 { return dest; }
91 if (src === src.toUpperCase())
92 { return dest.toUpperCase(); }
93 if (src[0] === src[0].toUpperCase() && src.slice(1) === src.slice(1).toLowerCase())
94 {
95 return dest.charAt(0).toUpperCase() + dest.slice(1).toLowerCase();
96 }
97 return dest.toLowerCase();
98 }
@@ -0,0 +1,98 @@
1/**
2 * Dialogue line / choice text placeholders:
3 * [playername], [playerfullname], [playersurname], and gendered forms ([he]/[Mr], …).
4 * Gender tokens keep the casing of the placeholder ([He] → She).
5 */
6
7const NAME_TOKENS = Object.freeze({
8 playername: "firstName",
9 playerfullname: "fullName",
10 playersurname: "lastName"
11});
12
13/** Male form → [male, female] lowercase pair. Lookup is case-insensitive. */
14const GENDERED_TOKENS = Object.freeze({
15 mr: ["mr", "ms"],
16 he: ["he", "she"],
17 him: ["him", "her"],
18 his: ["his", "her"],
19 hers: ["his", "hers"],
20 himself: ["himself", "herself"],
21 man: ["man", "woman"],
22 men: ["men", "women"],
23 male: ["male", "female"],
24 boy: ["boy", "girl"],
25 lad: ["lad", "lass"],
26 brother: ["brother", "sister"],
27 sir: ["sir", "ma'am"],
28 lord: ["lord", "lady"],
29 king: ["king", "queen"],
30 husband: ["husband", "wife"],
31 son: ["son", "daughter"],
32 father: ["father", "mother"],
33 uncle: ["uncle", "aunt"],
34 nephew: ["nephew", "niece"]
35});
36
37/**
38 * Catalog for the editor help modal.
39 * @returns {{ token: string, meaning: string }[]}
40 */
41export function dialogueReplacementCatalog ()
42{
43 return [
44 { token: "[playername]", meaning: "Player’s first name" },
45 { token: "[playerfullname]", meaning: "Player’s first and last name" },
46 { token: "[playersurname]", meaning: "Player’s last name" },
47 ...Object.entries(GENDERED_TOKENS).map(([key, [male, female]]) => ({
48 token: `[${key}]`,
49 meaning: `${male} / ${female} (casing follows the tag, e.g. [He] → She)`
50 }))
51 ];
52}
53
54/**
55 * Apply name + gendered replacements to dialogue text.
56 * @param {string} text
57 * @param {{ firstName?: string, lastName?: string, sex?: string }} identity
58 */
59export function applyDialogueTextReplacements (text, identity = {})
60{
61 const raw = String(text ?? "");
62 if (!raw.includes("["))
63 { return raw; }
64 const firstName = String(identity.firstName ?? "").trim() || "Adventurer";
65 const lastName = String(identity.lastName ?? "").trim();
66 const fullName = lastName ? `${firstName} ${lastName}` : firstName;
67 const female = identity.sex === "female";
68 const names = { firstName, lastName: lastName || firstName, fullName };
69
70 return raw.replace(/\[([^\]]+)\]/g, (match, inner) =>
71 {
72 const key = String(inner).trim().toLowerCase();
73 const nameField = NAME_TOKENS[key];
74 if (nameField)
75 { return names[nameField]; }
76 const pair = GENDERED_TOKENS[key];
77 if (!pair)
78 { return match; }
79 const word = female ? pair[1] : pair[0];
80 return applyTokenCasing(inner.trim(), word);
81 });
82}
83
84/** Copy casing style from the placeholder body onto the replacement word. */
85export function applyTokenCasing (template, word)
86{
87 const src = String(template ?? "");
88 const dest = String(word ?? "");
89 if (!src || !dest)
90 { return dest; }
91 if (src === src.toUpperCase())
92 { return dest.toUpperCase(); }
93 if (src[0] === src[0].toUpperCase() && src.slice(1) === src.slice(1).toLowerCase())
94 {
95 return dest.charAt(0).toUpperCase() + dest.slice(1).toLowerCase();
96 }
97 return dest.toLowerCase();
98}