rpg-engine 0.19.1 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (229) hide show
  1. package/README.md +9 -6
  2. package/dist/adventures/index.d.ts +1 -1
  3. package/dist/adventures/index.js +1 -1
  4. package/dist/adventures/source.d.ts +3 -0
  5. package/dist/adventures/source.js +11 -49
  6. package/dist/campaign/create-campaign.d.ts +1 -1
  7. package/dist/campaign/create-campaign.js +4 -3
  8. package/dist/campaign/find-campaign.d.ts +6 -0
  9. package/dist/campaign/find-campaign.js +7 -1
  10. package/dist/campaign/host-files.js +22 -0
  11. package/dist/campaign/index.d.ts +2 -2
  12. package/dist/campaign/index.js +2 -2
  13. package/dist/campaign/last-choices.d.ts +10 -4
  14. package/dist/campaign/last-choices.js +43 -17
  15. package/dist/campaign/settings.d.ts +10 -2
  16. package/dist/campaign/settings.js +32 -8
  17. package/dist/chats/chat.d.ts +33 -0
  18. package/dist/chats/chat.js +50 -0
  19. package/dist/chats/claude-code.d.ts +5 -0
  20. package/dist/chats/claude-code.js +39 -0
  21. package/dist/chats/codex.d.ts +3 -0
  22. package/dist/chats/codex.js +42 -0
  23. package/dist/chats/index.d.ts +5 -0
  24. package/dist/chats/index.js +12 -0
  25. package/dist/chats/keep.d.ts +10 -0
  26. package/dist/chats/keep.js +50 -0
  27. package/dist/chats/read.d.ts +8 -0
  28. package/dist/chats/read.js +46 -0
  29. package/dist/cli/cli.js +6 -1
  30. package/dist/cli/command-line.js +3 -2
  31. package/dist/commands/book.d.ts +36 -0
  32. package/dist/commands/book.js +129 -0
  33. package/dist/commands/chats.d.ts +38 -0
  34. package/dist/commands/chats.js +93 -0
  35. package/dist/commands/config/config.js +2 -2
  36. package/dist/commands/config/dashboard.d.ts +8 -1
  37. package/dist/commands/config/dashboard.js +70 -16
  38. package/dist/commands/config/words.d.ts +1 -1
  39. package/dist/commands/config/words.js +18 -5
  40. package/dist/commands/find.js +1 -1
  41. package/dist/commands/image.d.ts +14 -0
  42. package/dist/commands/image.js +100 -20
  43. package/dist/commands/index.js +4 -0
  44. package/dist/commands/init.js +3 -3
  45. package/dist/commands/package/data.d.ts +35 -0
  46. package/dist/commands/package/data.js +117 -0
  47. package/dist/commands/package/here.d.ts +7 -2
  48. package/dist/commands/package/here.js +23 -11
  49. package/dist/commands/package/install.js +14 -15
  50. package/dist/commands/package/language.d.ts +15 -0
  51. package/dist/commands/package/language.js +109 -0
  52. package/dist/commands/package/package.js +20 -10
  53. package/dist/commands/package/result.d.ts +19 -0
  54. package/dist/commands/package/theme.d.ts +13 -0
  55. package/dist/commands/package/theme.js +66 -0
  56. package/dist/commands/package/uninstall.d.ts +4 -1
  57. package/dist/commands/package/uninstall.js +29 -9
  58. package/dist/commands/scene/close.d.ts +2 -0
  59. package/dist/commands/scene/close.js +20 -2
  60. package/dist/commands/scene/result.d.ts +2 -0
  61. package/dist/commands/scene/scene.d.ts +2 -0
  62. package/dist/commands/shared/books/adventures.d.ts +0 -4
  63. package/dist/commands/shared/books/adventures.js +2 -31
  64. package/dist/commands/shared/books/words.js +3 -2
  65. package/dist/commands/shared/campaign/book.d.ts +42 -0
  66. package/dist/commands/shared/campaign/book.js +118 -0
  67. package/dist/commands/shared/campaign/chats.d.ts +11 -0
  68. package/dist/commands/shared/campaign/chats.js +29 -0
  69. package/dist/commands/shared/campaign/images.js +7 -1
  70. package/dist/commands/shared/campaign/mode.js +3 -1
  71. package/dist/commands/shared/campaign/saves.js +13 -5
  72. package/dist/commands/shared/campaign/world.js +2 -1
  73. package/dist/commands/shared/packages/catalog.d.ts +3 -3
  74. package/dist/commands/shared/packages/catalog.js +98 -42
  75. package/dist/commands/shared/packages/unpacked.d.ts +50 -0
  76. package/dist/commands/shared/packages/unpacked.js +146 -0
  77. package/dist/commands/shared/sheet/sheet.d.ts +7 -0
  78. package/dist/commands/shared/sheet/sheet.js +27 -0
  79. package/dist/commands/status.d.ts +1 -0
  80. package/dist/commands/status.js +4 -0
  81. package/dist/commands/view/page.js +4 -3
  82. package/dist/commands/view/result.d.ts +2 -0
  83. package/dist/commands/view/view.d.ts +1 -0
  84. package/dist/commands/view/view.js +4 -0
  85. package/dist/core/archive.d.ts +13 -0
  86. package/dist/core/archive.js +76 -0
  87. package/dist/core/consents.d.ts +2 -2
  88. package/dist/core/consents.js +3 -3
  89. package/dist/core/context.d.ts +40 -2
  90. package/dist/core/context.js +1 -0
  91. package/dist/core/download.js +1 -1
  92. package/dist/core/store.d.ts +5 -1
  93. package/dist/core/store.js +15 -2
  94. package/dist/dashboard/acts/names.js +10 -5
  95. package/dist/dashboard/acts/sending.js +5 -2
  96. package/dist/dashboard/acts/sheet.js +66 -15
  97. package/dist/dashboard/api.js +27 -4
  98. package/dist/dashboard/app.js +9 -4
  99. package/dist/dashboard/guide/ar.md +16 -15
  100. package/dist/dashboard/guide/cs.md +15 -14
  101. package/dist/dashboard/guide/da.md +17 -16
  102. package/dist/dashboard/guide/de.md +17 -16
  103. package/dist/dashboard/guide/el.md +17 -16
  104. package/dist/dashboard/guide/en.md +14 -13
  105. package/dist/dashboard/guide/es.md +15 -14
  106. package/dist/dashboard/guide/fi.md +15 -14
  107. package/dist/dashboard/guide/fr.md +20 -19
  108. package/dist/dashboard/guide/he.md +15 -14
  109. package/dist/dashboard/guide/hi.md +15 -14
  110. package/dist/dashboard/guide/hu.md +19 -18
  111. package/dist/dashboard/guide/is.md +15 -14
  112. package/dist/dashboard/guide/it.md +18 -17
  113. package/dist/dashboard/guide/ja.md +15 -14
  114. package/dist/dashboard/guide/ko.md +16 -15
  115. package/dist/dashboard/guide/nb.md +17 -16
  116. package/dist/dashboard/guide/nl.md +15 -14
  117. package/dist/dashboard/guide/pl.md +16 -15
  118. package/dist/dashboard/guide/pt.md +16 -15
  119. package/dist/dashboard/guide/ro.md +15 -14
  120. package/dist/dashboard/guide/ru.md +16 -15
  121. package/dist/dashboard/guide/sv.md +15 -14
  122. package/dist/dashboard/guide/tr.md +18 -17
  123. package/dist/dashboard/guide/uk.md +19 -18
  124. package/dist/dashboard/guide/zh.md +16 -15
  125. package/dist/dashboard/i18n/ar.json +63 -9
  126. package/dist/dashboard/i18n/cs.json +63 -9
  127. package/dist/dashboard/i18n/da.json +63 -9
  128. package/dist/dashboard/i18n/de.json +63 -9
  129. package/dist/dashboard/i18n/el.json +63 -9
  130. package/dist/dashboard/i18n/es.json +63 -9
  131. package/dist/dashboard/i18n/fi.json +63 -9
  132. package/dist/dashboard/i18n/fr.json +63 -9
  133. package/dist/dashboard/i18n/he.json +63 -9
  134. package/dist/dashboard/i18n/hi.json +63 -9
  135. package/dist/dashboard/i18n/hu.json +63 -9
  136. package/dist/dashboard/i18n/is.json +63 -9
  137. package/dist/dashboard/i18n/it.json +64 -10
  138. package/dist/dashboard/i18n/ja.json +63 -9
  139. package/dist/dashboard/i18n/ko.json +63 -9
  140. package/dist/dashboard/i18n/nb.json +63 -9
  141. package/dist/dashboard/i18n/nl.json +63 -9
  142. package/dist/dashboard/i18n/pl.json +63 -9
  143. package/dist/dashboard/i18n/pt.json +63 -9
  144. package/dist/dashboard/i18n/ro.json +63 -9
  145. package/dist/dashboard/i18n/ru.json +63 -9
  146. package/dist/dashboard/i18n/sv.json +63 -9
  147. package/dist/dashboard/i18n/tr.json +63 -9
  148. package/dist/dashboard/i18n/uk.json +63 -9
  149. package/dist/dashboard/i18n/zh.json +63 -9
  150. package/dist/dashboard/journal/book.js +107 -0
  151. package/dist/dashboard/journal/journal.js +16 -12
  152. package/dist/dashboard/kit.js +1 -1
  153. package/dist/dashboard/packages/catalog.js +31 -14
  154. package/dist/dashboard/packages/engine.js +46 -2
  155. package/dist/dashboard/packages/installed.js +13 -0
  156. package/dist/dashboard/packages/outcomes.js +21 -0
  157. package/dist/dashboard/packages/packages.js +41 -18
  158. package/dist/dashboard/packages/rows.js +3 -1
  159. package/dist/dashboard/parts/icons.js +3 -0
  160. package/dist/dashboard/parts/labels.js +6 -0
  161. package/dist/dashboard/parts/picture.js +89 -0
  162. package/dist/dashboard/parts/refusals.js +8 -1
  163. package/dist/dashboard/parts/widgets.js +3 -2
  164. package/dist/dashboard/place/view.js +1 -1
  165. package/dist/dashboard/play/scene.js +8 -5
  166. package/dist/dashboard/settings/settings.js +32 -16
  167. package/dist/dashboard/settings/setup.js +5 -3
  168. package/dist/dashboard/sheet/party.js +5 -2
  169. package/dist/dashboard/sheet/sheet.js +10 -6
  170. package/dist/dashboard/shell/notices.js +2 -2
  171. package/dist/dashboard/shell/system-style.js +45 -12
  172. package/dist/dashboard/shell/tooltip.js +223 -0
  173. package/dist/dashboard/style.css +775 -261
  174. package/dist/dashboard/world/calendar.js +1 -1
  175. package/dist/dashboard/world/lore.js +5 -4
  176. package/dist/dashboard/world/place-card.js +2 -1
  177. package/dist/helpers/briefs.d.ts +5 -0
  178. package/dist/helpers/briefs.js +8 -0
  179. package/dist/helpers/chosen.d.ts +8 -2
  180. package/dist/helpers/chosen.js +110 -6
  181. package/dist/helpers/codex.js +2 -1
  182. package/dist/helpers/index.d.ts +2 -2
  183. package/dist/helpers/index.js +2 -2
  184. package/dist/images/images.d.ts +2 -0
  185. package/dist/images/images.js +16 -2
  186. package/dist/images/index.d.ts +1 -1
  187. package/dist/images/index.js +1 -1
  188. package/dist/languages/index.d.ts +1 -1
  189. package/dist/languages/index.js +1 -1
  190. package/dist/languages/pack.d.ts +4 -1
  191. package/dist/languages/pack.js +16 -5
  192. package/dist/packages/engine.d.ts +7 -0
  193. package/dist/packages/engine.js +32 -1
  194. package/dist/packages/index.d.ts +1 -1
  195. package/dist/packages/index.js +1 -1
  196. package/dist/server/approver.d.ts +6 -0
  197. package/dist/server/approver.js +28 -0
  198. package/dist/server/chats.d.ts +3 -0
  199. package/dist/server/chats.js +27 -0
  200. package/dist/server/dashboard/engine.d.ts +18 -0
  201. package/dist/server/dashboard/engine.js +31 -0
  202. package/dist/server/dashboard/files.d.ts +8 -1
  203. package/dist/server/dashboard/files.js +30 -10
  204. package/dist/server/dashboard/index.d.ts +3 -0
  205. package/dist/server/dashboard/index.js +10 -1
  206. package/dist/server/dashboard/news.js +36 -5
  207. package/dist/server/dashboard/pictures.d.ts +7 -0
  208. package/dist/server/dashboard/pictures.js +62 -0
  209. package/dist/server/dashboard/writes.d.ts +5 -3
  210. package/dist/server/dashboard/writes.js +45 -14
  211. package/dist/server/mcp.js +37 -6
  212. package/dist/server/player-acts.d.ts +7 -2
  213. package/dist/server/player-acts.js +10 -3
  214. package/dist/testing/index.js +1 -0
  215. package/dist/themes/index.d.ts +2 -1
  216. package/dist/themes/index.js +4 -2
  217. package/dist/themes/installed.d.ts +14 -0
  218. package/dist/themes/installed.js +28 -0
  219. package/dist/themes/theme.d.ts +7 -0
  220. package/dist/themes/theme.js +22 -0
  221. package/instructions/core.md +3 -3
  222. package/instructions/dashboard-guide.md +1 -0
  223. package/instructions/mentor-hints.md +1 -1
  224. package/instructions/mentor-tutorial.md +1 -1
  225. package/instructions/party.md +1 -1
  226. package/instructions/play.md +2 -2
  227. package/instructions/start.md +1 -1
  228. package/package.json +2 -2
  229. package/systems/free/instructions/outcomes-told.md +1 -1
