@ai-game-assets/phaser 0.1.0

package/dist/first-drafts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-drafts.d.ts","sourceRoot":"","sources":["../src/first-drafts.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,kBAAkB,EAA2B,MAAM,mBAAmB,CAAC;AAErF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAElE,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,sCAAsC,GAAG;IACnD,KAAK,EAAE,0BAA0B,CAAC;IAClC,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;IACxD,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACvF,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,uCAAuC,KAAK,IAAI,CAAC;IACzE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,uCAAuC,GAAG;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG;IAClD,QAAQ,EAAE,eAAe,CAAC;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,KAAK,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC,CAAC;CACJ,CAAC;AAEF,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,sCAAsC,GAC9C,OAAO,CAAC,qCAAqC,CAAC,CAuGhD"}

package/dist/first-drafts.js

@@ -0,0 +1,178 @@
+import { aiTextureKey } from "./keys.js";
+export async function ensureMissingAiAssetFirstDrafts(options) {
+    const targetAssetIds = firstDraftTargetAssetIds(options.manifest, options.assetIds)
+        .filter((assetId) => isMissingLoadableAsset(options.manifest.assets[assetId]));
+    const generatedAssetIds = [];
+    const errors = [];
+    const pendingCompletions = [];
+    const applyResult = async (result) => {
+        Object.assign(options.manifest.assets, result.manifest.assets);
+        options.manifest.styleGuide = result.manifest.styleGuide;
+        options.onManifestUpdated?.(options.manifest);
+        for (const generated of result.generated) {
+            const asset = options.manifest.assets[generated.assetId];
+            if (!asset)
+                continue;
+            const textureKey = await loadGeneratedTexture(options.scene, asset, options.baseUrl, options.textureLoadTimeoutMs);
+            if (!generatedAssetIds.includes(generated.assetId)) {
+                generatedAssetIds.push(generated.assetId);
+            }
+            options.onAssetReady?.(generated.assetId, textureKey, asset);
+            options.onProgress?.({
+                completed: generatedAssetIds.length,
+                total: targetAssetIds.length,
+                currentAssetId: generated.assetId,
+                generatedAssetIds: [...generatedAssetIds]
+            });
+        }
+    };
+    options.onProgress?.({
+        completed: 0,
+        total: targetAssetIds.length,
+        generatedAssetIds: []
+    });
+    for (const assetId of targetAssetIds) {
+        if (!isMissingLoadableAsset(options.manifest.assets[assetId])) {
+            continue;
+        }
+        options.onProgress?.({
+            completed: generatedAssetIds.length,
+            total: targetAssetIds.length,
+            currentAssetId: assetId,
+            generatedAssetIds: [...generatedAssetIds]
+        });
+        try {
+            const generation = options.client.ensureFirstDrafts({ assetIds: [assetId] });
+            const result = await softTimeout(generation, options.generationTimeoutMs ?? 90000, `Timed out generating first draft for AI asset "${assetId}".`);
+            if (result.status === "timeout") {
+                errors.push({ assetId, error: result.error });
+                options.onError?.(result.error, assetId);
+                pendingCompletions.push(generation
+                    .then((lateResult) => applyResult(lateResult))
+                    .catch((error) => {
+                    errors.push({ assetId, error });
+                    options.onError?.(error, assetId);
+                }));
+                continue;
+            }
+            await applyResult(result.value);
+        }
+        catch (error) {
+            errors.push({ assetId, error });
+            options.onError?.(error, assetId);
+            if (!options.continueOnError) {
+                throw error;
+            }
+        }
+    }
+    void Promise.allSettled(pendingCompletions);
+    options.onProgress?.({
+        completed: generatedAssetIds.length,
+        total: targetAssetIds.length,
+        generatedAssetIds: [...generatedAssetIds]
+    });
+    return {
+        manifest: options.manifest,
+        generatedAssetIds,
+        errors
+    };
+}
+function firstDraftTargetAssetIds(manifest, rootAssetIds = Object.keys(manifest.assets)) {
+    const targets = [];
+    const add = (assetId) => {
+        if (!assetId || targets.includes(assetId))
+            return;
+        targets.push(assetId);
+    };
+    for (const rootAssetId of rootAssetIds) {
+        const asset = manifest.assets[rootAssetId];
+        const linkedAnimationIds = Object.values(asset?.linkedAnimationAssets ?? {})
+            .map((linkedAnimation) => linkedAnimation.assetId);
+        add(linkedAnimationIds[0] ?? rootAssetId);
+    }
+    for (const rootAssetId of rootAssetIds) {
+        const asset = manifest.assets[rootAssetId];
+        for (const linkedAnimation of Object.values(asset?.linkedAnimationAssets ?? {})) {
+            add(linkedAnimation.assetId);
+        }
+        add(rootAssetId);
+    }
+    for (const assetId of Object.keys(manifest.assets)) {
+        add(assetId);
+    }
+    return targets;
+}
+function isMissingLoadableAsset(asset) {
+    return Boolean(asset &&
+        asset.kind !== "collection" &&
+        asset.kind !== "sound" &&
+        asset.kind !== "music" &&
+        asset.kind !== "voice" &&
+        asset.kind !== "voice-line" &&
+        Object.keys(asset.versions).length === 0);
+}
+function loadGeneratedTexture(scene, asset, baseUrl, timeoutMs = 10000) {
+    if (!scene.textures) {
+        return Promise.reject(new Error("AI asset first-draft loading requires scene.textures."));
+    }
+    const version = asset.versions[asset.activeVersion];
+    if (!version) {
+        return Promise.reject(new Error(`AI asset "${asset.id}" does not have an active generated version.`));
+    }
+    return new Promise((resolve, reject) => {
+        const image = new Image();
+        const textureKey = aiTextureKey({
+            assetId: asset.id,
+            versionName: asset.activeVersion
+        });
+        const timeout = globalThis.setTimeout(() => {
+            image.onload = null;
+            image.onerror = null;
+            reject(new Error(`Timed out loading generated AI asset "${asset.id}".`));
+        }, timeoutMs);
+        image.onload = () => {
+            globalThis.clearTimeout(timeout);
+            if (scene.textures?.exists(textureKey)) {
+                scene.textures.remove(textureKey);
+            }
+            if (asset.frameGrid) {
+                scene.textures?.addSpriteSheet?.(textureKey, image, {
+                    frameWidth: asset.frameGrid.frameWidth,
+                    frameHeight: asset.frameGrid.frameHeight,
+                    margin: asset.frameGrid.margin,
+                    spacing: asset.frameGrid.spacing
+                });
+            }
+            else {
+                scene.textures?.addImage?.(textureKey, image);
+            }
+            resolve(textureKey);
+        };
+        image.onerror = () => {
+            globalThis.clearTimeout(timeout);
+            reject(new Error(`Could not load generated AI asset "${asset.id}".`));
+        };
+        image.src = joinUrl(baseUrl, version.file);
+    });
+}
+async function softTimeout(promise, timeoutMs, message) {
+    return new Promise((resolve, reject) => {
+        const timeout = globalThis.setTimeout(() => {
+            resolve({ status: "timeout", error: new Error(message) });
+        }, timeoutMs);
+        promise.then((value) => {
+            globalThis.clearTimeout(timeout);
+            resolve({ status: "resolved", value });
+        }, (error) => {
+            globalThis.clearTimeout(timeout);
+            reject(error);
+        });
+    });
+}
+function joinUrl(baseUrl, file) {
+    if (!baseUrl) {
+        return file;
+    }
+    return `${baseUrl.replace(/\/$/, "")}/${file.replace(/^\//, "")}`;
+}
+//# sourceMappingURL=first-drafts.js.map

