sci2-ts 0.0.0-stage → 0.2.1

package/tools/game/font.ts

@@ -0,0 +1,126 @@
+import type { Font, Glyph } from "../../packages/sci/src/index.ts";
+
+/**
+ * sci-ts's own pixel font: 7 pixels from the top of a capital to the baseline, 2 below for
+ * descenders, a line height of 10. Drawn here as rows of `#` (ink) and `.`; a glyph is 7 rows
+ * (sitting on the baseline) or 9 (with a descender). Each glyph gets one column of space after
+ * it. Characters 0-31 and 127 are empty.
+ */
+const ROWS = 9;
+const LINE_HEIGHT = 10;
+
+const GLYPHS: Record<string, string> = {
+  " ": "... ... ... ... ... ... ...",
+  "!": "# # # # # . #",
+  '"': "#.# #.# ... ... ... ... ...",
+  "#": "..... .#.#. ##### .#.#. ##### .#.#. .....",
+  "$": "..#.. .#### #.#.. .###. ..#.# ####. ..#..",
+  "%": "##..# ##.#. ..#.. .#... #..## #..## .....",
+  "&": ".#.. #.#. .#.. #.#. #..# #.#. .#.#",
+  "'": "# # . . . . .",
+  "(": ".# #. #. #. #. #. .#",
+  ")": "#. .# .# .# .# .# #.",
+  "*": "... #.# .#. #.# ... ... ...",
+  "+": "... ... .#. ### .#. ... ...",
+  ",": ".. .. .. .. .. .# .# #. ..",
+  "-": "... ... ... ### ... ... ...",
+  ".": ". . . . . . #",
+  "/": "...# ...# ..#. ..#. .#.. #... #...",
+  "0": ".##. #..# #.## ##.# #..# #..# .##.",
+  "1": ".#. ##. .#. .#. .#. .#. ###",
+  "2": ".##. #..# ...# ..#. .#.. #... ####",
+  "3": "###. ...# ...# .##. ...# ...# ###.",
+  "4": "#..# #..# #..# #### ...# ...# ...#",
+  "5": "#### #... ###. ...# ...# #..# .##.",
+  "6": ".##. #... #... ###. #..# #..# .##.",
+  "7": "#### ...# ..#. ..#. .#.. .#.. .#..",
+  "8": ".##. #..# #..# .##. #..# #..# .##.",
+  "9": ".##. #..# #..# .### ...# ...# .##.",
+  ":": ". . # . . # .",
+  ";": ".. .. .# .. .. .# .# #. ..",
+  "<": "... ..# .#. #.. .#. ..# ...",
+  "=": ".... .... #### .... #### .... ....",
+  ">": "... #.. .#. ..# .#. #.. ...",
+  "?": ".##. #..# ...# ..#. .#.. .... .#..",
+  "@": ".###. #...# #.### #.#.# #.### #.... .###.",
+  "A": ".##. #..# #..# #### #..# #..# #..#",
+  "B": "###. #..# #..# ###. #..# #..# ###.",
+  "C": ".##. #..# #... #... #... #..# .##.",
+  "D": "###. #..# #..# #..# #..# #..# ###.",
+  "E": "#### #... #... ###. #... #... ####",
+  "F": "#### #... #... ###. #... #... #...",
+  "G": ".##. #..# #... #.## #..# #..# .###",
+  "H": "#..# #..# #..# #### #..# #..# #..#",
+  "I": "### .#. .#. .#. .#. .#. ###",
+  "J": "..## ...# ...# ...# ...# #..# .##.",
+  "K": "#..# #.#. ##.. ##.. #.#. #..# #..#",
+  "L": "#... #... #... #... #... #... ####",
+  "M": "#...# ##.## #.#.# #.#.# #...# #...# #...#",
+  "N": "#..# ##.# ##.# #.## #.## #..# #..#",
+  "O": ".##. #..# #..# #..# #..# #..# .##.",
+  "P": "###. #..# #..# ###. #... #... #...",
+  "Q": ".##. #..# #..# #..# #..# #.#. .#.#",
+  "R": "###. #..# #..# ###. #.#. #..# #..#",
+  "S": ".##. #..# #... .##. ...# #..# .##.",
+  "T": "##### ..#.. ..#.. ..#.. ..#.. ..#.. ..#..",
+  "U": "#..# #..# #..# #..# #..# #..# .##.",
+  "V": "#...# #...# #...# .#.#. .#.#. ..#.. ..#..",
+  "W": "#...# #...# #...# #.#.# #.#.# ##.## #...#",
+  "X": "#..# #..# .##. .##. .##. #..# #..#",
+  "Y": "#...# #...# .#.#. ..#.. ..#.. ..#.. ..#..",
+  "Z": "#### ...# ..#. .#.. #... #... ####",
+  "[": "## #. #. #. #. #. ##",
+  "\\": "#... #... .#.. .#.. ..#. ...# ...#",
+  "]": "## .# .# .# .# .# ##",
+  "^": ".#. #.# ... ... ... ... ...",
+  _: ".... .... .... .... .... .... .... .... ####",
+  "`": "#. .# .. .. .. .. ..",
+  a: ".... .... .##. ...# .### #..# .###",
+  b: "#... #... ###. #..# #..# #..# ###.",
+  c: "... ... .## #.. #.. #.. .##",
+  d: "...# ...# .### #..# #..# #..# .###",
+  e: ".... .... .##. #..# #### #... .##.",
+  f: ".## #.. ### #.. #.. #.. #..",
+  g: ".... .... .### #..# #..# #..# .### ...# .##.",
+  h: "#... #... ###. #..# #..# #..# #..#",
+  i: "# . # # # # #",
+  j: ".# .. .# .# .# .# .# .# #.",
+  k: "#... #... #..# #.#. ##.. #.#. #..#",
+  l: "#. #. #. #. #. #. .#",
+  m: "..... ..... ####. #.#.# #.#.# #.#.# #.#.#",
+  n: ".... .... ###. #..# #..# #..# #..#",
+  o: ".... .... .##. #..# #..# #..# .##.",
+  p: ".... .... ###. #..# #..# #..# ###. #... #...",
+  q: ".... .... .### #..# #..# #..# .### ...# ...#",
+  r: "... ... #.# ##. #.. #.. #..",
+  s: ".... .... .### #... .##. ...# ###.",
+  t: ".#. .#. ### .#. .#. .#. ..#",
+  u: ".... .... #..# #..# #..# #..# .###",
+  v: "..... ..... #...# #...# .#.#. .#.#. ..#..",
+  w: "..... ..... #...# #...# #.#.# #.#.# .#.#.",
+  x: "..... ..... #...# .#.#. ..#.. .#.#. #...#",
+  y: ".... .... #..# #..# #..# #..# .### ...# .##.",
+  z: ".... .... #### ...# ..#. .#.. ####",
+  "{": ".## .#. .#. #.. .#. .#. .##",
+  "|": "# # # # # # # # #",
+  "}": "##. .#. .#. ..# .#. .#. ##.",
+  "~": ".... .... .#.# #.#. .... .... ....",
+};
+
+function glyph(char: string, art: string): Glyph {
+  const rows = art.split(" ");
+  if (rows.length !== 7 && rows.length !== 9) throw new Error(`glyph ${JSON.stringify(char)}: ${rows.length} rows`);
+  const inked = rows[0]!.length;
+  if (rows.some((r) => r.length !== inked)) throw new Error(`glyph ${JSON.stringify(char)}: rows of different widths`);
+  const width = inked + 1;
+  const pixels = new Uint8Array(width * ROWS);
+  rows.forEach((row, y) => [...row].forEach((c, x) => (pixels[y * width + x] = c === "#" ? 1 : 0)));
+  return { width, height: ROWS, pixels };
+}
+
+/** The font, as a Font (write it with writeFont). */
+export function pixelFont(): Font {
+  const glyphs: Glyph[] = Array.from({ length: 128 }, () => ({ width: 0, height: 0, pixels: new Uint8Array(0) }));
+  for (const [char, art] of Object.entries(GLYPHS)) glyphs[char.charCodeAt(0)] = glyph(char, art);
+  return { height: LINE_HEIGHT, glyphs };
+}

