@zylem/game-lib 0.8.9 → 0.9.1

package/dist/schema/song.schema.json

@@ -0,0 +1,430 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "SongDefinition",
+  "title": "SongDefinition",
+  "additionalProperties": false,
+  "type": "object",
+  "required": [
+    "id",
+    "name",
+    "bpm",
+    "timeSignature",
+    "lengthBars",
+    "instruments",
+    "tracks",
+    "clips"
+  ],
+  "properties": {
+    "id": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    },
+    "bpm": {
+      "exclusiveMinimum": 0,
+      "type": "number"
+    },
+    "timeSignature": {
+      "title": "TimeSignature",
+      "additionalProperties": false,
+      "type": "object",
+      "required": [
+        "numerator",
+        "denominator"
+      ],
+      "properties": {
+        "numerator": {
+          "minimum": 1,
+          "type": "integer"
+        },
+        "denominator": {
+          "minimum": 1,
+          "type": "integer"
+        }
+      }
+    },
+    "lengthBars": {
+      "minimum": 1,
+      "type": "integer"
+    },
+    "loop": {
+      "title": "SongLoop",
+      "additionalProperties": false,
+      "type": "object",
+      "required": [
+        "enabled",
+        "start",
+        "end"
+      ],
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "start": {
+          "minimum": 0,
+          "type": "number"
+        },
+        "end": {
+          "exclusiveMinimum": 0,
+          "type": "number"
+        }
+      }
+    },
+    "instruments": {
+      "type": "array",
+      "items": {
+        "title": "InstrumentDefinition",
+        "additionalProperties": false,
+        "type": "object",
+        "required": [
+          "id",
+          "name",
+          "preset"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "preset": {
+            "title": "InstrumentPreset",
+            "anyOf": [
+              {
+                "const": "synth",
+                "type": "string"
+              },
+              {
+                "const": "polySynth",
+                "type": "string"
+              },
+              {
+                "const": "fmSynth",
+                "type": "string"
+              },
+              {
+                "const": "amSynth",
+                "type": "string"
+              },
+              {
+                "const": "membraneSynth",
+                "type": "string"
+              },
+              {
+                "const": "metalSynth",
+                "type": "string"
+              },
+              {
+                "const": "noiseSynth",
+                "type": "string"
+              },
+              {
+                "const": "pluckSynth",
+                "type": "string"
+              }
+            ]
+          },
+          "oscillator": {
+            "title": "OscillatorType",
+            "anyOf": [
+              {
+                "const": "sine",
+                "type": "string"
+              },
+              {
+                "const": "square",
+                "type": "string"
+              },
+              {
+                "const": "sawtooth",
+                "type": "string"
+              },
+              {
+                "const": "triangle",
+                "type": "string"
+              }
+            ]
+          },
+          "envelope": {
+            "title": "Envelope",
+            "additionalProperties": false,
+            "type": "object",
+            "required": [
+              "attack",
+              "decay",
+              "sustain",
+              "release"
+            ],
+            "properties": {
+              "attack": {
+                "minimum": 0,
+                "type": "number"
+              },
+              "decay": {
+                "minimum": 0,
+                "type": "number"
+              },
+              "sustain": {
+                "minimum": 0,
+                "maximum": 1,
+                "type": "number"
+              },
+              "release": {
+                "minimum": 0,
+                "type": "number"
+              }
+            }
+          },
+          "volume": {
+            "type": "number"
+          },
+          "effects": {
+            "type": "array",
+            "items": {
+              "title": "InstrumentEffect",
+              "additionalProperties": false,
+              "type": "object",
+              "required": [
+                "id",
+                "type"
+              ],
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "type": {
+                  "title": "EffectType",
+                  "anyOf": [
+                    {
+                      "const": "reverb",
+                      "type": "string"
+                    },
+                    {
+                      "const": "delay",
+                      "type": "string"
+                    },
+                    {
+                      "const": "distortion",
+                      "type": "string"
+                    },
+                    {
+                      "const": "filter",
+                      "type": "string"
+                    }
+                  ]
+                },
+                "wet": {
+                  "minimum": 0,
+                  "maximum": 1,
+                  "type": "number"
+                },
+                "options": {
+                  "type": "object",
+                  "patternProperties": {
+                    "^(.*)$": {
+                      "anyOf": [
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "boolean"
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "tracks": {
+      "type": "array",
+      "items": {
+        "title": "SongTrack",
+        "additionalProperties": false,
+        "type": "object",
+        "required": [
+          "id",
+          "name",
+          "kind"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "kind": {
+            "anyOf": [
+              {
+                "const": "instrument",
+                "type": "string"
+              },
+              {
+                "const": "audio",
+                "type": "string"
+              }
+            ]
+          },
+          "instrumentId": {
+            "type": "string"
+          },
+          "color": {
+            "type": "string"
+          },
+          "volume": {
+            "type": "number"
+          },
+          "pan": {
+            "minimum": -1,
+            "maximum": 1,
+            "type": "number"
+          },
+          "mute": {
+            "type": "boolean"
+          },
+          "solo": {
+            "type": "boolean"
+          }
+        }
+      }
+    },
+    "clips": {
+      "type": "array",
+      "items": {
+        "title": "SongClip",
+        "anyOf": [
+          {
+            "title": "NoteClip",
+            "additionalProperties": false,
+            "type": "object",
+            "required": [
+              "kind",
+              "id",
+              "trackId",
+              "start",
+              "length",
+              "notes"
+            ],
+            "properties": {
+              "kind": {
+                "const": "notes",
+                "type": "string"
+              },
+              "id": {
+                "type": "string"
+              },
+              "trackId": {
+                "type": "string"
+              },
+              "name": {
+                "type": "string"
+              },
+              "start": {
+                "minimum": 0,
+                "type": "number"
+              },
+              "length": {
+                "exclusiveMinimum": 0,
+                "type": "number"
+              },
+              "notes": {
+                "type": "array",
+                "items": {
+                  "title": "SongNote",
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "pitch",
+                    "start",
+                    "duration"
+                  ],
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "pitch": {
+                      "minimum": 0,
+                      "maximum": 127,
+                      "type": "integer"
+                    },
+                    "start": {
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "duration": {
+                      "exclusiveMinimum": 0,
+                      "type": "number"
+                    },
+                    "velocity": {
+                      "minimum": 0,
+                      "maximum": 1,
+                      "type": "number"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "title": "AudioClip",
+            "additionalProperties": false,
+            "type": "object",
+            "required": [
+              "kind",
+              "id",
+              "trackId",
+              "url",
+              "start",
+              "length"
+            ],
+            "properties": {
+              "kind": {
+                "const": "audio",
+                "type": "string"
+              },
+              "id": {
+                "type": "string"
+              },
+              "trackId": {
+                "type": "string"
+              },
+              "name": {
+                "type": "string"
+              },
+              "url": {
+                "type": "string"
+              },
+              "start": {
+                "minimum": 0,
+                "type": "number"
+              },
+              "offset": {
+                "minimum": 0,
+                "type": "number"
+              },
+              "length": {
+                "exclusiveMinimum": 0,
+                "type": "number"
+              },
+              "gain": {
+                "type": "number"
+              }
+            }
+          }
+        ]
+      }
+    },
+    "masterVolume": {
+      "type": "number"
+    }
+  }
+}

package/dist/schema.d.ts

@@ -1,6 +1,8 @@
 export { f as EntityBlueprint, j as EntityJson, d as EntityJsonSchema, E as EntitySchema, i as LineEntityData, L as LineEntityDataSchema, h as SpriteEntityData, b as SpriteEntityDataSchema, S as StageBlueprint, k as StageJson, e as StageJsonSchema, c as StageSchema, g as TextEntityData, T as TextEntityDataSchema, V as Vector2Schema, a as Vector3TupleSchema } from './blueprints-TbGY-h53.js';
 import * as _sinclair_typebox from '@sinclair/typebox';
 import { Static } from '@sinclair/typebox';
+export { g as SongDefinition, S as SongDefinitionSchema } from './song-definition-rEKksP0B.js';
+export { g as CutsceneDefinition, C as CutsceneDefinitionSchema } from './cutscene-definition-C479fkei.js';
 
 /** Keyboard action → key-code list mapping. */
 declare const KeyboardMappingSchema: _sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TArray<_sinclair_typebox.TString>>;

package/dist/schema.js

@@ -1 +1 @@
-import{A,B,C,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z}from"./chunk-JNFFTNMH.js";import"./chunk-WOT6VMZA.js";export{v as ColorJsonSchema,h as EntityJsonSchema,b as EntitySchema,C as GameConfigJsonSchema,B as GameDeviceConfigJsonSchema,u as GameInputConfigSchema,t as GameInputPlayerConfigSchema,j as KeyboardMappingSchema,f as LineEntityDataSchema,s as MouseConfigSchema,k as MouseMappingSchema,A as ResolutionInputSchema,g as SpriteEntityDataSchema,y as StageAssetLoaderConfigSchema,z as StageConfigJsonSchema,x as StageGLTFAssetLoaderConfigSchema,i as StageJsonSchema,c as StageSchema,d as TextEntityDataSchema,w as Vec3ComponentsSchema,a as Vector2Schema,e as Vector3TupleSchema,n as VirtualTouchButtonConfigSchema,p as VirtualTouchButtonsConfigSchema,r as VirtualTouchConfigSchema,o as VirtualTouchJoystickConfigSchema,q as VirtualTouchJoysticksConfigSchema,m as VirtualTouchPositionSchema,l as VirtualTouchStyleSchema};
+import{A as C,B as D,C as E,a as c,b as d,c as e,d as f,e as g,f as h,g as i,h as j,i as k,j as l,k as m,l as n,m as o,n as p,o as q,p as r,q as s,r as t,s as u,t as v,u as w,v as x,w as y,x as z,y as A,z as B}from"./chunk-KSEP7AUF.js";import{k as a}from"./chunk-NVVLLWIM.js";import{k as b}from"./chunk-YNX3Q3CL.js";import"./chunk-WOT6VMZA.js";export{x as ColorJsonSchema,b as CutsceneDefinitionSchema,j as EntityJsonSchema,d as EntitySchema,E as GameConfigJsonSchema,D as GameDeviceConfigJsonSchema,w as GameInputConfigSchema,v as GameInputPlayerConfigSchema,l as KeyboardMappingSchema,h as LineEntityDataSchema,u as MouseConfigSchema,m as MouseMappingSchema,C as ResolutionInputSchema,a as SongDefinitionSchema,i as SpriteEntityDataSchema,A as StageAssetLoaderConfigSchema,B as StageConfigJsonSchema,z as StageGLTFAssetLoaderConfigSchema,k as StageJsonSchema,e as StageSchema,f as TextEntityDataSchema,y as Vec3ComponentsSchema,c as Vector2Schema,g as Vector3TupleSchema,p as VirtualTouchButtonConfigSchema,r as VirtualTouchButtonsConfigSchema,t as VirtualTouchConfigSchema,q as VirtualTouchJoystickConfigSchema,s as VirtualTouchJoysticksConfigSchema,o as VirtualTouchPositionSchema,n as VirtualTouchStyleSchema};

package/dist/selection-bounds-BKmSo9aG.d.ts

@@ -0,0 +1,50 @@
+import { Box3, Object3D } from 'three';
+
+/**
+ * The volume an entity presents to the editor's selection tools.
+ *
+ * Outlines, the hover cursor and the marquee hit test all need "the box
+ * around this entity", and a raw world AABB is a poor answer for anything
+ * flat: a plane has zero height, a sprite zero depth, a line is thin on two
+ * axes, and a zone or particle emitter has no renderable at all. This module
+ * gives every consumer one answer, in two layers:
+ *
+ * - a default that measures `group ?? mesh` and pads thin axes up to a
+ *   minimum thickness proportional to the entity's size, plus a small margin
+ *   so the outline sits just outside the surface;
+ * - an optional per-entity override, {@link SelectionBoundsProvider}, for
+ *   entities whose selection view cannot be derived from their render object.
+ */
+
+/** Uniform margin around the box, as a fraction of its largest extent. */
+declare const SELECTION_BOUNDS_MARGIN = 0.02;
+/** A thin axis is padded up to this fraction of the largest extent... */
+declare const SELECTION_THIN_AXIS_FRACTION = 0.05;
+/** ...clamped between these world-unit bounds. */
+declare const SELECTION_THIN_AXIS_MIN = 0.1;
+declare const SELECTION_THIN_AXIS_MAX = 1;
+/**
+ * Implemented by entities that define their own selection view. `target`
+ * is a scratch box to write into; return it, or `null` when the entity
+ * currently has no selectable volume. World space.
+ */
+interface SelectionBoundsProvider {
+    getSelectionBounds(target: Box3): Box3 | null;
+}
+/**
+ * Thicken any axis thinner than the minimum and add the uniform margin, in
+ * place. The minimum is proportional to the entity's largest extent so a
+ * 10-unit floor gets a visible slab while a coin-sized disk does not turn
+ * into a cube. Empty or non-finite boxes are returned untouched.
+ */
+declare function padSelectionBounds(box: Box3): Box3;
+/** The default selection view: the object's world AABB, padded. */
+declare function measureObjectSelectionBounds(object: Object3D, target: Box3): Box3;
+/**
+ * The selection bounds for an entity: its own {@link SelectionBoundsProvider}
+ * answer when it has one, otherwise the padded AABB of `group ?? mesh`.
+ * Returns `null` when there is nothing to select, so callers need one check.
+ */
+declare function resolveSelectionBounds(entity: unknown, target: Box3): Box3 | null;
+
+export { SELECTION_BOUNDS_MARGIN as S, SELECTION_THIN_AXIS_FRACTION as a, SELECTION_THIN_AXIS_MIN as b, SELECTION_THIN_AXIS_MAX as c, type SelectionBoundsProvider as d, measureObjectSelectionBounds as m, padSelectionBounds as p, resolveSelectionBounds as r };