@cimplify/cli 0.15.2 → 0.16.0

package/dist/capture-RAJ2B3BH.mjs

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+import { commonOptions } from './chunk-XL54SQJ3.mjs';
+import { readinessSummary } from './chunk-47ZXSY47.mjs';
+import { FINAL_CAPTURE, prepareSession, runSession, writeCapture, CAPTURE_SCHEMA } from './chunk-TYV2SVFN.mjs';
+import { SessionError } from './chunk-KNPYBZ6B.mjs';
+import { EMPTY_READINESS } from './chunk-BYNE553A.mjs';
+import './chunk-NY4YT7O6.mjs';
+import './chunk-SF44L2OD.mjs';
+import './chunk-VSA44UKR.mjs';
+import './chunk-EGQIPYUN.mjs';
+import './chunk-SCKQ4XSD.mjs';
+import { workPath, requireInteractiveProject } from './chunk-CPBESPWK.mjs';
+import './chunk-VHK7WBO3.mjs';
+import './chunk-5HP2INMY.mjs';
+import './chunk-JKECUAAV.mjs';
+import './chunk-THATLMEX.mjs';
+import './chunk-T4MW3PD4.mjs';
+import './chunk-KQNZKV6E.mjs';
+import './chunk-G2ZEFSQJ.mjs';
+import './chunk-ZUCDXRFI.mjs';
+import './chunk-EYEMPIMP.mjs';
+import './chunk-AKACUJ3W.mjs';
+import './chunk-25ZPFHLF.mjs';
+import './chunk-SGT5IJVW.mjs';
+import { parseArgs, flagString, flagBool } from './chunk-XQAHREKO.mjs';
+import './chunk-CLQYPTJ2.mjs';
+import './chunk-TT4YI33G.mjs';
+import { success, warn, info, dim, result, CliError, CLI_ERROR_CODE } from './chunk-KOD4GBQ5.mjs';
+import path from 'path';
+
+var CAPTURE_DIR = "captures";
+var PNG = ".png";
+function capturePath(root, out, device, frame, name) {
+  const base = out === void 0 ? workPath(root, CAPTURE_DIR, `${device}-f${frame}${PNG}`) : path.resolve(root, out.endsWith(PNG) ? out : `${out}${PNG}`);
+  if (name === FINAL_CAPTURE) return base;
+  return `${base.slice(0, -PNG.length)}-${name}${PNG}`;
+}
+async function run(argv) {
+  const args = parseArgs(argv);
+  const root = process.cwd();
+  requireInteractiveProject(root, "capture");
+  const options = await commonOptions(args, root);
+  const out = flagString(args, "out");
+  try {
+    const setup = await prepareSession(root);
+    const frames = await runSession(setup, { ...options, screenshots: true, inspect: !flagBool(args, "no-inspect") });
+    const final = frames.find((f) => f.sidecar.name === FINAL_CAPTURE)?.sidecar.frame ?? options.frame;
+    const captures = [];
+    const files = [];
+    for (const frame of frames) {
+      const file = capturePath(root, out, options.device.name, final, frame.sidecar.name);
+      captures.push(await writeCapture(frame, file));
+      files.push(path.relative(root, file));
+      success(`${frame.sidecar.name}: frame ${frame.sidecar.frame} on ${options.device.name} -> ${path.relative(root, file)}`);
+      if (frame.inspect !== null && frame.inspect.checks.findings.length > 0) warn(`${frame.inspect.checks.findings.length} UI findings; run \`cimplify inspect\` for the list`);
+    }
+    info(dim("Each PNG has a JSON sidecar with the frame, clock, seed, device, back-end, readiness and the UI tree"));
+    const readiness = frames.find((f) => f.sidecar.name === FINAL_CAPTURE)?.sidecar.readiness ?? frames[frames.length - 1]?.sidecar.readiness ?? EMPTY_READINESS;
+    info(readinessSummary(readiness));
+    if (readiness.stall_frames > 0) warn(`${readiness.stall_frames} streaming stall frames (a needed chunk was not resident), first at frame ${readiness.stalls[0]}`);
+    const body = { schema: CAPTURE_SCHEMA, captures, files, readiness };
+    result(body);
+  } catch (error) {
+    if (error instanceof SessionError) throw new CliError(CLI_ERROR_CODE.BUILD_FAILED, error.message);
+    throw error;
+  }
+}
+
+export { capturePath, run as default };

