@dreamcomposer/engine-types 2.1.0 → 2.2.0

package/from-engine/EngineAliveMessage.d.ts

@@ -0,0 +1,11 @@
+import { FromEngineMessage } from "../post-messages";
+
+/**
+ * Sent as the very first thing when the engine page starts, before any of
+ * its scripts are loaded. It only tells the embedder that the engine is
+ * reachable; it is still not allowed to send commands until it receives the
+ * `engine-ready` message.
+ */
+export interface EngineAliveMessage extends FromEngineMessage<"engine-alive"> {
+  payload: true;
+}

package/from-engine/EngineErrorMessage.d.ts

@@ -0,0 +1,16 @@
+import { FromEngineMessage } from "../post-messages";
+
+/**
+ * Sent when the engine fails in a way it cannot recover from on its own.
+ *
+ * `startup` errors happen before `engine-ready` was sent, i.e. the engine will
+ * never become ready. `runtime` errors happen afterwards and leave the engine
+ * unusable, e.g. a lost WebGL context that is not restored.
+ */
+export interface EngineErrorMessage extends FromEngineMessage<"engine-error"> {
+  payload: {
+    phase: "startup" | "runtime";
+    /** A technical description for logs, not meant to be shown to users. */
+    message: string;
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreamcomposer/engine-types",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "The type definitions for messages from and to the engine",
   "license": "UNLICENSED",
   "private": false,

package/post-messages.d.ts

@@ -1,5 +1,7 @@
 import { AckMessage } from "./from-engine/AckMessage";
 import { CanvasImageUrlMessage } from "./from-engine/CanvasImageUrlMessage";
+import { EngineAliveMessage } from "./from-engine/EngineAliveMessage";
+import { EngineErrorMessage } from "./from-engine/EngineErrorMessage";
 import { EngineReadyMessage } from "./from-engine/EngineReadyMessage";
 import { KeyDownMessage } from "./from-engine/KeyDownMessage";
 import { SetLoadingProgressMessage } from "./from-engine/SetLoadingProgressMessage";
@@ -82,6 +84,8 @@ export type FromEnginePostMessage =
   | AckMessage
   | CanvasImageUrlMessage
   | DisplayLoadingUiMessage
+  | EngineAliveMessage
+  | EngineErrorMessage
   | EngineReadyMessage
   | HideGuiMessage
   | HideLoadingUiMessage

package/to-engine/ResetCameraPositionMessage.d.ts

@@ -4,8 +4,12 @@ import { ToEngineMessage } from "../post-messages";
  * Resets the camera to its initial position.
  */
 export interface ResetCameraPositionMessage extends ToEngineMessage<"reset-camera-position"> {
-  /**
-   * An empty object.
-   */
-  payload: Record<string, never>;
+  payload: {
+    /**
+     * When true, the reset additionally restores the camera's default orientation
+     * on top of zoom and shift. Defaults to false (zoom/shift only), which keeps
+     * the current viewing angle.
+     */
+    resetRotation?: boolean;
+  };
 }

package/to-engine/SetInitialGeometryTransformMessage.ts

@@ -4,8 +4,9 @@ import type { ToEngineMessage } from "../post-messages";
 /**
  * Defines the initial geometry rotation and position.
  *
- * The initial transform is used if the transform is reseted.
+ * The initial transform is used if the transform is reseted. Setting it also applies it:
+ * instantly by default, or as a glide of `transitionDuration` seconds.
  */
 export interface SetInitialGeometryTransformMessage extends ToEngineMessage<"set-initial-geometry-transform"> {
-  payload: { transform: GeometryTransform };
+  payload: { transform: GeometryTransform; transitionDuration?: number };
 }