package/dist/first-drafts.js.map

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

package/dist/frame-transforms.d.ts

@@ -0,0 +1,24 @@
+import type { AiAssetAnimation } from "@ai-game-assets/core";
+export type AiAssetFrameTransformSize = {
+    width: number;
+    height: number;
+};
+export type AiAssetFrameTransformTarget = {
+    setDisplaySize(width: number, height: number): unknown;
+    setOrigin(x: number, y: number): unknown;
+    setRotation(radians: number): unknown;
+    on?(eventName: string, handler: (...args: unknown[]) => void): unknown;
+    off?(eventName: string, handler: (...args: unknown[]) => void): unknown;
+};
+export type AiAssetFrameTransformOptions = {
+    originX?: number;
+    originY?: number;
+    eventName?: string;
+};
+export type AiAssetFrameTransformBinding = {
+    apply(frameSlot: number): void;
+    detach(): void;
+};
+export declare function applyAiAnimationFrameTransform(target: AiAssetFrameTransformTarget, animation: AiAssetAnimation | undefined, frameSlot: number, size: AiAssetFrameTransformSize, options?: AiAssetFrameTransformOptions): void;
+export declare function bindAiAnimationFrameTransforms(target: AiAssetFrameTransformTarget, animation: AiAssetAnimation | undefined, size: AiAssetFrameTransformSize, options?: AiAssetFrameTransformOptions): AiAssetFrameTransformBinding;
+//# sourceMappingURL=frame-transforms.d.ts.map

