@aura3d/cli 3.0.1 → 4.0.2

package/dist/migrate-three/ImportMap.js

@@ -0,0 +1,35 @@
+/* Moved verbatim from packages/three-compat/src/migration (PRD-15 T6.2); emitted import targets updated from the deleted @aura3d/three-compat package to @aura3d/engine. */
+export const THREE_COMPAT_THREE_IMPORT_MAP = {
+    three: "@aura3d/engine",
+    "three/addons/controls/OrbitControls.js": "@aura3d/engine",
+    "three/examples/jsm/controls/OrbitControls.js": "@aura3d/engine",
+    "three/addons/loaders/GLTFLoader.js": "@aura3d/engine",
+    "three/examples/jsm/loaders/GLTFLoader.js": "@aura3d/engine"
+};
+/**
+ * Three.js import specifiers this package deliberately does NOT rewrite.
+ *
+ * WS-3.4 deleted the threejs-compatibility postprocess tree because its passes
+ * reported success without touching a GPU. The remaining production passes
+ * (packages/rendering/src/production-runtime/postprocess) operate on CPU
+ * Uint8Array pixel buffers, not on GPU render targets, so they are not a
+ * behavioural substitute for Three.js EffectComposer. Aliasing the subpath to
+ * them would convert working Three.js code into non-working Aura3D code and
+ * report success — the exact failure WS-3.4 removed.
+ *
+ * Per R7, a migration surface must not preserve broken semantics to claim
+ * coverage. These specifiers are reported as unsupported and left untouched so
+ * the developer sees a real compile error at the import site rather than a
+ * silent behavioural regression at runtime.
+ */
+export const THREE_COMPAT_UNSUPPORTED_THREE_IMPORTS = [
+    "three/addons/postprocessing/EffectComposer.js",
+    "three/examples/jsm/postprocessing/EffectComposer.js",
+    "three/addons/postprocessing/RenderPass.js",
+    "three/examples/jsm/postprocessing/RenderPass.js",
+    "three/addons/postprocessing/UnrealBloomPass.js",
+    "three/examples/jsm/postprocessing/UnrealBloomPass.js",
+    "three/addons/postprocessing/ShaderPass.js",
+    "three/examples/jsm/postprocessing/ShaderPass.js"
+];
+//# sourceMappingURL=ImportMap.js.map

package/dist/migrate-three/ImportMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImportMap.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/ImportMap.ts"],"names":[],"mappings":"AAAA,4KAA4K;AAC5K,MAAM,CAAC,MAAM,6BAA6B,GAAqC;IAC7E,KAAK,EAAE,gBAAgB;IACvB,wCAAwC,EAAE,gBAAgB;IAC1D,8CAA8C,EAAE,gBAAgB;IAChE,oCAAoC,EAAE,gBAAgB;IACtD,0CAA0C,EAAE,gBAAgB;CAC7D,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAsB;IACvE,+CAA+C;IAC/C,qDAAqD;IACrD,2CAA2C;IAC3C,iDAAiD;IACjD,gDAAgD;IAChD,sDAAsD;IACtD,2CAA2C;IAC3C,iDAAiD;CAClD,CAAC"}

package/dist/migrate-three/R3fMigration.d.ts

@@ -0,0 +1,32 @@
+import type { ThreeCompatCompatibilityWarning } from "./CompatibilityWarnings.js";
+/**
+ * R3F + CSS2D/CSS3D migration notes (muse3jsparity-PRD V1.4 + N4.3).
+ *
+ * Two explicit non-parity positions, documented where importers look:
+ *
+ * 1. No "R3F parity" claim. The covered-path mapping table lives in
+ *    `@aura3d/react` (`R3F_TO_AURA_MIGRATION_TABLE`: Canvas, Model, Lights,
+ *    Camera, Effect plus `useAuraFrame` / `useAuraApp` / suspense / events /
+ *    the three drei recipes). This lab detects R3F/drei source and points at
+ *    that table instead of rewriting imports it cannot honor.
+ * 2. No `CSS2DRenderer` / `CSS3DRenderer` parity (explicit 2.1 decision).
+ *    `CSS2D_CSS3D_MANUAL_MAP` gives the manual mapping per renderer.
+ */
+/** Where the R3F mapping table lives. A pointer, not a copy — one source of truth. */
+export declare const R3F_MIGRATION_TABLE_POINTER: string;
+export interface Css2DCss3DManualMapping {
+    readonly three: "CSS2DRenderer" | "CSS3DRenderer";
+    readonly aura: string;
+    readonly steps: readonly string[];
+}
+/**
+ * Manual CSS2D/3D mapping for importers (N4 task 3).
+ *
+ * CSS2D annotations map onto world-anchored labels. CSS3D has no Aura
+ * equivalent — in-plane 3D text maps onto G1 SDF text, and anything beyond
+ * that keeps its CSS3DRenderer alongside the canvas (it is DOM; it composes).
+ */
+export declare const CSS2D_CSS3D_MANUAL_MAP: readonly Css2DCss3DManualMapping[];
+/** Source-level R3F/drei/CSS2D/CSS3D detection for the migration lab. */
+export declare function createR3fMigrationWarnings(source: string): readonly ThreeCompatCompatibilityWarning[];
+//# sourceMappingURL=R3fMigration.d.ts.map

