build: package the .ablx into release/ via scripts/package.mjs

Move the packaged artifact out of the repo root into release/ (git-ignored), separating the shippable installable from the intermediate dist/ bundle. The wrapper derives the versioned filename from manifest.json, clears stale .ablx files so only the current build remains, prints a clean summary with the install hint, and supports --reveal to open it in Finder.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: madisonrickert

.gitignore

@@ -2,6 +2,7 @@
 node_modules/
 dist/
 ui/dist/
+release/
 
 *.log
 *.ablx

README.md

@@ -82,11 +82,12 @@ The fastest loop uses Live's Developer Mode and an externally-launched Extension
 ## Build & package
 
 ```bash
-npm run build      # production bundle
-npm run package    # produces an installable .ablx
+npm run build               # production bundle → dist/extension.js
+npm run package             # build + package the installable → release/Sheet-Music-<version>.ablx
+npm run package -- --reveal # same, then reveal the .ablx in Finder (macOS)
 ```
 
-Install the `.ablx` by dropping it onto Live's **Extensions** preferences (with Developer Mode **off**, so Live manages the host).
+`npm run package` writes the installable to `release/` (git-ignored), clearing any older `.ablx` first so there's only ever the current one. Install it by dropping the `.ablx` onto Live's **Extensions** preferences (with Developer Mode **off**, so Live manages the host).
 
 ## Test
 

package.json

@@ -16,7 +16,7 @@
     "build:dev": "npm run build:ui && npm run typecheck && tsx build.ts",
     "build": "npm run build:ui && npm run typecheck && tsx build.ts --production",
     "start": "npm run build:dev && extensions-cli run --storage-directory \"$PWD/.dev/storage\" --temp-directory \"$PWD/.dev/temp\"",
-    "package": "npm run build && extensions-cli package",
+    "package": "npm run build && node scripts/package.mjs",
     "dev:ui": "vite"
   },
   "dependencies": {

scripts/package.mjs

@@ -0,0 +1,45 @@
+// Builds the installable .ablx into ./release/ — kept out of the repo root and
+// git-ignored. The .ablx is the *shippable* artifact (a ZIP of manifest.json +
+// the built dist/extension.js) that users drag into Live's Extensions prefs;
+// dist/ holds the intermediate bundle that this packages. Run via
+// `npm run package` (which builds first). Pass `--reveal` to open the file in
+// Finder, ready to drag in: `npm run package -- --reveal`.
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync } from "node:fs";
+import { join } from "node:path";
+
+const OUT_DIR = "release";
+
+function fail(msg) {
+  console.error(`\n  package: ${msg}\n`);
+  process.exit(1);
+}
+
+const manifest = JSON.parse(readFileSync("manifest.json", "utf8"));
+if (!existsSync(manifest.entry)) {
+  fail(`${manifest.entry} not found — run \`npm run build\` first (or just \`npm run package\`).`);
+}
+
+// Match extensions-cli's own naming so the file is identical to its default,
+// only relocated: "<name with spaces → dashes>-<version>.ablx".
+const ablxName = `${(manifest.name || "extension").replace(/\s+/gu, "-")}-${manifest.version || "0.0.0"}.ablx`;
+const outPath = join(OUT_DIR, ablxName);
+
+// One artifact per build: clear stale .ablx files so we never ship the wrong one.
+mkdirSync(OUT_DIR, { recursive: true });
+for (const f of readdirSync(OUT_DIR)) {
+  if (f.endsWith(".ablx")) rmSync(join(OUT_DIR, f));
+}
+
+const cliBin = join("node_modules", ".bin", process.platform === "win32" ? "extensions-cli.cmd" : "extensions-cli");
+// Suppress the CLI's bare path print (stdout); surface its errors (stderr).
+execFileSync(cliBin, ["package", "-o", outPath], { stdio: ["ignore", "ignore", "inherit"] });
+
+const sizeMB = (statSync(outPath).size / 1024 / 1024).toFixed(2);
+console.log(`\n  package: ${manifest.name} ${manifest.version} → ${outPath} (${sizeMB} MB)`);
+console.log(`  install: drag it onto Live → Preferences → Extensions (Developer Mode off).\n`);
+
+if (process.argv.includes("--reveal")) {
+  if (process.platform === "darwin") execFileSync("open", ["-R", outPath]);
+  else console.log("  package: --reveal is macOS-only; skipped.");
+}