@aura3d/engine 4.0.2 → 4.0.4

package/dist/aura3d-cli/codemods/camera-cast.js

@@ -0,0 +1,259 @@
+/**
+ * tools/camera-cast-codemod (PRD-08 §9.3, C-39 `camera-cast`).
+ *
+ * Rewrites style-(a) camera cast-mutations —
+ *   `Object.assign(<cam> as unknown as <Mutable…>, {…})`
+ *   `(<cam> as unknown as <T>).<field> = <v>`
+ * — into C-22 `app.camera` calls, and reports style-(b) direct writes to
+ * camera-spec values (no cast) as a manual-migration list.
+ *
+ * Mapping:
+ *  - pose fields (position/target/near/far/orthographicSize/up)  → setPose (exact)
+ *  - fov → setFov, roll → setRoll                                (exact)
+ *  - spec-shape fields (offset/targetOffset/distance/mode/…)     → fromSpec merge (approximate)
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { extname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const POSE_FIELDS = new Set(["position", "target", "near", "far", "orthographicSize", "up"]);
+const CAMISH = /(?:camera|cameraSpec|cam|spec)\s*$/i;
+function lineOf(source, index) {
+    let n = 1;
+    for (let i = 0; i < index && i < source.length; i++)
+        if (source[i] === "\n")
+            n++;
+    return n;
+}
+/** Split a flat `{a: x, b: y}` literal body into top-level entries. */
+function splitProps(body) {
+    const props = [];
+    let depth = 0;
+    let cur = "";
+    for (const ch of body) {
+        if (ch === "{" || ch === "[" || ch === "(")
+            depth++;
+        if (ch === "}" || ch === "]" || ch === ")")
+            depth--;
+        if (ch === "," && depth === 0) {
+            props.push(cur);
+            cur = "";
+            continue;
+        }
+        cur += ch;
+    }
+    if (cur.trim())
+        props.push(cur);
+    return props
+        .map((p) => {
+        const m = /^\s*([A-Za-z_$][\w$]*)\s*:(.*)$/s.exec(p);
+        return m ? { key: m[1], value: m[2].trim() } : null;
+    })
+        .filter((p) => p !== null);
+}
+function literalBodyOf(src, braceOpen, braceClose) {
+    return src.slice(braceOpen + 1, braceClose);
+}
+function matching(src, openIndex, openCh, closeCh) {
+    let depth = 0;
+    for (let i = openIndex; i < src.length; i++) {
+        const ch = src[i];
+        if (ch === openCh)
+            depth++;
+        if (ch === closeCh) {
+            depth--;
+            if (depth === 0)
+                return i;
+        }
+        if ((ch === '"' || ch === "'" || ch === "`") && depth === 1) {
+            const q = ch;
+            i++;
+            while (i < src.length && src[i] !== q) {
+                if (src[i] === "\\")
+                    i++;
+                i++;
+            }
+        }
+    }
+    return -1;
+}
+export function transform(source, fileName = "<input>") {
+    const rows = [];
+    const edits = []; // applied later; positions are pre-edit
+    // ── Style (a1): Object.assign(<target> as unknown as <T>, <updates>) ──
+    // Type part is `[\w$]+` optionally generic — `<…>` may itself contain commas.
+    const objAssign = /Object\.assign\(\s*([\w$.[\]()]+?)\s+as\s+unknown\s+as\s+[\w$]+(?:<[^()]*>)?,\s*/g;
+    let m;
+    while ((m = objAssign.exec(source))) {
+        const target = m[1];
+        const argStart = m.index + m[0].length;
+        const parenClose = matching(source, m.index + "Object.assign(".length - 1, "(", ")");
+        if (parenClose < 0)
+            continue;
+        const argSrc = source.slice(argStart, parenClose);
+        // Consume a trailing `;` so replacements don't emit `;;`.
+        const stmtEnd = source[parenClose + 1] === ";" ? parenClose + 2 : parenClose + 1;
+        const trimmed = argSrc.trim();
+        const ln = lineOf(source, m.index);
+        if (trimmed.startsWith("{") && trimmed.endsWith("}")) {
+            const props = splitProps(literalBodyOf(source, argStart + argSrc.indexOf("{"), argStart + argSrc.lastIndexOf("}")));
+            const pose = props.filter((p) => POSE_FIELDS.has(p.key));
+            const fov = props.filter((p) => p.key === "fov");
+            const roll = props.filter((p) => p.key === "roll");
+            const rest = props.filter((p) => !POSE_FIELDS.has(p.key) && p.key !== "fov" && p.key !== "roll");
+            if (rest.length === 0 && (pose.length || fov.length || roll.length)) {
+                const calls = [];
+                if (pose.length)
+                    calls.push(`app.camera.setPose({ ${pose.map((p) => `${p.key}: ${p.value}`).join(", ")} });`);
+                for (const p of fov)
+                    calls.push(`app.camera.setFov(${p.value});`);
+                for (const p of roll)
+                    calls.push(`app.camera.setRoll(${p.value});`);
+                edits.push({ start: m.index, end: stmtEnd, text: calls.join("\n") });
+                rows.push({ file: fileName, line: ln, construct: `Object.assign(${target} as unknown as …)`, mapping: "exact", target: calls.join(" ") });
+            }
+            else {
+                // Mixed or spec-shape fields → merge into a rigs.fromSpec spec.
+                const text = `app.camera.use(app.camera.rigs.fromSpec({ ...${target}, ...${trimmed} }));`;
+                edits.push({ start: m.index, end: stmtEnd, text });
+                rows.push({ file: fileName, line: ln, construct: `Object.assign(${target} as unknown as …)`, mapping: "approximate", target: "app.camera.use(app.camera.rigs.fromSpec(merge))", note: `spec fields kept verbatim: ${rest.map((p) => p.key).join(", ") || "none"}` });
+            }
+        }
+        else {
+            const text = `app.camera.use(app.camera.rigs.fromSpec({ ...${target}, ...${trimmed} }));`;
+            edits.push({ start: m.index, end: stmtEnd, text });
+            rows.push({ file: fileName, line: ln, construct: `Object.assign(${target} as unknown as …, ${trimmed.slice(0, 40)})`, mapping: "approximate", target: "app.camera.use(app.camera.rigs.fromSpec(merge))", note: "dynamic updates merged into a spec" });
+        }
+    }
+    // ── Style (a2): (<x> as unknown as <T>).<field> = <v> ──
+    const castWrite = /\(\s*([\w$.[\]()]+?)\s+as\s+unknown\s+as\s+[\w$]+(?:<[^()]*>)?\)\s*\.\s*([A-Za-z_$][\w$]*)\s*=\s*/g;
+    while ((m = castWrite.exec(source))) {
+        const [, target, field] = m;
+        const ln = lineOf(source, m.index);
+        if (!CAMISH.test(target))
+            continue;
+        const stmtIdx = source.indexOf(";", m.index + m[0].length);
+        const value = stmtIdx > 0 ? source.slice(m.index + m[0].length, stmtIdx).trim() : "<expr>";
+        let text;
+        let mapping = "exact";
+        if (field === "fov")
+            text = `app.camera.setFov(${value});`;
+        else if (field === "roll")
+            text = `app.camera.setRoll(${value});`;
+        else if (POSE_FIELDS.has(field))
+            text = `app.camera.setPose({ ${field}: ${value} });`;
+        else {
+            text = `app.camera.use(app.camera.rigs.fromSpec({ ...${target}, ${field}: ${value} }));`;
+            mapping = "approximate";
+        }
+        const end = stmtIdx > 0 ? stmtIdx + 1 : m.index + m[0].length;
+        edits.push({ start: m.index, end, text });
+        rows.push({ file: fileName, line: ln, construct: `(${target} as …).${field} = …`, mapping, target: text });
+    }
+    // ── Style (b): <camish>.<camera field> = <v> — no cast → manual list ──
+    const directWrite = /\b([A-Za-z_$][\w$]*(?:\.[\w$]+)*)\.((?:position|target|offset|targetOffset|fov|near|far|distance|targetNode|smoothing|offsetMode|mode|orthographicSize|roll))\s*=\s*/g;
+    while ((m = directWrite.exec(source))) {
+        const [full, base] = [m[0], m[1]];
+        if (!CAMISH.test(base))
+            continue;
+        // Skip writes already covered by a cast edit above.
+        if (edits.some((e) => m.index >= e.start && m.index <= e.end))
+            continue;
+        rows.push({ file: fileName, line: lineOf(source, m.index), construct: `${full}…`, mapping: "none", note: "direct write to camera-spec value — migrate to app.camera.setPose/setFov or rigs.fromSpec (style b)" });
+    }
+    // Apply edits right-to-left.
+    const parts = [];
+    let last = source.length;
+    for (const e of [...edits].sort((a, b) => b.start - a.start)) {
+        parts.unshift(source.slice(e.end, last));
+        parts.unshift(e.text);
+        last = e.start;
+    }
+    parts.unshift(source.slice(0, last));
+    return { code: parts.join(""), rows };
+}
+// ── C-39 `camera-cast` codemod descriptor ──
+export const cameraCastCodemod = {
+    name: "camera-cast",
+    owner: "prd08",
+    description: "Camera spec cast-mutations → app.camera (C-22); reports direct spec writes.",
+    transform
+};
+// ── C-39 doctor rule `feel/evidence-only` ──
+export const feelEvidenceOnlyRule = {
+    code: "feel/evidence-only",
+    owner: "prd08",
+    check(file) {
+        const rows = [];
+        const src = file.text;
+        const gated = /(capture|evidence|VISUAL_CAPTURE|screenshot|diagnostic)/i;
+        let m;
+        const gateRe = /if\s*\(([^)]{0,160})\)\s*\{[^}]{0,900}?\b(shake|punch|fovKick|trauma|hitStop)\b/g;
+        while ((m = gateRe.exec(src))) {
+            if (!gated.test(m[1]))
+                continue;
+            rows.push({ line: lineOf(src, m.index), severity: "warning", message: "feel call gated behind a capture/evidence branch — feel must reach pixels every frame, not only during captures (PRD-08 §9.5)" });
+        }
+        if (/\b(shake|trauma|punch|juice)\b/.test(src)) {
+            const rndRe = /Math\.random\(\)/g;
+            while ((m = rndRe.exec(src))) {
+                rows.push({ line: lineOf(src, m.index), severity: "error", message: "Math.random() in a file applying camera feel — use seeded feel/Noise (determinism, repo rule)" });
+            }
+        }
+        const castRe = /as\s+unknown\s+as\s+[\w<>[\], ]+?\s*[),]\s*[^)]*?(position|target|fov|offset)\s*=/g;
+        while ((m = castRe.exec(src))) {
+            rows.push({ line: lineOf(src, m.index), severity: "warning", message: "camera cast-mutation — run `aura3d codemod camera-cast --write` (C-22)" });
+        }
+        return rows;
+    }
+};
+// ── CLI (`node tools/camera-cast-codemod/index.mjs <paths> [--report|--write|--dry-run]`) ──
+function collectFiles(paths, acc = []) {
+    for (const p of paths) {
+        if (!existsSync(p))
+            continue;
+        const st = statSync(p);
+        if (st.isDirectory()) {
+            for (const name of readdirSync(p)) {
+                if (name === "node_modules" || name.startsWith("."))
+                    continue;
+                collectFiles([join(p, name)], acc);
+            }
+        }
+        else if (extname(p) === ".ts" || extname(p) === ".tsx") {
+            acc.push(p);
+        }
+    }
+    return acc;
+}
+export function reportRows(allRows) {
+    const lines = ["# camera-cast report", ""];
+    for (const r of allRows) {
+        lines.push(`- ${r.file}:${r.line} — ${r.construct} → ${r.mapping}${r.target ? ` (${r.target})` : ""}${r.note ? ` — ${r.note}` : ""}`);
+    }
+    lines.push("");
+    lines.push(`${allRows.length} construct(s): ${allRows.filter((r) => r.mapping === "exact").length} exact, ${allRows.filter((r) => r.mapping === "approximate").length} approximate, ${allRows.filter((r) => r.mapping === "none").length} manual`);
+    return lines.join("\n");
+}
+export function main(argv = process.argv.slice(2)) {
+    const args = [...argv];
+    const write = args.includes("--write");
+    const dryRun = args.includes("--dry-run");
+    const inputs = args.filter((a) => !a.startsWith("--"));
+    if (!inputs.length) {
+        console.error("usage: index.mjs <dir-or-file>… [--report|--write|--dry-run]");
+        return 2;
+    }
+    const allRows = [];
+    for (const file of collectFiles(inputs)) {
+        const src = readFileSync(file, "utf8");
+        const { code, rows } = transform(src, file);
+        allRows.push(...rows);
+        if (write && code !== src)
+            writeFileSync(file, code);
+        if (dryRun && code !== src)
+            console.log(`--- ${file} would change`);
+    }
+    console.log(reportRows(allRows));
+    return 0;
+}
+//# sourceMappingURL=camera-cast.js.map

