@vworlds/vecs-phaser 1.0.35 → 1.0.37

package/catalog.d.ts

@@ -0,0 +1,39 @@
+/** Base identity for any catalog asset. New kinds extend this; the base never changes. */
+export interface AssetDescriptor {
+    /** Wire id (stable, append-only). */
+    id: number;
+    /** Author key, authoring/debug only. */
+    key: string;
+    /** Discriminant; narrowed by each subtype to its literal. */
+    kind: string;
+}
+/** A Tiled-tileset-backed spritesheet asset the client loads via Phaser's spritesheet loader. */
+export interface SpritesheetDescriptor extends AssetDescriptor {
+    /** Spritesheet catalog discriminant. */
+    kind: "spritesheet";
+    /** HTTP url the client loads the source image from. */
+    url: string;
+    /** Tile width (px). */
+    frameWidth: number;
+    /** Tile height (px). */
+    frameHeight: number;
+    /** Tileset margin (px). */
+    margin: number;
+    /** Tile spacing (px). */
+    spacing: number;
+    /** Tiles per row. */
+    columns: number;
+    /** Total frames. */
+    tileCount: number;
+    /** Source image width (px). */
+    imageWidth: number;
+    /** Source image height (px). */
+    imageHeight: number;
+}
+/** Per-world asset catalog served as JSON over HTTP. */
+export interface AssetCatalog {
+    /** Name of the world this catalog describes. */
+    worldName: string;
+    /** Heterogeneous asset descriptors; clients narrow per element via `kind`. */
+    assets: AssetDescriptor[];
+}

package/catalog.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=catalog.js.map

package/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":""}

package/components/image.d.ts

@@ -0,0 +1,7 @@
+/** Textured renderable. Both fields index the asset catalog. */
+export declare class Image {
+    /** Resource id of the source texture (image or spritesheet). */
+    texture: number;
+    /** Frame index within a spritesheet/tileset. */
+    frame: number;
+}

package/components/image.js

@@ -0,0 +1,28 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { type as wireType } from "@vworlds/vecs-wire";
+/** Textured renderable. Both fields index the asset catalog. */
+export class Image {
+    constructor() {
+        /** Resource id of the source texture (image or spritesheet). */
+        this.texture = 0;
+        /** Frame index within a spritesheet/tileset. */
+        this.frame = 0;
+    }
+}
+__decorate([
+    wireType("u32"),
+    __metadata("design:type", Object)
+], Image.prototype, "texture", void 0);
+__decorate([
+    wireType("u16"),
+    __metadata("design:type", Object)
+], Image.prototype, "frame", void 0);
+//# sourceMappingURL=image.js.map

package/components/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../src/components/image.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEtD,gEAAgE;AAChE,MAAM,OAAO,KAAK;IAAlB;QACE,gEAAgE;QAEzD,YAAO,GAAG,CAAC,CAAC;QAEnB,gDAAgD;QAEzC,UAAK,GAAG,CAAC,CAAC;IACnB,CAAC;CAAA;AALQ;IADN,QAAQ,CAAC,KAAK,CAAC;;sCACG;AAIZ;IADN,QAAQ,CAAC,KAAK,CAAC;;oCACC"}

package/components/style.d.ts

