ticbuild 1.0.0

package/dist/utils/math.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clamp = clamp;
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+//# sourceMappingURL=math.js.map

package/dist/utils/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":";;AACA,sBAEC;AAFD,SAAgB,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7C,CAAC"}

package/dist/utils/math.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=math.test.d.ts.map

package/dist/utils/math.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.test.d.ts","sourceRoot":"","sources":["../../src/utils/math.test.ts"],"names":[],"mappings":""}

package/dist/utils/math.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.test.js","sourceRoot":"","sources":["../../src/utils/math.test.ts"],"names":[],"mappings":";;AACA,iCAA6B;AAE7B,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;QACrB,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,CAAC,IAAA,YAAK,EAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,IAAA,YAAK,EAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,IAAA,YAAK,EAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,MAAM,CAAC,IAAA,YAAK,EAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjC,MAAM,CAAC,IAAA,YAAK,EAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,CAAC,IAAA,YAAK,EAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,IAAA,YAAK,EAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxC,MAAM,CAAC,IAAA,YAAK,EAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,CAAC,IAAA,YAAK,EAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClC,MAAM,CAAC,IAAA,YAAK,EAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnC,MAAM,CAAC,IAAA,YAAK,EAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClC,MAAM,CAAC,IAAA,YAAK,EAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxC,MAAM,CAAC,IAAA,YAAK,EAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,CAAC,IAAA,YAAK,EAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,MAAM,CAAC,IAAA,YAAK,EAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;YACtC,MAAM,CAAC,IAAA,YAAK,EAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/templates.d.ts

@@ -0,0 +1,3 @@
+export declare function applyTemplateVariables(template: string, variables: Record<string, string>): string;
+export declare function resolveTemplateDir(name: string): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/utils/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/utils/templates.ts"],"names":[],"mappings":"AAOA,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAMlG;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMvD"}

package/dist/utils/templates.js

@@ -0,0 +1,57 @@
+"use strict";
+// so yea i introduce YET another meta language.
+// another variable substitution system; quite simple just for expanding templates:
+// {{VARIABLE_NAME}} gets replaced with the string value.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyTemplateVariables = applyTemplateVariables;
+exports.resolveTemplateDir = resolveTemplateDir;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+function applyTemplateVariables(template, variables) {
+    let output = template;
+    for (const [key, value] of Object.entries(variables)) {
+        output = output.split(`{{${key}}}`).join(value);
+    }
+    return output;
+}
+function resolveTemplateDir(name) {
+    const templateDir = path.resolve(__dirname, "..", "..", "templates", name);
+    if (!fs.existsSync(templateDir)) {
+        throw new Error(`Template not found: ${templateDir}`);
+    }
+    return templateDir;
+}
+//# sourceMappingURL=templates.js.map

package/dist/utils/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/utils/templates.ts"],"names":[],"mappings":";AAAA,gDAAgD;AAChD,mFAAmF;AACnF,yDAAyD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKzD,wDAMC;AAED,gDAMC;AAjBD,4CAA8B;AAC9B,gDAAkC;AAElC,SAAgB,sBAAsB,CAAC,QAAgB,EAAE,SAAiC;IACxF,IAAI,MAAM,GAAG,QAAQ,CAAC;IACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,kBAAkB,CAAC,IAAY;IAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IAC3E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,uBAAuB,WAAW,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/utils/tic80/bankSupport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bankSupport.test.d.ts.map

package/dist/utils/tic80/bankSupport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bankSupport.test.d.ts","sourceRoot":"","sources":["../../../src/utils/tic80/bankSupport.test.ts"],"names":[],"mappings":""}

package/dist/utils/tic80/bankSupport.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bankSupport.test.js","sourceRoot":"","sources":["../../../src/utils/tic80/bankSupport.test.ts"],"names":[],"mappings":";;AAAA,6CAAiD;AACjD,6CAA8C;AAG9C,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,MAAM,GAAqB;YAC/B,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;YAC/D,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;SAC7D,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAiB,EAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAA,2BAAc,EAAC,MAAM,CAAC,CAAC;QAEtC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,MAAM,GAAqB;YAC/B,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;YACzD,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;SAC1D,CAAC;QAEF,MAAM,MAAM,CAAC,IAAA,8BAAiB,EAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,kDAAkD,CAAC,CAAC;IAClH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,MAAM,GAAqB,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAExG,MAAM,MAAM,CAAC,IAAA,8BAAiB,EAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACzD,4DAA4D,CAC7D,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/tic80/cartLoader.d.ts

