storysplat-viewer 2.3.2 → 2.3.3

package/dist/types/dynamic-viewer/viewerUI.d.ts

@@ -101,6 +101,10 @@ export declare function setJoystickVisible(elements: UIElements, visible: boolea
  * Update joystick thumb position based on touch input
  */
 export declare function updateJoystickPosition(elements: UIElements, active: boolean, dx: number, dy: number, maxRadius: number): void;
+/**
+ * Update look zone visual state based on touch input
+ */
+export declare function updateLookZoneState(elements: UIElements, active: boolean): void;
 /**
  * Show/hide camera mode toggle button (mobile-only, explore mode only)
  */

package/dist/types/editor/GizmoManager.d.ts

@@ -0,0 +1,98 @@
+/**
+ * GizmoManager - PlayCanvas Gizmo wrapper for editor
+ *
+ * Provides translate, rotate, and scale gizmos for 3D object manipulation.
+ * API modeled after BabylonJS GizmoManager for easier migration.
+ */
+import * as pc from 'playcanvas';
+export type GizmoMode = 'translate' | 'rotate' | 'scale' | 'none';
+export interface GizmoManagerConfig {
+    snap?: boolean;
+    snapIncrement?: number;
+    coordSpace?: 'world' | 'local';
+}
+export interface TransformEvent {
+    entity: pc.Entity | null;
+    position?: pc.Vec3;
+    rotation?: pc.Quat;
+    scale?: pc.Vec3;
+}
+export declare class GizmoManager {
+    private app;
+    private camera;
+    private gizmoLayer;
+    private translateGizmo;
+    private rotateGizmo;
+    private scaleGizmo;
+    private activeGizmo;
+    private attachedEntity;
+    private _mode;
+    private onTransformStart?;
+    private onTransformMove?;
+    private onTransformEnd?;
+    constructor(app: pc.Application, camera: pc.CameraComponent, config?: GizmoManagerConfig);
+    private setupEvents;
+    /**
+     * Get current gizmo mode
+     */
+    get mode(): GizmoMode;
+    /**
+     * Set the active gizmo mode
+     */
+    setMode(mode: GizmoMode): void;
+    /**
+     * Attach gizmo to an entity
+     */
+    attach(entity: pc.Entity | null): void;
+    /**
+     * Attach to mesh by finding the parent entity
+     * (Compatibility with BabylonJS pattern)
+     */
+    attachToMesh(mesh: pc.Entity | null): void;
+    /**
+     * Detach gizmo from current entity
+     */
+    detach(): void;
+    /**
+     * Enable/disable position gizmo
+     * (BabylonJS compatibility)
+     */
+    set positionGizmoEnabled(enabled: boolean);
+    get positionGizmoEnabled(): boolean;
+    /**
+     * Enable/disable rotation gizmo
+     * (BabylonJS compatibility)
+     */
+    set rotationGizmoEnabled(enabled: boolean);
+    get rotationGizmoEnabled(): boolean;
+    /**
+     * Enable/disable scale gizmo
+     * (BabylonJS compatibility)
+     */
+    set scaleGizmoEnabled(enabled: boolean);
+    get scaleGizmoEnabled(): boolean;
+    /**
+     * Set snap enabled and increment
+     */
+    setSnap(enabled: boolean, increment?: number): void;
+    /**
+     * Set coordinate space (world or local)
+     */
+    setCoordSpace(space: 'world' | 'local'): void;
+    /**
+     * Set transform event callbacks
+     */
+    onTransform(callbacks: {
+        start?: (event: TransformEvent) => void;
+        move?: (event: TransformEvent) => void;
+        end?: (event: TransformEvent) => void;
+    }): void;
+    /**
+     * Update gizmo (call each frame if needed)
+     */
+    update(): void;
+    /**
+     * Destroy the gizmo manager and clean up resources
+     */
+    destroy(): void;
+}

package/dist/types/editor/SelectionManager.d.ts

@@ -0,0 +1,77 @@
+/**
+ * SelectionManager - PlayCanvas entity selection for editor
+ *
+ * Handles raycasting, selection state, and visual feedback.
+ */
+import * as pc from 'playcanvas';
+export interface SelectionEvent {
+    entity: pc.Entity | null;
+    previousEntity: pc.Entity | null;
+}
+export interface SelectionManagerConfig {
+    highlightColor?: pc.Color;
+    multiSelect?: boolean;
+}
+export declare class SelectionManager {
+    private app;
+    private camera;
+    private picker;
+    private selectedEntities;
+    private highlightedEntity;
+    private config;
+    private originalMaterials;
+    private onSelectionChange?;
+    constructor(app: pc.Application, camera: pc.Entity, config?: SelectionManagerConfig);
+    /**
+     * Pick entity at screen coordinates
+     */
+    pickAtScreenPosition(x: number, y: number): Promise<pc.Entity | null>;
+    /**
+     * Get world point at screen coordinates (for double-click focus)
+     */
+    getWorldPointAtScreen(x: number, y: number): Promise<pc.Vec3 | null>;
+    /**
+     * Select an entity
+     */
+    select(entity: pc.Entity | null, additive?: boolean): void;
+    /**
+     * Deselect a specific entity
+     */
+    deselect(entity: pc.Entity): void;
+    /**
+     * Deselect all entities
+     */
+    deselectAll(): void;
+    /**
+     * Check if an entity is selected
+     */
+    isSelected(entity: pc.Entity): boolean;
+    /**
+     * Get the first selected entity (for single selection mode)
+     */
+    getSelectedEntity(): pc.Entity | null;
+    /**
+     * Get all selected entities
+     */
+    getSelectedEntities(): pc.Entity[];
+    /**
+     * Apply visual highlight to entity
+     */
+    private applyHighlight;
+    /**
+     * Remove visual highlight from entity
+     */
+    private removeHighlight;
+    /**
+     * Set selection change callback
+     */
+    onSelect(callback: (event: SelectionEvent) => void): void;
+    /**
+     * Handle pointer down event for selection
+     */
+    handlePointerDown(event: MouseEvent | TouchEvent, additive?: boolean): Promise<pc.Entity | null>;
+    /**
+     * Destroy the selection manager
+     */
+    destroy(): void;
+}

package/dist/types/editor/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * StorySplat Viewer Editor Extensions
+ *
+ * Provides editing capabilities on top of the base viewer.
+ * Used by the StorySplat editor application.
+ */
+export { GizmoManager } from './GizmoManager';
+export type { GizmoMode, GizmoManagerConfig, TransformEvent } from './GizmoManager';
+export { SelectionManager } from './SelectionManager';
+export type { SelectionEvent, SelectionManagerConfig } from './SelectionManager';

package/dist/types/index.d.ts

@@ -21,3 +21,9 @@ export { transformSceneToExportProps, exportPropsToViewerConfig } from './transf
 export type { ExportProps, TemplateType, SceneData, WaypointData, HotspotData, ViewerInstance, ViewerOptions, ViewerEvent, ViewerFromSceneIdOptions } from './types';
 export type { RevealPreset, RevealPresetConfig } from './effects';
 export { REVEAL_PRESETS, getRevealPreset } from './effects';
+export { GizmoManager } from './editor/GizmoManager';
+export type { GizmoMode, GizmoManagerConfig, TransformEvent } from './editor/GizmoManager';
+export { SelectionManager } from './editor/SelectionManager';
+export type { SelectionEvent, SelectionManagerConfig } from './editor/SelectionManager';
+export { CameraControls } from './dynamic-viewer/CameraControls';
+export type { CameraControlsConfig } from './dynamic-viewer/CameraControls';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "storysplat-viewer",
-  "version": "2.3.2",
+  "version": "2.3.3",
   "description": "PlayCanvas-based 3D viewer for StorySplat scenes - HTML export & dynamic embedding",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",