libram 0.8.28 → 0.8.29

package/dist/moonSign.js

@@ -0,0 +1,25 @@
+const MoonSigns = [
+    "Mongoose",
+    "Wallaby",
+    "Vole",
+    "Platypus",
+    "Opossum",
+    "Marmot",
+    "Wombat",
+    "Blender",
+    "Packrat",
+];
+/**
+ * @param moon Moon sign name
+ * @returns Moon sign id else 0
+ */
+export function signNameToId(moon) {
+    return MoonSigns.indexOf(moon) + 1;
+}
+/**
+ * @param id Moon sign id
+ * @returns Name of moon sign else "None"
+ */
+export function signIdToName(id) {
+    return MoonSigns[id - 1] || "None";
+}

package/dist/overlappingNames.d.ts

@@ -0,0 +1,3 @@
+/** THIS FILE IS AUTOMATICALLY GENERATED. See tools/parseItemSkillNames.ts for more information */
+export declare const overlappingItemNames: string[];
+export declare const overlappingSkillNames: string[];

package/dist/overlappingNames.js

@@ -0,0 +1,42 @@
+/** THIS FILE IS AUTOMATICALLY GENERATED. See tools/parseItemSkillNames.ts for more information */
+export const overlappingItemNames = [
+    "spider web",
+    "really sticky spider web",
+    "dictionary",
+    "NG",
+    "Cloaca-Cola",
+    "yo-yo",
+    "top",
+    "ball",
+    "kite",
+    "yo",
+    "red potion",
+    "blue potion",
+    "bowling ball",
+    "adder",
+    "red button",
+    "pile of sand",
+    "mushroom",
+    "deluxe mushroom",
+];
+export const overlappingSkillNames = [
+    "Shoot",
+    "Thrust-Smack",
+    "Headbutt",
+    "Toss",
+    "Knife in the Dark",
+    "Sing",
+    "Disarm",
+    "LIGHT",
+    "BURN",
+    "Extract",
+    "Meteor Shower",
+    "Snipe",
+    "Bite",
+    "Kick",
+    "Howl",
+    "Cleave",
+    "Boil",
+    "Slice",
+    "Rainbow",
+];

package/dist/property.d.ts

