@nodetool-ai/game-nodes 0.8.1

package/README.md

@@ -0,0 +1,61 @@
+# Native game asset nodes
+
+`LoadGameTemplate` lists the slots in a native template. `SlotPrompt` provides
+generation prompts and checker properties. `StageGameAssets` validates checked
+media and stages content-addressed candidate bindings for a full game ID.
+
+Install candidate bindings through the authorized game revision operation.
+Staging does not edit scenes or behaviors.
+
+`StageGameAssets.preparation` maps slot IDs to image settings. Each entry may set
+`trimAlpha`, `targetWidth` and `targetHeight`, `cropPolicy` (`cover`, `contain`,
+`stretch`), `mirrorX`, `mirrorY`, `pivot`, and `sampling`. Resizing, trimming and
+mirror tiling apply to single-image slots. Sheet and tile slots retain their
+checked grid and accept sampling and pivot settings. A sheet may also set
+`sheet: {cols, rows, baseline?}` when its grid matches the checked spritesheet.
+The node decodes the
+checked image, verifies its dimensions, writes prepared PNG bytes, then hashes
+those bytes. A trimmed binding records its original dimensions and crop offset;
+the renderer preserves its anchor. Mirror tiling duplicates reflected edge
+pixels, so both repeat boundaries meet. The maximum prepared dimension is
+4096 pixels per axis.
+
+`SlotPrompt.reference_images` exposes the selected style image for an
+image-to-image generator. The guided graph uses that image as a provider input
+when the chosen style has `reference_asset_id`; it records the reference in the
+staged binding. `StageGameAssets.fonts` maps logical font IDs to local or asset
+URIs for TrueType or OpenType files. Install those bindings through the same
+revision operation as images. New preparation and font bindings require a
+schema version 2 game document.
+
+The `generate_game_asset` agent tool also prepares imported or generated images:
+
+- `sheet: {cols, rows, baseline?}` produces an atlas with equal-sized frames.
+  Each pose is centered horizontally by its alpha bounds and shifted so its
+  lowest opaque row lies at `baseline`, a zero-based cell row. The default is
+  the last row of the cell. A grid that would discard pixels or a baseline
+  that would clip a pose is rejected. Empty cells stay transparent. The tool
+  returns `frames` and bindings named `<slot>.frame.<index>` sharing one atlas.
+- `tileset: {tileWidth?, tileHeight?, edges?, highlight?, shadow?}` resizes a
+  source texture to one tile and bakes a 4×4 atlas of exposed-edge variants.
+  Defaults are 32×32 tiles, a two-pixel edge, highlight 1.16 and shadow 0.72.
+  The mask bits are top `1`, right `2`, bottom `4` and left `8`. Mask zero is
+  the interior. The tool returns `tiles` and `<slot>.tile.<mask>` bindings.
+- `lut: {size?, brightness?, contrast?, saturation?, lift?, gain?, gamma?}`
+  creates an opaque `size² × size` color cube directly, without an image model.
+  Size defaults to 16. The default grade is identity. It applies saturation,
+  contrast and brightness, then channel lift, gamma and gain. It packs red
+  within a blue slice on the horizontal axis and green on the vertical axis,
+  matching the game's LUT renderer.
+
+These modes cannot be combined with each other or with trimming, resizing or
+mirror tiling. Bind the returned frame bindings in one `edit_native_game`
+operation batch or pass them to the game builder's `registerAssets` helper.
+The generated atlas is installed once. Frame bindings reuse its full asset ID.
+
+`generate_game_asset` accepts `input_file` as an owned asset URI, including a
+unique 12-character ID prefix, or a workspace-relative path. `font` imports
+TrueType and OpenType files. `sfx` imports WAV, Ogg or MP3 audio, or runs an
+explicit registered sound-effect `node_type` with its `params` forwarded as
+node inputs. Use `search_nodes` and `get_node_info` to select the node and its
+inputs. Sound-effect node generation is synchronous. Speech remains `audio`.

package/dist/.nodetool-build-stamp

@@ -0,0 +1 @@
+2026-09-28T09:19:13.819Z

package/dist/atlas-preparation.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import { gameLutPreparation, gameSheetPreparation, gameTilesetPreparation } from "@nodetool-ai/protocol";
+import type { PreparedImage } from "./image-preparation.js";
+export declare function prepareSheet(bytes: Uint8Array, width: number, height: number, settings: z.infer<typeof gameSheetPreparation>): Promise<PreparedImage>;
+/** Edge bits are top=1, right=2, bottom=4, left=8. Mask zero is the interior tile. */
+export declare function prepareTileset(bytes: Uint8Array, originalWidth: number, originalHeight: number, settings: z.infer<typeof gameTilesetPreparation>, sampling: "nearest" | "linear"): Promise<PreparedImage>;
+/** Produce a color cube directly so LUTs never depend on an image model's pixels. */
+export declare function prepareLut(settings: z.infer<typeof gameLutPreparation>): Promise<PreparedImage>;
+//# sourceMappingURL=atlas-preparation.d.ts.map

package/dist/atlas-preparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlas-preparation.d.ts","sourceRoot":"","sources":["../src/atlas-preparation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACzG,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAS3E,wBAAsB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EACjF,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CA2CxE;AAED,sFAAsF;AACtF,wBAAsB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EACnG,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,EAAE,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CA8B1G;AAED,qFAAqF;AACrF,wBAAsB,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAyBrG"}

package/dist/atlas-preparation.js