package/tools/game/kit.d.ts

@@ -0,0 +1,7 @@
+/**
+ * What a game's resources.ts imports to make art and music in code: the engine's writers
+ * and types, and the default palette's colours.
+ */
+export { ResourceType, SoundDevice, writeFont, writeHunkPalette, writePic, writeSound, writeView, type Cel, type Font, type HunkPaletteFile, type MidiEvent, type PicFile, type ResourceData, type SoundSpec, type ViewFile, } from "../../packages/sci/src/index.ts";
+export { BASE_PALETTE, CURSOR_VIEW, Colour, DEFAULT_FONT, basePalette, cube } from "./defaults.ts";
+export { pixelFont } from "./font.ts";

package/tools/game/kit.js

@@ -0,0 +1,7 @@
+/**
+ * What a game's resources.ts imports to make art and music in code: the engine's writers
+ * and types, and the default palette's colours.
+ */
+export { ResourceType, SoundDevice, writeFont, writeHunkPalette, writePic, writeSound, writeView, } from "../../packages/sci/src/index.js";
+export { BASE_PALETTE, CURSOR_VIEW, Colour, DEFAULT_FONT, basePalette, cube } from "./defaults.js";
+export { pixelFont } from "./font.js";

package/tools/game/kit.ts

@@ -0,0 +1,10 @@
+/**
+ * What a game's resources.ts imports to make art and music in code: the engine's writers
+ * and types, and the default palette's colours.
+ */
+export {
+  ResourceType, SoundDevice, writeFont, writeHunkPalette, writePic, writeSound, writeView,
+  type Cel, type Font, type HunkPaletteFile, type MidiEvent, type PicFile, type ResourceData, type SoundSpec, type ViewFile,
+} from "../../packages/sci/src/index.ts";
+export { BASE_PALETTE, CURSOR_VIEW, Colour, DEFAULT_FONT, basePalette, cube } from "./defaults.ts";
+export { pixelFont } from "./font.ts";