@@ -0,0 +1,3 @@
+import { Tic80Cart } from "./tic80";
+export declare function parseTic80Cart(data: Uint8Array): Tic80Cart;
+//# sourceMappingURL=cartLoader.d.ts.map

package/dist/utils/tic80/cartLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cartLoader.d.ts","sourceRoot":"","sources":["../../../src/utils/tic80/cartLoader.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,SAAS,EAAkB,MAAM,SAAS,CAAC;AAqC1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAgB1D"}

package/dist/utils/tic80/cartLoader.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTic80Cart = parseTic80Cart;
+const bin_1 = require("../bin");
+const tic80_1 = require("./tic80");
+// each chunk consists of a 4-byte header, then chunk data.
+// offset   bits      description
+// -----------------------------------------
+// 0        BBBC CCCC B = bank number (0..7), C = chunk type (0..31)
+// 1..2     Sx16      S = size of chunk, 16-bit little-endian
+// 3        Ux1       U = unused / reserved padding
+// 4..      ...       chunk data
+function parseThisChunk(data, offset) {
+    if (offset + 4 > data.length) {
+        throw new Error("Unexpected end of data while reading chunk header");
+    }
+    const headerByte = data[offset];
+    const chunkTypeValue = headerByte & 0x1f;
+    const bank = headerByte >> 5;
+    const size = (0, bin_1.readUint16LE)(data, offset + 1);
+    const nextOffset = offset + 4 + size;
+    if (nextOffset > data.length) {
+        throw new Error("Unexpected end of data while reading chunk data");
+    }
+    const chunkData = data.subarray(offset + 4, nextOffset);
+    const chunkTypeKey = tic80_1.kTic80CartChunkTypes.coerceByValue(chunkTypeValue)?.key;
+    if (!chunkTypeKey) {
+        throw new Error(`Unknown chunk type: ${chunkTypeValue}`);
+    }
+    return {
+        chunk: {
+            chunkType: chunkTypeKey,
+            bank,
+            data: chunkData,
+        },
+        nextOffset,
+    };
+}
+function parseTic80Cart(data) {
+    const chunks = [];
+    let offset = 0;
+    while (offset < data.length) {
+        const { chunk, nextOffset } = parseThisChunk(data, offset);
+        chunks.push(chunk);
+        offset = nextOffset;
+    }
+    // // dump
+    // console.log(`Parsed TIC-80 cart with ${chunks.length} chunks:`);
+    // for (const chunk of chunks) {
+    //   console.log(`Chunk: ${chunk.chunkType}, size: ${chunk.data.length}`);
+    // }
+    return { chunks };
+}
+//# sourceMappingURL=cartLoader.js.map

package/dist/utils/tic80/cartLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cartLoader.js","sourceRoot":"","sources":["../../../src/utils/tic80/cartLoader.ts"],"names":[],"mappings":";;AAsCA,wCAgBC;AAtDD,gCAAsC;AACtC,mCAA0E;AAE1E,2DAA2D;AAC3D,iCAAiC;AACjC,4CAA4C;AAC5C,oEAAoE;AACpE,6DAA6D;AAC7D,mDAAmD;AACnD,gCAAgC;AAEhC,SAAS,cAAc,CAAC,IAAgB,EAAE,MAAc;IACtD,IAAI,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,cAAc,GAAG,UAAU,GAAG,IAAI,CAAC;IACzC,MAAM,IAAI,GAAG,UAAU,IAAI,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAA,kBAAY,EAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC;IACrC,IAAI,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,4BAAoB,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC;IAC7E,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,uBAAuB,cAAc,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO;QACL,KAAK,EAAE;YACL,SAAS,EAAE,YAAY;YACvB,IAAI;YACJ,IAAI,EAAE,SAAS;SAChB;QACD,UAAU;KACX,CAAC;AACJ,CAAC;AAED,SAAgB,cAAc,CAAC,IAAgB;IAC7C,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,MAAM,GAAG,UAAU,CAAC;IACtB,CAAC;IAED,UAAU;IACV,mEAAmE;IACnE,gCAAgC;IAChC,0EAA0E;IAC1E,IAAI;IAEJ,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/dist/utils/tic80/cartWriter.d.ts