@@ -0,0 +1,222 @@
+import { Bounty, Class, Coinmaster, Effect, Element, Familiar, Item, Location, Monster, Phylum, Servant, Skill, Slot, Stat, Thrall } from "kolmafia";
+import { BooleanProperty, FamiliarProperty, LocationProperty, MonsterProperty, NumericOrStringProperty, NumericProperty, PhylumProperty, StatProperty, StringProperty } from "./propertyTypes";
+import { KnownProperty } from "./propertyTyping";
+export declare const getString: (property: string, default_?: string | undefined) => string;
+export declare const getCommaSeparated: (property: string, default_?: string[] | undefined) => string[];
+export declare const getBoolean: (property: string, default_?: boolean | undefined) => boolean;
+export declare const getNumber: (property: string, default_?: number | undefined) => number;
+export declare const getBounty: (property: string, default_?: Bounty | undefined) => Bounty | null;
+export declare const getClass: (property: string, default_?: Class | undefined) => Class | null;
+export declare const getCoinmaster: (property: string, default_?: Coinmaster | undefined) => Coinmaster | null;
+export declare const getEffect: (property: string, default_?: Effect | undefined) => Effect | null;
+export declare const getElement: (property: string, default_?: Element | undefined) => Element | null;
+export declare const getFamiliar: (property: string, default_?: Familiar | undefined) => Familiar | null;
+export declare const getItem: (property: string, default_?: Item | undefined) => Item | null;
+export declare const getLocation: (property: string, default_?: Location | undefined) => Location | null;
+export declare const getMonster: (property: string, default_?: Monster | undefined) => Monster | null;
+export declare const getPhylum: (property: string, default_?: Phylum | undefined) => Phylum | null;
+export declare const getServant: (property: string, default_?: Servant | undefined) => Servant | null;
+export declare const getSkill: (property: string, default_?: Skill | undefined) => Skill | null;
+export declare const getSlot: (property: string, default_?: Slot | undefined) => Slot | null;
+export declare const getStat: (property: string, default_?: Stat | undefined) => Stat | null;
+export declare const getThrall: (property: string, default_?: Thrall | undefined) => Thrall | null;
+export declare function get(property: BooleanProperty): boolean;
+export declare function get(property: BooleanProperty, _default: boolean): boolean;
+export declare function get(property: NumericProperty): number;
+export declare function get(property: NumericProperty, _default: number): number;
+export declare function get(property: NumericOrStringProperty): number | string;
+export declare function get(property: NumericOrStringProperty, _default: number | string): number | string;
+export declare function get(property: StringProperty): string;
+export declare function get(property: StringProperty, _default: string): string;
+export declare function get(property: LocationProperty): Location | null;
+export declare function get(property: LocationProperty, _default: Location): Location;
+export declare function get(property: MonsterProperty): Monster | null;
+export declare function get(property: MonsterProperty, _default: Monster): Monster;
+export declare function get(property: FamiliarProperty): Familiar | null;
+export declare function get(property: FamiliarProperty, _default: Familiar): Familiar;
+export declare function get(property: StatProperty): Stat | null;
+export declare function get(property: StatProperty, _default: Stat): Stat;
+export declare function get(property: PhylumProperty): Phylum | null;
+export declare function get(property: PhylumProperty, _default: Phylum): Phylum;
+export declare function get(property: string, _default: Location): Location | null;
+export declare function get(property: string, _default: Monster): Monster | null;
+export declare function get(property: string, _default: Familiar): Familiar | null;
+export declare function get(property: string, _default: boolean): boolean;
+export declare function get(property: string, _default: number): number;
+export declare function get(property: string, _default?: string): string;
+export declare function set(property: BooleanProperty, value: boolean): boolean;
+export declare function set(property: NumericProperty, value: number): number;
+export declare function set<T extends number | string>(property: NumericOrStringProperty, value: T): T;
+export declare function set(property: StringProperty, value: string): string;
+export declare function set(property: LocationProperty, value: Location): Location;
+export declare function set(property: MonsterProperty, value: Monster): Monster;
+export declare function set(property: FamiliarProperty, value: Familiar): Familiar;
+export declare function set(property: StatProperty, value: Stat): Stat;
+export declare function set(property: PhylumProperty, value: Phylum): Phylum;
+export declare function set<D extends {
+    toString(): string;
+}>(property: string, value: D): D;
+/**
+ * Increment a property
+ *
+ * @param property Numeric property to increment
+ * @param delta Number by which to increment
+ * @param max Maximum value to set
+ * @returns New value
+ */
+export declare function increment(property: NumericProperty, delta?: number, max?: number): number;
+/**
+ * Decrement a property
+ *
+ * @param property Numeric property to decrement
+ * @param delta Number by which to decrement
+ * @param min Maximum value to set
+ * @returns New value
+ */
+export declare function decrement(property: NumericProperty, delta?: number, min?: number): number;
+declare type Properties = Partial<{
+    [P in KnownProperty]: unknown;
+}> & {
+    [x in string]: unknown;
+};
+/**
+ * Sets the value of a set of mafia properties
+ *
+ * @param properties Set of properties
+ */
+export declare function setProperties(properties: Properties): void;
+/**
+ * Carries out a callback during which a set of properties will be set as supplied
+ *
+ * @param properties Properties to set during callback
+ * @param callback Callback to execute with set properties
+ * @returns Return value of the supplied callback
+ */
+export declare function withProperties<T>(properties: Properties, callback: () => T): T;
+/**
+ * Carries out a callback during which a property will be set as supplied
+ *
+ * @param property Property to set during callback
+ * @param value Value to set property during callback
+ * @param callback Callback to execute with set properties
+ * @returns Return value of the supplied callback
+ */
+export declare function withProperty<P extends KnownProperty, T>(property: P, value: unknown, callback: () => T): T;
+/**
+ * Carries out a callback during which a set of choices will be handled as supplied
+ *
+ * @param choices Choices to set during callback
+ * @param callback Callback to execute with set choices
+ * @returns Return value of the supplied callback
+ */
+export declare function withChoices<T>(choices: {
+    [choice: number]: number | string;
+}, callback: () => T): T;
+/**
+ * Carries out a callback during which a choice will be handled as supplied
+ *
+ * @param choice Choice to set during callback
+ * @param value How to handle choice during callback
+ * @param callback Callback to execute with set properties
+ * @returns Return value of the supplied callback
+ */
+export declare function withChoice<T>(choice: number, value: number | string, callback: () => T): T;
+export declare class PropertiesManager {
+    private static EMPTY_PREFERENCE;
+    private properties;
+    get storedValues(): Properties;
+    /**
+     * Sets a collection of properties to the given values, storing the old values.
+     *
+     * @param propertiesToSet A Properties object, keyed by property name.
+     */
+    set(propertiesToSet: Properties): void;
+    /**
+     * Sets a collection of choice adventure properties to the given values, storing the old values.
+     *
+     * @param choicesToSet An object keyed by choice adventure number.
+     */
+    setChoices(choicesToSet: {
+        [choice: number]: number | string;
+    }): void;
+    /**
+     * Sets a single choice adventure property to the given value, storing the old value.
+     *
+     * @param choiceToSet The number of the choice adventure to set the property for.
+     * @param value The value to assign to that choice adventure.
+     */
+    setChoice(choiceToSet: number, value: number | string): void;
+    /**
+     * Resets the given properties to their original stored value. Does not delete entries from the manager.
+     *
+     * @param properties Collection of properties to reset.
+     */
+    reset(...properties: KnownProperty[]): void;
+    /**
+     * Iterates over all stored values, setting each property back to its original stored value. Does not delete entries from the manager.
+     */
+    resetAll(): void;
+    /**
+     * Stops storing the original values of inputted properties.
+     *
+     * @param properties Properties for the manager to forget.
+     */
+    clear(...properties: (KnownProperty | string)[]): void;
+    /**
+     * Clears all properties.
+     */
+    clearAll(): void;
+    /**
+     * Increases a numeric property to the given value if necessary.
+     *
+     * @param property The numeric property we want to potentially raise.
+     * @param value The minimum value we want that property to have.
+     * @returns Whether we needed to change the property.
+     */
+    setMinimumValue(property: NumericProperty, value: number): boolean;
+    /**
+     * Decrease a numeric property to the given value if necessary.
+     *
+     * @param property The numeric property we want to potentially lower.
+     * @param value The maximum value we want that property to have.
+     * @returns Whether we needed to change the property.
+     */
+    setMaximumValue(property: NumericProperty, value: number): boolean;
+    /**
+     * Creates a new PropertiesManager with identical stored values to this one.
+     *
+     * @returns A new PropertiesManager, with identical stored values to this one.
+     */
+    clone(): PropertiesManager;
+    /**
+     * Clamps a numeric property, modulating it up or down to fit within a specified range
+     *
+     * @param property The numeric property to clamp
+     * @param min The lower bound for what we want the property to be allowed to be.
+     * @param max The upper bound for what we want the property to be allowed to be.
+     * @returns Whether we ended up changing the property or not.
+     */
+    clamp(property: NumericProperty, min: number, max: number): boolean;
+    /**
+     * Determines whether this PropertiesManager has identical stored values to another.
+     *
+     * @param other The PropertiesManager to compare to this one.
+     * @returns Whether their StoredValues are identical.
+     */
+    equals(other: PropertiesManager): boolean;
+    /**
+     * Merges a PropertiesManager onto this one, letting the input win in the event that both PropertiesManagers have a value stored.
+     *
+     * @param other The PropertiesManager to be merged onto this one.
+     * @returns A new PropertiesManager with stored values from both its parents.
+     */
+    merge(other: PropertiesManager): PropertiesManager;
+    /**
+     * Merges an arbitrary collection of PropertiesManagers, letting the rightmost PropertiesManager win in the event of verlap.
+     *
+     * @param mergees The PropertiesManagers to merge together.
+     * @returns A PropertiesManager that is just an amalgam of all the constituents.
+     */
+    static merge(...mergees: PropertiesManager[]): PropertiesManager;
+}
+export {};