package/tools/game/new.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A new game in `target` (a folder that doesn't exist yet), from the template. NAME becomes
+ * the folder's name and Name the same in capitals (the game's class). KIT and SCHEMA become
+ * the art kit and the room schema: by path for a game inside this repository, through the
+ * sci2-ts package for one outside it. `.tmpl` files lose the suffix (they aren't type
+ * checked where they stand). `refs` overrides that choice. Returns the game's folder.
+ */
+export declare function newGame(target: string, refs?: "path" | "package"): string;

package/tools/game/new.js

@@ -0,0 +1,39 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { basename, join, relative, resolve } from "node:path";
+import { GameBuildError } from "./build.js";
+/** Where `sci-ts new` copies from: a room in YAML and Yarn, the game, placeholder art. */
+const TEMPLATE = join(import.meta.dirname, "template");
+const ROOT = resolve(import.meta.dirname, "../..");
+/**
+ * A new game in `target` (a folder that doesn't exist yet), from the template. NAME becomes
+ * the folder's name and Name the same in capitals (the game's class). KIT and SCHEMA become
+ * the art kit and the room schema: by path for a game inside this repository, through the
+ * sci2-ts package for one outside it. `.tmpl` files lose the suffix (they aren't type
+ * checked where they stand). `refs` overrides that choice. Returns the game's folder.
+ */
+export function newGame(target, refs) {
+    const name = basename(resolve(target));
+    if (!/^[a-z][a-z0-9-]*$/.test(name))
+        throw new GameBuildError(`${name}: a game's name is lower-case letters, digits and dashes, starting with a letter`);
+    if (existsSync(target) && readdirSync(target).some((f) => f === "scripts" || f === "rooms"))
+        throw new GameBuildError(`${target} is already there`);
+    const inside = refs ? refs === "path" : !relative(ROOT, resolve(target)).startsWith("..");
+    const slash = (p) => p.replaceAll("\\", "/");
+    const kit = inside ? slash(relative(resolve(target), join(ROOT, "tools/game/kit.ts"))) : "sci2-ts/kit";
+    const schema = inside
+        ? slash(relative(join(resolve(target), "rooms"), join(ROOT, "packages/content/room.schema.json")))
+        : "../node_modules/sci2-ts/packages/content/room.schema.json";
+    const Name = name.replace(/(^|-)([a-z])/g, (_, __, c) => c.toUpperCase());
+    const fill = (text) => text.replaceAll('"KIT"', JSON.stringify(kit)).replaceAll("SCHEMA", schema).replaceAll("NAME", name).replaceAll("Name", Name);
+    const copy = (from, to) => {
+        mkdirSync(to, { recursive: true });
+        for (const entry of readdirSync(from, { withFileTypes: true })) {
+            if (entry.isDirectory())
+                copy(join(from, entry.name), join(to, entry.name));
+            else
+                writeFileSync(join(to, entry.name.replace(/\.tmpl$/, "")), fill(readFileSync(join(from, entry.name), "utf8")));
+        }
+    };
+    copy(TEMPLATE, target);
+    return target;
+}

