@zthun/romulator-client 1.15.0 → 1.17.0

package/dist/index.js

@@ -1,6 +1,6 @@
 import { ZMetadataBuilder } from '@zthun/helpful-query';
 import { firstDefined, castExtension } from '@zthun/helpful-fn';
-import { castArray, get, omitBy, isUndefined, keyBy, kebabCase, uniqBy, lowerCase } from 'lodash-es';
+import { castArray, get, keyBy, omitBy, isUndefined, kebabCase, uniqBy, lowerCase } from 'lodash-es';
 import { sep, extname, basename } from 'node:path';
 
 class ZRomulatorConfigGamesMetadata {
@@ -14,7 +14,7 @@ class ZRomulatorConfigGamesMetadata {
     }
 }
 
-function _define_property$4(obj, key, value) {
+function _define_property$5(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -47,11 +47,11 @@ class ZRomulatorConfigGamesBuilder {
         return structuredClone(this._config);
     }
     constructor(){
-        _define_property$4(this, "_config", {});
+        _define_property$5(this, "_config", {});
     }
 }
 
-function _define_property$3(obj, key, value) {
+function _define_property$4(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -113,7 +113,7 @@ class ZRomulatorConfigBuilder {
         return structuredClone(this._config);
     }
     constructor(){
-        _define_property$3(this, "_config", {
+        _define_property$4(this, "_config", {
             id: "games",
             name: "",
             file: ""
@@ -121,7 +121,7 @@ class ZRomulatorConfigBuilder {
     }
 }
 
-function _define_property$2(obj, key, value) {
+function _define_property$3(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
             value: value,
@@ -135,58 +135,48 @@ function _define_property$2(obj, key, value) {
     return obj;
 }
 /**
- * A builder for the IZRomulatorGame model.
- */ class ZRomulatorGameBuilder {
+ * Creates player range instances
+ */ class ZRomulatorPlayersBuilder {
     /**
-   * Sets the unique id for the game.
+   * Sets the minimum supported players.
    *
-   * @param id -
-   *        The unique identifier across all games and systems.
-   * @returns
-   *        This instance.
-   */ id(id) {
-        this._game.id = id;
-        return this;
-    }
-    /**
-   * Sets the display name for the game.
+   * @param players -
+   *        Minimum number of players.
    *
-   * @param name -
-   *        The canonical display name for the game.
    * @returns
-   *        This instance.
-   */ name(name) {
-        this._game.name = name;
+   *        This object.
+   */ min(players) {
+        this._players.min = players;
         return this;
     }
     /**
-   * Sets the file path for the rom.
+   * Sets the maximum supported players.
    *
-   * @param path -
-   *        The fully qualified path to the game file.
-   * @returns
-   *        This instance.
-   */ file(path) {
-        this._game.file = path;
-        return this;
-    }
-    /**
-   * Sets the system the game belongs to.
+   * @param players -
+   *        Maximum number of players.
    *
-   * @param system -
-   *        The owning system id.
    * @returns
-   *        This instance.
-   */ system(system) {
-        this._game.system = system;
+   *        This object.
+   */ max(players) {
+        this._players.max = players;
         return this;
     }
+    range(min, max) {
+        return this.min(min).max(max);
+    }
+    parseMax(candidate) {
+        const max = get(candidate, "max");
+        return typeof max === "number" ? this.max(max) : this;
+    }
+    parseMin(candidate) {
+        const min = get(candidate, "min");
+        return typeof min === "number" ? this.min(min) : this;
+    }
     /**
-   * Attempts to parse a game from a game entry in a system.json game
-   * list.
+   * Attempts to read player range values from an arbitrary candidate.
    *
    * @param candidate -
-   *        The candidate to parse.
+   *        Source object to inspect.
    *
    * @returns
    *        This object.
@@ -194,101 +184,58 @@ function _define_property$2(obj, key, value) {
         if (candidate == null || typeof candidate !== "object") {
             return this;
         }
-        const name = get(candidate, "name");
-        if (name != null && typeof name === "string") {
-            this.name(name);
-        }
-        return this;
+        return this.parseMin(candidate).parseMax(candidate);
     }
     /**
-   * Copies an existing game into this builder.
+   * Copies an existing player range into this builder.
    *
    * @param other -
-   *        The other game to copy.
+   *        Players object to duplicate.
+   *
    * @returns
-   *        This instance.
+   *        This object
    */ copy(other) {
-        this._game = structuredClone(other);
+        this._players = structuredClone(other);
         return this;
     }
     /**
-   * Builds the game instance.
+   * Creates the final player range instance.
    *
    * @returns
-   *        A structured clone of the current game with undefined properties removed.
+   *        A cloned IZRomulatorPlayers instance.
    */ build() {
-        const clone = structuredClone(this._game);
-        return omitBy(clone, isUndefined);
+        return structuredClone(this._players);
     }
     constructor(){
-        _define_property$2(this, "_game", {
-            id: ""
+        _define_property$3(this, "_players", {
+            min: 1,
+            max: 1
         });
-    }
-}
-
-var ZRomulatorGameMediaType = /*#__PURE__*/ function(ZRomulatorGameMediaType) {
-    /**
-   * A 3d representation of the box art.
-   */ ZRomulatorGameMediaType["Box3d"] = "3dboxes";
-    /**
-   * Back of the game box.
-   */ ZRomulatorGameMediaType["BackCover"] = "backcovers";
-    /**
-   * Front of the game box.
-   */ ZRomulatorGameMediaType["Cover"] = "covers";
-    /**
-   * Fan art.
-   */ ZRomulatorGameMediaType["FanArt"] = "fanart";
-    /**
-   * Game manual.
-   */ ZRomulatorGameMediaType["Manual"] = "manuals";
-    /**
-   * A marquee of a game.
-   */ ZRomulatorGameMediaType["Marquee"] = "marquees";
-    /**
-   * The cartridge or disc label.
-   */ ZRomulatorGameMediaType["PhysicalMedia"] = "physicalmedia";
-    /**
-   * An in game screenshot showcasing gameplay.
-   */ ZRomulatorGameMediaType["Screenshot"] = "screenshots";
-    /**
-   * An in game screenshot of the title screen.
-   */ ZRomulatorGameMediaType["Title"] = "titlescreens";
-    /**
-   * A video showcasing the game.
-   */ ZRomulatorGameMediaType["Video"] = "videos";
-    return ZRomulatorGameMediaType;
-}({});
-/**
- * Media type for a system.
- */ var ZRomulatorSystemMediaType = /*#__PURE__*/ function(ZRomulatorSystemMediaType) {
-    /**
-   * An image of a system's controller.
-   */ ZRomulatorSystemMediaType["Controller"] = "controller";
-    /**
-   * A picture of the system.
+        /**
+   * Sets the player count to 1 player for both min and max.
    *
-   * These are real life looking photos of what
-   * a system looks like.
-   */ ZRomulatorSystemMediaType["Picture"] = "picture";
-    /**
-   * A wheel for a system.
+   * @returns
+   *        This object.
+   */ _define_property$3(this, "singlePlayer", this.range.bind(this, 1, 1));
+        /**
+   * Sets the player count to 2 for max and 1 for min.
    *
-   * This is basically the logo.
-   */ ZRomulatorSystemMediaType["Wheel"] = "wheel";
-    return ZRomulatorSystemMediaType;
-}({});
-const ZRomulatorSystemMediaTypeMap = keyBy(Object.values(ZRomulatorSystemMediaType));
-const ZRomulatorGameMediaTypeMap = keyBy(Object.values(ZRomulatorGameMediaType));
-function isSystemMediaType(candidate) {
-    return typeof candidate === "string" && Object.prototype.hasOwnProperty.call(ZRomulatorSystemMediaTypeMap, candidate);
-}
-function isGameMediaType(candidate) {
-    return typeof candidate === "string" && Object.prototype.hasOwnProperty.call(ZRomulatorGameMediaTypeMap, candidate);
-}
-function isMediaType(candidate) {
-    return isSystemMediaType(candidate) || isGameMediaType(candidate);
+   * @returns
+   *        This object.
+   */ _define_property$3(this, "twoPlayer", this.range.bind(this, 1, 2));
+        /**
+   * Sets the player count to 4 for max and 1 for min.
+   *
+   * @returns
+   *        This object.
+   */ _define_property$3(this, "fourPlayer", this.range.bind(this, 1, 4));
+        /**
+   * Sets the player count to 8 for max and 1 for min.
+   *
+   * @returns
+   *        This object.
+   */ _define_property$3(this, "eightPlayer", this.range.bind(this, 1, 8));
+    }
 }
 
 /**
@@ -474,6 +421,259 @@ const ZRomulatorSystemIdMap = keyBy(Object.values(ZRomulatorSystemId));
     return typeof candidate === "string" && Object.prototype.hasOwnProperty.call(ZRomulatorSystemIdMap, candidate);
 }
 
+function _define_property$2(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * A builder for the IZRomulatorGame model.
+ */ class ZRomulatorGameBuilder {
+    /**
+   * Sets the unique id for the game.
+   *
+   * @param id -
+   *        The unique identifier across all games and systems.
+   * @returns
+   *        This instance.
+   */ id(id) {
+        this._game.id = id;
+        return this;
+    }
+    /**
+   * Sets the display name for the game.
+   *
+   * @param name -
+   *        The canonical display name for the game.
+   * @returns
+   *        This instance.
+   */ name(name) {
+        this._game.name = name;
+        return this;
+    }
+    /**
+   * Sets the file path for the rom.
+   *
+   * @param path -
+   *        The fully qualified path to the game file.
+   * @returns
+   *        This instance.
+   */ file(path) {
+        this._game.file = path;
+        return this;
+    }
+    /**
+   * Sets the system the game belongs to.
+   *
+   * @param system -
+   *        The owning system id.
+   * @returns
+   *        This instance.
+   */ system(system) {
+        this._game.system = system;
+        return this;
+    }
+    /**
+   * Sets the release date for the game.
+   *
+   * @param release -
+   *        The release information for the game.
+   * @returns
+   *        This instance.
+   */ release(release) {
+        this._game.release = release;
+        return this;
+    }
+    /**
+   * Sets the developer studio for the game.
+   *
+   * @param developer -
+   *        The developer name.
+   * @returns
+   *        This instance.
+   */ developer(developer) {
+        this._game.developer = developer;
+        return this;
+    }
+    /**
+   * Sets the publisher studio for the game.
+   *
+   * @param publisher -
+   *        The publisher name.
+   * @returns
+   *        This instance.
+   */ publisher(publisher) {
+        this._game.publisher = publisher;
+        return this;
+    }
+    /**
+   * Sets the description for the game.
+   *
+   * @param description -
+   *        The game description.
+   * @returns
+   *        This instance.
+   */ description(description) {
+        this._game.description = description;
+        return this;
+    }
+    /**
+   * Sets the player configuration for the game.
+   *
+   * @param players -
+   *        The player configuration.
+   * @returns
+   *        This instance.
+   */ players(players) {
+        this._game.players = new ZRomulatorPlayersBuilder().copy(players).build();
+        return this;
+    }
+    parseDeveloper(candidate) {
+        const developer = get(candidate, "developer");
+        return typeof developer === "string" ? this.developer(developer) : this;
+    }
+    parsePublisher(candidate) {
+        const publisher = get(candidate, "publisher");
+        return typeof publisher === "string" ? this.publisher(publisher) : this;
+    }
+    parseReleaseDate(candidate) {
+        const release = get(candidate, "release");
+        return typeof release == "string" ? this.release(release) : this;
+    }
+    parsePlayers(candidate) {
+        const players = get(candidate, "players");
+        return this.players(new ZRomulatorPlayersBuilder().copy(this._game.players).parse(players).build());
+    }
+    parseDescription(candidate) {
+        const description = get(candidate, "description");
+        return typeof description === "string" ? this.description(description) : this;
+    }
+    parseName(candidate) {
+        const name = get(candidate, "name");
+        return typeof name === "string" ? this.name(name) : this;
+    }
+    /**
+   * Attempts to parse a game from a game entry in a system.json game
+   * list.
+   *
+   * @param candidate -
+   *        The candidate to parse.
+   *
+   * @returns
+   *        This object.
+   */ parse(candidate) {
+        if (candidate == null || typeof candidate !== "object") {
+            return this;
+        }
+        return this.parseName(candidate).parseDescription(candidate).parsePlayers(candidate).parseReleaseDate(candidate).parseDeveloper(candidate).parsePublisher(candidate);
+    }
+    /**
+   * Copies an existing game into this builder.
+   *
+   * @param other -
+   *        The other game to copy.
+   * @returns
+   *        This instance.
+   */ copy(other) {
+        this._game = structuredClone(other);
+        return this;
+    }
+    /**
+   * Builds the game instance.
+   *
+   * @returns
+   *        A structured clone of the current game with undefined properties removed.
+   */ build() {
+        const clone = structuredClone(this._game);
+        return omitBy(clone, isUndefined);
+    }
+    constructor(){
+        _define_property$2(this, "_game", {
+            id: "",
+            name: "",
+            file: "",
+            system: ZRomulatorSystemId.Adam,
+            release: "",
+            description: "",
+            developer: "",
+            publisher: "",
+            players: new ZRomulatorPlayersBuilder().build()
+        });
+    }
+}
+
+var ZRomulatorGameMediaType = /*#__PURE__*/ function(ZRomulatorGameMediaType) {
+    /**
+   * A 3d representation of the box art.
+   */ ZRomulatorGameMediaType["Box3d"] = "3dboxes";
+    /**
+   * Back of the game box.
+   */ ZRomulatorGameMediaType["BackCover"] = "backcovers";
+    /**
+   * Front of the game box.
+   */ ZRomulatorGameMediaType["Cover"] = "covers";
+    /**
+   * Fan art.
+   */ ZRomulatorGameMediaType["FanArt"] = "fanart";
+    /**
+   * Game manual.
+   */ ZRomulatorGameMediaType["Manual"] = "manuals";
+    /**
+   * A marquee of a game.
+   */ ZRomulatorGameMediaType["Marquee"] = "marquees";
+    /**
+   * The cartridge or disc label.
+   */ ZRomulatorGameMediaType["PhysicalMedia"] = "physicalmedia";
+    /**
+   * An in game screenshot showcasing gameplay.
+   */ ZRomulatorGameMediaType["Screenshot"] = "screenshots";
+    /**
+   * An in game screenshot of the title screen.
+   */ ZRomulatorGameMediaType["Title"] = "titlescreens";
+    /**
+   * A video showcasing the game.
+   */ ZRomulatorGameMediaType["Video"] = "videos";
+    return ZRomulatorGameMediaType;
+}({});
+/**
+ * Media type for a system.
+ */ var ZRomulatorSystemMediaType = /*#__PURE__*/ function(ZRomulatorSystemMediaType) {
+    /**
+   * An image of a system's controller.
+   */ ZRomulatorSystemMediaType["Controller"] = "controller";
+    /**
+   * A picture of the system.
+   *
+   * These are real life looking photos of what
+   * a system looks like.
+   */ ZRomulatorSystemMediaType["Picture"] = "picture";
+    /**
+   * A wheel for a system.
+   *
+   * This is basically the logo.
+   */ ZRomulatorSystemMediaType["Wheel"] = "wheel";
+    return ZRomulatorSystemMediaType;
+}({});
+const ZRomulatorSystemMediaTypeMap = keyBy(Object.values(ZRomulatorSystemMediaType));
+const ZRomulatorGameMediaTypeMap = keyBy(Object.values(ZRomulatorGameMediaType));
+function isSystemMediaType(candidate) {
+    return typeof candidate === "string" && Object.prototype.hasOwnProperty.call(ZRomulatorSystemMediaTypeMap, candidate);
+}
+function isGameMediaType(candidate) {
+    return typeof candidate === "string" && Object.prototype.hasOwnProperty.call(ZRomulatorGameMediaTypeMap, candidate);
+}
+function isMediaType(candidate) {
+    return isSystemMediaType(candidate) || isGameMediaType(candidate);
+}
+
 function _define_property$1(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
@@ -556,6 +756,21 @@ function _define_property$1(obj, key, value) {
     }
 }
 
+/**
+ * Represents a serializer for a players object.
+ *
+ * The serialized form of players is a single digit if min and max are equal, or
+ * a range string of #min-#max if they are different.
+ */ class ZRomulatorPlayersSerialize {
+    serialize(candidate) {
+        if (candidate == null) {
+            return undefined;
+        }
+        const { min, max } = candidate;
+        return min === max ? `${min}` : `${min}-${max}`;
+    }
+}
+
 /**
  * The type of media content for a system.
  */ var ZRomulatorSystemContentType = /*#__PURE__*/ function(ZRomulatorSystemContentType) {
@@ -814,7 +1029,7 @@ function _define_property(obj, key, value) {
    * @returns
    *        This object.
    */ extension(extension) {
-        const { extensions: current } = this._system;
+        const current = this._system.extensions.slice();
         const extensions = castArray(extension).map((e)=>castExtension(e));
         const unique = uniqBy(current.concat(extensions), lowerCase);
         this._system.extensions = unique.filter((e)=>e != null).map((e)=>e?.toLowerCase());
@@ -910,5 +1125,5 @@ function _define_property(obj, key, value) {
     }
 }
 
-export { ZRomulatorConfigBuilder, ZRomulatorConfigGamesBuilder, ZRomulatorConfigGamesMetadata, ZRomulatorConfigId, ZRomulatorGameBuilder, ZRomulatorGameMediaType, ZRomulatorMediaBuilder, ZRomulatorSystemBuilder, ZRomulatorSystemContentType, ZRomulatorSystemHardwareType, ZRomulatorSystemId, ZRomulatorSystemMediaFormat, ZRomulatorSystemMediaType, isGameMediaType, isMediaType, isSystemContentType, isSystemHardwareType, isSystemId, isSystemMediaFormat, isSystemMediaType };
+export { ZRomulatorConfigBuilder, ZRomulatorConfigGamesBuilder, ZRomulatorConfigGamesMetadata, ZRomulatorConfigId, ZRomulatorGameBuilder, ZRomulatorGameMediaType, ZRomulatorMediaBuilder, ZRomulatorPlayersBuilder, ZRomulatorPlayersSerialize, ZRomulatorSystemBuilder, ZRomulatorSystemContentType, ZRomulatorSystemHardwareType, ZRomulatorSystemId, ZRomulatorSystemMediaFormat, ZRomulatorSystemMediaType, isGameMediaType, isMediaType, isSystemContentType, isSystemHardwareType, isSystemId, isSystemMediaFormat, isSystemMediaType };
 //# sourceMappingURL=index.js.map