@bscotch/yy 0.2.0

package/README.md

@@ -0,0 +1,43 @@
+# GameMaker `yy` and `yyp` parser/stringifier
+
+Read and write GameMaker's `.yyp` and `.yy` files!
+
+[GameMaker](https://gamemaker.io/en) projects consist of a variety of filetypes, with much of the core metadata described in the project root `.yyp` file and resource-specific `.yy` files. Being able to manipulate these files programmatically, outside of GameMaker's editor, is useful for building custom pipelines.
+
+This package provides parsing, stringifying, and reading/writing of GameMaker's `.yyp` and `.yy` files.
+
+## Why use this package?
+
+`yy` and `yyp` files are JSON-ish, but don't follow the JSON spec. In general, existing JSON utilities either won't be able to read `yy` files successfully or will write them differently from how GameMaker does it. In the latter case the files might still be functional, but will be reformatted by GameMaker and therefore act as a source of version control noise.
+
+How these files depart from JSON:
+
+- The files include trailing slashes, which are invalid in JSON
+- Files can include large integers that are beyond the range of default `Number` types
+- The spacing behavior does not match typical JSON prettifying behavior
+
+## Requirements
+
+- Node.js v16+
+- A Node.js project in which you want to use this package.
+
+## Installation
+
+In your project root:
+
+- npm install @bscotch/yy
+
+## Usage
+
+In your Node code:
+
+```ts
+// In Typescript, or in an ES6 module:
+import { Yy } from '@bscotch/yy';
+
+// Has sync and async versions.
+let parsedFile = Yy.readSync('./my-project.yyp');
+parsedFile = await Yy.read('./my-project.yyp');
+
+const reStringified = Yy.stringify(parsedFile);
+```

package/dist/Yy.d.ts

@@ -0,0 +1,23 @@
+export declare class Yy {
+    /**
+     * Stringify an object into a Yy-formatted string,
+     * including trailing commas.
+     *
+     * Supports BigInt.
+     */
+    static stringify(yyObject: any): string;
+    static parse<T = unknown>(yyString: string): T;
+    static read<T = unknown>(filePath: string): Promise<T>;
+    static readSync<T = unknown>(filePath: string): T;
+    /**
+     * If the file already exists
+     * its contents will be read first and the
+     * new content will only be written if it
+     * is different. This is to reduce file-watcher
+     * noise, since excess file-write events can
+     * cause problems with GameMaker.
+     */
+    static write(filePath: string, yyData: any): Promise<void>;
+    static writeSync(filePath: string, yyData: any): void;
+}
+//# sourceMappingURL=Yy.d.ts.map

package/dist/Yy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Yy.d.ts","sourceRoot":"","sources":["../src/Yy.ts"],"names":[],"mappings":"AAMA,qBAAa,EAAE;IACb;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG;IAI9B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC;WAIjC,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAI5D,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC;IAIjD;;;;;;;OAOG;WACU,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG;IAiBhD,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG;CAY/C"}

package/dist/Yy.js

@@ -0,0 +1,79 @@
+import fs from 'fs';
+import fsp from 'fs/promises';
+import path from 'path';
+import { parseYy } from './Yy.parse.js';
+import { stringifyYy } from './Yy.stringify.js';
+export class Yy {
+    /**
+     * Stringify an object into a Yy-formatted string,
+     * including trailing commas.
+     *
+     * Supports BigInt.
+     */
+    static stringify(yyObject) {
+        return stringifyYy(yyObject);
+    }
+    static parse(yyString) {
+        return parseYy(yyString);
+    }
+    static async read(filePath) {
+        return parseYy(await fsp.readFile(filePath, 'utf8'));
+    }
+    static readSync(filePath) {
+        return parseYy(fs.readFileSync(filePath, 'utf8'));
+    }
+    /**
+     * If the file already exists
+     * its contents will be read first and the
+     * new content will only be written if it
+     * is different. This is to reduce file-watcher
+     * noise, since excess file-write events can
+     * cause problems with GameMaker.
+     */
+    static async write(filePath, yyData) {
+        const stringifiedStuff = stringifyYy(yyData);
+        await fsp.mkdir(path.dirname(filePath), { recursive: true });
+        // Only clobber if the target is a file with different
+        // contents. This is to prevent file-watcher triggers from
+        // creating noise.
+        if (await exists(filePath)) {
+            // If the existing file is identical, do nothing.
+            const currentContent = await fsp.readFile(filePath, 'utf8');
+            if (currentContent === stringifiedStuff) {
+                return;
+            }
+        }
+        await fsp.writeFile(filePath, stringifiedStuff);
+    }
+    static writeSync(filePath, yyData) {
+        const stringifiedStuff = stringifyYy(yyData);
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        if (existsSync(filePath)) {
+            // If the existing file is identical, do nothing.
+            const currentContent = fs.readFileSync(filePath, 'utf8');
+            if (currentContent === stringifiedStuff) {
+                return;
+            }
+        }
+        fs.writeFileSync(filePath, stringifiedStuff);
+    }
+}
+async function exists(filepath) {
+    try {
+        await fsp.stat(filepath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function existsSync(filepath) {
+    try {
+        fs.statSync(filepath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=Yy.js.map

package/dist/Yy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Yy.js","sourceRoot":"","sources":["../src/Yy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,GAAG,MAAM,aAAa,CAAC;AAC9B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,EAAE;IACb;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,QAAa;QAC5B,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,KAAK,CAAc,QAAgB;QACxC,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAI,CAAc,QAAgB;QAC7C,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,QAAQ,CAAc,QAAgB;QAC3C,OAAO,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,MAAW;QAC9C,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE7D,sDAAsD;QACtD,0DAA0D;QAC1D,kBAAkB;QAClB,IAAI,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE;YAC1B,iDAAiD;YACjD,MAAM,cAAc,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC5D,IAAI,cAAc,KAAK,gBAAgB,EAAE;gBACvC,OAAO;aACR;SACF;QACD,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,QAAgB,EAAE,MAAW;QAC5C,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE;YACxB,iDAAiD;YACjD,MAAM,cAAc,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACzD,IAAI,cAAc,KAAK,gBAAgB,EAAE;gBACvC,OAAO;aACR;SACF;QACD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAC/C,CAAC;CACF;AAED,KAAK,UAAU,MAAM,CAAC,QAAgB;IACpC,IAAI;QACF,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;KACb;IAAC,MAAM;QACN,OAAO,KAAK,CAAC;KACd;AACH,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB;IAClC,IAAI;QACF,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;KACb;IAAC,MAAM;QACN,OAAO,KAAK,CAAC;KACd;AACH,CAAC"}

package/dist/Yy.parse.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @file Modified from public domain code: https://github.com/sidorares/json-bigint/blob/master/lib/parse.js
+ */
+export declare function parseYy(source: string): any;
+//# sourceMappingURL=Yy.parse.d.ts.map

package/dist/Yy.parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Yy.parse.d.ts","sourceRoot":"","sources":["../src/Yy.parse.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,OAyPrC"}

package/dist/Yy.parse.js

@@ -0,0 +1,241 @@
+/**
+ * @file Modified from public domain code: https://github.com/sidorares/json-bigint/blob/master/lib/parse.js
+ */
+const suspectProtoRx = /(?:_|\\u005[Ff])(?:_|\\u005[Ff])(?:p|\\u0070)(?:r|\\u0072)(?:o|\\u006[Ff])(?:t|\\u0074)(?:o|\\u006[Ff])(?:_|\\u005[Ff])(?:_|\\u005[Ff])/;
+const suspectConstructorRx = /(?:c|\\u0063)(?:o|\\u006[Ff])(?:n|\\u006[Ee])(?:s|\\u0073)(?:t|\\u0074)(?:r|\\u0072)(?:u|\\u0075)(?:c|\\u0063)(?:t|\\u0074)(?:o|\\u006[Ff])(?:r|\\u0072)/;
+const escapee = {
+    '"': '"',
+    '\\': '\\',
+    '/': '/',
+    b: '\b',
+    f: '\f',
+    n: '\n',
+    r: '\r',
+    t: '\t',
+};
+export function parseYy(source) {
+    // Clear trailing commas
+    source = source.replace(/,(\s*[}\]])/g, '$1');
+    /** Index of the current character */
+    let at = 0;
+    /** The current character */
+    let ch = ' ';
+    const text = source;
+    function error(m) {
+        throw {
+            name: 'SyntaxError',
+            message: m,
+            at: at,
+            text: text,
+        };
+    }
+    function next(c) {
+        // If a c parameter is provided, verify that it matches the current character.
+        if (c && c !== ch) {
+            error("Expected '" + c + "' instead of '" + ch + "'");
+        }
+        // Get the next character. When there are no more characters,
+        // return the empty string.
+        ch = text.charAt(at);
+        at += 1;
+        return ch;
+    }
+    function number() {
+        // Parse a number value.
+        let str = '';
+        if (ch === '-') {
+            str = '-';
+            next('-');
+        }
+        while (ch >= '0' && ch <= '9') {
+            str += ch;
+            next();
+        }
+        if (ch === '.') {
+            str += '.';
+            while (next() && ch >= '0' && ch <= '9') {
+                str += ch;
+            }
+        }
+        if (ch === 'e' || ch === 'E') {
+            str += ch;
+            next();
+            if (ch === '-' || ch === '+') {
+                str += ch;
+                next();
+            }
+            while (ch >= '0' && ch <= '9') {
+                str += ch;
+                next();
+            }
+        }
+        // Store as a BigInt if
+        // 1. it's an integer, and
+        // 2. it's too big to store as a vanilla number.
+        // (BigInts can only be parsed from purely-numeric strings)
+        const num = +str;
+        if (!str.includes('.')) {
+            const asBigInt = BigInt(str);
+            if (asBigInt > Number.MAX_SAFE_INTEGER) {
+                return asBigInt;
+            }
+        }
+        return num;
+    }
+    function string() {
+        // Parse a string value.
+        let hex, i, string = '', uffff;
+        // When parsing for string values, we must look for " and \ characters.
+        if (ch === '"') {
+            let startAt = at;
+            while (next()) {
+                if (ch === '"') {
+                    if (at - 1 > startAt)
+                        string += text.substring(startAt, at - 1);
+                    next();
+                    return string;
+                }
+                if (ch === '\\') {
+                    if (at - 1 > startAt)
+                        string += text.substring(startAt, at - 1);
+                    next();
+                    if (ch === 'u') {
+                        uffff = 0;
+                        for (i = 0; i < 4; i += 1) {
+                            hex = parseInt(next(), 16);
+                            if (!isFinite(hex)) {
+                                break;
+                            }
+                            uffff = uffff * 16 + hex;
+                        }
+                        string += String.fromCharCode(uffff);
+                    }
+                    else if (typeof escapee[ch] === 'string') {
+                        string += escapee[ch];
+                    }
+                    else {
+                        break;
+                    }
+                    startAt = at;
+                }
+            }
+        }
+        error('Bad string');
+    }
+    function white() {
+        // Skip whitespace.
+        while (ch && ch <= ' ') {
+            next();
+        }
+    }
+    function word() {
+        // true, false, or null.
+        switch (ch) {
+            case 't':
+                next('t');
+                next('r');
+                next('u');
+                next('e');
+                return true;
+            case 'f':
+                next('f');
+                next('a');
+                next('l');
+                next('s');
+                next('e');
+                return false;
+            case 'n':
+                next('n');
+                next('u');
+                next('l');
+                next('l');
+                return null;
+        }
+        error("Unexpected '" + ch + "'");
+    }
+    function value() {
+        // Parse a JSON value. It could be an object, an array, a string, a number,
+        // or a word.
+        white();
+        switch (ch) {
+            case '{':
+                return object();
+            case '[':
+                return array();
+            case '"':
+                return string();
+            case '-':
+                return number();
+            default:
+                return ch >= '0' && ch <= '9' ? number() : word();
+        }
+    }
+    function array() {
+        // Parse an array value.
+        const array = [];
+        if (ch === '[') {
+            next('[');
+            white();
+            if (ch === ']') {
+                next(']');
+                return array; // empty array
+            }
+            while (ch) {
+                array.push(value());
+                white();
+                if (ch === ']') {
+                    next(']');
+                    return array;
+                }
+                next(',');
+                white();
+            }
+        }
+        error('Bad array');
+    }
+    function object() {
+        // Parse an object value.
+        let key;
+        const obj = Object.create(null);
+        if (ch === '{') {
+            next('{');
+            white();
+            if (ch === '}') {
+                next('}');
+                return obj; // empty object
+            }
+            while (ch) {
+                key = string();
+                white();
+                next(':');
+                if (Object.hasOwnProperty.call(obj, key)) {
+                    error('Duplicate key "' + key + '"');
+                }
+                if (suspectProtoRx.test(key) === true) {
+                    error('Object contains forbidden prototype property');
+                }
+                else if (suspectConstructorRx.test(key) === true) {
+                    error('Object contains forbidden constructor property');
+                }
+                else {
+                    obj[key] = value();
+                }
+                white();
+                if (ch === '}') {
+                    next('}');
+                    return obj;
+                }
+                next(',');
+                white();
+            }
+        }
+        error('Bad object');
+    }
+    const result = value();
+    white();
+    if (ch) {
+        error('Syntax error');
+    }
+    return result;
+}
+//# sourceMappingURL=Yy.parse.js.map

package/dist/Yy.parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Yy.parse.js","sourceRoot":"","sources":["../src/Yy.parse.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,cAAc,GAClB,yIAAyI,CAAC;AAC5I,MAAM,oBAAoB,GACxB,0JAA0J,CAAC;AAE7J,MAAM,OAAO,GAAG;IACd,GAAG,EAAE,GAAG;IACR,IAAI,EAAE,IAAI;IACV,GAAG,EAAE,GAAG;IACR,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;CACR,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,MAAc;IACpC,wBAAwB;IACxB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAE9C,qCAAqC;IACrC,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,4BAA4B;IAC5B,IAAI,EAAE,GAAG,GAAG,CAAC;IACb,MAAM,IAAI,GAAG,MAAM,CAAC;IAEpB,SAAS,KAAK,CAAC,CAAS;QACtB,MAAM;YACJ,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,CAAC;YACV,EAAE,EAAE,EAAE;YACN,IAAI,EAAE,IAAI;SACX,CAAC;IACJ,CAAC;IAED,SAAS,IAAI,CAAC,CAAU;QACtB,8EAA8E;QAE9E,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE;YACjB,KAAK,CAAC,YAAY,GAAG,CAAC,GAAG,gBAAgB,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC;SACvD;QAED,6DAA6D;QAC7D,2BAA2B;QAE3B,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,EAAE,IAAI,CAAC,CAAC;QACR,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,SAAS,MAAM;QACb,wBAAwB;QAExB,IAAI,GAAG,GAAG,EAAE,CAAC;QAEb,IAAI,EAAE,KAAK,GAAG,EAAE;YACd,GAAG,GAAG,GAAG,CAAC;YACV,IAAI,CAAC,GAAG,CAAC,CAAC;SACX;QACD,OAAO,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,GAAG,EAAE;YAC7B,GAAG,IAAI,EAAE,CAAC;YACV,IAAI,EAAE,CAAC;SACR;QACD,IAAI,EAAE,KAAK,GAAG,EAAE;YACd,GAAG,IAAI,GAAG,CAAC;YACX,OAAO,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,GAAG,EAAE;gBACvC,GAAG,IAAI,EAAE,CAAC;aACX;SACF;QACD,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE;YAC5B,GAAG,IAAI,EAAE,CAAC;YACV,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,KAAM,GAAc,IAAI,EAAE,KAAM,GAAc,EAAE;gBACpD,GAAG,IAAI,EAAE,CAAC;gBACV,IAAI,EAAE,CAAC;aACR;YACD,OAAO,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,GAAG,EAAE;gBAC7B,GAAG,IAAI,EAAE,CAAC;gBACV,IAAI,EAAE,CAAC;aACR;SACF;QACD,uBAAuB;QACvB,0BAA0B;QAC1B,gDAAgD;QAChD,2DAA2D;QAC3D,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC;QACjB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;YACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,QAAQ,GAAG,MAAM,CAAC,gBAAgB,EAAE;gBACtC,OAAO,QAAQ,CAAC;aACjB;SACF;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,SAAS,MAAM;QACb,wBAAwB;QAExB,IAAI,GAAG,EACL,CAAC,EACD,MAAM,GAAG,EAAE,EACX,KAAK,CAAC;QAER,uEAAuE;QAEvE,IAAI,EAAE,KAAK,GAAG,EAAE;YACd,IAAI,OAAO,GAAG,EAAE,CAAC;YACjB,OAAO,IAAI,EAAE,EAAE;gBACb,IAAI,EAAE,KAAK,GAAG,EAAE;oBACd,IAAI,EAAE,GAAG,CAAC,GAAG,OAAO;wBAAE,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;oBAChE,IAAI,EAAE,CAAC;oBACP,OAAO,MAAM,CAAC;iBACf;gBACD,IAAI,EAAE,KAAK,IAAI,EAAE;oBACf,IAAI,EAAE,GAAG,CAAC,GAAG,OAAO;wBAAE,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;oBAChE,IAAI,EAAE,CAAC;oBACP,IAAI,EAAE,KAAK,GAAG,EAAE;wBACd,KAAK,GAAG,CAAC,CAAC;wBACV,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;4BACzB,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;4BAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;gCAClB,MAAM;6BACP;4BACD,KAAK,GAAG,KAAK,GAAG,EAAE,GAAG,GAAG,CAAC;yBAC1B;wBACD,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;qBACtC;yBAAM,IAAI,OAAO,OAAO,CAAC,EAAE,CAAC,KAAK,QAAQ,EAAE;wBAC1C,MAAM,IAAI,OAAO,CAAC,EAAE,CAAC,CAAC;qBACvB;yBAAM;wBACL,MAAM;qBACP;oBACD,OAAO,GAAG,EAAE,CAAC;iBACd;aACF;SACF;QACD,KAAK,CAAC,YAAY,CAAC,CAAC;IACtB,CAAC;IAED,SAAS,KAAK;QACZ,mBAAmB;QACnB,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE;YACtB,IAAI,EAAE,CAAC;SACR;IACH,CAAC;IAED,SAAS,IAAI;QACX,wBAAwB;QAExB,QAAQ,EAAE,EAAE;YACV,KAAK,GAAG;gBACN,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,OAAO,IAAI,CAAC;YACd,KAAK,GAAG;gBACN,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,OAAO,KAAK,CAAC;YACf,KAAK,GAAG;gBACN,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,OAAO,IAAI,CAAC;SACf;QACD,KAAK,CAAC,cAAc,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,SAAS,KAAK;QACZ,2EAA2E;QAC3E,aAAa;QAEb,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,EAAE;YACV,KAAK,GAAG;gBACN,OAAO,MAAM,EAAE,CAAC;YAClB,KAAK,GAAG;gBACN,OAAO,KAAK,EAAE,CAAC;YACjB,KAAK,GAAG;gBACN,OAAO,MAAM,EAAE,CAAC;YAClB,KAAK,GAAG;gBACN,OAAO,MAAM,EAAE,CAAC;YAClB;gBACE,OAAO,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACrD;IACH,CAAC;IAED,SAAS,KAAK;QACZ,wBAAwB;QAExB,MAAM,KAAK,GAAU,EAAE,CAAC;QAExB,IAAI,EAAE,KAAK,GAAG,EAAE;YACd,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,KAAM,GAAc,EAAE;gBAC1B,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,OAAO,KAAK,CAAC,CAAC,cAAc;aAC7B;YACD,OAAO,EAAE,EAAE;gBACT,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;gBACpB,KAAK,EAAE,CAAC;gBACR,IAAI,EAAE,KAAM,GAAc,EAAE;oBAC1B,IAAI,CAAC,GAAG,CAAC,CAAC;oBACV,OAAO,KAAK,CAAC;iBACd;gBACD,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,KAAK,EAAE,CAAC;aACT;SACF;QACD,KAAK,CAAC,WAAW,CAAC,CAAC;IACrB,CAAC;IAED,SAAS,MAAM;QACb,yBAAyB;QAEzB,IAAI,GAAW,CAAC;QAChB,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEhC,IAAI,EAAE,KAAK,GAAG,EAAE;YACd,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,KAAM,GAAc,EAAE;gBAC1B,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,OAAO,GAAG,CAAC,CAAC,eAAe;aAC5B;YACD,OAAO,EAAE,EAAE;gBACT,GAAG,GAAG,MAAM,EAAE,CAAC;gBACf,KAAK,EAAE,CAAC;gBACR,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,IAAI,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE;oBACxC,KAAK,CAAC,iBAAiB,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;iBACtC;gBAED,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;oBACrC,KAAK,CAAC,8CAA8C,CAAC,CAAC;iBACvD;qBAAM,IAAI,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;oBAClD,KAAK,CAAC,gDAAgD,CAAC,CAAC;iBACzD;qBAAM;oBACL,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC;iBACpB;gBAED,KAAK,EAAE,CAAC;gBACR,IAAI,EAAE,KAAM,GAAc,EAAE;oBAC1B,IAAI,CAAC,GAAG,CAAC,CAAC;oBACV,OAAO,GAAG,CAAC;iBACZ;gBACD,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,KAAK,EAAE,CAAC;aACT;SACF;QACD,KAAK,CAAC,YAAY,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC;IACvB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,EAAE;QACN,KAAK,CAAC,cAAc,CAAC,CAAC;KACvB;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/Yy.stringify.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Jsonify, with GameMaker-like JSON and allowing for BigInts.
+ * Based on {@link https://github.com/sidorares/json-bigint/blob/master/lib/stringify.js}
+ */
+export declare function stringifyYy(yyData: any): string;
+//# sourceMappingURL=Yy.stringify.d.ts.map

package/dist/Yy.stringify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Yy.stringify.d.ts","sourceRoot":"","sources":["../src/Yy.stringify.ts"],"names":[],"mappings":"AAmCA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,GAAG,UAgItC"}

package/dist/Yy.stringify.js

@@ -0,0 +1,131 @@
+const escapable = 
+// eslint-disable-next-line no-control-regex, no-misleading-character-class
+/[\\"\x00-\x1f\x7f-\x9f\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g;
+const meta = {
+    // table of character substitutions
+    '\b': '\\b',
+    '\t': '\\t',
+    '\n': '\\n',
+    '\f': '\\f',
+    '\r': '\\r',
+    '"': '\\"',
+    '\\': '\\\\',
+};
+const eol = `\r\n`; // GMS2 writes Windows-style line endings.
+function quote(string) {
+    // If the string contains no control characters, no quote characters, and no
+    // backslash characters, then we can safely slap some quotes around it.
+    // Otherwise we must also replace the offending characters with safe escape
+    // sequences.
+    escapable.lastIndex = 0;
+    return escapable.test(string)
+        ? '"' +
+            string.replace(escapable, function (a) {
+                const c = meta[a];
+                return typeof c === 'string'
+                    ? c
+                    : '\\u' + ('0000' + a.charCodeAt(0).toString(16)).slice(-4);
+            }) +
+            '"'
+        : '"' + string + '"';
+}
+/**
+ * Jsonify, with GameMaker-like JSON and allowing for BigInts.
+ * Based on {@link https://github.com/sidorares/json-bigint/blob/master/lib/stringify.js}
+ */
+export function stringifyYy(yyData) {
+    let gap = '';
+    let level = 0; // Level 1 are root elements
+    const indent = '  ';
+    function stringify(key, holder) {
+        // Produce a string from holder[key].
+        let value = holder[key];
+        const mind = gap;
+        const startingLevel = level;
+        // Allow for custom number objects (e.g. NumberFixed),
+        // by directly converting any Number-extended instances
+        // to strings.
+        if (value instanceof Number) {
+            return String(value);
+        }
+        // If the value has a toJSON method, call it to obtain a replacement value.
+        value = value?.toJSON?.(key) ?? value;
+        // What happens next depends on the value's type.
+        switch (typeof value) {
+            case 'string':
+                return quote(value);
+            case 'number':
+                // JSON numbers must be finite. Encode non-finite numbers as null.
+                return isFinite(value) ? String(value) : 'null';
+            case 'boolean':
+            case 'bigint':
+                // If the value is a boolean or null, convert it to a string. Note:
+                // typeof null does not produce 'null'. The case is included here in
+                // the remote chance that this gets fixed someday.
+                return String(value);
+            // If the type is 'object', we might be dealing with an object or an array or
+            // null.
+            case 'object': {
+                // Due to a specification blunder in ECMAScript, typeof null is 'object',
+                // so watch out for that case.
+                if (!value) {
+                    return 'null';
+                }
+                // Make an array to hold the partial results of stringifying this object value.
+                gap += indent;
+                level++;
+                // Is the value an array?
+                if (Array.isArray(value)) {
+                    // Stringify every element. Use null as a placeholder
+                    // for non-JSON values.
+                    const jsonifiedValues = value.map((_, i) => stringify(i, value) || 'null');
+                    // Join all of the elements together, separated with commas, and wrap them in
+                    // brackets.
+                    const v = jsonifiedValues.length === 0
+                        ? '[]'
+                        : `[${eol}` +
+                            gap +
+                            jsonifiedValues.join(`,${eol}` + gap) +
+                            `,${eol}` +
+                            mind +
+                            ']';
+                    gap = mind;
+                    level = startingLevel;
+                    return v;
+                }
+                const includeGaps = level <= 2;
+                const partial = [];
+                Object.keys(value).forEach(function (k) {
+                    const v = stringify(k, value);
+                    if (v) {
+                        partial.push(quote(k) + (includeGaps ? ': ' : ':') + v);
+                    }
+                });
+                // Join all of the member texts together, separated with commas,
+                // and wrap them in braces.
+                const v = partial.length === 0
+                    ? '{}'
+                    : includeGaps
+                        ? `{${eol}` +
+                            gap +
+                            partial.join(`,${eol}` + gap) +
+                            `,${eol}` +
+                            mind +
+                            '}'
+                        : '{' + partial.join(',') + ',}';
+                gap = mind;
+                level = startingLevel;
+                return v;
+            }
+        }
+        return;
+    }
+    // If there is a replacer, it must be a function or an array.
+    // Otherwise, throw an error.
+    // Make a fake root object containing our value under the key of ''.
+    // Return the result of stringifying the value.
+    return stringify('', {
+        '': yyData,
+    });
+}
+//# sourceMappingURL=Yy.stringify.js.map

package/dist/Yy.stringify.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { Yy } from './Yy.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { Yy } from './Yy.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@bscotch/yy",
+  "version": "0.2.0",
+  "description": "Stringify, parse, read, and write GameMaker yy and yyp files.",
+  "keywords": [
+    "yy",
+    "yyp",
+    "game maker",
+    "gamemaker",
+    "yoyo",
+    "json",
+    "parse",
+    "stringify",
+    "file",
+    "read",
+    "write"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "tslib": "^2.4.0"
+  },
+  "devDependencies": {
+    "@bscotch/utility": "^6.1.1",
+    "chai": "^4.3.6",
+    "typescript": "^4.8.0-beta"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "test": "treb test",
+    "watch": "tsc --build --watch"
+  }
+}