sci2-ts 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project. Versions follow [Semantic Versioning](https
 and the entries are generated from commit messages
 ([Conventional Commits](https://www.conventionalcommits.org/)) when a release is made.
 
+## [0.6.0](https://github.com/rlueder/sci-ts/compare/v0.5.0...v0.6.0) (2026-10-01)
+
+### Added
+
+* **content:** items made from items.yaml, given and taken in Yarn ([#4](https://github.com/rlueder/sci-ts/issues/4)) ([129c439](https://github.com/rlueder/sci-ts/commit/129c43965f318d8815957e6efd6ce9290eced619))
+
 ## [0.5.0](https://github.com/rlueder/sci-ts/compare/v0.4.0...v0.5.0) (2026-10-01)
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sci2-ts",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "An SCI2 adventure game engine in TypeScript, and the tools to make games with it",
   "license": "MIT",
   "type": "module",

package/packages/content/src/room.js

@@ -549,11 +549,22 @@ class RoomCompiler {
                             "pushi #show", "pushi 4", ...pushVal(int(view, "view", 0, 65535)), ...pushVal(int(loop, "loop", 0, 255)), ...pushVal(int(cel, "cel", 0, 255)), "pushSelf", "send 12",
                         ] }];
             }
+            case "get":
+            case "drop": {
+                arity(1, "<item>");
+                const { items, globals } = this.target;
+                const n = items?.exports[args[0]];
+                if (n === undefined || globals.inventory === undefined) {
+                    return fail(`no item called "${args[0]}"${items && Object.keys(items.exports).length ? ` (items: ${Object.keys(items.exports).join(", ")})` : " (items with a view in items.yaml)"}`);
+                }
+                const item = { code: [`pushi 2`, `pushi ${items.script}`, `pushi ${n}`, "callk ScriptID 4"] };
+                return [{ op: "code", code: send({ global: globals.inventory }, [[name === "get" ? "add" : "delete", [item]]]) }];
+            }
             case "room":
                 arity(1, "number");
                 return [{ op: "code", code: send({ global: g.curRoom }, [["newRoom", [int(args[0], "room", 0, 65535)]]]) }];
             default:
-                return fail("unknown command (known: walk, face, wait, hide, show, loop, cel, animate, stop, music, sound, closeup, room; and set, if)");
+                return fail("unknown command (known: walk, face, wait, hide, show, loop, cel, animate, stop, music, sound, closeup, get, drop, room; and set, if)");
         }
     }
     /** Loop music n, unless it's what's playing already. */

package/packages/content/src/room.ts

@@ -646,11 +646,22 @@ class RoomCompiler {
           "pushi #show", "pushi 4", ...pushVal(int(view, "view", 0, 65535)), ...pushVal(int(loop, "loop", 0, 255)), ...pushVal(int(cel, "cel", 0, 255)), "pushSelf", "send 12",
         ] }];
       }
+      case "get":
+      case "drop": {
+        arity(1, "<item>");
+        const { items, globals } = this.target;
+        const n = items?.exports[args[0]!];
+        if (n === undefined || globals.inventory === undefined) {
+          return fail(`no item called "${args[0]}"${items && Object.keys(items.exports).length ? ` (items: ${Object.keys(items.exports).join(", ")})` : " (items with a view in items.yaml)"}`);
+        }
+        const item: Val = { code: [`pushi 2`, `pushi ${items!.script}`, `pushi ${n}`, "callk ScriptID 4"] };
+        return [{ op: "code", code: send({ global: globals.inventory }, [[name === "get" ? "add" : "delete", [item]]]) }];
+      }
       case "room":
         arity(1, "number");
         return [{ op: "code", code: send({ global: g.curRoom }, [["newRoom", [int(args[0], "room", 0, 65535)]]]) }];
       default:
-        return fail("unknown command (known: walk, face, wait, hide, show, loop, cel, animate, stop, music, sound, closeup, room; and set, if)");
+        return fail("unknown command (known: walk, face, wait, hide, show, loop, cel, animate, stop, music, sound, closeup, get, drop, room; and set, if)");
     }
   }
 

package/packages/content/src/target.d.ts

@@ -20,6 +20,8 @@ export interface Target {
         /** The Sound object playing the music, and the one for sound effects. */
         music: number;
         sound: number;
+        /** The collection of what the hero carries (`add:`, `delete:`), if the target has one. */
+        inventory?: number;
     };
     /** Message talker number for narration (no speaker). */
     narrator: number;
