@zylem/game-lib 0.3.16 → 0.4.0

package/dist/lib/entities/rect.d.ts

@@ -60,3 +60,4 @@ export declare class ZylemRect extends GameEntity<ZylemRectOptions> {
 type RectOptions = BaseNode | Partial<ZylemRectOptions>;
 export declare function rect(...args: Array<RectOptions>): Promise<ZylemRect>;
 export {};
+//# sourceMappingURL=rect.d.ts.map

package/dist/lib/entities/rect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/rect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAA6E,OAAO,EAA4G,MAAM,OAAO,CAAC;AAC5N,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAM1C,KAAK,gBAAgB,GAAG,iBAAiB,GAAG;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IAClC,WAAW,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE;QACR,MAAM,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QACjE,KAAK,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,CAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACjF,CAAC;CACF,CAAC;AAiBF,qBAAa,WAAY,SAAQ,aAAa,CAAC,SAAS,EAAE,gBAAgB,CAAC;IAC1E,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS;CAGrE;AAED,eAAO,MAAM,SAAS,eAAiB,CAAC;AAExC,qBAAa,SAAU,SAAQ,UAAU,CAAC,gBAAgB,CAAC;IAC1D,MAAM,CAAC,IAAI,SAAa;IAExB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,IAAI,CAAyC;IACrD,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,YAAY,CAAa;gBAErB,OAAO,CAAC,EAAE,gBAAgB;IAWtC,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,UAAU;IAiElB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,qBAAqB;IAkD7B,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,8BAA8B;IAmBtC,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,GAAG,aAAa,GAAG,QAAQ,CAAC,CAAC;IAQjI,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAYhC;AAED,KAAK,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAExD,wBAAsB,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAQ1E"}

package/dist/lib/entities/sphere.d.ts

@@ -26,3 +26,4 @@ export declare class ZylemSphere extends GameEntity<ZylemSphereOptions> {
 type SphereOptions = BaseNode | Partial<ZylemSphereOptions>;
 export declare function sphere(...args: Array<SphereOptions>): Promise<ZylemSphere>;
 export {};
+//# sourceMappingURL=sphere.d.ts.map

package/dist/lib/entities/sphere.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sphere.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/sphere.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAS,cAAc,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAI9C,KAAK,kBAAkB,GAAG,iBAAiB,GAAG;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAcF,qBAAa,sBAAuB,SAAQ,sBAAsB;IACjE,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,YAAY;CAKnD;AAED,qBAAa,iBAAkB,SAAQ,iBAAiB;IACvD,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,cAAc;CAIlD;AAED,qBAAa,aAAc,SAAQ,aAAa,CAAC,WAAW,EAAE,kBAAkB,CAAC;IAChF,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,WAAW;CAGzE;AAED,eAAO,MAAM,WAAW,eAAmB,CAAC;AAE5C,qBAAa,WAAY,SAAQ,UAAU,CAAC,kBAAkB,CAAC;IAC9D,MAAM,CAAC,IAAI,SAAe;gBAEd,OAAO,CAAC,EAAE,kBAAkB;IAKxC,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAUhC;AAED,KAAK,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAE5D,wBAAsB,MAAM,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAUhF"}

package/dist/lib/entities/sprite.d.ts

@@ -50,3 +50,4 @@ export declare class ZylemSprite extends GameEntity<ZylemSpriteOptions> {
 type SpriteOptions = BaseNode | Partial<ZylemSpriteOptions>;
 export declare function sprite(...args: Array<SpriteOptions>): Promise<ZylemSprite>;
 export {};
+//# sourceMappingURL=sprite.d.ts.map

package/dist/lib/entities/sprite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/sprite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAmC,OAAO,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAGN,MAAM,IAAI,WAAW,EACrB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAmB,aAAa,EAAkB,MAAM,8BAA8B,CAAC;AAE9G,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACzD,MAAM,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,IAAI,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,KAAK,kBAAkB,GAAG,iBAAiB,GAAG;IAC7C,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAgBF,qBAAa,sBAAuB,SAAQ,sBAAsB;IACjE,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,YAAY;CAMnD;AAED,qBAAa,aAAc,SAAQ,aAAa,CAAC,WAAW,EAAE,kBAAkB,CAAC;IAChF,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,WAAW;CAGzE;AAED,eAAO,MAAM,WAAW,eAAmB,CAAC;AAE5C,qBAAa,WAAY,SAAQ,UAAU,CAAC,kBAAkB,CAAC;IAC9D,MAAM,CAAC,IAAI,SAAe;IAE1B,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,CAAM;IACtC,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IACrD,SAAS,CAAC,kBAAkB,EAAE,MAAM,CAAK;IACzC,SAAS,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAa;IACnD,SAAS,CAAC,gBAAgB,EAAE,GAAG,CAAQ;IACvC,SAAS,CAAC,qBAAqB,EAAE,MAAM,CAAM;IAC7C,SAAS,CAAC,qBAAqB,EAAE,MAAM,CAAK;IAC5C,SAAS,CAAC,oBAAoB,EAAE,MAAM,CAAK;gBAE/B,OAAO,CAAC,EAAE,kBAAkB;IAWxC,SAAS,CAAC,uBAAuB,CAAC,MAAM,EAAE,WAAW,EAAE;IAiBvD,SAAS,CAAC,gBAAgB,CAAC,UAAU,EAAE,eAAe,EAAE;IAgBxD,SAAS,CAAC,GAAG,EAAE,MAAM;IASrB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IA6BlC,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IActE,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAO9E;AAED,KAAK,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAE5D,wBAAsB,MAAM,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAShF"}

package/dist/lib/entities/text.d.ts

@@ -28,10 +28,17 @@ export declare class ZylemText extends GameEntity<ZylemTextOptions> {
     private _lastCanvasH;
     constructor(options?: ZylemTextOptions);
     private createSprite;
+    private measureAndResizeCanvas;
+    private drawCenteredText;
+    private updateTexture;
     private redrawText;
     private toCssColor;
     private textSetup;
     private textUpdate;
+    private getResolution;
+    private getScreenPixels;
+    private computeWorldExtents;
+    private updateSpriteScale;
     private updateStickyTransform;
     updateText(_text: string): void;
     buildInfo(): Record<string, any>;
@@ -39,3 +46,4 @@ export declare class ZylemText extends GameEntity<ZylemTextOptions> {
 type TextOptions = BaseNode | Partial<ZylemTextOptions>;
 export declare function text(...args: Array<TextOptions>): Promise<ZylemText>;
 export {};
+//# sourceMappingURL=text.d.ts.map

package/dist/lib/entities/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAA6E,OAAO,EAA8D,MAAM,OAAO,CAAC;AAC9K,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAM1C,KAAK,gBAAgB,GAAG,iBAAiB,GAAG;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAeF,qBAAa,WAAY,SAAQ,aAAa,CAAC,SAAS,EAAE,gBAAgB,CAAC;IAC1E,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS;CAGrE;AAED,eAAO,MAAM,SAAS,eAAiB,CAAC;AAExC,qBAAa,SAAU,SAAQ,UAAU,CAAC,gBAAgB,CAAC;IAC1D,MAAM,CAAC,IAAI,SAAa;IAExB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,IAAI,CAAyC;IACrD,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,YAAY,CAAa;gBAErB,OAAO,CAAC,EAAE,gBAAgB;IAWtC,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,sBAAsB;IAgB9B,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,qBAAqB;IAiB7B,UAAU,CAAC,KAAK,EAAE,MAAM;IAQxB,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAWhC;AAED,KAAK,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAExD,wBAAsB,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAQ1E"}

package/dist/lib/entities/text.js

@@ -1,9 +1,9 @@
-import { Vector2 as u, Group as H, CanvasTexture as w, LinearFilter as l, SpriteMaterial as k, Sprite as M, ClampToEdgeWrapping as C, Color as v } from "three";
-import { GameEntity as R } from "./entity.js";
-import { EntityBuilder as W } from "./builder.js";
-import { createEntity as E } from "./create.js";
-import { DebugDelegate as D } from "./delegates/debug.js";
-const x = {
+import { Vector2 as m, Group as v, CanvasTexture as d, LinearFilter as l, SpriteMaterial as y, Sprite as T, ClampToEdgeWrapping as _, Color as f } from "three";
+import { GameEntity as S } from "./entity.js";
+import { EntityBuilder as F } from "./builder.js";
+import { createEntity as R } from "./create.js";
+import { DebugDelegate as H } from "./delegates/debug.js";
+const u = {
   position: void 0,
   text: "",
   fontFamily: 'Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace',
@@ -12,17 +12,17 @@ const x = {
   backgroundColor: null,
   padding: 4,
   stickToViewport: !0,
-  screenPosition: new u(24, 24),
+  screenPosition: new m(24, 24),
   zDistance: 1
 };
-class P extends W {
+class k extends F {
   createEntity(t) {
-    return new o(t);
+    return new c(t);
   }
 }
-const z = Symbol("Text");
-class o extends R {
-  static type = z;
+const b = Symbol("Text");
+class c extends S {
+  static type = b;
   _sprite = null;
   _texture = null;
   _canvas = null;
@@ -31,81 +31,110 @@ class o extends R {
   _lastCanvasW = 0;
   _lastCanvasH = 0;
   constructor(t) {
-    super(), this.options = { ...x, ...t }, this.group = new H(), this.createSprite(), this.lifeCycleDelegate = {
+    super(), this.options = { ...u, ...t }, this.group = new v(), this.createSprite(), this.lifeCycleDelegate = {
       setup: [this.textSetup.bind(this)],
       update: [this.textUpdate.bind(this)]
     };
   }
   createSprite() {
-    this._canvas = document.createElement("canvas"), this._ctx = this._canvas.getContext("2d"), this._texture = new w(this._canvas), this._texture.minFilter = l, this._texture.magFilter = l;
-    const t = new k({
+    this._canvas = document.createElement("canvas"), this._ctx = this._canvas.getContext("2d"), this._texture = new d(this._canvas), this._texture.minFilter = l, this._texture.magFilter = l;
+    const t = new y({
       map: this._texture,
       transparent: !0,
       depthTest: !1,
       depthWrite: !1,
       alphaTest: 0.5
     });
-    this._sprite = new M(t), this.group?.add(this._sprite), this.redrawText(this.options.text ?? "");
+    this._sprite = new T(t), this.group?.add(this._sprite), this.redrawText(this.options.text ?? "");
+  }
+  measureAndResizeCanvas(t, e, s, a) {
+    if (!this._canvas || !this._ctx)
+      return { sizeChanged: !1 };
+    this._ctx.font = `${e}px ${s}`;
+    const i = this._ctx.measureText(t), n = Math.ceil(i.width), r = Math.ceil(e * 1.4), o = Math.max(2, n + a * 2), h = Math.max(2, r + a * 2), p = o !== this._lastCanvasW || h !== this._lastCanvasH;
+    return this._canvas.width = o, this._canvas.height = h, this._lastCanvasW = o, this._lastCanvasH = h, { sizeChanged: p };
+  }
+  drawCenteredText(t, e, s) {
+    !this._canvas || !this._ctx || (this._ctx.font = `${e}px ${s}`, this._ctx.textAlign = "center", this._ctx.textBaseline = "middle", this._ctx.clearRect(0, 0, this._canvas.width, this._canvas.height), this.options.backgroundColor && (this._ctx.fillStyle = this.toCssColor(this.options.backgroundColor), this._ctx.fillRect(0, 0, this._canvas.width, this._canvas.height)), this._ctx.fillStyle = this.toCssColor(this.options.fontColor ?? "#FFFFFF"), this._ctx.fillText(t, this._canvas.width / 2, this._canvas.height / 2));
+  }
+  updateTexture(t) {
+    !this._texture || !this._canvas || (t && (this._texture.dispose(), this._texture = new d(this._canvas), this._texture.minFilter = l, this._texture.magFilter = l, this._texture.wrapS = _, this._texture.wrapT = _), this._texture.image = this._canvas, this._texture.needsUpdate = !0, this._sprite && this._sprite.material && (this._sprite.material.map = this._texture, this._sprite.material.needsUpdate = !0));
   }
   redrawText(t) {
     if (!this._canvas || !this._ctx)
       return;
-    const e = this.options.fontSize ?? 18, r = this.options.fontFamily ?? x.fontFamily, a = this.options.padding ?? 4;
-    this._ctx.font = `${e}px ${r}`;
-    const p = this._ctx.measureText(t), _ = Math.ceil(p.width), h = Math.ceil(e * 1.4), n = Math.max(2, _ + a * 2), s = Math.max(2, h + a * 2), f = n !== this._lastCanvasW || s !== this._lastCanvasH;
-    this._canvas.width = n, this._canvas.height = s, this._lastCanvasW = n, this._lastCanvasH = s, this._ctx.font = `${e}px ${r}`, this._ctx.textBaseline = "top", this._ctx.clearRect(0, 0, this._canvas.width, this._canvas.height), this.options.backgroundColor && (this._ctx.fillStyle = this.toCssColor(this.options.backgroundColor), this._ctx.fillRect(0, 0, this._canvas.width, this._canvas.height)), this._ctx.fillStyle = this.toCssColor(this.options.fontColor ?? "#FFFFFF"), this._ctx.fillText(t, a, a), this._texture && (f && (this._texture.dispose(), this._texture = new w(this._canvas), this._texture.minFilter = l, this._texture.magFilter = l, this._texture.wrapS = C, this._texture.wrapT = C), this._texture.image = this._canvas, this._texture.needsUpdate = !0, this._sprite && this._sprite.material && (this._sprite.material.map = this._texture, this._sprite.material.needsUpdate = !0));
+    const e = this.options.fontSize ?? 18, s = this.options.fontFamily ?? u.fontFamily, a = this.options.padding ?? 4, { sizeChanged: i } = this.measureAndResizeCanvas(t, e, s, a);
+    this.drawCenteredText(t, e, s), this.updateTexture(!!i), this.options.stickToViewport && this._cameraRef && this.updateStickyTransform();
   }
   toCssColor(t) {
-    return typeof t == "string" ? t : `#${(t instanceof v ? t : new v(t)).getHexString()}`;
+    return typeof t == "string" ? t : `#${(t instanceof f ? t : new f(t)).getHexString()}`;
   }
   textSetup(t) {
-    this._cameraRef = t.camera, this.options.stickToViewport && this._cameraRef && this._cameraRef.camera.add(this.group);
+    this._cameraRef = t.camera, this.options.stickToViewport && this._cameraRef && (this._cameraRef.camera.add(this.group), this.updateStickyTransform());
   }
   textUpdate(t) {
     this._sprite && this.options.stickToViewport && this._cameraRef && this.updateStickyTransform();
   }
-  updateStickyTransform() {
-    if (!this._sprite || !this._cameraRef)
-      return;
-    const t = this._cameraRef.camera, e = this._cameraRef.renderer.domElement, r = e.clientWidth, a = e.clientHeight, p = (this.options.screenPosition ?? new u(24, 24)).x, _ = (this.options.screenPosition ?? new u(24, 24)).y, h = Math.max(1e-3, this.options.zDistance ?? 1);
-    let n = 1, s = 1;
+  getResolution() {
+    return {
+      width: this._cameraRef?.screenResolution.x ?? 1,
+      height: this._cameraRef?.screenResolution.y ?? 1
+    };
+  }
+  getScreenPixels(t, e, s) {
+    const a = t.x >= 0 && t.x <= 1, i = t.y >= 0 && t.y <= 1;
+    return {
+      px: a ? t.x * e : t.x,
+      py: i ? t.y * s : t.y
+    };
+  }
+  computeWorldExtents(t, e) {
+    let s = 1, a = 1;
     if (t.isPerspectiveCamera) {
-      const i = t, c = Math.tan(i.fov * Math.PI / 180 / 2) * h;
-      n = c * i.aspect, s = c;
+      const i = t, n = Math.tan(i.fov * Math.PI / 180 / 2) * e;
+      s = n * i.aspect, a = n;
     } else if (t.isOrthographicCamera) {
       const i = t;
-      n = (i.right - i.left) / 2, s = (i.top - i.bottom) / 2;
-    }
-    const f = p / r * 2 - 1, y = 1 - _ / a * 2, T = f * n, F = y * s;
-    if (this.group?.position.set(T, F, -h), this._canvas) {
-      const c = s * 2 / a, m = this._canvas.height, g = Math.max(1e-4, m * c), S = this._canvas.width / this._canvas.height, b = g * S;
-      this._sprite.scale.set(b, g, 1);
+      s = (i.right - i.left) / 2, a = (i.top - i.bottom) / 2;
     }
+    return { worldHalfW: s, worldHalfH: a };
+  }
+  updateSpriteScale(t, e) {
+    if (!this._canvas || !this._sprite)
+      return;
+    const a = t * 2 / e, i = this._canvas.height, n = Math.max(1e-4, i * a), r = this._canvas.width / this._canvas.height, o = n * r;
+    this._sprite.scale.set(o, n, 1);
+  }
+  updateStickyTransform() {
+    if (!this._sprite || !this._cameraRef)
+      return;
+    const t = this._cameraRef.camera, { width: e, height: s } = this.getResolution(), a = this.options.screenPosition ?? new m(24, 24), { px: i, py: n } = this.getScreenPixels(a, e, s), r = Math.max(1e-3, this.options.zDistance ?? 1), { worldHalfW: o, worldHalfH: h } = this.computeWorldExtents(t, r), p = i / e * 2 - 1, g = 1 - n / s * 2, w = p * o, C = g * h;
+    this.group?.position.set(w, C, -r), this.updateSpriteScale(h, s);
   }
   updateText(t) {
     this.options.text = t, this.redrawText(t), this.options.stickToViewport && this._cameraRef && this.updateStickyTransform();
   }
   buildInfo() {
     return {
-      ...new D(this).buildDebugInfo(),
-      type: String(o.type),
+      ...new H(this).buildDebugInfo(),
+      type: String(c.type),
       text: this.options.text ?? "",
       sticky: this.options.stickToViewport
     };
   }
 }
-async function X(...d) {
-  return E({
-    args: d,
-    defaultConfig: { ...x },
-    EntityClass: o,
-    BuilderClass: P,
-    entityType: o.type
+async function D(...x) {
+  return R({
+    args: x,
+    defaultConfig: { ...u },
+    EntityClass: c,
+    BuilderClass: k,
+    entityType: c.type
   });
 }
 export {
-  z as TEXT_TYPE,
-  P as TextBuilder,
-  o as ZylemText,
-  X as text
+  b as TEXT_TYPE,
+  k as TextBuilder,
+  c as ZylemText,
+  D as text
 };

package/dist/lib/entities/zone.d.ts

@@ -51,3 +51,4 @@ export declare class ZylemZone extends GameEntity<ZylemZoneOptions> implements C
 type ZoneOptions = BaseNode | Partial<ZylemZoneOptions>;
 export declare function zone(...args: Array<ZoneOptions>): Promise<ZylemZone>;
 export {};
+//# sourceMappingURL=zone.d.ts.map

package/dist/lib/entities/zone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/zone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAG3E,MAAM,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,GAAG,CAAC;CACb,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;AAC/E,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;AAE9E,KAAK,gBAAgB,GAAG,iBAAiB,GAAG;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;CACxC,CAAC;AAaF,qBAAa,oBAAqB,SAAQ,sBAAsB;IAC/D,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY;CAQjD;AAED,qBAAa,WAAY,SAAQ,aAAa,CAAC,SAAS,EAAE,gBAAgB,CAAC;IAC1E,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS;CAGrE;AAED,eAAO,MAAM,SAAS,eAAiB,CAAC;AAExC,qBAAa,SAAU,SAAQ,UAAU,CAAC,gBAAgB,CAAE,YAAW,wBAAwB;IAC9F,MAAM,CAAC,IAAI,SAAa;IAExB,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,aAAa,CAA+B;gBAExC,OAAO,CAAC,EAAE,gBAAgB;IAK/B,mBAAmB,CAAC,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAO1D,uBAAuB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAU9E,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI;IAKjD,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI;IAK/C,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI;IAK/C,OAAO,CAAC,KAAK,EAAE,GAAG;IAWlB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAkBjC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;CAc9B;AAED,KAAK,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAExD,wBAAsB,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAS1E"}

package/dist/lib/game/game-blueprint.d.ts

@@ -0,0 +1,38 @@
+import type { Stage } from '../stage/stage';
+import type { BaseGlobals, ZylemGameConfig } from './game-interfaces';
+/**
+ * A lightweight, serializable blueprint representing the initial configuration
+ * of a `Game`. It should not include runtime references. Use blueprints only to
+ * build games.
+ */
+export interface GameBlueprint<TGlobals extends BaseGlobals = BaseGlobals> {
+    id: string;
+    name?: string;
+    config: Partial<ZylemGameConfig<Stage, any, TGlobals>>;
+}
+export declare const gameBlueprintsState: {
+    byId: Record<string, GameBlueprint>;
+    order: string[];
+    currentId: string | null;
+};
+/** Reset the blueprints store back to its initial empty state. */
+export declare function resetGameBlueprints(): void;
+/** Create and register a new `GameBlueprint`. */
+export declare function createGameBlueprint<TGlobals extends BaseGlobals>(config: Partial<ZylemGameConfig<Stage, any, TGlobals>>, options?: {
+    id?: string;
+    name?: string;
+    setCurrent?: boolean;
+}): GameBlueprint<TGlobals>;
+/** Upsert a blueprint into the store. */
+export declare function upsertGameBlueprint<TGlobals extends BaseGlobals>(blueprint: GameBlueprint<TGlobals>): void;
+/** Remove a blueprint by id. */
+export declare function removeGameBlueprint(id: string): void;
+/** Get a blueprint by id. */
+export declare function getGameBlueprint(id: string): GameBlueprint | undefined;
+/** List all blueprints in insertion order. */
+export declare function listGameBlueprints(): GameBlueprint[];
+/** Set the current blueprint id (or clear by passing null). */
+export declare function setCurrentGameBlueprint(id: string | null): void;
+/** Get the current blueprint object, if any. */
+export declare function getCurrentGameBlueprint(): GameBlueprint | null;
+//# sourceMappingURL=game-blueprint.d.ts.map

package/dist/lib/game/game-blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-blueprint.d.ts","sourceRoot":"","sources":["../../../src/lib/game/game-blueprint.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEtE;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;CACvD;AAYD,eAAO,MAAM,mBAAmB;UALnB,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;WAC5B,MAAM,EAAE;eACF,MAAM,GAAG,IAAI;CAG8C,CAAC;AAEhF,kEAAkE;AAClE,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,WAAW,EAC/D,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,EACtD,OAAO,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAAE,GAC7D,aAAa,CAAC,QAAQ,CAAC,CAWzB;AAED,yCAAyC;AACzC,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,WAAW,EAC/D,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,GAChC,IAAI,CAKN;AAED,gCAAgC;AAChC,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAMpD;AAED,6BAA6B;AAC7B,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEtE;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,IAAI,aAAa,EAAE,CAIpD;AAED,+DAA+D;AAC/D,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE/D;AAED,gDAAgD;AAChD,wBAAgB,uBAAuB,IAAI,aAAa,GAAG,IAAI,CAG9D"}

package/dist/lib/game/game-canvas.d.ts

@@ -0,0 +1,35 @@
+import { AspectRatioValue } from '../device/aspect-ratio';
+export interface GameCanvasOptions {
+    id: string;
+    container?: HTMLElement;
+    containerId?: string;
+    canvas?: HTMLCanvasElement;
+    bodyBackground?: string;
+    fullscreen?: boolean;
+    aspectRatio: AspectRatioValue | number;
+}
+/**
+ * GameCanvas is a DOM delegate that owns:
+ * - container lookup/creation and styling (including fullscreen centering)
+ * - body background application
+ * - canvas mounting into container
+ * - aspect ratio sizing via AspectRatioDelegate
+ */
+export declare class GameCanvas {
+    id: string;
+    container: HTMLElement;
+    canvas: HTMLCanvasElement;
+    bodyBackground?: string;
+    fullscreen: boolean;
+    aspectRatio: number;
+    private ratioDelegate;
+    constructor(options: GameCanvasOptions);
+    applyBodyBackground(): void;
+    mountCanvas(): void;
+    mountRenderer(rendererDom: HTMLCanvasElement, onResize: (width: number, height: number) => void): void;
+    centerIfFullscreen(): void;
+    attachAspectRatio(onResize: (width: number, height: number) => void): void;
+    destroy(): void;
+    private ensureContainer;
+}
+//# sourceMappingURL=game-canvas.d.ts.map

package/dist/lib/game/game-canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-canvas.d.ts","sourceRoot":"","sources":["../../../src/lib/game/game-canvas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,gBAAgB,GAAG,MAAM,CAAC;CACvC;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAG,WAAW,CAAC;IACxB,MAAM,EAAG,iBAAiB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,aAAa,CAAoC;gBAE7C,OAAO,EAAE,iBAAiB;IAStC,mBAAmB;IAMnB,WAAW;IAOX,aAAa,CAAC,WAAW,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI;IAS/F,kBAAkB;IAUlB,iBAAiB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI;IAiBnE,OAAO;IAKP,OAAO,CAAC,eAAe;CAevB"}

package/dist/lib/game/game-canvas.js

@@ -0,0 +1,57 @@
+import { AspectRatioDelegate as s } from "../device/aspect-ratio.js";
+class o {
+  id;
+  container;
+  canvas;
+  bodyBackground;
+  fullscreen;
+  aspectRatio;
+  ratioDelegate = null;
+  constructor(t) {
+    this.id = t.id, this.container = this.ensureContainer(t.containerId ?? t.id, t.container), this.canvas = t.canvas ?? document.createElement("canvas"), this.bodyBackground = t.bodyBackground, this.fullscreen = !!t.fullscreen, this.aspectRatio = (typeof t.aspectRatio == "number", t.aspectRatio);
+  }
+  applyBodyBackground() {
+    this.bodyBackground && (document.body.style.background = this.bodyBackground);
+  }
+  mountCanvas() {
+    for (; this.container.firstChild; )
+      this.container.removeChild(this.container.firstChild);
+    this.container.appendChild(this.canvas);
+  }
+  mountRenderer(t, a) {
+    for (; this.container.firstChild; )
+      this.container.removeChild(this.container.firstChild);
+    this.container.appendChild(t), this.canvas = t, this.attachAspectRatio(a);
+  }
+  centerIfFullscreen() {
+    if (!this.fullscreen)
+      return;
+    const t = this.container.style;
+    t.display = "flex", t.alignItems = "center", t.justifyContent = "center", t.position = "fixed", t.inset = "0";
+  }
+  attachAspectRatio(t) {
+    this.ratioDelegate ? (this.ratioDelegate.canvas = this.canvas, this.ratioDelegate.onResize = t, this.ratioDelegate.aspectRatio = this.aspectRatio, this.ratioDelegate.apply()) : (this.ratioDelegate = new s({
+      container: this.container,
+      canvas: this.canvas,
+      aspectRatio: this.aspectRatio,
+      onResize: t
+    }), this.ratioDelegate.attach());
+  }
+  destroy() {
+    this.ratioDelegate?.detach(), this.ratioDelegate = null;
+  }
+  ensureContainer(t, a) {
+    if (a)
+      return a;
+    if (t) {
+      const i = document.getElementById(t);
+      if (i)
+        return i;
+    }
+    const n = t || this.id || "zylem-root", e = document.createElement("main");
+    return e.setAttribute("id", n), e.style.position = "relative", e.style.width = "100%", e.style.height = "100%", document.body.appendChild(e), e;
+  }
+}
+export {
+  o as GameCanvas
+};

package/dist/lib/game/game-config.d.ts

@@ -0,0 +1,63 @@
+import { StageInterface } from "../types";
+import { GameInputConfig } from "./game-interfaces";
+import { AspectRatio, AspectRatioValue } from "../device/aspect-ratio";
+import { RetroPresetKey } from "./game-retro-resolutions";
+export type GameConfigLike = Partial<{
+    id: string;
+    globals: Record<string, any>;
+    stages: StageInterface[];
+    debug: boolean;
+    time: number;
+    input: GameInputConfig;
+    /** numeric value or key in AspectRatio */
+    aspectRatio: AspectRatioValue | keyof typeof AspectRatio;
+    /** console/display preset to derive aspect ratio */
+    preset: RetroPresetKey;
+    /** lock internal render buffer to this resolution (e.g., '256x240' or { width, height }) */
+    resolution: string | {
+        width: number;
+        height: number;
+    };
+    fullscreen: boolean;
+    /** CSS background value for document body */
+    bodyBackground: string;
+    /** existing container by reference */
+    container: HTMLElement;
+    /** create/find container by id */
+    containerId: string;
+    /** optional canvas if caller wants to manage it */
+    canvas: HTMLCanvasElement;
+}>;
+export declare class GameConfig {
+    id: string;
+    globals: Record<string, any>;
+    stages: StageInterface[];
+    debug: boolean;
+    time: number;
+    input: GameInputConfig | undefined;
+    aspectRatio: number;
+    internalResolution: {
+        width: number;
+        height: number;
+    } | undefined;
+    fullscreen: boolean;
+    bodyBackground: string | undefined;
+    container: HTMLElement;
+    containerId?: string | undefined;
+    canvas?: HTMLCanvasElement | undefined;
+    constructor(id: string, globals: Record<string, any>, stages: StageInterface[], debug: boolean, time: number, input: GameInputConfig | undefined, aspectRatio: number, internalResolution: {
+        width: number;
+        height: number;
+    } | undefined, fullscreen: boolean, bodyBackground: string | undefined, container: HTMLElement, containerId?: string | undefined, canvas?: HTMLCanvasElement | undefined);
+}
+export declare function createDefaultGameConfig(base?: Partial<Pick<GameConfig, 'id' | 'debug' | 'time' | 'input'>> & {
+    stages?: StageInterface[];
+    globals?: Record<string, any>;
+}): GameConfig;
+export declare function resolveGameConfig(user?: GameConfigLike): GameConfig;
+/**
+ * Factory for authoring configuration objects in user code.
+ * Returns a plain object that can be passed to `game(...)`.
+ */
+export declare function gameConfig(config: GameConfigLike): GameConfigLike;
+//# sourceMappingURL=game-config.d.ts.map

package/dist/lib/game/game-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-config.d.ts","sourceRoot":"","sources":["../../../src/lib/game/game-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAA0D,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAElH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,eAAe,CAAC;IACvB,0CAA0C;IAC1C,WAAW,EAAE,gBAAgB,GAAG,MAAM,OAAO,WAAW,CAAC;IACzD,oDAAoD;IACpD,MAAM,EAAE,cAAc,CAAC;IACvB,4FAA4F;IAC5F,UAAU,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,UAAU,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,SAAS,EAAE,WAAW,CAAC;IACvB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,MAAM,EAAE,iBAAiB,CAAC;CAC1B,CAAC,CAAC;AAEH,qBAAa,UAAU;IAEd,EAAE,EAAE,MAAM;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC5B,MAAM,EAAE,cAAc,EAAE;IACxB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,eAAe,GAAG,SAAS;IAClC,WAAW,EAAE,MAAM;IACnB,kBAAkB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IACjE,UAAU,EAAE,OAAO;IACnB,cAAc,EAAE,MAAM,GAAG,SAAS;IAClC,SAAS,EAAE,WAAW;IACtB,WAAW,CAAC,EAAE,MAAM;IACpB,MAAM,CAAC,EAAE,iBAAiB;gBAZ1B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,MAAM,EAAE,cAAc,EAAE,EACxB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,eAAe,GAAG,SAAS,EAClC,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,EACjE,UAAU,EAAE,OAAO,EACnB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,SAAS,EAAE,WAAW,EACtB,WAAW,CAAC,EAAE,MAAM,YAAA,EACpB,MAAM,CAAC,EAAE,iBAAiB,YAAA;CAElC;AAkBD,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,GAAG,UAAU,CAkBtL;AAED,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,UAAU,CAoEnE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAEjE"}

package/dist/lib/game/game-config.js

@@ -0,0 +1,79 @@
+import { AspectRatio as p } from "../device/aspect-ratio.js";
+import { getDisplayAspect as b, parseResolution as y, getPresetResolution as R } from "./game-retro-resolutions.js";
+class f {
+  id;
+  globals;
+  stages;
+  debug;
+  time;
+  input;
+  aspectRatio;
+  internalResolution;
+  fullscreen;
+  bodyBackground;
+  container;
+  containerId;
+  canvas;
+  constructor(i, o, n, e, l, d, r, a, g, c, s, h, m) {
+    this.id = i, this.globals = o, this.stages = n, this.debug = e, this.time = l, this.input = d, this.aspectRatio = r, this.internalResolution = a, this.fullscreen = g, this.bodyBackground = c, this.container = s, this.containerId = h, this.canvas = m;
+  }
+}
+function u(t, i) {
+  if (i)
+    return i;
+  if (t) {
+    const e = document.getElementById(t);
+    if (e)
+      return e;
+  }
+  const o = t || "zylem-root", n = document.createElement("main");
+  return n.setAttribute("id", o), n.style.position = "relative", n.style.width = "100%", n.style.height = "100%", document.body.appendChild(n), n;
+}
+function B(t) {
+  const i = t?.id ?? "zylem", o = u(i);
+  return new f(i, t?.globals ?? {}, t?.stages ?? [], !!t?.debug, t?.time ?? 0, t?.input, p.SixteenByNine, void 0, !0, "#000000", o, i, void 0);
+}
+function C(t) {
+  const i = B({
+    id: t?.id ?? "zylem",
+    debug: !!t?.debug,
+    time: t?.time ?? 0,
+    input: t?.input,
+    stages: t?.stages ?? [],
+    globals: t?.globals ?? {}
+  }), o = t?.containerId ?? i.containerId, n = u(o, t?.container ?? null), e = t?.aspectRatio;
+  let l = i.aspectRatio;
+  if (typeof e == "number" || e && typeof e == "string")
+    l = typeof e == "number" ? e : p[e] ?? i.aspectRatio;
+  else if (t?.preset)
+    try {
+      l = b(t.preset) || i.aspectRatio;
+    } catch {
+      l = i.aspectRatio;
+    }
+  const d = t?.fullscreen ?? i.fullscreen, r = t?.bodyBackground ?? i.bodyBackground;
+  let a;
+  if (t?.resolution) {
+    if (typeof t.resolution == "string") {
+      const c = y(t.resolution);
+      if (c && (a = c), !a && t.preset) {
+        const s = R(t.preset, t.resolution);
+        s && (a = { width: s.width, height: s.height });
+      }
+    } else if (typeof t.resolution == "object") {
+      const c = t.resolution.width, s = t.resolution.height;
+      Number.isFinite(c) && Number.isFinite(s) && (a = { width: c, height: s });
+    }
+  }
+  const g = t?.canvas ?? void 0;
+  return new f(t?.id ?? i.id, t?.globals ?? i.globals, t?.stages ?? i.stages, !!(t?.debug ?? i.debug), t?.time ?? i.time, t?.input ?? i.input, l, a, d, r, n, o, g);
+}
+function k(t) {
+  return { ...t };
+}
+export {
+  f as GameConfig,
+  B as createDefaultGameConfig,
+  k as gameConfig,
+  C as resolveGameConfig
+};

package/dist/lib/game/game-default.d.ts

@@ -0,0 +1,19 @@
+import { Stage } from '../stage/stage';
+import type { BasicTypes, BaseGlobals, ZylemGameConfig, GameInputConfig } from './game-interfaces';
+export declare const gameDefaultsState: Partial<ZylemGameConfig<Stage, any, BaseGlobals>>;
+/** Replace multiple defaults at once (shallow merge). */
+export declare function setGameDefaults(partial: Partial<ZylemGameConfig<Stage, any, BaseGlobals>>): void;
+/** Reset defaults back to library defaults. */
+export declare function resetGameDefaults(): void;
+/**
+ * Get a plain object copy of the current defaults.
+ */
+export declare function getGameDefaultConfig<TGlobals extends Record<string, BasicTypes> = BaseGlobals>(): {
+    id: string;
+    globals: TGlobals;
+    stages: Stage[];
+    debug?: boolean;
+    time?: number;
+    input?: GameInputConfig;
+};
+//# sourceMappingURL=game-default.d.ts.map

package/dist/lib/game/game-default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-default.d.ts","sourceRoot":"","sources":["../../../src/lib/game/game-default.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAmBnG,eAAO,MAAM,iBAAiB,mDAE7B,CAAC;AAEF,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,GAAG,IAAI,CAEhG;AAED,+CAA+C;AAC/C,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,WAAW,KAAK;IAClG,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,QAAQ,CAAC;IAClB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,eAAe,CAAC;CACxB,CASA"}

package/dist/lib/game/game-default.js

@@ -0,0 +1,24 @@
+import { proxy as i } from "valtio/vanilla";
+import { stage as e } from "../stage/stage.js";
+const a = () => ({
+  id: "zylem",
+  globals: {},
+  stages: [e()],
+  debug: !1,
+  time: 0,
+  input: void 0
+}), t = i({ ...a() });
+function g() {
+  return {
+    id: t.id ?? "zylem",
+    globals: t.globals ?? {},
+    stages: t.stages ?? [e()],
+    debug: t.debug,
+    time: t.time,
+    input: t.input
+  };
+}
+export {
+  t as gameDefaultsState,
+  g as getGameDefaultConfig
+};

package/dist/lib/game/game-interfaces.d.ts

@@ -1,6 +1,6 @@
 import { UpdateFunction } from "../core/base-node-life-cycle";
 export type BasicTypes = number | string | boolean;
-export type GlobalVariablesType = Record<string, BasicTypes>;
+export type BaseGlobals = Record<string, BasicTypes>;
 export type KeyboardMapping = Record<string, string[]>;
 export type MouseMapping = Record<string, string[]>;
 export interface GameInputPlayerConfig {
@@ -17,7 +17,7 @@ export interface GameInputConfig {
     p7?: GameInputPlayerConfig;
     p8?: GameInputPlayerConfig;
 }
-export interface ZylemGameConfig<StageInterface, GameInterface, TGlobals extends Record<string, BasicTypes> = GlobalVariablesType> {
+export interface ZylemGameConfig<StageInterface, GameInterface, TGlobals extends BaseGlobals> {
     id: string;
     globals?: TGlobals;
     stages?: StageInterface[];
@@ -26,3 +26,4 @@ export interface ZylemGameConfig<StageInterface, GameInterface, TGlobals extends
     time?: number;
     input?: GameInputConfig;
 }
+//# sourceMappingURL=game-interfaces.d.ts.map

package/dist/lib/game/game-interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-interfaces.d.ts","sourceRoot":"","sources":["../../../src/lib/game/game-interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACnD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAErD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACrC,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,KAAK,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,EAAE,CAAC,EAAE,qBAAqB,CAAC;IAC3B,EAAE,CAAC,EAAE,qBAAqB,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe,CAAC,cAAc,EAAE,aAAa,EAAE,QAAQ,SAAS,WAAW;IAC3F,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,eAAe,CAAC;CACxB"}