@m4l-jweb/build 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jaime Lopez (alienmind)
+
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m4l-jweb/build",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "m4l-jweb: the CLI that builds and packages a device repo into installable Max for Live devices.",
   "type": "module",
   "license": "MIT",
@@ -18,17 +18,19 @@
   "exports": {
     ".": "./src/index.mjs",
     "./chains": "./src/chains.mjs",
-    "./amxd": "./src/amxd.mjs"
+    "./amxd": "./src/amxd.mjs",
+    "./init": "./src/init.mjs"
   },
   "files": [
     "bin",
     "src",
-    "templates"
+    "templates",
+    "LICENSE"
   ],
   "dependencies": {
     "acorn": "^8.17.0",
     "archiver": "^7.0.1",
     "typescript": "^5.7.0",
-    "@m4l-jweb/wrapper": "0.1.0"
+    "@m4l-jweb/wrapper": "0.2.0"
   }
 }

package/src/amxd.mjs

@@ -21,9 +21,9 @@ import { parse } from "acorn";
 
 /** 'aaaa' audio effect / 'mmmm' MIDI effect / 'iiii' instrument. */
 export const AMXD_TYPES = {
-	midi: 0x6d6d6d6d,
-	audio: 0x61616161,
-	instrument: 0x69696969,
+  midi: 0x6d6d6d6d,
+  audio: 0x61616161,
+  instrument: 0x69696969,
 };
 
 const TAG_BY_CODE = { 0x61616161: "aaaa", 0x6d6d6d6d: "mmmm", 0x69696969: "iiii" };