@@ -0,0 +1,18 @@
1
+ import type { EngineUpdater } from "../../core/context.ts";
2
+ import type { Served } from "./index.ts";
3
+ /** npm's latest version of rpg-engine, or why npm could not be asked. */
4
+ export type EngineLatest = {
5
+ version: string;
6
+ } | {
7
+ failed: string;
8
+ };
9
+ /** The last time this server asked npm: when, what it is answering, and whether it failed. */
10
+ export interface EngineAsked {
11
+ at: number;
12
+ latest: Promise<EngineLatest>;
13
+ failed: boolean;
14
+ }
15
+ /** npm's latest rpg-engine as known today: asked by this server or kept from today's check, else asked now and kept. */
16
+ export declare function knownLatest(served: Served, updater: EngineUpdater): Promise<EngineLatest>;
17
+ /** Asks npm for its latest rpg-engine now, and keeps what it said for the page. */
18
+ export declare function askLatest(served: Served, updater: EngineUpdater): Promise<EngineLatest>;
@@ -0,0 +1,31 @@
1
+ import { keepLatestEngine, keptLatestEngine } from "../../packages/index.js";
2
+ const checkHolds = 24 * 60 * 60 * 1000;
3
+ const retryAfter = 60 * 60 * 1000;
4
+ /** npm's latest rpg-engine as known today: asked by this server or kept from today's check, else asked now and kept. */
5
+ export async function knownLatest(served, updater) {
6
+ const now = served.context.now().getTime();
7
+ const asked = served.engineLatest;
8
+ if (asked !== undefined && now - asked.at >= 0 && now - asked.at < (asked.failed ? retryAfter : checkHolds)) {
9
+ return await asked.latest;
10
+ }
11
+ const kept = keptLatestEngine(served.context.home, now);
12
+ if (kept !== undefined) {
13
+ served.engineLatest = { at: kept.checked, latest: Promise.resolve({ version: kept.version }), failed: false };
14
+ return { version: kept.version };
15
+ }
16
+ return await askLatest(served, updater);
17
+ }
18
+ /** Asks npm for its latest rpg-engine now, and keeps what it said for the page. */
19
+ export async function askLatest(served, updater) {
20
+ const now = served.context.now().getTime();
21
+ const asking = { at: now, latest: updater.latest(), failed: false };
22
+ served.engineLatest = asking;
23
+ const latest = await asking.latest;
24
+ if ("failed" in latest) {
25
+ asking.failed = true;
26
+ }
27
+ else {
28
+ keepLatestEngine(served.context.home, now, latest.version);
29
+ }
30
+ return latest;
31
+ }
@@ -2,6 +2,7 @@ import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import { type PageModule } from "../../commands/shared/packages/extensions.ts";
3
3
  import type { Served } from "./index.ts";