package/tools/game/new.ts

@@ -0,0 +1,38 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { basename, join, relative, resolve } from "node:path";
+import { GameBuildError } from "./build.ts";
+
+/** Where `sci-ts new` copies from: a room in YAML and Yarn, the game, placeholder art. */
+const TEMPLATE = join(import.meta.dirname, "template");
+const ROOT = resolve(import.meta.dirname, "../..");
+
+/**
+ * A new game in `target` (a folder that doesn't exist yet), from the template. NAME becomes
+ * the folder's name and Name the same in capitals (the game's class). KIT and SCHEMA become
+ * the art kit and the room schema: by path for a game inside this repository, through the
+ * sci2-ts package for one outside it. `.tmpl` files lose the suffix (they aren't type
+ * checked where they stand). `refs` overrides that choice. Returns the game's folder.
+ */
+export function newGame(target: string, refs?: "path" | "package"): string {
+  const name = basename(resolve(target));
+  if (!/^[a-z][a-z0-9-]*$/.test(name)) throw new GameBuildError(`${name}: a game's name is lower-case letters, digits and dashes, starting with a letter`);
+  if (existsSync(target) && readdirSync(target).some((f) => f === "scripts" || f === "rooms")) throw new GameBuildError(`${target} is already there`);
+  const inside = refs ? refs === "path" : !relative(ROOT, resolve(target)).startsWith("..");
+  const slash = (p: string) => p.replaceAll("\\", "/");
+  const kit = inside ? slash(relative(resolve(target), join(ROOT, "tools/game/kit.ts"))) : "sci2-ts/kit";
+  const schema = inside
+    ? slash(relative(join(resolve(target), "rooms"), join(ROOT, "packages/content/room.schema.json")))
+    : "../node_modules/sci2-ts/packages/content/room.schema.json";
+  const Name = name.replace(/(^|-)([a-z])/g, (_, __, c: string) => c.toUpperCase());
+  const fill = (text: string) =>
+    text.replaceAll('"KIT"', JSON.stringify(kit)).replaceAll("SCHEMA", schema).replaceAll("NAME", name).replaceAll("Name", Name);
+  const copy = (from: string, to: string) => {
+    mkdirSync(to, { recursive: true });
+    for (const entry of readdirSync(from, { withFileTypes: true })) {
+      if (entry.isDirectory()) copy(join(from, entry.name), join(to, entry.name));
+      else writeFileSync(join(to, entry.name.replace(/\.tmpl$/, "")), fill(readFileSync(join(from, entry.name), "utf8")));
+    }
+  };
+  copy(TEMPLATE, target);
+  return target;
+}

package/tools/game/target.d.ts

@@ -0,0 +1,7 @@
+import type { Target } from "../../packages/content/src/index.ts";
+/**
+ * The class library (lib/) as a compile target for rooms written as YAML and Yarn
+ * (packages/content). Global numbers depend on the game's script 0, so the target is made
+ * for each build from the compiled globals' names.
+ */
+export declare function libraryTarget(globals: readonly string[]): Target;

package/tools/game/target.js

