@unboxy/phaser-sdk 0.2.19 → 0.2.20

package/dist/editor/EditorBridge.js

@@ -138,6 +138,7 @@ function buildOverlayInit(game) {
             before,
             after,
         }),
+        postShortcut: (action) => postToHost({ type: 'unboxy:editor:shortcut', action }),
     };
 }
 // --- Snapshot -------------------------------------------------------------

package/dist/editor/EditorOverlayScene.d.ts

@@ -43,6 +43,12 @@ interface EditorOverlayInitData {
         x: number;
         y: number;
     }) => void;
+    /**
+     * Forward an editor keyboard shortcut to the host. Set when the iframe has
+     * focus (which is always after the user clicks the canvas to select);
+     * native Cmd+Z otherwise can't reach the host.
+     */
+    postShortcut: (action: 'undo' | 'redo' | 'save') => void;
 }
 export declare class EditorOverlayScene extends Phaser.Scene {
     private graphics;
@@ -50,9 +56,11 @@ export declare class EditorOverlayScene extends Phaser.Scene {
     private hitTest;
     private postPick;
     private postDragEnd;
+    private postShortcut;
     constructor();
     init(data: EditorOverlayInitData): void;
     create(): void;
+    private handleShortcut;
     private handlePointerDown;
     private handlePointerMove;
     private handlePointerUp;

package/dist/editor/EditorOverlayScene.js

@@ -26,12 +26,40 @@ const WORLD_BOUNDS_ALPHA = 0.5;
 export class EditorOverlayScene extends Phaser.Scene {
     constructor() {
         super({ key: EDITOR_OVERLAY_KEY });
+        this.handleShortcut = (e) => {
+            if (!(e.metaKey || e.ctrlKey))
+                return;
+            // Don't swallow keys when the user is typing in a real form control —
+            // shouldn't happen inside the iframe, but be defensive.
+            const target = e.target;
+            if (target) {
+                const tag = target.tagName;
+                if (tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT')
+                    return;
+                if (target.isContentEditable)
+                    return;
+            }
+            const k = e.key.toLowerCase();
+            if (k === 'z') {
+                e.preventDefault();
+                this.postShortcut(e.shiftKey ? 'redo' : 'undo');
+            }
+            else if (k === 'y') {
+                e.preventDefault();
+                this.postShortcut('redo');
+            }
+            else if (k === 's') {
+                e.preventDefault();
+                this.postShortcut('save');
+            }
+        };
     }
     init(data) {
         this.worldBounds = data.worldBounds;
         this.hitTest = data.hitTest;
         this.postPick = data.postPick;
         this.postDragEnd = data.postDragEnd;
+        this.postShortcut = data.postShortcut;
     }
     create() {
         this.graphics = this.add.graphics();
@@ -45,6 +73,19 @@ export class EditorOverlayScene extends Phaser.Scene {
         this.input.on('pointerdown', this.handlePointerDown, this);
         this.input.on('pointermove', this.handlePointerMove, this);
         this.input.on('pointerup', this.handlePointerUp, this);
+        // Forward editor shortcuts back to the host. The user clicks the canvas
+        // to select an entity, which moves focus into the iframe — after that,
+        // native Cmd+Z lands here, not on the host's window. We catch it before
+        // Phaser's keyboard plugin gets it (DOM phase is fine because Phaser
+        // listens via its own KeyboardManager), preventDefault'ing browser
+        // back-nav-on-Cmd+Left etc. is unnecessary; we only intercept the few
+        // editor keys we care about.
+        if (typeof document !== 'undefined') {
+            document.addEventListener('keydown', this.handleShortcut, true);
+            this.events.once(Phaser.Scenes.Events.SHUTDOWN, () => {
+                document.removeEventListener('keydown', this.handleShortcut, true);
+            });
+        }
     }
     handlePointerDown(pointer) {
         const state = getEditorState(this.game);

package/dist/index.d.ts

@@ -24,7 +24,7 @@ export { EntityRegistry, attachEntityRegistry, getEntityRegistry, } from './scen
 export { setupEditorModeListener, isEditMode } from './scene/EditorMode.js';
 export { setupEditorBridge } from './editor/EditorBridge.js';
 export { EditorOverlayScene, EDITOR_OVERLAY_KEY } from './editor/EditorOverlayScene.js';
-export type { EditorEntityPatch, EditorEnterMessage, EditorExitMessage, EditorGetSceneMessage, EditorApplyEditMessage, EditorSetSelectionMessage, EditorPanZoomMessage, EditorHostToSdkMessage, EditorSceneLoadedMessage, EditorSelectionPickedMessage, EditorDragEndMessage, EditorSdkToHostMessage, } from './protocol.js';
+export type { EditorEntityPatch, EditorEnterMessage, EditorExitMessage, EditorGetSceneMessage, EditorApplyEditMessage, EditorSetSelectionMessage, EditorPanZoomMessage, EditorHostToSdkMessage, EditorSceneLoadedMessage, EditorSelectionPickedMessage, EditorDragEndMessage, EditorShortcutMessage, EditorSdkToHostMessage, } from './protocol.js';
 export { SCHEMA_VERSION, } from './scene/types.js';
 export type { Manifest, SceneRef, HudRef, AssetRecord, AssetKind, SceneType, SceneFile, WorldScene, HudScene, WorldSceneConfig, CameraConfig, WorldEntity, WorldEntityKind, NonGroupWorldEntity, SpriteEntity, PrimitiveEntity, CodeRenderedEntity, GroupEntity, TilemapEntity, TriggerEntity, WorldVisual, SpriteVisual, PrimitiveVisual, PrimitiveRectVisual, PrimitiveCircleVisual, CodeRenderedVisual, Transform, Anchor, AnchorSide, } from './scene/types.js';
 export { PROTOCOL_VERSION, type HelloMessage, type InitMessage, type RpcRequestMessage, type RpcResultOk, type RpcResultError, type HostToSdkMessage, type SdkToHostMessage, type RpcErrorPayload, type RpcMethod, type SavesGetParams, type SavesGetResult, type SavesSetParams, type SavesSetResult, type SavesDeleteParams, type SavesDeleteResult, type SavesListResult, type GameDataGetParams, type GameDataGetResult, type GameDataSetParams, type GameDataSetResult, type GameDataDeleteParams, type GameDataDeleteResult, type GameDataListResult, type RealtimeGetTokenParams, type RealtimeGetTokenResult, } from './protocol.js';

package/dist/protocol.d.ts

@@ -141,7 +141,16 @@ export interface EditorDragEndMessage {
         y: number;
     };
 }
-export type EditorSdkToHostMessage = EditorSceneLoadedMessage | EditorSelectionPickedMessage | EditorDragEndMessage;
+/**
+ * Editor keyboard shortcut intercepted inside the iframe (user clicked the
+ * canvas, so focus is on the iframe and the host window doesn't see the
+ * native keydown). The SDK forwards a small allowlist back to the host.
+ */
+export interface EditorShortcutMessage {
+    type: 'unboxy:editor:shortcut';
+    action: 'undo' | 'redo' | 'save';
+}
+export type EditorSdkToHostMessage = EditorSceneLoadedMessage | EditorSelectionPickedMessage | EditorDragEndMessage | EditorShortcutMessage;
 export type RpcMethod = 'saves.get' | 'saves.set' | 'saves.delete' | 'saves.list' | 'gameData.get' | 'gameData.set' | 'gameData.delete' | 'gameData.list' | 'realtime.getToken';
 export interface SavesGetParams {
     key: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboxy/phaser-sdk",
-  "version": "0.2.19",
+  "version": "0.2.20",
   "description": "Unboxy Phaser 3 SDK — game infrastructure for the Unboxy platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",