@aura3d/cli 5.0.3 → 5.2.0

package/dist/verify/command.d.ts

@@ -0,0 +1,12 @@
+import { type VerifyReport } from "./run.js";
+import type { VerifyBrowserDriver } from "./cdp.js";
+export declare const VERIFY_USAGE: string;
+export declare function formatReport(report: VerifyReport): string;
+export declare function verifyCommand(argv: readonly string[], io: {
+    readonly cwd: string;
+    stdout(s: string): void;
+    stderr(s: string): void;
+}, injected?: {
+    driver?: VerifyBrowserDriver;
+}): Promise<number>;
+//# sourceMappingURL=command.d.ts.map

package/dist/verify/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/verify/command.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgC,KAAK,YAAY,EAAmB,MAAM,UAAU,CAAC;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,eAAO,MAAM,YAAY,QAGiD,CAAC;AAoB3E,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAQzD;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,QAAQ,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,mBAAmB,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyCzM"}

package/dist/verify/command.js

@@ -0,0 +1,101 @@
+// `aura3d verify [projectDir] [--json] [--out file] [--skip steps] [--only steps] [--explain CODE] [--list-codes] ...`
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { VERIFY_CODE_TABLE, explainCode, formatExplanation } from "./codes.js";
+import { VERIFY_STEP_ORDER, runVerify } from "./run.js";
+export const VERIFY_USAGE = "aura3d verify [projectDir] [--json] [--out report.json] [--skip typecheck,build,...] [--only a,b] [--route /path] [--dist dist] [--chrome <path>] [--software-gl] [--browser-lock <dir>] [--frames-dir <dir>] [--width N --height N --settle-ms N --motion-gap-ms N --timeout-ms N --ready-timeout-ms N]\n" +
+    "aura3d verify --explain <CODE>      explain one finding code (cause and fix)\n" +
+    "aura3d verify --list-codes          print the whole code table as JSON";
+const valueOf = (argv, name) => {
+    const index = argv.indexOf(name);
+    const value = index >= 0 ? argv[index + 1] : undefined;
+    return value !== undefined && !value.startsWith("--") ? value : undefined;
+};
+const stepList = (value) => (value ?? "").split(",").map((s) => s.trim()).filter(Boolean).map((s) => {
+    if (!VERIFY_STEP_ORDER.includes(s))
+        throw new Error(`Unknown verify step "${s}". Steps: ${VERIFY_STEP_ORDER.join(", ")}.`);
+    return s;
+});
+const numberOf = (argv, name) => {
+    const raw = valueOf(argv, name);
+    if (raw === undefined)
+        return undefined;
+    const n = Number(raw);
+    if (!Number.isFinite(n) || n < 0)
+        throw new Error(`${name} needs a non-negative number.`);
+    return n;
+};
+export function formatReport(report) {
+    const lines = [`aura3d verify: ${report.ok ? "PASS" : "FAIL"} (${report.counts.error} error, ${report.counts.warning} warning) in ${(report.durationMs / 1000).toFixed(1)}s`];
+    for (const step of report.steps)
+        lines.push(`  ${step.status.padEnd(7)} ${step.id}${step.detail ? `  (${step.detail})` : ""}`);
+    for (const f of report.findings) {
+        const where = f.location ? ` ${f.location.file}:${f.location.line}:${f.location.column}` : "";
+        lines.push(`${f.severity.toUpperCase().padEnd(7)} ${f.code}${where}`, `        ${f.message}`, `        fix: ${f.fix}`);
+    }
+    return lines.join("\n");
+}
+export async function verifyCommand(argv, io, injected) {
+    if (argv.includes("--list-codes")) {
+        io.stdout(JSON.stringify(VERIFY_CODE_TABLE, null, 2));
+        return 0;
+    }
+    if (argv.includes("--explain")) {
+        const code = valueOf(argv, "--explain");
+        if (!code) {
+            io.stderr(`Usage: ${VERIFY_USAGE}`);
+            return 2;
+        }
+        const entry = explainCode(code);
+        if (!entry) {
+            io.stderr(`Unknown code "${code}". Run \`aura3d verify --list-codes\` for the table.`);
+            return 2;
+        }
+        io.stdout(argv.includes("--json") ? JSON.stringify(entry, null, 2) : formatExplanation(entry));
+        return 0;
+    }
+    let skip;
+    try {
+        const only = stepList(valueOf(argv, "--only"));
+        skip = only.length ? VERIFY_STEP_ORDER.filter((s) => !only.includes(s)) : stepList(valueOf(argv, "--skip"));
+    }
+    catch (error) {
+        io.stderr(String(error.message));
+        return 2;
+    }
+    const valueFlags = new Set(["--out", "--skip", "--only", "--route", "--dist", "--chrome", "--browser-lock", "--frames-dir", "--width", "--height", "--settle-ms", "--motion-gap-ms", "--timeout-ms", "--ready-timeout-ms"]);
+    const positional = argv.find((arg, i) => !arg.startsWith("--") && !valueFlags.has(argv[i - 1] ?? ""));
+    let report;
+    try {
+        report = await runVerify({
+            projectDir: resolve(io.cwd, positional ?? "."),
+            skip,
+            ...(valueOf(argv, "--dist") ? { distDir: valueOf(argv, "--dist") } : {}),
+            ...(valueOf(argv, "--route") ? { route: valueOf(argv, "--route") } : {}),
+            ...(valueOf(argv, "--chrome") ? { chromePath: valueOf(argv, "--chrome") } : {}),
+            ...(valueOf(argv, "--frames-dir") ? { framesDir: resolve(io.cwd, valueOf(argv, "--frames-dir")) } : {}),
+            ...(valueOf(argv, "--browser-lock") ? { browserLock: valueOf(argv, "--browser-lock") } : {}),
+            ...(argv.includes("--software-gl") ? { softwareGl: true } : {}),
+            ...(numberOf(argv, "--width") !== undefined ? { width: numberOf(argv, "--width") } : {}),
+            ...(numberOf(argv, "--height") !== undefined ? { height: numberOf(argv, "--height") } : {}),
+            ...(numberOf(argv, "--settle-ms") !== undefined ? { settleMs: numberOf(argv, "--settle-ms") } : {}),
+            ...(numberOf(argv, "--motion-gap-ms") !== undefined ? { motionGapMs: numberOf(argv, "--motion-gap-ms") } : {}),
+            ...(numberOf(argv, "--ready-timeout-ms") !== undefined ? { readyTimeoutMs: numberOf(argv, "--ready-timeout-ms") } : {}),
+            ...(numberOf(argv, "--timeout-ms") !== undefined ? { timeoutMs: numberOf(argv, "--timeout-ms") } : {}),
+            ...(injected?.driver ? { driver: injected.driver } : {})
+        });
+    }
+    catch (error) {
+        io.stderr(String(error.message ?? error));
+        return 2;
+    }
+    const out = valueOf(argv, "--out");
+    if (out) {
+        const file = resolve(io.cwd, out);
+        mkdirSync(dirname(file), { recursive: true });
+        writeFileSync(file, `${JSON.stringify(report, null, 2)}\n`);
+    }
+    io.stdout(argv.includes("--json") ? JSON.stringify(report, null, 2) : formatReport(report));
+    return report.ok ? 0 : 1;
+}
+//# sourceMappingURL=command.js.map

