handler-playable-sdk 0.5.36 → 0.5.40

package/dist/index.css

@@ -636,13 +636,6 @@
   order: -1;
 }
 
-.scene-tools-title {
-  font-size: 12px;
-  font-weight: var(--font-weight-semibold);
-  color: var(--ui-text);
-  letter-spacing: 0.4px;
-  text-transform: uppercase;
-}
 
 .scene-tools-collapse-btn {
   width: 24px;
@@ -846,6 +839,68 @@
   gap: 8px;
 }
 
+/* Unsaved changes indicator */
+.preview-unsaved-indicator {
+  font-size: 16px;
+  color: var(--ui-accent);
+  animation: preview-star-pulse 2s ease-in-out infinite;
+  display: inline-block;
+  margin-right: 4px;
+  line-height: 1;
+}
+
+@keyframes preview-star-pulse {
+  0%, 100% {
+    opacity: 1;
+    transform: scale(1);
+  }
+  50% {
+    opacity: 0.7;
+    transform: scale(1.1);
+  }
+}
+
+/* Save button in toolbar */
+.preview-save-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 8px 12px;
+  background: linear-gradient(135deg, var(--ui-accent), var(--ui-accent-overlay-3));
+  color: var(--ui-black);
+  border: none;
+  border-radius: 6px;
+  font-size: 11px;
+  font-weight: 700;
+  letter-spacing: 0.02em;
+  cursor: pointer;
+  box-shadow: 0 2px 8px var(--ui-accent-overlay-1);
+  transition: all var(--ui-duration-fast) var(--ui-ease);
+}
+
+.preview-save-btn:hover {
+  transform: translateY(-1px);
+  box-shadow: 0 4px 12px var(--ui-accent-overlay-2);
+}
+
+.preview-save-btn:active {
+  transform: translateY(0);
+}
+
+.preview-save-btn svg {
+  width: 14px;
+  height: 14px;
+  stroke-width: 2.5;
+}
+
+.preview-save-shortcut {
+  font-size: 9px;
+  opacity: 0.7;
+  font-weight: 600;
+  letter-spacing: 0.5px;
+  margin-left: 2px;
+}
+
 .view-toggle {
   display: flex;
   flex-direction: row;
@@ -1053,6 +1108,25 @@
   color: #ff9500;
 }
 
+.scene-object-badge.template {
+  background: rgba(168, 85, 247, 0.18);
+  color: #c084fc;
+}
+
+.scene-templates-toggle {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 12px;
+  color: var(--ui-text-secondary);
+  margin-left: 10px;
+  user-select: none;
+}
+
+.scene-templates-toggle input[type="checkbox"] {
+  accent-color: var(--ui-accent);
+}
+
 .scene-object-group-system {
   border-left: 3px solid #ff9500;
   padding-left: 8px;
@@ -2591,6 +2665,7 @@
   display: none;
 }
 
+
 /* ========== 04-device-frame.css ========== */
 /* 04 Device Frame */
 /* Auto-generated from preview.css */
@@ -5232,6 +5307,166 @@
   word-wrap: break-word;
 }
 
