ttpg-darrell 1.0.26 → 1.0.28

package/build/cjs/index.d.ts

@@ -1,18 +1,32 @@
-export * from "./error-handler/error-handler";
-export * from "./event/on-card-became-singleton-or-deck";
-export * from "./facing/facing";
-export * from "./garbage/garbage-container";
-export * from "./garbage/simple-card-garbage-handler";
-export * from "./garbage/simple-to-container-handler";
-export * from "./garbage/simple-to-snap-point-handler";
-export * from "./global/abstract-global";
-export * from "./global/context-menu/leave-seat";
-export * from "./locale/locale";
-export * from "./nsid/nsid";
-export * from "./setup/abstract-setup";
-export * from "./setup/layout/layout-objects";
-export * from "./setup/spawn/spawn";
-export * from "./shuffle/shuffle";
-export * from "./triggerable-multicast-delegate/triggerable-multicast-delegate";
-export * from "./ui/object/player-name-take-seat/player-name-take-seat";
-export * from "./ui/widget/d6widget/d6widget";
+export * from "./lib/bug-workarounds/bug-card-holder-assignment";
+export * from "./lib/bug-workarounds/bug-unique-cards";
+export * from "./lib/card-util/card-util";
+export * from "./lib/context-menu/leave-seat";
+export * from "./lib/data-store/data-store";
+export * from "./lib/dice-group/dice-group";
+export * from "./lib/error-handler/error-handler";
+export * from "./lib/event/on-card-became-singleton-or-deck";
+export * from "./lib/event/triggerable-multicast-delegate";
+export * from "./lib/facing/facing";
+export * from "./lib/find/find";
+export * from "./lib/game-object/cardholder-player-name/cardholder-player-name";
+export * from "./lib/game-object/garbage/garbage-container";
+export * from "./lib/game-object/garbage/simple-card-garbage-handler";
+export * from "./lib/game-object/garbage/simple-to-container-handler";
+export * from "./lib/game-object/garbage/simple-to-snap-point-handler";
+export * from "./lib/global/global-init";
+export * from "./lib/layout-objects/layout-objects";
+export * from "./lib/locale/locale";
+export * from "./lib/nsid/nsid";
+export * from "./lib/parse/parse-color";
+export * from "./lib/setup/abstract-setup";
+export * from "./lib/shuffle/shuffle";
+export * from "./lib/spawn/spawn";
+export * from "./lib/turn-order/turn-order";
+export * from "./lib/ui-visibility/ui-visibility";
+export * from "./lib/widget/confirm-button/confirm-button";
+export * from "./lib/widget/d6widget/d6widget";
+export * from "./lib/widget/turn-order-widget/turn-clicked-widget";
+export * from "./lib/widget/turn-order-widget/turn-entry-wart";
+export * from "./lib/widget/turn-order-widget/turn-entry-widget";
+export * from "./lib/widget/turn-order-widget/turn-order-widget";

package/build/cjs/index.js

