@umicat/phaser-sdk 1.0.0

package/dist/scene/types.js

@@ -0,0 +1,34 @@
+/**
+ * Scene-as-data types — visual editor foundation (slice 1).
+ *
+ * Spec: umicat-design/features/visual-editor/01-scene-data-foundation.md
+ *
+ * v1 schema (`schemaVersion: 1`) supports the entity kinds needed for the
+ * read-only scene viewer. HUD entity kinds, tilemap, trigger, and
+ * code-rendered visuals will land in later slices.
+ */
+export const SCHEMA_VERSION = 1;
+/**
+ * Type guard — true when `ninePatch` is the per-frame variant. Lets call
+ * sites that only need to handle one shape stay narrow.
+ */
+export function isPerFrameNinePatch(np) {
+    return !!np && 'perFrame' in np;
+}
+/**
+ * Type guard — true when `hitbox` is the per-frame variant. Used by SDK
+ * runtime to decide whether to install an `ANIMATION_UPDATE` listener that
+ * swaps body shape per frame.
+ *
+ * <p>Checks `default != null` (handles both `null` and `undefined`) rather
+ * than `'default' in h`. The backend stores hitboxes after a mode switch
+ * with EXPLICIT NULLS on the alternate shape's fields — `{ kind: 'rect',
+ * x, y, w, h, default: null, frames: null }` for Single mode — because
+ * OpenSearch's _update API deep-merges nested objects and would otherwise
+ * leave stale fields. `'default' in h` would return true on that shape and
+ * trip the per-frame path with a null default. The null check is the
+ * correct discriminator.
+ */
+export function isPerFrameHitbox(h) {
+    return !!h && h.default != null;
+}

package/dist/screenshot/ScreenshotManager.d.ts

@@ -0,0 +1,14 @@
+import Phaser from 'phaser';
+/**
+ * Sets up a postMessage listener that captures the game canvas
+ * when the parent window requests a screenshot.
+ *
+ * Parent sends: { type: 'screenshot' }
+ * Game responds: { type: 'screenshot_result', dataUrl: string }
+ */
+export declare function setupScreenshotListener(game: Phaser.Game): void;
+/**
+ * Take a screenshot programmatically (e.g., from within a scene).
+ * Returns a base64 data URL of the current canvas.
+ */
+export declare function takeScreenshot(game: Phaser.Game): string | null;

package/dist/screenshot/ScreenshotManager.js

@@ -0,0 +1,33 @@
+/**
+ * Sets up a postMessage listener that captures the game canvas
+ * when the parent window requests a screenshot.
+ *
+ * Parent sends: { type: 'screenshot' }
+ * Game responds: { type: 'screenshot_result', dataUrl: string }
+ */
+export function setupScreenshotListener(game) {
+    window.addEventListener('message', (event) => {
+        if (event.data?.type === 'screenshot') {
+            try {
+                const dataUrl = game.canvas.toDataURL('image/png');
+                window.parent.postMessage({ type: 'screenshot_result', dataUrl }, '*');
+            }
+            catch (e) {
+                console.error('[UmicatSDK] Screenshot failed:', e);
+            }
+        }
+    });
+}
+/**
+ * Take a screenshot programmatically (e.g., from within a scene).
+ * Returns a base64 data URL of the current canvas.
+ */
+export function takeScreenshot(game) {
+    try {
+        return game.canvas.toDataURL('image/png');
+    }
+    catch (e) {
+        console.error('[UmicatSDK] Screenshot failed:', e);
+        return null;
+    }
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@umicat/phaser-sdk",
+  "version": "1.0.0",
+  "description": "Umicat Phaser 3 SDK — game infrastructure for the Umicat platform",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "SDK-GUIDE.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "npm run build && node --test scripts/test-chat-facade.mjs",
+    "prepublishOnly": "npm run build && [ \"$UMICAT_PUBLISH_VIA_SCRIPT\" = \"1\" ] || (echo '\\nERROR: do not run `npm publish` directly. Use ./publish.sh instead — it gates on the template-sync checklist.\\nSee CLAUDE.md \"Template sync — do not skip\".\\n' >&2 && exit 1)",
+    "release": "./publish.sh"
+  },
+  "dependencies": {
+    "colyseus.js": "^0.16.0"
+  },
+  "peerDependencies": {
+    "phaser": "^3.60.0",
+    "phaser3-rex-plugins": "^1.80.0"
+  },
+  "devDependencies": {
+    "jose": "^6.2.2",
+    "phaser": "^3.80.0",
+    "phaser3-rex-plugins": "^1.80.20",
+    "typescript": "^5.5.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "UNLICENSED",
+  "private": false
+}