@@ -1,3 +1,4 @@
+import { Decoder, Encoder } from "@vworlds/vecs-wire";
 /** Fill color (RGB integer, e.g. 0xff0000) and opacity 0..1. */
 export declare class FillStyle {
     color: number;
@@ -10,3 +11,26 @@ export declare class StrokeStyle {
     /** Line width in screen pixels. */
     width: number;
 }
+/**
+ * Multiplicative tint, one color per GameObject corner (top-left, top-right,
+ * bottom-left, bottom-right). White (0xffffff) = no tint.
+ *
+ * Two wire modes keep the encoding efficient:
+ * - **Monochromatic** (`monochromatic = true`): one u32 applies to all four
+ *   corners. Set via the `value` setter (writes all four corners and flips the
+ *   flag) or by constructing with identical corners.
+ * - **Polychromatic** (`monochromatic = false`): four independent u32 corners.
+ *   Set the corner fields directly.
+ */
+export declare class Tint {
+    topLeft: number;
+    topRight: number;
+    bottomLeft: number;
+    bottomRight: number;
+    monochromatic: boolean;
+    /** Uniform tint color; writing it sets all four corners and `monochromatic = true`. */
+    get value(): number;
+    set value(color: number);
+    wireEncode(encoder: Encoder): void;
+    static wireDecode(decoder: Decoder): Tint;
+}

package/components/style.js

@@ -44,4 +44,63 @@ __decorate([
     wireType("f32"),
     __metadata("design:type", Object)
 ], StrokeStyle.prototype, "width", void 0);
+/**
+ * Multiplicative tint, one color per GameObject corner (top-left, top-right,
+ * bottom-left, bottom-right). White (0xffffff) = no tint.
+ *
+ * Two wire modes keep the encoding efficient:
+ * - **Monochromatic** (`monochromatic = true`): one u32 applies to all four
+ *   corners. Set via the `value` setter (writes all four corners and flips the
+ *   flag) or by constructing with identical corners.
+ * - **Polychromatic** (`monochromatic = false`): four independent u32 corners.
+ *   Set the corner fields directly.
+ */
+export class Tint {
+    constructor() {
+        this.topLeft = 0xffffff;
+        this.topRight = 0xffffff;
+        this.bottomLeft = 0xffffff;
+        this.bottomRight = 0xffffff;
+        this.monochromatic = true;
+    }
+    /** Uniform tint color; writing it sets all four corners and `monochromatic = true`. */
+    get value() {
+        return this.topLeft;
+    }
+    set value(color) {
+        this.topLeft = color;
+        this.topRight = color;
+        this.bottomLeft = color;
+        this.bottomRight = color;
+        this.monochromatic = true;
+    }
+    wireEncode(encoder) {
+        encoder.write_bool(this.monochromatic);
+        if (this.monochromatic) {
+            encoder.write_u32(this.topLeft);
+            return;
+        }
+        encoder.write_u32(this.topLeft);
+        encoder.write_u32(this.topRight);
+        encoder.write_u32(this.bottomLeft);
+        encoder.write_u32(this.bottomRight);
+    }
+    static wireDecode(decoder) {
+        const t = new Tint();
+        t.monochromatic = decoder.read_bool();
+        if (t.monochromatic) {
+            const c = decoder.read_u32();
+            t.topLeft = c;
+            t.topRight = c;
+            t.bottomLeft = c;
+            t.bottomRight = c;
+            return t;
+        }
+        t.topLeft = decoder.read_u32();
+        t.topRight = decoder.read_u32();
+        t.bottomLeft = decoder.read_u32();
+        t.bottomRight = decoder.read_u32();
+        return t;
+    }
+}
 //# sourceMappingURL=style.js.map

package/components/style.js.map

@@ -1 +1 @@
-{"version":3,"file":"style.js","sourceRoot":"","sources":["../../src/components/style.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEtD,gEAAgE;AAChE,MAAM,OAAO,SAAS;IAAtB;QAES,UAAK,GAAG,QAAQ,CAAC;QAGjB,UAAK,GAAG,CAAC,CAAC;IACnB,CAAC;CAAA;AAJQ;IADN,QAAQ,CAAC,KAAK,CAAC;;wCACQ;AAGjB;IADN,QAAQ,CAAC,KAAK,CAAC;;wCACC;AAGnB,iFAAiF;AACjF,MAAM,OAAO,WAAW;IAAxB;QAES,UAAK,GAAG,QAAQ,CAAC;QAGjB,UAAK,GAAG,CAAC,CAAC;QAEjB,mCAAmC;QAE5B,UAAK,GAAG,CAAC,CAAC;IACnB,CAAC;CAAA;AARQ;IADN,QAAQ,CAAC,KAAK,CAAC;;0CACQ;AAGjB;IADN,QAAQ,CAAC,KAAK,CAAC;;0CACC;AAIV;IADN,QAAQ,CAAC,KAAK,CAAC;;0CACC"}
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../../src/components/style.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEtD,gEAAgE;AAChE,MAAM,OAAO,SAAS;IAAtB;QAES,UAAK,GAAG,QAAQ,CAAC;QAGjB,UAAK,GAAG,CAAC,CAAC;IACnB,CAAC;CAAA;AAJQ;IADN,QAAQ,CAAC,KAAK,CAAC;;wCACQ;AAGjB;IADN,QAAQ,CAAC,KAAK,CAAC;;wCACC;AAGnB,iFAAiF;AACjF,MAAM,OAAO,WAAW;IAAxB;QAES,UAAK,GAAG,QAAQ,CAAC;QAGjB,UAAK,GAAG,CAAC,CAAC;QAEjB,mCAAmC;QAE5B,UAAK,GAAG,CAAC,CAAC;IACnB,CAAC;CAAA;AARQ;IADN,QAAQ,CAAC,KAAK,CAAC;;0CACQ;AAGjB;IADN,QAAQ,CAAC,KAAK,CAAC;;0CACC;AAIV;IADN,QAAQ,CAAC,KAAK,CAAC;;0CACC;AAGnB;;;;;;;;;;GAUG;AACH,MAAM,OAAO,IAAI;IAAjB;QACS,YAAO,GAAG,QAAQ,CAAC;QACnB,aAAQ,GAAG,QAAQ,CAAC;QACpB,eAAU,GAAG,QAAQ,CAAC;QACtB,gBAAW,GAAG,QAAQ,CAAC;QACvB,kBAAa,GAAG,IAAI,CAAC;IA4C9B,CAAC;IA1CC,uFAAuF;IACvF,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAW,KAAK,CAAC,KAAa;QAC5B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAEM,UAAU,CAAC,OAAgB;QAChC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAChC,OAAO;QACT,CAAC;QACD,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAEM,MAAM,CAAC,UAAU,CAAC,OAAgB;QACvC,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,CAAC,CAAC,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC7B,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;YACf,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;YACjB,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC;YAClB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC/B,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAChC,CAAC,CAAC,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAClC,CAAC,CAAC,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnC,OAAO,CAAC,CAAC;IACX,CAAC;CACF"}

package/index.d.ts

@@ -1,9 +1,12 @@
 export { Alpha, Depth, Position, Rotation, Scale } from "./components/transform.js";
-export { FillStyle, StrokeStyle } from "./components/style.js";
+export { FillStyle, StrokeStyle, Tint } from "./components/style.js";
+export { Image } from "./components/image.js";
+export type { AssetCatalog, AssetDescriptor, SpritesheetDescriptor } from "./catalog.js";
 export { Arc, Ellipse, Line, Polygon, Rectangle, Size, Star, Triangle, } from "./components/shapes.js";
 export { Text, TextAlign } from "./components/text.js";
 import { Alpha, Depth, Position, Rotation, Scale } from "./components/transform.js";
-import { FillStyle, StrokeStyle } from "./components/style.js";
+import { FillStyle, StrokeStyle, Tint } from "./components/style.js";
+import { Image } from "./components/image.js";
 import { Arc, Ellipse, Line, Polygon, Rectangle, Size, Star, Triangle } from "./components/shapes.js";
 import { Text } from "./components/text.js";
 /**
@@ -25,13 +28,15 @@ import { Text } from "./components/text.js";
  *  12  Line
  *  13  Triangle
  *  14  Star
- *  15  Text
- *  16  Size
+ *   15  Text
+ *   16  Size
+ *   17  Image
+ *   18  Tint
  */
-export declare const phaserNetworkComponents: readonly [typeof Position, typeof Rotation, typeof Scale, typeof Alpha, typeof Depth, typeof FillStyle, typeof StrokeStyle, typeof Arc, typeof Ellipse, typeof Rectangle, typeof Polygon, typeof Line, typeof Triangle, typeof Star, typeof Text, typeof Size];
+export declare const phaserNetworkComponents: readonly [typeof Position, typeof Rotation, typeof Scale, typeof Alpha, typeof Depth, typeof FillStyle, typeof StrokeStyle, typeof Arc, typeof Ellipse, typeof Rectangle, typeof Polygon, typeof Line, typeof Triangle, typeof Star, typeof Text, typeof Size, typeof Image, typeof Tint];
 /**
  * The subset of network components that represent renderable shapes.
  * Exactly one of these should be present on each renderable entity.
  * Order matches phaserNetworkComponents (shapes section).
  */
-export declare const phaserRenderableComponents: readonly [typeof Arc, typeof Ellipse, typeof Rectangle, typeof Polygon, typeof Line, typeof Triangle, typeof Star, typeof Text];
+export declare const phaserRenderableComponents: readonly [typeof Arc, typeof Ellipse, typeof Rectangle, typeof Polygon, typeof Line, typeof Triangle, typeof Star, typeof Text, typeof Image];

package/index.js

@@ -1,9 +1,11 @@
 export { Alpha, Depth, Position, Rotation, Scale } from "./components/transform.js";
-export { FillStyle, StrokeStyle } from "./components/style.js";
+export { FillStyle, StrokeStyle, Tint } from "./components/style.js";
+export { Image } from "./components/image.js";
 export { Arc, Ellipse, Line, Polygon, Rectangle, Size, Star, Triangle, } from "./components/shapes.js";
 export { Text, TextAlign } from "./components/text.js";
 import { Alpha, Depth, Position, Rotation, Scale } from "./components/transform.js";
-import { FillStyle, StrokeStyle } from "./components/style.js";
+import { FillStyle, StrokeStyle, Tint } from "./components/style.js";
+import { Image } from "./components/image.js";
 import { Arc, Ellipse, Line, Polygon, Rectangle, Size, Star, Triangle, } from "./components/shapes.js";
 import { Text } from "./components/text.js";
 /**
@@ -25,8 +27,10 @@ import { Text } from "./components/text.js";
  *  12  Line
  *  13  Triangle
  *  14  Star
- *  15  Text
- *  16  Size
+ *   15  Text
+ *   16  Size
+ *   17  Image
+ *   18  Tint
  */
 export const phaserNetworkComponents = [
     Position,
@@ -45,6 +49,8 @@ export const phaserNetworkComponents = [
     Star,
     Text,
     Size,
+    Image,
+    Tint,
 ];
 /**
  * The subset of network components that represent renderable shapes.
@@ -60,5 +66,6 @@ export const phaserRenderableComponents = [
     Triangle,
     Star,
     Text,
+    Image,
 ];
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EACL,GAAG,EACH,OAAO,EACP,IAAI,EACJ,OAAO,EACP,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,QAAQ,GACT,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EACL,GAAG,EACH,OAAO,EACP,IAAI,EACJ,OAAO,EACP,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,QAAQ,GACT,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,QAAQ;IACR,QAAQ;IACR,KAAK;IACL,KAAK;IACL,KAAK;IACL,SAAS;IACT,WAAW;IACX,GAAG;IACH,OAAO;IACP,SAAS;IACT,OAAO;IACP,IAAI;IACJ,QAAQ;IACR,IAAI;IACJ,IAAI;IACJ,IAAI;CACwC,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,GAAG;IACH,OAAO;IACP,SAAS;IACT,OAAO;IACP,IAAI;IACJ,QAAQ;IACR,IAAI;IACJ,IAAI;CACwC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE9C,OAAO,EACL,GAAG,EACH,OAAO,EACP,IAAI,EACJ,OAAO,EACP,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,QAAQ,GACT,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EACL,GAAG,EACH,OAAO,EACP,IAAI,EACJ,OAAO,EACP,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,QAAQ,GACT,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,QAAQ;IACR,QAAQ;IACR,KAAK;IACL,KAAK;IACL,KAAK;IACL,SAAS;IACT,WAAW;IACX,GAAG;IACH,OAAO;IACP,SAAS;IACT,OAAO;IACP,IAAI;IACJ,QAAQ;IACR,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;CACwC,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,GAAG;IACH,OAAO;IACP,SAAS;IACT,OAAO;IACP,IAAI;IACJ,QAAQ;IACR,IAAI;IACJ,IAAI;IACJ,KAAK;CACuC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vworlds/vecs-phaser",
-  "version": "1.0.35",
+  "version": "1.0.37",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",
@@ -15,8 +15,8 @@
     "url": "git+https://github.com/vworlds/vecs.git"
   },
   "dependencies": {
-    "@vworlds/vecs": "1.0.35",
-    "@vworlds/vecs-wire": "1.0.35"
+    "@vworlds/vecs": "1.0.37",
+    "@vworlds/vecs-wire": "1.0.37"
   },
   "license": "MIT"
 }