package/dist/frame-transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-transforms.d.ts","sourceRoot":"","sources":["../src/frame-transforms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACvD,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;IACvE,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;CACzE,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,IAAI,IAAI,CAAC;CAChB,CAAC;AAIF,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,2BAA2B,EACnC,SAAS,EAAE,gBAAgB,GAAG,SAAS,EACvC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,yBAAyB,EAC/B,OAAO,GAAE,4BAAiC,GACzC,IAAI,CAiBN;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,2BAA2B,EACnC,SAAS,EAAE,gBAAgB,GAAG,SAAS,EACvC,IAAI,EAAE,yBAAyB,EAC/B,OAAO,GAAE,4BAAiC,GACzC,4BAA4B,CAyB9B"}

package/dist/frame-transforms.js

@@ -0,0 +1,33 @@
+const defaultAnimationUpdateEventName = "animationupdate";
+export function applyAiAnimationFrameTransform(target, animation, frameSlot, size, options = {}) {
+    const normalizedFrameSlot = Math.max(0, frameSlot);
+    const timing = animation?.frameTimings?.[normalizedFrameSlot];
+    const offsetX = timing?.offsetX ?? 0;
+    const offsetY = timing?.offsetY ?? 0;
+    const scaleX = timing?.scaleX ?? 1;
+    const scaleY = timing?.scaleY ?? 1;
+    const rotation = timing?.rotation ?? 0;
+    const originX = options.originX ?? 0.5;
+    const originY = options.originY ?? 0.5;
+    target.setDisplaySize(size.width * scaleX, size.height * scaleY);
+    target.setOrigin(originX - offsetX / Math.max(1, size.width), originY - offsetY / Math.max(1, size.height));
+    target.setRotation(rotation * Math.PI / 180);
+}
+export function bindAiAnimationFrameTransforms(target, animation, size, options = {}) {
+    const eventName = options.eventName ?? defaultAnimationUpdateEventName;
+    const handler = (...args) => {
+        const frame = args[1];
+        applyAiAnimationFrameTransform(target, animation, Math.max(0, (frame?.index ?? 1) - 1), size, options);
+    };
+    applyAiAnimationFrameTransform(target, animation, 0, size, options);
+    target.on?.(eventName, handler);
+    return {
+        apply(frameSlot) {
+            applyAiAnimationFrameTransform(target, animation, frameSlot, size, options);
+        },
+        detach() {
+            target.off?.(eventName, handler);
+        }
+    };
+}
+//# sourceMappingURL=frame-transforms.js.map