package/dist/verify/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/verify/command.ts"],"names":[],"mappings":"AAAA,uHAAuH;AACvH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAsC,MAAM,UAAU,CAAC;AAG5F,MAAM,CAAC,MAAM,YAAY,GACvB,4SAA4S;IAC5S,gFAAgF;IAChF,wEAAwE,CAAC;AAE3E,MAAM,OAAO,GAAG,CAAC,IAAuB,EAAE,IAAY,EAAsB,EAAE;IAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,OAAO,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5E,CAAC,CAAC;AACF,MAAM,QAAQ,GAAG,CAAC,KAAyB,EAAgB,EAAE,CAC3D,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;IACtE,IAAI,CAAE,iBAAuC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,aAAa,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClJ,OAAO,CAAe,CAAC;AACzB,CAAC,CAAC,CAAC;AACL,MAAM,QAAQ,GAAG,CAAC,IAAuB,EAAE,IAAY,EAAsB,EAAE;IAC7E,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,+BAA+B,CAAC,CAAC;IAC1F,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,MAAM,KAAK,GAAG,CAAC,kBAAkB,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,MAAM,CAAC,OAAO,gBAAgB,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9K,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/H,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,KAAK,EAAE,EAAE,WAAW,CAAC,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACzH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAuB,EAAE,EAA8E,EAAE,QAA2C;IACtL,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IACvG,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,EAAE,CAAC,MAAM,CAAC,UAAU,YAAY,EAAE,CAAC,CAAC;YAAC,OAAO,CAAC,CAAC;QAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,EAAE,CAAC;YAAC,EAAE,CAAC,MAAM,CAAC,iBAAiB,IAAI,sDAAsD,CAAC,CAAC;YAAC,OAAO,CAAC,CAAC;QAAC,CAAC;QACjH,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/F,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC/C,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC9G,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAE,KAAe,CAAC,OAAO,CAAC,CAAC,CAAC;QAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC5N,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACtG,IAAI,MAAoB,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,SAAS,CAAC;YACvB,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,IAAI,GAAG,CAAC;YAC9C,IAAI;YACJ,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,CAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,CAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,cAAc,CAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7F,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzF,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5F,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpG,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/G,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxH,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvG,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAE,KAAe,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC;QAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IACnF,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,IAAI,GAAG,EAAE,CAAC;QAAC,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAC3J,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5F,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC"}

