@zylem/game-lib 0.9.1 → 0.9.3

package/dist/api/game-lib.api.json

@@ -679,7 +679,7 @@
               "text": "{\n    readonly FourByThree: number;\n    readonly SixteenByNine: number;\n    readonly NineBySixteen: number;\n    readonly TwentyOneByNine: number;\n    readonly OneByOne: number;\n}"
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "isReadonly": true,
           "releaseTag": "Public",
           "name": "AspectRatio",
@@ -724,7 +724,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "releaseTag": "Public",
           "name": "AspectRatioValue",
           "typeTokenRange": {
@@ -2218,7 +2218,7 @@
               "text": "interface CameraAction "
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "releaseTag": "Public",
           "name": "CameraAction",
           "preserveMemberOrder": false,
@@ -2356,7 +2356,7 @@
               "text": "interface CameraBehavior "
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "releaseTag": "Public",
           "name": "CameraBehavior",
           "preserveMemberOrder": false,
@@ -2584,7 +2584,7 @@
               "text": "interface CameraContext "
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "releaseTag": "Public",
           "name": "CameraContext",
           "preserveMemberOrder": false,
@@ -3028,42 +3028,44 @@
         {
           "kind": "Class",
           "canonicalReference": "@zylem/game-lib!CameraManager:class",
-          "docComment": "/**\n * CameraManager orchestrates multiple cameras per stage.\n *\n * Responsibilities: - Named camera registry (add/remove/get by name or reference) - Active camera list management (determines which cameras render) - Always-available debug camera with orbit controls - Per-frame update of all active cameras' perspective controllers - Coordinating rendering via RendererManager for all active viewports\n */\n",
+          "docComment": "/**\n * CameraManager orchestrates multiple cameras per stage.\n *\n * Responsibilities: - Named camera registry (add/remove/get by name or reference) - Active camera list management (determines which cameras render) - Editor view cameras (side, top, isometric, free), created only while an editor is attached - Per-frame update of all active cameras' perspective controllers - Coordinating rendering via RendererManager for all active viewports\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "declare class CameraManager "
+              "text": "declare class CameraManager implements "
+            },
+            {
+              "kind": "Reference",
+              "text": "EditorCameraHost",
+              "canonicalReference": "@zylem/game-lib!~EditorCameraHost:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "isAbstract": false,
           "name": "CameraManager",
           "preserveMemberOrder": false,
           "members": [
             {
-              "kind": "Constructor",
-              "canonicalReference": "@zylem/game-lib!CameraManager:constructor(1)",
-              "docComment": "/**\n * Constructs a new instance of the `CameraManager` class\n */\n",
+              "kind": "Method",
+              "canonicalReference": "@zylem/game-lib!CameraManager#activateCameraById:member(1)",
+              "docComment": "/**\n * Switch the main view.\n *\n * `game` releases to the remembered game camera. Editor view ids show that view. Any other id activates a game-registered camera and clears the editor override.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "constructor();"
-                }
-              ],
-              "releaseTag": "Public",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": []
-            },
-            {
-              "kind": "Method",
-              "canonicalReference": "@zylem/game-lib!CameraManager#activateDebugCamera:member(1)",
-              "docComment": "/**\n * Switch the primary viewport to the debug orbit camera, remembering the previous primary so gameplay cameras (e.g. first-person) can be restored.\n */\n",
-              "excerptTokens": [
+                  "text": "activateCameraById(id: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
                 {
                   "kind": "Content",
-                  "text": "activateDebugCamera(): "
+                  "text": "): "
                 },
                 {
                   "kind": "Content",
@@ -3076,16 +3078,25 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
+                "startIndex": 3,
+                "endIndex": 4
               },
               "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
-              "parameters": [],
+              "parameters": [
+                {
+                  "parameterName": "id",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
               "isOptional": false,
               "isAbstract": false,
-              "name": "activateDebugCamera"
+              "name": "activateCameraById"
             },
             {
               "kind": "Property",
@@ -3348,16 +3359,16 @@
             },
             {
               "kind": "Method",
-              "canonicalReference": "@zylem/game-lib!CameraManager#deactivateDebugCamera:member(1)",
-              "docComment": "/**\n * Restore the gameplay primary camera that was active before {@link activateDebugCamera}.\n */\n",
+              "canonicalReference": "@zylem/game-lib!CameraManager#destroyEditorCameras:member(1)",
+              "docComment": "/**\n * Restore the game camera when an editor view is showing, then destroy the four editor cameras.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "deactivateDebugCamera(): "
+                  "text": "destroyEditorCameras(): "
                 },
                 {
                   "kind": "Content",
-                  "text": "boolean"
+                  "text": "void"
                 },
                 {
                   "kind": "Content",
@@ -3375,55 +3386,52 @@
               "parameters": [],
               "isOptional": false,
               "isAbstract": false,
-              "name": "deactivateDebugCamera"
+              "name": "destroyEditorCameras"
             },
             {
-              "kind": "Property",
-              "canonicalReference": "@zylem/game-lib!CameraManager#debugCamera:member",
-              "docComment": "/**\n * Get the debug camera.\n */\n",
+              "kind": "Method",
+              "canonicalReference": "@zylem/game-lib!CameraManager#dispose:member(1)",
+              "docComment": "/**\n * Dispose all cameras and cleanup.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "get debugCamera(): "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "ZylemCamera",
-                  "canonicalReference": "@zylem/game-lib!~ZylemCamera:class"
+                  "text": "dispose(): "
                 },
                 {
                   "kind": "Content",
-                  "text": " | null"
+                  "text": "void"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "debugCamera",
-              "propertyTypeTokenRange": {
+              "isStatic": false,
+              "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 3
+                "endIndex": 2
               },
-              "isStatic": false,
+              "releaseTag": "Public",
               "isProtected": false,
-              "isAbstract": false
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "dispose"
             },
             {
               "kind": "Method",
-              "canonicalReference": "@zylem/game-lib!CameraManager#dispose:member(1)",
-              "docComment": "/**\n * Dispose all cameras and cleanup.\n */\n",
+              "canonicalReference": "@zylem/game-lib!CameraManager#ensureDefaultCamera:member(1)",
+              "docComment": "/**\n * Create a default third-person camera if no cameras have been added.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "dispose(): "
+                  "text": "ensureDefaultCamera(): "
                 },
                 {
-                  "kind": "Content",
-                  "text": "void"
+                  "kind": "Reference",
+                  "text": "ZylemCamera",
+                  "canonicalReference": "@zylem/game-lib!~ZylemCamera:class"
                 },
                 {
                   "kind": "Content",
@@ -3441,21 +3449,25 @@
               "parameters": [],
               "isOptional": false,
               "isAbstract": false,
-              "name": "dispose"
+              "name": "ensureDefaultCamera"
             },
             {
               "kind": "Method",
-              "canonicalReference": "@zylem/game-lib!CameraManager#ensureDefaultCamera:member(1)",
-              "docComment": "/**\n * Create a default third-person camera if no cameras have been added.\n */\n",
+              "canonicalReference": "@zylem/game-lib!CameraManager#ensureEditorCameras:member(1)",
+              "docComment": "/**\n * Create side, top, isometric, and free cameras seeded from the current game camera. Does not change which camera is rendering.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "ensureDefaultCamera(): "
+                  "text": "ensureEditorCameras(): "
                 },
                 {
                   "kind": "Reference",
-                  "text": "ZylemCamera",
-                  "canonicalReference": "@zylem/game-lib!~ZylemCamera:class"
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<void>"
                 },
                 {
                   "kind": "Content",
@@ -3465,7 +3477,7 @@
               "isStatic": false,
               "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 2
+                "endIndex": 3
               },
               "releaseTag": "Public",
               "isProtected": false,
@@ -3473,7 +3485,7 @@
               "parameters": [],
               "isOptional": false,
               "isAbstract": false,
-              "name": "ensureDefaultCamera"
+              "name": "ensureEditorCameras"
             },
             {
               "kind": "Method",
@@ -3529,39 +3541,66 @@
               "name": "getCamera"
             },
             {
-              "kind": "Property",
-              "canonicalReference": "@zylem/game-lib!CameraManager#preDebugPrimary:member",
-              "docComment": "/**\n * Gameplay primary camera that was active before debug mode was enabled.\n */\n",
+              "kind": "Method",
+              "canonicalReference": "@zylem/game-lib!CameraManager#hasEditorCameras:member(1)",
+              "docComment": "/**\n * True after the four editor views have been created.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "get preDebugPrimary(): "
+                  "text": "hasEditorCameras(): "
                 },
                 {
-                  "kind": "Reference",
-                  "text": "ZylemCamera",
-                  "canonicalReference": "@zylem/game-lib!~ZylemCamera:class"
+                  "kind": "Content",
+                  "text": "boolean"
                 },
                 {
                   "kind": "Content",
-                  "text": " | null"
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "hasEditorCameras"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@zylem/game-lib!CameraManager#isEditorViewActive:member(1)",
+              "docComment": "/**\n * True while side, top, isometric, or free is the main view.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "isEditorViewActive(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "preDebugPrimary",
-              "propertyTypeTokenRange": {
+              "isStatic": false,
+              "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 3
+                "endIndex": 2
               },
-              "isStatic": false,
+              "releaseTag": "Public",
               "isProtected": false,
-              "isAbstract": false
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "isEditorViewActive"
             },
             {
               "kind": "Property",
@@ -3601,7 +3640,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@zylem/game-lib!CameraManager#removeCamera:member(1)",
-              "docComment": "/**\n * Remove a camera by name or reference. Cannot remove the debug camera via this method.\n */\n",
+              "docComment": "/**\n * Remove a camera by name or reference.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -3703,7 +3742,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@zylem/game-lib!CameraManager#setActiveCamera:member(1)",
-              "docComment": "/**\n * Set a camera as the primary active camera (replaces all active cameras except additional viewport cameras).\n *\n * @param nameOrRef - Camera name or reference to activate\n */\n",
+              "docComment": "/**\n * Set a camera as the primary active camera (replaces all active cameras except additional viewport cameras).\n *\n * While an editor view owns the main view, a game camera is remembered and the rendered camera does not change.\n *\n * @param nameOrRef - Camera name or reference to activate\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -3756,7 +3795,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@zylem/game-lib!CameraManager#setup:member(1)",
-              "docComment": "/**\n * Setup all cameras with the given scene and renderer manager. Also creates the debug camera.\n */\n",
+              "docComment": "/**\n * Setup all cameras with the given scene and renderer manager. Editor view cameras are created here only when an editor is already attached.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -3873,7 +3912,12 @@
               "name": "update"
             }
           ],
-          "implementsTokenRanges": []
+          "implementsTokenRanges": [
+            {
+              "startIndex": 1,
+              "endIndex": 2
+            }
+          ]
         },
         {
           "kind": "Interface",
@@ -3885,7 +3929,7 @@
               "text": "interface CameraOptions "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "name": "CameraOptions",
           "preserveMemberOrder": false,
@@ -4246,7 +4290,7 @@
               "text": "interface CameraPerspective "
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "releaseTag": "Public",
           "name": "CameraPerspective",
           "preserveMemberOrder": false,
@@ -4393,7 +4437,7 @@
               "text": "declare class CameraPipeline "
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "releaseTag": "Public",
           "isAbstract": false,
           "name": "CameraPipeline",
@@ -4885,7 +4929,7 @@
               "text": "interface CameraPipelineState "
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "releaseTag": "Public",
           "name": "CameraPipelineState",
           "preserveMemberOrder": false,
@@ -5048,7 +5092,7 @@
               "text": "interface CameraPose "
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "releaseTag": "Public",
           "name": "CameraPose",
           "preserveMemberOrder": false,
@@ -5306,7 +5350,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "releaseTag": "Public",
           "name": "CameraProjection",
           "typeTokenRange": {
@@ -5582,7 +5626,7 @@
               "text": "declare class CameraWrapper "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "isAbstract": false,
           "name": "CameraWrapper",
@@ -7354,7 +7398,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "returnTypeTokenRange": {
             "startIndex": 3,
             "endIndex": 4
@@ -8017,7 +8061,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "returnTypeTokenRange": {
             "startIndex": 6,
             "endIndex": 8
@@ -8454,7 +8498,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "returnTypeTokenRange": {
             "startIndex": 5,
             "endIndex": 6
@@ -8980,7 +9024,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "returnTypeTokenRange": {
             "startIndex": 3,
             "endIndex": 4
@@ -15938,7 +15982,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "releaseTag": "Public",
           "name": "DeviceProfile",
           "typeTokenRange": {
@@ -20359,7 +20403,7 @@
               "text": "interface FirstPersonOptions "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "name": "FirstPersonOptions",
           "preserveMemberOrder": false,
@@ -20631,7 +20675,7 @@
               "text": " "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "isAbstract": false,
           "name": "FirstPersonPerspective",
@@ -21304,7 +21348,7 @@
               "text": "interface Fixed2DOptions "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "name": "Fixed2DOptions",
           "preserveMemberOrder": false,
@@ -21386,7 +21430,7 @@
               "text": " "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "isAbstract": false,
           "name": "Fixed2DPerspective",
@@ -21580,7 +21624,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@zylem/game-lib!focusEntity:function(1)",
-          "docComment": "/**\n * Select an entity by UUID and frame the debug camera to fit it. Enables debug mode so orbit controls are active.\n *\n * @returns true if the entity was found and framed\n */\n",
+          "docComment": "/**\n * Select an entity by UUID and frame the active editor camera to fit it. When the game camera is showing, the stage switches to the free editor camera first. Enables debug mode so the selection is visible.\n *\n * @returns true if the entity was found and framed\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -21822,7 +21866,7 @@
               "text": " "
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "releaseTag": "Public",
           "typeParameters": [
             {
@@ -23554,6 +23598,54 @@
               "isAbstract": false,
               "name": "onEditorAttached"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@zylem/game-lib!GameBridge#onEditorDetached:member(1)",
+              "docComment": "/**\n * Run a callback when the editor drops both entity subscriptions.\n *\n * Mirrors {@link onEditorAttached}: the first of the pair to unsubscribe is the same editor finishing teardown, so the callback waits until the other type is already at zero.\n *\n * @returns An unsubscribe function.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "onEditorDetached(callback: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "() => void"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "() => void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "callback",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "onEditorDetached"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@zylem/game-lib!GameBridge#publishCatalog:member(1)",
@@ -24803,7 +24895,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "returnTypeTokenRange": {
             "startIndex": 3,
             "endIndex": 4
@@ -27325,7 +27417,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "releaseTag": "Public",
           "name": "GameConfigLike",
           "typeTokenRange": {
@@ -27401,7 +27493,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "releaseTag": "Public",
           "name": "GameDeviceConfig",
           "typeTokenRange": {
@@ -36406,7 +36498,7 @@
               "text": "interface GameLoadingEvent "
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "releaseTag": "Public",
           "name": "GameLoadingEvent",
           "preserveMemberOrder": false,
@@ -36749,7 +36841,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "returnTypeTokenRange": {
             "startIndex": 3,
             "endIndex": 4
@@ -36989,7 +37081,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "returnTypeTokenRange": {
             "startIndex": 5,
             "endIndex": 7
@@ -39739,7 +39831,7 @@
               "text": "interface IsometricOptions "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "name": "IsometricOptions",
           "preserveMemberOrder": false,
@@ -39903,7 +39995,7 @@
               "text": " "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "isAbstract": false,
           "name": "IsometricPerspective",
@@ -40257,7 +40349,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "returnTypeTokenRange": {
             "startIndex": 1,
             "endIndex": 3
@@ -40729,6 +40821,75 @@
           ],
           "name": "lerpVec3"
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@zylem/game-lib!LevelStage:interface",
+          "docComment": "/**\n * The slice of a stage `streamLevelOnStage` needs.\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "interface LevelStage "
+            }
+          ],
+          "fileUrlPath": "dist/core.d.ts",
+          "releaseTag": "Public",
+          "name": "LevelStage",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@zylem/game-lib!LevelStage#spawnEntity:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "spawnEntity(node: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "BaseNode",
+                  "canonicalReference": "@zylem/game-lib!~BaseNode:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<void> | void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "node",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "name": "spawnEntity"
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Variable",
           "canonicalReference": "@zylem/game-lib!LIGHT_TYPE:var",
@@ -43797,7 +43958,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "returnTypeTokenRange": {
             "startIndex": 3,
             "endIndex": 4
@@ -44048,7 +44209,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "name": "PerspectiveOptions",
           "typeTokenRange": {
@@ -44070,7 +44231,7 @@
               "text": "{\n    readonly FirstPerson: \"first-person\";\n    readonly ThirdPerson: \"third-person\";\n    readonly SecondPerson: \"second-person\";\n    readonly Isometric: \"isometric\";\n    readonly Flat2D: \"flat-2d\";\n    readonly Fixed2D: \"fixed-2d\";\n    readonly TopDown: \"top-down\";\n}"
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "isReadonly": true,
           "releaseTag": "Public",
           "name": "Perspectives",
@@ -44115,7 +44276,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "releaseTag": "Public",
           "name": "PerspectiveType",
           "typeTokenRange": {
@@ -45009,7 +45170,7 @@
               "text": "interface PoseDelta "
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "releaseTag": "Public",
           "name": "PoseDelta",
           "preserveMemberOrder": false,
@@ -45655,7 +45816,7 @@
               "text": "declare class RenderBundleManager "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "isAbstract": false,
           "name": "RenderBundleManager",
@@ -46175,7 +46336,7 @@
               "text": "declare class RenderStrategyManager "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "isAbstract": false,
           "name": "RenderStrategyManager",
@@ -46686,7 +46847,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "releaseTag": "Public",
           "name": "ResolutionInput",
           "typeTokenRange": {
@@ -46906,7 +47067,7 @@
               "text": "interface ResolveGameConfigRuntime "
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "releaseTag": "Public",
           "name": "ResolveGameConfigRuntime",
           "preserveMemberOrder": false,
@@ -47171,7 +47332,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "releaseTag": "Public",
           "name": "RetroPreset",
           "typeTokenRange": {
@@ -47202,7 +47363,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "releaseTag": "Public",
           "name": "RetroPresetKey",
           "typeTokenRange": {
@@ -47228,7 +47389,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/game-D8KTP3fD.d.ts",
+          "fileUrlPath": "dist/game-DBNxY6mb.d.ts",
           "releaseTag": "Public",
           "name": "RetroResolution",
           "typeTokenRange": {
@@ -49683,7 +49844,7 @@
               "text": "interface SecondPersonOptions "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "name": "SecondPersonOptions",
           "preserveMemberOrder": false,
@@ -49874,7 +50035,7 @@
               "text": " "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "isAbstract": false,
           "name": "SecondPersonPerspective",
@@ -57724,7 +57885,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "returnTypeTokenRange": {
             "startIndex": 3,
             "endIndex": 4
@@ -58212,7 +58373,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "name": "StageConfigLike",
           "typeTokenRange": {
@@ -59859,7 +60020,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "name": "StageOptions",
           "typeTokenRange": {
@@ -60844,6 +61005,301 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@zylem/game-lib!streamLevel:function(1)",
+          "docComment": "/**\n * Hand each buffer entry to `spawn`, in order, yielding between batches.\n *\n * @returns How many entries were handed off. A spawn that no-ops for an unknown catalog type still counts: the entry was delivered.\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "declare function streamLevel(buffer: "
+            },
+            {
+              "kind": "Reference",
+              "text": "LevelBuffer",
+              "canonicalReference": "@zylem/bridge!LevelBuffer:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", spawn: "
+            },
+            {
+              "kind": "Content",
+              "text": "(entry: "
+            },
+            {
+              "kind": "Reference",
+              "text": "LevelEntry",
+              "canonicalReference": "@zylem/bridge!LevelEntry:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ") => void | "
+            },
+            {
+              "kind": "Reference",
+              "text": "Promise",
+              "canonicalReference": "!Promise:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<void>"
+            },
+            {
+              "kind": "Content",
+              "text": ", options?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "StreamLevelOptions",
+              "canonicalReference": "@zylem/game-lib!StreamLevelOptions:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Promise",
+              "canonicalReference": "!Promise:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "StreamLevelResult",
+              "canonicalReference": "@zylem/game-lib!StreamLevelResult:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "dist/core.d.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 11,
+            "endIndex": 15
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "buffer",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "spawn",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 8
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "options",
+              "parameterTypeTokenRange": {
+                "startIndex": 9,
+                "endIndex": 10
+              },
+              "isOptional": true
+            }
+          ],
+          "name": "streamLevel"
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@zylem/game-lib!streamLevelOnStage:function(1)",
+          "docComment": "/**\n * Spawn every catalog entry in `buffer` onto `stage`.\n *\n * Position is handed to the type's factory. Rotation and scale are applied after spawn, and a scale change rebuilds colliders. An entry whose catalog id is not registered is skipped.\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "declare function streamLevelOnStage(stage: "
+            },
+            {
+              "kind": "Reference",
+              "text": "LevelStage",
+              "canonicalReference": "@zylem/game-lib!LevelStage:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", buffer: "
+            },
+            {
+              "kind": "Reference",
+              "text": "LevelBuffer",
+              "canonicalReference": "@zylem/bridge!LevelBuffer:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", options?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "StreamLevelOptions",
+              "canonicalReference": "@zylem/game-lib!StreamLevelOptions:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Promise",
+              "canonicalReference": "!Promise:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "StreamLevelResult",
+              "canonicalReference": "@zylem/game-lib!StreamLevelResult:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "dist/core.d.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 7,
+            "endIndex": 11
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "stage",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "buffer",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "options",
+              "parameterTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "isOptional": true
+            }
+          ],
+          "name": "streamLevelOnStage"
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@zylem/game-lib!StreamLevelOptions:interface",
+          "docComment": "/**\n * Stream a level buffer into a stage.\n *\n * The streamer does not know the catalog. `spawn` is the host's existing create path, which resolves a catalog id and no-ops when the type is unknown. Entries are handed off in batches, yielding to the event loop between them so a large level does not stall the frame the way a single synchronous spawn loop would.\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "interface StreamLevelOptions "
+            }
+          ],
+          "fileUrlPath": "dist/core.d.ts",
+          "releaseTag": "Public",
+          "name": "StreamLevelOptions",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@zylem/game-lib!StreamLevelOptions#batchSize:member",
+              "docComment": "/**\n * @default 5\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "batchSize?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "batchSize",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@zylem/game-lib!StreamLevelResult:interface",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "interface StreamLevelResult "
+            }
+          ],
+          "fileUrlPath": "dist/core.d.ts",
+          "releaseTag": "Public",
+          "name": "StreamLevelResult",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@zylem/game-lib!StreamLevelResult#spawned:member",
+              "docComment": "/**\n * Entries handed to `spawn`, in buffer order.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "spawned: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "spawned",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@zylem/game-lib!SwatchApplyOutcome:interface",
@@ -61279,7 +61735,7 @@
               "text": "interface ThirdPersonOptions "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "name": "ThirdPersonOptions",
           "preserveMemberOrder": false,
@@ -61605,7 +62061,7 @@
               "text": " "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "isAbstract": false,
           "name": "ThirdPersonPerspective",
@@ -62015,7 +62471,7 @@
               "text": "interface TopDownOptions "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "name": "TopDownOptions",
           "preserveMemberOrder": false,
@@ -62179,7 +62635,7 @@
               "text": " "
             }
           ],
-          "fileUrlPath": "dist/stage-CAPlk_cN.d.ts",
+          "fileUrlPath": "dist/stage-bVLyYnOQ.d.ts",
           "releaseTag": "Public",
           "isAbstract": false,
           "name": "TopDownPerspective",
@@ -63954,7 +64410,7 @@
               "text": "interface TransformLike "
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "releaseTag": "Public",
           "name": "TransformLike",
           "preserveMemberOrder": false,
@@ -65616,7 +66072,7 @@
               "text": "interface Viewport "
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "releaseTag": "Public",
           "name": "Viewport",
           "preserveMemberOrder": false,
@@ -75632,7 +76088,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "releaseTag": "Public",
           "name": "ZylemPostEffect",
           "typeTokenRange": {
@@ -76080,7 +76536,7 @@
               "text": ";"
             }
           ],
-          "fileUrlPath": "dist/zylem-camera-CYDtrVgi.d.ts",
+          "fileUrlPath": "dist/zylem-camera-CO713zFl.d.ts",
           "releaseTag": "Public",
           "name": "ZylemRenderer",
           "typeTokenRange": {