4
4
  export declare const themeAddress = "/theme";
5
+ export declare const themesAddress = "/themes";
5
6
  export declare const builtPage: string;
6
7
  export declare const pagePolicy: string;
7
8
  export declare const pageHtml: string;
@@ -31,7 +32,8 @@ export declare function packagePageFile(path: string, served: Served): string |
31
32
  export declare function pageModulesOf(root: string, served: Served): PageModule[];
32
33
  /**
33
34
  * The theme of the campaign's game system (D-528): its CSS of custom properties, its icons and its name, which the page uses while the player keeps the game's
34
- * style on; refused when it does not pass its checks, which validate says; the system's name alone when it names none.
35
+ * style on; refused when it does not pass its checks, which validate says; the system's name alone when it names none. Beside it, the themes installed on
36
+ * their own that pass their checks, for any system, each with its CSS at its own address, which the player chooses in Settings; none when there are none.
35
37
  */
36
38
  export declare function themeNow(response: ServerResponse, served: Served): Promise<void>;
37
39
  /**
@@ -39,6 +41,11 @@ export declare function themeNow(response: ServerResponse, served: Served): Prom
39
41
  * or a picture. Its ornament comes in the colour asked, ?ink=#rrggbb, and turned for a page that reads right to left, &mirrored.
40
42
  */
41
43
  export declare function sendThemeFile(name: string, query: URLSearchParams, request: IncomingMessage, response: ServerResponse, served: Served): Promise<void>;
44
+ /**
45
+ * A file of a theme installed on its own, at themes/<id>/<path>, as the system's theme sends its files: only from its folder, by real paths, and only while it
46
+ * passes its checks; a picture runs nothing, whoever made it.
47
+ */
48
+ export declare function sendInstalledThemeFile(path: string, query: URLSearchParams, request: IncomingMessage, response: ServerResponse, served: Served): Promise<void>;
42
49
  /**
43
50
  * A picture of the campaign or of its game system, by the name of its file (D-267): only a file an images folder has, looked for by name, never by a path. It
44
51
  * runs nothing, even an SVG opened by itself.
@@ -11,11 +11,12 @@ import { campaignTheme } from "../../commands/shared/campaign/theme.js";
11
11
  import { campaignSystem } from "../../commands/shared/campaign/world.js";
12
12
  import { campaignPackages } from "../../commands/shared/packages/code.js";
13
13
  import { campaignPageModules } from "../../commands/shared/packages/extensions.js";
14
+ import { languageFolders, themesFolder, themesHere } from "../../commands/shared/packages/unpacked.js";
14
15
  import { realPath } from "../../core/files.js";
15
16
  import { files, isInside, withFiles } from "../../core/store.js";
16
17
  import { findHiddenImage, findImage } from "../../images/index.js";
17
18
  import { languagePackFor, packGuide, packPhrases } from "../../languages/index.js";
18
- import { drawnOrnament, themeCss, themeFile } from "../../themes/index.js";
19
+ import { drawnOrnament, isThemeId, readTheme, themeCss, themeFile } from "../../themes/index.js";
19
20
  const imageTypes = { ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".webp": "image/webp", ".svg": "image/svg+xml" };
20
21
  const pageTypes = {
21
22
  ".js": "text/javascript; charset=utf-8",
@@ -29,8 +30,9 @@ const pageTypes = {
29
30
  ".md": "text/markdown; charset=utf-8",
30
31
  ".wav": "audio/wav",
31
32
  };
32
- // Where the page finds the theme's files, and what they may be: faces and pictures.
33
+ // Where the page finds the theme's files, the system's and those installed on their own by their id, and what they may be: faces and pictures.
33
34
  export const themeAddress = "/theme";
35
+ export const themesAddress = "/themes";
34
36
  const themeTypes = { ...imageTypes, ".woff2": "font/woff2", ".woff": "font/woff", ".ttf": "font/ttf", ".otf": "font/otf" };
35
37
  // A picture runs nothing, even an SVG opened by itself.
36
38
  const picturePolicy = "default-src 'none'; style-src 'unsafe-inline'; sandbox";
@@ -91,7 +93,7 @@ export const securityHeaders = { "X-Content-Type-Options": "nosniff", "Referrer-
91
93
  */