@@ -14,22 +14,39 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./error-handler/error-handler"), exports);
-__exportStar(require("./event/on-card-became-singleton-or-deck"), exports);
-__exportStar(require("./facing/facing"), exports);
-__exportStar(require("./garbage/garbage-container"), exports);
-__exportStar(require("./garbage/simple-card-garbage-handler"), exports);
-__exportStar(require("./garbage/simple-to-container-handler"), exports);
-__exportStar(require("./garbage/simple-to-snap-point-handler"), exports);
-__exportStar(require("./global/abstract-global"), exports);
-__exportStar(require("./global/context-menu/leave-seat"), exports);
-__exportStar(require("./locale/locale"), exports);
-__exportStar(require("./nsid/nsid"), exports);
-__exportStar(require("./setup/abstract-setup"), exports);
-__exportStar(require("./setup/layout/layout-objects"), exports);
-__exportStar(require("./setup/spawn/spawn"), exports);
-__exportStar(require("./shuffle/shuffle"), exports);
-__exportStar(require("./triggerable-multicast-delegate/triggerable-multicast-delegate"), exports);
-__exportStar(require("./ui/object/player-name-take-seat/player-name-take-seat"), exports);
-__exportStar(require("./ui/widget/d6widget/d6widget"), exports);
+const locale_1 = require("./lib/locale/locale");
+__exportStar(require("./lib/bug-workarounds/bug-card-holder-assignment"), exports);
+__exportStar(require("./lib/bug-workarounds/bug-unique-cards"), exports);
+__exportStar(require("./lib/card-util/card-util"), exports);
+__exportStar(require("./lib/context-menu/leave-seat"), exports);
+__exportStar(require("./lib/data-store/data-store"), exports);
+__exportStar(require("./lib/dice-group/dice-group"), exports);
+__exportStar(require("./lib/error-handler/error-handler"), exports);
+__exportStar(require("./lib/event/on-card-became-singleton-or-deck"), exports);
+__exportStar(require("./lib/event/triggerable-multicast-delegate"), exports);
+__exportStar(require("./lib/facing/facing"), exports);
+__exportStar(require("./lib/find/find"), exports);
+__exportStar(require("./lib/game-object/cardholder-player-name/cardholder-player-name"), exports);
+__exportStar(require("./lib/game-object/garbage/garbage-container"), exports);
+__exportStar(require("./lib/game-object/garbage/simple-card-garbage-handler"), exports);
+__exportStar(require("./lib/game-object/garbage/simple-to-container-handler"), exports);
+__exportStar(require("./lib/game-object/garbage/simple-to-snap-point-handler"), exports);
+__exportStar(require("./lib/global/global-init"), exports);
+__exportStar(require("./lib/layout-objects/layout-objects"), exports);
+__exportStar(require("./lib/locale/locale"), exports);
+__exportStar(require("./lib/nsid/nsid"), exports);
+__exportStar(require("./lib/parse/parse-color"), exports);
+__exportStar(require("./lib/setup/abstract-setup"), exports);
+__exportStar(require("./lib/shuffle/shuffle"), exports);
+__exportStar(require("./lib/spawn/spawn"), exports);
+__exportStar(require("./lib/turn-order/turn-order"), exports);
+__exportStar(require("./lib/ui-visibility/ui-visibility"), exports);
+__exportStar(require("./lib/widget/confirm-button/confirm-button"), exports);
+__exportStar(require("./lib/widget/d6widget/d6widget"), exports);
+__exportStar(require("./lib/widget/turn-order-widget/turn-clicked-widget"), exports);
+__exportStar(require("./lib/widget/turn-order-widget/turn-entry-wart"), exports);
+__exportStar(require("./lib/widget/turn-order-widget/turn-entry-widget"), exports);
+__exportStar(require("./lib/widget/turn-order-widget/turn-order-widget"), exports);
+const locale_data_1 = require("./locale.data");
+locale_1.locale.inject(locale_data_1.DICT);
 //# sourceMappingURL=index.js.map

package/build/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,2EAAyD;AACzD,kDAAgC;AAChC,8DAA4C;AAC5C,wEAAsD;AACtD,wEAAsD;AACtD,yEAAuD;AACvD,2DAAyC;AACzC,mEAAiD;AACjD,kDAAgC;AAChC,8CAA4B;AAC5B,yDAAuC;AACvC,gEAA8C;AAC9C,sDAAoC;AACpC,oDAAkC;AAClC,kGAAgF;AAChF,0FAAwE;AACxE,gEAA8C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA6C;AAE7C,mFAAiE;AACjE,yEAAuD;AACvD,4DAA0C;AAC1C,gEAA8C;AAC9C,8DAA4C;AAC5C,8DAA4C;AAC5C,oEAAkD;AAClD,+EAA6D;AAC7D,6EAA2D;AAC3D,sDAAoC;AACpC,kDAAgC;AAChC,kGAAgF;AAChF,8EAA4D;AAC5D,wFAAsE;AACtE,wFAAsE;AACtE,yFAAuE;AACvE,2DAAyC;AACzC,sEAAoD;AACpD,sDAAoC;AACpC,kDAAgC;AAChC,0DAAwC;AACxC,6DAA2C;AAC3C,wDAAsC;AACtC,oDAAkC;AAClC,8DAA4C;AAC5C,oEAAkD;AAClD,6EAA2D;AAC3D,iEAA+C;AAC/C,qFAAmE;AACnE,iFAA+D;AAC/D,mFAAiE;AACjE,mFAAiE;AAEjE,+CAAqC;AACrC,eAAM,CAAC,MAAM,CAAC,kBAAI,CAAC,CAAC"}

