@datamoc/mw_games 0.7.1 → 0.7.2

package/dist/core/Csv.js

@@ -70,13 +70,40 @@ export function parseCSV(source, options = {}) {
     });
 }
 function coerceCsvCell(raw, type, column, rowIndex, listDelimiter, mapDelimiter) {
+    return coerceCsvValue(raw, type, {
+        column,
+        rowIndex,
+        listDelimiter,
+        mapDelimiter,
+        error: () => {
+            if (type === 'number')
+                return `CSV row ${rowIndex + 1}, column "${column}": "${raw}" is not a number`;
+            if (type === 'boolean')
+                return `CSV row ${rowIndex + 1}, column "${column}": "${raw}" is not "true" or "false"`;
+            if (type === 'map')
+                return `CSV row ${rowIndex + 1}, column "${column}": "${raw
+                    .split(listDelimiter)
+                    .map((piece) => piece.trim())
+                    .find((piece) => piece && !piece.includes(mapDelimiter)) ?? raw}" has no "${mapDelimiter}" to split a key from its value`;
+            return `CSV row ${rowIndex + 1}, column "${column}": "${raw}" is invalid`;
+        },
+    });
+}
+/** Coerce one typed cell, shared by CSV and declarative content readers. */
+export function coerceCsvValue(raw, type, options = {}) {
+    const column = options.column ?? 'value';
+    const listDelimiter = options.listDelimiter ?? ';';
+    const mapDelimiter = options.mapDelimiter ?? '=';
+    const fail = (message) => {
+        throw new Error(options.error?.(message) ?? message);
+    };
     switch (type) {
         case 'string':
             return raw;
         case 'number': {
             const value = Number(raw);
             if (!Number.isFinite(value))
-                throw new Error(`CSV row ${rowIndex + 1}, column "${column}": "${raw}" is not a number`);
+                fail(`${column} must be a number`);
             return value;
         }
         case 'boolean': {
@@ -85,7 +112,11 @@ function coerceCsvCell(raw, type, column, rowIndex, listDelimiter, mapDelimiter)
                 return true;
             if (lower === 'false')
                 return false;
-            throw new Error(`CSV row ${rowIndex + 1}, column "${column}": "${raw}" is not "true" or "false"`);
+            if (options.acceptYesNo && lower === 'yes')
+                return true;
+            if (options.acceptYesNo && lower === 'no')
+                return false;
+            fail(`${column} must be true, false${options.acceptYesNo ? ', yes, or no' : ''}`);
         }
         case 'list':
             return raw
@@ -100,7 +131,7 @@ function coerceCsvCell(raw, type, column, rowIndex, listDelimiter, mapDelimiter)
                 .filter((piece) => piece.length > 0)) {
                 const at = entry.indexOf(mapDelimiter);
                 if (at === -1)
-                    throw new Error(`CSV row ${rowIndex + 1}, column "${column}": "${entry}" has no "${mapDelimiter}" to split a key from its value`);
+                    fail(`${column} map entry must contain ${mapDelimiter}`);
                 map[entry.slice(0, at).trim()] = entry.slice(at + mapDelimiter.length).trim();
             }
             return map;

package/dist/core/Csv.js.map

@@ -1 +1 @@
-{"version":3,"file":"Csv.js","sourceRoot":"","sources":["../../src/core/Csv.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Csv.js","sourceRoot":"","sources":["../../src/core/Csv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAeH;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAA6B,MAAc,EAAE,OAAO,GAAe,EAAE;IAC5F,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/B,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,GAAG,CAAC;IACnD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,GAAG,CAAC;IAEjD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QACnC,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE;YACpC,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YACrC,IAAI,GAAG,KAAK,EAAE;gBAAE,OAAO,CAAC,2EAA2E;YACnG,GAAG,CAAC,IAAI,CAAC,GAAG,aAAa,CACxB,GAAG,EACH,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,QAAQ,EACnC,IAAI,EACJ,QAAQ,EACR,aAAa,EACb,YAAY,CACZ,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,GAAQ,CAAC;IACjB,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACrB,GAAW,EACX,IAAmB,EACnB,MAAc,EACd,QAAgB,EAChB,aAAqB,EACrB,YAAoB;IAEpB,OAAO,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE;QAChC,MAAM;QACN,QAAQ;QACR,aAAa;QACb,YAAY;QACZ,KAAK,EAAE,GAAG,EAAE;YACX,IAAI,IAAI,KAAK,QAAQ;gBAAE,OAAO,WAAW,QAAQ,GAAG,CAAC,aAAa,MAAM,OAAO,GAAG,mBAAmB,CAAC;YACtG,IAAI,IAAI,KAAK,SAAS;gBACrB,OAAO,WAAW,QAAQ,GAAG,CAAC,aAAa,MAAM,OAAO,GAAG,4BAA4B,CAAC;YACzF,IAAI,IAAI,KAAK,KAAK;gBACjB,OAAO,WAAW,QAAQ,GAAG,CAAC,aAAa,MAAM,OAChD,GAAG;qBACD,KAAK,CAAC,aAAa,CAAC;qBACpB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;qBAC5B,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,IAAI,GAC9D,aAAa,YAAY,iCAAiC,CAAC;YAC5D,OAAO,WAAW,QAAQ,GAAG,CAAC,aAAa,MAAM,OAAO,GAAG,cAAc,CAAC;QAC3E,CAAC;KACD,CAAC,CAAC;AACJ,CAAC;AAWD,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,IAAmB,EAAE,OAAO,GAAuB,EAAE;IAChG,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC;IACzC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,GAAG,CAAC;IACnD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,GAAG,CAAC;IACjD,MAAM,IAAI,GAAG,CAAC,OAAe,EAAS,EAAE;QACvC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC;IACtD,CAAC,CAAC;IACF,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,QAAQ;YACZ,OAAO,GAAG,CAAC;QACZ,KAAK,QAAQ,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,IAAI,CAAC,GAAG,MAAM,mBAAmB,CAAC,CAAC;YAChE,OAAO,KAAK,CAAC;QACd,CAAC;QACD,KAAK,SAAS,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YAChC,IAAI,KAAK,KAAK,MAAM;gBAAE,OAAO,IAAI,CAAC;YAClC,IAAI,KAAK,KAAK,OAAO;gBAAE,OAAO,KAAK,CAAC;YACpC,IAAI,OAAO,CAAC,WAAW,IAAI,KAAK,KAAK,KAAK;gBAAE,OAAO,IAAI,CAAC;YACxD,IAAI,OAAO,CAAC,WAAW,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YACxD,IAAI,CAAC,GAAG,MAAM,uBAAuB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,KAAK,MAAM;YACV,OAAO,GAAG;iBACR,KAAK,CAAC,aAAa,CAAC;iBACpB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;iBAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACvC,KAAK,KAAK,EAAE,CAAC;YACZ,MAAM,GAAG,GAA2B,EAAE,CAAC;YACvC,KAAK,MAAM,KAAK,IAAI,GAAG;iBACrB,KAAK,CAAC,aAAa,CAAC;iBACpB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;iBAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;gBACvC,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;gBACvC,IAAI,EAAE,KAAK,CAAC,CAAC;oBAAE,IAAI,CAAC,GAAG,MAAM,2BAA2B,YAAY,EAAE,CAAC,CAAC;gBACxE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/E,CAAC;YACD,OAAO,GAAG,CAAC;QACZ,CAAC;IACF,CAAC;AACF,CAAC;AAED,gGAAgG;AAChG,+FAA+F;AAC/F,+EAA+E;AAC/E,SAAS,WAAW,CAAC,MAAc;IAClC,MAAM,IAAI,GAAe,EAAE,CAAC;IAC5B,IAAI,GAAG,GAAa,EAAE,CAAC;IACvB,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,QAAQ,EAAE,CAAC;YACd,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBAClB,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC3B,KAAK,IAAI,GAAG,CAAC;oBACb,CAAC,IAAI,CAAC,CAAC;oBACP,SAAS;gBACV,CAAC;gBACD,QAAQ,GAAG,KAAK,CAAC;gBACjB,CAAC,EAAE,CAAC;gBACJ,SAAS;YACV,CAAC;YACD,KAAK,IAAI,IAAI,CAAC;YACd,CAAC,EAAE,CAAC;YACJ,SAAS;QACV,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YAClB,QAAQ,GAAG,IAAI,CAAC;YAChB,CAAC,EAAE,CAAC;YACJ,SAAS;QACV,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YAClB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChB,KAAK,GAAG,EAAE,CAAC;YACX,CAAC,EAAE,CAAC;YACJ,SAAS;QACV,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACnB,CAAC,EAAE,CAAC;YACJ,SAAS;QACV,CAAC,CAAC,2CAA2C;QAC7C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACnB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACf,GAAG,GAAG,EAAE,CAAC;YACT,KAAK,GAAG,EAAE,CAAC;YACX,CAAC,EAAE,CAAC;YACJ,SAAS;QACV,CAAC;QACD,KAAK,IAAI,IAAI,CAAC;QACd,CAAC,EAAE,CAAC;IACL,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IAED,uFAAuF;IACvF,8CAA8C;IAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/dist/core/Entity.d.ts

@@ -30,8 +30,8 @@ export declare class EntityRegistry<T extends object> {
     private entities;
     private ids;
     private sequence;
-    /** registers a new entity and returns the id it is known by from now on */
-    add(entity: T): EntityId;
+    /** registers an entity, using a caller-supplied stable id when provided */
+    add(entity: T, requestedId?: EntityId): EntityId;
     get(id: EntityId): T | undefined;
     /** the reverse lookup - what a game passes as another API's `actorId`/`id` callback */
     idOf(entity: T): EntityId | undefined;

package/dist/core/Entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Entity.d.ts","sourceRoot":"","sources":["../../src/core/Entity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B;;;;;;;GAOG;AACH,qBAAa,cAAc,CAAC,CAAC,SAAS,MAAM;IAC3C,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,QAAQ,CAAK;IAErB,2EAA2E;IAC3E,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,QAAQ,CAQvB;IAED,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,CAAC,GAAG,SAAS,CAE/B;IAED,uFAAuF;IACvF,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,QAAQ,GAAG,SAAS,CAEpC;IAED,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAEzB;IAED,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAO5B;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;CACD"}
+{"version":3,"file":"Entity.d.ts","sourceRoot":"","sources":["../../src/core/Entity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B;;;;;;;GAOG;AACH,qBAAa,cAAc,CAAC,CAAC,SAAS,MAAM;IAC3C,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,QAAQ,CAAK;IAErB,2EAA2E;IAC3E,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,WAAW,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAmB/C;IAED,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,CAAC,GAAG,SAAS,CAE/B;IAED,uFAAuF;IACvF,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,QAAQ,GAAG,SAAS,CAEpC;IAED,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAEzB;IAED,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAO5B;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;CACD"}

package/dist/core/Entity.js

@@ -12,12 +12,26 @@ export class EntityRegistry {
         this.ids = new Map();
         this.sequence = 0;
     }
-    /** registers a new entity and returns the id it is known by from now on */
-    add(entity) {
+    /** registers an entity, using a caller-supplied stable id when provided */
+    add(entity, requestedId) {
         const existing = this.ids.get(entity);
-        if (existing !== undefined)
+        if (existing !== undefined) {
+            if (requestedId !== undefined && requestedId !== existing)
+                throw new Error(`entity already has id ${existing}`);
             return existing;
-        const id = `e${this.sequence++}`;
+        }
+        let id = requestedId;
+        if (id !== undefined) {
+            if (id.length === 0)
+                throw new Error('entity id must not be empty');
+            if (this.entities.has(id))
+                throw new Error(`entity id already exists: ${id}`);
+        }
+        else {
+            do
+                id = `e${this.sequence++}`;
+            while (this.entities.has(id));
+        }
         this.entities.set(id, entity);
         this.ids.set(entity, id);
         return id;

package/dist/core/Entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"Entity.js","sourceRoot":"","sources":["../../src/core/Entity.ts"],"names":[],"mappings":"AAqBA;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IAA3B;QACS,aAAQ,GAAG,IAAI,GAAG,EAAe,CAAC;QAClC,QAAG,GAAG,IAAI,GAAG,EAAe,CAAC;QAC7B,aAAQ,GAAG,CAAC,CAAC;IAsCtB,CAAC;IApCA,2EAA2E;IAC3E,GAAG,CAAC,MAAS;QACZ,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QAE5C,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACzB,OAAO,EAAE,CAAC;IACX,CAAC;IAED,GAAG,CAAC,EAAY;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,uFAAuF;IACvF,IAAI,CAAC,MAAS;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,EAAY;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,EAAY;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAEvC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC3B,CAAC;CACD"}
+{"version":3,"file":"Entity.js","sourceRoot":"","sources":["../../src/core/Entity.ts"],"names":[],"mappings":"AAqBA;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IAA3B;QACS,aAAQ,GAAG,IAAI,GAAG,EAAe,CAAC;QAClC,QAAG,GAAG,IAAI,GAAG,EAAe,CAAC;QAC7B,aAAQ,GAAG,CAAC,CAAC;IAiDtB,CAAC;IA/CA,2EAA2E;IAC3E,GAAG,CAAC,MAAS,EAAE,WAAsB;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,QAAQ;gBACxD,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;YACtD,OAAO,QAAQ,CAAC;QACjB,CAAC;QAED,IAAI,EAAE,GAAG,WAAW,CAAC;QACrB,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACtB,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACpE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;QAC/E,CAAC;aAAM,CAAC;YACP;gBAAG,EAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;mBACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAC/B,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACzB,OAAO,EAAE,CAAC;IACX,CAAC;IAED,GAAG,CAAC,EAAY;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,uFAAuF;IACvF,IAAI,CAAC,MAAS;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,EAAY;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,EAAY;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAEvC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC3B,CAAC;CACD"}

package/dist/index.d.ts

@@ -21,4 +21,5 @@ export * as Board from './board/index.ts';
 export * as Audio from './audio/index.ts';
 export * as Simulation from './simulation/index.ts';
 export * as Mwl from './mwl/index.ts';
+export * as AI from './ai/index.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -21,4 +21,5 @@ export * as Board from './board/index.js';
 export * as Audio from './audio/index.js';
 export * as Simulation from './simulation/index.js';
 export * as Mwl from './mwl/index.js';
+export * as AI from './ai/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,eAAe,CAAC"}