ttpg-darrell 1.0.2 → 1.0.4

package/build/cjs/layout/layout-objects.d.ts

@@ -1,4 +1,5 @@
 import { StaticObject, Vector } from "@tabletop-playground/api";
+import { TriggerableMulticastDelegate } from "../triggerable-multicast-delegate/triggerable-multicast-delegate";
 export type LayoutObjectsSize = {
     w: number;
     h: number;
@@ -11,6 +12,8 @@ export declare class LayoutObjects {
     private _isVertical;
     private _overrideHeight;
     private _overrideWidth;
+    private _layoutCenter;
+    readonly afterLayout: TriggerableMulticastDelegate<unknown>;
     constructor();
     setChildDistanace(value: number): this;
     setHorizontalAlignment(value: number): this;
@@ -19,6 +22,7 @@ export declare class LayoutObjects {
     setOverrideHeight(value: number): this;
     setOverrideWidth(value: number): this;
     add(item: StaticObject | LayoutObjects): this;
+    flip(flipH: boolean, flipV: boolean): this;
     /**
      * Get size of self, applying any overrides.
      *
@@ -33,6 +37,7 @@ export declare class LayoutObjects {
     calculateChildrenSize(): LayoutObjectsSize;
     static _calculateChildSize(child: StaticObject | LayoutObjects): LayoutObjectsSize;
     doLayoutAtPoint(center: Vector, yaw: number): this;
+    getCenter(): Vector;
     layoutLeftOf(peer: StaticObject, gap: number): this;
     layoutRightOf(peer: StaticObject, gap: number): this;
     layoutAbove(peer: StaticObject, gap: number): this;

package/build/cjs/layout/layout-objects.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LayoutObjects = void 0;
 const api_1 = require("@tabletop-playground/api");
+const triggerable_multicast_delegate_1 = require("../triggerable-multicast-delegate/triggerable-multicast-delegate");
 class LayoutObjects {
     constructor() {
         this._children = [];
@@ -11,6 +12,8 @@ class LayoutObjects {
         this._isVertical = false;
         this._overrideHeight = 0;
         this._overrideWidth = 0;
+        this._layoutCenter = new api_1.Vector(0, 0, 0);
+        this.afterLayout = new triggerable_multicast_delegate_1.TriggerableMulticastDelegate();
     }
     setChildDistanace(value) {
         this._childDistance = value;
@@ -41,6 +44,36 @@ class LayoutObjects {
         this._children.push(item);
         return this;
     }
+    flip(flipH, flipV) {
+        // Children.
+        if ((flipH && !this._isVertical) || (flipV && this._isVertical)) {
+            this._children.reverse();
+        }
+        // Layout.
+        if (flipH) {
+            if (this._horizontalAlignment === api_1.HorizontalAlignment.Left) {
+                this._horizontalAlignment = api_1.HorizontalAlignment.Right;
+            }
+            else if (this._horizontalAlignment === api_1.HorizontalAlignment.Right) {
+                this._horizontalAlignment = api_1.HorizontalAlignment.Left;
+            }
+        }
+        if (flipV) {
+            if (this._verticalAlignment === api_1.VerticalAlignment.Top) {
+                this._verticalAlignment = api_1.VerticalAlignment.Bottom;
+            }
+            else if (this._verticalAlignment === api_1.VerticalAlignment.Bottom) {
+                this._verticalAlignment = api_1.VerticalAlignment.Top;
+            }
+        }
+        // Recurse.
+        for (const child of this._children) {
+            if (child instanceof LayoutObjects) {
+                child.flip(flipH, flipV);
+            }
+        }
+        return this;
+    }
     /**
      * Get size of self, applying any overrides.
      *
@@ -99,34 +132,61 @@ class LayoutObjects {
         return childSize;
     }
     doLayoutAtPoint(center, yaw) {
-        const size = this.calculateSize();
+        this._layoutCenter = center;
+        const overrideSize = this.calculateSize();
         const childrenSize = this.calculateChildrenSize();
+        // Position accounting for override size.
         let padLeft;
+        let padTop;
         if (this._horizontalAlignment === api_1.HorizontalAlignment.Left) {
             padLeft = 0;
         }
         else if (this._horizontalAlignment === api_1.HorizontalAlignment.Right) {
-            padLeft = size.w - childrenSize.w;
+            padLeft = overrideSize.w - childrenSize.w;
         }
         else {
-            padLeft = (size.w - childrenSize.w) / 2; // center (even if "Fill")
+            padLeft = (overrideSize.w - childrenSize.w) / 2; // center (even if "Fill")
         }
-        let padTop;
         if (this._verticalAlignment === api_1.VerticalAlignment.Top) {
             padTop = 0;
         }
         else if (this._verticalAlignment === api_1.VerticalAlignment.Bottom) {
-            padTop = size.w - childrenSize.w;
+            padTop = overrideSize.h - childrenSize.h;
         }
         else {
-            padTop = (size.w - childrenSize.w) / 2; // center (even if "Fill")
+            padTop = (overrideSize.h - childrenSize.h) / 2; // center (even if "Fill")
         }
-        let left = -size.w / 2 + padLeft;
-        let top = -size.h / 2 + padTop;
+        let left = -overrideSize.w / 2 + padLeft;
+        let top = overrideSize.h / 2 - padTop;
         for (const child of this._children) {
             const childSize = LayoutObjects._calculateChildSize(child);
+            // Apply layout in row/col.
+            padLeft = 0;
+            padTop = 0;
+            if (this._isVertical) {
+                if (this._horizontalAlignment === api_1.HorizontalAlignment.Left) {
+                    padLeft = 0;
+                }
+                else if (this._horizontalAlignment === api_1.HorizontalAlignment.Right) {
+                    padLeft = childrenSize.w - childSize.w;
+                }
+                else {
+                    padLeft = (childrenSize.w - childSize.w) / 2; // center (even if "Fill")
+                }
+            }
+            else {
+                if (this._verticalAlignment === api_1.VerticalAlignment.Top) {
+                    padTop = 0;
+                }
+                else if (this._verticalAlignment === api_1.VerticalAlignment.Bottom) {
+                    padTop = childrenSize.h - childSize.h;
+                }
+                else {
+                    padTop = (childrenSize.h - childSize.h) / 2; // center (even if "Fill")
+                }
+            }
             // Calculate child center (world).
-            const childCenter = new api_1.Vector(top + childSize.h / 2, left + childSize.w / 2, 0)
+            const childCenter = new api_1.Vector(top - childSize.h / 2 - padTop, left + childSize.w / 2 + padLeft, 0)
                 .rotateAngleAxis(yaw, [0, 0, 1])
                 .add(center);
             // Position child.
@@ -139,14 +199,18 @@ class LayoutObjects {
             }
             // Move "cursor" to next open spot top-left.
             if (this._isVertical) {
-                top += childSize.h + this._childDistance;
+                top -= childSize.h + this._childDistance;
             }
             else {
                 left += childSize.w + this._childDistance;
             }
         }
+        this.afterLayout.trigger();
         return this;
     }
+    getCenter() {
+        return this._layoutCenter;
+    }
     layoutLeftOf(peer, gap) {
         const peerSize = LayoutObjects._calculateChildSize(peer);
         const size = this.calculateSize();

package/build/cjs/spawn/spawn.d.ts

@@ -5,6 +5,7 @@ import { GameObject, Vector } from "@tabletop-playground/api";
 export declare abstract class Spawn {
     private static _nsidToTemplateId;
     static spawn(nsid: string, position: Vector | [x: number, y: number, z: number]): GameObject | undefined;
+    static spawnOrThrow(nsid: string, position: Vector | [x: number, y: number, z: number]): GameObject;
     static inject(dict: {
         [key: string]: string;
     }): void;

package/build/cjs/spawn/spawn.js

@@ -9,11 +9,18 @@ class Spawn {
     static spawn(nsid, position) {
         const templateId = Spawn._nsidToTemplateId[nsid];
         if (!templateId) {
-            throw new Error(`spawn nsid "${nsid}" has no templateId`);
+            return undefined;
         }
         const obj = api_1.world.createObjectFromTemplate(templateId, position);
         return obj;
     }
+    static spawnOrThrow(nsid, position) {
+        const obj = Spawn.spawn(nsid, position);
+        if (!obj) {
+            throw new Error(`spawnOrThrow failed for "${nsid}"`);
+        }
+        return obj;
+    }
     static inject(dict) {
         for (const [k, v] of Object.entries(dict)) {
             Spawn._nsidToTemplateId[k] = v;

package/build/esm/layout/layout-objects.d.ts

@@ -1,4 +1,5 @@
 import { StaticObject, Vector } from "@tabletop-playground/api";
+import { TriggerableMulticastDelegate } from "../triggerable-multicast-delegate/triggerable-multicast-delegate";
 export type LayoutObjectsSize = {
     w: number;
     h: number;
@@ -11,6 +12,8 @@ export declare class LayoutObjects {
     private _isVertical;
     private _overrideHeight;
     private _overrideWidth;
+    private _layoutCenter;
+    readonly afterLayout: TriggerableMulticastDelegate<unknown>;
     constructor();
     setChildDistanace(value: number): this;
     setHorizontalAlignment(value: number): this;
@@ -19,6 +22,7 @@ export declare class LayoutObjects {
     setOverrideHeight(value: number): this;
     setOverrideWidth(value: number): this;
     add(item: StaticObject | LayoutObjects): this;
+    flip(flipH: boolean, flipV: boolean): this;
     /**
      * Get size of self, applying any overrides.
      *
@@ -33,6 +37,7 @@ export declare class LayoutObjects {
     calculateChildrenSize(): LayoutObjectsSize;
     static _calculateChildSize(child: StaticObject | LayoutObjects): LayoutObjectsSize;
     doLayoutAtPoint(center: Vector, yaw: number): this;
+    getCenter(): Vector;
     layoutLeftOf(peer: StaticObject, gap: number): this;
     layoutRightOf(peer: StaticObject, gap: number): this;
     layoutAbove(peer: StaticObject, gap: number): this;

package/build/esm/layout/layout-objects.js

@@ -1,4 +1,5 @@
 import { HorizontalAlignment, StaticObject, Vector, VerticalAlignment, } from "@tabletop-playground/api";
+import { TriggerableMulticastDelegate } from "../triggerable-multicast-delegate/triggerable-multicast-delegate";
 export class LayoutObjects {
     constructor() {
         this._children = [];
@@ -8,6 +9,8 @@ export class LayoutObjects {
         this._isVertical = false;
         this._overrideHeight = 0;
         this._overrideWidth = 0;
+        this._layoutCenter = new Vector(0, 0, 0);
+        this.afterLayout = new TriggerableMulticastDelegate();
     }
     setChildDistanace(value) {
         this._childDistance = value;
@@ -38,6 +41,36 @@ export class LayoutObjects {
         this._children.push(item);
         return this;
     }
+    flip(flipH, flipV) {
+        // Children.
+        if ((flipH && !this._isVertical) || (flipV && this._isVertical)) {
+            this._children.reverse();
+        }
+        // Layout.
+        if (flipH) {
+            if (this._horizontalAlignment === HorizontalAlignment.Left) {
+                this._horizontalAlignment = HorizontalAlignment.Right;
+            }
+            else if (this._horizontalAlignment === HorizontalAlignment.Right) {
+                this._horizontalAlignment = HorizontalAlignment.Left;
+            }
+        }
+        if (flipV) {
+            if (this._verticalAlignment === VerticalAlignment.Top) {
+                this._verticalAlignment = VerticalAlignment.Bottom;
+            }
+            else if (this._verticalAlignment === VerticalAlignment.Bottom) {
+                this._verticalAlignment = VerticalAlignment.Top;
+            }
+        }
+        // Recurse.
+        for (const child of this._children) {
+            if (child instanceof LayoutObjects) {
+                child.flip(flipH, flipV);
+            }
+        }
+        return this;
+    }
     /**
      * Get size of self, applying any overrides.
      *
@@ -96,34 +129,61 @@ export class LayoutObjects {
         return childSize;
     }
     doLayoutAtPoint(center, yaw) {
-        const size = this.calculateSize();
+        this._layoutCenter = center;
+        const overrideSize = this.calculateSize();
         const childrenSize = this.calculateChildrenSize();
+        // Position accounting for override size.
         let padLeft;
+        let padTop;
         if (this._horizontalAlignment === HorizontalAlignment.Left) {
             padLeft = 0;
         }
         else if (this._horizontalAlignment === HorizontalAlignment.Right) {
-            padLeft = size.w - childrenSize.w;
+            padLeft = overrideSize.w - childrenSize.w;
         }
         else {
-            padLeft = (size.w - childrenSize.w) / 2; // center (even if "Fill")
+            padLeft = (overrideSize.w - childrenSize.w) / 2; // center (even if "Fill")
         }
-        let padTop;
         if (this._verticalAlignment === VerticalAlignment.Top) {
             padTop = 0;
         }
         else if (this._verticalAlignment === VerticalAlignment.Bottom) {
-            padTop = size.w - childrenSize.w;
+            padTop = overrideSize.h - childrenSize.h;
         }
         else {
-            padTop = (size.w - childrenSize.w) / 2; // center (even if "Fill")
+            padTop = (overrideSize.h - childrenSize.h) / 2; // center (even if "Fill")
         }
-        let left = -size.w / 2 + padLeft;
-        let top = -size.h / 2 + padTop;
+        let left = -overrideSize.w / 2 + padLeft;
+        let top = overrideSize.h / 2 - padTop;
         for (const child of this._children) {
             const childSize = LayoutObjects._calculateChildSize(child);
+            // Apply layout in row/col.
+            padLeft = 0;
+            padTop = 0;
+            if (this._isVertical) {
+                if (this._horizontalAlignment === HorizontalAlignment.Left) {
+                    padLeft = 0;
+                }
+                else if (this._horizontalAlignment === HorizontalAlignment.Right) {
+                    padLeft = childrenSize.w - childSize.w;
+                }
+                else {
+                    padLeft = (childrenSize.w - childSize.w) / 2; // center (even if "Fill")
+                }
+            }
+            else {
+                if (this._verticalAlignment === VerticalAlignment.Top) {
+                    padTop = 0;
+                }
+                else if (this._verticalAlignment === VerticalAlignment.Bottom) {
+                    padTop = childrenSize.h - childSize.h;
+                }
+                else {
+                    padTop = (childrenSize.h - childSize.h) / 2; // center (even if "Fill")
+                }
+            }
             // Calculate child center (world).
-            const childCenter = new Vector(top + childSize.h / 2, left + childSize.w / 2, 0)
+            const childCenter = new Vector(top - childSize.h / 2 - padTop, left + childSize.w / 2 + padLeft, 0)
                 .rotateAngleAxis(yaw, [0, 0, 1])
                 .add(center);
             // Position child.
@@ -136,14 +196,18 @@ export class LayoutObjects {
             }
             // Move "cursor" to next open spot top-left.
             if (this._isVertical) {
-                top += childSize.h + this._childDistance;
+                top -= childSize.h + this._childDistance;
             }
             else {
                 left += childSize.w + this._childDistance;
             }
         }
+        this.afterLayout.trigger();
         return this;
     }
+    getCenter() {
+        return this._layoutCenter;
+    }
     layoutLeftOf(peer, gap) {
         const peerSize = LayoutObjects._calculateChildSize(peer);
         const size = this.calculateSize();

package/build/esm/spawn/spawn.d.ts

@@ -5,6 +5,7 @@ import { GameObject, Vector } from "@tabletop-playground/api";
 export declare abstract class Spawn {
     private static _nsidToTemplateId;
     static spawn(nsid: string, position: Vector | [x: number, y: number, z: number]): GameObject | undefined;
+    static spawnOrThrow(nsid: string, position: Vector | [x: number, y: number, z: number]): GameObject;
     static inject(dict: {
         [key: string]: string;
     }): void;

package/build/esm/spawn/spawn.js

@@ -6,11 +6,18 @@ export class Spawn {
     static spawn(nsid, position) {
         const templateId = Spawn._nsidToTemplateId[nsid];
         if (!templateId) {
-            throw new Error(`spawn nsid "${nsid}" has no templateId`);
+            return undefined;
         }
         const obj = world.createObjectFromTemplate(templateId, position);
         return obj;
     }
+    static spawnOrThrow(nsid, position) {
+        const obj = Spawn.spawn(nsid, position);
+        if (!obj) {
+            throw new Error(`spawnOrThrow failed for "${nsid}"`);
+        }
+        return obj;
+    }
     static inject(dict) {
         for (const [k, v] of Object.entries(dict)) {
             Spawn._nsidToTemplateId[k] = v;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ttpg-darrell",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "TTPG TypeScript library",
   "main": "./build/cjs/index.js",
   "module": "./build/esm/index.js",