@lovo/matter-cli 0.4.0 → 0.5.0

package/dist/chunk-YAWX2IU3.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+
+// src/poster/server.ts
+import { createServer } from "http";
+async function createPosterServer(opts) {
+  const server = createServer((request, response) => {
+    const url2 = request.url ?? "/";
+    if (url2 === "/" || url2 === "/index.html") {
+      response.writeHead(200, { "content-type": "text/html; charset=utf-8" });
+      response.end(opts.bundle.html);
+      return;
+    }
+    if (url2 === "/harness.js") {
+      response.writeHead(200, { "content-type": "text/javascript; charset=utf-8" });
+      response.end(opts.bundle.js);
+      return;
+    }
+    if (url2 === "/config.json") {
+      response.writeHead(200, { "content-type": "application/json; charset=utf-8" });
+      response.end(JSON.stringify(opts.config));
+      return;
+    }
+    response.writeHead(404, { "content-type": "text/plain" });
+    response.end("not found");
+  });
+  await new Promise((resolve) => {
+    server.listen(0, "127.0.0.1", resolve);
+  });
+  const rawAddress = server.address();
+  if (rawAddress === null || typeof rawAddress === "string") {
+    throw new Error("matter poster: expected server to bind a TCP address");
+  }
+  const address = rawAddress;
+  const url = `http://127.0.0.1:${address.port}`;
+  return {
+    url,
+    close: () => new Promise((resolve, reject) => {
+      server.close((closeError) => closeError ? reject(closeError) : resolve());
+    })
+  };
+}
+
+export {
+  createPosterServer
+};
+//# sourceMappingURL=chunk-YAWX2IU3.js.map

package/dist/chunk-YAWX2IU3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/poster/server.ts"],"sourcesContent":["import { createServer, type Server } from 'node:http';\nimport type { AddressInfo } from 'node:net';\n\nexport interface PosterBundle {\n  html: string;\n  js: string;\n}\n\nexport interface PosterRenderConfig {\n  width: number;\n  height: number;\n}\n\nexport interface PosterServer {\n  url: string;\n  close: () => Promise<void>;\n}\n\nexport async function createPosterServer(opts: {\n  bundle: PosterBundle;\n  config: PosterRenderConfig;\n}): Promise<PosterServer> {\n  const server: Server = createServer((request, response) => {\n    const url = request.url ?? '/';\n\n    if (url === '/' || url === '/index.html') {\n      response.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });\n      response.end(opts.bundle.html);\n\n      return;\n    }\n    if (url === '/harness.js') {\n      response.writeHead(200, { 'content-type': 'text/javascript; charset=utf-8' });\n      response.end(opts.bundle.js);\n\n      return;\n    }\n    if (url === '/config.json') {\n      response.writeHead(200, { 'content-type': 'application/json; charset=utf-8' });\n      response.end(JSON.stringify(opts.config));\n\n      return;\n    }\n    response.writeHead(404, { 'content-type': 'text/plain' });\n    response.end('not found');\n  });\n\n  await new Promise<void>((resolve) => {\n    server.listen(0, '127.0.0.1', resolve);\n  });\n\n  const rawAddress = server.address();\n\n  if (rawAddress === null || typeof rawAddress === 'string') {\n    throw new Error('matter poster: expected server to bind a TCP address');\n  }\n  const address: AddressInfo = rawAddress;\n  const url = `http://127.0.0.1:${address.port}`;\n\n  return {\n    url,\n    close: () =>\n      new Promise<void>((resolve, reject) => {\n        server.close((closeError) => (closeError ? reject(closeError) : resolve()));\n      }),\n  };\n}\n"],"mappings":";;;AAAA,SAAS,oBAAiC;AAkB1C,eAAsB,mBAAmB,MAGf;AACxB,QAAM,SAAiB,aAAa,CAAC,SAAS,aAAa;AACzD,UAAMA,OAAM,QAAQ,OAAO;AAE3B,QAAIA,SAAQ,OAAOA,SAAQ,eAAe;AACxC,eAAS,UAAU,KAAK,EAAE,gBAAgB,2BAA2B,CAAC;AACtE,eAAS,IAAI,KAAK,OAAO,IAAI;AAE7B;AAAA,IACF;AACA,QAAIA,SAAQ,eAAe;AACzB,eAAS,UAAU,KAAK,EAAE,gBAAgB,iCAAiC,CAAC;AAC5E,eAAS,IAAI,KAAK,OAAO,EAAE;AAE3B;AAAA,IACF;AACA,QAAIA,SAAQ,gBAAgB;AAC1B,eAAS,UAAU,KAAK,EAAE,gBAAgB,kCAAkC,CAAC;AAC7E,eAAS,IAAI,KAAK,UAAU,KAAK,MAAM,CAAC;AAExC;AAAA,IACF;AACA,aAAS,UAAU,KAAK,EAAE,gBAAgB,aAAa,CAAC;AACxD,aAAS,IAAI,WAAW;AAAA,EAC1B,CAAC;AAED,QAAM,IAAI,QAAc,CAAC,YAAY;AACnC,WAAO,OAAO,GAAG,aAAa,OAAO;AAAA,EACvC,CAAC;AAED,QAAM,aAAa,OAAO,QAAQ;AAElC,MAAI,eAAe,QAAQ,OAAO,eAAe,UAAU;AACzD,UAAM,IAAI,MAAM,sDAAsD;AAAA,EACxE;AACA,QAAM,UAAuB;AAC7B,QAAM,MAAM,oBAAoB,QAAQ,IAAI;AAE5C,SAAO;AAAA,IACL;AAAA,IACA,OAAO,MACL,IAAI,QAAc,CAAC,SAAS,WAAW;AACrC,aAAO,MAAM,CAAC,eAAgB,aAAa,OAAO,UAAU,IAAI,QAAQ,CAAE;AAAA,IAC5E,CAAC;AAAA,EACL;AACF;","names":["url"]}