@@ -0,0 +1,41 @@
+/**
+ * The class library (lib/) as a compile target for rooms written as YAML and Yarn
+ * (packages/content). Global numbers depend on the game's script 0, so the target is made
+ * for each build from the compiled globals' names.
+ */
+export function libraryTarget(globals) {
+    const g = (name) => {
+        const n = globals.indexOf(name);
+        if (n < 0)
+            throw new Error(`the library's global ${name} isn't there: is script 0 compiled with the library?`);
+        return n;
+    };
+    return {
+        roomClass: "Room",
+        roomDefaults: {},
+        globals: {
+            ego: g("ego"),
+            game: g("game"),
+            curRoom: g("curRoom"),
+            messager: g("messager"),
+            narratorObject: g("narrator"),
+            music: g("music"),
+            sound: g("sfx"),
+        },
+        // As in lib/system.sh.
+        narrator: 99,
+        heroTalker: 98,
+        firstRoomTalker: 200,
+        voice: { class: "Talker", props: {} },
+        // Portraits stand at the top left, the text beside them.
+        portrait: { class: "PortraitTalker", props: {}, at: [36, 70], frameSignal: 0, partSignal: 0 },
+        teller: { class: "Teller", props: {}, verb: 2 },
+        forwardCycle: "Forward",
+        // room.enter lines: a verb the player can't use.
+        narrationVerb: 0,
+        verbs: { look: 1, talk: 2, walk: 3, do: 4 },
+        messageVersion: 4321,
+        // SetFlag, ClearFlag and IsFlag: script 999's exports 0, 1 and 2.
+        flags: { script: 999, set: 0, clear: 1, test: 2, first: 0, last: 1023 },
+    };
+}

package/tools/game/target.ts

@@ -0,0 +1,42 @@
+import type { Target } from "../../packages/content/src/index.ts";
+
+/**
+ * The class library (lib/) as a compile target for rooms written as YAML and Yarn
+ * (packages/content). Global numbers depend on the game's script 0, so the target is made
+ * for each build from the compiled globals' names.
+ */
+export function libraryTarget(globals: readonly string[]): Target {
+  const g = (name: string) => {
+    const n = globals.indexOf(name);
+    if (n < 0) throw new Error(`the library's global ${name} isn't there: is script 0 compiled with the library?`);
+    return n;
+  };
+  return {
+    roomClass: "Room",
+    roomDefaults: {},
+    globals: {
+      ego: g("ego"),
+      game: g("game"),
+      curRoom: g("curRoom"),
+      messager: g("messager"),
+      narratorObject: g("narrator"),
+      music: g("music"),
+      sound: g("sfx"),
+    },
+    // As in lib/system.sh.
+    narrator: 99,
+    heroTalker: 98,
+    firstRoomTalker: 200,
+    voice: { class: "Talker", props: {} },
+    // Portraits stand at the top left, the text beside them.
+    portrait: { class: "PortraitTalker", props: {}, at: [36, 70], frameSignal: 0, partSignal: 0 },
+    teller: { class: "Teller", props: {}, verb: 2 },
+    forwardCycle: "Forward",
+    // room.enter lines: a verb the player can't use.
+    narrationVerb: 0,
+    verbs: { look: 1, talk: 2, walk: 3, do: 4 },
+    messageVersion: 4321,
+    // SetFlag, ClearFlag and IsFlag: script 999's exports 0, 1 and 2.
+    flags: { script: 999, set: 0, clear: 1, test: 2, first: 0, last: 1023 },
+  };
+}

package/tools/game/template/resources.ts.tmpl

