@volter/game-editor 0.5.67 → 0.5.68

package/BUNDLED_NOTICES

@@ -735,9 +735,9 @@ Public License instead of this License.  But first, please read
 <https://www.gnu.org/licenses/why-not-lgpl.html>.
 
 
-@volter/editor-blender@0.1.10
+@volter/editor-blender@0.1.11
 Declared license: AGPL-3.0-only AND GPL-3.0-or-later
-Source: the unmodified npm package @volter/editor-blender@0.1.10, from https://github.com/volter-ai/editor.git
+Source: the unmodified npm package @volter/editor-blender@0.1.11, from https://github.com/volter-ai/editor.git
 
 --- packages/editor-blender/LICENSE ---
 
@@ -2176,9 +2176,9 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
-@volter/editor-core@0.5.67
+@volter/editor-core@0.5.68
 Declared license: AGPL-3.0-only AND Apache-2.0
-Source: the unmodified npm package @volter/editor-core@0.5.67, from https://github.com/volter-ai/editor.git
+Source: the unmodified npm package @volter/editor-core@0.5.68, from https://github.com/volter-ai/editor.git
 
 --- packages/editor-core/LICENSE ---
 
@@ -3100,9 +3100,9 @@ server/support/ modules transferred from @vgai/sdk are Apache-2.0.
 Their source paths and hashes are recorded in provenance/editor-server.json.
 
 
-@volter/editor-game@0.5.67
+@volter/editor-game@0.5.68
 Declared license: AGPL-3.0-only
-Source: the unmodified npm package @volter/editor-game@0.5.67, from https://github.com/volter-ai/editor.git
+Source: the unmodified npm package @volter/editor-game@0.5.68, from https://github.com/volter-ai/editor.git
 
 --- packages/editor-game/LICENSE ---
 
@@ -3796,9 +3796,9 @@ the Apache-2.0 @vgai/sdk package, and retains that license. It re-exports the
 Apache-2.0 tool contract of @volter/editor-sdk.
 
 
-@volter/editor-project@0.5.67
+@volter/editor-project@0.5.68
 Declared license: Apache-2.0
-Source: the unmodified npm package @volter/editor-project@0.5.67, from https://github.com/volter-ai/editor.git
+Source: the unmodified npm package @volter/editor-project@0.5.68, from https://github.com/volter-ai/editor.git
 
 --- packages/editor-project/LICENSE ---
 
@@ -4006,9 +4006,9 @@ Source: the unmodified npm package @volter/editor-project@0.5.67, from https://g
    limitations under the License.
 
 
-@volter/editor-react@0.5.67
+@volter/editor-react@0.5.68
 Declared license: AGPL-3.0-only
-Source: the unmodified npm package @volter/editor-react@0.5.67, from https://github.com/volter-ai/editor.git
+Source: the unmodified npm package @volter/editor-react@0.5.68, from https://github.com/volter-ai/editor.git
 
 --- packages/editor-react/LICENSE ---
 
@@ -4683,9 +4683,9 @@ The files in this package were imported from volter-ai/vgai-engine at commit
 09c2749ce. LICENSE contains the AGPL-3.0-only license they retain.
 
 
-@volter/editor-sdk@0.5.67
+@volter/editor-sdk@0.5.68
 Declared license: Apache-2.0
-Source: the unmodified npm package @volter/editor-sdk@0.5.67, from https://github.com/volter-ai/editor.git
+Source: the unmodified npm package @volter/editor-sdk@0.5.68, from https://github.com/volter-ai/editor.git
 
 --- packages/editor-sdk/LICENSE ---
 
@@ -4905,9 +4905,9 @@ The project output-root policy is Apache-2.0, transferred from the original
 SDK; its exact source is recorded in provenance/editor-server.json.
 
 
-@volter/editor-threejs@0.5.67
+@volter/editor-threejs@0.5.68
 Declared license: AGPL-3.0-only AND Apache-2.0