@@ -0,0 +1,5 @@
+import { Tic80Cart, Tic80CartChunkTypeKey } from "./tic80";
+export declare function trimTrailingZeros(data: Uint8Array): Uint8Array;
+export declare function serializeChunk(chunkType: Tic80CartChunkTypeKey, data: Uint8Array, bank: number): Uint8Array;
+export declare function AssembleTic80Cart(input: Tic80Cart): Promise<Uint8Array>;
+//# sourceMappingURL=cartWriter.d.ts.map

package/dist/utils/tic80/cartWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cartWriter.d.ts","sourceRoot":"","sources":["../../../src/utils/tic80/cartWriter.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,SAAS,EAAkB,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGjG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAM9D;AASD,wBAAgB,cAAc,CAAC,SAAS,EAAE,qBAAqB,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAwB3G;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAoD7E"}

package/dist/utils/tic80/cartWriter.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trimTrailingZeros = trimTrailingZeros;
+exports.serializeChunk = serializeChunk;
+exports.AssembleTic80Cart = AssembleTic80Cart;
+const errorHandling_1 = require("../errorHandling");
+const tic80_1 = require("./tic80");
+// remove trailing zeros from a Uint8Array; chunk data in TIC-80 need not include trailing zeros.
+function trimTrailingZeros(data) {
+    let end = data.length;
+    while (end > 0 && data[end - 1] === 0) {
+        end--;
+    }
+    return data.subarray(0, end);
+}
+// each chunk consists of a 4-byte header, then chunk data.
+// offset   bits      description
+// -----------------------------------------
+// 0        BBBC CCCC B = bank number (0..7), C = chunk type (0..31)
+// 1..2     Sx16      S = size of chunk, 16-bit little-endian
+// 3        Ux1       U = unused / reserved padding
+// 4..      ...       chunk data
+function serializeChunk(chunkType, data, bank) {
+    const chunkInfo = tic80_1.kTic80CartChunkTypes.coerceByKey(chunkType);
+    if (!chunkInfo) {
+        throw new Error(`Unknown chunk type key: ${chunkType}`);
+    }
+    if (!Number.isInteger(bank)) {
+        throw new Error(`Bank index must be an integer for chunk ${chunkType}`);
+    }
+    if (bank < 0 || bank >= chunkInfo.bankCount) {
+        throw new Error(`Bank index ${bank} out of range for chunk ${chunkType} (0..${chunkInfo.bankCount - 1})`);
+    }
+    const header = new Uint8Array(4);
+    // first byte: BBBC CCCC
+    (0, errorHandling_1.assert)(chunkInfo.value >= 0 && chunkInfo.value <= 31, `Chunk type value out of range: ${chunkInfo.value}`);
+    header[0] = (bank << 5) | chunkInfo.value; // BBBC CCCC
+    // size: Sx16
+    const size = data.length;
+    if (size > chunkInfo.sizePerBank) {
+        throw new Error(`Chunk data too large: ${size} bytes (max 65535)`);
+    }
+    header[1] = size & 0xff;
+    header[2] = (size >> 8) & 0xff;
+    header[3] = 0; // unused / reserved
+    return new Uint8Array([...header, ...data]);
+}
+async function AssembleTic80Cart(input) {
+    // sanity check: no duplicate chunk types
+    const seenChunkTypes = new Set();
+    for (const chunk of input.chunks) {
+        const key = `${chunk.chunkType}@${chunk.bank}`;
+        if (seenChunkTypes.has(key)) {
+            throw new Error(`Duplicate chunk type in TIC-80 cart: ${chunk.chunkType} bank ${chunk.bank}`);
+        }
+        seenChunkTypes.add(key);
+    }
+    // put chunks in sort order. i don't know if that's necessary but let's play safe?
+    // so start by attaching chunk info to each chunk.
+    const chunksWithInfo = input.chunks.map((chunk) => {
+        const info = tic80_1.kTic80CartChunkTypes.coerceByKey(chunk.chunkType);
+        if (!info) {
+            throw new Error(`Unknown chunk type key: ${chunk.chunkType}`);
+        }
+        return { chunk, info };
+    });
+    // sort by chunk type value, then by bank
+    chunksWithInfo.sort((a, b) => {
+        const typeDelta = a.info.value - b.info.value;
+        if (typeDelta !== 0) {
+            return typeDelta;
+        }
+        return a.chunk.bank - b.chunk.bank;
+    });
+    // serialize each chunk
+    const serializedChunks = [];
+    for (const { chunk } of chunksWithInfo) {
+        const trimmedData = trimTrailingZeros(chunk.data);
+        const serialized = serializeChunk(chunk.chunkType, trimmedData, chunk.bank);
+        serializedChunks.push(serialized);
+    }
+    // concatenate all serialized chunks into a single Uint8Array
+    let totalLength = 0;
+    for (const chunk of serializedChunks) {
+        totalLength += chunk.length;
+    }
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of serializedChunks) {
+        result.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return result;
+}
+//# sourceMappingURL=cartWriter.js.map

