@jspicl/cli 4.0.0-alpha.0

package/LICENSE.md

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2019 Agron Kabashi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# @jspicl/cli
+
+A command-line tool that simplifies PICO-8 game development in JavaScript.
+
+**Features:**
+
+- Built-in build pipeline powered by esbuild
+- JavaScript to PICO-8 Lua transpilation via [@jspicl/core](../core)
+- Tree-shaking to minimize token count
+- PNG spritesheet support - use your favorite image editor
+- Live reloading with watch mode
+
+## Installation
+
+```bash
+npm install -D @jspicl/cli
+```
+
+## Usage
+
+```bash
+jspicl <input> <output> --config <config-file> [--watch]
+```
+
+**Example:**
+
+```bash
+jspicl src/game.js build/game.p8 --config jspicl.config.ts --watch
+```
+
+## Config File
+
+Create a config file (JavaScript or TypeScript):
+
+```typescript
+// jspicl.config.ts
+import type {Config} from "@jspicl/cli/types";
+
+const config: Config = {
+  spritesheetImagePath: "assets/sprites.png",
+  jsOutput: "build/game.js",
+  picoPath: "/Applications/PICO-8.app/Contents/MacOS/pico8",
+  reloadOnSave: true,
+  showStats: true
+};
+
+export default config;
+```
+
+### Config Options
+
+| Name                   | Type     | Required | Description                                        |
+| ---------------------- | -------- | -------- | -------------------------------------------------- |
+| `spritesheetImagePath` | string   | Yes      | Path to PNG spritesheet                            |
+| `jsOutput`             | string   | Yes      | Path to output bundled JavaScript (for debugging)  |
+| `picoPath`             | string   | No       | Custom path to PICO-8 executable                   |
+| `includeBanner`        | boolean  | No       | Include jspicl info comment in output              |
+| `luaOutput`            | string   | No       | Path to output transpiled Lua (for debugging)      |
+| `pipeOutputToConsole`  | boolean  | No       | Pipe console.log to terminal                       |
+| `reloadOnSave`         | boolean  | No       | Reload PICO-8 when cartridge is updated            |
+| `showStats`            | boolean  | No       | Display build statistics                           |
+| `jspicl`               | object   | No       | Options passed to @jspicl/core (prettify, etc.)    |
+
+## CLI Options
+
+| Name              | Description                              |
+| ----------------- | ---------------------------------------- |
+| `--config`, `-c`  | Path to config file (required)           |
+| `--watch`, `-w`   | Watch for changes and rebuild            |
+
+## Watch Mode
+
+With `--watch`, the CLI rebuilds automatically when source files change:
+
+![](https://i.imgur.com/QYj4Xga.gif)
+
+This applies for the spritesheet as well. Simply save your image and your changes will be reloaded in PICO-8.
+
+![](https://github.com/AgronKabashi/assets/raw/814f6efe24bc9aca5d9d6ca6259279733529e300/rollup-plugin-jspicl/spritesheetLiveReload.gif)
+
+**Note:** Automatic PICO-8 reload is currently only supported on macOS.
+
+## Requirements
+
+- Node.js 22+
+
+## Related
+
+- [@jspicl/core](../core) - The transpiler library
+- [Games made with jspicl](https://github.com/topics/jspicl-sample)
+
+## License
+
+MIT

package/dist/cli.js

@@ -0,0 +1,530 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+import path5 from "node:path";
+import process2 from "process";
+import esbuild from "esbuild";
+
+// src/arguments.ts
+import path from "node:path";
+var cliArguments = {
+  watch: {
+    description: "Reload cartridge on rebuilds",
+    type: "boolean",
+    default: false,
+    alias: "w"
+  },
+  config: {
+    description: "Path to a config file",
+    type: "string",
+    alias: "c",
+    requiresArg: true,
+    default: {
+      jsOutput: "build/jsOutput.js"
+    },
+    coerce: async (p) => {
+      const configModule = await import(path.resolve(p));
+      return configModule.default;
+    }
+  }
+};
+
+// src/logging.ts
+import fs from "node:fs";
+import path2 from "node:path";
+import { mkdirp } from "mkdirp";
+
+// src/tokenCounter.ts
+var tokens = [
+  /\"[^\"]*\"/,
+  // Strings
+  /\d+\.\d+/,
+  // floating numbers
+  /\w+/,
+  // words
+  /\d+/,
+  // numbers
+  /!=/,
+  // inequality
+  /==/,
+  // comparison
+  /\+=/,
+  // incrementing assignment
+  /-=/,
+  // decrementing assignment
+  /<=/,
+  // equal or less than
+  />=/,
+  // equal or greater than
+  /\.\./,
+  // string concatenation
+  /</,
+  // less than
+  />/,
+  // greater than
+  /\+/,
+  // addition
+  /-/,
+  // subtraction
+  /\//,
+  // division
+  /\*/,
+  // multiplication
+  /=/,
+  // equals
+  /\%/,
+  // percentage
+  /\(/,
+  // paranthesis
+  /\[/,
+  // left bracket
+  /\{/
+  // left curly brace
+].map((r) => r.source).join("|");
+function getTokenCount(luaCode) {
+  const regex = new RegExp(`(${tokens})`, "gi");
+  return (luaCode.match(regex) || []).filter(
+    (token) => token !== "local" && token !== "end"
+  ).length;
+}
+
+// src/logging.ts
+function logToFile(content, filePath) {
+  mkdirp.sync(path2.dirname(filePath));
+  fs.writeFileSync(path2.resolve(filePath), content);
+}
+function logInfo(content) {
+  logToConsole(content, "\x1B[34m\u2139" /* info */);
+}
+function logSuccess(content) {
+  logToConsole(content, "\x1B[32m\u2714" /* success */);
+}
+function logWarning(content) {
+  logToConsole(content, "\x1B[33m\u26A0" /* warning */);
+}
+function logError(content) {
+  logToConsole(content, "\x1B[31m\u2716" /* error */);
+}
+function logToConsole(content, icon) {
+  console.log(`${icon} ${content}\x1B[0m`);
+}
+function logStats(lua, polyfillOutput, code) {
+  const tokens2 = getTokenCount(lua);
+  const polyfillTokens = getTokenCount(polyfillOutput);
+  logInfo("Cartridge Statistics");
+  console.log("".padEnd(41, "\u2014"));
+  const stats = [
+    {
+      label: "Characters",
+      value: lua.length,
+      percent: `${~~(lua.length * 100 / 65535)}%`
+    },
+    {
+      label: "Tokens",
+      value: `~${tokens2}`,
+      percent: `${~~(tokens2 * 100 / 8192)}%`
+    },
+    {
+      label: "  - Polyfills",
+      value: `~${polyfillTokens}`
+    },
+    {
+      label: "Filesize",
+      value: `${Math.ceil(code.length / 1024)} KB`
+    }
+  ];
+  stats.forEach((stats2) => {
+    const label = `${stats2.label}:`.padEnd(20, " ");
+    const value = `${stats2.value}`.padStart(15, " ");
+    const percent = stats2.percent ? `\x1B[33m${stats2.percent}`.padStart(10, " ") : "";
+    console.log(`${label}${value}${percent}\x1B[0m`);
+  });
+}
+
+// src/createPico8Launcher.ts
+import path3 from "path";
+import { spawn, exec } from "child_process";
+import { fileURLToPath } from "url";
+var __dirname = path3.dirname(fileURLToPath(import.meta.url));
+var osMatrix = {
+  win32: {
+    execPath: `"C:\\Program Files (x86)\\PICO-8\\pico8.exe"`
+  },
+  darwin: {
+    execPath: "/Applications/PICO-8.app/Contents/MacOS/pico8",
+    reloadCommand: path3.resolve(__dirname, "../scripts/reload-pico8-bin")
+  },
+  linux: {
+    execPath: "~/pico-8/pico8"
+  }
+};
+function createPico8Launcher(watch, customPicoPath, reloadOnSave, pipeOutputToConsole) {
+  let picoProcess;
+  const { execPath, reloadCommand } = osMatrix[process.platform];
+  return (cartridgePath) => {
+    if (!watch || !cartridgePath) {
+      return;
+    }
+    if (picoProcess) {
+      if (!reloadOnSave) {
+        return;
+      }
+      if (reloadCommand) {
+        logSuccess("Reloading cartridge in PICO-8");
+        exec(reloadCommand);
+      } else {
+        logWarning(
+          "Autoreloading is currently not supported on your OS. Please press Ctrl+R in PICO-8 to see new changes."
+        );
+      }
+    } else {
+      logSuccess("Running cartridge in PICO-8");
+      picoProcess = launchPico8(
+        customPicoPath || execPath,
+        cartridgePath,
+        pipeOutputToConsole
+      );
+      picoProcess.on("close", (errorCode) => {
+        if (errorCode !== 0) {
+          logWarning(`PICO-8 process exited with code ${errorCode}`);
+        }
+        picoProcess = null;
+      });
+    }
+  };
+}
+function launchPico8(picoPath, cartridgePath, pipeOutputToConsole) {
+  return spawn(picoPath, ["-run", `"${path3.resolve(cartridgePath)}"`], {
+    shell: true,
+    stdio: pipeOutputToConsole ? "inherit" : "pipe"
+  });
+}
+
+// src/watchPlugin.ts
+import fs4 from "node:fs";
+
+// src/cartridge.ts
+import fs2 from "fs";
+import path4 from "path";
+function generateCartridgeContent({
+  lua = "",
+  gff = "",
+  gfx = "",
+  music = "",
+  map = "",
+  sfx = ""
+} = {}) {
+  return [
+    "pico-8 cartridge // http://www.pico-8.com",
+    "version 42",
+    "__lua__",
+    lua,
+    gfx && `__gfx__
+${gfx}`,
+    gff && `__gff__
+${gff}`,
+    map && `__map__
+${map}`,
+    sfx && `__sfx__
+${sfx}`,
+    music && `__music__
+${music}`,
+    "\n"
+  ].filter(Boolean).join("\n");
+}
+function getPicoSectionsFromCartridge(cartridgePath) {
+  try {
+    const resolvedCartridgePath = path4.resolve(cartridgePath);
+    const content = fs2.existsSync(resolvedCartridgePath) ? fs2.readFileSync(resolvedCartridgePath, "utf8") : "";
+    return parsePico8Cartridge(content);
+  } catch (error) {
+    throw new Error(
+      `Failed to read cartridge at ${cartridgePath}: ${error.message}`
+    );
+  }
+}
+function parsePico8Cartridge(content) {
+  const cartridgeSections = {
+    lua: "",
+    gff: "",
+    gfx: "",
+    music: "",
+    map: "",
+    sfx: ""
+  };
+  const regex = /__(\w+)__\n([\s\S]*?)(?=\n__\w+__\n|\n(\n|$))/g;
+  let result;
+  while ((result = regex.exec(content)) !== null) {
+    const [, section, content2] = result;
+    cartridgeSections[section] = content2;
+  }
+  return cartridgeSections;
+}
+
+// src/spritesheet.ts
+import fs3 from "fs";
+import pngjs from "pngjs";
+
+// src/constants.ts
+var JSPICL_BANNER = `--[[
+generated with jspicl,
+a javascript to pico-8 lua
+transpiler.
+
+please report any bugs at:
+https://github.com/jspicl/jspicl/issues
+]]--
+`;
+var PICO8_PALETTE = [
+  {
+    r: 0,
+    g: 0,
+    b: 0
+  },
+  {
+    r: 29,
+    g: 43,
+    b: 83
+  },
+  {
+    r: 126,
+    g: 37,
+    b: 83
+  },
+  {
+    r: 0,
+    g: 135,
+    b: 81
+  },
+  {
+    r: 171,
+    g: 82,
+    b: 54
+  },
+  {
+    r: 95,
+    g: 87,
+    b: 79
+  },
+  {
+    r: 194,
+    g: 195,
+    b: 199
+  },
+  {
+    r: 255,
+    g: 241,
+    b: 232
+  },
+  {
+    r: 255,
+    g: 0,
+    b: 77
+  },
+  {
+    r: 255,
+    g: 163,
+    b: 0
+  },
+  {
+    r: 255,
+    g: 236,
+    b: 39
+  },
+  {
+    r: 0,
+    g: 228,
+    b: 54
+  },
+  {
+    r: 41,
+    g: 173,
+    b: 255
+  },
+  {
+    r: 131,
+    g: 118,
+    b: 156
+  },
+  {
+    r: 255,
+    g: 119,
+    b: 168
+  },
+  {
+    r: 255,
+    g: 204,
+    b: 170
+  }
+];
+
+// src/spritesheet.ts
+var spritesheetWidth = 128;
+var spritesheetHeight = 128;
+var hexBase = 16;
+var pixelDataSize = 4;
+var toClosestColor = (pixels) => (_, offset) => {
+  const pixelOffset = offset * pixelDataSize;
+  const pixel = {
+    r: pixels[pixelOffset],
+    g: pixels[pixelOffset + 1],
+    b: pixels[pixelOffset + 2]
+  };
+  let minDistance = Number.MAX_VALUE;
+  let closestPaletteColor = 0;
+  PICO8_PALETTE.forEach(
+    (color, i) => {
+      const diff = (color.r - pixel.r) ** 2 + (color.g - pixel.g) ** 2 + (color.b - pixel.b) ** 2;
+      if (diff < minDistance) {
+        minDistance = diff;
+        closestPaletteColor = i;
+      }
+    }
+  );
+  return closestPaletteColor.toString(hexBase);
+};
+function getSpritesheetFromImage(imagePath) {
+  if (!imagePath) {
+    throw new Error("Image path is missing");
+  }
+  const stream = fs3.createReadStream(imagePath).pipe(new pngjs.PNG());
+  return new Promise(
+    (resolve) => stream.on("parsed", () => {
+      if (stream.width !== spritesheetWidth || stream.height !== spritesheetHeight) {
+        throw new Error("The spritesheet must be a 128x128 png image");
+      }
+      const pixels = new Array(stream.width * stream.height).fill(0).map(toClosestColor(stream.data));
+      const pixelsAsString = new Array(stream.height).fill(0).map(
+        (_, offset) => (
+          // cut the strings so we get stacks of 128 characters
+          pixels.slice(
+            offset * spritesheetWidth,
+            offset * spritesheetWidth + spritesheetWidth
+          ).join("")
+        )
+      ).join("\n");
+      resolve(pixelsAsString);
+    })
+  );
+}
+
+// src/transpile.ts
+import { jspicl } from "@jspicl/core";
+function transpile(javascriptCode, config) {
+  const { includeBanner, polyfillTransform, jspicl: jspiclOptions = {} } = config;
+  const jspiclBanner = includeBanner && `${JSPICL_BANNER}` || "";
+  const { code, polyfills } = jspicl(javascriptCode, jspiclOptions);
+  const polyfillOutput = polyfillTransform ? polyfillTransform(polyfills) : Object.values(polyfills).join("\n");
+  const lua = `${jspiclBanner}${polyfillOutput}${code}`;
+  return {
+    lua,
+    polyfillOutput
+  };
+}
+
+// src/watchPlugin.ts
+var watchPlugin = (options) => ({
+  name: "watcher",
+  setup(build) {
+    build.onEnd(async (result) => {
+      const { onBuildEnd, onBuildError, config, output } = options;
+      const { jsOutput, spritesheetImagePath } = config;
+      if (result.errors.length) {
+        const errors = result.errors.map((error) => error.text).join("\n");
+        onBuildError?.(errors);
+        return;
+      }
+      console.clear();
+      const jsContent = fs4.readFileSync(jsOutput, "utf-8");
+      const transpiledSource = transpile(jsContent, config);
+      const cartridgeSections = getPicoSectionsFromCartridge(output);
+      const gfxSection = await getSpritesheetFromImage(spritesheetImagePath);
+      const cartridgeContent = generateCartridgeContent({
+        ...cartridgeSections,
+        lua: transpiledSource.lua,
+        gfx: gfxSection
+      });
+      onBuildEnd?.(cartridgeContent, transpiledSource);
+    });
+  }
+});
+
+// src/index.ts
+async function getCommandlineArguments() {
+  const argv = await yargs(hideBin(process2.argv)).options(cliArguments).usage("jspicl-cli input output [<args>]").demandCommand(2, "Please specify an input and output file").help(false).strict().wrap(null).parseAsync();
+  const {
+    _: [input, output],
+    ...restArguments
+  } = argv;
+  return {
+    input: path5.resolve(input.toString()),
+    output: path5.resolve(output.toString()),
+    options: restArguments
+  };
+}
+async function startBuildService(input, output, cliOptions) {
+  const { watch, config } = cliOptions;
+  const runPico = createPico8Launcher(
+    watch,
+    config.picoPath,
+    config.reloadOnSave,
+    config.pipeOutputToConsole
+  );
+  const jsOutput = path5.resolve(config.jsOutput || "build/jsOutput.js");
+  const buildConfig = {
+    entryPoints: [input],
+    bundle: true,
+    platform: "neutral",
+    treeShaking: false,
+    minify: false,
+    format: "esm",
+    outfile: jsOutput,
+    plugins: [
+      watchPlugin({
+        config,
+        output,
+        onBuildError: (errors) => {
+          logError(`Build failed with errors:
+${errors}`);
+        },
+        onBuildEnd: (cartridgeContent, transpiledSource) => {
+          config.luaOutput && logToFile(transpiledSource.lua, config.luaOutput);
+          logToFile(cartridgeContent, output);
+          logSuccess("Build completed");
+          runPico(output);
+          config.showStats && logStats(
+            transpiledSource.lua,
+            transpiledSource.polyfillOutput,
+            cartridgeContent
+          );
+        }
+      })
+    ]
+  };
+  if (watch) {
+    const context = await esbuild.context(buildConfig);
+    await context.watch();
+  } else {
+    await esbuild.build(buildConfig);
+  }
+}
+async function runCLI() {
+  const { input, output, options } = await getCommandlineArguments();
+  process2.on("SIGINT", () => {
+    logInfo("Shutting down...");
+    process2.exit(0);
+  });
+  try {
+    await startBuildService(input, output, options);
+  } catch (error) {
+    logError(String(error));
+    throw error;
+  }
+}
+runCLI();
+export {
+  startBuildService
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../src/arguments.ts", "../src/logging.ts", "../src/tokenCounter.ts", "../src/createPico8Launcher.ts", "../src/watchPlugin.ts", "../src/cartridge.ts", "../src/spritesheet.ts", "../src/constants.ts", "../src/transpile.ts"],
+  "sourcesContent": ["import yargs from \"yargs\";\nimport {hideBin} from \"yargs/helpers\";\n\nimport path from \"node:path\";\n\nimport process from \"process\";\n\nimport esbuild, {type BuildOptions} from \"esbuild\";\nimport {cliArguments} from \"./arguments.js\";\nimport {logError, logInfo, logStats, logSuccess, logToFile} from \"./logging.js\";\nimport type {CommandLineOptions} from \"./types.js\";\nimport {createPico8Launcher} from \"./createPico8Launcher.js\";\nimport {watchPlugin} from \"./watchPlugin.js\";\n\nasync function getCommandlineArguments(): Promise<{\n  input: string;\n  output: string;\n  options: CommandLineOptions;\n}> {\n  const argv = await yargs(hideBin(process.argv))\n    .options(cliArguments)\n    .usage(\"jspicl-cli input output [<args>]\")\n    .demandCommand(2, \"Please specify an input and output file\")\n    .help(false)\n    .strict()\n    .wrap(null)\n    .parseAsync();\n\n  const {\n    _: [input, output],\n    ...restArguments\n  } = argv;\n\n  return {\n    input: path.resolve(input.toString()),\n    output: path.resolve(output.toString()),\n    options: restArguments as CommandLineOptions\n  };\n}\n\nexport async function startBuildService(\n  input: string,\n  output: string,\n  cliOptions: CommandLineOptions\n) {\n  const {watch, config} = cliOptions;\n  const runPico = createPico8Launcher(\n    watch,\n    config.picoPath,\n    config.reloadOnSave,\n    config.pipeOutputToConsole\n  );\n\n  const jsOutput = path.resolve(config.jsOutput || \"build/jsOutput.js\");\n\n  const buildConfig: BuildOptions = {\n    entryPoints: [input],\n    bundle: true,\n    platform: \"neutral\",\n    treeShaking: false,\n    minify: false,\n    format: \"esm\",\n    outfile: jsOutput,\n    plugins: [\n      watchPlugin({\n        config,\n        output,\n\n        onBuildError: (errors) => {\n          logError(`Build failed with errors:\\n${errors}`);\n        },\n\n        onBuildEnd: (cartridgeContent, transpiledSource) => {\n          config.luaOutput && logToFile(transpiledSource.lua, config.luaOutput);\n          logToFile(cartridgeContent, output);\n\n          logSuccess(\"Build completed\");\n          runPico(output);\n\n          // Statistics\n          config.showStats &&\n            logStats(\n              transpiledSource.lua,\n              transpiledSource.polyfillOutput,\n              cartridgeContent\n            );\n        }\n      })\n    ]\n  };\n\n  if (watch) {\n    const context = await esbuild.context(buildConfig);\n    await context.watch();\n  } else {\n    await esbuild.build(buildConfig);\n  }\n}\n\nasync function runCLI() {\n  const {input, output, options} = await getCommandlineArguments();\n\n  process.on(\"SIGINT\", () => {\n    logInfo(\"Shutting down...\");\n    process.exit(0);\n  });\n\n  try {\n    await startBuildService(input, output, options);\n  } catch (error) {\n    logError(String(error));\n    throw error;\n  }\n}\n\nrunCLI();\n", "import path from \"node:path\";\nimport type {Options} from \"yargs\";\nimport type {CommandLineOptions, Config} from \"./types.js\";\n\nexport const cliArguments: Record<keyof CommandLineOptions, Options> = {\n  watch: {\n    description: \"Reload cartridge on rebuilds\",\n    type: \"boolean\",\n    default: false,\n    alias: \"w\"\n  },\n  config: {\n    description: \"Path to a config file\",\n    type: \"string\",\n    alias: \"c\",\n    requiresArg: true,\n    default: {\n      jsOutput: \"build/jsOutput.js\"\n    } as Config,\n    coerce: async (p: string) => {\n      const configModule = await import(path.resolve(p));\n      return configModule.default;\n    }\n  }\n};\n", "import fs from \"node:fs\";\nimport path from \"node:path\";\nimport {mkdirp} from \"mkdirp\";\nimport {getTokenCount} from \"./tokenCounter.js\";\n\nenum ICONS {\n  info = \"\\x1b[34m\u2139\",\n  success = \"\\x1b[32m\u2714\",\n  warning = \"\\x1b[33m\u26A0\",\n  error = \"\\x1b[31m\u2716\"\n}\n\nexport function logToFile(content: string, filePath: string) {\n  mkdirp.sync(path.dirname(filePath));\n  fs.writeFileSync(path.resolve(filePath), content);\n}\n\nexport function logInfo(content: string) {\n  logToConsole(content, ICONS.info);\n}\n\nexport function logSuccess(content: string) {\n  logToConsole(content, ICONS.success);\n}\n\nexport function logWarning(content: string) {\n  logToConsole(content, ICONS.warning);\n}\n\nexport function logError(content: string) {\n  logToConsole(content, ICONS.error);\n}\n\nfunction logToConsole(content: string, icon: string) {\n  console.log(`${icon} ${content}\\x1b[0m`);\n}\n\nexport function logStats(lua: string, polyfillOutput: string, code: string) {\n  const tokens = getTokenCount(lua);\n  const polyfillTokens = getTokenCount(polyfillOutput);\n\n  logInfo(\"Cartridge Statistics\");\n  console.log(\"\".padEnd(41, \"\u2014\"));\n\n  const stats = [\n    {\n      label: \"Characters\",\n      value: lua.length,\n      percent: `${~~((lua.length * 100) / 65535)}%`\n    },\n    {\n      label: \"Tokens\",\n      value: `~${tokens}`,\n      percent: `${~~((tokens * 100) / 8192)}%`\n    },\n    {\n      label: \"  - Polyfills\",\n      value: `~${polyfillTokens}`\n    },\n    {\n      label: \"Filesize\",\n      value: `${Math.ceil(code.length / 1024)} KB`\n    }\n  ];\n\n  stats.forEach((stats) => {\n    const label = `${stats.label}:`.padEnd(20, \" \");\n    const value = `${stats.value}`.padStart(15, \" \");\n    const percent = stats.percent\n      ? `\\x1b[33m${stats.percent}`.padStart(10, \" \")\n      : \"\";\n\n    console.log(`${label}${value}${percent}\\x1b[0m`);\n  });\n}\n", "// Each token is a word (e.g. variable name) or operator.\n// Pairs of brackets, and strings count as 1 token.\n// Commas, periods, LOCALs, semi-colons, ENDs, and comments are not counted.\nconst tokens = [\n  /\\\"[^\\\"]*\\\"/, // Strings\n  /\\d+\\.\\d+/, // floating numbers\n  /\\w+/, // words\n  /\\d+/, // numbers\n\n  /!=/, // inequality\n  /==/, // comparison\n  /\\+=/, // incrementing assignment\n  /-=/, // decrementing assignment\n  /<=/, // equal or less than\n  />=/, // equal or greater than\n  /\\.\\./, // string concatenation\n\n  /</, // less than\n  />/, // greater than\n  /\\+/, // addition\n  /-/, // subtraction\n  /\\//, // division\n  /\\*/, // multiplication\n  /=/, // equals\n  /\\%/, // percentage\n  /\\(/, // paranthesis\n  /\\[/, // left bracket\n  /\\{/ // left curly brace\n]\n  .map((r) => r.source)\n  .join(\"|\");\n\n/** Calculates the token count for the passed in Lua code*/\nexport function getTokenCount(luaCode: string) {\n  const regex = new RegExp(`(${tokens})`, \"gi\");\n\n  return (luaCode.match(regex) || []).filter(\n    (token) => token !== \"local\" && token !== \"end\"\n  ).length;\n}\n", "import path from \"path\";\nimport {spawn, exec, ChildProcess} from \"child_process\";\nimport {fileURLToPath} from \"url\";\nimport {logSuccess, logWarning} from \"./logging.js\";\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nconst osMatrix: Record<string, {execPath: string; reloadCommand?: string}> = {\n  win32: {\n    execPath: `\"C:\\\\Program Files (x86)\\\\PICO-8\\\\pico8.exe\"`\n  },\n  darwin: {\n    execPath: \"/Applications/PICO-8.app/Contents/MacOS/pico8\",\n    reloadCommand: path.resolve(__dirname, \"../scripts/reload-pico8-bin\")\n  },\n  linux: {\n    execPath: \"~/pico-8/pico8\"\n  }\n};\n\nexport function createPico8Launcher(\n  watch: boolean,\n  customPicoPath?: string,\n  reloadOnSave?: boolean,\n  pipeOutputToConsole?: boolean\n) {\n  let picoProcess: ChildProcess | null;\n  const {execPath, reloadCommand} = osMatrix[process.platform];\n\n  return (cartridgePath: string) => {\n    if (!watch || !cartridgePath) {\n      return;\n    }\n\n    if (picoProcess) {\n      if (!reloadOnSave) {\n        return;\n      }\n\n      if (reloadCommand) {\n        logSuccess(\"Reloading cartridge in PICO-8\");\n        exec(reloadCommand);\n      } else {\n        logWarning(\n          \"Autoreloading is currently not supported on your OS. Please press Ctrl+R in PICO-8 to see new changes.\"\n        );\n      }\n    } else {\n      logSuccess(\"Running cartridge in PICO-8\");\n      // Use customized path if available, otherwise fallback to the default one for the current OS\n      picoProcess = launchPico8(\n        customPicoPath || execPath,\n        cartridgePath,\n        pipeOutputToConsole\n      );\n\n      picoProcess.on(\"close\", (errorCode) => {\n        if (errorCode !== 0) {\n          logWarning(`PICO-8 process exited with code ${errorCode}`);\n        }\n        picoProcess = null;\n      });\n    }\n  };\n}\n\nfunction launchPico8(\n  picoPath: string,\n  cartridgePath: string,\n  pipeOutputToConsole?: boolean\n) {\n  return spawn(picoPath, [\"-run\", `\"${path.resolve(cartridgePath)}\"`], {\n    shell: true,\n    stdio: pipeOutputToConsole ? \"inherit\" : \"pipe\"\n  });\n}\n", "import type {BuildResult, Plugin} from \"esbuild\";\nimport fs from \"node:fs\";\nimport {\n  generateCartridgeContent,\n  getPicoSectionsFromCartridge\n} from \"./cartridge.js\";\nimport {getSpritesheetFromImage} from \"./spritesheet.js\";\nimport {transpile} from \"./transpile.js\";\nimport type {Config} from \"./types.js\";\n\ntype WatchPluginOptions = {\n  config: Config;\n  output: string;\n  onBuildEnd?: (\n    cartridgeContent: string,\n    transpiledSource: {lua: string; polyfillOutput: string}\n  ) => void;\n  onBuildError?: (errors: string) => void;\n};\n\nexport const watchPlugin = (options: WatchPluginOptions): Plugin => ({\n  name: \"watcher\",\n  setup(build) {\n    build.onEnd(async (result: BuildResult) => {\n      const {onBuildEnd, onBuildError, config, output} = options;\n\n      const {jsOutput, spritesheetImagePath} = config;\n\n      if (result.errors.length) {\n        const errors = result.errors.map((error) => error.text).join(\"\\n\");\n        onBuildError?.(errors);\n\n        return;\n      }\n\n      console.clear();\n\n      const jsContent = fs.readFileSync(jsOutput, \"utf-8\");\n      const transpiledSource = transpile(jsContent, config);\n      const cartridgeSections = getPicoSectionsFromCartridge(output);\n      const gfxSection = await getSpritesheetFromImage(spritesheetImagePath);\n\n      const cartridgeContent = generateCartridgeContent({\n        ...cartridgeSections,\n        lua: transpiledSource.lua,\n        gfx: gfxSection\n      });\n\n      onBuildEnd?.(cartridgeContent, transpiledSource);\n    });\n  }\n});\n", "import fs from \"fs\";\nimport path from \"path\";\nimport type {PicoSections} from \"./types.js\";\n\nexport function generateCartridgeContent({\n  lua = \"\",\n  gff = \"\",\n  gfx = \"\",\n  music = \"\",\n  map = \"\",\n  sfx = \"\"\n}: Partial<PicoSections> = {}) {\n  return [\n    \"pico-8 cartridge // http://www.pico-8.com\",\n    \"version 42\",\n    \"__lua__\",\n    lua,\n    gfx && `__gfx__\\n${gfx}`,\n    gff && `__gff__\\n${gff}`,\n    map && `__map__\\n${map}`,\n    sfx && `__sfx__\\n${sfx}`,\n    music && `__music__\\n${music}`,\n    \"\\n\"\n  ]\n    .filter(Boolean)\n    .join(\"\\n\");\n}\n\nexport function getPicoSectionsFromCartridge(\n  cartridgePath: string\n): PicoSections {\n  try {\n    const resolvedCartridgePath = path.resolve(cartridgePath);\n    const content = fs.existsSync(resolvedCartridgePath)\n      ? fs.readFileSync(resolvedCartridgePath, \"utf8\")\n      : \"\";\n    return parsePico8Cartridge(content);\n  } catch (error) {\n    throw new Error(\n      `Failed to read cartridge at ${cartridgePath}: ${(error as Error).message}`\n    );\n  }\n}\n\nfunction parsePico8Cartridge(content: string): PicoSections {\n  const cartridgeSections: PicoSections = {\n    lua: \"\",\n    gff: \"\",\n    gfx: \"\",\n    music: \"\",\n    map: \"\",\n    sfx: \"\"\n  };\n\n  // Extract the contents of each section\n  const regex = /__(\\w+)__\\n([\\s\\S]*?)(?=\\n__\\w+__\\n|\\n(\\n|$))/g;\n  // /__(\\w+)__\\r?\\n([\\s\\S]*?)(?=__\\w+__|\\s*$)/g;\n\n  let result;\n  while ((result = regex.exec(content)) !== null) {\n    const [, section, content] = result;\n    cartridgeSections[section as keyof PicoSections] = content;\n  }\n\n  return cartridgeSections;\n}\n", "import fs from \"fs\";\nimport pngjs from \"pngjs\";\nimport {PICO8_PALETTE} from \"./constants.js\";\n\nconst spritesheetWidth = 128;\nconst spritesheetHeight = 128;\nconst hexBase = 16;\nconst pixelDataSize = 4; // red + green + blue + alpha\n\nconst toClosestColor = (pixels: Buffer) => (_: any, offset: number) => {\n  const pixelOffset = offset * pixelDataSize;\n  const pixel = {\n    r: pixels[pixelOffset],\n    g: pixels[pixelOffset + 1],\n    b: pixels[pixelOffset + 2]\n  };\n\n  let minDistance = Number.MAX_VALUE;\n  let closestPaletteColor = 0;\n  PICO8_PALETTE.forEach(\n    (color: {r: number; g: number; b: number}, i: number) => {\n      const diff =\n        (color.r - pixel.r) ** 2 +\n        (color.g - pixel.g) ** 2 +\n        (color.b - pixel.b) ** 2;\n\n      if (diff < minDistance) {\n        minDistance = diff;\n        closestPaletteColor = i;\n      }\n    }\n  );\n\n  return closestPaletteColor.toString(hexBase);\n};\n\nexport function getSpritesheetFromImage(imagePath: string): Promise<string> {\n  if (!imagePath) {\n    throw new Error(\"Image path is missing\");\n  }\n\n  const stream = fs.createReadStream(imagePath).pipe(new pngjs.PNG());\n\n  return new Promise((resolve) =>\n    stream.on(\"parsed\", () => {\n      if (\n        stream.width !== spritesheetWidth ||\n        stream.height !== spritesheetHeight\n      ) {\n        throw new Error(\"The spritesheet must be a 128x128 png image\");\n      }\n\n      const pixels = new Array(stream.width * stream.height)\n        .fill(0)\n        .map(toClosestColor(stream.data));\n\n      const pixelsAsString = new Array(stream.height)\n        .fill(0)\n        .map((_: any, offset) =>\n          // cut the strings so we get stacks of 128 characters\n          pixels\n            .slice(\n              offset * spritesheetWidth,\n              offset * spritesheetWidth + spritesheetWidth\n            )\n            .join(\"\")\n        )\n        .join(\"\\n\");\n\n      resolve(pixelsAsString);\n    })\n  );\n}\n", "export const JSPICL_BANNER = `--[[\ngenerated with jspicl,\na javascript to pico-8 lua\ntranspiler.\n\nplease report any bugs at:\nhttps://github.com/jspicl/jspicl/issues\n]]--\n`;\n\nexport const PICO8_PALETTE = [\n  {\n    r: 0,\n    g: 0,\n    b: 0\n  },\n  {\n    r: 29,\n    g: 43,\n    b: 83\n  },\n  {\n    r: 126,\n    g: 37,\n    b: 83\n  },\n  {\n    r: 0,\n    g: 135,\n    b: 81\n  },\n  {\n    r: 171,\n    g: 82,\n    b: 54\n  },\n  {\n    r: 95,\n    g: 87,\n    b: 79\n  },\n  {\n    r: 194,\n    g: 195,\n    b: 199\n  },\n  {\n    r: 255,\n    g: 241,\n    b: 232\n  },\n  {\n    r: 255,\n    g: 0,\n    b: 77\n  },\n  {\n    r: 255,\n    g: 163,\n    b: 0\n  },\n  {\n    r: 255,\n    g: 236,\n    b: 39\n  },\n  {\n    r: 0,\n    g: 228,\n    b: 54\n  },\n  {\n    r: 41,\n    g: 173,\n    b: 255\n  },\n  {\n    r: 131,\n    g: 118,\n    b: 156\n  },\n  {\n    r: 255,\n    g: 119,\n    b: 168\n  },\n  {\n    r: 255,\n    g: 204,\n    b: 170\n  }\n];\n", "import {jspicl} from \"@jspicl/core\";\nimport {JSPICL_BANNER} from \"./constants.js\";\nimport type {Config} from \"./types.js\";\n\nexport function transpile(javascriptCode: string, config: Config) {\n  const {includeBanner, polyfillTransform, jspicl: jspiclOptions = {}} = config;\n\n  const jspiclBanner = (includeBanner && `${JSPICL_BANNER}`) || \"\";\n\n  const {code, polyfills} = jspicl(javascriptCode, jspiclOptions);\n  const polyfillOutput = polyfillTransform\n    ? polyfillTransform(polyfills)\n    : Object.values(polyfills).join(\"\\n\");\n\n  const lua = `${jspiclBanner}${polyfillOutput}${code}`;\n\n  return {\n    lua,\n    polyfillOutput\n  };\n}\n"],
+  "mappings": "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",
+  "names": ["path", "process", "path", "path", "tokens", "stats", "path", "path", "fs", "fs", "path", "content", "fs", "fs", "fs", "process", "path"]
+}

package/dist/types.d.ts

@@ -0,0 +1,25 @@
+import type { Options as JspiclOptions } from "@jspicl/core/types";
+export interface PicoSections extends Record<string, string> {
+    lua: string;
+    gff: string;
+    gfx: string;
+    music: string;
+    map: string;
+    sfx: string;
+}
+export interface Config {
+    spritesheetImagePath: string;
+    jsOutput: string;
+    picoPath?: string;
+    includeBanner?: boolean;
+    luaOutput?: string;
+    pipeOutputToConsole?: boolean;
+    polyfillTransform?: (polyfills: Record<string, string>) => string;
+    reloadOnSave?: boolean;
+    showStats?: boolean;
+    jspicl?: JspiclOptions;
+}
+export interface CommandLineOptions {
+    watch: boolean;
+    config: Config;
+}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@jspicl/cli",
+  "version": "4.0.0-alpha.0",
+  "description": "CLI for simplifying PICO-8 game development in JavaScript",
+  "author": "Agron Kabashi",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "jspicl": "dist/cli.js"
+  },
+  "exports": {
+    "./types": {
+      "types": "./dist/types.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsc --noEmit && tsc -p tsconfig.types.json && esbuild src/index.ts --bundle --platform=node --format=esm --packages=external --banner:js='#!/usr/bin/env node' --outfile=dist/cli.js --sourcemap",
+    "clean": "rm -rf dist",
+    "test": "echo \"No tests yet\"",
+    "prepublishOnly": "yarn clean && yarn test && yarn build"
+  },
+  "prettier": {
+    "arrowParens": "always",
+    "bracketSpacing": false,
+    "endOfLine": "lf",
+    "printWidth": 80,
+    "semi": true,
+    "singleQuote": false,
+    "tabWidth": 2,
+    "trailingComma": "none",
+    "useTabs": false
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jspicl/jspicl"
+  },
+  "keywords": [
+    "jspicl",
+    "pico-8",
+    "cli",
+    "build-tool",
+    "javascript",
+    "lua",
+    "transpiler",
+    "game-development"
+  ],
+  "devDependencies": {
+    "@types/lodash.debounce": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "@types/pngjs": "^6.0.5",
+    "@types/yargs": "^17.0.33",
+    "esbuild": "^0.25.0",
+    "typescript": "^5.7.0"
+  },
+  "dependencies": {
+    "@jspicl/core": "workspace:^",
+    "chokidar": "^5.0.0",
+    "lodash.debounce": "^4.0.8",
+    "mkdirp": "^3.0.1",
+    "pngjs": "^7.0.0",
+    "yargs": "^18.0.0"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}