@adatechnology/game-test-room 0.1.0 → 0.1.1

package/README.md

@@ -79,7 +79,7 @@ The items join the catalogue under the module's group and its scenarios become b
 | E | grab / drop |
 | R | rotate the held item |
 | Right button or G | throw |
-| F | use a fluid item (drink); Z tilt; C fill from the tap; V pour |
+| F | use a fluid item (drink); Z tilt; C fill from the tap; V pour (holding a fluid item) or kick (otherwise, with the `kick` tool whatever is selected) |
 | Tab | show / hide the panels |
 
 Panels: catalogue tabs (spawn, Clear, Reset all), slow motion 0.25x, time x10, quality select, inspector (material, state, hp, temperature, char, marks, joints, load and stress) and the behaviour log with filters.
@@ -100,6 +100,10 @@ One JSON object per line (`log.toNDJSON()`, "Baixar NDJSON"):
 `{ passed, failed, results: [{ id, name, ok, checks: [{ label, ok }] }] }`. 21 ship with the package (bullets vs steel, concrete and glass, hammer, shotgun, kick, screwdriver,
 fire and torch, gas bottle, bottle drop, thrown chair, coffee sips and spills, jerrycan leak, fuel fire, columns and a roof, extinguisher). Open the example with `?scenario=all` to run them.
 
+### Inside a claude.ai Artifact
+
+An Artifact page cannot use `<a download>` or blob links. When `globalThis.claude.use('downloads')` resolves, `log.download(format)` offers the file through that capability (the NDJSON goes out as `test-room-log.ndjson.txt`, since `.ndjson` is not on the allowlist) and a declined save writes an `export_cancelled` line to the log; otherwise it falls back to the blob link. **The artifact page must declare the `downloads` capability.** "Copy JSON" falls back to selecting the text in a textarea when `navigator.clipboard` is missing.
+
 ## Português
 
 Uma sala de testes em primeira pessoa para three.js. Você passa o seu catálogo de objetos, anda, atira, bate, queima, corta, arremessa, bebe café e

package/dist/index.d.ts

@@ -15,7 +15,11 @@ interface WritableLog extends TestRoomLog {
     setBeforeRead(fn: (() => void) | null): void;
     setClock(fn: () => number): void;
 }
-declare function createLog(): WritableLog;
+interface LogOptions {
+    /** Text of the `action` line written when the viewer declines (or fails) an export from an Artifact page. */
+    exportCancelled?: () => string;
+}
+declare function createLog(options?: LogOptions): WritableLog;
 
 /** Locales shipped with the package. Unknown locales fall back to `en`. */
 type TestRoomLocale = 'en' | 'pt-BR';
@@ -229,6 +233,12 @@ interface TestRoom {
     tilt(rad: number): void;
     /** Open or close the tap over the table (default: toggle). Returns whether it is open. */
     toggleTap(on?: boolean): boolean;
+    /** Stop the simulation (time, physics, animations, tools, walks): the UI, the camera and the log stay live. `step` and `update` do nothing until `resume`. Scenarios run unpaused. */
+    pause(): void;
+    resume(): void;
+    readonly paused: boolean;
+    /** Walk the player in a straight line to the floor position `to` (x and z; y is ignored) over `seconds` of simulated time, during the next `step()` / frames. Colliders still block. 0 seconds moves at once. */
+    walk(to: Vec3, seconds: number): void;
     /** 0.25x simulation speed. */
     setSlowMotion(on: boolean): void;
     /** Run the simulation 10x per frame (fire, melting and drying take a tenth of the time). */
@@ -318,8 +328,12 @@ interface TestRoomLog {
     toNDJSON(): string;
     /** Plain text lines (the on-screen panel). */
     toText(): string;
-    /** Download the log as a file in the browser (`.ndjson` by default). */
-    download(format?: 'json' | 'ndjson' | 'txt'): void;
+    /**
+     * Download the log as a file (`.ndjson` by default). In a claude.ai Artifact page (a `globalThis.claude.use('downloads')` that resolves) it asks the
+     * viewer through the `downloads` capability (`ndjson` is saved as `.ndjson.txt`, the allowlist has no `.ndjson`); if the viewer declines, an
+     * `export_cancelled` action line is logged. Elsewhere it uses a blob link.
+     */
+    download(format?: 'json' | 'ndjson' | 'txt'): Promise<void>;
     /** Counts per event type and per material (quick summary for checks). */
     summary(): {
         byType: Record<string, number>;