ticbuild 1.0.2 → 1.0.3

package/dist/backend/codeBanking.test.js

@@ -0,0 +1,100 @@
+"use strict";
+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 });
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const project_1 = require("./project");
+const tic80_1 = require("../utils/tic80/tic80");
+function writeFile(filePath, content) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, content, "utf-8");
+}
+function createTempProject(code, assemblyBlock) {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), "ticbuild-codebank-"));
+    const codePath = path.join(dir, "main.lua");
+    writeFile(codePath, code);
+    const manifest = {
+        project: {
+            name: "test",
+            binDir: "./bin",
+            objDir: "./obj",
+            outputCartName: "out.tic",
+        },
+        imports: [
+            {
+                name: "maincode",
+                path: "main.lua",
+                kind: "LuaCode",
+            },
+        ],
+        assembly: {
+            lua: {
+                minify: false,
+            },
+            blocks: [assemblyBlock],
+        },
+    };
+    const manifestPath = path.join(dir, "project.ticbuild.jsonc");
+    writeFile(manifestPath, JSON.stringify(manifest, null, 2));
+    return { dir, manifestPath };
+}
+describe("Code chunk banking", () => {
+    it("should split CODE across multiple banks when oversized", async () => {
+        const maxChunkSize = tic80_1.kTic80CartChunkTypes.byKey.CODE.sizePerBank;
+        const payloadLength = maxChunkSize + 10;
+        const code = `local s = "${"a".repeat(payloadLength)}"`;
+        const { dir, manifestPath } = createTempProject(code, {
+            chunks: ["CODE"],
+            asset: "maincode",
+        });
+        try {
+            const project = project_1.TicbuildProject.loadFromManifest({ manifestPath });
+            await project.loadImports();
+            const output = await project.assembleOutput();
+            const codeChunks = output.chunks.filter((chunk) => chunk.chunkType === "CODE");
+            expect(codeChunks).toHaveLength(2);
+            expect(codeChunks[0].bank).toBe(0);
+            expect(codeChunks[1].bank).toBe(1);
+            expect(codeChunks[0].data.length).toBe(maxChunkSize);
+            const totalLength = new TextEncoder().encode(code).length;
+            expect(codeChunks[1].data.length).toBe(totalLength - maxChunkSize);
+        }
+        finally {
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=codeBanking.test.js.map

package/dist/backend/importers/LuaCodeImporter.test.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const LuaCodeImporter_1 = require("./LuaCodeImporter");
+const projectCore_1 = require("../projectCore");
+function makeProject(manifest) {
+    return new projectCore_1.TicbuildProjectCore({
+        manifest,
+        manifestPath: "C:/test/manifest.ticbuild.jsonc",
+        projectDir: "C:/test",
+    });
+}
+describe("LuaCodeResourceView emitGlobals", () => {
+    it("should respect code.emitGlobals=false", () => {
+        const manifest = {
+            project: {
+                name: "test",
+                binDir: "./bin",
+                objDir: "./obj",
+                outputCartName: "test.tic",
+            },
+            variables: {},
+            imports: [],
+            assembly: {
+                lua: {
+                    minify: false,
+                    globals: {
+                        PROJECT_NAME: "Demo",
+                    },
+                },
+                blocks: [],
+            },
+        };
+        const project = makeProject(manifest);
+        const view = new LuaCodeImporter_1.LuaCodeResourceView("print('hello')", "print('hello')");
+        const withGlobals = new TextDecoder().decode(view.getDataForChunk(project, "CODE"));
+        expect(withGlobals).toContain('local PROJECT_NAME = "Demo"');
+        const withoutGlobals = new TextDecoder().decode(view.getDataForChunk(project, "CODE", { emitGlobals: false }));
+        expect(withoutGlobals).not.toContain('local PROJECT_NAME = "Demo"');
+        expect(withoutGlobals).toContain("print('hello')");
+    });
+});
+//# sourceMappingURL=LuaCodeImporter.test.js.map

package/dist/backend/luaPreprocessor.test.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const luaPreprocessor_1 = require("./luaPreprocessor");
+const projectCore_1 = require("./projectCore");
+function makeProject(manifest) {
+    return new projectCore_1.TicbuildProjectCore({
+        manifest,
+        manifestPath: "C:/test/manifest.ticbuild.jsonc",
+        projectDir: "C:/test",
+    });
+}
+describe("Lua preprocessor __ENCODE", () => {
+    it("should encode hex to hex literal", async () => {
+        const manifest = {
+            project: {
+                name: "test",
+                binDir: "./bin",
+                objDir: "./obj",
+                outputCartName: "test.tic",
+            },
+            variables: {},
+            imports: [],
+            assembly: {
+                blocks: [],
+            },
+        };
+        // for reference,
+        // {25,44,93,255,127,128}
+        // hex:    "192c5dff7f80"
+        // b85+1:  "#)(](nIt.M!"
+        // lz85+1: "!!!X;l?2oD)"
+        {
+            const project = makeProject(manifest);
+            const source = 'local value = __ENCODE("hex", "hex", "1f 00")';
+            const result = await (0, luaPreprocessor_1.preprocessLuaCode)(project, source, "C:/test/source.lua");
+            expect(result.code).toContain('local value = "1f00"');
+        }
+        {
+            const project = makeProject(manifest);
+            const source = 'local value = __ENCODE("b85+1", "hex", "#)(](nIt.M!")';
+            const result = await (0, luaPreprocessor_1.preprocessLuaCode)(project, source, "C:/test/source.lua");
+            expect(result.code).toContain('local value = "192c5dff7f80"');
+        }
+        {
+            const project = makeProject(manifest);
+            const source = 'local value = __ENCODE("lz85+1", "hex", "!!!X;l?2oD)")';
+            const result = await (0, luaPreprocessor_1.preprocessLuaCode)(project, source, "C:/test/source.lua");
+            expect(result.code).toContain('local value = "192c5dff7f80"');
+        }
+        {
+            const project = makeProject(manifest);
+            const source = 'local value = __ENCODE("lz85+1", "b85+1", "!!!X;l?2oD)")';
+            const result = await (0, luaPreprocessor_1.preprocessLuaCode)(project, source, "C:/test/source.lua");
+            expect(result.code).toContain('local value = "#)(](nIt.M!"');
+        }
+        {
+            const project = makeProject(manifest);
+            const source = 'local value = __ENCODE("lz85+1", "u8", "!!!X;l?2oD)")';
+            const result = await (0, luaPreprocessor_1.preprocessLuaCode)(project, source, "C:/test/source.lua");
+            expect(result.code).toContain("local value = {25,44,93,255,127,128}");
+        }
+    });
+});
+//# sourceMappingURL=luaPreprocessor.test.js.map

package/dist/backend/manifestLoader.test.js

@@ -0,0 +1,149 @@
+"use strict";
+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 });
+const fs = __importStar(require("fs"));
+const manifestLoader_1 = require("./manifestLoader");
+// Mock fs module
+jest.mock("fs");
+const mockFs = fs;
+describe("Manifest Loader", () => {
+    const validManifest = {
+        project: {
+            name: "test-project",
+            binDir: "./bin",
+            objDir: "./obj",
+            outputCartName: "output.tic",
+        },
+        imports: [
+            {
+                name: "maincode",
+                path: "main.lua",
+                kind: "LuaCode",
+            },
+        ],
+        assembly: {
+            blocks: [
+                {
+                    asset: "maincode",
+                },
+            ],
+        },
+    };
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+    describe("findManifestInDirectory", () => {
+        it("should find .ticbuild.jsonc file", () => {
+            mockFs.readdirSync.mockReturnValue(["test.ticbuild.jsonc", "other.txt"]);
+            const result = (0, manifestLoader_1.findManifestInDirectory)("/test/dir");
+            expect(result).toContain("test.ticbuild.jsonc");
+            expect(result).toContain("test");
+            expect(result).toContain("dir");
+        });
+        it("should find .ticbuild.json file", () => {
+            mockFs.readdirSync.mockReturnValue(["test.ticbuild.json", "other.txt"]);
+            const result = (0, manifestLoader_1.findManifestInDirectory)("/test/dir");
+            expect(result).toContain("test.ticbuild.json");
+        });
+        it("should return undefined if no manifest found", () => {
+            mockFs.readdirSync.mockReturnValue(["other.txt", "config.json"]);
+            const result = (0, manifestLoader_1.findManifestInDirectory)("/test/dir");
+            expect(result).toBeUndefined();
+        });
+        it("should throw ManifestLoadError if directory cannot be read", () => {
+            mockFs.readdirSync.mockImplementation(() => {
+                throw new Error("Permission denied");
+            });
+            expect(() => (0, manifestLoader_1.findManifestInDirectory)("/test/dir")).toThrow(manifestLoader_1.ManifestLoadError);
+        });
+    });
+    describe("loadManifest", () => {
+        it("should load and validate a valid manifest", () => {
+            const manifestContent = JSON.stringify(validManifest);
+            mockFs.existsSync.mockReturnValue(true);
+            mockFs.readFileSync.mockReturnValue(manifestContent);
+            const result = (0, manifestLoader_1.loadManifest)("/test/manifest.ticbuild.jsonc");
+            expect(result.manifest).toMatchObject(validManifest);
+            expect(result.filePath).toContain("manifest.ticbuild.jsonc");
+            expect(result.projectDir).toBeDefined();
+        });
+        it("should handle JSONC with comments", () => {
+            const manifestContent = `{
+        // This is a comment
+        "project": {
+          "name": "test-project",
+          "binDir": "./bin",
+          "objDir": "./obj",
+          "outputCartName": "output.tic"
+        },
+        "imports": [
+          {
+            "name": "maincode",
+            "path": "main.lua",
+            "kind": "LuaCode"
+          }
+        ],
+        "assembly": {
+          "blocks": [
+            {
+              "asset": "maincode"
+            }
+          ]
+        }
+      }`;
+            mockFs.existsSync.mockReturnValue(true);
+            mockFs.readFileSync.mockReturnValue(manifestContent);
+            const result = (0, manifestLoader_1.loadManifest)("/test/manifest.ticbuild.jsonc");
+            expect(result.manifest.project.name).toBe("test-project");
+        });
+        it("should throw ManifestValidationError for invalid manifest", () => {
+            const invalidManifest = {
+                project: {
+                    name: "test",
+                    // missing required fields
+                },
+            };
+            mockFs.existsSync.mockReturnValue(true);
+            mockFs.readFileSync.mockReturnValue(JSON.stringify(invalidManifest));
+            expect(() => (0, manifestLoader_1.loadManifest)("/test/invalid.ticbuild.jsonc")).toThrow(manifestLoader_1.ManifestValidationError);
+        });
+        it("should throw ManifestLoadError for invalid JSON", () => {
+            mockFs.existsSync.mockReturnValue(true);
+            mockFs.readFileSync.mockReturnValue("{ invalid json }");
+            expect(() => (0, manifestLoader_1.loadManifest)("/test/bad.ticbuild.jsonc")).toThrow();
+        });
+    });
+});
+//# sourceMappingURL=manifestLoader.test.js.map

package/dist/buildInfo.d.ts

@@ -1,9 +1,8 @@
 export declare const buildInfo: {
-    readonly gitTag: "v1.0.0";
-    readonly commitsSinceTag: 6;
+    readonly version: "1.0.3";
     readonly dirty: false;
-    readonly buildDate: "2026-01-26T19:12:28.748Z";
-    readonly lastCommitDate: "2026-01-26T20:12:23+01:00";
-    readonly commitHash: "f1af073";
+    readonly buildDate: "2026-01-26T20:24:43.365Z";
+    readonly lastCommitDate: "2026-01-26T21:24:36+01:00";
+    readonly commitHash: "3b6f257";
 };
 //# sourceMappingURL=buildInfo.d.ts.map

package/dist/buildInfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildInfo.d.ts","sourceRoot":"","sources":["../src/buildInfo.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,SAAS;;;;;;;CAOZ,CAAC"}
+{"version":3,"file":"buildInfo.d.ts","sourceRoot":"","sources":["../src/buildInfo.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,SAAS;;;;;;CAMZ,CAAC"}

package/dist/buildInfo.js

@@ -3,11 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildInfo = void 0;
 // Auto-generated by scripts/gen-build-info.js. Do not edit.
 exports.buildInfo = {
-    "gitTag": "v1.0.0",
-    "commitsSinceTag": 6,
+    "version": "1.0.3",
     "dirty": false,
-    "buildDate": "2026-01-26T19:12:28.748Z",
-    "lastCommitDate": "2026-01-26T20:12:23+01:00",
-    "commitHash": "f1af073"
+    "buildDate": "2026-01-26T20:24:43.365Z",
+    "lastCommitDate": "2026-01-26T21:24:36+01:00",
+    "commitHash": "3b6f257"
 };
 //# sourceMappingURL=buildInfo.js.map

package/dist/buildInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildInfo.js","sourceRoot":"","sources":["../src/buildInfo.ts"],"names":[],"mappings":";;;AAAA,4DAA4D;AAC/C,QAAA,SAAS,GAAG;IACvB,QAAQ,EAAE,QAAQ;IAClB,iBAAiB,EAAE,CAAC;IACpB,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,0BAA0B;IACvC,gBAAgB,EAAE,2BAA2B;IAC7C,YAAY,EAAE,SAAS;CACf,CAAC"}
+{"version":3,"file":"buildInfo.js","sourceRoot":"","sources":["../src/buildInfo.ts"],"names":[],"mappings":";;;AAAA,4DAA4D;AAC/C,QAAA,SAAS,GAAG;IACvB,SAAS,EAAE,OAAO;IAClB,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,0BAA0B;IACvC,gBAAgB,EAAE,2BAA2B;IAC7C,YAAY,EAAE,SAAS;CACf,CAAC"}

package/dist/frontend/codeBankWarnings.test.js

@@ -0,0 +1,93 @@
+"use strict";
+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 });
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const core_1 = require("./core");
+const cons = __importStar(require("../utils/console"));
+function writeFile(filePath, content) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, content, "utf-8");
+}
+function createTempProject(code, assemblyBlock) {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), "ticbuild-codewarn-"));
+    const codePath = path.join(dir, "main.lua");
+    writeFile(codePath, code);
+    const manifest = {
+        project: {
+            name: "test",
+            binDir: "./bin",
+            objDir: "./obj",
+            outputCartName: "out.tic",
+        },
+        imports: [
+            {
+                name: "maincode",
+                path: "main.lua",
+                kind: "LuaCode",
+            },
+        ],
+        assembly: {
+            lua: {
+                minify: false,
+            },
+            blocks: [assemblyBlock],
+        },
+    };
+    const manifestPath = path.join(dir, "project.ticbuild.jsonc");
+    writeFile(manifestPath, JSON.stringify(manifest, null, 2));
+    return { dir, manifestPath };
+}
+describe("Code chunk bank warnings", () => {
+    it("should warn when CODE block specifies explicit bank", async () => {
+        const { dir, manifestPath } = createTempProject("print('ok')", {
+            chunks: ["CODE"],
+            bank: 1,
+            asset: "maincode",
+        });
+        // so we can test warnings emitted.
+        const warnSpy = jest.spyOn(cons, "warning").mockImplementation(() => undefined);
+        try {
+            await (0, core_1.buildCore)(manifestPath);
+            expect(warnSpy).toHaveBeenCalledWith("Explicit bank specified for CODE chunk: CODE#1");
+        }
+        finally {
+            warnSpy.mockRestore();
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=codeBankWarnings.test.js.map

package/dist/obj/build.log

@@ -0,0 +1,5 @@
+[2026-01-26T15:39:22.442Z] [INFO] Project loaded from:
+[2026-01-26T15:39:22.442Z] [INFO]   C:\root\git\thenfour\tic80effects\ticbuild\example.ticbuild.jsonc
+[2026-01-26T15:39:22.444Z] [INFO] Outputting resolved manifest to
+[2026-01-26T15:39:22.444Z] [INFO]   C:\root\git\thenfour\tic80effects\ticbuild\dist\obj\resolvedManifest.ticbuild.jsonc
+[2026-01-26T15:39:22.445Z] [INFO] Loading imported resources...

package/dist/utils/algorithms.test.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const algorithms_1 = require("./algorithms");
+describe("Algorithm utilities", () => {
+    describe("debounce", () => {
+        jest.useFakeTimers();
+        it("should debounce function calls", () => {
+            const mockFn = jest.fn();
+            const debouncedFn = (0, algorithms_1.debounce)(mockFn, 100);
+            // Call multiple times rapidly
+            debouncedFn("test1");
+            debouncedFn("test2");
+            debouncedFn("test3");
+            // Function should not be called yet
+            expect(mockFn).not.toHaveBeenCalled();
+            // Fast-forward time
+            jest.advanceTimersByTime(100);
+            // Function should be called once with the last arguments
+            expect(mockFn).toHaveBeenCalledTimes(1);
+            expect(mockFn).toHaveBeenCalledWith("test3");
+        });
+        it("should reset timer on subsequent calls", () => {
+            const mockFn = jest.fn();
+            const debouncedFn = (0, algorithms_1.debounce)(mockFn, 100);
+            debouncedFn("first");
+            jest.advanceTimersByTime(50);
+            debouncedFn("second");
+            jest.advanceTimersByTime(50);
+            // Should not be called yet (timer was reset)
+            expect(mockFn).not.toHaveBeenCalled();
+            jest.advanceTimersByTime(50);
+            // Now it should be called with the last value
+            expect(mockFn).toHaveBeenCalledTimes(1);
+            expect(mockFn).toHaveBeenCalledWith("second");
+        });
+    });
+});
+//# sourceMappingURL=algorithms.test.js.map

package/dist/utils/lua/lua_processor.test.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const lua_processor_1 = require("./lua_processor");
+describe("Lua printer numeric literal formatting", () => {
+    it("should keep leading zero after string concatenation", () => {
+        const options = {
+            stripComments: true,
+            maxIndentLevel: 1,
+            lineBehavior: "tight",
+            maxLineLength: 180,
+            renameLocalVariables: false,
+            aliasRepeatedExpressions: false,
+            aliasLiterals: false,
+            packLocalDeclarations: false,
+            simplifyExpressions: true,
+            removeUnusedLocals: false,
+            removeUnusedFunctions: false,
+            functionNamesToKeep: [],
+            renameTableFields: false,
+            tableEntryKeysToRename: [],
+        };
+        {
+            const input = 'local s="str"..(1/4)';
+            const output = (0, lua_processor_1.processLua)(input, options);
+            expect(output).toContain('"str"..0.25');
+        }
+        {
+            // integers don't need leading zero
+            const input = 'local s="str"..10';
+            const output = (0, lua_processor_1.processLua)(input, options);
+            expect(output).toContain('"str"..10');
+        }
+        {
+            const input = `print("x="..(.25))`;
+            const output = (0, lua_processor_1.processLua)(input, options);
+            expect(output).toContain('"x="..0.25');
+        }
+        {
+            const input = `local t = 0.25 print("t=" .. t)`;
+            const output = (0, lua_processor_1.processLua)(input, options);
+            // i see:
+            // local t=.25 print(\"t=\"...25..\"\")
+            expect(output).toContain('t="..0.25');
+        }
+    });
+    it("should use parenthesis when a numeric literal precedes a string concatenation operator", () => {
+        const options = {
+            stripComments: true,
+            maxIndentLevel: 1,
+            lineBehavior: "tight",
+            maxLineLength: 180,
+            renameLocalVariables: false,
+            aliasRepeatedExpressions: false,
+            aliasLiterals: false,
+            packLocalDeclarations: false,
+            simplifyExpressions: true,
+            removeUnusedLocals: false,
+            removeUnusedFunctions: false,
+            functionNamesToKeep: [],
+            renameTableFields: false,
+            tableEntryKeysToRename: [],
+        };
+        {
+            // the following produces a syntax error in parenthesis-less form:
+            // 4.."hello" is a syntax error; Lua treats the .. as a decimal point.
+            // so as we print lua make sure we don't produce this case.
+            const input = "print((4) .. y)";
+            const output = (0, lua_processor_1.processLua)(input, options);
+            expect(output).toContain("(4)..y");
+        }
+        {
+            const input = `local y = 4 print(y.."")`;
+            const output = (0, lua_processor_1.processLua)(input, options);
+            expect(output).toContain(`(4)..""`);
+        }
+        {
+            // having a decimal point doesn't change anything here. Lua parser still
+            // cannot handle it so parenthesis are needed.
+            const input = `local y = 4.2 print(y.."")`;
+            const output = (0, lua_processor_1.processLua)(input, options);
+            expect(output).toContain(`(4.2)..""`);
+        }
+    });
+});
+//# sourceMappingURL=lua_processor.test.js.map

package/dist/utils/math.test.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const math_1 = require("./math");
+describe('Math utilities', () => {
+    describe('clamp', () => {
+        it('should return the value when within range', () => {
+            expect((0, math_1.clamp)(5, 0, 10)).toBe(5);
+            expect((0, math_1.clamp)(0, 0, 10)).toBe(0);
+            expect((0, math_1.clamp)(10, 0, 10)).toBe(10);
+        });
+        it('should clamp to minimum when value is too low', () => {
+            expect((0, math_1.clamp)(-5, 0, 10)).toBe(0);
+            expect((0, math_1.clamp)(-100, 0, 10)).toBe(0);
+            expect((0, math_1.clamp)(1, 1, 10)).toBe(1);
+            expect((0, math_1.clamp)(1.001, 1, 10)).toBe(1.001);
+            expect((0, math_1.clamp)(0.9999, 1, 10)).toBe(1);
+        });
+        it('should clamp to maximum when value is too high', () => {
+            expect((0, math_1.clamp)(15, 0, 10)).toBe(10);
+            expect((0, math_1.clamp)(100, 0, 10)).toBe(10);
+            expect((0, math_1.clamp)(10, 0, 10)).toBe(10);
+            expect((0, math_1.clamp)(9.999, 0, 10)).toBe(9.999);
+            expect((0, math_1.clamp)(10.001, 0, 10)).toBe(10);
+        });
+        it('should work with negative ranges', () => {
+            expect((0, math_1.clamp)(-5, -10, -1)).toBe(-5);
+            expect((0, math_1.clamp)(-15, -10, -1)).toBe(-10);
+            expect((0, math_1.clamp)(0, -10, -1)).toBe(-1);
+        });
+    });
+});
+//# sourceMappingURL=math.test.js.map

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

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cartWriter_1 = require("./cartWriter");
+const cartLoader_1 = require("./cartLoader");
+describe("TIC-80 cart bank support", () => {
+    it("should round-trip banked chunks", async () => {
+        const chunks = [
+            { chunkType: "CODE", bank: 0, data: new Uint8Array([1, 2, 3]) },
+            { chunkType: "CODE", bank: 1, data: new Uint8Array([4, 5]) },
+        ];
+        const output = await (0, cartWriter_1.AssembleTic80Cart)({ chunks });
+        const parsed = (0, cartLoader_1.parseTic80Cart)(output);
+        expect(parsed.chunks).toHaveLength(2);
+        expect(parsed.chunks[0].chunkType).toBe("CODE");
+        expect(parsed.chunks[0].bank).toBe(0);
+        expect(Array.from(parsed.chunks[0].data)).toEqual([1, 2, 3]);
+        expect(parsed.chunks[1].chunkType).toBe("CODE");
+        expect(parsed.chunks[1].bank).toBe(1);
+        expect(Array.from(parsed.chunks[1].data)).toEqual([4, 5]);
+    });
+    it("should reject duplicate chunk type in same bank", async () => {
+        const chunks = [
+            { chunkType: "CODE", bank: 0, data: new Uint8Array([1]) },
+            { chunkType: "CODE", bank: 0, data: new Uint8Array([2]) },
+        ];
+        await expect((0, cartWriter_1.AssembleTic80Cart)({ chunks })).rejects.toThrow("Duplicate chunk type in TIC-80 cart: CODE bank 0");
+    });
+    it("should validate bank index against chunk capabilities", async () => {
+        const chunks = [{ chunkType: "CODE_COMPRESSED", bank: 1, data: new Uint8Array([1]) }];
+        await expect((0, cartWriter_1.AssembleTic80Cart)({ chunks })).rejects.toThrow("Bank index 1 out of range for chunk CODE_COMPRESSED (0..0)");
+    });
+});
+//# sourceMappingURL=bankSupport.test.js.map

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

@@ -1,6 +1,6 @@
 export declare const kTic80CartChunkTypes: {
     readonly $key: "TILES" | "SPRITES" | "MAP" | "CODE" | "FLAGS" | "SFX" | "WAVEFORMS" | "PALETTE" | "MUSIC_TRACKS" | "MUSIC_PATTERNS" | "CODE_COMPRESSED" | "DEFAULT" | "SCREEN" | "CODE_WASM";
-    readonly $value: 6 | 1 | 2 | 4 | 5 | 9 | 10 | 12 | 14 | 15 | 16 | 17 | 18 | 19;
+    readonly $value: 1 | 2 | 4 | 5 | 6 | 9 | 10 | 12 | 14 | 15 | 16 | 17 | 18 | 19;
     readonly $info: ({
         key: "TILES";
     } & {
@@ -332,7 +332,7 @@ export declare const kTic80CartChunkTypes: {
             readonly deprecated: false;
         };
     };
-    readonly infoByValue: Map<6 | 1 | 2 | 4 | 5 | 9 | 10 | 12 | 14 | 15 | 16 | 17 | 18 | 19, ({
+    readonly infoByValue: Map<1 | 2 | 4 | 5 | 6 | 9 | 10 | 12 | 14 | 15 | 16 | 17 | 18 | 19, ({
         key: "TILES";
     } & {
         readonly value: 1;
@@ -431,9 +431,9 @@ export declare const kTic80CartChunkTypes: {
         readonly sizePerBank: 0;
         readonly deprecated: false;
     })>;
-    readonly keyByValue: Map<6 | 1 | 2 | 4 | 5 | 9 | 10 | 12 | 14 | 15 | 16 | 17 | 18 | 19, "TILES" | "SPRITES" | "MAP" | "CODE" | "FLAGS" | "SFX" | "WAVEFORMS" | "PALETTE" | "MUSIC_TRACKS" | "MUSIC_PATTERNS" | "CODE_COMPRESSED" | "DEFAULT" | "SCREEN" | "CODE_WASM">;
+    readonly keyByValue: Map<1 | 2 | 4 | 5 | 6 | 9 | 10 | 12 | 14 | 15 | 16 | 17 | 18 | 19, "TILES" | "SPRITES" | "MAP" | "CODE" | "FLAGS" | "SFX" | "WAVEFORMS" | "PALETTE" | "MUSIC_TRACKS" | "MUSIC_PATTERNS" | "CODE_COMPRESSED" | "DEFAULT" | "SCREEN" | "CODE_WASM">;
     readonly keys: ["TILES" | "SPRITES" | "MAP" | "CODE" | "FLAGS" | "SFX" | "WAVEFORMS" | "PALETTE" | "MUSIC_TRACKS" | "MUSIC_PATTERNS" | "CODE_COMPRESSED" | "DEFAULT" | "SCREEN" | "CODE_WASM", ...("TILES" | "SPRITES" | "MAP" | "CODE" | "FLAGS" | "SFX" | "WAVEFORMS" | "PALETTE" | "MUSIC_TRACKS" | "MUSIC_PATTERNS" | "CODE_COMPRESSED" | "DEFAULT" | "SCREEN" | "CODE_WASM")[]];
-    readonly values: (6 | 1 | 2 | 4 | 5 | 9 | 10 | 12 | 14 | 15 | 16 | 17 | 18 | 19)[];
+    readonly values: (1 | 2 | 4 | 5 | 6 | 9 | 10 | 12 | 14 | 15 | 16 | 17 | 18 | 19)[];
     readonly infos: (({
         key: "TILES";
     } & {
@@ -533,7 +533,7 @@ export declare const kTic80CartChunkTypes: {
         readonly sizePerBank: 0;
         readonly deprecated: false;
     }))[];
-    readonly valuesSet: Set<6 | 1 | 2 | 4 | 5 | 9 | 10 | 12 | 14 | 15 | 16 | 17 | 18 | 19>;
+    readonly valuesSet: Set<1 | 2 | 4 | 5 | 6 | 9 | 10 | 12 | 14 | 15 | 16 | 17 | 18 | 19>;
     readonly keysSet: Set<"TILES" | "SPRITES" | "MAP" | "CODE" | "FLAGS" | "SFX" | "WAVEFORMS" | "PALETTE" | "MUSIC_TRACKS" | "MUSIC_PATTERNS" | "CODE_COMPRESSED" | "DEFAULT" | "SCREEN" | "CODE_WASM">;
     readonly isValidKey: (k: any) => k is "TILES" | "SPRITES" | "MAP" | "CODE" | "FLAGS" | "SFX" | "WAVEFORMS" | "PALETTE" | "MUSIC_TRACKS" | "MUSIC_PATTERNS" | "CODE_COMPRESSED" | "DEFAULT" | "SCREEN" | "CODE_WASM";
     readonly coerceByKey: {

package/dist/utils/versionString.d.ts

@@ -1,6 +1,5 @@
 export type BuildInfoLike = {
-    gitTag: string | null;
-    commitsSinceTag: number | null;
+    version: string;
     dirty: boolean | null;
     buildDate?: string;
     lastCommitDate?: string | null;

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

@@ -1 +1 @@
-{"version":3,"file":"versionString.d.ts","sourceRoot":"","sources":["../../src/utils/versionString.ts"],"names":[],"mappings":"AAiDA,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAOF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAW9D;AAID,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAGD,wBAAgB,4BAA4B,IAAI,MAAM,CAErD"}
+{"version":3,"file":"versionString.d.ts","sourceRoot":"","sources":["../../src/utils/versionString.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAMF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAQ9D;AAID,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAGD,wBAAgB,4BAA4B,IAAI,MAAM,CAErD"}

package/dist/utils/versionString.js

@@ -5,17 +5,13 @@ exports.getAppVersionString = getAppVersionString;
 exports.getAppVersionAndCommitString = getAppVersionAndCommitString;
 const buildInfo_1 = require("../buildInfo");
 // Version tag is like:
-// - v1
-// - v1+290
-// - v1+290(!)
+// - v1.0.2
+// - v1.0.2(!)
 // - unknown
 function getBuildVersionTag(info) {
-    if (!info.gitTag)
+    if (!info.version)
         return "unknown";
-    let str = String(info.gitTag);
-    if (info.commitsSinceTag && info.commitsSinceTag > 0) {
-        str += `+${info.commitsSinceTag}`;
-    }
+    let str = `v${info.version}`;
     if (info.dirty) {
         str += "(!)";
     }

package/dist/utils/versionString.js.map

@@ -1 +1 @@
-{"version":3,"file":"versionString.js","sourceRoot":"","sources":["../../src/utils/versionString.ts"],"names":[],"mappings":";;AA+DA,gDAWC;AAID,kDAEC;AAGD,oEAEC;AArFD,4CAAyC;AA0DzC,uBAAuB;AACvB,OAAO;AACP,WAAW;AACX,cAAc;AACd,YAAY;AACZ,SAAgB,kBAAkB,CAAC,IAAmB;IACpD,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAEnC,IAAI,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;QACrD,GAAG,IAAI,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;IACpC,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,GAAG,IAAI,KAAK,CAAC;IACf,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,+BAA+B;AAC/B,gCAAgC;AAChC,SAAgB,mBAAmB;IACjC,OAAO,YAAY,kBAAkB,CAAC,qBAAS,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,6CAA6C;AAC7C,SAAgB,4BAA4B;IAC1C,OAAO,YAAY,kBAAkB,CAAC,qBAAS,CAAC,KAAK,qBAAS,CAAC,UAAU,IAAI,SAAS,GAAG,CAAC;AAC5F,CAAC"}
+{"version":3,"file":"versionString.js","sourceRoot":"","sources":["../../src/utils/versionString.ts"],"names":[],"mappings":";;AA2BA,gDAQC;AAID,kDAEC;AAGD,oEAEC;AA9CD,4CAAyC;AAuBzC,uBAAuB;AACvB,WAAW;AACX,cAAc;AACd,YAAY;AACZ,SAAgB,kBAAkB,CAAC,IAAmB;IACpD,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAEpC,IAAI,GAAG,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,GAAG,IAAI,KAAK,CAAC;IACf,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,+BAA+B;AAC/B,gCAAgC;AAChC,SAAgB,mBAAmB;IACjC,OAAO,YAAY,kBAAkB,CAAC,qBAAS,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,6CAA6C;AAC7C,SAAgB,4BAA4B;IAC1C,OAAO,YAAY,kBAAkB,CAAC,qBAAS,CAAC,KAAK,qBAAS,CAAC,UAAU,IAAI,SAAS,GAAG,CAAC;AAC5F,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticbuild",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "A build & watch system for TIC-80",
   "main": "dist/index.js",
   "bin": {
@@ -28,6 +28,14 @@
     "url": "https://github.com/thenfour/ticbuild"
   },
   "license": "ISC",
+  "files": [
+    ".attachments/",
+    "dist/",
+    "templates/",
+    "README.md",
+    "LICENSE",
+    "ticbuild.schema.json"
+  ],
   "devDependencies": {
     "@types/jest": "^29.0.0",
     "@types/node": "^20.0.0",

package/templates/example/project.ticbuild.jsonc

@@ -0,0 +1,43 @@
+// paths are always relative to the manifest file's dir (which defines the project root dir)
+{
+    "$schema": "./ticbuild.schema.json",
+    "project": {
+        "name": "{{PROJECT_NAME}}",
+        "includeDirs": [
+            "./src"
+        ],
+        "importDirs": [
+            "./assets"
+        ],
+        "binDir": "./dist/bin",
+        "objDir": "./dist/obj",
+        "outputCartName": "$(project.name).tic",
+    },
+    "variables": {},
+    "imports": [
+        {
+            "name": "maincode",
+            "path": "src/main.lua",
+            "kind": "LuaCode",
+        },
+    ],
+    "assembly": {
+        "lua": {
+            "minify": true,
+            "globals": {
+                "PROJECT_NAME": "$(project.name)",
+            },
+        },
+        "blocks": [
+            {
+                "chunks": [
+                    "CODE"
+                ],
+                "asset": "maincode",
+                "code": {
+                    "emitGlobals": true,
+                }
+            },
+        ],
+    },
+}

package/templates/example/src/main.lua

@@ -0,0 +1,4 @@
+function TIC()
+	cls(0)
+	print(__EXPAND("$(project.name)"), 84, 64, 12)
+end

package/templates/minimal/src/main.lua

@@ -0,0 +1,4 @@
+function TIC()
+	cls(0)
+	print(__EXPAND("$(project.name)"), 84, 64, 12)
+end

package/.env.example

@@ -1,3 +0,0 @@
-# TIC-80 location override (optional)
-# If TIC-80 is not in your PATH, specify the full path to tic80.exe here
-# TIC80_LOCATION=C:\path\to\tic80.exe

package/.prettierignore

@@ -1,10 +0,0 @@
-.gitkeep
-.env*
-*.ico
-*.lock
-db/migrations
-.next
-.yarn
-.pnp.*
-node_modules
-README.md

package/debug/obj/resolvedManifest.ticbuild.jsonc

@@ -1,108 +0,0 @@
-{
-  "$schema": "./ticbuild.schema.json",
-  "project": {
-    "name": "example-game",
-    "includeDirs": [
-      "./src",
-      "./include"
-    ],
-    "binDir": "./debug/bin",
-    "objDir": "./debug/obj",
-    "outputCartName": "example-game.tic"
-  },
-  "variables": {
-    "version": "3.0.0",
-    "author": "Example Developer",
-    "$schema": "./ticbuild.schema.json",
-    "project.name": "example-game",
-    "project.binDir": "./debug/bin",
-    "project.objDir": "./debug/obj",
-    "project.outputCartName": "example-game.tic",
-    "variables.version": "3.0.0",
-    "variables.author": "Example Developer",
-    "assembly.lua.minify": "false",
-    "buildConfigurations.debug.project.binDir": "./debug/bin",
-    "buildConfigurations.debug.project.objDir": "./debug/obj",
-    "buildConfigurations.debug.variables.version": "3.0.0",
-    "buildConfigurations.debug.assembly.lua.minify": "false"
-  },
-  "imports": [
-    {
-      "name": "maincode",
-      "path": "main.lua",
-      "kind": "LuaCode"
-    },
-    {
-      "name": "graphics",
-      "path": "./assets/sprites.tic",
-      "kind": "Tic80Cartridge",
-      "chunks": [
-        "TILES",
-        "SPRITES"
-      ]
-    },
-    {
-      "name": "music",
-      "path": "./assets/song.tic",
-      "kind": "Tic80Cartridge",
-      "chunks": [
-        "MUSIC_WAVEFORMS",
-        "MUSIC_PATTERNS",
-        "MUSIC_SFX",
-        "MUSIC_SONG"
-      ]
-    }
-  ],
-  "assembly": {
-    "lua": {
-      "minify": false
-    },
-    "blocks": [
-      {
-        "chunks": [
-          "CODE"
-        ],
-        "asset": {
-          "import": "maincode"
-        },
-        "assembler": "LuaCode"
-      },
-      {
-        "asset": {
-          "import": "graphics",
-          "chunks": [
-            "TILES",
-            "SPRITES"
-          ]
-        }
-      },
-      {
-        "asset": {
-          "import": "music",
-          "chunks": [
-            "MUSIC_WAVEFORMS",
-            "MUSIC_PATTERNS",
-            "MUSIC_SFX",
-            "MUSIC_SONG"
-          ]
-        }
-      }
-    ]
-  },
-  "buildConfigurations": {
-    "debug": {
-      "project": {
-        "binDir": "./debug/bin",
-        "objDir": "./debug/obj"
-      },
-      "variables": {
-        "version": "3.0.0"
-      },
-      "assembly": {
-        "lua": {
-          "minify": false
-        }
-      }
-    }
-  }
-}

package/example.ticbuild.jsonc

@@ -1,94 +0,0 @@
-{
-  "$schema": "./ticbuild.schema.json",
-  // Example manifest for a TIC-80 project
-  "project": {
-    "name": "example",
-    "includeDirs": [
-      "./src",
-      "./include"
-    ],
-    "binDir": "./dist/bin",
-    "objDir": "./dist/obj",
-    "outputCartName": "example.tic",
-  },
-  "variables": {
-    "version": "1.0.0",
-    "author": "Example Developer",
-  },
-  "imports": [
-    {
-      "name": "maincode",
-      "path": "main.lua",
-      "kind": "LuaCode",
-    },
-    {
-      "name": "graphics",
-      "path": "./assets/sprites.tic",
-      "kind": "Tic80Cartridge",
-      "chunks": [
-        "TILES",
-        "SFX"
-      ],
-    },
-    {
-      "name": "music",
-      "path": "./assets/song.tic",
-      "kind": "Tic80Cartridge",
-      "chunks": [
-        "WAVEFORMS",
-        "MUSIC_PATTERNS",
-        "SFX",
-        "MUSIC_TRACKS"
-      ],
-    },
-  ],
-  "assembly": {
-    "lua": {
-      "minify": true,
-    },
-    "blocks": [
-      {
-        "chunks": [
-          "CODE"
-        ],
-        "asset": "maincode",
-      },
-      {
-        "asset": {
-          "import": "graphics",
-          "chunks": [
-            "TILES",
-            "SPRITES"
-          ],
-        },
-      },
-      {
-        "asset": {
-          "import": "music",
-          "chunks": [
-            "WAVEFORMS",
-            "MUSIC_PATTERNS",
-            "SFX",
-            "MUSIC_TRACKS"
-          ],
-        },
-      },
-    ],
-  },
-  "buildConfigurations": {
-    "debug": {
-      "project": {
-        "binDir": "./debug/bin",
-        "objDir": "./debug/obj",
-      },
-      "variables": {
-        "version": "1.0.0-debug",
-      },
-      "assembly": {
-        "lua": {
-          "minify": false,
-        },
-      },
-    },
-  },
-}