@@ -0,0 +1,43 @@
+import { Colour, ResourceType, basePalette, cube, writePic, writeView, type ResourceData, type ViewFile } from "KIT";
+
+/**
+ * Placeholder art, drawn here: the room (picture 100) and the hero (view 200: loop 0 east,
+ * 1 west, 2 south, 3 north). Replace it with your own: draw it here, or see the docs.
+ */
+export default function resources(): ResourceData[] {
+  return [
+    { type: ResourceType.Pic, number: 100, data: writePic(room()) },
+    { type: ResourceType.View, number: 200, data: writeView(hero()) },
+  ];
+}
+
+const W = 320, H = 200;
+
+function room() {
+  const pixels = new Uint8Array(W * H);
+  for (let y = 0; y < H; y++) pixels.fill(y < 150 ? cube(204, 204, 153) : cube(153, 102, 51), y * W, (y + 1) * W);
+  // A window.
+  for (let y = 40; y <= 100; y++) for (let x = 130; x <= 190; x++) pixels[y * W + x] = x === 130 || x === 190 || y === 40 || y === 100 || x === 160 || y === 70 ? cube(102, 51, 0) : cube(153, 204, 255);
+  return {
+    resolution: [W, H] as [number, number],
+    cels: [{ width: W, height: H, displaceX: 0, displaceY: 0, skipColor: Colour.Transparent, pixels, priority: 0, x: 0, y: 0, unknown16: 0 }],
+    palette: basePalette(),
+  };
+}
+
+/** A figure 9 pixels wide; its legs move in cels 1 and 3. */
+function hero(): ViewFile {
+  const colours: Record<string, number> = { H: cube(51, 51, 51), S: cube(255, 204, 153), C: cube(51, 102, 153), L: cube(51, 51, 51) };
+  const body = ["..HHHHH..", "..SSSSS..", "..SSSSS..", "...SSS...", "..CCCCC..", ".CCCCCCC.", ".CCCCCCC.", ".SCCCCCS.", "..CCCCC.."];
+  const legs = [["..LL.LL..", "..LL.LL..", "..LL.LL.."], [".LL...LL.", ".LL...LL.", "LL.....LL"], ["..LL.LL..", "..LL.LL..", "..LL.LL.."], ["...LLL...", "...LLL...", "...LLL..."]];
+  const cels = legs.map((l) => {
+    const rows = [...body, ...l];
+    const pixels = Uint8Array.from(rows.join(""), (c) => colours[c] ?? Colour.Transparent);
+    return { width: 9, height: rows.length, displaceX: 0, displaceY: 0, skipColor: Colour.Transparent, pixels };
+  });
+  return {
+    flags: 1,
+    loops: [{ link: -1, mirror: false, cels }, { link: 0, mirror: true, cels: [] }, { link: -1, mirror: false, cels }, { link: -1, mirror: false, cels }],
+    palette: undefined,
+  };
+}

package/tools/game/template/rooms/1.room.yaml

@@ -0,0 +1,9 @@
+# yaml-language-server: $schema=SCHEMA
+# The first room. What's here and where you can walk; what's said is in 1.yarn.
+room: 1
+picture: 100
+hero:
+  at: [60, 170]
+walkable: [[0, 150], [319, 150], [319, 189], [0, 189]]
+features:
+  window: { rect: [130, 40, 190, 100] }

package/tools/game/template/rooms/1.yarn

@@ -0,0 +1,17 @@
+title: room.enter
+---
+<<if not $started>>
+You're here. Right-click for the next verb; click to use it.
+<<set $started to true>>
+<<endif>>
+===
+
+title: room.look
+---
+An empty room, waiting for a story.
+===
+
+title: window.look
+---
+Nothing out there yet.
+===

package/tools/game/template/scripts/0.sc

@@ -0,0 +1,24 @@
+;;; NAME: the game. It sets up, names the hero, and goes to the first room.
+(script 0)
+(include "system.sh")
+
+(public NAME 0)
+
+(class NameGame of Game
+  (method (init)
+    (super init:)
+    (= ego hero)
+    (= heroTalker heroVoice)
+    (self newRoom: 1)))
+
+(instance NAME of NameGame)
+
+(instance hero of Ego
+  (properties
+    view 200
+    xStep 2 yStep 1
+    cycleSpeed 8))
+
+;; Who says the hero's lines (Hero: in Yarn).
+(instance heroVoice of Talker
+  (properties name "You"))

package/tools/game.d.ts

@@ -0,0 +1 @@
+export {};

package/tools/game.js