package/dist/utils/tic80/cartWriter.js.map

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

package/dist/utils/tic80/launch.d.ts

@@ -0,0 +1,4 @@
+import { ChildProcess } from "node:child_process";
+export declare function launchProcessReturnImmediately(exePath: string, args?: string[]): Promise<ChildProcess>;
+export declare function launchProcessAndWait(exePath: string, args?: string[]): Promise<number>;
+//# sourceMappingURL=launch.d.ts.map

package/dist/utils/tic80/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../src/utils/tic80/launch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAIzD,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAYhH;AAGD,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAahG"}

package/dist/utils/tic80/launch.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.launchProcessReturnImmediately = launchProcessReturnImmediately;
+exports.launchProcessAndWait = launchProcessAndWait;
+const node_child_process_1 = require("node:child_process");
+// launches it and returns the process id / handle / something that can be used to
+// monitor and kill the running instance. Returns immediately; does not wait for the process to finish.
+async function launchProcessReturnImmediately(exePath, args = []) {
+    return new Promise((resolve, reject) => {
+        const child = (0, node_child_process_1.spawn)(exePath, args, {
+            stdio: "ignore",
+            detached: true,
+        });
+        child.on("error", (err) => {
+            reject(err);
+        });
+        child.unref(); // Allow parent process to exit independently
+        resolve(child); // resolve immediately with the child process
+    });
+}
+//
+async function launchProcessAndWait(exePath, args = []) {
+    return new Promise((resolve, reject) => {
+        const child = (0, node_child_process_1.spawn)(exePath, args, {
+            stdio: "inherit",
+        });
+        child.on("error", (err) => {
+            reject(err);
+        });
+        child.on("close", (code) => {
+            resolve(code || 0);
+        });
+        // do not resolve immediately; wait for process to exit
+    });
+}
+//# sourceMappingURL=launch.js.map

package/dist/utils/tic80/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../../src/utils/tic80/launch.ts"],"names":[],"mappings":";;AAIA,wEAYC;AAGD,oDAaC;AAhCD,2DAAyD;AAEzD,kFAAkF;AAClF,uGAAuG;AAChG,KAAK,UAAU,8BAA8B,CAAC,OAAe,EAAE,OAAiB,EAAE;IACvF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,IAAA,0BAAK,EAAC,OAAO,EAAE,IAAI,EAAE;YACjC,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,6CAA6C;QAC5D,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,6CAA6C;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,EAAE;AACK,KAAK,UAAU,oBAAoB,CAAC,OAAe,EAAE,OAAiB,EAAE;IAC7E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,IAAA,0BAAK,EAAC,OAAO,EAAE,IAAI,EAAE;YACjC,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QACH,uDAAuD;IACzD,CAAC,CAAC,CAAC;AACL,CAAC"}