@@ -64,6 +66,14 @@ export interface Target {
      * instance takes `show: view loop cel caller` and cues the caller when it's dismissed.
      */
     closeUp?: string;
+    /**
+     * Items rooms can give and take (<<get lens>>, <<drop lens>>): objects exported by
+     * `script`, by name, added to and deleted from the inventory global.
+     */
+    items?: {
+        script: number;
+        exports: Record<string, number>;
+    };
     /** Verb number for "said on arrival" messages. */
     narrationVerb: number;
     /** Verb names as used in Yarn node titles (lower case) -> verb numbers. */

package/packages/content/src/target.ts

@@ -20,6 +20,8 @@ export interface Target {
     /** The Sound object playing the music, and the one for sound effects. */
     music: number;
     sound: number;
+    /** The collection of what the hero carries (`add:`, `delete:`), if the target has one. */
+    inventory?: number;
   };
   /** Message talker number for narration (no speaker). */
   narrator: number;
@@ -51,6 +53,11 @@ export interface Target {
    * instance takes `show: view loop cel caller` and cues the caller when it's dismissed.
    */
   closeUp?: string;
+  /**
+   * Items rooms can give and take (<<get lens>>, <<drop lens>>): objects exported by
+   * `script`, by name, added to and deleted from the inventory global.
+   */
+  items?: { script: number; exports: Record<string, number> };
   /** Verb number for "said on arrival" messages. */
   narrationVerb: number;
   /** Verb names as used in Yarn node titles (lower case) -> verb numbers. */

package/tools/game/build.d.ts

@@ -9,8 +9,9 @@ import { type ResourceData } from "../../packages/sci/src/index.ts";
  *   games/<name>/rooms/<n>.room.yaml (+ <n>.yarn)  rooms as data (packages/content), compiled
  *                                  for the class library; their Yarn variables are flags
  *                                  numbered in flags.yaml
- *   games/<name>/items.yaml        optional: the verbs of the things the hero can carry
- *                                  (`lens: 10`), so rooms' Yarn can answer them (filings.lens)
+ *   games/<name>/items.yaml        optional: the things the hero can carry: their verbs, so
+ *                                  rooms' Yarn can answer them (filings.lens), and with a view
+ *                                  the item itself, made in script ITEMS_SCRIPT (<<get lens>>)
  *   games/<name>/music/<n>.mid     music: sound n, from a Standard MIDI File (General MIDI)
  *   games/<name>/sounds/<n>.wav    digital effects: sound n plays this instead of music
  *   games/<name>/resources.ts      optional: `export default () => ResourceData[]` for art,
@@ -46,5 +47,17 @@ export declare const LIBRARY_DIR: string;
 export declare function buildGame(dir: string, options?: {
     library?: boolean;
 }): Promise<BuiltGame>;
-/** items.yaml: `name: verb` lines, each item's verb from 10 to 255 (1 to 4 are the player's). */
-export declare function itemVerbs(dir: string): Record<string, number>;
+/** An item from items.yaml: its verb, and if it has a view, everything the build needs to make it. */
+export interface GameItem {
+    verb: number;
+    view?: number;
+    description?: string;
+}
+/**
+ * items.yaml: each thing the hero can carry, by name. `lens: 10` names just its verb (10 to
+ * 255; 1 to 4 are the player's), for a game whose scripts make the item; with a view, the
+ * build makes it too, in script ITEMS_SCRIPT, and rooms can give it (`<<get lens>>`):
+ *
+ *   lens: { verb: 10, view: 250, description: "Holmes's lens." }
+ */
+export declare function gameItems(dir: string): Record<string, GameItem>;

package/tools/game/build.js

@@ -9,12 +9,13 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { basename, dirname, join, relative, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
+import { parse as parseYaml } from "yaml";
 import { AsmError, CompileError, GLOBAL_NAMES_VOCAB, OBJECT_HEADER, ResourceType, assemble, compileScripts, kernelNames, messagesFromText, parseScript, resourceKey, writeClassTable, writeEffects, writeMessages, writeSelectorNames, writeSol, writeSound, } from "../../packages/sci/src/index.js";
 import { ContentError, compileRoom } from "../../packages/content/src/index.js";
 import { modFlags } from "../mod-build.js";
 import { AudioFileError, readMidiFile, readWav } from "./audio.js";
 import { defaultResources } from "./defaults.js";
-import { libraryTarget } from "./target.js";
+import { ITEMS_SCRIPT, libraryTarget } from "./target.js";
 const HEADER = OBJECT_HEADER;
 export class GameBuildError extends Error {
 }
@@ -36,6 +37,14 @@ export async function buildGame(dir, options = {}) {
     const repeated = numbers.find((n, i) => numbers.indexOf(n) !== i);
     if (repeated !== undefined)
         throw new GameBuildError(`${dir}: script ${repeated} is there twice`);
+    // Items described in items.yaml are made by a script of their own.
+    const items = gameItems(dir);
+    const madeItems = library ? itemsScript(items) : undefined;
+    if (madeItems) {
+        if (numbers.includes(ITEMS_SCRIPT))
+            throw new GameBuildError(`${dir}: script ${ITEMS_SCRIPT} is where the build makes the items in items.yaml`);
+        compiled.push({ file: join(dir, `${ITEMS_SCRIPT}.items.sc`), text: madeItems });
+    }
     if (library) {
         const lib = load(LIBRARY_DIR, /^\d+\.sc$/);
         const clash = lib.find((l) => numbers.includes(numberOf(l.file)));
@@ -108,7 +117,7 @@ export async function buildGame(dir, options = {}) {
         const roomsDir = join(dir, "rooms");
         if (!existsSync(roomsDir))
             return [];
-        const target = libraryTarget(globals, itemVerbs(dir));
+        const target = libraryTarget(globals, items);
         const flags = modFlags(dir, { content: target });
         const out = [];
         for (const { file, text } of load(roomsDir, /^\d+\.room\.yaml$/)) {
@@ -257,29 +266,66 @@ export async function buildGame(dir, options = {}) {
         warnings: [...new Set(warnings)],
     };
 }
-/** items.yaml: `name: verb` lines, each item's verb from 10 to 255 (1 to 4 are the player's). */
-export function itemVerbs(dir) {
+/**
+ * items.yaml: each thing the hero can carry, by name. `lens: 10` names just its verb (10 to
+ * 255; 1 to 4 are the player's), for a game whose scripts make the item; with a view, the
+ * build makes it too, in script ITEMS_SCRIPT, and rooms can give it (`<<get lens>>`):
+ *
+ *   lens: { verb: 10, view: 250, description: "Holmes's lens." }
+ */
+export function gameItems(dir) {
     const file = join(dir, "items.yaml");
     if (!existsSync(file))
         return {};
     const where = relative(process.cwd(), file);
-    const verbs = {};
-    readFileSync(file, "utf8").split("\n").forEach((raw, i) => {
-        const line = raw.replace(/#.*/, "").trim();
-        if (!line)
-            return;
-        const at = `${where}:${i + 1}`;
-        const m = /^([A-Za-z]\w*)\s*:\s*(\d+)$/.exec(line);
-        if (!m)
-            throw new GameBuildError(`${at}: expected item: verb`);
-        const [, name, n] = m, verb = Number(n);
+    const fail = (message) => { throw new GameBuildError(`${where}: ${message}`); };
+    let data;
+    try {
+        data = parseYaml(readFileSync(file, "utf8"));
+    }
+    catch (e) {
+        return fail(e.message.split("\n")[0]);
+    }
+    if (data === null || data === undefined)
+        return {};
+    if (typeof data !== "object" || Array.isArray(data))
+        return fail("expected item: verb, or item: { verb, view, description }");
+    const items = {};
+    for (const [name, value] of Object.entries(data)) {
         if (!/^[a-z][A-Za-z0-9]*$/.test(name) || ["look", "talk", "walk", "do", "enter"].includes(name))
-            throw new GameBuildError(`${at}: "${name}" can't name an item (lower camelCase, and not a verb)`);
-        if (verb < 10 || verb > 255)
-            throw new GameBuildError(`${at}: ${name}: the verb is a number from 10 to 255`);
-        if (Object.values(verbs).includes(verb))
-            throw new GameBuildError(`${at}: ${name}: verb ${verb} is used twice`);
-        verbs[name] = verb;
-    });
-    return verbs;
+            fail(`"${name}" can't name an item (lower camelCase, and not a verb)`);
+        const spec = typeof value === "number" ? { verb: value } : value;
+        if (!spec || typeof spec !== "object" || Array.isArray(spec))
+            return fail(`${name}: expected a verb, or { verb, view, description }`);
+        const { verb, view, description, ...rest } = spec;
+        const unknown = Object.keys(rest)[0];
+        if (unknown)
+            fail(`${name}: unknown key ${unknown}`);
+        if (typeof verb !== "number" || !Number.isInteger(verb) || verb < 10 || verb > 255)
+            fail(`${name}: the verb is a number from 10 to 255`);
+        if (Object.values(items).some((i) => i.verb === verb))
+            fail(`${name}: verb ${verb} is used twice`);
+        if (view !== undefined && (typeof view !== "number" || !Number.isInteger(view) || view < 0 || view > 65535))
+            fail(`${name}: view is a view number`);
+        if (description !== undefined && (typeof description !== "string" || /["\\]/.test(description)))
+            fail(`${name}: description is text without quotes or backslashes`);
+        if (description !== undefined && view === undefined)
+            fail(`${name}: an item the build makes needs a view`);
+        items[name] = { verb: verb, view: view, description: description };
+    }
+    return items;
+}
+/** The script making the items that have views, exported in items.yaml's order. */
+function itemsScript(items) {
+    const made = Object.entries(items).filter(([, i]) => i.view !== undefined);
+    if (!made.length)
+        return undefined;
+    return [
+        ";;; The items in items.yaml, made by the build.",
+        `(script ${ITEMS_SCRIPT})`,
+        '(include "system.sh")',
+        `(public ${made.map(([name], i) => `${name} ${i}`).join(" ")})`,
+        ...made.map(([name, i]) => `(instance ${name} of InvItem (properties view ${i.view} verb ${i.verb}${i.description ? ` description "${i.description}"` : ""}))`),
+        "",
+    ].join("\n");
 }

package/tools/game/build.ts

@@ -1,6 +1,7 @@
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { basename, dirname, join, relative, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
+import { parse as parseYaml } from "yaml";
 import {
   AsmError, CompileError, GLOBAL_NAMES_VOCAB, OBJECT_HEADER, ResourceType, assemble, compileScripts, kernelNames, messagesFromText, parseScript,
   resourceKey, writeClassTable, writeEffects, writeMessages, writeSelectorNames, writeSol, writeSound, type AsmContext,
@@ -10,7 +11,7 @@ import { ContentError, compileRoom } from "../../packages/content/src/index.ts";
 import { modFlags } from "../mod-build.ts";
 import { AudioFileError, readMidiFile, readWav } from "./audio.ts";
 import { defaultResources } from "./defaults.ts";
-import { libraryTarget } from "./target.ts";
+import { ITEMS_SCRIPT, libraryTarget } from "./target.ts";
 
 /**
  * Builds a game from its sources, needing nothing from any other game:
@@ -22,8 +23,9 @@ import { libraryTarget } from "./target.ts";
  *   games/<name>/rooms/<n>.room.yaml (+ <n>.yarn)  rooms as data (packages/content), compiled
  *                                  for the class library; their Yarn variables are flags
  *                                  numbered in flags.yaml
- *   games/<name>/items.yaml        optional: the verbs of the things the hero can carry
- *                                  (`lens: 10`), so rooms' Yarn can answer them (filings.lens)
+ *   games/<name>/items.yaml        optional: the things the hero can carry: their verbs, so
+ *                                  rooms' Yarn can answer them (filings.lens), and with a view
+ *                                  the item itself, made in script ITEMS_SCRIPT (<<get lens>>)
  *   games/<name>/music/<n>.mid     music: sound n, from a Standard MIDI File (General MIDI)
  *   games/<name>/sounds/<n>.wav    digital effects: sound n plays this instead of music
  *   games/<name>/resources.ts      optional: `export default () => ResourceData[]` for art,
@@ -71,6 +73,13 @@ export async function buildGame(dir: string, options: { library?: boolean } = {}
   if (!numbers.includes(0)) throw new GameBuildError(`${dir}: no scripts/0.sc or 0.sca (script 0 exports the game object)`);
   const repeated = numbers.find((n, i) => numbers.indexOf(n) !== i);
   if (repeated !== undefined) throw new GameBuildError(`${dir}: script ${repeated} is there twice`);
+  // Items described in items.yaml are made by a script of their own.
+  const items = gameItems(dir);
+  const madeItems = library ? itemsScript(items) : undefined;
+  if (madeItems) {
+    if (numbers.includes(ITEMS_SCRIPT)) throw new GameBuildError(`${dir}: script ${ITEMS_SCRIPT} is where the build makes the items in items.yaml`);
+    compiled.push({ file: join(dir, `${ITEMS_SCRIPT}.items.sc`), text: madeItems });
+  }
   if (library) {
     const lib = load(LIBRARY_DIR, /^\d+\.sc$/);
     const clash = lib.find((l) => numbers.includes(numberOf(l.file)));
@@ -142,7 +151,7 @@ export async function buildGame(dir: string, options: { library?: boolean } = {}
   const compileRooms = (): { file: string; text: string }[] => {
     const roomsDir = join(dir, "rooms");
     if (!existsSync(roomsDir)) return [];
-    const target = libraryTarget(globals, itemVerbs(dir));
+    const target = libraryTarget(globals, items);
     const flags = modFlags(dir, { content: target });
     const out: { file: string; text: string }[] = [];
     for (const { file, text } of load(roomsDir, /^\d+\.room\.yaml$/)) {
@@ -284,23 +293,58 @@ export async function buildGame(dir: string, options: { library?: boolean } = {}
   };
 }
 
-/** items.yaml: `name: verb` lines, each item's verb from 10 to 255 (1 to 4 are the player's). */
-export function itemVerbs(dir: string): Record<string, number> {
+/** An item from items.yaml: its verb, and if it has a view, everything the build needs to make it. */
+export interface GameItem {
+  verb: number;
+  view?: number;
+  description?: string;
+}
+
+/**
+ * items.yaml: each thing the hero can carry, by name. `lens: 10` names just its verb (10 to
+ * 255; 1 to 4 are the player's), for a game whose scripts make the item; with a view, the
+ * build makes it too, in script ITEMS_SCRIPT, and rooms can give it (`<<get lens>>`):
+ *
+ *   lens: { verb: 10, view: 250, description: "Holmes's lens." }
+ */
+export function gameItems(dir: string): Record<string, GameItem> {
   const file = join(dir, "items.yaml");
   if (!existsSync(file)) return {};
   const where = relative(process.cwd(), file);
-  const verbs: Record<string, number> = {};
-  readFileSync(file, "utf8").split("\n").forEach((raw, i) => {
-    const line = raw.replace(/#.*/, "").trim();
-    if (!line) return;
-    const at = `${where}:${i + 1}`;
-    const m = /^([A-Za-z]\w*)\s*:\s*(\d+)$/.exec(line);
-    if (!m) throw new GameBuildError(`${at}: expected item: verb`);
-    const [, name, n] = m, verb = Number(n);
-    if (!/^[a-z][A-Za-z0-9]*$/.test(name!) || ["look", "talk", "walk", "do", "enter"].includes(name!)) throw new GameBuildError(`${at}: "${name}" can't name an item (lower camelCase, and not a verb)`);
-    if (verb < 10 || verb > 255) throw new GameBuildError(`${at}: ${name}: the verb is a number from 10 to 255`);
-    if (Object.values(verbs).includes(verb)) throw new GameBuildError(`${at}: ${name}: verb ${verb} is used twice`);
-    verbs[name!] = verb;
-  });
-  return verbs;
+  const fail = (message: string): never => { throw new GameBuildError(`${where}: ${message}`); };
+  let data: unknown;
+  try { data = parseYaml(readFileSync(file, "utf8")); }
+  catch (e) { return fail((e as Error).message.split("\n")[0]!); }
+  if (data === null || data === undefined) return {};
+  if (typeof data !== "object" || Array.isArray(data)) return fail("expected item: verb, or item: { verb, view, description }");
+  const items: Record<string, GameItem> = {};
+  for (const [name, value] of Object.entries(data as Record<string, unknown>)) {
+    if (!/^[a-z][A-Za-z0-9]*$/.test(name) || ["look", "talk", "walk", "do", "enter"].includes(name)) fail(`"${name}" can't name an item (lower camelCase, and not a verb)`);
+    const spec = typeof value === "number" ? { verb: value } : value;
+    if (!spec || typeof spec !== "object" || Array.isArray(spec)) return fail(`${name}: expected a verb, or { verb, view, description }`);
+    const { verb, view, description, ...rest } = spec as Record<string, unknown>;
+    const unknown = Object.keys(rest)[0];
+    if (unknown) fail(`${name}: unknown key ${unknown}`);
+    if (typeof verb !== "number" || !Number.isInteger(verb) || verb < 10 || verb > 255) fail(`${name}: the verb is a number from 10 to 255`);
+    if (Object.values(items).some((i) => i.verb === verb)) fail(`${name}: verb ${verb} is used twice`);
+    if (view !== undefined && (typeof view !== "number" || !Number.isInteger(view) || view < 0 || view > 65535)) fail(`${name}: view is a view number`);
+    if (description !== undefined && (typeof description !== "string" || /["\\]/.test(description))) fail(`${name}: description is text without quotes or backslashes`);
+    if (description !== undefined && view === undefined) fail(`${name}: an item the build makes needs a view`);
+    items[name] = { verb: verb as number, view: view as number | undefined, description: description as string | undefined };
+  }
+  return items;
+}
+
+/** The script making the items that have views, exported in items.yaml's order. */
+function itemsScript(items: Record<string, GameItem>): string | undefined {
+  const made = Object.entries(items).filter(([, i]) => i.view !== undefined);
+  if (!made.length) return undefined;
+  return [
+    ";;; The items in items.yaml, made by the build.",
+    `(script ${ITEMS_SCRIPT})`,
+    '(include "system.sh")',
+    `(public ${made.map(([name], i) => `${name} ${i}`).join(" ")})`,
+    ...made.map(([name, i]) => `(instance ${name} of InvItem (properties view ${i.view} verb ${i.verb}${i.description ? ` description "${i.description}"` : ""}))`),
+    "",
+  ].join("\n");
 }

package/tools/game/target.d.ts

@@ -4,4 +4,9 @@ import type { Target } from "../../packages/content/src/index.ts";
  * (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[], items?: Record<string, number>): Target;
+/** The script the build makes for the items items.yaml describes (InvItem instances). */
+export declare const ITEMS_SCRIPT = 989;
+export declare function libraryTarget(globals: readonly string[], items?: Record<string, {
+    verb: number;
+    view?: number;
+}>): Target;

package/tools/game/target.js

@@ -3,7 +3,10 @@
  * (packages/content). Global numbers depend on the game's script 0, so the target is made
  * for each build from the compiled globals' names.
  */
+/** The script the build makes for the items items.yaml describes (InvItem instances). */
+export const ITEMS_SCRIPT = 989;
 export function libraryTarget(globals, items = {}) {
+    const made = Object.entries(items).filter(([, i]) => i.view !== undefined).map(([name]) => name);
     const g = (name) => {
         const n = globals.indexOf(name);
         if (n < 0)
@@ -21,6 +24,7 @@ export function libraryTarget(globals, items = {}) {
             narratorObject: g("narrator"),
             music: g("music"),
             sound: g("sfx"),
+            inventory: g("inventory"),
         },
         // As in lib/system.sh.
         narrator: 99,
@@ -35,7 +39,9 @@ export function libraryTarget(globals, items = {}) {
         // room.enter lines: a verb the player can't use.
         narrationVerb: 0,
         // And the game's items (items.yaml): using one is its own verb.
-        verbs: { look: 1, talk: 2, walk: 3, do: 4, ...items },
+        verbs: { look: 1, talk: 2, walk: 3, do: 4, ...Object.fromEntries(Object.entries(items).map(([name, i]) => [name, i.verb])) },
+        // Items the build makes (exported in items.yaml's order): <<get>> and <<drop>>.
+        items: { script: ITEMS_SCRIPT, exports: Object.fromEntries(made.map((name, i) => [name, i])) },
         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

@@ -5,7 +5,11 @@ import type { Target } from "../../packages/content/src/index.ts";
  * (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[], items: Record<string, number> = {}): Target {
+/** The script the build makes for the items items.yaml describes (InvItem instances). */
+export const ITEMS_SCRIPT = 989;
+
+export function libraryTarget(globals: readonly string[], items: Record<string, { verb: number; view?: number }> = {}): Target {
+  const made = Object.entries(items).filter(([, i]) => i.view !== undefined).map(([name]) => name);
   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?`);
@@ -22,6 +26,7 @@ export function libraryTarget(globals: readonly string[], items: Record<string,
       narratorObject: g("narrator"),
       music: g("music"),
       sound: g("sfx"),
+      inventory: g("inventory"),
     },
     // As in lib/system.sh.
     narrator: 99,
@@ -36,7 +41,9 @@ export function libraryTarget(globals: readonly string[], items: Record<string,
     // room.enter lines: a verb the player can't use.
     narrationVerb: 0,
     // And the game's items (items.yaml): using one is its own verb.
-    verbs: { look: 1, talk: 2, walk: 3, do: 4, ...items },
+    verbs: { look: 1, talk: 2, walk: 3, do: 4, ...Object.fromEntries(Object.entries(items).map(([name, i]) => [name, i.verb])) },
+    // Items the build makes (exported in items.yaml's order): <<get>> and <<drop>>.
+    items: { script: ITEMS_SCRIPT, exports: Object.fromEntries(made.map((name, i) => [name, i])) },
     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 },