@@ -0,0 +1,117 @@
+import sharp from "sharp";
+const MAX_PIXELS = 4096 * 4096;
+async function encode(pixels, width, height) {
+    return sharp(pixels, { raw: { width, height, channels: 4 } })
+        .png({ compressionLevel: 9, palette: false }).toBuffer();
+}
+export async function prepareSheet(bytes, width, height, settings) {
+    if (width % settings.cols !== 0 || height % settings.rows !== 0) {
+        throw new Error("Sprite sheet dimensions must be divisible by cols and rows");
+    }
+    const cellWidth = width / settings.cols;
+    const cellHeight = height / settings.rows;
+    const baseline = settings.baseline ?? cellHeight - 1;
+    if (baseline >= cellHeight) {
+        throw new Error("Sprite sheet baseline must lie inside each cell");
+    }
+    const source = await sharp(bytes, { limitInputPixels: MAX_PIXELS }).ensureAlpha().raw().toBuffer();
+    const output = Buffer.alloc(width * height * 4);
+    const frames = [];
+    for (let row = 0; row < settings.rows; row += 1) {
+        for (let col = 0; col < settings.cols; col += 1) {
+            const frame = { x: col * cellWidth, y: row * cellHeight, width: cellWidth, height: cellHeight };
+            frames.push(frame);
+            let left = cellWidth;
+            let top = cellHeight;
+            let right = 0;
+            let bottom = 0;
+            for (let y = 0; y < cellHeight; y += 1) {
+                for (let x = 0; x < cellWidth; x += 1) {
+                    if (source[((frame.y + y) * width + frame.x + x) * 4 + 3] === 0) {
+                        continue;
+                    }
+                    left = Math.min(left, x);
+                    top = Math.min(top, y);
+                    right = Math.max(right, x + 1);
+                    bottom = Math.max(bottom, y + 1);
+                }
+            }
+            if (bottom === 0) {
+                continue;
+            }
+            const poseWidth = right - left;
+            const poseHeight = bottom - top;
+            if (poseHeight > baseline + 1) {
+                throw new Error(`Sprite sheet baseline would clip pose ${frames.length - 1}`);
+            }
+            const xOffset = Math.floor((cellWidth - poseWidth) / 2);
+            const yOffset = baseline + 1 - poseHeight;
+            for (let y = 0; y < poseHeight; y += 1) {
+                const start = ((frame.y + top + y) * width + frame.x + left) * 4;
+                source.copy(output, ((frame.y + yOffset + y) * width + frame.x + xOffset) * 4, start, start + poseWidth * 4);
+            }
+        }
+    }
+    return { bytes: await encode(output, width, height), width, height, originalWidth: width,
+        originalHeight: height, frames, baseline };
+}
+/** Edge bits are top=1, right=2, bottom=4, left=8. Mask zero is the interior tile. */
+export async function prepareTileset(bytes, originalWidth, originalHeight, settings, sampling) {
+    const tileWidth = settings.tileWidth;
+    const tileHeight = settings.tileHeight;
+    const width = tileWidth * 4;
+    const height = tileHeight * 4;
+    const source = await sharp(bytes, { limitInputPixels: MAX_PIXELS }).ensureAlpha()
+        .resize(tileWidth, tileHeight, { fit: "cover", kernel: sampling === "nearest" ? "nearest" : "lanczos3" })
+        .raw().toBuffer();
+    const output = Buffer.alloc(width * height * 4);
+    const tiles = [];
+    for (let mask = 0; mask < 16; mask += 1) {
+        const frame = { x: (mask % 4) * tileWidth, y: Math.floor(mask / 4) * tileHeight, width: tileWidth, height: tileHeight };
+        tiles.push({ mask, frame });
+        for (let y = 0; y < tileHeight; y += 1) {
+            for (let x = 0; x < tileWidth; x += 1) {
+                const sourceOffset = (y * tileWidth + x) * 4;
+                const destination = ((frame.y + y) * width + frame.x + x) * 4;
+                const top = (mask & 1) !== 0 && y < settings.edges;
+                const right = (mask & 2) !== 0 && x >= tileWidth - settings.edges;
+                const bottom = (mask & 4) !== 0 && y >= tileHeight - settings.edges;
+                const left = (mask & 8) !== 0 && x < settings.edges;
+                const factor = (top || left ? settings.highlight : 1) * (right || bottom ? settings.shadow : 1);
+                for (let channel = 0; channel < 3; channel += 1) {
+                    output[destination + channel] = Math.min(255, Math.round(source[sourceOffset + channel] * factor));
+                }
+                output[destination + 3] = source[sourceOffset + 3];
+            }
+        }
+    }
+    return { bytes: await encode(output, width, height), width, height, originalWidth, originalHeight, tiles };
+}
+/** Produce a color cube directly so LUTs never depend on an image model's pixels. */
+export async function prepareLut(settings) {
+    const size = settings.size;
+    const width = size * size;
+    const height = size;
+    const output = Buffer.alloc(width * height * 4);
+    const clamp = (value) => Math.min(1, Math.max(0, value));
+    for (let b = 0; b < size; b += 1) {
+        for (let g = 0; g < size; g += 1) {
+            for (let r = 0; r < size; r += 1) {
+                const values = [r, g, b].map((value) => value / (size - 1));
+                const luma = values[0] * 0.2126 + values[1] * 0.7152 + values[2] * 0.0722;
+                const offset = (g * width + b * size + r) * 4;
+                for (let channel = 0; channel < 3; channel += 1) {
+                    const saturated = luma + (values[channel] - luma) * settings.saturation;
+                    const contrasted = (saturated - 0.5) * settings.contrast + 0.5 + settings.brightness;
+                    const lifted = clamp(contrasted + settings.lift[channel]);
+                    const graded = Math.pow(lifted, 1 / settings.gamma[channel]) * settings.gain[channel];
+                    output[offset + channel] = Math.round(clamp(graded) * 255);
+                }
+                output[offset + 3] = 255;
+            }
+        }
+    }
+    return { bytes: await encode(output, width, height), width, height, originalWidth: width,
+        originalHeight: height, lutSize: size };
+}
+//# sourceMappingURL=atlas-preparation.js.map

package/dist/atlas-preparation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlas-preparation.js","sourceRoot":"","sources":["../src/atlas-preparation.ts"],"names":[],"mappings":"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"}

package/dist/fills.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Reading a graph's `fills` input into a native game asset candidate manifest.
+ *
+ * A `nodetool.game.*` checker emits two handles: `fill`, the {@link SlotFill}
+ * it validated, and `output`, the stored image or audio ref carrying that same
+ * fill under `metadata.nodetool_slot`. Only the second one knows where the
+ * bytes are, so that is the handle `StageGameAssets` wants — and a bare fill
+ * is rejected with the wiring that fixes it rather than exported as a project
+ * with no art in it.
+ */
+import { type FilledManifest } from "@nodetool-ai/protocol";
+import type { MediaRefValue } from "@nodetool-ai/runtime";
+export interface ResolvedFills {
+    manifest: FilledManifest;
+    /** The ref to read bytes from, per asset id the writer will copy. */
+    refs: Map<string, MediaRefValue>;
+}
+/**
+ * The filled manifest `fills` describes, plus the ref each asset's bytes come
+ * from.
+ *
+ * An entry is either a checker's stamped `output` ref or a whole
+ * `{slot_id, asset, fill}` record. An empty list is a filled manifest with no
+ * slots — the blank-template export, which ships the template's own art. An
+ * asset id is taken from the ref when it has one and derived from the slot id
+ * when it does not, so a hermetic run — one whose context cannot create
+ * assets, where every checker returns its ref inline — still exports a project
+ * with deterministic resource ids.
+ */
+export declare function resolveFills(template: string, fills: readonly unknown[]): ResolvedFills;
+//# sourceMappingURL=fills.d.ts.map

package/dist/fills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fills.d.ts","sourceRoot":"","sources":["../src/fills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAKL,KAAK,cAAc,EAGpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AA+B1D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,cAAc,CAAC;IACzB,qEAAqE;IACrE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,SAAS,OAAO,EAAE,GACxB,aAAa,CAmEf"}

package/dist/fills.js