package/build/cjs/lib/broadcast/broadcast.d.ts

@@ -0,0 +1,9 @@
+import { Color, Player } from "@tabletop-playground/api";
+export declare class Broadcast {
+    static get ERROR(): Color;
+    static lastMessage: string;
+    static broadcastAll(message: string, color?: Color | [r: number, g: number, b: number, a: number]): void;
+    static broadcastOne(player: Player, message: string, color?: Color | [r: number, g: number, b: number, a: number]): void;
+    static chatAll(message: string, color?: Color | [r: number, g: number, b: number, a: number]): void;
+    static chatOne(player: Player, message: string, color?: Color | [r: number, g: number, b: number, a: number]): void;
+}

package/build/cjs/lib/broadcast/broadcast.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Broadcast = void 0;
+const api_1 = require("@tabletop-playground/api");
+class Broadcast {
+    static get ERROR() {
+        return new api_1.Color(1, 0, 0, 1);
+    }
+    static broadcastAll(message, color) {
+        if (api_1.GameWorld.getExecutionReason() !== "unittest") {
+            console.log(`Broadcast.broadcastAll: ${message}`);
+        }
+        for (const player of api_1.world.getAllPlayers()) {
+            player.showMessage(message);
+            player.sendChatMessage(message, color !== null && color !== void 0 ? color : [1, 1, 1, 1]);
+        }
+        Broadcast.lastMessage = message;
+    }
+    static broadcastOne(player, message, color) {
+        if (api_1.GameWorld.getExecutionReason() !== "unittest") {
+            console.log(`Broadcast.broadcastOne: ${message}`);
+        }
+        player.showMessage(message);
+        player.sendChatMessage(message, color !== null && color !== void 0 ? color : [1, 1, 1, 1]);
+        Broadcast.lastMessage = message;
+    }
+    static chatAll(message, color) {
+        if (api_1.GameWorld.getExecutionReason() !== "unittest") {
+            console.log(`Broadcast.chatAll: ${message}`);
+        }
+        for (const player of api_1.world.getAllPlayers()) {
+            player.sendChatMessage(message, color !== null && color !== void 0 ? color : [1, 1, 1, 1]);
+        }
+        Broadcast.lastMessage = message;
+    }
+    static chatOne(player, message, color) {
+        if (api_1.GameWorld.getExecutionReason() !== "unittest") {
+            console.log(`Broadcast.chatOne (${player.getName()}): ${message}`);
+        }
+        player.sendChatMessage(message, color !== null && color !== void 0 ? color : [1, 1, 1, 1]);
+        Broadcast.lastMessage = message;
+    }
+}
+exports.Broadcast = Broadcast;
+Broadcast.lastMessage = "";
+//# sourceMappingURL=broadcast.js.map