-Source: the unmodified npm package @volter/editor-threejs@0.5.67, from https://github.com/volter-ai/editor.git
+Source: the unmodified npm package @volter/editor-threejs@0.5.68, from https://github.com/volter-ai/editor.git
 
 --- packages/editor-threejs/LICENSE ---
 
@@ -5798,9 +5798,9 @@ Source revisions and original file hashes are recorded in the repository's
 provenance/blender-integration.json and provenance/editor-host.json.
 
 
-@volter/editor-xstate@0.5.67
+@volter/editor-xstate@0.5.68
 Declared license: AGPL-3.0-only
-Source: the unmodified npm package @volter/editor-xstate@0.5.67, from https://github.com/volter-ai/editor.git
+Source: the unmodified npm package @volter/editor-xstate@0.5.68, from https://github.com/volter-ai/editor.git
 
 --- packages/editor-xstate/LICENSE ---
 
@@ -6475,9 +6475,9 @@ Copyright 2026 Volter AI, Inc.
 LICENSE contains the AGPL-3.0-only license this package is distributed under.
 
 
-@volter/game-runtime@0.5.67
+@volter/game-runtime@0.5.68
 Declared license: Apache-2.0
-Source: the unmodified npm package @volter/game-runtime@0.5.67, from https://github.com/volter-ai/editor.git
+Source: the unmodified npm package @volter/game-runtime@0.5.68, from https://github.com/volter-ai/editor.git
 
 --- packages/game-runtime/LICENSE ---
 
@@ -6695,9 +6695,9 @@ Apache-2.0 @vgai/game-runtime package. They retain that license; LICENSE
 contains its text.
 
 
-@volter/threejs-runtime@0.5.67
+@volter/threejs-runtime@0.5.68
 Declared license: Apache-2.0
-Source: the unmodified npm package @volter/threejs-runtime@0.5.67, from https://github.com/volter-ai/editor.git
+Source: the unmodified npm package @volter/threejs-runtime@0.5.68, from https://github.com/volter-ai/editor.git
 
 --- packages/threejs-runtime/LICENSE ---
 

package/catalog/entries/blender.json

@@ -4,7 +4,7 @@
   "id": "blender",
   "packageJson": {
     "dependencies": {
-      "@volter/editor-blender": "0.1.10",
+      "@volter/editor-blender": "0.1.11",
       "@volter/blender-engine": "0.1.9"
     }
   },

package/catalog/entries/music.json

@@ -15,8 +15,8 @@
   "id": "music",
   "packageJson": {
     "dependencies": {
-      "@volter/dawproject": "0.5.67",
-      "@volter/editor-dawproject": "0.5.67"
+      "@volter/dawproject": "0.5.68",
+      "@volter/editor-dawproject": "0.5.68"
     },
     "vgaiTools": [
       "./src/tools/music-render.tool.ts"
@@ -27,5 +27,5 @@
     "vgai-music"
   ],
   "title": "Music (rendered pieces)",
-  "version": "0.4.1"
+  "version": "0.4.2"
 }

package/catalog/project-source/src/lib/music/music-player.ts

@@ -1,7 +1,7 @@
 /**
  * The game's MUSIC, played from a piece's render (`render-piece`'s output folder): the looped
- * mix, a section loop per `<Marker>` (`--sections`), the stems, and one-shot stingers
- * (`--one-shot`), all through the game's own Web Audio graph.
+ * mix, a section loop per `<Marker>` (`--sections`), a loop per launcher `<Scene>`, the stems,
+ * and one-shot stingers (`--one-shot`), all through the game's own Web Audio graph.
  *
  *   horizontal   `queue('Battle')` switches loops on the next bar line of what is playing
  *                (`barSeconds` in the report), or at its loop end; the old loop fades out
@@ -27,6 +27,8 @@ export interface MusicRender {
   readonly barSeconds: readonly number[];
   /** A section per marker: `start` is its second in the whole piece, where its loop begins. */
   readonly sections?: readonly { readonly name: string; readonly start: number; readonly seconds: number; readonly file: string; readonly fileM4a?: string }[];