92
94
  export function sendPacked(path, response, served) {
93
95
  const match = /^\/(i18n|guide)\/([a-z]{2,3}(?:-[a-z0-9]{2,8})*)\.(json|md)$/i.exec(path);
94
- const pack = match === null ? undefined : languagePackFor(served.context.extensionFolders ?? [], match[2]);
96
+ const pack = match === null ? undefined : languagePackFor(languageFolders(served.context), match[2]);
95
97
  if (match === null || pack === undefined) {
96
98
  return false;
97
99
  }
@@ -161,25 +163,28 @@ export function pageModulesOf(root, served) {
161
163
  }
162
164
  /**
163
165
  * The theme of the campaign's game system (D-528): its CSS of custom properties, its icons and its name, which the page uses while the player keeps the game's
164
- * style on; refused when it does not pass its checks, which validate says; the system's name alone when it names none.
166
+ * style on; refused when it does not pass its checks, which validate says; the system's name alone when it names none. Beside it, the themes installed on
167
+ * their own that pass their checks, for any system, each with its CSS at its own address, which the player chooses in Settings; none when there are none.
165
168
  */
166
169
  export async function themeNow(response, served) {
167
170
  const root = findCampaign(served.context.folder);
168
171
  await served.session.ready();
169
172
  const system = root === undefined ? undefined : withFiles(served.session, () => campaignSystem(root, served.context));
170
173
  const reading = root === undefined ? undefined : withFiles(served.session, () => campaignTheme(root, served.context));
174
+ const installed = withFiles(served.session, () => themesHere(served.context)).flatMap(({ id, theme }) => theme === undefined ? [] : [{ id, name: theme.name, css: themeCss(theme, `${themesAddress}/${id}`), icons: theme.icons }]);
175
+ const themes = installed.length === 0 ? {} : { themes: installed };
171
176
  if (system === undefined) {
172
- sendJson(response, 200, {});
177
+ sendJson(response, 200, themes);
173
178
  }
174
179
  else if (reading === undefined) {
175
180
  // No theme, but the system's name, which keeps the player's switch of its page style, if its page module gives one.
176
- sendJson(response, 200, { system: system.name });
181
+ sendJson(response, 200, { system: system.name, ...themes });
177
182
  }
178
183
  else if (reading.theme === undefined) {
179
- sendJson(response, 200, { system: reading.system, refused: true });
184
+ sendJson(response, 200, { system: reading.system, refused: true, ...themes });
180
185
  }
181
186
  else {
182
- sendJson(response, 200, { system: reading.system, name: reading.theme.name, css: themeCss(reading.theme, themeAddress), icons: reading.theme.icons });
187
+ sendJson(response, 200, { system: reading.system, name: reading.theme.name, css: themeCss(reading.theme, themeAddress), icons: reading.theme.icons, ...themes });
183
188
  }
184
189
  }
185
190
  /**
@@ -190,18 +195,33 @@ export async function sendThemeFile(name, query, request, response, served) {
190
195
  const root = findCampaign(served.context.folder);
191
196
  await served.session.ready();
192
197
  const folder = root === undefined ? undefined : withFiles(served.session, () => campaignTheme(root, served.context))?.theme?.folder;
198
+ sendFileOfTheme(folder, name, `${themeAddress}/${name}`, query, request, response, served);
199
+ }
200
+ /**
201
+ * A file of a theme installed on its own, at themes/<id>/<path>, as the system's theme sends its files: only from its folder, by real paths, and only while it
202
+ * passes its checks; a picture runs nothing, whoever made it.
203
+ */
204
+ export async function sendInstalledThemeFile(path, query, request, response, served) {
205
+ const [id, ...rest] = path.split("/");
206
+ const themes = themesFolder(served.context);
207
+ await served.session.ready();
208
+ const folder = themes === undefined || !isThemeId(id) ? undefined : withFiles(served.session, () => readTheme(join(themes, id)).theme?.folder);
209
+ sendFileOfTheme(folder, rest.join("/"), `${themesAddress}/${path}`, query, request, response, served);
210
+ }
211
+ /** A face or a picture of the theme in this folder, by its name in the address; its ornament in the colour asked, ?ink=#rrggbb, and turned, &mirrored. */
212
+ function sendFileOfTheme(folder, name, address, query, request, response, served) {
193
213
  const given = decoded(name);
194
214
  const file = folder === undefined || given === undefined ? undefined : themeFile(folder, given);
195
215
  const type = file === undefined ? undefined : themeTypes[extname(file).toLowerCase()];
196
216
  if (file === undefined || type === undefined) {
197
- send(response, 404, "text/plain; charset=utf-8", `Nothing at ${themeAddress}/${name}.`);
217
+ send(response, 404, "text/plain; charset=utf-8", `Nothing at ${address}.`);
198
218
  return;
199
219
  }
200
220
  const ink = query.get("ink");
201
221
  const tinted = type === imageTypes[".svg"] && ink !== null && /^#[0-9a-f]{6}$/i.test(ink);
202
222
  const bytes = withFiles(served.session, () => (tinted ? Buffer.from(drawnOrnament(files().text(file) ?? "", ink, query.has("mirrored"))) : files().bytes(file)));
203
223
  if (bytes === undefined) {
204
- send(response, 404, "text/plain; charset=utf-8", `Nothing at ${themeAddress}/${name}.`);
224
+ send(response, 404, "text/plain; charset=utf-8", `Nothing at ${address}.`);
205
225
  return;
206
226
  }
207
227
  sendTagged(request, response, bytes, { "Content-Type": type, "Content-Security-Policy": type.startsWith("image/") ? picturePolicy : securityHeaders["Content-Security-Policy"] });
@@ -5,6 +5,7 @@ import type { Catalog } from "../../commands/shared/packages/catalog.ts";
5
5
  import type { Context, Player, SystemTexts } from "../../core/context.ts";
6
6
  import type { SessionStore } from "../../core/session-store.ts";
7
7
  import { type Acts } from "../player-acts.ts";
8
+ import type { EngineAsked } from "./engine.ts";
8
9
  import { type Asked, type ShownCard } from "./player.ts";
9
10
  import { type PackageAction, type PackagePhase } from "./writes.ts";
10
11
  export { campaignPorts, dashboardPorts } from "./ports.ts";
@@ -100,6 +101,8 @@ export interface Served {
100
101
  at: number;
101
102
  catalog: Catalog;
102
103
  };
104
+ /** What npm said of its latest rpg-engine, asked at most once a day (T-219). */
105
+ engineLatest?: EngineAsked;
103
106
  /** The player's sentences said on the page, waiting for the master or heard lately (D-495). */
104
107
  acts: Acts;
105
108
  /** The doorbell of Claude Code's hook, waiting for a sentence; and whether one ever came, so that this chat has one (D-495). */
@@ -17,8 +17,9 @@ import { helperCommand, queueInCodex } from "../../helpers/index.js";
17
17
  import { loadSystemCode } from "../../systems/index.js";
18
18
  import { newActs } from "../player-acts.js";
19
19
  import { choicesNews, choicesRequest } from "./choices.js";
20
- import { builtPage, packagePageFile, pageFile, pageHtml, pageModulesOf, pagePolicy, pageWords, securityHeaders, send, sendFile, sendImage, sendJson, sendPacked, sendThemeFile, themeAddress, themeNow, vendorModule } from "./files.js";
20
+ import { builtPage, packagePageFile, pageFile, pageHtml, pageModulesOf, pagePolicy, pageWords, securityHeaders, send, sendFile, sendImage, sendInstalledThemeFile, sendJson, sendPacked, sendThemeFile, themeAddress, themeNow, themesAddress, vendorModule, } from "./files.js";
21
21
  import { act, deliverActs, keepProblems, listenForBell, notes, pageNews, setupWord, story } from "./news.js";
22
+ import { givePicture } from "./pictures.js";
22
23
  import { answerAsked, closeCard, listenForChanges, pagePlayer, pageSeen, rollNamesOf, spendShown } from "./player.js";
23
24
  import { campaignPorts } from "./ports.js";
24
25
  import { addPackage, catalogNow, changeLibrary, changePackage, changeSaves, changeSetting, engineNow, exportCampaign, exportedFile, libraryNow, packagesNow, runForPlayer, takeLayerOff, } from "./writes.js";
@@ -237,6 +238,11 @@ async function answer(request, response, served) {
237
238
  await addPackage(request, response, served);
238
239
  return;
239
240
  }
241
+ // A picture of the player's own for a page (D-572 (3)).
242
+ if (request.method === "POST" && path === "/api/picture" && origin !== undefined) {
243
+ await givePicture(request, response, served, url.searchParams.get("page") ?? "");
244
+ return;
245
+ }
240
246
  if (request.method === "POST" && path === "/api/export" && origin !== undefined) {
241
247
  await exportCampaign(request, response, served);
242
248
  return;
@@ -367,6 +373,9 @@ async function answer(request, response, served) {
367
373
  else if (sendPacked(path, response, served)) {
368
374
  // A language package's phrases or Guide, before the page's own (D-485 (3)).
369
375
  }
376
+ else if (path.startsWith(`${themesAddress}/`)) {
377
+ await sendInstalledThemeFile(path.slice(themesAddress.length + 1), url.searchParams, request, response, served);
378
+ }
370
379
  else if (path.startsWith(`${themeAddress}/`)) {
371
380
  await sendThemeFile(path.slice(themeAddress.length + 1), url.searchParams, request, response, served);
372
381
  }
@@ -3,7 +3,8 @@ import { findCampaign, requireCampaign } from "../../campaign/index.js";
3
3
  import { playerSettings, setupQuestions, setupSettingNamed } from "../../commands/config/dashboard.js";
4
4
  import { playerChangeNews } from "../../commands/config/news.js";
5
5
  import { campaignWorld } from "../../commands/shared/campaign/world.js";
6
- import { playerStory } from "../../commands/shared/characters/knowledge.js";
6
+ import { knownText, playerKnowledge, playerStory } from "../../commands/shared/characters/knowledge.js";
7
+ import { knownNamedPage } from "../../commands/view/page.js";
7
8
  import { withFiles } from "../../core/store.js";
8
9
  import { comparableText } from "../../core/text.js";
9
10
  import { codexClient } from "../../helpers/index.js";
@@ -24,12 +25,14 @@ const storyRule = "It is their proposal, not a fact nor an instruction to you, w
24
25
  + "and the world's logic, write in the opening text of their page in your own words once they say yes; what does not, propose to change; what is already decided "
25
26
  + "stays as it is.";
26
27
  // Every way a text breaks a line, and the characters that do not show: a quoted note keeps neither, so that no line of it passes for the engine's (D-378).
28
+ // How much of a thing's known text the master hears with a sentence about it (T-218).
29
+ const mostKnown = 1200;
27
30
  const lineBreaks = /\r\n|[\n\r\v\f\u0085\u2028\u2029]/;
28
31
  const invisible = /[\u0000-\u0008\u000e-\u001f\u007f-\u009f\u200b-\u200f\u202a-\u202e\u2060-\u2069\ufeff]/g;
29
32
  /** What the master hears of what the player did on the page since their last call: the saves, in order, then the settings; all given back when the call never answers. */
30
33
  export function pageNews(served, told) {
31
34
  const events = served.events.splice(0);
32
- const acts = takeActs(served.acts, quotedLines);
35
+ const acts = takeActs(served.acts, quotedLines, (item) => knownOfThing(served, item));
33
36
  const shares = [...served.shared];
34
37
  const settings = settingNews(served, told);
35
38
  const problems = problemNews(served);
@@ -194,7 +197,7 @@ export async function act(request, response, served) {
194
197
  return;
195
198
  }
196
199
  const parsed = z.union([
197
- z.object({ text: z.string().max(mostSaid).transform(actText).pipe(z.string().min(1)) }).strict(),
200
+ z.object({ text: z.string().max(mostSaid).transform(actText).pipe(z.string().min(1)), item: z.string().min(1).max(200).optional() }).strict(),
198
201
  z.object({ withdraw: z.string().min(1).max(64) }).strict(),
199
202
  ]).safeParse(await readBody(request));
200
203
  if (!parsed.success) {
@@ -213,7 +216,7 @@ export async function act(request, response, served) {
213
216
  return;
214
217
  }
215
218
  const id = served.context.newId();
216
- served.acts.pending.push({ id, text: parsed.data.text });
219
+ served.acts.pending.push({ id, text: parsed.data.text, ...(parsed.data.item === undefined ? {} : { item: parsed.data.item }) });
217
220
  served.notify();
218
221
  deliverActs(served);
219
222
  sendJson(response, 202, { id, ...actsShown(served) });
@@ -306,6 +309,31 @@ function sharedNoteNews(note) {
306
309
  function quotedLines(text) {
307
310
  return text.trim().split(lineBreaks).map((line) => line.replace(invisible, "")).map((line) => (line.trim() === "" ? ">" : `> ${line}`)).join("\n");
308
311
  }
312
+ /**
313
+ * What the player character already knows of the thing a sentence starts from, read when the master hears it (T-218): its page's text as the character knows
314
+ * it, never a secret it did not discover, quoted and cut short; undefined for a thing it knows no page of, or one with no text.
315
+ */
316
+ function knownOfThing(served, item) {
317
+ try {
318
+ return withFiles(served.session, () => {
319
+ const root = requireCampaign(served.context.folder);
320
+ const world = campaignWorld(root, served.context);
321
+ const knowledge = playerKnowledge(root, world);
322
+ const page = knowledge === undefined ? undefined : knownNamedPage(world, knowledge, item);
323
+ const text = knowledge === undefined || page === undefined ? "" : knownText(world, knowledge, page).trim();
324
+ if (knowledge === undefined || page === undefined || text === "") {
325
+ return undefined;
326
+ }
327
+ const shown = text.length > mostKnown ? `${text.slice(0, mostKnown).trimEnd()}…` : text;
328
+ return `What ${knowledge.pc.name} already knows of ${page.name}, from its page:
329
+ ${quotedLines(shown)}
330
+ Narrate as found only what this does not say.`;
331
+ });
332
+ }
333
+ catch {
334
+ return undefined;
335
+ }
336
+ }
309
337
  function actsShown(served) {
310
338
  return { pending: served.acts.pending, heard: served.acts.heard, bell: hasBell(served) };
311
339
  }
@@ -326,7 +354,10 @@ async function queueActs(served, thread) {
326
354
  // Heard as it goes, so that it is no longer taken back nor told at a call's head.
327
355
  markHeard(served.acts, [one.id]);
328
356
  served.notify();
329
- if (!(await served.queue.send(thread, one.text).catch(() => false))) {
357
+ const known = one.item === undefined ? undefined : knownOfThing(served, one.item);
358
+ if (!(await served.queue.send(thread, known === undefined ? one.text : `${one.text}
359
+
360
+ ${known}`).catch(() => false))) {
330
361
  giveBackAct(served.acts, one);
331
362
  served.queueBroken = true;
332
363
  served.notify();
@@ -0,0 +1,7 @@
1
+ import type { IncomingMessage, ServerResponse } from "node:http";
2
+ import type { Served } from "./index.ts";
3
+ /**
4
+ * Gives `page` the picture in the request's body: a page of the campaign the character knows, never one of the game system; a body over the largest picture
5
+ * is refused by its declared length before it is read, or as soon as it passes it.
6
+ */
7
+ export declare function givePicture(request: IncomingMessage, response: ServerResponse, served: Served, page: string): Promise<void>;
@@ -0,0 +1,62 @@
1
+ import { requireCampaign } from "../../campaign/index.js";
2
+ import { placeImage } from "../../commands/image.js";
3
+ import { campaignWorld } from "../../commands/shared/campaign/world.js";
4
+ import { knowsPage, playerKnowledge } from "../../commands/shared/characters/knowledge.js";
5
+ import { Refusal, refusalBody } from "../../core/refusal.js";
6
+ import { withFiles } from "../../core/store.js";
7
+ import { imageOfBytes, largestImage } from "../../images/index.js";
8
+ import { pageNamed } from "../../pages/index.js";
9
+ import { decoded, mostSaid, readBytes, sendJson } from "./files.js";
10
+ /**
11
+ * Gives `page` the picture in the request's body: a page of the campaign the character knows, never one of the game system; a body over the largest picture
12
+ * is refused by its declared length before it is read, or as soon as it passes it.
13
+ */
14
+ export async function givePicture(request, response, served, page) {
15
+ const size = largestImage / 1024 / 1024;
16
+ const tooBig = { error: `The picture is more than ${size} MB: make it smaller (512 pixels a side are enough).`, code: "picture-big", values: { size: String(size) } };
17
+ // The connection closes after the refusal: the rest of the body is never read.
18
+ if (Number(request.headers["content-length"] ?? 0) > largestImage) {
19
+ response.setHeader("Connection", "close");
20
+ sendJson(response, 413, tooBig);
21
+ return;
22
+ }
23
+ const name = page.trim();
24
+ if (name === "" || name.length > mostSaid) {
25
+ sendJson(response, 400, { error: "Send the picture as the body, with the page it is for: /api/picture?page=<name>." });
26
+ return;
27
+ }
28
+ const bytes = await readBytes(request, largestImage);
29
+ if (bytes === undefined) {
30
+ response.setHeader("Connection", "close");
31
+ sendJson(response, 413, tooBig);
32
+ return;
33
+ }
34
+ const file = decoded(String(request.headers["x-file-name"] ?? "")) ?? "";
35
+ try {
36
+ await served.session.ready();
37
+ const given = withFiles(served.session, () => {
38
+ const root = requireCampaign(served.context.folder);
39
+ const world = campaignWorld(root, served.context);
40
+ const found = pageNamed(world, name);
41
+ const knowledge = playerKnowledge(root, world);
42
+ // A page the character does not know reads as none: the refusal never tells it is there.
43
+ if (found === undefined || knowledge === undefined || !knowsPage(knowledge, found)) {
44
+ throw new Refusal(`Your character knows no page called ${name}: reload the page.`, "no-page", { page: name });
45
+ }
46
+ if (found.system !== undefined) {
47
+ throw new Refusal(`${found.name} is a page of the game system: it shows the system's picture.`, "system-page", { page: found.name });
48
+ }
49
+ const picture = imageOfBytes(bytes, file === "" ? "The file" : file);
50
+ if ("problem" in picture) {
51
+ throw new Refusal(picture.problem, "not-picture", { name: file === "" ? name : file });
52
+ }
53
+ return placeImage(root, { ...served.context, actor: "player" }, world, found, picture);
54
+ });
55
+ served.context.later?.add(`The player gave ${given.page} a picture of their own, on the dashboard: it is ${given.image ?? ""} now.`);
56
+ served.notify();
57
+ sendJson(response, 200, { page: given.page });
58
+ }
59
+ catch (error) {
60
+ sendJson(response, error instanceof Refusal && error.code === "no-page" ? 404 : 400, refusalBody(error));
61
+ }
62
+ }
@@ -38,7 +38,8 @@ export declare function packagesNow(response: ServerResponse, served: Served, np
38
38
  export declare function changePackage(request: IncomingMessage, response: ServerResponse, served: Served): Promise<void>;
39
39
  /**
40
40
  * Something the player adds on the page (D-485 (1)): a .zip or a .tgz as the request's body, named by its X-File-Name, or { source }: a link, an npm name or a
41
- * folder of this computer. The engine tells the kind by what it holds; an adventure is read in memory, a .tgz kept in the player's data folder while npm installs it.
41
+ * folder of this computer. The engine tells the kind by what it holds; a .zip, an adventure, a theme or a language, is read in memory, a .tgz kept in the
42
+ * player's data folder while npm installs it.
42
43
  */
43
44
  export declare function addPackage(request: IncomingMessage, response: ServerResponse, served: Served): Promise<void>;
44
45
  /**
@@ -53,8 +54,9 @@ export declare function libraryNow(response: ServerResponse, served: Served): Pr
53
54
  */
54
55
  export declare function changeLibrary(request: IncomingMessage, response: ServerResponse, served: Served): Promise<void>;
55
56
  /**
56
- * rpg-engine itself on the Packages page (D-515 (3)): its version, npm's latest and whether it is newer, and how it is installed, read at each look; its update,
57
- * from the page alone, globally with npm as it was installed, a development link or another install told and never touched; then how the chat takes it.
57
+ * rpg-engine itself on the Packages page (D-515 (3)): its version, npm's latest and whether it is newer, asked at most once a day (T-219), and how it is
58
+ * installed; its update, from the page alone with the player's yes in a window of their computer, globally with npm as it was installed, a development link or
59
+ * another install told and never touched; then how the chat takes it.
58
60
  */
59
61
  export declare function engineNow(request: IncomingMessage, response: ServerResponse, served: Served): Promise<void>;
60
62
  /** What the page may add (D-485, D-486), from npm and GitHub, read again at most every ten minutes, or when the page asks it fresh. */
@@ -1,13 +1,12 @@
1
1
  import { basename, join } from "node:path";
2
2
  import { z } from "zod";
3
- import { readAdventureZip } from "../../adventures/index.js";
4
3
  import { findCampaign, readSettings, readTextSetting, requireCampaign, settingNames } from "../../campaign/index.js";
5
4
  import { config } from "../../commands/config/config.js";
6
5
  import { playerSettingNamed, playerSettings, setupSettingNamed } from "../../commands/config/dashboard.js";
6
+ import { installDataPackage, zipDataPackage } from "../../commands/package/data.js";
7
7
  import { isInstalledPackage } from "../../commands/package/here.js";
8
8
  import { adventureText, packageCommand } from "../../commands/package/package.js";
9
9
  import { playerSaveNews, save } from "../../commands/save.js";
10
- import { installAdventure } from "../../commands/shared/books/adventures.js";
11
10
  import { libraryContents, libraryEntries, startLibraryReading, unquoted } from "../../commands/shared/books/library.js";
12
11
  import { campaignMode } from "../../commands/shared/campaign/mode.js";
13
12
  import { exportsFolderName, resetPoints } from "../../commands/shared/campaign/saves.js";
@@ -25,6 +24,7 @@ import { getVersion, isNewerVersion } from "../../core/version.js";
25
24
  import { extensionWords, findExtension } from "../../extensions/index.js";
26
25
  import { samePath } from "../../library/index.js";
27
26
  import { readableSystems } from "../../systems/index.js";
27
+ import { askLatest, knownLatest } from "./engine.js";
28
28
  import { decoded, mostSaid, readBody, readBytes, securityHeaders, send, sendJson } from "./files.js";
29
29
  // How long the catalog is kept before npm and GitHub are asked again.
30
30
  const catalogLife = 10 * 60 * 1000;
@@ -226,7 +226,16 @@ export async function packagesNow(response, served, npm) {
226
226
  system: system === undefined ? null : { name: system.name, title: system.title },
227
227
  // The other systems of this computer, for a new campaign: a campaign's own is chosen in its setup (D-475).
228
228
  otherSystems: readableSystems(served.context.systemFolders).filter((other) => other.name !== system?.name).map((other) => ({ name: other.name, title: other.title })),
229
- ...(list.kind === "list" ? { installed: inLanguage(list.installed, served, readTextSetting(root, "language")), missing: list.missing, adventures: list.adventures, systems: list.systems, languages: list.languages } : {}),
229
+ ...(list.kind === "list"
230
+ ? {
231
+ installed: inLanguage(list.installed, served, readTextSetting(root, "language")),
232
+ missing: list.missing,
233
+ adventures: list.adventures,
234
+ systems: list.systems,
235
+ languages: list.languages,
236
+ themes: list.themes,
237
+ }
238
+ : {}),
230
239
  ...(available?.kind === "available" ? { available: available.packages, ...(available.failed === undefined ? {} : { failed: available.failed }) } : {}),
231
240
  ...(served.packageWork === undefined ? {} : { working: served.packageWork }),
232
241
  };
@@ -261,7 +270,8 @@ export async function changePackage(request, response, served) {
261
270
  }
262
271
  /**
263
272
  * Something the player adds on the page (D-485 (1)): a .zip or a .tgz as the request's body, named by its X-File-Name, or { source }: a link, an npm name or a
264
- * folder of this computer. The engine tells the kind by what it holds; an adventure is read in memory, a .tgz kept in the player's data folder while npm installs it.
273
+ * folder of this computer. The engine tells the kind by what it holds; a .zip, an adventure, a theme or a language, is read in memory, a .tgz kept in the
274
+ * player's data folder while npm installs it.
265
275
  */
266
276
  export async function addPackage(request, response, served) {
267
277
  const json = /^application\/json/i.test(String(request.headers["content-type"] ?? ""));
@@ -278,7 +288,7 @@ export async function addPackage(request, response, served) {
278
288
  }
279
289
  if (bytes !== undefined && !/\.(zip|tgz|tar\.gz)$/i.test(file)) {
280
290
  sendJson(response, 400, {
281
- error: `${file} is neither a .zip nor a .tgz: an adventure comes as a .zip, an extension, a game system or a language as a .tgz.`,
291
+ error: `${file} is neither a .zip nor a .tgz: an adventure, a theme or a language comes as a .zip; an extension, a game system or a language from npm as a .tgz.`,
282
292
  code: "file-kind",
283
293
  values: { name: file },
284
294
  });
@@ -287,9 +297,9 @@ export async function addPackage(request, response, served) {
287
297
  const source = given?.success === true ? given.data.source : file;
288
298
  await packageWork(response, served, source, "add", async (context) => {
289
299
  if (bytes !== undefined && /\.zip$/i.test(file)) {
290
- const root = requireCampaign(context.folder);
291
- const installed = installAdventure(root, context, readAdventureZip(bytes, file), file);
292
- return { kind: "adventure", news: `The player, on the dashboard, added an adventure: ${adventureText(installed)}` };
300
+ const result = await installDataPackage(requireCampaign(context.folder), context, zipDataPackage(bytes, file, file), file);
301
+ const said = result.kind === "adventure-installed" ? `an adventure: ${adventureText(result)}` : `${file}: ${packageCommand.format(result)}`;
302
+ return { kind: kindOf(result.kind), news: `The player, on the dashboard, added ${said}` };
293
303
  }
294
304
  const kept = bytes === undefined ? undefined : join(served.context.home ?? packagesFolder(), "uploads", file);
295
305
  try {
@@ -352,8 +362,9 @@ export async function changeLibrary(request, response, served) {
352
362
  });
353
363
  }
354
364
  /**
355
- * rpg-engine itself on the Packages page (D-515 (3)): its version, npm's latest and whether it is newer, and how it is installed, read at each look; its update,
356
- * from the page alone, globally with npm as it was installed, a development link or another install told and never touched; then how the chat takes it.
365
+ * rpg-engine itself on the Packages page (D-515 (3)): its version, npm's latest and whether it is newer, asked at most once a day (T-219), and how it is
366
+ * installed; its update, from the page alone with the player's yes in a window of their computer, globally with npm as it was installed, a development link or
367
+ * another install told and never touched; then how the chat takes it.
357
368
  */
358
369
  export async function engineNow(request, response, served) {
359
370
  const updater = served.context.engine;
@@ -366,7 +377,7 @@ export async function engineNow(request, response, served) {
366
377
  // What npm installed since this server started comes with a new chat: said apart, never as the version that runs.
367
378
  const onDisk = updater.onDisk();
368
379
  if (request.method === "GET") {
369
- const [latest, installed] = await Promise.all([updater.latest(), updater.installed()]);
380
+ const [latest, installed] = await Promise.all([knownLatest(served, updater), updater.installed()]);
370
381
  sendJson(response, 200, {
371
382
  version,
372
383
  ...(onDisk === version ? {} : { installed: onDisk }),
@@ -382,8 +393,8 @@ export async function engineNow(request, response, served) {
382
393
  sendJson(response, 400, { error: "Send what to do with rpg-engine: { action: update }." });
383
394
  return;
384
395
  }
385
- await packageWork(response, served, "rpg-engine", "engine", async () => {
386
- const latest = await updater.latest();
396
+ await packageWork(response, served, "rpg-engine", "engine", async (context) => {
397
+ const latest = await askLatest(served, updater);
387
398
  if ("failed" in latest) {
388
399
  throw new Refusal(`${latest.failed}: update it once this computer is online. Nothing changed.`, "engine-offline", { why: latest.failed });
389
400
  }
@@ -400,6 +411,7 @@ export async function engineNow(request, response, served) {
400
411
  name: installed.folder,
401
412
  });
402
413
  }
414
+ await engineYes(context, onDisk, latest.version);
403
415
  const why = await updater.update(latest.version);
404
416
  if (why !== undefined) {
405
417
  throw new Refusal(`rpg-engine could not be updated: ${why}. Nothing changed.`, "engine-failed", { why });
@@ -414,6 +426,24 @@ export async function engineNow(request, response, served) {
414
426
  };
415
427
  });
416
428
  }
429
+ /**
430
+ * The player's own yes to updating rpg-engine, in a window of their computer, never the page's click alone (D-477): a no holds for the session (D-510); where
431
+ * no window opens, the command that updates it from a terminal.
432
+ */
433
+ async function engineYes(context, from, to) {
434
+ if (context.declined?.has("rpg-engine") === true) {
435
+ throw new Refusal("The player said no to updating rpg-engine in this session: it is not asked again until the game's server starts again. Nothing changed.", "declined");
436
+ }
437
+ const question = `Update RPG Engine from ${from} to ${to}? npm installs it on this computer, for every campaign. The chat you play in keeps ${from} until you start a new one.`;
438
+ const answer = context.confirm === undefined ? "none" : await context.confirm.ask("Update RPG Engine", question, context.signal, { yes: "Update", no: "Not now" });
439
+ if (answer === "no") {
440
+ context.declined?.add("rpg-engine");
441
+ throw new Refusal("The player did not want to update rpg-engine. Nothing changed.", "declined");
442
+ }
443
+ if (answer === "none") {
444
+ throw new Refusal("No window for the player's yes opens on this computer: update it in a terminal with npm install -g rpg-engine. Nothing changed.", "no-window");
445
+ }
446
+ }
417
447
  /** What the page may add (D-485, D-486), from npm and GitHub, read again at most every ten minutes, or when the page asks it fresh. */
418
448
  export async function catalogNow(response, served, fresh) {
419
449
  const kept = served.catalog;
@@ -534,7 +564,8 @@ async function packageWork(response, served, name, action, work) {
534
564
  }
535
565
  /** The kind of package a result of package install says it installed. */
536
566
  function kindOf(result) {
537
- return result === "adventure-installed" ? "adventure" : result === "system-installed" ? "system" : result === "language-installed" ? "language" : "extension";
567
+ const kinds = { "adventure-installed": "adventure", "system-installed": "system", "language-installed": "language", "theme-installed": "theme" };
568
+ return kinds[result] ?? "extension";
538
569
  }
539
570
  /** A file's name as the page sends it, encoded for a header; as it is when it does not decode. */
540
571
  function fileName(header) {