package/build/cjs/lib/broadcast/broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.js","sourceRoot":"","sources":["../../../../src/lib/broadcast/broadcast.ts"],"names":[],"mappings":";;;AAAA,kDAA2E;AAE3E,MAAa,SAAS;IACX,MAAM,KAAK,KAAK;QACnB,OAAO,IAAI,WAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACjC,CAAC;IAIM,MAAM,CAAC,YAAY,CACtB,OAAe,EACf,KAA4D;QAE5D,IAAI,eAAS,CAAC,kBAAkB,EAAE,KAAK,UAAU,EAAE,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,WAAK,CAAC,aAAa,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC5B,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,SAAS,CAAC,WAAW,GAAG,OAAO,CAAC;IACpC,CAAC;IAEM,MAAM,CAAC,YAAY,CACtB,MAAc,EACd,OAAe,EACf,KAA4D;QAE5D,IAAI,eAAS,CAAC,kBAAkB,EAAE,KAAK,UAAU,EAAE,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC5B,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvD,SAAS,CAAC,WAAW,GAAG,OAAO,CAAC;IACpC,CAAC;IAEM,MAAM,CAAC,OAAO,CACjB,OAAe,EACf,KAA4D;QAE5D,IAAI,eAAS,CAAC,kBAAkB,EAAE,KAAK,UAAU,EAAE,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,WAAK,CAAC,aAAa,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,SAAS,CAAC,WAAW,GAAG,OAAO,CAAC;IACpC,CAAC;IAEM,MAAM,CAAC,OAAO,CACjB,MAAc,EACd,OAAe,EACf,KAA4D;QAE5D,IAAI,eAAS,CAAC,kBAAkB,EAAE,KAAK,UAAU,EAAE,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,OAAO,EAAE,MAAM,OAAO,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvD,SAAS,CAAC,WAAW,GAAG,OAAO,CAAC;IACpC,CAAC;;AAzDL,8BA0DC;AArDiB,qBAAW,GAAW,EAAE,CAAC"}

package/build/cjs/lib/bug-workarounds/bug-card-holder-assignment.d.ts

@@ -0,0 +1,8 @@
+import { IGlobal } from "../global/i-global";
+/**
+ * Monitor card holder, expect it to be the primary holder for
+ * the owning player slot player.
+ */
+export declare class BugCardHolderAssignment implements IGlobal {
+    init(): void;
+}

package/build/cjs/lib/bug-workarounds/bug-card-holder-assignment.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BugCardHolderAssignment = void 0;
+/**
+ * Monitor card holder, expect it to be the primary holder for
+ * the owning player slot player.
+ */
+class BugCardHolderAssignment {
+    init() {
+        throw new Error("Method not implemented.");
+    }
+}
+exports.BugCardHolderAssignment = BugCardHolderAssignment;
+//# sourceMappingURL=bug-card-holder-assignment.js.map

package/build/cjs/lib/bug-workarounds/bug-card-holder-assignment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bug-card-holder-assignment.js","sourceRoot":"","sources":["../../../../src/lib/bug-workarounds/bug-card-holder-assignment.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,uBAAuB;IAChC,IAAI;QACA,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC/C,CAAC;CACJ;AAJD,0DAIC"}

package/build/cjs/lib/bug-workarounds/bug-unique-cards.d.ts

@@ -0,0 +1,8 @@
+import { IGlobal } from "../global/i-global";
+/**
+ * Monitor given decks expecting no NSID (metadata) repeats.
+ * Prune extra cards if found.
+ */
+export declare class BugUniqueCards implements IGlobal {
+    init(): void;
+}

package/build/cjs/lib/bug-workarounds/bug-unique-cards.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BugUniqueCards = void 0;
+/**
+ * Monitor given decks expecting no NSID (metadata) repeats.
+ * Prune extra cards if found.
+ */
+class BugUniqueCards {
+    init() {
+        throw new Error("Method not implemented.");
+    }
+}
+exports.BugUniqueCards = BugUniqueCards;
+//# sourceMappingURL=bug-unique-cards.js.map

package/build/cjs/lib/bug-workarounds/bug-unique-cards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bug-unique-cards.js","sourceRoot":"","sources":["../../../../src/lib/bug-workarounds/bug-unique-cards.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,cAAc;IACvB,IAAI;QACA,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC/C,CAAC;CACJ;AAJD,wCAIC"}

package/build/cjs/lib/card-util/card-util.d.ts