+  /** A loop per launcher scene (one state of the music), `bars` whole bars from its own start. */
+  readonly scenes?: readonly { readonly name: string; readonly bars: number; readonly seconds: number; readonly file: string; readonly fileM4a?: string }[];
   readonly stems?: { readonly files?: readonly { readonly track: string; readonly file: string; readonly fileM4a?: string }[] };
 }
 
@@ -35,7 +37,7 @@ export interface MusicRender {
  * that cannot decode Vorbis (Safari on iOS before 17.4) gets the same loop from its `.m4a`.
  */
 export async function loadMusic(context: BaseAudioContext, baseUrl: string, render: MusicRender): Promise<Map<string, AudioBuffer>> {
-  const entries = [render, ...(render.sections ?? []), ...(render.stems?.files ?? [])];
+  const entries = [render, ...(render.sections ?? []), ...(render.scenes ?? []), ...(render.stems?.files ?? [])];
   const base = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;
   const decode = async (file: string): Promise<AudioBuffer> => {
     const response = await fetch(new URL(file, base));
@@ -65,7 +67,7 @@ interface Playing {
 export interface MusicPlayer {
   /** The player's output; connect it where the game's music bus is. */
   readonly output: GainNode;
-  /** Start a section's loop (by marker name), or the whole piece's with `null`, at `when` (now). */
+  /** Start a section's loop (by marker name) or a scene's (by scene name), or the whole piece's with `null`, at `when` (now). */
   play(section: string | null, options?: { stems?: boolean; when?: number }): void;
   /** Switch to another loop at the next bar line, or at the playing loop's end. Returns the context time it switches. */
   queue(section: string | null, options?: { at?: 'bar' | 'end'; fade?: number; stems?: boolean }): number;
@@ -104,20 +106,24 @@ export function createMusicPlayer(options: {
   };
 
   const start = (name: string | null, stems: boolean, when: number): Playing => {
-    const section = name === null ? null : render.sections?.find((candidate) => candidate.name === name);
-    if (name !== null && !section) throw new Error(`No section "${name}" in this render (render it with --sections).`);
-    if (stems && section) throw new Error('Stems are rendered for the whole piece, not per section.');
-    const files = stems ? (render.stems?.files ?? []).map((stem) => [stem.track, stem.file] as const) : [[name ?? 'mix', section?.file ?? render.file] as const];
+    const section = name === null ? undefined : render.sections?.find((candidate) => candidate.name === name);
+    const scene = name === null ? undefined : render.scenes?.find((candidate) => candidate.name === name);
+    if (section && scene) throw new Error(`"${name}" names both a section and a scene in this render; rename one of them.`);
+    if (name !== null && !section && !scene) {
+      throw new Error(`No section or scene "${name}" in this render (sections render with --sections; scenes always render).`);
+    }
+    if (stems && (section || scene)) throw new Error('Stems are rendered for the whole piece, not per section or scene.');
+    const files = stems ? (render.stems?.files ?? []).map((stem) => [stem.track, stem.file] as const) : [[name ?? 'mix', (section ?? scene)?.file ?? render.file] as const];
     if (files.length === 0) throw new Error('This render has no stems.');
     // The loop is the decoded buffer's own length (the context may resample the file); its bar
     // lines are the piece's that fall inside it, from its start. A marker off a downbeat starts a
     // loop mid-bar, and its bar lines are still the piece's.
     const seconds = buffer(files[0]![1]).duration;
     const from = section?.start ?? 0;
-    const bars = [
-      ...render.barSeconds.map((second) => second - from).filter((second) => second >= -1e-6 && second < seconds - 1e-3),
-      seconds,
-    ];
+    // A scene's loop is its own: its bar lines divide it evenly, from its start.
+    const bars = scene
+      ? [...Array.from({ length: scene.bars }, (_, bar) => (bar * seconds) / scene.bars), seconds]
+      : [...render.barSeconds.map((second) => second - from).filter((second) => second >= -1e-6 && second < seconds - 1e-3), seconds];
     const gain = context.createGain();
     gain.connect(output);
     const sources = new Map<string, { source: AudioBufferSourceNode; gain: GainNode }>();