@@ -35,11 +35,11 @@ const TAG_BY_CODE = { 0x61616161: "aaaa", 0x6d6d6d6d: "mmmm", 0x69696969: "iiii"
  * preference. Call this on the exact bytes that will ship.
  */
 export function assertES5(js, label = "wrapper") {
-	try {
-		parse(js, { ecmaVersion: 5 });
-	} catch (e) {
-		throw new Error(`${label} is not valid ES5: ${e.message}`);
-	}
+  try {
+    parse(js, { ecmaVersion: 5 });
+  } catch (e) {
+    throw new Error(`${label} is not valid ES5: ${e.message}`);
+  }
 }
 
 /**
@@ -51,17 +51,17 @@ export function assertES5(js, label = "wrapper") {
  * so it carries the payload and writes it to a real file on first load.
  */
 export function payloadJs(prefix, name, buf) {
-	const CHUNK = 30000; // multiple of 3 -> each chunk is padding-free base64
-	const chunks = [];
-	for (let i = 0; i < buf.length; i += CHUNK) {
-		chunks.push(JSON.stringify(buf.subarray(i, i + CHUNK).toString("base64")));
-	}
-	return (
-		`\n// ---- generated: embedded ${prefix} payload ----\n` +
-		`var ${prefix}_NAME = ${JSON.stringify(name)};\n` +
-		`var ${prefix}_BYTES = ${buf.length};\n` +
-		`var ${prefix}_B64 = [\n${chunks.join(",\n")}\n];\n`
-	);
+  const CHUNK = 30000; // multiple of 3 -> each chunk is padding-free base64
+  const chunks = [];
+  for (let i = 0; i < buf.length; i += CHUNK) {
+    chunks.push(JSON.stringify(buf.subarray(i, i + CHUNK).toString("base64")));
+  }
+  return (
+    `\n// ---- generated: embedded ${prefix} payload ----\n` +
+    `var ${prefix}_NAME = ${JSON.stringify(name)};\n` +
+    `var ${prefix}_BYTES = ${buf.length};\n` +
+    `var ${prefix}_B64 = [\n${chunks.join(",\n")}\n];\n`
+  );
 }
 
 /**
@@ -74,38 +74,38 @@ export function payloadJs(prefix, name, buf) {
  * the wrapper's core.ts.
  */
 export function extraPayloadsJs(payloads) {
-	const names = payloads.map((p) => JSON.stringify(p.name));
-	const bytes = payloads.map((p) => p.data.length);
-	const blobs = payloads.map((p) => {
-		const CHUNK = 30000;
-		const chunks = [];
-		for (let i = 0; i < p.data.length; i += CHUNK) {
-			chunks.push(JSON.stringify(p.data.subarray(i, i + CHUNK).toString("base64")));
-		}
-		return `[\n${chunks.join(",\n")}\n]`;
-	});
-	return (
-		`\n// ---- generated: ${payloads.length} extra payload(s) ----\n` +
-		`var EXTRA_PAYLOAD_NAMES = [${names.join(", ")}];\n` +
-		`var EXTRA_PAYLOAD_BYTES = [${bytes.join(", ")}];\n` +
-		`var EXTRA_PAYLOAD_B64 = [\n${blobs.join(",\n")}\n];\n`
-	);
+  const names = payloads.map((p) => JSON.stringify(p.name));
+  const bytes = payloads.map((p) => p.data.length);
+  const blobs = payloads.map((p) => {
+    const CHUNK = 30000;
+    const chunks = [];
+    for (let i = 0; i < p.data.length; i += CHUNK) {
+      chunks.push(JSON.stringify(p.data.subarray(i, i + CHUNK).toString("base64")));
+    }
+    return `[\n${chunks.join(",\n")}\n]`;
+  });
+  return (
+    `\n// ---- generated: ${payloads.length} extra payload(s) ----\n` +
+    `var EXTRA_PAYLOAD_NAMES = [${names.join(", ")}];\n` +
+    `var EXTRA_PAYLOAD_BYTES = [${bytes.join(", ")}];\n` +
+    `var EXTRA_PAYLOAD_B64 = [\n${blobs.join(",\n")}\n];\n`
+  );
 }
 
 const u32be = (n) => {
-	const b = Buffer.alloc(4);
-	b.writeUInt32BE(n >>> 0);
-	return b;
+  const b = Buffer.alloc(4);
+  b.writeUInt32BE(n >>> 0);
+  return b;
 };
 const u32le = (n) => {
-	const b = Buffer.alloc(4);
-	b.writeUInt32LE(n >>> 0);
-	return b;
+  const b = Buffer.alloc(4);
+  b.writeUInt32LE(n >>> 0);
+  return b;
 };
 const field = (tag, payload) => Buffer.concat([Buffer.from(tag, "latin1"), u32be(8 + payload.length), payload]);
 const paddedName = (name) => {
-	const raw = Buffer.from(name + "\0", "latin1");
-	return Buffer.concat([raw, Buffer.alloc((4 - (raw.length % 4)) % 4)]);
+  const raw = Buffer.from(name + "\0", "latin1");
+  return Buffer.concat([raw, Buffer.alloc((4 - (raw.length % 4)) % 4)]);
 };
 
 /**
@@ -119,60 +119,60 @@ const paddedName = (name) => {
  * @returns {Buffer}
  */
 export function buildAmxd({ patcherJson, wrapperJs, deviceName, extras = [] }) {
-	assertES5(wrapperJs, "wrapper.js");
+  assertES5(wrapperJs, "wrapper.js");
 
-	const amxdtype = JSON.parse(patcherJson).patcher?.project?.amxdtype;
-	const deviceTag = TAG_BY_CODE[amxdtype];
-	if (!deviceTag) throw new Error(`unknown project.amxdtype ${amxdtype}`);
+  const amxdtype = JSON.parse(patcherJson).patcher?.project?.amxdtype;
+  const deviceTag = TAG_BY_CODE[amxdtype];
+  if (!deviceTag) throw new Error(`unknown project.amxdtype ${amxdtype}`);
 
-	const macDate = Math.floor(Date.now() / 1000) + 2082844800; // secs since 1904-01-01
+  const macDate = Math.floor(Date.now() / 1000) + 2082844800; // secs since 1904-01-01
 
-	const files = [
-		{ type: "JSON", name: deviceName, data: Buffer.from(patcherJson, "utf8"), flag: 0x11 },
-		{ type: "TEXT", name: "wrapper.js", data: Buffer.from(wrapperJs, "utf8"), flag: 0 },
-		...extras.map((e) => ({
-			type: e.type ?? (/\.(maxpat|json)$/.test(e.name) ? "JSON" : "TEXT"),
-			name: e.name,
-			data: e.data,
-			flag: 0,
-		})),
-	];
+  const files = [
+    { type: "JSON", name: deviceName, data: Buffer.from(patcherJson, "utf8"), flag: 0x11 },
+    { type: "TEXT", name: "wrapper.js", data: Buffer.from(wrapperJs, "utf8"), flag: 0 },
+    ...extras.map((e) => ({
+      type: e.type ?? (/\.(maxpat|json)$/.test(e.name) ? "JSON" : "TEXT"),
+      name: e.name,
+      data: e.data,
+      flag: 0,
+    })),
+  ];
 
-	// Payload region: the patcher JSON first, at offset 16 (right after mx@c).
-	let offset = 16;
-	const entries = [];
-	for (const f of files) {
-		const at = offset;
-		offset += f.data.length;
-		entries.push(
-			field(
-				"dire",
-				Buffer.concat([
-					field("type", Buffer.from(f.type, "latin1")),
-					field("fnam", paddedName(f.name)),
-					field("sz32", u32be(f.data.length)),
-					field("of32", u32be(at)),
-					field("vers", u32be(0)),
-					field("flag", u32be(f.flag)),
-					field("mdat", u32be(macDate)),
-				]),
-			),
-		);
-	}
+  // Payload region: the patcher JSON first, at offset 16 (right after mx@c).
+  let offset = 16;
+  const entries = [];
+  for (const f of files) {
+    const at = offset;
+    offset += f.data.length;
+    entries.push(
+      field(
+        "dire",
+        Buffer.concat([
+          field("type", Buffer.from(f.type, "latin1")),
+          field("fnam", paddedName(f.name)),
+          field("sz32", u32be(f.data.length)),
+          field("of32", u32be(at)),
+          field("vers", u32be(0)),
+          field("flag", u32be(f.flag)),
+          field("mdat", u32be(macDate)),
+        ]),
+      ),
+    );
+  }
 
-	const payload = Buffer.concat(files.map((f) => f.data));
-	const mxc = Buffer.concat([Buffer.from("mx@c", "latin1"), u32be(16), u32be(0), u32be(16 + payload.length)]);
-	const ptchBody = Buffer.concat([mxc, payload, field("dlst", Buffer.concat(entries))]);
+  const payload = Buffer.concat(files.map((f) => f.data));
+  const mxc = Buffer.concat([Buffer.from("mx@c", "latin1"), u32be(16), u32be(0), u32be(16 + payload.length)]);
+  const ptchBody = Buffer.concat([mxc, payload, field("dlst", Buffer.concat(entries))]);
 
-	return Buffer.concat([
-		Buffer.from("ampf", "latin1"),
-		u32le(4),
-		Buffer.from(deviceTag, "latin1"),
-		Buffer.from("meta", "latin1"),
-		u32le(4),
-		u32le(7),
-		Buffer.from("ptch", "latin1"),
-		u32le(ptchBody.length),
-		ptchBody,
-	]);
+  return Buffer.concat([
+    Buffer.from("ampf", "latin1"),
+    u32le(4),
+    Buffer.from(deviceTag, "latin1"),
+    Buffer.from("meta", "latin1"),
+    u32le(4),
+    u32le(7),
+    Buffer.from("ptch", "latin1"),
+    u32le(ptchBody.length),
+    ptchBody,
+  ]);
 }