package/dist/chunk-YSFTOGZX.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+import {
+  createPosterServer
+} from "./chunk-YAWX2IU3.js";
+import {
+  bundlePoster
+} from "./chunk-TBB7CTPP.js";
+import {
+  launchAndScreenshot
+} from "./chunk-RRL35RGP.js";
+import {
+  findProjectRoot
+} from "./chunk-Q7CQW6AH.js";
+
+// src/commands/poster.ts
+import { mkdir, stat } from "fs/promises";
+import { dirname, extname, resolve } from "path";
+var READY_TIMEOUT_MS = 1e4;
+var DEFAULT_JPEG_QUALITY = 80;
+function normalizeType(rawType) {
+  const normalizedType = rawType?.toLowerCase();
+  if (normalizedType === void 0 || normalizedType === "jpg" || normalizedType === "jpeg")
+    return "jpeg";
+  if (normalizedType === "png") return "png";
+  throw new Error(`--type must be 'png' or 'jpg' (got ${String(rawType)})`);
+}
+function extensionFor(format) {
+  return format === "png" ? ".png" : ".jpg";
+}
+function resolveOutPath(out, format) {
+  const ext = extname(out).toLowerCase();
+  const expected = extensionFor(format);
+  if (ext === expected) return out;
+  if (format === "jpeg" && ext === ".jpeg") return out;
+  if (ext === ".png" || ext === ".jpg" || ext === ".jpeg") {
+    throw new Error(
+      `--out extension '${ext}' doesn't match --type '${format === "jpeg" ? "jpg" : "png"}'`
+    );
+  }
+  return `${out}${expected}`;
+}
+async function runPoster(opts, io = { cwd: process.cwd(), log: console.log }) {
+  if (!Number.isInteger(opts.width) || opts.width <= 0 || opts.width > 4096) {
+    throw new Error(`--width must be a positive integer \u2264 4096 (got ${opts.width})`);
+  }
+  if (!Number.isInteger(opts.height) || opts.height <= 0 || opts.height > 4096) {
+    throw new Error(`--height must be a positive integer \u2264 4096 (got ${opts.height})`);
+  }
+  if (!Number.isFinite(opts.timeSeconds) || opts.timeSeconds < 0) {
+    throw new Error(`--time must be \u2265 0 (got ${opts.timeSeconds})`);
+  }
+  if (opts.quality !== void 0) {
+    if (!Number.isInteger(opts.quality) || opts.quality < 1 || opts.quality > 100) {
+      throw new Error(`--quality must be an integer 1\u2013100 (got ${opts.quality})`);
+    }
+  }
+  const format = normalizeType(opts.type);
+  const resolvedOut = resolveOutPath(opts.out, format);
+  if (format === "png" && opts.quality !== void 0) {
+    io.log(`warn: --quality is ignored for PNG output (lossless)`);
+  }
+  const quality = format === "jpeg" ? opts.quality ?? DEFAULT_JPEG_QUALITY : void 0;
+  const fromAbs = resolve(io.cwd, opts.from);
+  const outAbs = resolve(io.cwd, resolvedOut);
+  try {
+    await stat(fromAbs);
+  } catch {
+    throw new Error(`--from ${opts.from}: file not found`);
+  }
+  const projectRoot = await findProjectRoot(fromAbs);
+  const bundle = await bundlePoster({
+    from: fromAbs,
+    exportName: opts.exportName,
+    projectRoot
+  });
+  const server = await createPosterServer({
+    bundle,
+    config: { width: opts.width, height: opts.height }
+  });
+  try {
+    await mkdir(dirname(outAbs), { recursive: true });
+    const { bytes } = await launchAndScreenshot({
+      url: server.url,
+      width: opts.width,
+      height: opts.height,
+      timeSeconds: opts.timeSeconds,
+      readyTimeoutMs: READY_TIMEOUT_MS,
+      outPath: outAbs,
+      projectRoot,
+      format,
+      quality
+    });
+    io.log(`Wrote poster: ${resolvedOut} (${opts.width}\xD7${opts.height}, ${formatBytes(bytes)})`);
+    io.log("");
+    io.log(`Wire it up inside ${opts.from}:`);
+    io.log('  <ShaderScene fallback={<img src="' + posterPublicSrc(resolvedOut) + '" alt="" />}>');
+    io.log("    ...");
+    io.log("  </ShaderScene>");
+  } finally {
+    await server.close();
+  }
+}
+function formatBytes(byteCount) {
+  if (byteCount < 1024) return `${byteCount} B`;
+  if (byteCount < 1024 * 1024) return `${(byteCount / 1024).toFixed(1)} KB`;
+  return `${(byteCount / 1024 / 1024).toFixed(2)} MB`;
+}
+function posterPublicSrc(outPath) {
+  const publicSegmentIndex = outPath.replace(/\\/g, "/").indexOf("/public/");
+  if (publicSegmentIndex >= 0)
+    return outPath.replace(/\\/g, "/").slice(publicSegmentIndex + "/public".length);
+  return outPath;
+}
+
+export {
+  resolveOutPath,
+  runPoster
+};
+//# sourceMappingURL=chunk-YSFTOGZX.js.map