@@ -0,0 +1,100 @@
+/**
+ * Reading a graph's `fills` input into a native game asset candidate manifest.
+ *
+ * A `nodetool.game.*` checker emits two handles: `fill`, the {@link SlotFill}
+ * it validated, and `output`, the stored image or audio ref carrying that same
+ * fill under `metadata.nodetool_slot`. Only the second one knows where the
+ * bytes are, so that is the handle `StageGameAssets` wants — and a bare fill
+ * is rejected with the wiring that fixes it rather than exported as a project
+ * with no art in it.
+ */
+import { SLOT_METADATA_KEY, filledManifest, filledSlot, slotFill } from "@nodetool-ai/protocol";
+/** The default extension per fill kind, when a ref's uri carries none. */
+const DEFAULT_EXTENSION = {
+    spritesheet: "png",
+    tileset: "png",
+    image: "png",
+    sfx: "wav",
+    music: "wav"
+};
+const isAudio = (kind) => kind === "sfx" || kind === "music";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const text = (value) => typeof value === "string" ? value.trim() : "";
+/** `asset://player.png` → `player`; anything else → "". */
+function idFromUri(uri) {
+    if (!uri.startsWith("asset://"))
+        return "";
+    return uri.slice("asset://".length).split(".")[0] ?? "";
+}
+function extensionFromUri(uri) {
+    const match = /\.([a-z0-9]+)$/i.exec(uri);
+    return match ? match[1].toLowerCase() : "";
+}
+/**
+ * The filled manifest `fills` describes, plus the ref each asset's bytes come
+ * from.
+ *
+ * An entry is either a checker's stamped `output` ref or a whole
+ * `{slot_id, asset, fill}` record. An empty list is a filled manifest with no
+ * slots — the blank-template export, which ships the template's own art. An
+ * asset id is taken from the ref when it has one and derived from the slot id
+ * when it does not, so a hermetic run — one whose context cannot create
+ * assets, where every checker returns its ref inline — still exports a project
+ * with deterministic resource ids.
+ */
+export function resolveFills(template, fills) {
+    const slots = [];
+    const refs = new Map();
+    for (const [index, entry] of fills.entries()) {
+        const at = `fills[${index}]`;
+        if (!isRecord(entry)) {
+            throw new Error(`${at} is not a slot fill.`);
+        }
+        const whole = filledSlot.safeParse(entry);
+        if (whole.success) {
+            slots.push(whole.data);
+            refs.set(whole.data.asset.asset_id, {
+                uri: whole.data.asset.uri,
+                asset_id: whole.data.asset.asset_id
+            });
+            continue;
+        }
+        const stamped = slotFill.safeParse(isRecord(entry.metadata) ? entry.metadata[SLOT_METADATA_KEY] : undefined);
+        if (!stamped.success) {
+            const bare = slotFill.safeParse(entry);
+            throw new Error(bare.success
+                ? `${at} is a bare ${bare.data.kind} fill for slot ${bare.data.slot_id}, ` +
+                    `which says nothing about where the bytes are. Wire the checker's ` +
+                    `output handle instead of its fill handle.`
+                : `${at} carries no slot fill. Run the asset through the nodetool.game ` +
+                    `node for its kind first (SpriteSheet, Tileset, SeamlessImage, ` +
+                    `SoundEffect, MusicLoop).`);
+        }
+        const fill = stamped.data;
+        const uri = text(entry.uri);
+        const assetId = text(entry.asset_id) || idFromUri(uri) || fill.slot_id.replace(/\./g, "_");
+        const extension = extensionFromUri(uri) || DEFAULT_EXTENSION[fill.kind];
+        slots.push({
+            slot_id: fill.slot_id,
+            asset: {
+                type: isAudio(fill.kind) ? "audio" : "image",
+                uri: `asset://${assetId}.${extension}`,
+                asset_id: assetId
+            },
+            fill
+        });
+        refs.set(assetId, entry);
+    }
+    const parsed = filledManifest.safeParse({
+        manifest_version: 1,
+        template,
+        slots
+    });
+    if (!parsed.success) {
+        throw new Error(`the filled slots do not form a manifest: ${parsed.error.issues
+            .map((i) => `${i.path.join(".") || "<root>"}: ${i.message}`)
+            .join("; ")}`);
+    }
+    return { manifest: parsed.data, refs };
+}
+//# sourceMappingURL=fills.js.map

package/dist/fills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fills.js","sourceRoot":"","sources":["../src/fills.ts"],"names":[],"mappings":"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"}

package/dist/font-preparation.d.ts

@@ -0,0 +1,3 @@
+/** Detect the font containers accepted by the game renderer and export builder. */
+export declare function gameFontFormat(bytes: Uint8Array): "ttf" | "otf" | null;
+//# sourceMappingURL=font-preparation.d.ts.map

package/dist/font-preparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-preparation.d.ts","sourceRoot":"","sources":["../src/font-preparation.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAetE"}

package/dist/font-preparation.js

@@ -0,0 +1,26 @@
+/** Detect the font containers accepted by the game renderer and export builder. */
+export function gameFontFormat(bytes) {
+    if (bytes.length < 12) {
+        return null;
+    }
+    const trueType = bytes[0] === 0 && bytes[1] === 1 && bytes[2] === 0 && bytes[3] === 0;
+    const openType = bytes[0] === 79 && bytes[1] === 84 && bytes[2] === 84 && bytes[3] === 79;
+    if (!trueType && !openType) {
+        return null;
+    }
+    const tables = bytes[4] * 256 + bytes[5];
+    if (tables < 1 || 12 + tables * 16 > bytes.length) {
+        return null;
+    }
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    for (let index = 0; index < tables; index += 1) {
+        const position = 12 + index * 16;
+        const offset = view.getUint32(position + 8);
+        const length = view.getUint32(position + 12);
+        if (offset < 12 + tables * 16 || offset + length > bytes.length) {
+            return null;
+        }
+    }
+    return trueType ? "ttf" : "otf";
+}
+//# sourceMappingURL=font-preparation.js.map

package/dist/font-preparation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-preparation.js","sourceRoot":"","sources":["../src/font-preparation.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC9C,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACtF,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;IAC1F,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACzC,IAAI,MAAM,GAAG,CAAC,IAAI,EAAE,GAAG,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IACnE,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5E,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,EAAE,GAAG,KAAK,GAAG,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;QAC7C,IAAI,MAAM,GAAG,EAAE,GAAG,MAAM,GAAG,EAAE,IAAI,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IACnF,CAAC;IACD,OAAO,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AAClC,CAAC"}

package/dist/image-preparation.d.ts