package/dist/verify/frame.d.ts

@@ -0,0 +1,46 @@
+export interface RgbImage {
+    readonly width: number;
+    readonly height: number;
+    readonly rgb: Uint8Array;
+}
+export declare const FRAME_THRESHOLDS: Readonly<{
+    minTexturedBlockFraction: 0.1;
+    minP99Luma: 6;
+    minDistinctColors: 8;
+    blockStddev: 6;
+    maxGain: 8;
+    blockSize: 16;
+    /** Below this p99 luma (but above black) the frame counts as dim. */
+    dimP99Luma: 40;
+}>;
+/** Minimal PNG decoder (8-bit gray, gray+alpha, RGB, RGBA, palette; non-interlaced). Alpha is composited on black. */
+export declare function decodePng(buf: Buffer): RgbImage;
+export interface FrameAnalysis {
+    readonly width: number;
+    readonly height: number;
+    readonly meanLuma: number;
+    readonly lumaStddev: number;
+    readonly p1Luma: number;
+    readonly p99Luma: number;
+    readonly gain: number;
+    readonly distinctColors: number;
+    readonly texturedBlockFraction: number;
+    readonly drawn: boolean;
+    readonly reasons: readonly string[];
+    /** Machine-readable verdict flags derived from the same thresholds. */
+    readonly black: boolean;
+    readonly flat: boolean;
+    readonly empty: boolean;
+    readonly dim: boolean;
+}
+export declare function analyzeFrame(image: RgbImage, thresholds?: typeof FRAME_THRESHOLDS): FrameAnalysis;
+export interface MotionAnalysis {
+    /** Mean absolute per-channel difference, 0..255. */
+    readonly meanAbsDiff: number;
+    /** Share of pixels whose channels differ by more than 8. */
+    readonly changedPixelFraction: number;
+    readonly moved: boolean;
+}
+/** Two frames of the same size. `moved` needs at least 0.05% of pixels to change noticeably, which a static scene's encoder noise never reaches. */
+export declare function compareFrames(a: RgbImage, b: RgbImage, minChangedFraction?: number): MotionAnalysis;
+//# sourceMappingURL=frame.d.ts.map

package/dist/verify/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/verify/frame.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,QAAQ;IAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;CAAE;AAEvG,eAAO,MAAM,gBAAgB;;;;;;;IAO3B,qEAAqE;;EAErE,CAAC;AAKH,sHAAsH;AACtH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAqD/C;AAKD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACjI,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACxE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACjG;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,GAAE,OAAO,gBAAmC,GAAG,aAAa,CA2CnH;AAED,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,oJAAoJ;AACpJ,wBAAgB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,kBAAkB,SAAS,GAAG,cAAc,CAWnG"}

package/dist/verify/frame.js