@@ -0,0 +1,45 @@
+import { Card, GameObject } from "@tabletop-playground/api";
+export declare class CardUtil {
+    private readonly _find;
+    /**
+     * Deal card to the player's card holder.
+     * (Card.deal may fail if holder is not attached to player.)
+     *
+     * @param card
+     * @param playerSlot
+     * @returns
+     */
+    dealToHolder(card: Card, playerSlot: number): boolean;
+    /**
+     * Find the card anywhere on the table / in-deck / in-holder.
+     * Remove from deck or holder, if applicable.
+     *
+     * @param nsid
+     * @returns
+     */
+    fetchCard(nsid: string): Card | undefined;
+    /**
+     * Extract filter-approved cards into a new deck.  Leave any remaining
+     * cards in the old deck (may potentially become empty).
+     *
+     * @param deck
+     * @param filter
+     * @returns - new deck with filtered cards
+     */
+    filterCards(deck: Card, filter: (nsid: string) => boolean): Card | undefined;
+    /**
+     * Is this card a singleton (not a deck), not held by a player, etc.
+     *
+     * @param obj
+     * @param allowFaceDown
+     * @returns
+     */
+    isLooseCard(obj: GameObject, allowFaceDown?: boolean, rejectSnapPointTags?: string[]): boolean;
+    /**
+     * Split a deck into an array of single-card objects.
+     *
+     * @param deck
+     * @returns
+     */
+    separateDeck(deck: Card): Card[];
+}

package/build/cjs/lib/card-util/card-util.js

