handler-playable-sdk 0.3.2 → 0.3.4

package/dist/index.d.ts

@@ -1,5 +1,15 @@
-import { O as ObjectCentricConfig } from './loader-object-centric-C1QteFfG.js';
-export { g as applyDefaults, c as loadAllObjectConfigs, a as loadComponentSchemas, d as loadEngineConfig, e as loadGamePromptConfig, l as loadObjectCentricConfig, b as loadObjectConfig, f as loadSceneConfig, t as toLegacyFormat, v as validateObjectConfig } from './loader-object-centric-C1QteFfG.js';
+import { Graphics } from 'pixi.js';
+import { O as ObjectCentricConfig } from './loader-object-centric-Ce6MVkQw.js';
+export { g as applyDefaults, c as loadAllObjectConfigs, a as loadComponentSchemas, d as loadEngineConfig, e as loadGamePromptConfig, l as loadObjectCentricConfig, b as loadObjectConfig, f as loadSceneConfig, t as toLegacyFormat, v as validateObjectConfig } from './loader-object-centric-Ce6MVkQw.js';
+
+type TelemetryConfig = {
+    endpoint: string;
+    transport?: 'beacon' | 'fetch';
+    batchSize?: number;
+    flushIntervalMs?: number;
+    maxQueue?: number;
+    debug?: boolean;
+};
 
 declare global {
     interface Window {
@@ -155,42 +165,394 @@ declare class PreviewShell {
 }
 declare function createPreviewShell(options?: PreviewOptions): PreviewShell;
 
-declare class DebugPanel {
-    private debugOverlay;
-    private isDebugOpen;
+type SceneObjectsPanelOptions = {
+    onSelect: (objectId: string) => void;
+};
+declare class SceneObjectsPanel {
+    private root;
+    private listContainer;
+    private searchInput;
+    private selectedId;
+    private options;
+    private retryTimer;
+    private filterMode;
+    render(): string;
+    initialize(container: HTMLElement, options: SceneObjectsPanelOptions): void;
+    setSelected(objectId: string | null): void;
+    refreshObjects(): void;
+    /**
+     * Format display name: removes json. prefix, converts underscores to spaces, title case
+     */
+    private formatDisplayName;
+    /**
+     * Get object type for icon display
+     */
+    private getObjectType;
+    private renderGroup;
+    private getTypeIconByType;
+    private getTypeIcon;
+    private getAssetPreview;
+    private getColorIndicator;
+    private getMetadata;
+    private scheduleRetry;
+    private select;
+}
+
+type SceneToolsPanelOptions = {
+    onHighlightObject: (enabled: boolean) => void;
+    onHighlightAnchor: (enabled: boolean) => void;
+    onNudge: (dx: number, dy: number) => void;
+    onShowSplash?: () => void;
+    onUpdateSplash?: (patch: Record<string, any>) => void;
+};
+declare class SceneToolsPanel {
+    private root;
+    private infoEls;
+    private options;
+    render(): string;
+    initialize(container: HTMLElement, options: SceneToolsPanelOptions): void;
+    getNudgeStep(): number;
+    updateInfo(info: {
+        instanceId: string;
+        worldX: number;
+        worldY: number;
+        anchorX: number | null;
+        anchorY: number | null;
+    } | null): void;
+}
+
+type LibraryPanelOptions = {
+    onApply: (objectId: string, assetPath: string, category: string) => Promise<void>;
+    onReset: (objectId: string, defaultAsset: string, category: string) => Promise<void>;
+};
+declare class LibraryPanel {
+    private root;
+    private slotsContainer;
+    private options;
+    private registry;
+    private expandedSlot;
+    private mergeRegistries;
+    /**
+     * Render the library panel HTML template (called by DebugPanel)
+     */
+    render(): string;
+    initialize(container: HTMLElement, options: LibraryPanelOptions): void;
+    /**
+     * Re-renders the slots using the current in-memory registry.
+     * Useful when registry is updated locally (e.g. after conversion)
+     */
+    reRender(): void;
+    refresh(): Promise<void>;
+    private loadAssetRegistry;
+    private renderSlots;
+    private createSlotElement;
+    private createLibraryElement;
+    private fetchFolderAssets;
+    private handleApply;
+    private handleReset;
+    private formatCategoryName;
+    /**
+     * Handle AI Edit for existing asset
+     */
+    private handleAIEdit;
+    /**
+     * Handle Create with AI (new asset from scratch)
+     */
+    private handleCreateWithAI;
+    /**
+     * Highlights and scrolls to a specific slot
+     */
+    highlightSlot(objectId: string, category?: string): void;
+}
+
+type InspectorPanelOptions = {
+    onPropertyChange?: (objectId: string, path: string, value: any) => void;
+};
+declare class InspectorPanel {
+    private root;
+    private contentContainer;
     private selectedObjectId;
-    private configViewer;
+    private options;
+    private showAdvanced;
+    private rendererRegistry;
+    private updateManager;
+    private quickActions;
+    constructor();
+    render(): string;
+    initialize(container: HTMLElement, options: InspectorPanelOptions): void;
+    loadObject(objectId: string): void;
+    private renderProperties;
+    private renderConversionButtons;
+    private renderFooter;
+    private renderSection;
+    private attachEventListeners;
+    private addComponent;
+    private isSectionMeaningful;
+    private showError;
+    private formatLabel;
+    private getSectionIcon;
+    clear(): void;
+}
+
+/**
+ * Brand Vision Mapper Panel
+ *
+ * Three-tab UI for importing brand assets and mapping them to game objects:
+ * - Tab 1: Upload manifest + assets + flat design
+ * - Tab 2: Review AI-generated mappings (APPLY / GENERATE / KEEP)
+ * - Tab 3: Generation progress + Apply all
+ *
+ * Pipeline logic is handled by brandVisionPipeline.ts
+ * Prompts are defined in brandVisionPrompts.ts
+ */
+
+declare class BrandVisionPanel {
+    private root;
+    private currentTab;
+    private onClose?;
+    private uploadMethod;
+    private uploadedJsons;
+    private normalizedManifest;
+    private flatDesignDataUrl;
+    private assetFiles;
+    private zipFile;
+    private mappingResult;
+    private analysisRawResponse;
+    private analysisParsedOk;
+    private analysisParseError;
+    private isAnalyzing;
+    private isGenerating;
+    private get manifest();
+    render(): string;
+    initialize(container: HTMLElement, onClose?: () => void): void;
+    private attachEventListeners;
+    private switchTab;
+    private switchUploadMethod;
+    private handleZipUpload;
+    private processZipFile;
+    private fileToDataUrl;
+    private blobToDataUrl;
+    private inferAssetCategory;
+    private addAssetsToRegistry;
+    private refreshLibrary;
+    private handleManifestUpload;
+    private handleAssetsUpload;
+    private handleFlatDesignUpload;
+    private runAnalysis;
+    private generateAllMissing;
+    private renderMappings;
+    private applyAll;
+    private getEngineAssets;
+    private getPreviewValueForMapping;
+    private stageOverridesFromMappings;
+    private applyOne;
+    private saveAndApplyOne;
+    private openEditorForOne;
+    private generateOne;
+    private stageEngineAssetOverride;
+    private saveToLibraryAndReturnPath;
+    private inferCategoryFromAssetKey;
+    private copyRawAnalysis;
+    private setStatus;
+    private getGameObjects;
+    private getGamePrompt;
+    private setupResizeHandle;
+    refresh(): void;
+}
+
+type CustomizeSettingsPanelOptions = {
+    onApply: (payload: {
+        assets: Record<string, string>;
+        runtime: {
+            theme: Record<string, string>;
+            ui: Record<string, string>;
+            fonts: Record<string, string>;
+            audio: Record<string, string | number>;
+        };
+    }, options?: {
+        source?: 'manual' | 'auto';
+    }) => void;
+};
+declare class CustomizeSettingsPanel {
+    private root;
+    private assetsContainer;
+    private colorsContainer;
+    private fontsContainer;
+    private textsContainer;
+    private audioContainer;
+    private options;
+    private previewModal;
+    private autoApplyTimer;
+    private activePreviewKey;
+    private activePreviewValue;
+    private activePreviewFileInput;
+    private retryTimer;
+    private aiModal;
+    private aiTargetKey;
+    private aiKeyInput;
+    private aiPromptInput;
+    private aiStrengthInput;
+    private aiStrengthValue;
+    private aiModelSelect;
+    private aiModalSubtitle;
+    private aiGalleryToggle;
+    private aiGalleryEl;
+    private aiGalleryGrid;
+    private aiReferenceInput;
+    private aiReferenceName;
+    private aiReferenceFile;
+    private aiRemoveBgToggle;
+    private aiUseOutputToggle;
+    private aiGenerateBtn;
+    private aiApplyBtn;
+    private aiSaveLibraryBtn;
+    private aiCropBtn;
+    private aiDownloadBtn;
+    private aiPreviewImg;
+    private aiStatusEl;
+    private aiOutputDataUrl;
+    private aiBaseDataUrl;
+    private aiBaseValue;
+    private aiOutputKey;
+    private aiContext;
+    private aiBgToleranceInput;
+    private aiBgToleranceValue;
+    private aiRawOutputDataUrl;
+    private aiLoadingEl;
+    render(): string;
+    initialize(container: HTMLElement, options: CustomizeSettingsPanelOptions): void;
+    private setupRenderModeHandlers;
+    private applyEndgamePngMode;
+    private applySplashPngMode;
+    openAiEditor(assetKey: string, prompt?: string, initialValue?: string, context?: {
+        objectId?: string;
+        path?: string;
+    }): void;
+    refresh(): void;
+    private getEngineSnapshot;
+    private renderAssets;
+    private renderColors;
+    private renderFonts;
+    private renderTexts;
+    private renderAudio;
+    private readUiValue;
+    private getObjectTextValue;
+    private getObjectPropertyValue;
+    private handleApply;
+    private handleApplyWithSource;
+    private setupAiPanel;
+    private setAiStatus;
+    private getSelectedAssetKey;
+    private getSelectedAssetInput;
+    private getImageDataFromAsset;
+    private updateAiBasePreview;
+    private updateAiPreview;
+    private updateAiModalPreview;
+    private setAiLoading;
+    private toggleAiGallery;
+    private renderAiGallery;
+    private getAiGalleryEntries;
+    private isAiGalleryImage;
+    private selectAiGalleryAsset;
+    private openAiModal;
+    private closeAiModal;
+    private handleAiGenerate;
+    private refreshAiOutputFromRaw;
+    private setAiOutput;
+    private setAiOutputButtonsEnabled;
+    private handleAiApply;
+    private handleAiSaveToLibrary;
+    private inferCategoryFromAssetKey;
+    private inferObjectIdFromAssetKey;
+    private inferPathFromAssetKey;
+    private getFilenameFromPath;
+    private handleAiCrop;
+    private handleAiDownload;
+    private handleAssetValueChange;
+    private handleAssetUpload;
+    private scheduleAutoApply;
+    private previewAsset;
+    private resolveAssetUrls;
+    private guessMimeType;
+    private openPreviewModal;
+    private loadWithFallback;
+    private fetchWithFallback;
+    private applyObjectPropertyValue;
+    private applyTextColorToObject;
+    private closePreviewModal;
+    private updatePreviewIfOpen;
+    private scheduleRetry;
+    private clearRetry;
+    private setupResizeHandle;
+    private getImageDimensions;
+    private loadImage;
+    private showManualCropModal;
+    private loadImageForValue;
+}
+
+type WorkbenchTab = 'hierarchy' | 'inspector' | 'library' | 'ai' | 'changes';
+/**
+ * DebugPanel context interface - used to pass 'this' context to modular functions
+ */
+interface DebugPanelContext {
+    container: HTMLElement | null;
+    debugOverlay: HTMLElement | null;
+    configViewer: HTMLElement | null;
+    isDebugOpen: boolean;
+    selectedObjectId: string | null;
+    activeTab: WorkbenchTab;
+    highlightObject: boolean;
+    highlightAnchor: boolean;
+    objectAutoApplyTimer: number | null;
+    objectDebugRaf: number | null;
+    objectBoundsGfx: Graphics | null;
+    objectAnchorGfx: Graphics | null;
+    sceneObjectsPanel: SceneObjectsPanel;
+    sceneToolsPanel: SceneToolsPanel;
+    inspectorPanel: InspectorPanel;
+    libraryPanel: LibraryPanel;
+    brandVisionPanel: BrandVisionPanel;
+    customizeSettingsPanel: CustomizeSettingsPanel;
+}
+
+declare class ConfigPersistencePanel {
     private container;
-    private objectAutoApplyTimer;
-    private objectDebugRaf;
-    private objectBoundsGfx;
-    private objectAnchorGfx;
-    private highlightObject;
-    private highlightAnchor;
-    private sceneObjectsPanel;
-    private sceneEditPanel;
-    private sceneToolsPanel;
-    private customizeSettingsPanel;
-    private libraryPanel;
-    private batchAiPanel;
-    private brandDnaPanel;
-    private activeTab;
     initialize(container: HTMLElement): void;
-    selectObject(objectId: string): void;
-    getDebugOverlayHTML(): string;
-    setupDebugEventListeners(): void;
-    private updateWorkbenchTabs;
-    toggleDebug(force?: boolean): void;
+    render(): string;
+    private formatValue;
+    setupEventListeners(): void;
+    private showSuccessNotification;
+    refreshPanel(): void;
+}
+
+/**
+ * DebugPanel - Refactored using modular functions
+ * Original methods are now in separate modules under ./debug/
+ */
+declare class DebugPanel implements DebugPanelContext {
+    debugOverlay: HTMLElement | null;
+    isDebugOpen: boolean;
+    selectedObjectId: string | null;
+    configViewer: HTMLElement | null;
+    container: HTMLElement | null;
+    objectAutoApplyTimer: number | null;
+    objectDebugRaf: number | null;
+    objectBoundsGfx: Graphics | null;
+    objectAnchorGfx: Graphics | null;
+    highlightObject: boolean;
+    highlightAnchor: boolean;
+    activeTab: WorkbenchTab;
+    sceneObjectsPanel: SceneObjectsPanel;
+    sceneToolsPanel: SceneToolsPanel;
+    inspectorPanel: InspectorPanel;
+    libraryPanel: LibraryPanel;
+    brandVisionPanel: BrandVisionPanel;
+    customizeSettingsPanel: CustomizeSettingsPanel;
+    configPersistencePanel: ConfigPersistencePanel;
     private applyAssetChange;
     private resetAsset;
-    updateDebugBadge(): void;
-    private setupDebugInputListeners;
-    private setupPanelLayout;
-    private saveWorkbenchState;
-    private loadWorkbenchState;
-    private setupCollapsiblePanels;
-    private handleObjectSelect;
-    private nudgeSelectedObject;
+    private applySlotAsset;
+    private resetSlotAsset;
     private startObjectVisuals;
     private stopObjectVisuals;
     private shouldRunObjectVisuals;
@@ -208,10 +570,6 @@ declare class DebugPanel {
     private clearAnchor;
     private clearObjectVisuals;
     private updateObjectInfo;
-    private scheduleObjectAutoApply;
-    private setupRangeInput;
-    private getNestedValue;
-    private setNestedValue;
     private resetDebugConfig;
     private applyDebugConfig;
     private exportDebugConfig;
@@ -220,7 +578,24 @@ declare class DebugPanel {
     private copyConfigValues;
     private applyObjectConfig;
     private applyCustomizeSettings;
-    private shouldUseOffsetPosition;
+    private scheduleObjectAutoApply;
+    setupDebugEventListeners(): void;
+    private setupDebugInputListeners;
+    private setupPanelLayout;
+    private setupCollapsiblePanels;
+    private setupRangeInput;
+    private updateWorkbenchTabs;
+    private saveWorkbenchState;
+    private loadWorkbenchState;
+    initialize(container: HTMLElement): void;
+    selectObject(objectId: string): void;
+    private highlightChangesTab;
+    getDebugOverlayHTML(): string;
+    refresh(): void;
+    toggleDebug(force?: boolean): void;
+    updateDebugBadge(): void;
+    private handleObjectSelect;
+    private nudgeSelectedObject;
 }
 
 /**
@@ -334,6 +709,7 @@ declare function setupHotReload(deps: HotReloadDependencies): void;
  */
 interface ConfigOverride {
     objectId?: string;
+    sceneId?: string;
     path: string;
     value: any;
 }
@@ -348,6 +724,8 @@ interface ConfigOverrideOptions {
     silent?: boolean;
     persist?: boolean;
 }
+declare function getOverrideMode(): boolean;
+declare function setOverrideMode(enabled: boolean): void;
 /**
  * Apply a config override
  */
@@ -360,6 +738,8 @@ declare function applyConfigOverrides(overrides: ConfigOverride[], options?: Con
  * Clear all config overrides
  */
 declare function clearConfigOverrides(): void;
+declare function clearConfigOverridesForObject(objectId: string): void;
+declare function removeConfigOverride(objectId: string | undefined, path: string): void;
 /**
  * Get all active overrides
  */
@@ -373,6 +753,38 @@ declare const configOverrideManager: {
     getChanges(): ConfigChange[];
     clearChanges(): void;
 };
+/**
+ * Deep clone utility for baseline copying
+ */
+declare function deepClone(obj: any): any;
+/**
+ * Export full config snapshots (Safeguard #1)
+ * CRITICAL: Must start from loader-resolved baseline, never from scratch
+ * Must output full object trees, never just changed keys
+ */
+declare function exportConfigsAsJSON(): Record<string, any>;
+/**
+ * Get summary of config state (for UI display)
+ */
+declare function getConfigStateSummary(): {
+    modifiedObjects: string[];
+    overrideCount: number;
+    hasChanges: boolean;
+    overrides: ConfigOverride[];
+};
+/**
+ * Apply configs to disk (Safeguard #2)
+ * CRITICAL: Clear cache ONLY after successful API response
+ */
+declare function applyConfigsToDisk(): Promise<void>;
+/**
+ * Reset to applied state (clear cache, reload)
+ */
+declare function resetToApplied(): void;
+/**
+ * Reset to original configs (restore from backup)
+ */
+declare function resetToOriginal(): Promise<void>;
 
 /**
  * Base Layer - Lottie Instance
@@ -408,6 +820,23 @@ type InitOptions = {
     profile?: 'web_embed' | 'mraid' | string;
     consent?: Consent;
     destinationUrl?: string;
+    telemetry?: TelemetryConfig;
+};
+type Envelope = {
+    event_name: string;
+    ts: number;
+    session_id: string;
+    deployment_id: string;
+    variant_id: string;
+    export_profile_id: string;
+    instance_id: string;
+    env: 'web' | 'mraid' | 'native';
+    attribution?: {
+        campaign_id?: string;
+        placement_id?: string;
+        experiment_id?: string;
+    };
+    payload?: any;
 };
 declare const Handler: {
     init(options?: InitOptions, callback?: (w: number, h: number) => void): void;
@@ -428,10 +857,36 @@ declare const Handler: {
     finish(): void;
     install(url?: string): void;
     emit(name: string, payload?: any): void;
+    gameStart(): void;
+    gameEnd(): void;
+    ctaClick(url?: string, options?: {
+        open?: boolean;
+    }): void;
+    ctaShow(meta?: any): void;
+    ctaDismiss(meta?: any): void;
+    getGameTimeMs(): number | null;
+    endSession(reason?: "complete" | "cta" | "manual"): void;
+    setAttribution(attribution?: Envelope["attribution"]): void;
+    abTest(experimentId: string, variants: string[]): string;
+    levelStart(levelId: string | number, meta?: any): void;
+    levelComplete(levelId: string | number, meta?: any): void;
+    levelFail(levelId: string | number, meta?: any): void;
+    checkpoint(checkpointId: string | number, meta?: any): void;
+    reward(rewardId: string, meta?: any): void;
+    tutorialStart(stepId?: string | number, meta?: any): void;
+    tutorialComplete(stepId?: string | number, meta?: any): void;
+    tutorialSkip(stepId?: string | number, meta?: any): void;
+    timerStart(key: string): void;
+    timerEnd(key: string, eventName?: "load_time" | "level_time" | "custom", meta?: any): void;
+    fps(value: number, meta?: any): void;
+    memory(bytes: number, meta?: any): void;
+    assetLoadStart(assetId: string, meta?: any): void;
+    assetLoadComplete(assetId: string, meta?: any): void;
+    reportError(code: string, message: string, meta?: any): void;
     retry(): void;
     pause(): void;
     resume(): void;
     resize(width?: number, height?: number): void;
 };
 
-export { 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, type PreviewOptions, PreviewShell, type ReloadStrategy, type SetupLiveEditBridgeOptions, applyConfigOverride, applyConfigOverrides, baseLottie, bootstrap, clearConfigOverrides, configOverrideManager, createPreviewShell, Handler as default, defaultPreset, deviceGroups, devicePresets, diffConfigs, getConfigOverrides, getPresetById, getPresetsByCategory, rehydrateObject, setBootstrapDependencies, setupHotReload, setupLiveEditBridge };
+export { 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, type PreviewOptions, PreviewShell, type ReloadStrategy, type SetupLiveEditBridgeOptions, applyConfigOverride, applyConfigOverrides, applyConfigsToDisk, baseLottie, bootstrap, clearConfigOverrides, clearConfigOverridesForObject, configOverrideManager, createPreviewShell, deepClone, Handler as default, defaultPreset, deviceGroups, devicePresets, diffConfigs, exportConfigsAsJSON, getConfigOverrides, getConfigStateSummary, getOverrideMode, getPresetById, getPresetsByCategory, rehydrateObject, removeConfigOverride, resetToApplied, resetToOriginal, setBootstrapDependencies, setOverrideMode, setupHotReload, setupLiveEditBridge };