package/dist/chunk-YSFTOGZX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/poster.ts"],"sourcesContent":["import { mkdir, stat } from 'node:fs/promises';\nimport { dirname, extname, resolve } from 'node:path';\n\nimport { bundlePoster } from '../poster/bundle.js';\nimport { launchAndScreenshot } from '../poster/playwright.js';\nimport { findProjectRoot } from '../poster/projectRoot.js';\nimport { createPosterServer } from '../poster/server.js';\n\nexport type PosterFormat = 'jpeg' | 'png';\n\nexport interface PosterOptions {\n  from: string;\n  out: string;\n  exportName: string;\n  timeSeconds: number;\n  width: number;\n  height: number;\n  type?: string;\n  quality?: number;\n}\n\nexport interface PosterIO {\n  cwd: string;\n  log: (line: string) => void;\n}\n\nconst READY_TIMEOUT_MS = 10_000;\nconst DEFAULT_JPEG_QUALITY = 80;\n\nfunction normalizeType(rawType: string | undefined): PosterFormat {\n  const normalizedType = rawType?.toLowerCase();\n\n  if (normalizedType === undefined || normalizedType === 'jpg' || normalizedType === 'jpeg')\n    return 'jpeg';\n  if (normalizedType === 'png') return 'png';\n\n  throw new Error(`--type must be 'png' or 'jpg' (got ${String(rawType)})`);\n}\n\nfunction extensionFor(format: PosterFormat): string {\n  return format === 'png' ? '.png' : '.jpg';\n}\n\nexport function resolveOutPath(out: string, format: PosterFormat): string {\n  const ext = extname(out).toLowerCase();\n  const expected = extensionFor(format);\n\n  if (ext === expected) return out;\n  if (format === 'jpeg' && ext === '.jpeg') return out;\n  if (ext === '.png' || ext === '.jpg' || ext === '.jpeg') {\n    throw new Error(\n      `--out extension '${ext}' doesn't match --type '${format === 'jpeg' ? 'jpg' : 'png'}'`,\n    );\n  }\n\n  return `${out}${expected}`;\n}\n\nexport async function runPoster(\n  opts: PosterOptions,\n  io: PosterIO = { cwd: process.cwd(), log: console.log },\n): Promise<void> {\n  if (!Number.isInteger(opts.width) || opts.width <= 0 || opts.width > 4096) {\n    throw new Error(`--width must be a positive integer ≤ 4096 (got ${opts.width})`);\n  }\n  if (!Number.isInteger(opts.height) || opts.height <= 0 || opts.height > 4096) {\n    throw new Error(`--height must be a positive integer ≤ 4096 (got ${opts.height})`);\n  }\n  if (!Number.isFinite(opts.timeSeconds) || opts.timeSeconds < 0) {\n    throw new Error(`--time must be ≥ 0 (got ${opts.timeSeconds})`);\n  }\n  if (opts.quality !== undefined) {\n    if (!Number.isInteger(opts.quality) || opts.quality < 1 || opts.quality > 100) {\n      throw new Error(`--quality must be an integer 1–100 (got ${opts.quality})`);\n    }\n  }\n\n  const format = normalizeType(opts.type);\n  const resolvedOut = resolveOutPath(opts.out, format);\n\n  if (format === 'png' && opts.quality !== undefined) {\n    io.log(`warn: --quality is ignored for PNG output (lossless)`);\n  }\n\n  const quality = format === 'jpeg' ? (opts.quality ?? DEFAULT_JPEG_QUALITY) : undefined;\n\n  const fromAbs = resolve(io.cwd, opts.from);\n  const outAbs = resolve(io.cwd, resolvedOut);\n\n  try {\n    await stat(fromAbs);\n  } catch {\n    throw new Error(`--from ${opts.from}: file not found`);\n  }\n\n  const projectRoot = await findProjectRoot(fromAbs);\n  const bundle = await bundlePoster({\n    from: fromAbs,\n    exportName: opts.exportName,\n    projectRoot,\n  });\n\n  const server = await createPosterServer({\n    bundle,\n    config: { width: opts.width, height: opts.height },\n  });\n\n  try {\n    await mkdir(dirname(outAbs), { recursive: true });\n    const { bytes } = await launchAndScreenshot({\n      url: server.url,\n      width: opts.width,\n      height: opts.height,\n      timeSeconds: opts.timeSeconds,\n      readyTimeoutMs: READY_TIMEOUT_MS,\n      outPath: outAbs,\n      projectRoot,\n      format,\n      quality,\n    });\n\n    io.log(`Wrote poster: ${resolvedOut} (${opts.width}×${opts.height}, ${formatBytes(bytes)})`);\n    io.log('');\n    io.log(`Wire it up inside ${opts.from}:`);\n    io.log('  <ShaderScene fallback={<img src=\"' + posterPublicSrc(resolvedOut) + '\" alt=\"\" />}>');\n    io.log('    ...');\n    io.log('  </ShaderScene>');\n  } finally {\n    await server.close();\n  }\n}\n\nfunction formatBytes(byteCount: number): string {\n  if (byteCount < 1024) return `${byteCount} B`;\n  if (byteCount < 1024 * 1024) return `${(byteCount / 1024).toFixed(1)} KB`;\n\n  return `${(byteCount / 1024 / 1024).toFixed(2)} MB`;\n}\n\nfunction posterPublicSrc(outPath: string): string {\n  // Best-effort hint: if the path goes through `/public/`, suggest the served form.\n  const publicSegmentIndex = outPath.replace(/\\\\/g, '/').indexOf('/public/');\n\n  if (publicSegmentIndex >= 0)\n    return outPath.replace(/\\\\/g, '/').slice(publicSegmentIndex + '/public'.length);\n\n  return outPath;\n}\n"],"mappings":"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","names":[]}

package/dist/commands/poster.d.ts

@@ -0,0 +1,19 @@
+type PosterFormat = 'jpeg' | 'png';
+interface PosterOptions {
+    from: string;
+    out: string;
+    exportName: string;
+    timeSeconds: number;
+    width: number;
+    height: number;
+    type?: string;
+    quality?: number;
+}
+interface PosterIO {
+    cwd: string;
+    log: (line: string) => void;
+}
+declare function resolveOutPath(out: string, format: PosterFormat): string;
+declare function runPoster(opts: PosterOptions, io?: PosterIO): Promise<void>;
+
+export { type PosterFormat, type PosterIO, type PosterOptions, resolveOutPath, runPoster };

package/dist/commands/poster.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import {
+  resolveOutPath,
+  runPoster
+} from "../chunk-YSFTOGZX.js";
+import "../chunk-YAWX2IU3.js";
+import "../chunk-TBB7CTPP.js";
+import "../chunk-RRL35RGP.js";
+import "../chunk-Q7CQW6AH.js";
+import "../chunk-D4HDZEJT.js";
+export {
+  resolveOutPath,
+  runPoster
+};
+//# sourceMappingURL=poster.js.map

package/dist/commands/poster.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}