@@ -0,0 +1,176 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CardUtil = void 0;
+const api_1 = require("@tabletop-playground/api");
+const find_1 = require("../find/find");
+const nsid_1 = require("../nsid/nsid");
+class CardUtil {
+    constructor() {
+        this._find = new find_1.Find();
+    }
+    /**
+     * Deal card to the player's card holder.
+     * (Card.deal may fail if holder is not attached to player.)
+     *
+     * @param card
+     * @param playerSlot
+     * @returns
+     */
+    dealToHolder(card, playerSlot) {
+        var _a;
+        let holder;
+        // Check if player has attached card holder, otherwise search.
+        const player = api_1.world.getPlayerBySlot(playerSlot);
+        holder = player === null || player === void 0 ? void 0 : player.getHandHolder();
+        if (!holder) {
+            const skipContained = true;
+            holder = this._find.findCardHolderBySlot(playerSlot, skipContained);
+        }
+        return (_a = holder === null || holder === void 0 ? void 0 : holder.insert(card, holder.getNumCards())) !== null && _a !== void 0 ? _a : false;
+    }
+    /**
+     * Find the card anywhere on the table / in-deck / in-holder.
+     * Remove from deck or holder, if applicable.
+     *
+     * @param nsid
+     * @returns
+     */
+    fetchCard(nsid) {
+        // Find card.
+        let card;
+        const skipContained = false;
+        for (const obj of api_1.world.getAllObjects(skipContained)) {
+            if (!(obj instanceof api_1.Card)) {
+                continue;
+            }
+            if (obj.getStackSize() === 1) {
+                if (nsid_1.NSID.get(obj) === nsid) {
+                    card = obj;
+                    break;
+                }
+                continue; // single card, not the one we want
+            }
+            const offset = nsid_1.NSID.getDeck(obj).indexOf(nsid);
+            if (offset < 0) {
+                continue; // deck, wanted not not inside
+            }
+            const number = 1;
+            const fromFront = true;
+            const keep = false;
+            card = obj.takeCards(number, fromFront, offset, keep);
+            if (card) {
+                break;
+            }
+        }
+        // Remove from container.
+        const container = card === null || card === void 0 ? void 0 : card.getContainer();
+        if (card && container) {
+            container.remove(card);
+        }
+        // If found, remove from holder.
+        const cardHolder = card === null || card === void 0 ? void 0 : card.getHolder();
+        if (card && cardHolder) {
+            const index = cardHolder.getCards().indexOf(card);
+            if (index >= 0) {
+                cardHolder.removeAt(index);
+            }
+        }
+        // If held, release.
+        if (card === null || card === void 0 ? void 0 : card.isHeld()) {
+            card.release();
+        }
+        return card;
+    }
+    /**
+     * Extract filter-approved cards into a new deck.  Leave any remaining
+     * cards in the old deck (may potentially become empty).
+     *
+     * @param deck
+     * @param filter
+     * @returns - new deck with filtered cards
+     */
+    filterCards(deck, filter) {
+        let result;
+        const nsids = nsid_1.NSID.getDeck(deck);
+        for (let i = nsids.length - 1; i >= 0; i--) {
+            if (filter(nsids[i])) {
+                // Remove card from deck.
+                let card;
+                if (deck.getStackSize() === 1) {
+                    card = deck;
+                }
+                else {
+                    const numCards = 1;
+                    const fromFront = true;
+                    const offset = i;
+                    const keep = false;
+                    card = deck.takeCards(numCards, fromFront, offset, keep);
+                }
+                // Add card to result.
+                if (card) {
+                    if (result) {
+                        const toFront = true;
+                        const offset = 0;
+                        const animate = false;
+                        const flipped = false;
+                        result.addCards(card, toFront, offset, animate, flipped);
+                    }
+                    else {
+                        result = card;
+                    }
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Is this card a singleton (not a deck), not held by a player, etc.
+     *
+     * @param obj
+     * @param allowFaceDown
+     * @returns
+     */
+    isLooseCard(obj, allowFaceDown, rejectSnapPointTags) {
+        if (rejectSnapPointTags) {
+            const snapPoint = obj.getSnappedToPoint();
+            if (snapPoint) {
+                const tags = snapPoint.getTags();
+                for (const tag of tags) {
+                    if (rejectSnapPointTags.includes(tag)) {
+                        return false;
+                    }
+                }
+            }
+        }
+        return (obj instanceof api_1.Card &&
+            (allowFaceDown || obj.isFaceUp()) &&
+            obj.getStackSize() === 1 &&
+            !obj.getContainer() &&
+            !obj.isHeld() &&
+            !obj.isInHolder() &&
+            obj.isValid());
+    }
+    /**
+     * Split a deck into an array of single-card objects.
+     *
+     * @param deck
+     * @returns
+     */
+    separateDeck(deck) {
+        const cards = [];
+        while (deck.getStackSize() > 1) {
+            const numCards = 1;
+            const fromFront = true;
+            const offset = 0;
+            const keep = false;
+            const card = deck.takeCards(numCards, fromFront, offset, keep);
+            if (card) {
+                cards.push(card);
+            }
+        }
+        cards.push(deck); // one card remains
+        return cards;
+    }
+}
+exports.CardUtil = CardUtil;
+//# sourceMappingURL=card-util.js.map

package/build/cjs/lib/card-util/card-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-util.js","sourceRoot":"","sources":["../../../../src/lib/card-util/card-util.ts"],"names":[],"mappings":"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"}

package/build/cjs/lib/context-menu/abstract-right-click-card.d.ts

@@ -0,0 +1,17 @@
+import { GameObject, Player } from "@tabletop-playground/api";
+import { IGlobal } from "../global/i-global";
+/**
+ * Add a context menu item ONLY when the singleton card exists.
+ * Remove it if the card becomes a deck.
+ *
+ * NOTE: the handler is a standard onCustomAction handler -- you need to verify
+ * the identifier before processing!  This is to match other onCustomAction
+ * handling rather than create a new signature.
+ */
+export declare abstract class AbstractRightClickCard implements IGlobal {
+    private readonly _cardNsid;
+    private readonly _customActionName;
+    private readonly _customActionHandler;
+    constructor(cardNsid: string, customActionName: string, customActionHandler: (object: GameObject, player: Player, identifier: string) => void);
+    init(): void;
+}

package/build/cjs/lib/context-menu/abstract-right-click-card.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractRightClickCard = void 0;
+const on_card_became_singleton_or_deck_1 = require("../event/on-card-became-singleton-or-deck");
+const nsid_1 = require("../nsid/nsid");
+/**
+ * Add a context menu item ONLY when the singleton card exists.
+ * Remove it if the card becomes a deck.
+ *
+ * NOTE: the handler is a standard onCustomAction handler -- you need to verify
+ * the identifier before processing!  This is to match other onCustomAction
+ * handling rather than create a new signature.
+ */
+class AbstractRightClickCard {
+    constructor(cardNsid, customActionName, customActionHandler) {
+        this._cardNsid = cardNsid;
+        this._customActionName = customActionName;
+        this._customActionHandler = customActionHandler;
+    }
+    init() {
+        // These trigger the frame AFTER init.  No need to look for objects.
+        on_card_became_singleton_or_deck_1.OnCardBecameSingletonOrDeck.onSingletonCardCreated.add((card) => {
+            const nsid = nsid_1.NSID.get(card);
+            if (nsid === this._cardNsid) {
+                card.removeCustomAction(this._customActionName);
+                card.addCustomAction(this._customActionName);
+                card.onCustomAction.remove(this._customActionHandler);
+                card.onCustomAction.add(this._customActionHandler);
+            }
+        });
+        on_card_became_singleton_or_deck_1.OnCardBecameSingletonOrDeck.onSingletonCardMadeDeck.add((card, oldNsid) => {
+            if (oldNsid === this._cardNsid) {
+                card.removeCustomAction(this._customActionName);
+                card.onCustomAction.remove(this._customActionHandler);
+            }
+        });
+    }
+}
+exports.AbstractRightClickCard = AbstractRightClickCard;
+//# sourceMappingURL=abstract-right-click-card.js.map

package/build/cjs/lib/context-menu/abstract-right-click-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-right-click-card.js","sourceRoot":"","sources":["../../../../src/lib/context-menu/abstract-right-click-card.ts"],"names":[],"mappings":";;;AACA,gGAAwF;AAExF,uCAAoC;AAEpC;;;;;;;GAOG;AACH,MAAsB,sBAAsB;IASxC,YACI,QAAgB,EAChB,gBAAwB,EACxB,mBAIS;QAET,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;QAC1C,IAAI,CAAC,oBAAoB,GAAG,mBAAmB,CAAC;IACpD,CAAC;IAED,IAAI;QACA,oEAAoE;QACpE,8DAA2B,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,IAAU,EAAE,EAAE;YAClE,MAAM,IAAI,GAAG,WAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,IAAI,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;gBAChD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;gBAC7C,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;gBACtD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACvD,CAAC;QACL,CAAC,CAAC,CAAC;QACH,8DAA2B,CAAC,uBAAuB,CAAC,GAAG,CACnD,CAAC,IAAU,EAAE,OAAe,EAAE,EAAE;YAC5B,IAAI,OAAO,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC7B,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;gBAChD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAC1D,CAAC;QACL,CAAC,CACJ,CAAC;IACN,CAAC;CACJ;AA3CD,wDA2CC"}

package/build/cjs/lib/context-menu/abstract-right-click-deck.d.ts

@@ -0,0 +1,19 @@
+import { GameObject, Player } from "@tabletop-playground/api";
+import { IGlobal } from "../global/i-global";
+/**
+ * Add context menu item on a deck ONLY when all cards match the given prefix.
+ * Remove it if the deck becomes a singleton card.
+ *
+ * NOTE: does not remove the handler if a mismatch card is added to the deck later!
+ *
+ * NOTE: the handler is a standard onCustomAction handler -- you need to verify
+ * the identifier before processing!  This is to match other onCustomAction
+ * handling rather than create a new signature.
+ */
+export declare abstract class AbstractRightClickDeck implements IGlobal {
+    private readonly _deckNsidPrefix;
+    private readonly _customActionName;
+    private readonly _customActionHandler;
+    constructor(deckNsidPrefix: string, customActionName: string, customActionHandler: (object: GameObject, player: Player, identifier: string) => void);
+    init(): void;
+}

package/build/cjs/lib/context-menu/abstract-right-click-deck.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractRightClickDeck = void 0;
+const on_card_became_singleton_or_deck_1 = require("../event/on-card-became-singleton-or-deck");
+const nsid_1 = require("../nsid/nsid");
+/**
+ * Add context menu item on a deck ONLY when all cards match the given prefix.
+ * Remove it if the deck becomes a singleton card.
+ *
+ * NOTE: does not remove the handler if a mismatch card is added to the deck later!
+ *
+ * NOTE: the handler is a standard onCustomAction handler -- you need to verify
+ * the identifier before processing!  This is to match other onCustomAction
+ * handling rather than create a new signature.
+ */
+class AbstractRightClickDeck {
+    constructor(deckNsidPrefix, customActionName, customActionHandler) {
+        this._deckNsidPrefix = deckNsidPrefix;
+        this._customActionName = customActionName;
+        this._customActionHandler = customActionHandler;
+    }
+    init() {
+        // These trigger the frame AFTER init.  No need to look for objects.
+        on_card_became_singleton_or_deck_1.OnCardBecameSingletonOrDeck.onSingletonCardCreated.add((card) => {
+            const nsid = nsid_1.NSID.get(card);
+            if (nsid.startsWith(this._deckNsidPrefix)) {
+                card.removeCustomAction(this._customActionName);
+                card.onCustomAction.remove(this._customActionHandler);
+            }
+        });
+        on_card_became_singleton_or_deck_1.OnCardBecameSingletonOrDeck.onSingletonCardMadeDeck.add((card) => {
+            const nsids = nsid_1.NSID.getDeck(card);
+            for (const nsid of nsids) {
+                if (!nsid.startsWith(this._deckNsidPrefix)) {
+                    return; // at least one mismatch
+                }
+            }
+            card.removeCustomAction(this._customActionName);
+            card.addCustomAction(this._customActionName);
+            card.onCustomAction.remove(this._customActionHandler);
+            card.onCustomAction.add(this._customActionHandler);
+        });
+    }
+}
+exports.AbstractRightClickDeck = AbstractRightClickDeck;
+//# sourceMappingURL=abstract-right-click-deck.js.map

package/build/cjs/lib/context-menu/abstract-right-click-deck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-right-click-deck.js","sourceRoot":"","sources":["../../../../src/lib/context-menu/abstract-right-click-deck.ts"],"names":[],"mappings":";;;AACA,gGAAwF;AAExF,uCAAoC;AAEpC;;;;;;;;;GASG;AACH,MAAsB,sBAAsB;IASxC,YACI,cAAsB,EACtB,gBAAwB,EACxB,mBAIS;QAET,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;QACtC,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;QAC1C,IAAI,CAAC,oBAAoB,GAAG,mBAAmB,CAAC;IACpD,CAAC;IAED,IAAI;QACA,oEAAoE;QACpE,8DAA2B,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,IAAU,EAAE,EAAE;YAClE,MAAM,IAAI,GAAG,WAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;gBACxC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;gBAChD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAC1D,CAAC;QACL,CAAC,CAAC,CAAC;QACH,8DAA2B,CAAC,uBAAuB,CAAC,GAAG,CACnD,CAAC,IAAU,EAAE,EAAE;YACX,MAAM,KAAK,GAAa,WAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACvB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;oBACzC,OAAO,CAAC,wBAAwB;gBACpC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAChD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC7C,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACtD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACvD,CAAC,CACJ,CAAC;IACN,CAAC;CACJ;AA/CD,wDA+CC"}

package/build/cjs/lib/context-menu/leave-seat.d.ts

@@ -0,0 +1,19 @@
+import { Player } from "@tabletop-playground/api";
+import { IGlobal } from "../global/i-global";
+/**
+ * Global content menu item to leave seat.  Move to an unused slot, NOT the
+ * spectator slot (spectators cannot interact, preventing them from clicking
+ * any "take seat" buttons).
+ */
+export declare class LeaveSeat implements IGlobal {
+    static readonly CUSTOM_ACTION_NAME = "* Leave seat";
+    private static readonly _customActionHandler;
+    init(): void;
+    /**
+     * Move player to an "unused" slot, meaning no existing player NOR any
+     * object's owning player slot.
+     *
+     * @param player
+     */
+    static leaveSeat(player: Player): boolean;
+}