@@ -0,0 +1,190 @@
+// Frame analysis for `aura3d verify`: a dependency-free PNG decoder, the black/flat/dim frame check and a two-frame motion check.
+// The frame check is a TypeScript port of analyzeFrame in tools/release/render-gate/analysis.mjs (same thresholds, same maths); the CLI is
+// published on its own and cannot import repo tools, so tests/unit/aura3d-cli/verify-frame.test.ts asserts the two agree on the same images.
+import { inflateSync } from "node:zlib";
+export const FRAME_THRESHOLDS = Object.freeze({
+    minTexturedBlockFraction: 0.1,
+    minP99Luma: 6,
+    minDistinctColors: 8,
+    blockStddev: 6,
+    maxGain: 8,
+    blockSize: 16,
+    /** Below this p99 luma (but above black) the frame counts as dim. */
+    dimP99Luma: 40
+});
+const SIGNATURE = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
+const CHANNELS = { 0: 1, 2: 3, 3: 1, 4: 2, 6: 4 };
+/** Minimal PNG decoder (8-bit gray, gray+alpha, RGB, RGBA, palette; non-interlaced). Alpha is composited on black. */
+export function decodePng(buf) {
+    if (buf.length < 33 || !SIGNATURE.every((b, i) => buf[i] === b))
+        throw new Error("not a PNG");
+    let pos = 8, width = 0, height = 0, depth = 0, colorType = 0, interlace = 0;
+    const idat = [];
+    let palette = null;
+    while (pos + 8 <= buf.length) {
+        const len = buf.readUInt32BE(pos);
+        const type = buf.toString("latin1", pos + 4, pos + 8);
+        const data = buf.subarray(pos + 8, pos + 8 + len);
+        if (type === "IHDR") {
+            width = data.readUInt32BE(0);
+            height = data.readUInt32BE(4);
+            depth = data[8];
+            colorType = data[9];
+            interlace = data[12];
+        }
+        else if (type === "PLTE")
+            palette = data;
+        else if (type === "IDAT")
+            idat.push(data);
+        else if (type === "IEND")
+            break;
+        pos += 12 + len;
+    }
+    if (!width || !height)
+        throw new Error("PNG without IHDR");
+    if (depth !== 8 || interlace !== 0 || !(colorType in CHANNELS))
+        throw new Error(`unsupported PNG (depth ${depth}, colour type ${colorType}, interlace ${interlace})`);
+    if (colorType === 3 && !palette)
+        throw new Error("palette PNG without PLTE");
+    const ch = CHANNELS[colorType];
+    const stride = width * ch;
+    const raw = inflateSync(Buffer.concat(idat));
+    if (raw.length < (stride + 1) * height)
+        throw new Error("truncated PNG data");
+    const out = new Uint8Array(stride * height);
+    for (let y = 0; y < height; y++) {
+        const f = raw[y * (stride + 1)];
+        const src = y * (stride + 1) + 1;
+        const dst = y * stride;
+        for (let x = 0; x < stride; x++) {
+            const a = x >= ch ? out[dst + x - ch] : 0;
+            const b = y > 0 ? out[dst - stride + x] : 0;
+            const c = x >= ch && y > 0 ? out[dst - stride + x - ch] : 0;
+            let v = raw[src + x];
+            if (f === 1)
+                v += a;
+            else if (f === 2)
+                v += b;
+            else if (f === 3)
+                v += (a + b) >> 1;
+            else if (f === 4) {
+                const p = a + b - c, pa = Math.abs(p - a), pb = Math.abs(p - b), pc = Math.abs(p - c);
+                v += pa <= pb && pa <= pc ? a : pb <= pc ? b : c;
+            }
+            else if (f !== 0)
+                throw new Error(`bad PNG filter ${f}`);
+            out[dst + x] = v & 255;
+        }
+    }
+    const rgb = new Uint8Array(width * height * 3);
+    for (let i = 0, n = width * height; i < n; i++) {
+        let r, g, b, al = 255;
+        if (colorType === 2) {
+            r = out[i * 3];
+            g = out[i * 3 + 1];
+            b = out[i * 3 + 2];
+        }
+        else if (colorType === 6) {
+            r = out[i * 4];
+            g = out[i * 4 + 1];
+            b = out[i * 4 + 2];
+            al = out[i * 4 + 3];
+        }
+        else if (colorType === 0) {
+            r = g = b = out[i];
+        }
+        else if (colorType === 4) {
+            r = g = b = out[i * 2];
+            al = out[i * 2 + 1];
+        }
+        else {
+            const p = out[i] * 3;
+            r = palette[p];
+            g = palette[p + 1];
+            b = palette[p + 2];
+        }
+        rgb[i * 3] = (r * al) / 255;
+        rgb[i * 3 + 1] = (g * al) / 255;
+        rgb[i * 3 + 2] = (b * al) / 255;
+    }
+    return { width, height, rgb };
+}
+const luma = (r, g, b) => 0.2126 * r + 0.7152 * g + 0.0722 * b;
+const round = (v, d = 2) => Math.round(v * 10 ** d) / 10 ** d;
+export function analyzeFrame(image, thresholds = FRAME_THRESHOLDS) {
+    const { width, height, rgb } = image;
+    const n = width * height;
+    const hist = new Uint32Array(256);
+    const colors = new Set();
+    const lum = new Float32Array(n);
+    let sum = 0, sumSq = 0;
+    for (let i = 0; i < n; i++) {
+        const l = luma(rgb[i * 3], rgb[i * 3 + 1], rgb[i * 3 + 2]);
+        lum[i] = l;
+        sum += l;
+        sumSq += l * l;
+        hist[Math.min(255, Math.round(l))]++;
+    }
+    const pct = (p) => { let acc = 0; const target = n * p; for (let v = 0; v < 256; v++) {
+        acc += hist[v];
+        if (acc >= target)
+            return v;
+    } return 255; };
+    const mean = sum / n;
+    const stddev = Math.sqrt(Math.max(0, sumSq / n - mean * mean));
+    const p1 = pct(0.01), p99 = pct(0.99);
+    const gain = p99 >= 96 ? 1 : Math.min(thresholds.maxGain, 160 / Math.max(p99, 1));
+    for (let i = 0; i < n; i++) {
+        const r = Math.min(255, rgb[i * 3] * gain), g = Math.min(255, rgb[i * 3 + 1] * gain), b = Math.min(255, rgb[i * 3 + 2] * gain);
+        colors.add(((r >> 4) << 8) | ((g >> 4) << 4) | (b >> 4));
+    }
+    const bs = thresholds.blockSize;
+    let blocks = 0, textured = 0;
+    for (let by = 0; by + bs <= height; by += bs) {
+        for (let bx = 0; bx + bs <= width; bx += bs) {
+            let s = 0, sq = 0;
+            for (let y = by; y < by + bs; y++)
+                for (let x = bx; x < bx + bs; x++) {
+                    const v = Math.min(255, lum[y * width + x] * gain);
+                    s += v;
+                    sq += v * v;
+                }
+            const m = s / (bs * bs), sd = Math.sqrt(Math.max(0, sq / (bs * bs) - m * m));
+            blocks++;
+            if (sd >= thresholds.blockStddev)
+                textured++;
+        }
+    }
+    const texturedBlockFraction = blocks ? textured / blocks : 0;
+    const reasons = [];
+    const black = p99 < thresholds.minP99Luma;
+    const flat = colors.size < thresholds.minDistinctColors;
+    const empty = texturedBlockFraction < thresholds.minTexturedBlockFraction;
+    if (black)
+        reasons.push(`black frame (p99 luma ${p99})`);
+    if (flat)
+        reasons.push(`flat frame (${colors.size} distinct colours)`);
+    if (empty)
+        reasons.push(`no scene texture (${(texturedBlockFraction * 100).toFixed(1)}% textured blocks)`);
+    return {
+        width, height, meanLuma: round(mean), lumaStddev: round(stddev), p1Luma: p1, p99Luma: p99, gain: round(gain),
+        distinctColors: colors.size, texturedBlockFraction: round(texturedBlockFraction, 4),
+        drawn: reasons.length === 0, reasons, black, flat, empty, dim: !black && p99 < thresholds.dimP99Luma
+    };
+}
+/** Two frames of the same size. `moved` needs at least 0.05% of pixels to change noticeably, which a static scene's encoder noise never reaches. */
+export function compareFrames(a, b, minChangedFraction = 0.0005) {
+    if (a.width !== b.width || a.height !== b.height)
+        return { meanAbsDiff: 255, changedPixelFraction: 1, moved: true };
+    const n = a.width * a.height;
+    let total = 0, changed = 0;
+    for (let i = 0; i < n; i++) {
+        const d = Math.abs(a.rgb[i * 3] - b.rgb[i * 3]) + Math.abs(a.rgb[i * 3 + 1] - b.rgb[i * 3 + 1]) + Math.abs(a.rgb[i * 3 + 2] - b.rgb[i * 3 + 2]);
+        total += d / 3;
+        if (d > 24)
+            changed++;
+    }
+    const changedPixelFraction = n ? changed / n : 0;
+    return { meanAbsDiff: round(n ? total / n : 0, 3), changedPixelFraction: round(changedPixelFraction, 5), moved: changedPixelFraction >= minChangedFraction };
+}
+//# sourceMappingURL=frame.js.map