package/dist/frame-transforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-transforms.js","sourceRoot":"","sources":["../src/frame-transforms.ts"],"names":[],"mappings":"AA0BA,MAAM,+BAA+B,GAAG,iBAAiB,CAAC;AAE1D,MAAM,UAAU,8BAA8B,CAC5C,MAAmC,EACnC,SAAuC,EACvC,SAAiB,EACjB,IAA+B,EAC/B,UAAwC,EAAE;IAE1C,MAAM,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,CAAC,mBAAmB,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,IAAI,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC;IAEvC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACjE,MAAM,CAAC,SAAS,CACd,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAC3C,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAC7C,CAAC;IACF,MAAM,CAAC,WAAW,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,MAAmC,EACnC,SAAuC,EACvC,IAA+B,EAC/B,UAAwC,EAAE;IAE1C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,+BAA+B,CAAC;IACvE,MAAM,OAAO,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAmC,CAAC;QAExD,8BAA8B,CAC5B,MAAM,EACN,SAAS,EACT,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EACpC,IAAI,EACJ,OAAO,CACR,CAAC;IACJ,CAAC,CAAC;IAEF,8BAA8B,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACpE,MAAM,CAAC,EAAE,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEhC,OAAO;QACL,KAAK,CAAC,SAAiB;YACrB,8BAA8B,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM;YACJ,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export type { LoadAiAssetOptions } from "./loader.js";
+export { loadAiAsset, loadAiAudioAsset, loadAiAudioAssets, loadAiAssets } from "./loader.js";
+export { createAiAnimations } from "./animations.js";
+export type { AiAssetFrameTransformBinding, AiAssetFrameTransformOptions, AiAssetFrameTransformSize, AiAssetFrameTransformTarget } from "./frame-transforms.js";
+export { applyAiAnimationFrameTransform, bindAiAnimationFrameTransforms } from "./frame-transforms.js";
+export type { EnsureMissingAiAssetFirstDraftsOptions, EnsureMissingAiAssetFirstDraftsProgress, EnsureMissingAiAssetFirstDraftsResult } from "./first-drafts.js";
+export { ensureMissingAiAssetFirstDrafts } from "./first-drafts.js";
+export type { AiAssetRuntimeOptions } from "./runtime.js";
+export { AiAssetRuntime } from "./runtime.js";
+export { aiTextureKey } from "./keys.js";
+export type { GenerateDebugOptionsRequest, DebugStyleGuideDraft, GeneratedDebugOption, SaveDebugOptionRequest } from "./debug-client.js";
+export { AiAssetDebugClient } from "./debug-client.js";
+export type { AiAssetDesigner, AiAssetDesignerOptions, AiAssetDesignerSceneLike } from "./designer.js";
+export { installAiAssetDesigner } from "./designer.js";
+export type { PhaserAnimationsLike, PhaserImageLike, PhaserLoaderLike, PhaserSceneLike, PhaserTextureManagerLike } from "./phaser-types.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,YAAY,EACV,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,YAAY,EACV,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,8BAA8B,EAC9B,8BAA8B,EAC/B,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,sCAAsC,EACtC,uCAAuC,EACvC,qCAAqC,EACtC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAEpE,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,YAAY,EACV,2BAA2B,EAC3B,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACzB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { loadAiAsset, loadAiAudioAsset, loadAiAudioAssets, loadAiAssets } from "./loader.js";
+export { createAiAnimations } from "./animations.js";
+export { applyAiAnimationFrameTransform, bindAiAnimationFrameTransforms } from "./frame-transforms.js";
+export { ensureMissingAiAssetFirstDrafts } from "./first-drafts.js";
+export { AiAssetRuntime } from "./runtime.js";
+export { aiTextureKey } from "./keys.js";
+export { AiAssetDebugClient } from "./debug-client.js";
+export { installAiAssetDesigner } from "./designer.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":"AAIA,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AASrD,OAAO,EACL,8BAA8B,EAC9B,8BAA8B,EAC/B,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AAIpE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AASzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAQvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/keys.d.ts

@@ -0,0 +1,3 @@
+import type { AiAssetSelection } from "@ai-game-assets/core";
+export declare function aiTextureKey(selection: AiAssetSelection | string): string;
+//# sourceMappingURL=keys.d.ts.map

package/dist/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,wBAAgB,YAAY,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAQzE"}

package/dist/keys.js

@@ -0,0 +1,9 @@
+export function aiTextureKey(selection) {
+    if (typeof selection === "string") {
+        return selection;
+    }
+    return selection.versionName
+        ? `${selection.assetId}#${selection.versionName}`
+        : selection.assetId;
+}
+//# sourceMappingURL=keys.js.map

