@gamepark/react-game 6.24.1 → 6.24.3

package/dist/locators/FlexLocator.js

@@ -17,27 +17,57 @@ var __extends = (this && this.__extends) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FlexLocator = void 0;
 var ListLocator_1 = require("./ListLocator");
-var FlexLocator = (function (_super) {
+/**
+ * This Locator places a list of items as a grid, with break points for the lines. Inspired by the CSS flexbox.
+ */
+var FlexLocator = /** @class */ (function (_super) {
     __extends(FlexLocator, _super);
     function FlexLocator(clone) {
         var _this = _super.call(this) || this;
+        /**
+         * The number of items per line.
+         */
         _this.lineSize = 2;
         Object.assign(_this, clone);
         return _this;
     }
+    /**
+     * Function to override to provide a {@link lineSize} that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns The number of items per line.
+     */
     FlexLocator.prototype.getLineSize = function (_location, _context) {
         return this.lineSize;
     };
     FlexLocator.prototype.getMaxCount = function (location, context) {
         return this.getLineSize(location, context);
     };
+    /**
+     * Function to override to provide a {@link getLineGap} that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns The default gap between 2 consecutive lines
+     */
     FlexLocator.prototype.getLineGap = function (_location, _context) {
         var _a;
         return (_a = this.lineGap) !== null && _a !== void 0 ? _a : {};
     };
+    /**
+     * Function to override to provide a {@link maxLines} that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns The maximum number of lines displayed before the gap between the lines is reduced to fill in the same space.
+     */
     FlexLocator.prototype.getMaxLines = function (_location, _context) {
         return this.maxLines;
     };
+    /**
+     * Function to override to provide a {@link maxLineGap} that depends on the context. Uses getMaxLines by default.
+     * @param location Location to position
+     * @param context Context of the game
+     * @returns The maximum gap between the first and the last line.
+     */
     FlexLocator.prototype.getMaxLineGap = function (location, context) {
         if (this.maxLineGap)
             return this.maxLineGap;

package/dist/locators/FlexLocator.js.map

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

package/dist/locators/HandLocator.d.ts

@@ -1,24 +1,96 @@
 import { Coordinates, Location, MaterialItem } from '@gamepark/rules-api';
 import { LocationDescription } from '../components';
 import { ItemContext, Locator, MaterialContext } from './Locator';
+/**
+ * This Locator places items fan-shaped to mimic the ways we hold cards in our hands.
+ */
 export declare class HandLocator<P extends number = number, M extends number = number, L extends number = number> extends Locator<P, M, L> {
     constructor(clone?: Partial<HandLocator>);
+    /**
+     * Items are place around the circle of an arc. This is the radius of the arc. Override {@link getRadius} to provide a dynamic radius.
+     */
     radius: number;
+    /**
+     * Provide the radius of the circle. Defaults to {@link radius} property.
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns the radius of the circle in cm
+     */
     getRadius(_location: Location<P, L>, _context: MaterialContext<P, M, L>): number;
+    /**
+     * The default angle of the hand items. For instance, 180 will display the hand oriented towards the bottom of the screen.
+     */
     baseAngle: number;
+    /**
+     * Function to override to provide a {@link baseAngle} that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns the default angle of the items
+     */
     getBaseAngle(_location: Location<P, L>, _context: MaterialContext<P, M, L>): number;
+    /**
+     * The maximum angle that is allowed between the first and the last items displayed.
+     */
     maxAngle: number;
+    /**
+     * Function to override to provide a {@link maxAngle} that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns the maximum angle between the first and the last items
+     */
     getMaxAngle(_location: Location<P, L>, _context: MaterialContext<P, M, L>): number;
+    /**
+     * The maximum angle between two consecutive items in the hand
+     */
     gapMaxAngle: number;
+    /**
+     * Function to override to provide a {@link gapMaxAngle} that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns The maximum angle between two consecutive items in the hand
+     */
     getGapMaxAngle(_location: Location<P, L>, _context: MaterialContext<P, M, L>): number;
+    /**
+     * The direction of the items displayed, for the first to the last index. Default is true.
+     */
     clockwise: boolean;
+    /**
+     * Function to override to provide a {@link clockwise} info that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns true if items should be displayed clockwise around the arc of circle. Default is true.
+     */
     isClockwise(_location: Location<P, L>, _context: MaterialContext<P, M, L>): boolean;
+    /**
+     * The Z-axis position difference between 2 consecutive items in the hand. Default is 0.05cm.
+     */
     deltaZ: number;
+    /**
+     * Function to override to provide a {@link deltaZ} that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns The Z-axis position difference between 2 consecutive items in the hand. Default is 0.05cm.
+     */
     getDeltaZ(_location: Location<P, L>, _context: MaterialContext<P, M, L>): number;
+    /**
+     * See {@link Locator.getLocationCoordinates}.
+     * @param location Location to position
+     * @param context Context of the game
+     * @param index Index of the item (or location) to place
+     */
     getLocationCoordinates(location: Location<P, L>, context: MaterialContext<P, M, L>, index?: number | undefined): Coordinates;
     getItemCoordinates(item: MaterialItem<P, L>, context: ItemContext<P, M, L>): Coordinates;
+    /**
+     * See {@link Locator.getRotateZ}.
+     * @param location Location to position
+     * @param context Context of the game
+     * @param index Index of the item (or location) to place
+     */
     getRotateZ(location: Location<P, L>, context: MaterialContext<P, M, L>, index?: number | undefined): number;
     getItemRotateZ(item: MaterialItem<P, L>, context: ItemContext<P, M, L>): number;
     protected generateLocationDescriptionFromDraggedItem(_location: Location<P, L>, context: ItemContext<P, M, L>): LocationDescription<P, M, L>;
+    /**
+     * See {@link Locator.getHoverTransform}. By default, display the item on top of others, straight, and twice as big.
+     */
     getHoverTransform(item: MaterialItem<P, L>, context: ItemContext<P, M, L>): string[];
 }

package/dist/locators/HandLocator.js

@@ -18,37 +18,100 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HandLocator = void 0;
 var components_1 = require("../components");
 var Locator_1 = require("./Locator");
-var HandLocator = (function (_super) {
+/**
+ * This Locator places items fan-shaped to mimic the ways we hold cards in our hands.
+ */
+var HandLocator = /** @class */ (function (_super) {
     __extends(HandLocator, _super);
     function HandLocator(clone) {
         var _this = _super.call(this) || this;
+        /**
+         * Items are place around the circle of an arc. This is the radius of the arc. Override {@link getRadius} to provide a dynamic radius.
+         */
         _this.radius = 100;
+        /**
+         * The default angle of the hand items. For instance, 180 will display the hand oriented towards the bottom of the screen.
+         */
         _this.baseAngle = 0;
+        /**
+         * The maximum angle that is allowed between the first and the last items displayed.
+         */
         _this.maxAngle = 15;
+        /**
+         * The maximum angle between two consecutive items in the hand
+         */
         _this.gapMaxAngle = 3;
+        /**
+         * The direction of the items displayed, for the first to the last index. Default is true.
+         */
         _this.clockwise = true;
+        /**
+         * The Z-axis position difference between 2 consecutive items in the hand. Default is 0.05cm.
+         */
         _this.deltaZ = 0.05;
         Object.assign(_this, clone);
         return _this;
     }
+    /**
+     * Provide the radius of the circle. Defaults to {@link radius} property.
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns the radius of the circle in cm
+     */
     HandLocator.prototype.getRadius = function (_location, _context) {
         return this.radius;
     };
+    /**
+     * Function to override to provide a {@link baseAngle} that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns the default angle of the items
+     */
     HandLocator.prototype.getBaseAngle = function (_location, _context) {
         return this.baseAngle;
     };
+    /**
+     * Function to override to provide a {@link maxAngle} that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns the maximum angle between the first and the last items
+     */
     HandLocator.prototype.getMaxAngle = function (_location, _context) {
         return this.maxAngle;
     };
+    /**
+     * Function to override to provide a {@link gapMaxAngle} that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns The maximum angle between two consecutive items in the hand
+     */
     HandLocator.prototype.getGapMaxAngle = function (_location, _context) {
         return this.gapMaxAngle;
     };
+    /**
+     * Function to override to provide a {@link clockwise} info that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns true if items should be displayed clockwise around the arc of circle. Default is true.
+     */
     HandLocator.prototype.isClockwise = function (_location, _context) {
         return this.clockwise;
     };
+    /**
+     * Function to override to provide a {@link deltaZ} that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns The Z-axis position difference between 2 consecutive items in the hand. Default is 0.05cm.
+     */
     HandLocator.prototype.getDeltaZ = function (_location, _context) {
         return this.deltaZ;
     };
+    /**
+     * See {@link Locator.getLocationCoordinates}.
+     * @param location Location to position
+     * @param context Context of the game
+     * @param index Index of the item (or location) to place
+     */
     HandLocator.prototype.getLocationCoordinates = function (location, context, index) {
         if (index === void 0) { index = this.getLocationIndex(location, context); }
         var _a = this.getCoordinates(location, context), _b = _a.x, x = _b === void 0 ? 0 : _b, _c = _a.y, y = _c === void 0 ? 0 : _c, _d = _a.z, z = _d === void 0 ? 0 : _d;
@@ -67,6 +130,12 @@ var HandLocator = (function (_super) {
     HandLocator.prototype.getItemCoordinates = function (item, context) {
         return this.getLocationCoordinates(item.location, context, this.getItemIndex(item, context));
     };
+    /**
+     * See {@link Locator.getRotateZ}.
+     * @param location Location to position
+     * @param context Context of the game
+     * @param index Index of the item (or location) to place
+     */
     HandLocator.prototype.getRotateZ = function (location, context, index) {
         if (index === void 0) { index = this.getLocationIndex(location, context); }
         var baseAngle = this.getBaseAngle(location, context);
@@ -96,6 +165,9 @@ var HandLocator = (function (_super) {
             borderRadius: borderRadius
         });
     };
+    /**
+     * See {@link Locator.getHoverTransform}. By default, display the item on top of others, straight, and twice as big.
+     */
     HandLocator.prototype.getHoverTransform = function (item, context) {
         return ['translateZ(10em)', "rotateZ(".concat(-this.getItemRotateZ(item, context)).concat(this.rotationUnit, ")"), 'scale(2)'];
     };

package/dist/locators/HandLocator.js.map

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

package/dist/locators/LineLocator.d.ts

@@ -1,12 +1,12 @@
-import { Coordinates, Location, MaterialItem } from '@gamepark/rules-api';
-import { ItemContext, Locator, MaterialContext } from './Locator';
-export declare abstract class LineLocator<P extends number = number, M extends number = number, L extends number = number> extends Locator<P, M, L> {
-    getOriginCoordinates(_location: Location<P, L>, _context: MaterialContext<P, M, L>): Partial<Coordinates>;
-    getLocationCoordinates(location: Location<P, L>, context: MaterialContext<P, M, L>, index?: number): Coordinates;
-    getItemCoordinates(item: MaterialItem<P, L>, context: ItemContext<P, M, L>): Coordinates;
+import { Coordinates, MaterialItem } from '@gamepark/rules-api';
+import { ItemContext, ItemLocator } from './ItemLocator';
+export declare abstract class LineLocator<P extends number = number, M extends number = number, L extends number = number> extends ItemLocator<P, M, L> {
+    getPosition(item: MaterialItem<P, L>, context: ItemContext<P, M, L>): Coordinates;
     getDeltaValue(delta: number | undefined, max: number | undefined, count: number): number;
+    coordinates: Coordinates;
+    getCoordinates(_item: MaterialItem<P, L>, _context: ItemContext<P, M, L>): Coordinates;
     delta?: Partial<Coordinates>;
-    getDelta(_location: Location<P, L>, _context: MaterialContext<P, M, L>): Partial<Coordinates>;
+    getDelta(_item: MaterialItem<P, L>, _context: ItemContext<P, M, L>): Partial<Coordinates>;
     deltaMax?: Partial<Coordinates>;
-    getDeltaMax(_location: Location<P, L>, _context: MaterialContext<P, M, L>): Partial<Coordinates>;
+    getDeltaMax(_item: MaterialItem<P, L>, _context: ItemContext<P, M, L>): Partial<Coordinates>;
 }

package/dist/locators/LineLocator.js

@@ -14,38 +14,43 @@ var __extends = (this && this.__extends) || (function () {
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     };
 })();
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LineLocator = void 0;
-var Locator_1 = require("./Locator");
+var ItemLocator_1 = require("./ItemLocator");
 var LineLocator = (function (_super) {
     __extends(LineLocator, _super);
     function LineLocator() {
-        return _super !== null && _super.apply(this, arguments) || this;
+        var _this = _super !== null && _super.apply(this, arguments) || this;
+        _this.coordinates = { x: 0, y: 0, z: 0 };
+        return _this;
     }
-    LineLocator.prototype.getOriginCoordinates = function (_location, _context) {
-        return this.coordinates;
-    };
-    LineLocator.prototype.getLocationCoordinates = function (location, context, index) {
+    LineLocator.prototype.getPosition = function (item, context) {
         var _a, _b, _c, _d, _e;
-        if (index === void 0) { index = (_a = this.getLocationIndex(location, context)) !== null && _a !== void 0 ? _a : 0; }
-        var _f = this.getOriginCoordinates(location, context), _g = _f.x, x = _g === void 0 ? 0 : _g, _h = _f.y, y = _h === void 0 ? 0 : _h, _j = _f.z, z = _j === void 0 ? 0 : _j;
-        var delta = this.getDelta(location, context);
+        var coordinates = this.getCoordinates(item, context);
+        var index = this.getItemIndex(item, context);
+        var delta = this.getDelta(item, context);
         if (this.getDeltaMax) {
-            var count = this.countItems(location, context);
+            var count = this.countItems(item.location, context);
             if (count > 1) {
-                var deltaMax = this.getDeltaMax(location, context);
+                var deltaMax = this.getDeltaMax(item, context);
+                delta = __assign(__assign({}, delta), { z: delta.z === undefined ? (_b = (_a = context.material[context.type]) === null || _a === void 0 ? void 0 : _a.thickness) !== null && _b !== void 0 ? _b : 0.05 : delta.z });
                 delta.x = this.getDeltaValue(delta.x, deltaMax.x, count);
                 delta.y = this.getDeltaValue(delta.y, deltaMax.y, count);
-                delta.z = this.getDeltaValue((_b = delta.z) !== null && _b !== void 0 ? _b : 0.05, deltaMax.z, count);
+                delta.z = this.getDeltaValue(delta.z, deltaMax.z, count);
             }
         }
-        return { x: x + index * ((_c = delta.x) !== null && _c !== void 0 ? _c : 0), y: y + index * ((_d = delta.y) !== null && _d !== void 0 ? _d : 0), z: z + index * ((_e = delta.z) !== null && _e !== void 0 ? _e : 0) };
-    };
-    LineLocator.prototype.getItemCoordinates = function (item, context) {
-        var _a, _b;
-        var _c = this.getLocationCoordinates(item.location, context, this.getItemIndex(item, context)), x = _c.x, y = _c.y, z = _c.z;
-        var thickness = (_b = (_a = context.material[context.type]) === null || _a === void 0 ? void 0 : _a.thickness) !== null && _b !== void 0 ? _b : 0;
-        return { x: x, y: y, z: z + thickness };
+        return { x: coordinates.x + index * ((_c = delta.x) !== null && _c !== void 0 ? _c : 0), y: coordinates.y + index * ((_d = delta.y) !== null && _d !== void 0 ? _d : 0), z: coordinates.z + index * ((_e = delta.z) !== null && _e !== void 0 ? _e : 0) };
     };
     LineLocator.prototype.getDeltaValue = function (delta, max, count) {
         if (delta === void 0) { delta = 0; }
@@ -55,15 +60,18 @@ var LineLocator = (function (_super) {
             return Math.max(delta, max / (count - 1));
         return delta;
     };
-    LineLocator.prototype.getDelta = function (_location, _context) {
+    LineLocator.prototype.getCoordinates = function (_item, _context) {
+        return this.coordinates;
+    };
+    LineLocator.prototype.getDelta = function (_item, _context) {
         var _a;
         return (_a = this.delta) !== null && _a !== void 0 ? _a : {};
     };
-    LineLocator.prototype.getDeltaMax = function (_location, _context) {
+    LineLocator.prototype.getDeltaMax = function (_item, _context) {
         var _a;
         return (_a = this.deltaMax) !== null && _a !== void 0 ? _a : {};
     };
     return LineLocator;
-}(Locator_1.Locator));
+}(ItemLocator_1.ItemLocator));
 exports.LineLocator = LineLocator;
 //# sourceMappingURL=LineLocator.js.map

package/dist/locators/LineLocator.js.map

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

package/dist/locators/ListLocator.d.ts

@@ -1,14 +1,50 @@
 import { Coordinates, Location, MaterialItem, XYCoordinates } from '@gamepark/rules-api';
 import { LocationDescription } from '../components';
 import { ItemContext, Locator, MaterialContext } from './Locator';
+/**
+ * This Locator places items at regular intervals.
+ */
 export declare class ListLocator<P extends number = number, M extends number = number, L extends number = number> extends Locator<P, M, L> {
     constructor(clone?: Partial<ListLocator>);
+    /**
+     * The default gap between 2 consecutive items
+     */
     gap?: Partial<Coordinates>;
+    /**
+     * Function to override to provide a {@link gap} that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns The default gap between 2 consecutive items
+     */
     getGap(_location: Location<P, L>, _context: MaterialContext<P, M, L>): Partial<Coordinates>;
+    /**
+     * The maximum number of items that can be displayed in the list before the gap between items is reduced to fill in the same space.
+     */
     maxCount?: number;
+    /**
+     * Function to override to provide a {@link maxCount that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns The maximum number of items that can be displayed in the list before the gap between items is reduced to fill in the same space.
+     */
     getMaxCount(_location: Location<P, L>, _context: MaterialContext<P, M, L>): number | undefined;
+    /**
+     * The maximum gap between the first and the last items. See {@link maxCount} to get a maxGap based on a max number of items.
+     */
     maxGap?: Partial<Coordinates>;
+    /**
+     * Function to override to provide a {@link maxGap} that depends on the context
+     * @param location Location to position
+     * @param context Context of the game
+     * @returns The maximum gap between the first and the last items
+     */
     getMaxGap(location: Location<P, L>, context: MaterialContext<P, M, L>): Partial<Coordinates>;
+    /**
+     * The number of items displayed in the list
+     * @param location Location area of the items
+     * @param context Context of the game
+     * @returns number of items in the location area
+     */
     countListItems(location: Location<P, L>, context: MaterialContext<P, M, L>): number;
     protected getAreaCoordinates(location: Location<P, L>, context: MaterialContext<P, M, L>): Partial<Coordinates>;
     protected getCurrentMaxGap(location: Location<P, L>, context: MaterialContext<P, M, L>): XYCoordinates;

package/dist/locators/ListLocator.js

@@ -18,20 +18,41 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ListLocator = void 0;
 var components_1 = require("../components");
 var Locator_1 = require("./Locator");
-var ListLocator = (function (_super) {
+/**
+ * This Locator places items at regular intervals.
+ */
+var ListLocator = /** @class */ (function (_super) {
     __extends(ListLocator, _super);
     function ListLocator(clone) {
         var _this = _super.call(this) || this;
         Object.assign(_this, clone);
         return _this;
     }
+    /**
+     * Function to override to provide a {@link gap} that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns The default gap between 2 consecutive items
+     */
     ListLocator.prototype.getGap = function (_location, _context) {
         var _a;
         return (_a = this.gap) !== null && _a !== void 0 ? _a : {};
     };
+    /**
+     * Function to override to provide a {@link maxCount that depends on the context
+     * @param _location Location to position
+     * @param _context Context of the game
+     * @returns The maximum number of items that can be displayed in the list before the gap between items is reduced to fill in the same space.
+     */
     ListLocator.prototype.getMaxCount = function (_location, _context) {
         return this.maxCount;
     };
+    /**
+     * Function to override to provide a {@link maxGap} that depends on the context
+     * @param location Location to position
+     * @param context Context of the game
+     * @returns The maximum gap between the first and the last items
+     */
     ListLocator.prototype.getMaxGap = function (location, context) {
         if (this.maxGap)
             return this.maxGap;
@@ -45,6 +66,12 @@ var ListLocator = (function (_super) {
             z: z ? z * (maxCount - 1) : z
         };
     };
+    /**
+     * The number of items displayed in the list
+     * @param location Location area of the items
+     * @param context Context of the game
+     * @returns number of items in the location area
+     */
     ListLocator.prototype.countListItems = function (location, context) {
         var _a;
         return Math.min((_a = this.limit) !== null && _a !== void 0 ? _a : Infinity, this.countItems(location, context));

package/dist/locators/ListLocator.js.map

@@ -1 +1 @@
-{"version":3,"file":"ListLocator.js","sourceRoot":"","sources":["../../src/locators/ListLocator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AACA,4CAAwE;AACxE,qCAAiE;AAKjE;IAAkH,+BAAgB;IAEhI,qBAAY,KAA4B;QAAxC,YACE,iBAAO,SAER;QADC,MAAM,CAAC,MAAM,CAAC,KAAI,EAAE,KAAK,CAAC,CAAA;;IAC5B,CAAC;IAaD,4BAAM,GAAN,UAAO,SAAyB,EAAE,QAAkC;;QAClE,OAAO,MAAA,IAAI,CAAC,GAAG,mCAAI,EAAE,CAAA;IACvB,CAAC;IAaD,iCAAW,GAAX,UAAY,SAAyB,EAAE,QAAkC;QACvE,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAaD,+BAAS,GAAT,UAAU,QAAwB,EAAE,OAAiC;QACnE,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAA;QACnC,IAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACpD,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,EAAE,CAAA;QAC/B,IAAA,KAAc,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,EAA1C,CAAC,OAAA,EAAE,CAAC,OAAA,EAAE,CAAC,OAAmC,CAAA;QAClD,OAAO;YACL,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7B,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7B,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAC9B,CAAA;IACH,CAAC;IAQD,oCAAc,GAAd,UAAe,QAAwB,EAAE,OAAiC;;QACxE,OAAO,IAAI,CAAC,GAAG,CAAC,MAAA,IAAI,CAAC,KAAK,mCAAI,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;IAC7E,CAAC;IAES,wCAAkB,GAA5B,UAA6B,QAAwB,EAAE,OAAiC;QAChF,IAAA,KAA0B,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,EAA9D,SAAK,EAAL,CAAC,mBAAG,CAAC,KAAA,EAAE,SAAK,EAAL,CAAC,mBAAG,CAAC,KAAA,EAAE,SAAK,EAAL,CAAC,mBAAG,CAAC,KAA2C,CAAA;QAChE,IAAA,KAAmB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAtD,EAAE,OAAA,EAAK,EAAE,OAA6C,CAAA;QACjE,OAAO,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,GAAA,EAAE,CAAA;IAC5C,CAAC;IAES,sCAAgB,GAA1B,UAA2B,QAAwB,EAAE,OAAiC;QAC9E,IAAA,KAA2B,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAvD,SAAS,EAAN,EAAE,mBAAG,CAAC,KAAA,EAAE,SAAS,EAAN,EAAE,mBAAG,CAAC,KAAmC,CAAA;QACzD,IAAA,KAAqB,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAjD,GAAG,OAAA,EAAK,GAAG,OAAsC,CAAA;QAC5D,IAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACpD,OAAO,EAAE,CAAC,EAAE,CAAC,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;IACvE,CAAC;IAED,4CAAsB,GAAtB,UAAuB,QAAwB,EAAE,OAAiC,EAC3D,KAAgD;QAAhD,sBAAA,EAAA,QAAQ,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC;QACrE,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACpE,IAAA,KAA0B,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,EAA9D,SAAK,EAAL,CAAC,mBAAG,CAAC,KAAA,EAAE,SAAK,EAAL,CAAC,mBAAG,CAAC,KAAA,EAAE,SAAK,EAAL,CAAC,mBAAG,CAAC,KAA2C,CAAA;QAChE,IAAA,KAAyC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,EAArE,SAAS,EAAN,EAAE,mBAAG,CAAC,KAAA,EAAE,SAAS,EAAN,EAAE,mBAAG,CAAC,KAAA,EAAE,SAAY,EAAT,EAAE,mBAAG,IAAI,KAAmC,CAAA;QACvE,IAAA,KAA6B,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAzD,GAAG,OAAA,EAAK,GAAG,OAAA,EAAK,GAAG,OAAsC,CAAA;QACpE,IAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACpD,OAAO;YACL,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClF,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClF,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACnF,CAAA;IACH,CAAC;IAED,wCAAkB,GAAlB,UAAmB,IAAwB,EAAE,OAA6B;QACxE,OAAO,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IAC9F,CAAC;IAES,gEAA0C,GAApD,UAAqD,QAAwB,EAAE,OAA6B;;QAC1G,IAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACxE,IAAI,CAAC,IAAI;YAAE,OAAM;QACX,IAAA,KAA4B,MAAA,MAAA,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,0CAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,mCAAI,EAAE,EAAhF,aAAS,EAAT,KAAK,mBAAG,CAAC,KAAA,EAAE,cAAU,EAAV,MAAM,mBAAG,CAAC,KAA2D,CAAA;QAClF,IAAA,KAAW,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAjD,CAAC,OAAA,EAAE,CAAC,OAA6C,CAAA;QACzD,IAAM,YAAY,GAAG,MAAA,MAAA,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,0CAAE,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,mCAAI,CAAC,CAAA;QAClF,OAAO,IAAI,gCAAmB,CAAC;YAC7B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5B,YAAY,cAAA;SACb,CAAC,CAAA;IACJ,CAAC;IACH,kBAAC;AAAD,CAAC,AAjHD,CAAkH,iBAAO,GAiHxH;AAjHY,kCAAW"}
+{"version":3,"file":"ListLocator.js","sourceRoot":"","sources":["../../src/locators/ListLocator.ts"],"names":[],"mappings":"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"}