package/dist/migrate-three/R3fMigration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"R3fMigration.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/R3fMigration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAE/E;;;;;;;;;;;;GAYG;AAEH,sFAAsF;AACtF,eAAO,MAAM,2BAA2B,QAEyB,CAAC;AAElE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,uBAAuB,EAmBpE,CAAC;AAyBF,yEAAyE;AACzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,+BAA+B,EAAE,CAErG"}

package/dist/migrate-three/R3fMigration.js

@@ -0,0 +1,70 @@
+/**
+ * R3F + CSS2D/CSS3D migration notes (muse3jsparity-PRD V1.4 + N4.3).
+ *
+ * Two explicit non-parity positions, documented where importers look:
+ *
+ * 1. No "R3F parity" claim. The covered-path mapping table lives in
+ *    `@aura3d/react` (`R3F_TO_AURA_MIGRATION_TABLE`: Canvas, Model, Lights,
+ *    Camera, Effect plus `useAuraFrame` / `useAuraApp` / suspense / events /
+ *    the three drei recipes). This lab detects R3F/drei source and points at
+ *    that table instead of rewriting imports it cannot honor.
+ * 2. No `CSS2DRenderer` / `CSS3DRenderer` parity (explicit 2.1 decision).
+ *    `CSS2D_CSS3D_MANUAL_MAP` gives the manual mapping per renderer.
+ */
+/** Where the R3F mapping table lives. A pointer, not a copy — one source of truth. */
+export const R3F_MIGRATION_TABLE_POINTER = "@aura3d/react exports R3F_TO_AURA_MIGRATION_TABLE (AuraCanvas components plus useAuraFrame/useAuraApp/suspense/events/drei recipes). " +
+    "That table maps covered paths; it is not an R3F-parity claim.";
+/**
+ * Manual CSS2D/3D mapping for importers (N4 task 3).
+ *
+ * CSS2D annotations map onto world-anchored labels. CSS3D has no Aura
+ * equivalent — in-plane 3D text maps onto G1 SDF text, and anything beyond
+ * that keeps its CSS3DRenderer alongside the canvas (it is DOM; it composes).
+ */
+export const CSS2D_CSS3D_MANUAL_MAP = [
+    {
+        three: "CSS2DRenderer",
+        aura: "labels.* world-anchored screen-space labels",
+        steps: [
+            "Replace each CSS2DObject with labels.billboard() or labels.anchor() at the same world position.",
+            "Map CSS2DObject.visible = false to offscreenPolicy: \"hide\" (default is \"clamp\").",
+            "Occlusion dimming is on by default (occlusionAware); set occlusionAware: false to keep the old always-on-top CSS behavior."
+        ]
+    },
+    {
+        three: "CSS3DRenderer",
+        aura: "no equivalent — G1 SDF text for in-plane text, otherwise keep CSS3DRenderer",
+        steps: [
+            "For text rendered in a 3D plane, use G1 SDF text (packages/rendering/src/SdfText.ts) with the uppercase alphanumeric catalog.",
+            "For annotations, use labels.* world-anchored labels instead.",
+            "Anything beyond those two keeps its CSS3DRenderer element alongside the AuraCanvas; it is DOM and composes without a migration."
+        ]
+    }
+];
+const R3F_SOURCE_MARKERS = [
+    {
+        marker: "@react-three/fiber",
+        code: "r3f-manual",
+        message: `R3F imports are not rewritten. Map them manually with ${R3F_MIGRATION_TABLE_POINTER}`
+    },
+    {
+        marker: "@react-three/drei",
+        code: "drei-manual",
+        message: `drei imports are not rewritten. The three covered patterns are cameraControlsRecipe, environmentPresetRecipe, and transformGizmoRecipe in @aura3d/react; everything else stays on drei. ${R3F_MIGRATION_TABLE_POINTER}`
+    },
+    {
+        marker: "CSS2DRenderer",
+        code: "css2d-manual",
+        message: `CSS2DRenderer has no Aura parity target by explicit 2.1 decision. ${CSS2D_CSS3D_MANUAL_MAP[0]?.steps.join(" ") ?? ""}`
+    },
+    {
+        marker: "CSS3DRenderer",
+        code: "css3d-manual",
+        message: `CSS3DRenderer has no Aura parity target by explicit 2.1 decision. ${CSS2D_CSS3D_MANUAL_MAP[1]?.steps.join(" ") ?? ""}`
+    }
+];
+/** Source-level R3F/drei/CSS2D/CSS3D detection for the migration lab. */
+export function createR3fMigrationWarnings(source) {
+    return R3F_SOURCE_MARKERS.filter(({ marker }) => source.includes(marker)).map(({ code, message }) => ({ code, message }));
+}
+//# sourceMappingURL=R3fMigration.js.map