@@ -0,0 +1,77 @@
+/**
+ * Games built from their own sources (see tools/game/build.ts):
+ *
+ *   pnpm game build games/<name> [out dir]   RESOURCE.MAP + RESOURCE.000, by default in
+ *                                            out/games/<name>, and in src/ the assembly
+ *                                            compiled from each .sc script
+ *   pnpm game new <name>                     a new game in games/<name>, from tools/game/template:
+ *                                            a room in YAML and Yarn, a hero, placeholder art
+ *   pnpm game site games/<name> [out dir]    a static site: the docs as pages and the game
+ *                                            in the player (out/site by default; see
+ *                                            tools/site/build.ts)
+ *
+ * Play one in the browser with SCI_GAME=out/games/<name> pnpm viewer (then /play.html), or
+ * headless with SCI_GAME=out/games/<name> pnpm play.
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import { basename, join, relative } from "node:path";
+import { writeResourceArchive } from "../packages/sci/src/index.js";
+import { GameBuildError, buildGame } from "./game/build.js";
+import { newGame } from "./game/new.js";
+import { buildSite } from "./site/build.js";
+const [command, dir, outArg] = process.argv.slice(2);
+if ((command !== "build" && command !== "site" && command !== "new") || !dir) {
+    console.error("usage: pnpm game build|site games/<name> [out dir], or pnpm game new <name>");
+    process.exit(2);
+}
+if (command === "new") {
+    try {
+        const target = newGame(join("games", basename(dir)));
+        console.log(`${target}: a room (rooms/1.room.yaml, 1.yarn), the game (scripts/0.sc) and placeholder art (resources.ts)`);
+        console.log(`  pnpm game build ${target}, then SCI_GAME=out/${target} pnpm viewer`);
+    }
+    catch (e) {
+        console.error(e.message);
+        process.exit(1);
+    }
+    process.exit(0);
+}
+if (command === "site") {
+    const out = outArg ?? "out/site";
+    try {
+        const site = await buildSite(dir, out);
+        console.log(`${out}: ${site.pages} pages, ${site.game} in play/play.html${site.soundFont ? "" : " (no SoundFont in assets/soundfonts: music is silent)"}`);
+    }
+    catch (e) {
+        if (!(e instanceof GameBuildError))
+            throw e;
+        console.error(e.message);
+        process.exit(1);
+    }
+    process.exit(0);
+}
+try {
+    const game = await buildGame(dir);
+    const out = outArg ?? join("out/games", basename(dir));
+    const { map, volume } = writeResourceArchive(game.resources);
+    mkdirSync(out, { recursive: true });
+    writeFileSync(join(out, "RESOURCE.MAP"), map);
+    writeFileSync(join(out, "RESOURCE.000"), volume);
+    for (const [name, data] of Object.entries(game.files))
+        writeFileSync(join(out, name), data);
+    // What the compiler made of the .sc scripts, to read when something doesn't work.
+    if (game.generated.size) {
+        mkdirSync(join(out, "src"), { recursive: true });
+        for (const [n, text] of game.generated)
+            writeFileSync(join(out, "src", `${n}.sca`), text);
+    }
+    for (const w of game.warnings)
+        console.warn(`warning: ${w}`);
+    console.log(`${relative(process.cwd(), out) || "."}: ${game.resources.length} resources, ${game.selectors.length} selectors, ${game.classes.size} classes`);
+}
+catch (e) {
+    if (!(e instanceof GameBuildError))
+        throw e;
+    console.error(e.message);
+    process.exit(1);
+}

package/tools/game.ts

@@ -0,0 +1,70 @@
+/**
+ * Games built from their own sources (see tools/game/build.ts):
+ *
+ *   pnpm game build games/<name> [out dir]   RESOURCE.MAP + RESOURCE.000, by default in
+ *                                            out/games/<name>, and in src/ the assembly
+ *                                            compiled from each .sc script
+ *   pnpm game new <name>                     a new game in games/<name>, from tools/game/template:
+ *                                            a room in YAML and Yarn, a hero, placeholder art
+ *   pnpm game site games/<name> [out dir]    a static site: the docs as pages and the game
+ *                                            in the player (out/site by default; see
+ *                                            tools/site/build.ts)
+ *
+ * Play one in the browser with SCI_GAME=out/games/<name> pnpm viewer (then /play.html), or
+ * headless with SCI_GAME=out/games/<name> pnpm play.
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import { basename, join, relative } from "node:path";
+import { writeResourceArchive } from "../packages/sci/src/index.ts";
+import { GameBuildError, buildGame } from "./game/build.ts";
+import { newGame } from "./game/new.ts";
+import { buildSite } from "./site/build.ts";
+
+const [command, dir, outArg] = process.argv.slice(2);
+if ((command !== "build" && command !== "site" && command !== "new") || !dir) {
+  console.error("usage: pnpm game build|site games/<name> [out dir], or pnpm game new <name>");
+  process.exit(2);
+}
+if (command === "new") {
+  try {
+    const target = newGame(join("games", basename(dir)));
+    console.log(`${target}: a room (rooms/1.room.yaml, 1.yarn), the game (scripts/0.sc) and placeholder art (resources.ts)`);
+    console.log(`  pnpm game build ${target}, then SCI_GAME=out/${target} pnpm viewer`);
+  } catch (e) {
+    console.error((e as Error).message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+if (command === "site") {
+  const out = outArg ?? "out/site";
+  try {
+    const site = await buildSite(dir, out);
+    console.log(`${out}: ${site.pages} pages, ${site.game} in play/play.html${site.soundFont ? "" : " (no SoundFont in assets/soundfonts: music is silent)"}`);
+  } catch (e) {
+    if (!(e instanceof GameBuildError)) throw e;
+    console.error(e.message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+try {
+  const game = await buildGame(dir);
+  const out = outArg ?? join("out/games", basename(dir));
+  const { map, volume } = writeResourceArchive(game.resources);
+  mkdirSync(out, { recursive: true });
+  writeFileSync(join(out, "RESOURCE.MAP"), map);
+  writeFileSync(join(out, "RESOURCE.000"), volume);
+  for (const [name, data] of Object.entries(game.files)) writeFileSync(join(out, name), data);
+  // What the compiler made of the .sc scripts, to read when something doesn't work.
+  if (game.generated.size) {
+    mkdirSync(join(out, "src"), { recursive: true });
+    for (const [n, text] of game.generated) writeFileSync(join(out, "src", `${n}.sca`), text);
+  }
+  for (const w of game.warnings) console.warn(`warning: ${w}`);
+  console.log(`${relative(process.cwd(), out) || "."}: ${game.resources.length} resources, ${game.selectors.length} selectors, ${game.classes.size} classes`);
+} catch (e) {
+  if (!(e instanceof GameBuildError)) throw e;
+  console.error(e.message);
+  process.exit(1);
+}

package/tools/mod-build.d.ts

@@ -0,0 +1,28 @@
+import { type ModTarget } from "./mod-target.ts";
+import { ResourceType, type AsmContext, type ResourceManager, type ScriptWorld } from "../packages/sci/src/index.ts";
+export interface BuiltResource {
+    type: ResourceType;
+    number: number;
+    data: Uint8Array;
+}
+/** Message file text with each record annotated: verb name, and the room objects using the noun. */
+export declare function dumpMessages(rm: ResourceManager, world: ScriptWorld, n: number): Promise<string>;
+/**
+ * Builds a mod directory: <n>.sca / <n>.msg are whole new files (a new room);
+ * <n>.sca.diff / <n>.msg.diff change the game's own, applied to fresh dumps with `patch`;
+ * <n>.png (+ <n>.layer-<priority>.png) is a room picture; *.view.json is a view;
+ * <n>.room.yaml (+ <n>.yarn) is a room described as data, compiled to <n>.sca and <n>.msg
+ * (@sci-ts/content). `generated` receives that compiled text, for reading. Their Yarn
+ * variables are flags numbered in the mod's flags.yaml (see modFlags). Rooms are compiled for
+ * the game named in the mod's mod.yaml (see tools/mod-target.ts).
+ */
+export declare function buildMod(modDir: string, rm: ResourceManager, world: ScriptWorld, ctx: AsmContext, generated?: (file: string, text: string) => void): Promise<BuiltResource[]>;
+/**
+ * A mod's flags.yaml: Yarn variable -> flag number. Saved games store flags by number, so
+ * a name keeps its number once given: new names get the next free one (the build adds them
+ * to the file; commit it with the mod). `$game<n>` is the game's own flag n.
+ */
+export declare function modFlags(modDir: string, target: ModTarget): {
+    number: (name: string) => number;
+    save: () => void;
+};