package/dist/chunk-25ZPFHLF.mjs

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+import { createHash } from 'crypto';
+
+var DIGEST_PATTERN = /^[0-9a-f]{64}$/;
+function sha256(bytes) {
+  return createHash("sha256").update(bytes).digest("hex");
+}
+function hasher() {
+  return createHash("sha256");
+}
+function finish(hash) {
+  return hash.digest("hex");
+}
+function isDigest(value) {
+  return DIGEST_PATTERN.test(value);
+}
+function digestHex(digest) {
+  if (!isDigest(digest)) throw new Error(`not a lowercase hex sha256 digest: ${digest}`);
+  return digest;
+}
+function canonicalJson(value) {
+  if (value === null || typeof value === "boolean" || typeof value === "string") return JSON.stringify(value);
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) throw new Error("canonical JSON cannot hold a non-finite number");
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) {
+    let out2 = "[";
+    for (let i = 0; i < value.length; i++) out2 += (i === 0 ? "" : ",") + canonicalJson(value[i]);
+    return `${out2}]`;
+  }
+  const record = value;
+  const keys = Object.keys(record).sort(compareStrings);
+  let out = "{";
+  for (let i = 0; i < keys.length; i++) {
+    out += `${i === 0 ? "" : ","}${JSON.stringify(keys[i])}:${canonicalJson(record[keys[i]])}`;
+  }
+  return `${out}}`;
+}
+function compareStrings(a, b) {
+  const n = a.length < b.length ? a.length : b.length;
+  for (let i = 0; i < n; i++) {
+    const ca = a.codePointAt(i);
+    const cb = b.codePointAt(i);
+    if (ca !== cb) return ca < cb ? -1 : 1;
+    if (ca > 65535) i++;
+  }
+  return a.length - b.length;
+}
+
+export { canonicalJson, compareStrings, digestHex, finish, hasher, isDigest, sha256 };

package/dist/chunk-47ZXSY47.mjs

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { loadScript, parseDevice, DEFAULT_DEVICE, DEFAULT_SEED, DEFAULT_FRAMES } from './chunk-KNPYBZ6B.mjs';
+import { EMPTY_READINESS } from './chunk-BYNE553A.mjs';
+import { existsSync } from 'fs';
+import path from 'path';
+
+var READINESS_GATE = "readiness";
+var READINESS_SCRIPTS = ["test/readiness.json", "test/readiness.ts"];
+function kib(bytes) {
+  return `${Math.round(bytes / 1024)} KiB`;
+}
+function readinessSummary(readiness) {
+  if (readiness.first_frame < 0) return "readiness: the game presented no frame through the game API";
+  return `readiness: first frame at frame ${readiness.first_frame} (${Math.round(readiness.first_frame_ms)} ms wall), ${kib(readiness.bytes_before_first_play)} before first play, ${kib(readiness.bytes_total)} total, ${readiness.stall_frames} stall frames in ${readiness.frames}`;
+}
+function readinessScript(root) {
+  for (const name of READINESS_SCRIPTS) {
+    const file = path.join(root, name);
+    if (existsSync(file)) return file;
+  }
+  return null;
+}
+function judgeReadiness(readiness, maxStalls) {
+  const summary = readinessSummary(readiness);
+  if (maxStalls !== null && readiness.stall_frames > maxStalls) {
+    return { name: READINESS_GATE, status: "failed", detail: `${summary}; the script allows ${maxStalls} (max_stalls), first stalls at frames ${readiness.stalls.slice(0, 8).join(", ")}` };
+  }
+  return { name: READINESS_GATE, status: "passed", detail: maxStalls === null ? `${summary}; set max_stalls in the script to gate on stalls` : summary };
+}
+async function readinessGate(root, setup, run) {
+  const file = readinessScript(root);
+  if (file === null) return { name: READINESS_GATE, status: "skipped", detail: `add ${READINESS_SCRIPTS[0]} (an input script along a recorded path) to measure time to first frame, bytes before first play and streaming stalls` };
+  const script = await loadScript(file);
+  const device = parseDevice(script.devices?.[0] ?? DEFAULT_DEVICE);
+  if (typeof device === "string") throw new Error(device);
+  const request = {
+    device,
+    backend: "swiftshader",
+    seed: script.seed ?? DEFAULT_SEED,
+    scene: script.scene,
+    frame: DEFAULT_FRAMES,
+    script,
+    scriptPath: path.relative(root, file),
+    screenshots: false,
+    inspect: false
+  };
+  const frames = await run(setup, request);
+  const readiness = frames[frames.length - 1]?.sidecar.readiness ?? EMPTY_READINESS;
+  return judgeReadiness(readiness, script.max_stalls ?? null);
+}
+
+export { READINESS_GATE, readinessGate, readinessScript, readinessSummary };

package/dist/{chunk-NK6VC264.mjs → chunk-54J3XR4T.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { TERMINAL_DEPLOYMENT_STATUSES, DEPLOYMENT_STATUS } from './chunk-MXYUAJEW.mjs';
-import { dim, CliError, CLI_ERROR_CODE, failure, success, isJsonMode } from './chunk-3QUK5BPY.mjs';
+import { TERMINAL_DEPLOYMENT_STATUSES, DEPLOYMENT_STATUS } from './chunk-LLRUOIMU.mjs';
+import { dim, CliError, CLI_ERROR_CODE, failure, success, isJsonMode } from './chunk-KOD4GBQ5.mjs';
 
 // src/progress.ts
 var POLL_INTERVAL_MS = 1e3;