package/dist/migrate-three/R3fMigration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"R3fMigration.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/R3fMigration.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,sFAAsF;AACtF,MAAM,CAAC,MAAM,2BAA2B,GACtC,uIAAuI;IACvI,+DAA+D,CAAC;AAQlE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAuC;IACxE;QACE,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,6CAA6C;QACnD,KAAK,EAAE;YACL,iGAAiG;YACjG,sFAAsF;YACtF,4HAA4H;SAC7H;KACF;IACD;QACE,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,6EAA6E;QACnF,KAAK,EAAE;YACL,+HAA+H;YAC/H,8DAA8D;YAC9D,iIAAiI;SAClI;KACF;CACF,CAAC;AAEF,MAAM,kBAAkB,GAA4F;IAClH;QACE,MAAM,EAAE,oBAAoB;QAC5B,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,yDAAyD,2BAA2B,EAAE;KAChG;IACD;QACE,MAAM,EAAE,mBAAmB;QAC3B,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,2LAA2L,2BAA2B,EAAE;KAClO;IACD;QACE,MAAM,EAAE,eAAe;QACvB,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,qEAAqE,sBAAsB,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE;KACjI;IACD;QACE,MAAM,EAAE,eAAe;QACvB,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,qEAAqE,sBAAsB,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE;KACjI;CACF,CAAC;AAEF,yEAAyE;AACzE,MAAM,UAAU,0BAA0B,CAAC,MAAc;IACvD,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AAC5H,CAAC"}

package/dist/migrate-three/ThreeToA3DAdapter.d.ts

@@ -0,0 +1,8 @@
+import { createThreeCompatCompatibilityWarnings } from "./CompatibilityWarnings.js";
+export interface ThreeCompatMigrationResult {
+    readonly code: string;
+    readonly rewrittenImports: number;
+    readonly warnings: ReturnType<typeof createThreeCompatCompatibilityWarnings>;
+}
+export declare function migrateThreeToA3D(source: string): ThreeCompatMigrationResult;
+//# sourceMappingURL=ThreeToA3DAdapter.d.ts.map

package/dist/migrate-three/ThreeToA3DAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreeToA3DAdapter.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/ThreeToA3DAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sCAAsC,EAAE,MAAM,yBAAyB,CAAC;AAEjF,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,sCAAsC,CAAC,CAAC;CAC9E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,0BAA0B,CAe5E"}

package/dist/migrate-three/ThreeToA3DAdapter.js

@@ -0,0 +1,20 @@
+import { THREE_COMPAT_THREE_IMPORT_MAP } from "./ImportMap.js";
+import { createThreeCompatCompatibilityWarnings } from "./CompatibilityWarnings.js";
+export function migrateThreeToA3D(source) {
+    let code = source;
+    let rewrittenImports = 0;
+    for (const [from, to] of Object.entries(THREE_COMPAT_THREE_IMPORT_MAP)) {
+        const before = code;
+        code = code.replaceAll(`from "${from}"`, `from "${to}"`).replaceAll(`from '${from}'`, `from '${to}'`);
+        if (code !== before)
+            rewrittenImports += 1;
+    }
+    code = code.replaceAll("new THREE.WebGLRenderer", "createThreeCompatRenderer");
+    code = code.replaceAll("renderer.setSize", "renderer.resize");
+    return {
+        code,
+        rewrittenImports,
+        warnings: createThreeCompatCompatibilityWarnings(source)
+    };
+}
+//# sourceMappingURL=ThreeToA3DAdapter.js.map