package/dist/aura3d-cli/codemods/camera-cast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-cast.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/codemods/camera-cast.ts"],"names":[],"mappings":"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"}

package/dist/aura3d-cli/codemods/core-v2.d.ts

@@ -0,0 +1,55 @@
+/**
+ * C-39 codemod `core-v2` (PRD-01 §11 item 4, §15 Phase 2).
+ * Pure `source → code + rows` transform — no fs access; the C-39 registry
+ * (`packages/aura3d-cli/src/commands/prd01/index.ts`) drives file IO.
+ *
+ * Rules:
+ *  - `pixelRatio:` overrides inside `createAuraApp(...)` options (top level or
+ *    inside a `...(cond ? {...} : {})` spread): `Math.min(<cap>, <dpr>)` and the
+ *    literal `1` map to `renderer.resolution.maxPixelRatio`; any other value
+ *    maps to `renderer.resolution.pixelRatio` (same semantics, new surface).
+ *  - `qualityProfile:` inside `renderer:` options → `quality:` tier
+ *    (`"production"` → `"high"`, `"safe-basic"` → `"low"`; unknown values keep
+ *    the expression and are reported `approximate`).
+ *  - `safe-basic` mentions are classified (mode-select / fallback-warning
+ *    assertion / documentation) and reported for the inventory — not edited.
+ *  - `lights.ambient({intensity})` sites are reported with old vs physical
+ *    effective irradiance (÷π) for lane 14's retune — not edited.
+ */
+export interface CodemodRow {
+    readonly file: string;
+    readonly line: number;
+    readonly construct: string;
+    readonly mapping: "exact" | "approximate" | "none";
+    readonly target?: string;
+    readonly note?: string;
+}
+export interface CodemodResult {
+    readonly code: string;
+    readonly rows: readonly CodemodRow[];
+}
+/** Match a `(`/`{`/`[` opening at `open`, skipping strings and comments. */
+export declare function matchDelimited(src: string, open: number): number;
+export declare function transformCoreV2(source: string, fileName: string): CodemodResult;
+export interface SafeBasicInventoryEntry {
+    readonly file: string;
+    readonly line: number;
+    readonly construct: string;
+    readonly classification: string;
+}
+export declare function collectSafeBasicInventory(files: readonly {
+    path: string;
+    text: string;
+}[]): readonly SafeBasicInventoryEntry[];
+export interface AmbientReviewEntry {
+    readonly file: string;
+    readonly line: number;
+    readonly intensity?: number;
+    readonly effectiveIrradianceBefore?: number;
+    readonly effectiveIrradianceAfter?: number;
+}
+export declare function collectAmbientReview(files: readonly {
+    path: string;
+    text: string;
+}[]): readonly AmbientReviewEntry[];
+//# sourceMappingURL=core-v2.d.ts.map

package/dist/aura3d-cli/codemods/core-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-v2.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/codemods/core-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,CAAC;CACtC;AAUD,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAuBhE;AAqED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CA8I/E;AAMD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,SAAS,uBAAuB,EAAE,CAQ9H;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;CAC5C;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,SAAS,kBAAkB,EAAE,CAmBpH"}