+/* Add Object Menu modals – Screen picker & name prompt (hierarchy + Add) */
+.add-menu-modal-overlay {
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  background-color: var(--ui-overlay-dark-4);
+  z-index: 10002;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.add-menu-modal {
+  background-color: var(--ui-surface);
+  border: 1px solid var(--ui-border);
+  border-radius: 10px;
+  box-shadow: var(--ui-shadow-strong);
+  width: 90%;
+  max-width: 380px;
+  display: flex;
+  flex-direction: column;
+}
+
+.add-menu-modal-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 14px 18px;
+  border-bottom: 1px solid var(--ui-border);
+}
+
+.add-menu-modal-title {
+  margin: 0;
+  color: var(--ui-text);
+  font-size: 15px;
+  font-weight: 600;
+}
+
+.add-menu-modal-close {
+  background: none;
+  border: none;
+  color: var(--ui-muted);
+  font-size: 20px;
+  line-height: 1;
+  padding: 0;
+  width: 28px;
+  height: 28px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 6px;
+  cursor: pointer;
+  transition: color 0.15s var(--ui-ease), background 0.15s var(--ui-ease);
+}
+
+.add-menu-modal-close:hover {
+  color: var(--ui-text);
+  background: var(--ui-accent-overlay-1);
+}
+
+.add-menu-modal-body {
+  padding: 18px;
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+
+.add-menu-modal-label {
+  display: block;
+  color: var(--ui-text);
+  font-size: 13px;
+  font-weight: 500;
+  margin-bottom: 2px;
+}
+
+.add-menu-modal-select,
+.add-menu-modal-input {
+  width: 100%;
+  background-color: var(--ui-surface);
+  color: var(--ui-text);
+  border: 1px solid var(--ui-border);
+  border-radius: 6px;
+  padding: 8px 12px;
+  font-size: 13px;
+  transition: border-color var(--ui-duration-fast) var(--ui-ease),
+    box-shadow var(--ui-duration-fast) var(--ui-ease);
+  appearance: none;
+  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 12 12'%3E%3Cpath fill='%23888' d='M6 8L2 4h8z'/%3E%3C/svg%3E");
+  background-repeat: no-repeat;
+  background-position: right 10px center;
+  padding-right: 32px;
+}
+
+.add-menu-modal-input {
+  background-image: none;
+  padding-right: 12px;
+}
+
+.add-menu-modal-select:hover,
+.add-menu-modal-input:hover {
+  border-color: var(--ui-terracotta);
+  background-color: var(--ui-accent-overlay-1);
+}
+
+.add-menu-modal-select:focus,
+.add-menu-modal-input:focus {
+  outline: none;
+  border-color: var(--ui-accent);
+  box-shadow: 0 0 0 2px var(--ui-accent-overlay-1);
+}
+
+.add-menu-modal-hint {
+  font-size: 11px;
+  color: var(--ui-muted);
+  margin-top: 2px;
+}
+
+.add-menu-modal-footer {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 10px;
+  padding: 14px 18px;
+  border-top: 1px solid var(--ui-border);
+}
+
+.add-menu-modal-btn {
+  padding: 8px 16px;
+  border-radius: 6px;
+  font-size: 13px;
+  font-weight: 500;
+  cursor: pointer;
+  transition: all 0.15s var(--ui-ease);
+  border: 1px solid transparent;
+}
+
+.add-menu-modal-btn-secondary {
+  background: var(--ui-surface);
+  color: var(--ui-text);
+  border-color: var(--ui-border);
+}
+
+.add-menu-modal-btn-secondary:hover {
+  background: var(--ui-surface-2);
+  border-color: var(--ui-accent);
+}
+
+.add-menu-modal-btn-primary {
+  background: var(--ui-accent);
+  color: var(--ui-text-white);
+  border-color: var(--ui-accent);
+}
+
+.add-menu-modal-btn-primary:hover {
+  background: var(--ui-terracotta-hover);
+  border-color: var(--ui-terracotta-hover);
+}
+
 /* ========== 11-wizard.css ========== */
 /* Wizard Modal Overlay */
 .wizard-modal {

package/dist/index.d.cts

@@ -115,6 +115,8 @@ declare class PreviewShell {
     private gameReady;
     private resizeListenersDisabled;
     private compareSnapshotTimer;
+    private hasUnsavedChanges;
+    private getShortcutKey;
     constructor(options?: PreviewOptions);
     mount(target?: HTMLElement): void;
     destroy(): void;
@@ -152,6 +154,8 @@ declare class PreviewShell {
     private setupSpaceKeyListener;
     private isInputFocused;
     private setupShortcutListeners;
+    private setupUnsavedChangesIndicator;
+    private updateUnsavedChangesIndicator;
     private updateDragCursor;
     private onFrameDragMove;
     private onFrameDragEnd;
@@ -181,20 +185,28 @@ declare function createPreviewShell(options?: PreviewOptions): PreviewShell;
 
 type SceneObjectsPanelOptions = {
     onSelect: (objectId: string) => void;
+    onMultiSelect?: (objectIds: string[]) => void;
 };
 declare class SceneObjectsPanel {
     private root;
     private listContainer;
     private searchInput;
     private selectedId;
+    private selectedIds;
+    private lastSelectedIndex;
+    private objectEntries;
     private options;
     private retryTimer;
     private screenFilter;
+    private showTemplates;
     private isContextMenuOpen;
     private getScreenFilterStorageKey;
+    private getShowTemplatesStorageKey;
     render(): string;
     initialize(container: HTMLElement, options: SceneObjectsPanelOptions): void;
     setSelected(objectId: string | null): void;
+    getSelectedIds(): string[];
+    private updateSelectionUI;
     refreshObjects(): void;
     /**
      * Format display name: removes json. prefix, converts underscores to spaces, title case
@@ -214,6 +226,9 @@ declare class SceneObjectsPanel {
     private getMetadata;
     private scheduleRetry;
     private select;
+    private toggleSelect;
+    private selectRange;
+    private updateLastSelectedIndex;
     private getDefaultScreenForCreate;
     private openAddObjectMenu;
     /**
@@ -222,7 +237,10 @@ declare class SceneObjectsPanel {
     private openAddObjectWizard;
     private showContextMenu;
     private deleteObject;
+    private deleteMultipleObjects;
     private deleteSystemGroup;
+    private moveObject;
+    private moveMultipleObjects;
     private syncScreens;
 }
 
@@ -685,7 +703,7 @@ declare class DebugPanel implements DebugPanelContext {
     toggleDebug(force?: boolean): void;
     updateDebugBadge(): void;
     private handleObjectSelect;
-    nudgeSelectedObject(dx: number, dy: number): void;
+    nudgeSelectedObject(dx: number, dy: number): Promise<void>;
 }
 
 /**
@@ -809,6 +827,8 @@ interface ConfigChange {
     oldValue: any;
     newValue: any;
     ts: number;
+    changeType?: 'property' | 'object_create' | 'object_delete';
+    metadata?: any;
 }
 interface ConfigOverrideOptions {
     silent?: boolean;
@@ -855,6 +875,14 @@ declare function undoLastConfigChange(): boolean;
  * Returns true if redo was successful, false if no changes to redo
  */
 declare function redoLastConfigChange(): boolean;
+/**
+ * Track object creation in undo history
+ */
+declare function trackObjectCreation(objectId: string, screenId: string, objectConfig: any): void;
+/**
+ * Track object deletion in undo history
+ */
+declare function trackObjectDeletion(objectId: string, screenId: string, objectConfig: any): void;
 /**
  * Deep clone utility for baseline copying
  */
@@ -1031,4 +1059,4 @@ declare const Handler: {
     resize(width?: number, height?: number): void;
 };
 
-export { COLORS, type ConfigChange, type ConfigChangeEvent, type ConfigOverride, type ConfigOverrideOptions, ConfigWatcher, DebugPanel, DefaultReloadStrategy, type DeviceCategory, type DeviceGroup, type DevicePreset, Handler, type HotReloadDependencies, type HotReloadWatcher, type LiveEditBridge, ObjectCentricConfig, PlayableLoadingScreen, type PreviewOptions, PreviewShell, type ReloadStrategy, STROKE_WIDTH, type SetupLiveEditBridgeOptions, THEME, applyConfigOverride, applyConfigOverrides, applyConfigsToDisk, baseLottie, bootstrap, clearConfigOverrides, clearConfigOverridesForObject, configOverrideManager, createPreviewShell, deepClone, Handler as default, defaultPreset, deviceGroups, devicePresets, diffConfigs, exportConfigsAsJSON, getConfigOverrides, getConfigStateSummary, getOverrideMode, getPresetById, getPresetsByCategory, redoLastConfigChange, rehydrateObject, removeConfigOverride, resetToApplied, resetToOriginal, setBootstrapDependencies, setOverrideMode, setupHotReload, setupLiveEditBridge, undoLastConfigChange };
+export { COLORS, type ConfigChange, type ConfigChangeEvent, type ConfigOverride, type ConfigOverrideOptions, ConfigWatcher, DebugPanel, DefaultReloadStrategy, type DeviceCategory, type DeviceGroup, type DevicePreset, Handler, type HotReloadDependencies, type HotReloadWatcher, type LiveEditBridge, ObjectCentricConfig, PlayableLoadingScreen, type PreviewOptions, PreviewShell, type ReloadStrategy, STROKE_WIDTH, type SetupLiveEditBridgeOptions, THEME, applyConfigOverride, applyConfigOverrides, applyConfigsToDisk, baseLottie, bootstrap, clearConfigOverrides, clearConfigOverridesForObject, configOverrideManager, createPreviewShell, deepClone, Handler as default, defaultPreset, deviceGroups, devicePresets, diffConfigs, exportConfigsAsJSON, getConfigOverrides, getConfigStateSummary, getOverrideMode, getPresetById, getPresetsByCategory, redoLastConfigChange, rehydrateObject, removeConfigOverride, resetToApplied, resetToOriginal, setBootstrapDependencies, setOverrideMode, setupHotReload, setupLiveEditBridge, trackObjectCreation, trackObjectDeletion, undoLastConfigChange };

package/dist/index.d.ts

@@ -115,6 +115,8 @@ declare class PreviewShell {
     private gameReady;
     private resizeListenersDisabled;
     private compareSnapshotTimer;
+    private hasUnsavedChanges;
+    private getShortcutKey;
     constructor(options?: PreviewOptions);
     mount(target?: HTMLElement): void;
     destroy(): void;
@@ -152,6 +154,8 @@ declare class PreviewShell {
     private setupSpaceKeyListener;
     private isInputFocused;
     private setupShortcutListeners;
+    private setupUnsavedChangesIndicator;
+    private updateUnsavedChangesIndicator;
     private updateDragCursor;
     private onFrameDragMove;
     private onFrameDragEnd;
@@ -181,20 +185,28 @@ declare function createPreviewShell(options?: PreviewOptions): PreviewShell;
 
 type SceneObjectsPanelOptions = {
     onSelect: (objectId: string) => void;
+    onMultiSelect?: (objectIds: string[]) => void;
 };
 declare class SceneObjectsPanel {
     private root;
     private listContainer;
     private searchInput;
     private selectedId;
+    private selectedIds;
+    private lastSelectedIndex;
+    private objectEntries;
     private options;
     private retryTimer;
     private screenFilter;
+    private showTemplates;
     private isContextMenuOpen;
     private getScreenFilterStorageKey;
+    private getShowTemplatesStorageKey;
     render(): string;
     initialize(container: HTMLElement, options: SceneObjectsPanelOptions): void;
     setSelected(objectId: string | null): void;
+    getSelectedIds(): string[];
+    private updateSelectionUI;
     refreshObjects(): void;
     /**
      * Format display name: removes json. prefix, converts underscores to spaces, title case
@@ -214,6 +226,9 @@ declare class SceneObjectsPanel {
     private getMetadata;
     private scheduleRetry;
     private select;
+    private toggleSelect;
+    private selectRange;
+    private updateLastSelectedIndex;
     private getDefaultScreenForCreate;
     private openAddObjectMenu;
     /**
@@ -222,7 +237,10 @@ declare class SceneObjectsPanel {
     private openAddObjectWizard;
     private showContextMenu;
     private deleteObject;
+    private deleteMultipleObjects;
     private deleteSystemGroup;
+    private moveObject;
+    private moveMultipleObjects;
     private syncScreens;
 }
 
@@ -685,7 +703,7 @@ declare class DebugPanel implements DebugPanelContext {
     toggleDebug(force?: boolean): void;
     updateDebugBadge(): void;
     private handleObjectSelect;
-    nudgeSelectedObject(dx: number, dy: number): void;
+    nudgeSelectedObject(dx: number, dy: number): Promise<void>;
 }
 
 /**
@@ -809,6 +827,8 @@ interface ConfigChange {
     oldValue: any;
     newValue: any;
     ts: number;
+    changeType?: 'property' | 'object_create' | 'object_delete';
+    metadata?: any;
 }
 interface ConfigOverrideOptions {
     silent?: boolean;
@@ -855,6 +875,14 @@ declare function undoLastConfigChange(): boolean;
  * Returns true if redo was successful, false if no changes to redo
  */
 declare function redoLastConfigChange(): boolean;
+/**
+ * Track object creation in undo history
+ */
+declare function trackObjectCreation(objectId: string, screenId: string, objectConfig: any): void;
+/**
+ * Track object deletion in undo history
+ */
+declare function trackObjectDeletion(objectId: string, screenId: string, objectConfig: any): void;
 /**
  * Deep clone utility for baseline copying
  */
@@ -1031,4 +1059,4 @@ declare const Handler: {
     resize(width?: number, height?: number): void;
 };
 
-export { COLORS, type ConfigChange, type ConfigChangeEvent, type ConfigOverride, type ConfigOverrideOptions, ConfigWatcher, DebugPanel, DefaultReloadStrategy, type DeviceCategory, type DeviceGroup, type DevicePreset, Handler, type HotReloadDependencies, type HotReloadWatcher, type LiveEditBridge, ObjectCentricConfig, PlayableLoadingScreen, type PreviewOptions, PreviewShell, type ReloadStrategy, STROKE_WIDTH, type SetupLiveEditBridgeOptions, THEME, applyConfigOverride, applyConfigOverrides, applyConfigsToDisk, baseLottie, bootstrap, clearConfigOverrides, clearConfigOverridesForObject, configOverrideManager, createPreviewShell, deepClone, Handler as default, defaultPreset, deviceGroups, devicePresets, diffConfigs, exportConfigsAsJSON, getConfigOverrides, getConfigStateSummary, getOverrideMode, getPresetById, getPresetsByCategory, redoLastConfigChange, rehydrateObject, removeConfigOverride, resetToApplied, resetToOriginal, setBootstrapDependencies, setOverrideMode, setupHotReload, setupLiveEditBridge, undoLastConfigChange };
+export { COLORS, type ConfigChange, type ConfigChangeEvent, type ConfigOverride, type ConfigOverrideOptions, ConfigWatcher, DebugPanel, DefaultReloadStrategy, type DeviceCategory, type DeviceGroup, type DevicePreset, Handler, type HotReloadDependencies, type HotReloadWatcher, type LiveEditBridge, ObjectCentricConfig, PlayableLoadingScreen, type PreviewOptions, PreviewShell, type ReloadStrategy, STROKE_WIDTH, type SetupLiveEditBridgeOptions, THEME, applyConfigOverride, applyConfigOverrides, applyConfigsToDisk, baseLottie, bootstrap, clearConfigOverrides, clearConfigOverridesForObject, configOverrideManager, createPreviewShell, deepClone, Handler as default, defaultPreset, deviceGroups, devicePresets, diffConfigs, exportConfigsAsJSON, getConfigOverrides, getConfigStateSummary, getOverrideMode, getPresetById, getPresetsByCategory, redoLastConfigChange, rehydrateObject, removeConfigOverride, resetToApplied, resetToOriginal, setBootstrapDependencies, setOverrideMode, setupHotReload, setupLiveEditBridge, trackObjectCreation, trackObjectDeletion, undoLastConfigChange };

package/dist/index.js

@@ -1 +1 @@
-import{E as H,F as I,G as J,H as K,I as L,J as M,K as N,L as O,M as P,N as Q,O as R,P as S,Q as T,R as U,S as V,T as W,U as X,a}from"./chunk-ROFM4I6A.js";import"./chunk-I5OOVR5U.js";import{a as s,b as t,c as u,d as v,e as w,f as x,g as y,h as z,i as A,j as B,k as C,l as D,m as E,n as F,o as G}from"./chunk-NHKCXBUZ.js";import{a as b,b as c,c as d,d as e,e as f,f as g,g as h,h as i,i as j,j as k,k as l,l as m,m as n,n as o,o as p,p as q,q as r}from"./chunk-C4GAOSNW.js";import"./chunk-E6WJCS24.js";import"./chunk-JXBG6UFL.js";export{S as COLORS,D as ConfigWatcher,M as DebugPanel,C as DefaultReloadStrategy,W as Handler,V as PlayableLoadingScreen,N as PreviewShell,T as STROKE_WIDTH,U as THEME,d as applyConfigOverride,e as applyConfigOverrides,p as applyConfigsToDisk,z as applyDefaults,a as baseLottie,R as bootstrap,f as clearConfigOverrides,g as clearConfigOverridesForObject,j as configOverrideManager,O as createPreviewShell,m as deepClone,X as default,J as defaultPreset,I as deviceGroups,H as devicePresets,E as diffConfigs,n as exportConfigsAsJSON,i as getConfigOverrides,o as getConfigStateSummary,b as getOverrideMode,K as getPresetById,L as getPresetsByCategory,u as loadAllObjectConfigs,s as loadComponentSchemas,v as loadEngineConfig,w as loadGamePromptConfig,A as loadObjectCentricConfig,t as loadObjectConfig,x as loadSceneConfig,l as redoLastConfigChange,F as rehydrateObject,h as removeConfigOverride,q as resetToApplied,r as resetToOriginal,Q as setBootstrapDependencies,c as setOverrideMode,G as setupHotReload,P as setupLiveEditBridge,B as toLegacyFormat,k as undoLastConfigChange,y as validateObjectConfig};
+import{E as J,F as K,G as L,H as M,I as N,J as O,K as P,L as Q,M as R,N as S,O as T,P as U,Q as V,R as W,S as X,T as Y,U as Z,a}from"./chunk-WTWSWRFR.js";import"./chunk-I5OOVR5U.js";import{a as u,b as v,c as w,d as x,e as y,f as z,g as A,h as B,i as C,j as D,k as E,l as F,m as G,n as H,o as I}from"./chunk-PW2FGMCO.js";import{a as b,b as c,c as d,d as e,e as f,f as g,g as h,h as i,i as j,j as k,k as l,l as m,m as n,n as o,o as p,p as q,q as r,r as s,s as t}from"./chunk-HVKF2KYL.js";import"./chunk-E6WJCS24.js";import"./chunk-JXBG6UFL.js";export{U as COLORS,F as ConfigWatcher,O as DebugPanel,E as DefaultReloadStrategy,Y as Handler,X as PlayableLoadingScreen,P as PreviewShell,V as STROKE_WIDTH,W as THEME,d as applyConfigOverride,e as applyConfigOverrides,r as applyConfigsToDisk,B as applyDefaults,a as baseLottie,T as bootstrap,f as clearConfigOverrides,g as clearConfigOverridesForObject,j as configOverrideManager,Q as createPreviewShell,o as deepClone,Z as default,L as defaultPreset,K as deviceGroups,J as devicePresets,G as diffConfigs,p as exportConfigsAsJSON,i as getConfigOverrides,q as getConfigStateSummary,b as getOverrideMode,M as getPresetById,N as getPresetsByCategory,w as loadAllObjectConfigs,u as loadComponentSchemas,x as loadEngineConfig,y as loadGamePromptConfig,C as loadObjectCentricConfig,v as loadObjectConfig,z as loadSceneConfig,l as redoLastConfigChange,H as rehydrateObject,h as removeConfigOverride,s as resetToApplied,t as resetToOriginal,S as setBootstrapDependencies,c as setOverrideMode,I as setupHotReload,R as setupLiveEditBridge,D as toLegacyFormat,m as trackObjectCreation,n as trackObjectDeletion,k as undoLastConfigChange,A as validateObjectConfig};