package/dist/migrate-three/ThreeToA3DAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreeToA3DAdapter.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/ThreeToA3DAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,sCAAsC,EAAE,MAAM,yBAAyB,CAAC;AAQjF,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,IAAI,IAAI,GAAG,MAAM,CAAC;IAClB,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,6BAA6B,CAAC,EAAE,CAAC;QACvE,MAAM,MAAM,GAAG,IAAI,CAAC;QACpB,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QACtG,IAAI,IAAI,KAAK,MAAM;YAAE,gBAAgB,IAAI,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,yBAAyB,EAAE,2BAA2B,CAAC,CAAC;IAC/E,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;IAC9D,OAAO;QACL,IAAI;QACJ,gBAAgB;QAChB,QAAQ,EAAE,sCAAsC,CAAC,MAAM,CAAC;KACzD,CAAC;AACJ,CAAC"}

package/dist/migrate-three/emit.d.ts

@@ -0,0 +1,21 @@
+/**
+ * PRD-15 T6.1 — emitter for `aura3d migrate three`.
+ *
+ * Rewrites `from "three"` imports to the engine imports the emitted calls
+ * need, replaces each mapped `new THREE.X(...)` with its factory call, and
+ * inserts `// TODO(a3d-migrate)` comments above every unmapped construct so
+ * the output fails noisily instead of silently producing wrong code.
+ */
+export interface MigrateRow {
+    readonly construct: string;
+    readonly line: number;
+    readonly mapping: "exact" | "approximate" | "none";
+    readonly note: string;
+}
+export interface MigrateResult {
+    readonly code: string;
+    readonly rows: readonly MigrateRow[];
+    readonly rewrittenConstructs: number;
+}
+export declare function emitMigratedSource(source: string): MigrateResult;
+//# sourceMappingURL=emit.d.ts.map

package/dist/migrate-three/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/emit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,CAAC;IACrC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAyEhE"}

package/dist/migrate-three/emit.js