package/dist/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,SAAoC;IAC/D,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC,WAAW;QAC1B,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,WAAW,EAAE;QACjD,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;AACxB,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,12 @@
+import { type AiAssetManifest, type AiAssetSelection, type ResolvedAiAsset } from "@ai-game-assets/core";
+import type { PhaserSceneLike } from "./phaser-types.js";
+export type LoadAiAssetOptions = {
+    key?: string;
+    baseUrl?: string;
+    versionName?: string;
+};
+export declare function loadAiAsset(scene: PhaserSceneLike, manifest: AiAssetManifest, selection: AiAssetSelection | string, options?: LoadAiAssetOptions): ResolvedAiAsset;
+export declare function loadAiAudioAsset(scene: PhaserSceneLike, manifest: AiAssetManifest, selection: AiAssetSelection | string, options?: LoadAiAssetOptions): ResolvedAiAsset | undefined;
+export declare function loadAiAudioAssets(scene: PhaserSceneLike, manifest: AiAssetManifest, options?: LoadAiAssetOptions): ResolvedAiAsset[];
+export declare function loadAiAssets(scene: PhaserSceneLike, manifest: AiAssetManifest, options?: LoadAiAssetOptions): ResolvedAiAsset[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,WAAW,CACzB,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,gBAAgB,GAAG,MAAM,EACpC,OAAO,GAAE,kBAAuB,GAC/B,eAAe,CAuFjB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,gBAAgB,GAAG,MAAM,EACpC,OAAO,GAAE,kBAAuB,GAC/B,eAAe,GAAG,SAAS,CA+B7B;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,kBAAuB,GAC/B,eAAe,EAAE,CAKnB;AAMD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,kBAAuB,GAC/B,eAAe,EAAE,CAInB"}

package/dist/loader.js

@@ -0,0 +1,130 @@
+import { resolveAiAsset } from "@ai-game-assets/core";
+import { aiTextureKey } from "./keys.js";
+import { aiAssetPlaceholderDataUrl } from "./placeholder.js";
+export function loadAiAsset(scene, manifest, selection, options = {}) {
+    const assetId = typeof selection === "string" ? selection : selection.assetId;
+    if (manifest.assets[assetId]?.kind === "collection" ||
+        manifest.assets[assetId]?.kind === "sound" ||
+        manifest.assets[assetId]?.kind === "music" ||
+        manifest.assets[assetId]?.kind === "voice" ||
+        manifest.assets[assetId]?.kind === "voice-line") {
+        throw new Error(`AI asset "${assetId}" cannot be loaded as a texture.`);
+    }
+    const unresolvedAsset = manifest.assets[assetId];
+    if (unresolvedAsset && Object.keys(unresolvedAsset.versions).length === 0) {
+        const key = options.key ?? aiTextureKey({ assetId });
+        const url = aiAssetPlaceholderDataUrl(unresolvedAsset);
+        if (unresolvedAsset.kind === "spritesheet" || unresolvedAsset.kind === "animation") {
+            if (!unresolvedAsset.frameGrid) {
+                throw new Error(`AI asset "${unresolvedAsset.id}" requires frameGrid for spritesheet loading.`);
+            }
+            scene.load.spritesheet(key, url, {
+                frameWidth: unresolvedAsset.frameGrid.frameWidth,
+                frameHeight: unresolvedAsset.frameGrid.frameHeight,
+                margin: unresolvedAsset.frameGrid.margin,
+                spacing: unresolvedAsset.frameGrid.spacing
+            });
+        }
+        else if (scene.load.svg) {
+            scene.load.svg(key, url, {
+                width: unresolvedAsset.dimensions?.width ?? 1,
+                height: unresolvedAsset.dimensions?.height ?? 1
+            });
+        }
+        else {
+            scene.load.image(key, url);
+        }
+        return {
+            asset: unresolvedAsset,
+            versionName: "",
+            version: {
+                name: "",
+                file: url,
+                prompt: unresolvedAsset.prompt,
+                createdAt: new Date(0).toISOString(),
+                model: "loading-placeholder"
+            }
+        };
+    }
+    const resolved = resolveAiAsset(manifest, typeof selection === "string"
+        ? { assetId: selection, versionName: options.versionName }
+        : { ...selection, versionName: options.versionName ?? selection.versionName });
+    const key = options.key ?? aiTextureKey({
+        assetId: resolved.asset.id,
+        versionName: resolved.versionName === resolved.asset.activeVersion
+            ? undefined
+            : resolved.versionName
+    });
+    const url = joinUrl(options.baseUrl, resolved.version.file);
+    if (resolved.asset.kind === "spritesheet" || resolved.asset.kind === "animation") {
+        if (!resolved.asset.frameGrid) {
+            throw new Error(`AI asset "${resolved.asset.id}" requires frameGrid for spritesheet loading.`);
+        }
+        scene.load.spritesheet(key, url, {
+            frameWidth: resolved.asset.frameGrid.frameWidth,
+            frameHeight: resolved.asset.frameGrid.frameHeight,
+            margin: resolved.asset.frameGrid.margin,
+            spacing: resolved.asset.frameGrid.spacing
+        });
+    }
+    else {
+        if (isSvg(url) && scene.load.svg) {
+            scene.load.svg(key, url, {
+                width: resolved.asset.dimensions?.width ?? 1,
+                height: resolved.asset.dimensions?.height ?? 1
+            });
+        }
+        else {
+            scene.load.image(key, url);
+        }
+    }
+    return resolved;
+}
+export function loadAiAudioAsset(scene, manifest, selection, options = {}) {
+    const assetId = typeof selection === "string" ? selection : selection.assetId;
+    const asset = manifest.assets[assetId];
+    if (!asset || !isAudioLikeAsset(asset.kind)) {
+        throw new Error(`AI asset "${assetId}" is not an audio asset.`);
+    }
+    if (!scene.load.audio) {
+        throw new Error("This Phaser scene loader does not support audio assets.");
+    }
+    if (Object.keys(asset.versions).length === 0) {
+        return undefined;
+    }
+    const resolved = resolveAiAsset(manifest, typeof selection === "string"
+        ? { assetId: selection, versionName: options.versionName }
+        : { ...selection, versionName: options.versionName ?? selection.versionName });
+    const key = options.key ?? aiTextureKey({
+        assetId: resolved.asset.id,
+        versionName: resolved.versionName === resolved.asset.activeVersion
+            ? undefined
+            : resolved.versionName
+    });
+    scene.load.audio(key, joinUrl(options.baseUrl, resolved.version.file));
+    return resolved;
+}
+export function loadAiAudioAssets(scene, manifest, options = {}) {
+    return Object.values(manifest.assets)
+        .filter((asset) => asset.kind === "sound" || asset.kind === "music")
+        .map((asset) => loadAiAudioAsset(scene, manifest, asset.id, options))
+        .filter((asset) => Boolean(asset));
+}
+function isSvg(url) {
+    return /\.svg(?:$|[?#])/i.test(url);
+}
+export function loadAiAssets(scene, manifest, options = {}) {
+    return Object.values(manifest.assets)
+        .filter((asset) => asset.kind !== "collection" && !isAudioLikeAsset(asset.kind))
+        .map((asset) => loadAiAsset(scene, manifest, asset.id, options));
+}
+function isAudioLikeAsset(kind) {
+    return kind === "sound" || kind === "music" || kind === "voice" || kind === "voice-line";
+}
+function joinUrl(baseUrl, file) {
+    if (!baseUrl) {
+        return file;
+    }
+    return `${baseUrl.replace(/\/$/, "")}/${file.replace(/^\//, "")}`;
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/phaser-types.d.ts

@@ -0,0 +1,41 @@
+export type PhaserLoaderLike = {
+    audio?(key: string, urls: string | string[]): unknown;
+    image(key: string, url: string): unknown;
+    svg?(key: string, url: string, config?: {
+        width?: number;
+        height?: number;
+    }): unknown;
+    spritesheet(key: string, url: string, config: {
+        frameWidth: number;
+        frameHeight: number;
+        margin?: number;
+        spacing?: number;
+    }): unknown;
+};
+export type PhaserTextureManagerLike = {
+    exists(key: string): boolean;
+    remove(key: string): unknown;
+    addImage?(key: string, image: HTMLImageElement): unknown;
+    addSpriteSheet?(key: string, image: HTMLImageElement, config: {
+        frameWidth: number;
+        frameHeight: number;
+        margin?: number;
+        spacing?: number;
+    }): unknown;
+};
+export type PhaserAnimationsLike = {
+    create(config: unknown): unknown;
+    remove?(key: string): unknown;
+    generateFrameNumbers(key: string, config: {
+        frames: number[];
+    }): unknown;
+};
+export type PhaserSceneLike = {
+    load: PhaserLoaderLike;
+    textures?: PhaserTextureManagerLike;
+    anims?: PhaserAnimationsLike;
+};
+export type PhaserImageLike = {
+    setTexture(key: string, frame?: string | number): unknown;
+};
+//# sourceMappingURL=phaser-types.d.ts.map

package/dist/phaser-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phaser-types.d.ts","sourceRoot":"","sources":["../src/phaser-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IACtD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACzC,GAAG,CAAC,CACF,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA,OAAO,CAAC;IACX,WAAW,CACT,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,QAAQ,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;IACzD,cAAc,CAAC,CACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IACjC,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,oBAAoB,CAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,GAC3B,OAAO,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC3D,CAAC"}

package/dist/phaser-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=phaser-types.js.map

package/dist/phaser-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phaser-types.js","sourceRoot":"","sources":["../src/phaser-types.ts"],"names":[],"mappings":""}

package/dist/placeholder.d.ts

@@ -0,0 +1,3 @@
+import type { AiAssetDefinition } from "@ai-game-assets/core";
+export declare function aiAssetPlaceholderDataUrl(asset: AiAssetDefinition): string;
+//# sourceMappingURL=placeholder.d.ts.map

package/dist/placeholder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder.d.ts","sourceRoot":"","sources":["../src/placeholder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CA2C1E"}

package/dist/placeholder.js

@@ -0,0 +1,56 @@
+export function aiAssetPlaceholderDataUrl(asset) {
+    const width = asset.frameGrid
+        ? asset.frameGrid.frameWidth * asset.frameGrid.columns
+        : asset.dimensions?.width ?? 128;
+    const height = asset.frameGrid
+        ? asset.frameGrid.frameHeight * asset.frameGrid.rows
+        : asset.dimensions?.height ?? 128;
+    const frameWidth = asset.frameGrid?.frameWidth ?? width;
+    const frameHeight = asset.frameGrid?.frameHeight ?? height;
+    const cells = [];
+    if (asset.frameGrid) {
+        const frameCount = asset.frameGrid.frameCount ?? asset.frameGrid.columns * asset.frameGrid.rows;
+        for (let index = 0; index < frameCount; index += 1) {
+            const column = index % asset.frameGrid.columns;
+            const row = Math.floor(index / asset.frameGrid.columns);
+            cells.push(placeholderCell(column * frameWidth, row * frameHeight, frameWidth, frameHeight, index));
+        }
+    }
+    else {
+        cells.push(placeholderCell(0, 0, width, height, 0));
+    }
+    const svg = [
+        `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}">`,
+        "<defs>",
+        "<pattern id=\"grid\" width=\"8\" height=\"8\" patternUnits=\"userSpaceOnUse\">",
+        "<path d=\"M8 0H0v8\" fill=\"none\" stroke=\"#334155\" stroke-width=\"1\" opacity=\".35\"/>",
+        "</pattern>",
+        "</defs>",
+        `<rect width="${width}" height="${height}" rx="4" fill="#0f172a"/>`,
+        `<rect width="${width}" height="${height}" fill="url(#grid)"/>`,
+        cells.join(""),
+        "</svg>"
+    ].join("");
+    return `data:image/svg+xml;base64,${base64Encode(svg)}`;
+}
+function placeholderCell(x, y, width, height, index) {
+    const cx = x + width / 2;
+    const cy = y + height / 2;
+    const pulse = 0.25 + (index % 4) * 0.15;
+    return [
+        `<rect x="${x + 1}" y="${y + 1}" width="${Math.max(1, width - 2)}" height="${Math.max(1, height - 2)}" rx="3" fill="#111827" stroke="#475569" stroke-width="1"/>`,
+        `<circle cx="${cx}" cy="${cy - Math.max(5, height * 0.12)}" r="${Math.max(2, Math.min(width, height) * (0.1 + pulse * 0.04))}" fill="#38bdf8" opacity="${pulse}"/>`,
+        `<text x="${cx}" y="${cy + Math.max(5, height * 0.18)}" text-anchor="middle" font-family="Inter, Arial, sans-serif" font-size="${Math.max(5, Math.min(width / 5, height / 5, 12))}" fill="#e2e8f0">Loading...</text>`
+    ].join("");
+}
+function base64Encode(value) {
+    if (typeof btoa === "function") {
+        return btoa(value);
+    }
+    const bufferConstructor = globalThis.Buffer;
+    if (!bufferConstructor) {
+        throw new Error("AI asset placeholder generation requires btoa or Buffer.");
+    }
+    return bufferConstructor.from(value, "utf8").toString("base64");
+}
+//# sourceMappingURL=placeholder.js.map

package/dist/placeholder.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,15 @@
+import { type AiAssetManifest, type AiAssetSelection } from "@ai-game-assets/core";
+import type { PhaserImageLike, PhaserSceneLike } from "./phaser-types.js";
+export type AiAssetRuntimeOptions = {
+    baseUrl?: string;
+};
+export declare class AiAssetRuntime {
+    readonly scene: PhaserSceneLike;
+    readonly manifest: AiAssetManifest;
+    readonly baseUrl?: string;
+    constructor(scene: PhaserSceneLike, manifest: AiAssetManifest, options?: AiAssetRuntimeOptions);
+    key(selection: AiAssetSelection | string): string;
+    setTexture(target: PhaserImageLike, selection: AiAssetSelection | string): void;
+    url(selection: AiAssetSelection | string): string;
+}
+//# sourceMappingURL=runtime.d.ts.map