package/dist/property.js

@@ -0,0 +1,385 @@
+import { Bounty, Class, Coinmaster, Effect, Element, Familiar, getProperty, Item, Location, Monster, Phylum, propertyExists, removeProperty, Servant, setProperty, Skill, Slot, Stat, Thrall, toBounty, toClass, toCoinmaster, toEffect, toElement, toFamiliar, toItem, toLocation, toMonster, toPhylum, toServant, toSkill, toSlot, toStat, toThrall, } from "kolmafia";
+import { isBooleanProperty, isFamiliarProperty, isLocationProperty, isMonsterProperty, isNumericOrStringProperty, isNumericProperty, isPhylumProperty, isStatProperty, isStringProperty, } from "./propertyTyping";
+const createPropertyGetter = (transform) => (property, default_) => {
+    const value = getProperty(property);
+    if (default_ !== undefined && value === "") {
+        return default_;
+    }
+    return transform(value, property);
+};
+const createMafiaClassPropertyGetter = (Type, toType) => createPropertyGetter((value) => {
+    if (value === "")
+        return null;
+    const v = toType(value);
+    return v === Type.none ? null : v;
+});
+export const getString = createPropertyGetter((value) => value);
+export const getCommaSeparated = createPropertyGetter((value) => value.split(/, ?/));
+export const getBoolean = createPropertyGetter((value) => value === "true");
+export const getNumber = createPropertyGetter((value) => Number(value));
+export const getBounty = createMafiaClassPropertyGetter(Bounty, toBounty);
+export const getClass = createMafiaClassPropertyGetter(Class, toClass);
+export const getCoinmaster = createMafiaClassPropertyGetter(Coinmaster, toCoinmaster);
+export const getEffect = createMafiaClassPropertyGetter(Effect, toEffect);
+export const getElement = createMafiaClassPropertyGetter(Element, toElement);
+export const getFamiliar = createMafiaClassPropertyGetter(Familiar, toFamiliar);
+export const getItem = createMafiaClassPropertyGetter(Item, toItem);
+export const getLocation = createMafiaClassPropertyGetter(Location, toLocation);
+export const getMonster = createMafiaClassPropertyGetter(Monster, toMonster);
+export const getPhylum = createMafiaClassPropertyGetter(Phylum, toPhylum);
+export const getServant = createMafiaClassPropertyGetter(Servant, toServant);
+export const getSkill = createMafiaClassPropertyGetter(Skill, toSkill);
+export const getSlot = createMafiaClassPropertyGetter(Slot, toSlot);
+export const getStat = createMafiaClassPropertyGetter(Stat, toStat);
+export const getThrall = createMafiaClassPropertyGetter(Thrall, toThrall);
+/**
+ * Gets the value of a mafia property, either built in or custom
+ *
+ * @param property Name of the property
+ * @param _default Default value for the property to take if not set
+ * @returns Value of the mafia property
+ */
+export function get(property, _default) {
+    const value = getString(property);
+    // Handle known properties.
+    if (isBooleanProperty(property)) {
+        return getBoolean(property, _default) ?? false;
+    }
+    else if (isNumericProperty(property)) {
+        return getNumber(property, _default) ?? 0;
+    }
+    else if (isNumericOrStringProperty(property)) {
+        return value.match(/^\d+$/) ? parseInt(value) : value;
+    }
+    else if (isLocationProperty(property)) {
+        return getLocation(property, _default);
+    }
+    else if (isMonsterProperty(property)) {
+        return getMonster(property, _default);
+    }
+    else if (isFamiliarProperty(property)) {
+        return getFamiliar(property, _default);
+    }
+    else if (isStatProperty(property)) {
+        return getStat(property, _default);
+    }
+    else if (isPhylumProperty(property)) {
+        return getPhylum(property, _default);
+    }
+    else if (isStringProperty(property)) {
+        return value;
+    }
+    // Not a KnownProperty from here on out.
+    if (_default instanceof Location) {
+        return getLocation(property, _default);
+    }
+    else if (_default instanceof Monster) {
+        return getMonster(property, _default);
+    }
+    else if (_default instanceof Familiar) {
+        return getFamiliar(property, _default);
+    }
+    else if (_default instanceof Stat) {
+        return getStat(property, _default);
+    }
+    else if (_default instanceof Phylum) {
+        return getPhylum(property, _default);
+    }
+    else if (typeof _default === "boolean") {
+        return value === "true" ? true : value === "false" ? false : _default;
+    }
+    else if (typeof _default === "number") {
+        return value === "" ? _default : parseInt(value);
+    }
+    else if (value === "") {
+        return _default === undefined ? "" : _default;
+    }
+    else {
+        return value;
+    }
+}
+/**
+ * Sets the value of a mafia property, either built in or custom
+ *
+ * @param property Name of the property
+ * @param value Value to give the property
+ * @returns Value that was set
+ */
+export function set(property, value) {
+    const stringValue = value === null ? "" : value.toString();
+    setProperty(property, stringValue);
+    return value;
+}
+/**
+ * Increment a property
+ *
+ * @param property Numeric property to increment
+ * @param delta Number by which to increment
+ * @param max Maximum value to set
+ * @returns New value
+ */
+export function increment(property, delta = 1, max = Infinity) {
+    const value = get(property);
+    if (!isNumericProperty(property))
+        return value;
+    const nextValue = Math.min(max, value + delta);
+    return set(property, nextValue);
+}
+/**
+ * Decrement a property
+ *
+ * @param property Numeric property to decrement
+ * @param delta Number by which to decrement
+ * @param min Maximum value to set
+ * @returns New value
+ */
+export function decrement(property, delta = 1, min = Infinity) {
+    const value = get(property);
+    if (!isNumericProperty(property))
+        return value;
+    const nextValue = Math.max(min, value - delta);
+    return set(property, nextValue);
+}
+/**
+ * Sets the value of a set of mafia properties
+ *
+ * @param properties Set of properties
+ */
+export function setProperties(properties) {
+    for (const [prop, value] of Object.entries(properties)) {
+        set(prop, value);
+    }
+}
+/**
+ * Carries out a callback during which a set of properties will be set as supplied
+ *
+ * @param properties Properties to set during callback
+ * @param callback Callback to execute with set properties
+ * @returns Return value of the supplied callback
+ */
+export function withProperties(properties, callback) {
+    const propertiesBackup = Object.fromEntries(Object.entries(properties).map(([prop]) => [prop, get(prop)]));
+    setProperties(properties);
+    try {
+        return callback();
+    }
+    finally {
+        setProperties(propertiesBackup);
+    }
+}
+/**
+ * Carries out a callback during which a property will be set as supplied
+ *
+ * @param property Property to set during callback
+ * @param value Value to set property during callback
+ * @param callback Callback to execute with set properties
+ * @returns Return value of the supplied callback
+ */
+export function withProperty(property, value, callback) {
+    return withProperties({ [property]: value }, callback);
+}
+/**
+ * Carries out a callback during which a set of choices will be handled as supplied
+ *
+ * @param choices Choices to set during callback
+ * @param callback Callback to execute with set choices
+ * @returns Return value of the supplied callback
+ */
+export function withChoices(choices, callback) {
+    const properties = Object.fromEntries(Object.entries(choices).map(([choice, option]) => [
+        `choiceAdventure${choice}`,
+        option,
+    ]));
+    return withProperties(properties, callback);
+}
+/**
+ * Carries out a callback during which a choice will be handled as supplied
+ *
+ * @param choice Choice to set during callback
+ * @param value How to handle choice during callback
+ * @param callback Callback to execute with set properties
+ * @returns Return value of the supplied callback
+ */
+export function withChoice(choice, value, callback) {
+    return withChoices({ [choice]: value }, callback);
+}
+export class PropertiesManager {
+    static EMPTY_PREFERENCE = Symbol("empty preference");
+    properties = {};
+    get storedValues() {
+        return this.properties;
+    }
+    /**
+     * Sets a collection of properties to the given values, storing the old values.
+     *
+     * @param propertiesToSet A Properties object, keyed by property name.
+     */
+    set(propertiesToSet) {
+        for (const [propertyName, propertyValue] of Object.entries(propertiesToSet)) {
+            if (!(propertyName in this.properties)) {
+                this.properties[propertyName] = propertyExists(propertyName)
+                    ? get(propertyName)
+                    : PropertiesManager.EMPTY_PREFERENCE;
+            }
+            set(propertyName, propertyValue);
+        }
+    }
+    /**
+     * Sets a collection of choice adventure properties to the given values, storing the old values.
+     *
+     * @param choicesToSet An object keyed by choice adventure number.
+     */
+    setChoices(choicesToSet) {
+        this.set(Object.fromEntries(Object.entries(choicesToSet).map(([choiceNumber, choiceValue]) => [
+            `choiceAdventure${choiceNumber}`,
+            choiceValue,
+        ])));
+    }
+    /**
+     * Sets a single choice adventure property to the given value, storing the old value.
+     *
+     * @param choiceToSet The number of the choice adventure to set the property for.
+     * @param value The value to assign to that choice adventure.
+     */
+    setChoice(choiceToSet, value) {
+        this.setChoices({ [choiceToSet]: value });
+    }
+    /**
+     * Resets the given properties to their original stored value. Does not delete entries from the manager.
+     *
+     * @param properties Collection of properties to reset.
+     */
+    reset(...properties) {
+        for (const property of properties) {
+            if (!(property in this.properties))
+                continue;
+            const value = this.properties[property];
+            if (value === PropertiesManager.EMPTY_PREFERENCE) {
+                removeProperty(property);
+            }
+            else if (value) {
+                set(property, value);
+            }
+            else {
+                set(property, "");
+            }
+        }
+    }
+    /**
+     * Iterates over all stored values, setting each property back to its original stored value. Does not delete entries from the manager.
+     */
+    resetAll() {
+        setProperties(this.properties);
+    }
+    /**
+     * Stops storing the original values of inputted properties.
+     *
+     * @param properties Properties for the manager to forget.
+     */
+    clear(...properties) {
+        for (const property of properties) {
+            if (this.properties[property]) {
+                delete this.properties[property];
+            }
+        }
+    }
+    /**
+     * Clears all properties.
+     */
+    clearAll() {
+        this.properties = {};
+    }
+    /**
+     * Increases a numeric property to the given value if necessary.
+     *
+     * @param property The numeric property we want to potentially raise.
+     * @param value The minimum value we want that property to have.
+     * @returns Whether we needed to change the property.
+     */
+    setMinimumValue(property, value) {
+        if (get(property, 0) < value) {
+            this.set({ [property]: value });
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Decrease a numeric property to the given value if necessary.
+     *
+     * @param property The numeric property we want to potentially lower.
+     * @param value The maximum value we want that property to have.
+     * @returns Whether we needed to change the property.
+     */
+    setMaximumValue(property, value) {
+        if (get(property, 0) > value) {
+            this.set({ [property]: value });
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Creates a new PropertiesManager with identical stored values to this one.
+     *
+     * @returns A new PropertiesManager, with identical stored values to this one.
+     */
+    clone() {
+        const newGuy = new PropertiesManager();
+        newGuy.properties = this.storedValues;
+        return newGuy;
+    }
+    /**
+     * Clamps a numeric property, modulating it up or down to fit within a specified range
+     *
+     * @param property The numeric property to clamp
+     * @param min The lower bound for what we want the property to be allowed to be.
+     * @param max The upper bound for what we want the property to be allowed to be.
+     * @returns Whether we ended up changing the property or not.
+     */
+    clamp(property, min, max) {
+        if (max < min)
+            return false;
+        const start = get(property);
+        this.setMinimumValue(property, min);
+        this.setMaximumValue(property, max);
+        return start !== get(property);
+    }
+    /**
+     * Determines whether this PropertiesManager has identical stored values to another.
+     *
+     * @param other The PropertiesManager to compare to this one.
+     * @returns Whether their StoredValues are identical.
+     */
+    equals(other) {
+        const thisProps = Object.entries(this.storedValues);
+        const otherProps = new Map(Object.entries(other.storedValues));
+        if (thisProps.length !== otherProps.size)
+            return false;
+        for (const [propertyName, propertyValue] of thisProps) {
+            if (otherProps.get(propertyName) === propertyValue)
+                return false;
+        }
+        return true;
+    }
+    /**
+     * Merges a PropertiesManager onto this one, letting the input win in the event that both PropertiesManagers have a value stored.
+     *
+     * @param other The PropertiesManager to be merged onto this one.
+     * @returns A new PropertiesManager with stored values from both its parents.
+     */
+    merge(other) {
+        const newGuy = new PropertiesManager();
+        newGuy.properties = { ...this.properties, ...other.properties };
+        return newGuy;
+    }
+    /**
+     * Merges an arbitrary collection of PropertiesManagers, letting the rightmost PropertiesManager win in the event of verlap.
+     *
+     * @param mergees The PropertiesManagers to merge together.
+     * @returns A PropertiesManager that is just an amalgam of all the constituents.
+     */
+    static merge(...mergees) {
+        if (mergees.length === 0)
+            return new PropertiesManager();
+        return mergees.reduce((a, b) => a.merge(b));
+    }
+}