@@ -0,0 +1,117 @@
+/**
+ * PRD-15 T6.1 — emitter for `aura3d migrate three`.
+ *
+ * Rewrites `from "three"` imports to the engine imports the emitted calls
+ * need, replaces each mapped `new THREE.X(...)` with its factory call, and
+ * inserts `// TODO(a3d-migrate)` comments above every unmapped construct so
+ * the output fails noisily instead of silently producing wrong code.
+ */
+import { threeMappingFor } from "./mappings.js";
+import { parseThreeSource } from "./parse.js";
+const UNSAFE_BARE_NAME = /^(?:Error|Map|Set|Promise|RegExp|Date|Number|String|Boolean|Array|Object)$/;
+export function emitMigratedSource(source) {
+    const constructs = parseThreeSource(source);
+    const rows = [];
+    const neededImports = new Set();
+    const comments = new Map();
+    const rewrites = [];
+    let rewritten = 0;
+    for (const c of constructs) {
+        if (c.construct === "import")
+            continue; // handled at the end
+        if (c.specifier === "bare" && UNSAFE_BARE_NAME.test(c.construct))
+            continue;
+        const mapping = threeMappingFor(c.construct);
+        if (c.specifier === "bare" && !mapping)
+            continue; // not a THREE name — don't report local ctors
+        const row = rowFor(c, mapping);
+        rows.push(row);
+        if (mapping && mapping.mapping !== "none") {
+            rewritten++;
+            if (mapping.engineImport)
+                neededImports.add(mapping.engineImport);
+            if (c.construct.endsWith(".load")) {
+                // loader `.load(` calls get a comment, not a rewrite (the model() call needs a typed asset key)
+                pushComment(comments, c.line, `// TODO(a3d-migrate): ${c.construct} → ${mapping.target} — ${mapping.note}`);
+            }
+            else {
+                const replacement = emitCall(mapping, c);
+                const needle = `new THREE.${c.construct}(${c.args})`;
+                const needleBare = `new ${c.construct}(${c.args})`;
+                if (source.includes(needle)) {
+                    rewrites.push({ match: needle, replacement });
+                }
+                else if (source.includes(needleBare)) {
+                    rewrites.push({ match: needleBare, replacement });
+                }
+            }
+        }
+        else {
+            pushComment(comments, c.line, `// TODO(a3d-migrate): no mapping for ${c.construct} — ${row.note}`);
+        }
+    }
+    let code = source;
+    for (const { match, replacement } of rewrites) {
+        code = code.replaceAll(match, replacement);
+    }
+    // rewrite three imports
+    const importNames = [...neededImports].sort();
+    if (importNames.length > 0) {
+        let importWritten = false;
+        for (const c of constructs.filter((x) => x.construct === "import")) {
+            const spec = c.specifier ?? "";
+            if (spec === "three" || spec === "three/src/three.module.js") {
+                if (!importWritten) {
+                    code = code.replace(/from\s+["']three["']/, `from "@aura3d/engine"`);
+                    code = code.replace(/import\s+(?:\*\s+as\s+THREE|\{[^}]*\})\s+from\s+["']@aura3d\/engine["']/, `import { ${importNames.join(", ")} } from "@aura3d/engine"`);
+                    importWritten = true;
+                }
+            }
+            else {
+                // three/addons/* specifier → TODO comment; the construct rows cover the rewrite
+                pushComment(comments, c.line, `// TODO(a3d-migrate): import specifier "${spec}" has no public Aura3D equivalent — resolve manually`);
+                rows.push({ construct: `import "${spec}"`, line: c.line, mapping: "none", note: "three/addons specifier is not rewritten; resolve the named export against @aura3d/engine manually." });
+            }
+        }
+    }
+    // splice comments (bottom-up so line numbers stay valid)
+    const codeLines = code.split("\n");
+    for (const [line, texts] of [...comments.entries()].sort((a, b) => b[0] - a[0])) {
+        const at = Math.min(line, codeLines.length);
+        codeLines.splice(Math.max(0, at - 1), 0, ...texts);
+    }
+    code = codeLines.join("\n");
+    rows.sort((a, b) => a.line - b.line);
+    return { code, rows, rewrittenConstructs: rewritten };
+}
+function rowFor(c, mapping) {
+    if (!mapping) {
+        return { construct: c.construct, line: c.line, mapping: "none", note: "no Aura3D equivalent in the T6.1 table; resolve manually." };
+    }
+    return { construct: c.construct, line: c.line, mapping: mapping.mapping, note: `${mapping.target} — ${mapping.note}` };
+}
+function emitCall(mapping, c) {
+    const args = c.args;
+    const todo = ` /* TODO(a3d-migrate): ${c.construct} — ${args ? `map args (${args}); ` : ""}${mapping.note} */`;
+    switch (mapping.construct) {
+        case "Euler": {
+            // Euler emits a tuple literal, valid as an expression.
+            const xyz = /,\s*['"]?XYZ['"]?\s*$/.test(args)
+                ? args.replace(/,\s*['"]?XYZ['"]?\s*$/, "").trim()
+                : args;
+            return `[${xyz}]${args && xyz !== args ? "" : todo}`;
+        }
+        case "Vector3":
+            return `[${args}]${todo}`;
+        case "Color":
+            return `(${args}) /* a3d: ${mapping.target} */`;
+        default:
+            return `${mapping.target}()${todo}`;
+    }
+}
+function pushComment(map, line, text) {
+    const list = map.get(line) ?? [];
+    list.push(text);
+    map.set(line, list);
+}
+//# sourceMappingURL=emit.js.map

package/dist/migrate-three/emit.js.map

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

package/dist/migrate-three/mappings.d.ts

@@ -0,0 +1,21 @@
+/**
+ * PRD-15 T6.1 — the Three.js → @aura3d/engine mapping table.
+ *
+ * Each entry covers one construct the migrator rewrites. "exact" means the
+ * target factory is a drop-in; "approximate" means semantics survive but
+ * options or framing differ; "none" rows are reported with a TODO comment
+ * and no rewrite.
+ */
+export interface ThreeMapping {
+    /** Construct key as produced by parse (e.g. "BoxGeometry", "GLTFLoader.load"). */
+    readonly construct: string;
+    /** Aura3D factory the construct maps to ("" for none). */
+    readonly target: string;
+    /** Engine namespace member the emitted code imports (for the rewritten import line). */
+    readonly engineImport?: string;
+    readonly mapping: "exact" | "approximate" | "none";
+    readonly note: string;
+}
+export declare const THREE_TO_A3D_MAPPINGS: readonly ThreeMapping[];
+export declare function threeMappingFor(construct: string): ThreeMapping | undefined;
+//# sourceMappingURL=mappings.d.ts.map

package/dist/migrate-three/mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/mappings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wFAAwF;IACxF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,qBAAqB,EAAE,SAAS,YAAY,EA4BxD,CAAC;AAIF,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE3E"}

package/dist/migrate-three/mappings.js

@@ -0,0 +1,42 @@
+/**
+ * PRD-15 T6.1 — the Three.js → @aura3d/engine mapping table.
+ *
+ * Each entry covers one construct the migrator rewrites. "exact" means the
+ * target factory is a drop-in; "approximate" means semantics survive but
+ * options or framing differ; "none" rows are reported with a TODO comment
+ * and no rewrite.
+ */
+export const THREE_TO_A3D_MAPPINGS = [
+    { construct: "Scene", target: "scene", engineImport: "scene", mapping: "approximate", note: "THREE.Scene graph root maps to scene({ nodes }); node add/remove calls migrate to nodes[] entries." },
+    { construct: "PerspectiveCamera", target: "camera.perspective", engineImport: "camera", mapping: "approximate", note: "fov maps 1:1; position/target move into camera spec options instead of set/lookAt calls." },
+    { construct: "Mesh", target: "primitives", engineImport: "primitives", note: "Mesh is not a standalone object: emit the matching primitives.* or model() node and carry material over.", mapping: "approximate" },
+    { construct: "BoxGeometry", target: "primitives.box", engineImport: "primitives", mapping: "approximate", note: "width/height/depth args map to a primitives.box size option; generated call keeps args in a TODO comment." },
+    { construct: "SphereGeometry", target: "primitives.sphere", engineImport: "primitives", mapping: "approximate", note: "radius/segments args map to primitives.sphere options; generated call keeps args in a TODO comment." },
+    { construct: "CylinderGeometry", target: "primitives.cylinder", engineImport: "primitives", mapping: "approximate", note: "radius/height args map to primitives.cylinder options; generated call keeps args in a TODO comment." },
+    { construct: "PlaneGeometry", target: "primitives.plane", engineImport: "primitives", mapping: "approximate", note: "width/height args map to primitives.plane options; generated call keeps args in a TODO comment." },
+    { construct: "TorusGeometry", target: "primitives.torus", engineImport: "primitives", mapping: "approximate", note: "radius/tube args map to primitives.torus options; generated call keeps args in a TODO comment." },
+    { construct: "MeshStandardMaterial", target: "material.pbr", engineImport: "material", mapping: "approximate", note: "color/metalness/roughness map to material.pbr options; envMapIntensity semantics differ." },
+    { construct: "MeshPhysicalMaterial", target: "material.physical", engineImport: "material", mapping: "approximate", note: "clearcoat, transmission and sheen survive as material.physical options (engine material-physical layer bounds them)." },
+    { construct: "DirectionalLight", target: "lights.directional", engineImport: "lights", mapping: "approximate", note: "color/intensity map; position becomes a spec option and shadow becomes a boolean flag." },
+    { construct: "PointLight", target: "lights.point", engineImport: "lights", mapping: "approximate", note: "color/intensity/distance map to lights.point options." },
+    { construct: "SpotLight", target: "lights.spot", engineImport: "lights", mapping: "approximate", note: "angle/penumbra/decay/distance map to lights.spot options." },
+    { construct: "AmbientLight", target: "lights.ambient", engineImport: "lights", mapping: "approximate", note: "color/intensity map to lights.ambient options." },
+    { construct: "HemisphereLight", target: "lights.ambient", engineImport: "lights", mapping: "approximate", note: "sky/ground two-tone shading approximates to ambient until the lights.hemisphere contract lands; keep the pair of tints in the TODO comment." },
+    { construct: "GLTFLoader", target: "", mapping: "none", note: "loader objects disappear — the load call becomes model(assets.<typedKey>); see the .load row." },
+    { construct: "GLTFLoader.load", target: "model", engineImport: "model", mapping: "approximate", note: "loader.load(url) becomes model(assets.<typedKey>) — register the GLB via `aura3d assets add` and reference the generated asset key." },
+    { construct: "RGBELoader", target: "", mapping: "none", note: "loader objects disappear — RGBELoader+PMREMGenerator collapses into environments.hdri; see the .load row." },
+    { construct: "RGBELoader.load", target: "environments.hdri", engineImport: "environments", mapping: "approximate", note: "RGBELoader + PMREMGenerator collapses into environments.hdri({ texture: assets.<hdrKey> }); register the .hdr via `aura3d assets add`." },
+    { construct: "OrbitControls", target: "camera.orbit", engineImport: "camera", mapping: "approximate", note: "OrbitControls target/damping maps to camera.orbit({ target, distance, fov }); per-frame input comes from the runtime, not listeners." },
+    { construct: "InstancedMesh", target: "instances.box", engineImport: "instances", mapping: "approximate", note: "InstancedMesh maps to instances.<shape>({ transforms: [...] }); pick the instances factory matching the underlying geometry." },
+    { construct: "Euler", target: "rotation", mapping: "approximate", note: "Euler('XYZ') order maps to rotation: [x, y, z] on the node builder; non-XYZ orders need quaternion composition — flagged in TODO." },
+    { construct: "WebGLRenderer", target: "createAuraApp", engineImport: "createAuraApp", mapping: "approximate", note: "WebGLRenderer + render loop maps to createAuraApp({ scene }) lifecycle; setSize/animation loops fold into the app spec." },
+    { construct: "Vector3", target: "[x, y, z]", mapping: "approximate", note: "Vector3 maps to AuraVec3 tuples; mutate via node builder position()/scale() instead of .set()." },
+    { construct: "Color", target: "#rrggbb", mapping: "approximate", note: "THREE.Color maps to hex strings or [r,g,b] arrays in material/light options." },
+    { construct: "TextureLoader.load", target: "assets", engineImport: "assets", mapping: "approximate", note: "TextureLoader.load(url) maps to a typed aura-assets texture ref (assets.<key>) plus material options." },
+    { construct: "Clock", target: "useAuraFrame", mapping: "approximate", note: "THREE.Clock/getDelta folds into the frame callback's dt argument." },
+];
+const byConstruct = new Map(THREE_TO_A3D_MAPPINGS.map((m) => [m.construct, m]));
+export function threeMappingFor(construct) {
+    return byConstruct.get(construct);
+}
+//# sourceMappingURL=mappings.js.map

package/dist/migrate-three/mappings.js.map

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

package/dist/migrate-three/parse.d.ts

@@ -0,0 +1,20 @@
+/**
+ * PRD-15 T6.1 — source scanner for `aura3d migrate three`.
+ *
+ * Line-oriented extraction of Three.js constructs: `new THREE.X(...)`,
+ * `new X(...)` for imported names, `IDENT.load(url)` for loaders, and
+ * `from "three"`-family import specifiers. Produces the construct list the
+ * emitter and report walk.
+ */
+export interface ThreeConstruct {
+    /** Three.js symbol or operation name, e.g. "Scene", "GLTFLoader.load". */
+    readonly construct: string;
+    /** 1-based source line where the construct occurs. */
+    readonly line: number;
+    /** Constructor-call argument source, trimmed ("" for non-ctor matches). */
+    readonly args: string;
+    /** Import specifier when the construct is an import ("three", "three/addons/…"). */
+    readonly specifier?: string;
+}
+export declare function parseThreeSource(source: string): ThreeConstruct[];
+//# sourceMappingURL=parse.d.ts.map

package/dist/migrate-three/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAWD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAsCjE"}

package/dist/migrate-three/parse.js

@@ -0,0 +1,56 @@
+/**
+ * PRD-15 T6.1 — source scanner for `aura3d migrate three`.
+ *
+ * Line-oriented extraction of Three.js constructs: `new THREE.X(...)`,
+ * `new X(...)` for imported names, `IDENT.load(url)` for loaders, and
+ * `from "three"`-family import specifiers. Produces the construct list the
+ * emitter and report walk.
+ */
+const NEW_THREE = /\bnew\s+THREE\.([A-Za-z0-9_]+)\s*\(([^)]*)\)/g;
+const NEW_BARE = /\bnew\s+([A-Za-z0-9_]+)\s*\(([^)]*)\)/g;
+const EULER_ORDER = /\bnew\s+(?:THREE\.)?Euler\s*\(([^)]*)\)/g;
+const LOADER_LOAD = /\b([A-Za-z0-9_]+)\.load\s*\(/g;
+const LOADER_DECL = /\b(?:const|let|var)\s+([A-Za-z0-9_]+)\s*=\s*new\s+THREE\.([A-Za-z0-9_]+)/g;
+const THREE_IMPORT = /\bfrom\s+["'](three(?:\/[^"']*)?)["']/g;
+const LOADER_NAMES = new Set(["GLTFLoader", "RGBELoader", "TextureLoader", "CubeTextureLoader", "EXRLoader"]);
+export function parseThreeSource(source) {
+    const constructs = [];
+    const lines = source.split("\n");
+    const seenLoaderTypes = new Set();
+    for (const m of source.matchAll(NEW_THREE))
+        seenLoaderTypes.add(m[1] ?? "");
+    // variable → loader type so `loader.load(...)` resolves to `GLTFLoader.load`
+    const varTypes = new Map();
+    for (const m of source.matchAll(LOADER_DECL))
+        varTypes.set(m[1] ?? "", m[2] ?? "");
+    lines.forEach((text, index) => {
+        const line = index + 1;
+        for (const m of text.matchAll(THREE_IMPORT)) {
+            constructs.push({ construct: "import", line, args: "", specifier: m[1] });
+        }
+        for (const m of text.matchAll(NEW_THREE)) {
+            constructs.push({ construct: m[1] ?? "", line, args: (m[2] ?? "").trim() });
+        }
+        for (const m of text.matchAll(EULER_ORDER)) {
+            // dedup with NEW_THREE: Euler already captured above if THREE.-prefixed
+            if (!text.slice(0, m.index).endsWith("THREE.")) {
+                constructs.push({ construct: "Euler", line, args: (m[1] ?? "").trim() });
+            }
+        }
+        for (const m of text.matchAll(LOADER_LOAD)) {
+            const name = m[1] ?? "";
+            const resolved = varTypes.get(name) ?? (LOADER_NAMES.has(name) ? name : undefined);
+            if (resolved)
+                constructs.push({ construct: `${resolved}.load`, line, args: "" });
+        }
+        // bare `new X(...)` for names a bare-THREE import could declare
+        for (const m of text.matchAll(NEW_BARE)) {
+            const name = m[1] ?? "";
+            if (seenLoaderTypes.has(name))
+                continue;
+            constructs.push({ construct: name, line, args: (m[2] ?? "").trim(), specifier: "bare" });
+        }
+    });
+    return constructs;
+}
+//# sourceMappingURL=parse.js.map

package/dist/migrate-three/parse.js.map

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

package/dist/migrate-three/report.d.ts

@@ -0,0 +1,18 @@
+/**
+ * PRD-15 T6.1 — report renderer for `aura3d migrate three`.
+ *
+ * Emits the per-construct row table ({construct, line, mapping, note}) as
+ * JSON plus a one-line summary count per mapping class.
+ */
+import type { MigrateRow } from "./emit.js";
+export interface MigrateReport {
+    readonly rows: readonly MigrateRow[];
+    readonly counts: {
+        readonly exact: number;
+        readonly approximate: number;
+        readonly none: number;
+    };
+}
+export declare function buildMigrateReport(rows: readonly MigrateRow[]): MigrateReport;
+export declare function formatMigrateReport(report: MigrateReport): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/migrate-three/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/report.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAClG;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,aAAa,CAI7E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAEjE"}

package/dist/migrate-three/report.js

@@ -0,0 +1,16 @@
+/**
+ * PRD-15 T6.1 — report renderer for `aura3d migrate three`.
+ *
+ * Emits the per-construct row table ({construct, line, mapping, note}) as
+ * JSON plus a one-line summary count per mapping class.
+ */
+export function buildMigrateReport(rows) {
+    const counts = { exact: 0, approximate: 0, none: 0 };
+    for (const row of rows)
+        counts[row.mapping]++;
+    return { rows, counts };
+}
+export function formatMigrateReport(report) {
+    return JSON.stringify(report, null, 2);
+}
+//# sourceMappingURL=report.js.map

package/dist/migrate-three/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/migrate-three/report.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,UAAU,kBAAkB,CAAC,IAA2B;IAC5D,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACrD,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/pull-bridge/adapters.d.ts

@@ -1,4 +1,4 @@
 import type { SourceAdapter } from "@aura3d/asset-index";
-export declare function buildSearchAdapters(env?: NodeJS.ProcessEnv): SourceAdapter[];
+export declare function buildSearchAdapters(env?: NodeJS.ProcessEnv, projectDir?: string): SourceAdapter[];
 export declare function buildDeepLinkAdapter(): SourceAdapter | undefined;
 //# sourceMappingURL=adapters.d.ts.map

package/dist/pull-bridge/adapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/pull-bridge/adapters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAgBzD,wBAAgB,mBAAmB,CACjC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,aAAa,EAAE,CAwBjB;AAED,wBAAgB,oBAAoB,IAAI,aAAa,GAAG,SAAS,CAGhE"}
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../../../../packages/aura3d-cli/src/pull-bridge/adapters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAiBzD,wBAAgB,mBAAmB,CACjC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,UAAU,GAAE,MAAsB,GACjC,aAAa,EAAE,CAoCjB;AAED,wBAAgB,oBAAoB,IAAI,aAAa,GAAG,SAAS,CAGhE"}