package/dist/verify/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../src/verify/frame.ts"],"names":[],"mappings":"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"}

package/dist/verify/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./codes.js";
+export * from "./lint.js";
+export * from "./frame.js";
+export * from "./run.js";
+export { createChromeCdpDriver, findChrome, BrowserUnavailableError, type VerifyBrowserDriver, type RenderCapture, type RenderCaptureOptions } from "./cdp.js";
+export { verifyCommand, formatReport, VERIFY_USAGE } from "./command.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/verify/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/verify/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,uBAAuB,EAAE,KAAK,mBAAmB,EAAE,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAC/J,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/verify/index.js

@@ -0,0 +1,7 @@
+export * from "./codes.js";
+export * from "./lint.js";
+export * from "./frame.js";
+export * from "./run.js";
+export { createChromeCdpDriver, findChrome, BrowserUnavailableError } from "./cdp.js";
+export { verifyCommand, formatReport, VERIFY_USAGE } from "./command.js";
+//# sourceMappingURL=index.js.map

package/dist/verify/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/verify/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,uBAAuB,EAA2E,MAAM,UAAU,CAAC;AAC/J,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/verify/lint.d.ts

@@ -0,0 +1,43 @@
+export interface LintSource {
+    readonly path: string;
+    readonly text: string;
+}
+export interface LintFinding {
+    readonly code: string;
+    readonly message: string;
+    readonly location: {
+        readonly file: string;
+        readonly line: number;
+        readonly column: number;
+    };
+}
+export type LintGroup = "assets" | "scene";
+export interface LintOptions {
+    /** Which rule group to run. Default: both. */
+    readonly group?: LintGroup;
+    /** Whether a project-relative URL (e.g. `/models/a.glb`) resolves to a file in the project. Default: never. */
+    readonly fileExists?: (url: string) => boolean;
+}
+/** Names the generated GLSL prelude owns. Mirrors RESERVED_UNIFORM_NAMES in packages/engine/src/agent-api/compiler/customMaterial.ts (a parity test guards drift). */
+export declare const RESERVED_UNIFORM_NAMES: readonly string[];
+/** Keys `effects.fog` reads. Mirrors FOG_OPTION_KEYS in packages/engine/src/agent-api/nodes/effects.ts (a parity test guards drift). Anything else is OPTION_IGNORED. */
+export declare const FOG_VALID_OPTIONS: readonly string[];
+/** `instances.model` options the runtime accepts and does not apply (UNAPPLIED_INSTANCED_MODEL_OPTIONS in nodes/instances.ts; emitted as OPTION_IGNORED). */
+export declare const INSTANCES_MODEL_UNAPPLIED_OPTIONS: readonly string[];
+/**
+ * Builder option tables for LINT_EFFECT_OPTION_IGNORED. `valid`: any other key is ignored. `ignored`: these keys are ignored.
+ * `effects.particles` has no row: every defined particle option rides to lowering, so there is no list of ignored particle options to lint against
+ * (the runtime still reports any that appear, see RUNTIME_OPTION_IGNORED).
+ */
+export declare const IGNORED_OPTION_RULES: readonly {
+    readonly builder: string;
+    readonly valid?: readonly string[];
+    readonly ignored?: readonly string[];
+}[];
+/** Source files of a project: `src/` if present, else the root (config files excluded). */
+export declare function collectLintSources(projectDir: string): LintSource[];
+/** Run the lint rules over in-memory sources. Pure: no file system, no engine import. */
+export declare function lintSources(sources: readonly LintSource[], options?: LintOptions): LintFinding[];
+/** Project-level convenience: collect sources, resolve `fileExists` against `public/` and the project root. */
+export declare function lintProject(projectDir: string, options?: LintOptions): LintFinding[];
+//# sourceMappingURL=lint.d.ts.map

package/dist/verify/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/verify/lint.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,UAAU;IAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC5E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9F;AACD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAC3C,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,+GAA+G;IAC/G,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CAChD;AAED,sKAAsK;AACtK,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAKnD,CAAC;AAEF,yKAAyK;AACzK,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAI9C,CAAC;AAEF,6JAA6J;AAC7J,eAAO,MAAM,iCAAiC,EAAE,SAAS,MAAM,EAAmF,CAAC;AAEnJ;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,EAGjJ,CAAC;AAQF,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,EAAE,CAiBnE;AAqaD,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,GAAE,WAAgB,GAAG,WAAW,EAAE,CAOpG;AAED,+GAA+G;AAC/G,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,WAAW,EAAE,CAOxF"}