@@ -0,0 +1,73 @@
+import { z } from "zod";
+export declare const imagePreparationSettings: z.ZodObject<{
+    sheet: z.ZodOptional<z.ZodObject<{
+        cols: z.ZodNumber;
+        rows: z.ZodNumber;
+        baseline: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    tileset: z.ZodOptional<z.ZodObject<{
+        tileWidth: z.ZodDefault<z.ZodNumber>;
+        tileHeight: z.ZodDefault<z.ZodNumber>;
+        edges: z.ZodDefault<z.ZodNumber>;
+        highlight: z.ZodDefault<z.ZodNumber>;
+        shadow: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    lut: z.ZodOptional<z.ZodObject<{
+        size: z.ZodDefault<z.ZodNumber>;
+        brightness: z.ZodDefault<z.ZodNumber>;
+        contrast: z.ZodDefault<z.ZodNumber>;
+        saturation: z.ZodDefault<z.ZodNumber>;
+        lift: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        gain: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+        gamma: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    }, z.core.$strict>>;
+    trimAlpha: z.ZodDefault<z.ZodBoolean>;
+    targetWidth: z.ZodOptional<z.ZodNumber>;
+    targetHeight: z.ZodOptional<z.ZodNumber>;
+    cropPolicy: z.ZodOptional<z.ZodEnum<{
+        contain: "contain";
+        cover: "cover";
+        stretch: "stretch";
+    }>>;
+    mirrorX: z.ZodDefault<z.ZodBoolean>;
+    mirrorY: z.ZodDefault<z.ZodBoolean>;
+    pivot: z.ZodDefault<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>>;
+    sampling: z.ZodDefault<z.ZodEnum<{
+        linear: "linear";
+        nearest: "nearest";
+    }>>;
+}, z.core.$strict>;
+export type ImagePreparationSettings = z.infer<typeof imagePreparationSettings>;
+export interface PreparedImage {
+    readonly bytes: Uint8Array;
+    readonly width: number;
+    readonly height: number;
+    readonly originalWidth: number;
+    readonly originalHeight: number;
+    readonly trim?: {
+        readonly sourceWidth: number;
+        readonly sourceHeight: number;
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly frames?: readonly PreparedFrame[];
+    readonly baseline?: number;
+    readonly tiles?: readonly {
+        readonly mask: number;
+        readonly frame: PreparedFrame;
+    }[];
+    readonly lutSize?: number;
+}
+export interface PreparedFrame {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export declare function imagePreparationMetadata(settings: ImagePreparationSettings): NonNullable<import("@nodetool-ai/protocol").GameAssetBinding["preparation"]>;
+/** Decode, transform and encode canonical PNG bytes before a digest is computed. */
+export declare function prepareGameImage(bytes: Uint8Array, settings: ImagePreparationSettings): Promise<PreparedImage>;
+//# sourceMappingURL=image-preparation.d.ts.map

package/dist/image-preparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-preparation.d.ts","sourceRoot":"","sources":["../src/image-preparation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmBwC,CAAC;AAC9E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;KAAE,EAAE,CAAC;IACrF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AACD,MAAM,WAAW,aAAa;IAAG,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAE1H,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,WAAW,CAAC,OAAO,uBAAuB,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAGzJ;AAED,oFAAoF;AACpF,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC,CA+DpH"}

package/dist/image-preparation.js

@@ -0,0 +1,107 @@
+import sharp from "sharp";
+import { z } from "zod";
+import { gameImagePreparation } from "@nodetool-ai/protocol";
+import { prepareSheet, prepareTileset, prepareLut } from "./atlas-preparation.js";
+const MAX_DIMENSION = 4096;
+const dimension = z.number().int().min(1).max(MAX_DIMENSION);
+export const imagePreparationSettings = gameImagePreparation.extend({
+    trimAlpha: z.boolean().default(false),
+    targetWidth: dimension.optional(),
+    targetHeight: dimension.optional(),
+    cropPolicy: z.enum(["cover", "contain", "stretch"]).optional(),
+    mirrorX: z.boolean().default(false),
+    mirrorY: z.boolean().default(false),
+    pivot: z.strictObject({ x: z.number().finite().min(0).max(1), y: z.number().finite().min(0).max(1) }).default({ x: 0.5, y: 0.5 }),
+    sampling: z.enum(["nearest", "linear"]).default("nearest")
+}).refine((settings) => (settings.targetWidth === undefined) === (settings.targetHeight === undefined), "targetWidth and targetHeight must be set together")
+    .refine((settings) => !settings.cropPolicy || settings.targetWidth !== undefined, "cropPolicy needs targetWidth and targetHeight")
+    .refine((settings) => !(settings.trimAlpha && (settings.mirrorX || settings.mirrorY)), "alpha trimming and mirror tiling cannot be combined")
+    .refine((settings) => [settings.sheet, settings.tileset, settings.lut].filter(Boolean).length <= 1, "choose only one of sheet, tileset or lut")
+    .refine((settings) => !(settings.sheet || settings.tileset || settings.lut) ||
+    !(settings.trimAlpha || settings.targetWidth || settings.mirrorX || settings.mirrorY), "sheet, tileset and lut cannot be combined with single-image transforms");
+export function imagePreparationMetadata(settings) {
+    const { pivot: _pivot, sampling: _sampling, ...metadata } = settings;
+    return metadata;
+}
+/** Decode, transform and encode canonical PNG bytes before a digest is computed. */
+export async function prepareGameImage(bytes, settings) {
+    if (settings.lut) {
+        return prepareLut(settings.lut);
+    }
+    const metadata = await sharp(bytes, { failOn: "error", limitInputPixels: MAX_DIMENSION * MAX_DIMENSION }).metadata();
+    const originalWidth = metadata.width;
+    const originalHeight = metadata.height;
+    if (!originalWidth || !originalHeight || originalWidth > MAX_DIMENSION || originalHeight > MAX_DIMENSION) {
+        throw new Error("Game image has invalid dimensions");
+    }
+    if (settings.sheet) {
+        return prepareSheet(bytes, originalWidth, originalHeight, settings.sheet);
+    }
+    if (settings.tileset) {
+        return prepareTileset(bytes, originalWidth, originalHeight, settings.tileset, settings.sampling);
+    }
+    const resized = sharp(bytes, { failOn: "error", limitInputPixels: MAX_DIMENSION * MAX_DIMENSION }).ensureAlpha();
+    if (settings.targetWidth && settings.targetHeight) {
+        resized.resize(settings.targetWidth, settings.targetHeight, {
+            fit: settings.cropPolicy === "stretch" ? "fill" : settings.cropPolicy ?? "contain",
+            background: { r: 0, g: 0, b: 0, alpha: 0 },
+            kernel: settings.sampling === "nearest" ? "nearest" : "lanczos3"
+        });
+    }
+    const decoded = await resized.raw().toBuffer({ resolveWithObject: true });
+    const source = decoded.data;
+    const sourceWidth = decoded.info.width;
+    const sourceHeight = decoded.info.height;
+    let left = 0;
+    let top = 0;
+    let right = sourceWidth;
+    let bottom = sourceHeight;
+    if (settings.trimAlpha) {
+        left = sourceWidth;
+        top = sourceHeight;
+        right = 0;
+        bottom = 0;
+        for (let y = 0; y < sourceHeight; y += 1) {
+            for (let x = 0; x < sourceWidth; x += 1) {
+                if (source[(y * sourceWidth + x) * 4 + 3] === 0) {
+                    continue;
+                }
+                left = Math.min(left, x);
+                top = Math.min(top, y);
+                right = Math.max(right, x + 1);
+                bottom = Math.max(bottom, y + 1);
+            }
+        }
+        if (right === 0 || bottom === 0) {
+            throw new Error("Cannot trim a fully transparent game image");
+        }
+    }
+    const contentWidth = right - left;
+    const contentHeight = bottom - top;
+    const width = contentWidth * (settings.mirrorX ? 2 : 1);
+    const height = contentHeight * (settings.mirrorY ? 2 : 1);
+    if (width > MAX_DIMENSION || height > MAX_DIMENSION) {
+        throw new Error("Prepared game image exceeds 4096 pixels per axis");
+    }
+    const output = Buffer.alloc(width * height * 4);
+    for (let y = 0; y < height; y += 1) {
+        const localY = y < contentHeight ? y : 2 * contentHeight - y - 1;
+        for (let x = 0; x < width; x += 1) {
+            const localX = x < contentWidth ? x : 2 * contentWidth - x - 1;
+            const sourceOffset = ((top + localY) * sourceWidth + left + localX) * 4;
+            source.copy(output, (y * width + x) * 4, sourceOffset, sourceOffset + 4);
+        }
+    }
+    const prepared = await sharp(output, { raw: { width, height, channels: 4 } }).png({ compressionLevel: 9, palette: false }).toBuffer();
+    const decodedPrepared = await sharp(prepared).metadata();
+    if (decodedPrepared.width !== width || decodedPrepared.height !== height) {
+        throw new Error("Prepared image dimensions changed during encoding");
+    }
+    const trimmed = left !== 0 || top !== 0 || contentWidth !== sourceWidth || contentHeight !== sourceHeight;
+    const result = { bytes: prepared, width, height, originalWidth, originalHeight };
+    if (trimmed) {
+        return { ...result, trim: { sourceWidth, sourceHeight, x: left, y: top } };
+    }
+    return result;
+}
+//# sourceMappingURL=image-preparation.js.map

package/dist/image-preparation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-preparation.js","sourceRoot":"","sources":["../src/image-preparation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAElF,MAAM,aAAa,GAAG,IAAI,CAAC;AAC3B,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,oBAAoB,CAAC,MAAM,CAAC;IAClE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACrC,WAAW,EAAE,SAAS,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,SAAS,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9D,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IACjI,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;CAC3D,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,KAAK,SAAS,CAAC,EACpG,mDAAmD,CAAC;KACnD,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS,EAC9E,+CAA+C,CAAC;KACjD,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,EACnF,qDAAqD,CAAC;KACvD,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,EAChG,0CAA0C,CAAC;KAC5C,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC;IACzE,CAAC,CAAC,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,EACrF,wEAAwE,CAAC,CAAC;AAiB9E,MAAM,UAAU,wBAAwB,CAAC,QAAkC;IACzE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC;IACrE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAiB,EAAE,QAAkC;IAC1F,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;QAAC,OAAO,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IACrH,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC;IACrC,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;IACvC,IAAI,CAAC,aAAa,IAAI,CAAC,cAAc,IAAI,aAAa,GAAG,aAAa,IAAI,cAAc,GAAG,aAAa,EAAE,CAAC;QACzG,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAAC,OAAO,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;IAClG,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QAAC,OAAO,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAAC,CAAC;IAC3H,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACjH,IAAI,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;QAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,YAAY,EAAE;YAC1D,GAAG,EAAE,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,IAAI,SAAS;YAClF,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;YAC1C,MAAM,EAAE,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;SACjE,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC5B,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;IACvC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;IACzC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,WAAW,CAAC;IACxB,IAAI,MAAM,GAAG,YAAY,CAAC;IAC1B,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,IAAI,GAAG,WAAW,CAAC;QACnB,GAAG,GAAG,YAAY,CAAC;QACnB,KAAK,GAAG,CAAC,CAAC;QACV,MAAM,GAAG,CAAC,CAAC;QACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;oBAAC,SAAS;gBAAC,CAAC;gBAC9D,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBACzB,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBACvB,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC/B,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QACD,IAAI,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAAC,CAAC;IACrG,CAAC;IACD,MAAM,YAAY,GAAG,KAAK,GAAG,IAAI,CAAC;IAClC,MAAM,aAAa,GAAG,MAAM,GAAG,GAAG,CAAC;IACnC,MAAM,KAAK,GAAG,YAAY,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,aAAa,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,IAAI,KAAK,GAAG,aAAa,IAAI,MAAM,GAAG,aAAa,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAAC,CAAC;IAC7H,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC;IAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG,CAAC,GAAG,CAAC,CAAC;QACjE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,GAAG,CAAC,GAAG,CAAC,CAAC;YAC/D,MAAM,YAAY,GAAG,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,WAAW,GAAG,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACxE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IACtI,MAAM,eAAe,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;IACzD,IAAI,eAAe,CAAC,KAAK,KAAK,KAAK,IAAI,eAAe,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IAAC,CAAC;IACnJ,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,YAAY,KAAK,WAAW,IAAI,aAAa,KAAK,YAAY,CAAC;IAC1G,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;IACjF,IAAI,OAAO,EAAE,CAAC;QAAC,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC;IAAC,CAAC;IAC5F,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { LoadGameTemplateNode, SlotPromptNode, StageGameAssetsNode, GAME_TEMPLATE_NODES, LEGACY_GAME_NODE_DIAGNOSTIC } from "./nodes/game.js";
+export { resolveFills, type ResolvedFills } from "./fills.js";
+export { getNativeTemplate, listNativeTemplates, type NativeGameTemplate } from "./templates.js";
+export { prepareGameImage, imagePreparationSettings, imagePreparationMetadata, type ImagePreparationSettings, type PreparedImage } from "./image-preparation.js";
+export { gameFontFormat } from "./font-preparation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,KAAK,wBAAwB,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACjK,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { LoadGameTemplateNode, SlotPromptNode, StageGameAssetsNode, GAME_TEMPLATE_NODES, LEGACY_GAME_NODE_DIAGNOSTIC } from "./nodes/game.js";
+export { resolveFills } from "./fills.js";
+export { getNativeTemplate, listNativeTemplates } from "./templates.js";
+export { prepareGameImage, imagePreparationSettings, imagePreparationMetadata } from "./image-preparation.js";
+export { gameFontFormat } from "./font-preparation.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAsB,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAA2B,MAAM,gBAAgB,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,wBAAwB,EAAqD,MAAM,wBAAwB,CAAC;AACjK,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/nodes/game.d.ts

@@ -0,0 +1,102 @@
+import { BaseNode } from "@nodetool-ai/node-sdk";
+import { type Entity, type GameAssetBinding, type GameAssetManifest, type GameSlotSpec, type InputMode } from "@nodetool-ai/protocol";
+import { type ProcessingContext } from "@nodetool-ai/runtime";
+type LoadGameTemplateOutputs = {
+    manifest: GameAssetManifest;
+    slots: GameSlotSpec[];
+    slot: GameSlotSpec;
+};
+export declare class LoadGameTemplateNode extends BaseNode {
+    static readonly nodeType = "nodetool.game.LoadGameTemplate";
+    static readonly title = "Load Game Template";
+    static readonly description = "Read a native game template's asset slots for generation.";
+    static readonly metadataOutputTypes: {
+        manifest: string;
+        slots: string;
+        slot: string;
+    };
+    static readonly inlineFields: string[];
+    static readonly inputFields: string[];
+    static readonly inputMode: InputMode;
+    static readonly outputCorrelation: {
+        slot: {
+            kind: "iteration";
+            source: string;
+            group: string;
+        };
+        slots: {
+            kind: "single";
+            source: string;
+        };
+        manifest: {
+            kind: "single";
+            source: string;
+        };
+    };
+    template: string;
+    process(): Promise<LoadGameTemplateOutputs>;
+    genProcess(): AsyncGenerator<Partial<LoadGameTemplateOutputs>>;
+}
+type SlotPromptOutputs = {
+    prompt: string;
+    width: number;
+    height: number;
+    kind: string;
+    checker: Record<string, unknown>;
+    seconds: number;
+    reference_images: NonNullable<Entity["reference_images"]>;
+    reference_asset_id: string;
+};
+export declare class SlotPromptNode extends BaseNode {
+    static readonly nodeType = "nodetool.game.SlotPrompt";
+    static readonly title = "Slot Prompt";
+    static readonly description = "Turn a native game asset slot into a generation prompt and checker properties.";
+    static readonly metadataOutputTypes: {
+        prompt: string;
+        width: string;
+        height: string;
+        kind: string;
+        checker: string;
+        seconds: string;
+        reference_images: string;
+        reference_asset_id: string;
+    };
+    static readonly inlineFields: string[];
+    static readonly inputFields: string[];
+    slot: unknown;
+    style: Entity | null;
+    cast: Entity[];
+    process(context?: ProcessingContext): Promise<SlotPromptOutputs>;
+}
+type StageGameAssetsOutputs = {
+    output: {
+        gameId: string;
+        bindings: Record<string, GameAssetBinding>;
+    };
+    bindings: Record<string, GameAssetBinding>;
+    paths: string[];
+};
+/** Stage validated media; a separate revision operation installs selected bindings. */
+export declare class StageGameAssetsNode extends BaseNode {
+    static readonly nodeType = "nodetool.game.StageGameAssets";
+    static readonly title = "Stage Game Assets";
+    static readonly description = "Validate generated media and stage candidate bindings for a native game.";
+    static readonly metadataOutputTypes: {
+        output: string;
+        bindings: string;
+        paths: string;
+    };
+    static readonly inlineFields: string[];
+    static readonly inputFields: string[];
+    template: string;
+    game_id: string;
+    fills: unknown[];
+    preparation: Record<string, unknown>;
+    reference_asset_id: string;
+    fonts: Record<string, string>;
+    process(context?: ProcessingContext): Promise<StageGameAssetsOutputs>;
+}
+export declare const LEGACY_GAME_NODE_DIAGNOSTIC = "ExportGodotProject was removed. Create a native game, reconnect surviving asset checkers to StageGameAssets, then install selected bindings into a game revision. GDScript and Godot scenes require manual reconstruction.";
+export declare const GAME_TEMPLATE_NODES: (typeof LoadGameTemplateNode | typeof SlotPromptNode | typeof StageGameAssetsNode)[];
+export {};
+//# sourceMappingURL=game.d.ts.map

package/dist/nodes/game.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../src/nodes/game.ts"],"names":[],"mappings":"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"}

package/dist/nodes/game.js

@@ -0,0 +1,201 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { createHash } from "node:crypto";
+import { BaseNode, isString, prop } from "@nodetool-ai/node-sdk";
+import { checkSlotFill, gameSlotSpec, LEGACY_GAME_EXPORT_DIAGNOSTIC, slotPrompt } from "@nodetool-ai/protocol";
+import { loadMediaRefBytes, resolveEntities } from "@nodetool-ai/runtime";
+import { tagAsServer } from "@nodetool-ai/nodes-utils";
+import { resolveFills } from "../fills.js";
+import { getNativeTemplate, listNativeTemplates } from "../templates.js";
+import { imagePreparationMetadata, imagePreparationSettings, prepareGameImage } from "../image-preparation.js";
+import { gameFontFormat } from "../font-preparation.js";
+const TEMPLATE_IDS = listNativeTemplates().map((template) => template.id);
+const trimmed = (value) => isString(value) ? value.trim() : "";
+export class LoadGameTemplateNode extends BaseNode {
+    static nodeType = "nodetool.game.LoadGameTemplate";
+    static title = "Load Game Template";
+    static description = "Read a native game template's asset slots for generation.";
+    static metadataOutputTypes = { manifest: "dict", slots: "list[game_slot]", slot: "game_slot" };
+    static inlineFields = ["template"];
+    static inputFields = [];
+    static inputMode = "buffered";
+    static outputCorrelation = {
+        slot: { kind: "iteration", source: "__execution__", group: "slots" },
+        slots: { kind: "single", source: "__execution__" },
+        manifest: { kind: "single", source: "__execution__" }
+    };
+    async process() {
+        const manifest = getNativeTemplate(trimmed(this.template)).manifest;
+        return { manifest, slots: manifest.slots, slot: manifest.slots[0] };
+    }
+    async *genProcess() {
+        const manifest = getNativeTemplate(trimmed(this.template)).manifest;
+        for (const slot of manifest.slots)
+            yield { slot };
+        yield { manifest, slots: manifest.slots };
+    }
+}
+__decorate([
+    prop({ type: "str", default: "topdown", title: "Template", values: TEMPLATE_IDS })
+], LoadGameTemplateNode.prototype, "template", void 0);
+export class SlotPromptNode extends BaseNode {
+    static nodeType = "nodetool.game.SlotPrompt";
+    static title = "Slot Prompt";
+    static description = "Turn a native game asset slot into a generation prompt and checker properties.";
+    static metadataOutputTypes = { prompt: "str", width: "int", height: "int", kind: "str", checker: "dict", seconds: "float",
+        reference_images: "list[image]", reference_asset_id: "str" };
+    static inlineFields = [];
+    static inputFields = ["slot", "style", "cast"];
+    async process(context) {
+        const parsed = gameSlotSpec.safeParse(this.slot);
+        if (!parsed.success)
+            throw new Error(`Slot Prompt: invalid game slot: ${parsed.error.message}`);
+        const slot = parsed.data;
+        const [style] = await resolveEntities(this.style ? [this.style] : [], context);
+        const cast = await resolveEntities(Array.isArray(this.cast) ? this.cast : [], context);
+        const result = slotPrompt(slot, style ?? null, cast);
+        return { prompt: result.prompt, width: result.width, height: result.height, kind: slot.kind, checker: result.checker,
+            seconds: slot.kind === "sfx" || slot.kind === "music" ? slot.seconds : 0,
+            reference_images: result.referenceImages, reference_asset_id: result.referenceAssetId };
+    }
+}
+__decorate([
+    prop({ type: "game_slot", default: null, title: "Slot" })
+], SlotPromptNode.prototype, "slot", void 0);
+__decorate([
+    prop({ type: "entity", default: null, title: "Style" })
+], SlotPromptNode.prototype, "style", void 0);
+__decorate([
+    prop({ type: "list[entity]", default: [], title: "Cast" })
+], SlotPromptNode.prototype, "cast", void 0);
+/** Stage validated media; a separate revision operation installs selected bindings. */
+export class StageGameAssetsNode extends BaseNode {
+    static nodeType = "nodetool.game.StageGameAssets";
+    static title = "Stage Game Assets";
+    static description = "Validate generated media and stage candidate bindings for a native game.";
+    static metadataOutputTypes = { output: "dict", bindings: "dict", paths: "list[str]" };
+    static inlineFields = ["template", "game_id"];
+    static inputFields = ["fills", "game_id", "preparation", "reference_asset_id", "fonts"];
+    async process(context) {
+        if (!context?.workspace)
+            throw new Error("Stage Game Assets requires a project workspace");
+        const gameId = trimmed(this.game_id);
+        if (!/^[a-f0-9]{32}$/.test(gameId))
+            throw new Error("Stage Game Assets requires a full 32-character game ID");
+        const manifest = getNativeTemplate(trimmed(this.template)).manifest;
+        const resolved = resolveFills(manifest.template, Array.isArray(this.fills) ? this.fills : []);
+        const specs = new Map(manifest.slots.map((slot) => [slot.id, slot]));
+        for (const slotId of Object.keys(this.preparation ?? {})) {
+            if (!specs.has(slotId))
+                throw new Error(`Unknown preparation slot ${slotId}`);
+        }
+        const bindings = {};
+        const paths = [];
+        for (const slot of resolved.manifest.slots) {
+            const spec = specs.get(slot.slot_id);
+            if (!spec)
+                throw new Error(`Unknown template slot ${slot.slot_id}`);
+            const problems = checkSlotFill(spec, slot.fill);
+            if (problems.length > 0)
+                throw new Error(`Invalid fill for ${slot.slot_id}: ${problems.join("; ")}`);
+            if (bindings[slot.slot_id])
+                throw new Error(`Slot ${slot.slot_id} is filled twice`);
+            const ref = resolved.refs.get(slot.asset.asset_id);
+            if (!ref)
+                throw new Error(`Missing media reference for ${slot.slot_id}`);
+            const sourceBytes = await loadMediaRefBytes(ref, context);
+            if (!sourceBytes || sourceBytes.length === 0)
+                throw new Error(`Cannot read media bytes for ${slot.slot_id}`);
+            const extension = slot.fill.kind === "sfx" || slot.fill.kind === "music" ? "wav" : "png";
+            const requested = this.preparation?.[slot.slot_id];
+            if (extension === "wav" && requested !== undefined)
+                throw new Error(`Preparation is only supported for images: ${slot.slot_id}`);
+            const parsed = extension === "png" ? imagePreparationSettings.safeParse(requested ?? {}) : null;
+            if (parsed && !parsed.success)
+                throw new Error(`Invalid preparation for ${slot.slot_id}: ${parsed.error.message}`);
+            const settings = parsed?.success ? parsed.data : null;
+            if (settings && slot.fill.kind !== "image" &&
+                (settings.trimAlpha || settings.targetWidth !== undefined || settings.mirrorX || settings.mirrorY || settings.tileset || settings.lut)) {
+                throw new Error(`Only single-image slots support trimming, resizing, mirror tiling, tileset creation and LUT creation: ${slot.slot_id}`);
+            }
+            if (settings?.sheet && (slot.fill.kind !== "spritesheet" || settings.sheet.cols !== slot.fill.columns || settings.sheet.rows !== slot.fill.rows)) {
+                throw new Error(`Sheet preparation must match the checked spritesheet grid: ${slot.slot_id}`);
+            }
+            const expectedWidth = slot.fill.kind === "spritesheet" || slot.fill.kind === "tileset" ? slot.fill.columns * slot.fill.cell[0] : slot.fill.kind === "image" ? slot.fill.size[0] : 1;
+            const expectedHeight = slot.fill.kind === "spritesheet" || slot.fill.kind === "tileset" ? slot.fill.rows * slot.fill.cell[1] : slot.fill.kind === "image" ? slot.fill.size[1] : 1;
+            const prepared = settings ? await prepareGameImage(sourceBytes, settings) : null;
+            if (prepared && (prepared.originalWidth !== expectedWidth || prepared.originalHeight !== expectedHeight)) {
+                throw new Error(`Image dimensions for ${slot.slot_id} are ${prepared.originalWidth}x${prepared.originalHeight}, expected ${expectedWidth}x${expectedHeight}`);
+            }
+            const bytes = prepared?.bytes ?? sourceBytes;
+            const digest = createHash("sha256").update(bytes).digest("hex");
+            const path = `games/${gameId}/assets/${digest}.${extension}`;
+            await context.workspace.write(path, bytes);
+            paths.push(path);
+            const referenceAssetId = trimmed(this.reference_asset_id);
+            const binding = { assetId: slot.asset.asset_id, digest, mediaKind: extension === "wav" ? "audio" : "image",
+                width: prepared?.width ?? expectedWidth, height: prepared?.height ?? expectedHeight,
+                pivot: settings?.pivot ?? { x: 0.5, y: 0.5 }, sampling: settings?.sampling ?? "nearest",
+                provenance: `template:${manifest.template}:${slot.slot_id}${referenceAssetId ? `:style:${referenceAssetId}` : ""}` };
+            if (prepared?.baseline !== undefined && prepared.frames?.[0]) {
+                binding.pivot = { x: 0.5, y: (prepared.baseline + 1) / prepared.frames[0].height };
+            }
+            if (settings && requested !== undefined) {
+                binding.preparation = imagePreparationMetadata(settings);
+            }
+            if (prepared?.trim)
+                binding.trim = prepared.trim;
+            if (prepared && requested !== undefined)
+                binding.originalDimensions = { width: prepared.originalWidth, height: prepared.originalHeight };
+            if (referenceAssetId)
+                binding.referenceAssetId = referenceAssetId;
+            bindings[slot.slot_id] = binding;
+        }
+        for (const [fontId, uri] of Object.entries(this.fonts ?? {})) {
+            if (!/^[a-z][a-z0-9_.-]*$/.test(fontId) || typeof uri !== "string" || !uri.trim()) {
+                throw new Error(`Invalid font source for ${fontId}`);
+            }
+            if (bindings[fontId])
+                throw new Error(`Font ID conflicts with a template slot: ${fontId}`);
+            const bytes = await loadMediaRefBytes({ type: "image", uri }, context);
+            if (!bytes || bytes.length < 4)
+                throw new Error(`Cannot read font bytes for ${fontId}`);
+            const fontFormat = gameFontFormat(bytes);
+            if (!fontFormat)
+                throw new Error(`Font ${fontId} must be a TrueType or OpenType font`);
+            const digest = createHash("sha256").update(bytes).digest("hex");
+            const path = `games/${gameId}/assets/${digest}.${fontFormat}`;
+            await context.workspace.write(path, bytes);
+            paths.push(path);
+            bindings[fontId] = { assetId: uri, digest, mediaKind: "font", fontFormat, width: 1, height: 1,
+                pivot: { x: 0.5, y: 0.5 }, sampling: "nearest", required: true,
+                provenance: `font:${fontId}` };
+        }
+        return { output: { gameId, bindings }, bindings, paths };
+    }
+}
+__decorate([
+    prop({ type: "str", default: "topdown", title: "Template", values: TEMPLATE_IDS })
+], StageGameAssetsNode.prototype, "template", void 0);
+__decorate([
+    prop({ type: "str", default: "", title: "Game ID" })
+], StageGameAssetsNode.prototype, "game_id", void 0);
+__decorate([
+    prop({ type: "list[union[image,audio]]", default: [], title: "Checked assets" })
+], StageGameAssetsNode.prototype, "fills", void 0);
+__decorate([
+    prop({ type: "dict", default: {}, title: "Preparation by slot" })
+], StageGameAssetsNode.prototype, "preparation", void 0);
+__decorate([
+    prop({ type: "str", default: "", title: "Shared style image asset ID" })
+], StageGameAssetsNode.prototype, "reference_asset_id", void 0);
+__decorate([
+    prop({ type: "dict", default: {}, title: "Font asset URIs by logical ID" })
+], StageGameAssetsNode.prototype, "fonts", void 0);
+export const LEGACY_GAME_NODE_DIAGNOSTIC = LEGACY_GAME_EXPORT_DIAGNOSTIC;
+export const GAME_TEMPLATE_NODES = tagAsServer([LoadGameTemplateNode, SlotPromptNode, StageGameAssetsNode]);
+//# sourceMappingURL=game.js.map

package/dist/nodes/game.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game.js","sourceRoot":"","sources":["../../src/nodes/game.ts"],"names":[],"mappings":"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"}

package/dist/templates.d.ts

@@ -0,0 +1,9 @@
+import { type GameAssetManifest } from "@nodetool-ai/protocol";
+export interface NativeGameTemplate {
+    readonly id: string;
+    readonly name: string;
+    readonly manifest: GameAssetManifest;
+}
+export declare function listNativeTemplates(): readonly NativeGameTemplate[];
+export declare function getNativeTemplate(id: string): NativeGameTemplate;
+//# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAElF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;CACtC;AAkBD,wBAAgB,mBAAmB,IAAI,SAAS,kBAAkB,EAAE,CAEnE;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,CAGhE"}

package/dist/templates.js

@@ -0,0 +1,25 @@
+import { gameAssetManifest } from "@nodetool-ai/protocol";
+const TOP_DOWN = {
+    id: "topdown",
+    name: "Top-down room",
+    manifest: gameAssetManifest.parse({
+        version: 1,
+        template: "topdown",
+        engineVersion: "1",
+        slots: [
+            { id: "player", kind: "spritesheet", cell: [32, 32], animations: { idle: 1, walk: 4 }, prompt: "top-down player character" },
+            { id: "wall", kind: "tileset", cell: [32, 32], count: 1, prompt: "top-down stone wall tile" },
+            { id: "gem", kind: "spritesheet", cell: [32, 32], animations: { idle: 1 }, prompt: "bright collectible gem" },
+            { id: "sfx.collect", kind: "sfx", seconds: 0.4, prompt: "short collection chime" }
+        ]
+    })
+};
+export function listNativeTemplates() {
+    return [TOP_DOWN];
+}
+export function getNativeTemplate(id) {
+    if (id === TOP_DOWN.id)
+        return TOP_DOWN;
+    throw new Error(`Unknown native game template ${id}. Available: ${TOP_DOWN.id}`);
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA0B,MAAM,uBAAuB,CAAC;AAQlF,MAAM,QAAQ,GAAuB;IACnC,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,iBAAiB,CAAC,KAAK,CAAC;QAChC,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,SAAS;QACnB,aAAa,EAAE,GAAG;QAClB,KAAK,EAAE;YACL,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,2BAA2B,EAAE;YAC5H,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,0BAA0B,EAAE;YAC7F,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,wBAAwB,EAAE;YAC7G,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,wBAAwB,EAAE;SACnF;KACF,CAAC;CACH,CAAC;AAEF,MAAM,UAAU,mBAAmB;IACjC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,IAAI,EAAE,KAAK,QAAQ,CAAC,EAAE;QAAE,OAAO,QAAQ,CAAC;IACxC,MAAM,IAAI,KAAK,CAAC,gCAAgC,EAAE,gBAAgB,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;AACnF,CAAC"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@nodetool-ai/game-nodes",
+  "version": "0.8.1",
+  "description": "NodeTool native game asset generation and staging nodes",
+  "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "node ../../scripts/build-typescript-workspace.mjs",
+    "test": "node ../../scripts/run-vitest.mjs run",
+    "test:watch": "node ../../scripts/run-vitest.mjs",
+    "lint": "node ../../scripts/run-tsc.mjs --noEmit"
+  },
+  "dependencies": {
+    "@nodetool-ai/node-sdk": "^0.8.1",
+    "@nodetool-ai/nodes-utils": "^0.8.1",
+    "@nodetool-ai/protocol": "^0.8.1",
+    "@nodetool-ai/runtime": "^0.8.1",
+    "sharp": "^0.35.3"
+  },
+  "devDependencies": {
+    "@nodetool-ai/audio-nodes": "*",
+    "@nodetool-ai/image-nodes": "*",
+    "@nodetool-ai/storage": "*",
+    "@types/node": "^22.0.0",
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "vitest": "^5.0.1"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./nodes/*": {
+      "types": "./dist/nodes/*.d.ts",
+      "import": "./dist/nodes/*.js",
+      "default": "./dist/nodes/*.js"
+    }
+  },
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nodetool-ai/nodetool.git",
+    "directory": "packages/game-nodes"
+  },
+  "homepage": "https://nodetool.ai",
+  "bugs": {
+    "url": "https://github.com/nodetool-ai/nodetool/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "nodetool",
+    "game",
+    "workflow",
+    "typescript"
+  ]
+}