@aura3d/engine 3.0.0 → 4.0.0

package/dist/engine/agent-api/world/spline.d.ts

@@ -0,0 +1,67 @@
+/**
+ * PRD-10 §7.1.7 / T5.2 + T5.3 — `world.spline` and `world.extrude`.
+ *
+ * Spline: centripetal Catmull-Rom (alpha = 0.5) with an arc-length
+ * reparameterisation, rotation-minimizing (parallel-transport) frames and
+ * optional banking roll. All math is CPU-side, deterministic, and pure — the
+ * handle captures sampled state at build time so callers can query
+ * `pointAt/tangentAt/frameAt/closestT` without re-deriving.
+ *
+ * Extrude: sweeps a named or custom 2D profile (x = right, y = up in frame
+ * space) along the spline into indexed triangle geometry with UVs in metres
+ * (`uv.uScale`, `uv.vMetersPerTile`). `conformToTerrain` writes a flatten
+ * mask into the target terrain's height source before upload and bumps the
+ * record's `gridVersion` so the Path S runtime re-uploads the height texture.
+ */
+import type { AuraMaterialSpec, AuraSceneNode } from "../index.js";
+import type { AuraWorldNodeBase } from "./types.js";
+import { type AuraTerrainHandle } from "./terrain.js";
+type V3 = [number, number, number];
+export interface AuraSplineFrame {
+    readonly right: V3;
+    readonly up: V3;
+    readonly forward: V3;
+}
+export interface AuraSplineHandle {
+    /** Arc length in metres. */
+    readonly length: number;
+    /** Position at t ∈ [0,1] (t = arc-length fraction). */
+    pointAt(t: number): V3;
+    /** Unit tangent at t ∈ [0,1]. */
+    tangentAt(t: number): V3;
+    /** Rotation-minimizing orthonormal frame at t ∈ [0,1] (banking applied). */
+    frameAt(t: number): AuraSplineFrame;
+    /** t of the closest curve point to `point` (coarse + refined). */
+    closestT(point: V3): number;
+}
+export interface AuraSplineOptions {
+    readonly closed?: boolean;
+    /** Reserved for API stability — centripetal parameterisation ignores it. */
+    readonly tension?: number;
+    readonly up?: "y" | "banked";
+    /** Roll around the tangent at each control point, degrees. Default 0. */
+    readonly bankDeg?: readonly number[];
+}
+export declare function worldSpline(points: readonly (readonly [number, number, number])[], options?: AuraSplineOptions): AuraSplineHandle;
+/** A 2D profile swept along the spline: x = right offset, y = up offset. */
+export type AuraExtrudeProfile = "road-2-lane" | "road-4-lane" | "race-track" | "curb" | "rail" | "tunnel-round" | "tunnel-box" | "fence" | "marking-line" | readonly (readonly [number, number])[];
+export interface AuraExtrudeOptions extends AuraWorldNodeBase {
+    readonly profile: AuraExtrudeProfile;
+    readonly material: AuraMaterialSpec;
+    /** Stations per metre of arc length; subdivided adaptively on curvature. */
+    readonly segmentsPerMeter?: number;
+    readonly uv?: {
+        readonly uScale?: number;
+        readonly vMetersPerTile?: number;
+    };
+    readonly conformToTerrain?: {
+        readonly terrain: AuraTerrainHandle | string;
+        readonly falloff?: number;
+        readonly offsetY?: number;
+    } | boolean;
+    /** Accepted for future physics emission; Path S carries visual mesh only. */
+    readonly collider?: boolean;
+}
+export declare function worldExtrude(spline: AuraSplineHandle, options: AuraExtrudeOptions): AuraSceneNode;
+export {};
+//# sourceMappingURL=spline.d.ts.map

package/dist/engine/agent-api/world/spline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spline.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/world/spline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAIxE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AA6CnC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC;IACvB,iCAAiC;IACjC,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC;IACzB,4EAA4E;IAC5E,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC;IACpC,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,CAAC,EAAE,GAAG,GAAG,QAAQ,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAID,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,EAAE,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAgHrI;AAID,4EAA4E;AAC5E,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GAAG,aAAa,GAAG,YAAY,GAAG,MAAM,GAAG,MAAM,GAC9D,cAAc,GAAG,YAAY,GAAG,OAAO,GAAG,cAAc,GACxD,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;AA8B3C,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,QAAQ,CAAC,gBAAgB,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IAC7I,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AA6CD,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,kBAAkB,GAAG,aAAa,CA2GjG"}

package/dist/engine/agent-api/world/spline.js

@@ -0,0 +1,337 @@
+import { defineAuraCustomGeometry, geometry } from "../index.js";
+import { terrainRecordFor } from "./terrain.js";
+const add = (a, b) => [a[0] + b[0], a[1] + b[1], a[2] + b[2]];
+const sub = (a, b) => [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+const scale = (a, s) => [a[0] * s, a[1] * s, a[2] * s];
+const dot = (a, b) => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+const cross = (a, b) => [
+    a[1] * b[2] - a[2] * b[1],
+    a[2] * b[0] - a[0] * b[2],
+    a[0] * b[1] - a[1] * b[0]
+];
+const len = (a) => Math.hypot(a[0], a[1], a[2]);
+const norm = (a) => {
+    const l = len(a);
+    return l > 1e-12 ? scale(a, 1 / l) : [0, 0, 1];
+};
+const lerp = (a, b, t) => [
+    a[0] + (b[0] - a[0]) * t,
+    a[1] + (b[1] - a[1]) * t,
+    a[2] + (b[2] - a[2]) * t
+];
+// -------------------------------------------------- Catmull-Rom sampling ---
+// Centripetal (alpha = 0.5) formulation: segment knots are spaced by
+// sqrt(|P_{i+1} - P_i|), which prevents the cusps uniform CR produces when
+// control points bunch up.
+function catmullRomPoint(p0, p1, p2, p3, u) {
+    const d01 = Math.max(Math.sqrt(len(sub(p1, p0))), 1e-6);
+    const d12 = Math.max(Math.sqrt(len(sub(p2, p1))), 1e-6);
+    const d23 = Math.max(Math.sqrt(len(sub(p3, p2))), 1e-6);
+    const t0 = 0;
+    const t1 = t0 + d01;
+    const t2 = t1 + d12;
+    const t3 = t2 + d23;
+    const t = t1 + u * (t2 - t1);
+    const a1 = add(scale(p0, (t1 - t) / (t1 - t0)), scale(p1, (t - t0) / (t1 - t0)));
+    const a2 = add(scale(p1, (t2 - t) / (t2 - t1)), scale(p2, (t - t1) / (t2 - t1)));
+    const a3 = add(scale(p2, (t3 - t) / (t3 - t2)), scale(p3, (t - t2) / (t3 - t2)));
+    const b1 = add(scale(a1, (t2 - t) / (t2 - t0)), scale(a2, (t - t0) / (t2 - t0)));
+    const b2 = add(scale(a2, (t3 - t) / (t3 - t1)), scale(a3, (t - t1) / (t3 - t1)));
+    return add(scale(b1, (t2 - t) / (t2 - t1)), scale(b2, (t - t1) / (t2 - t1)));
+}
+const SAMPLES_PER_SPAN = 16;
+export function worldSpline(points, options = {}) {
+    if (points.length < 2)
+        throw new Error("world.spline: at least two control points are required");
+    const closed = options.closed === true;
+    if (closed && points.length < 3)
+        throw new Error("world.spline: a closed spline needs at least three control points");
+    // Sample the curve densely (16 sub-steps per span) and build the arc-length
+    // table. All queries then operate on the table — deterministic and O(1)-ish.
+    const pts = points.map((p) => [p[0], p[1], p[2]]);
+    const spanCount = closed ? pts.length : pts.length - 1;
+    const at = (i) => closed ? pts[((i % pts.length) + pts.length) % pts.length] : pts[Math.max(0, Math.min(pts.length - 1, i))];
+    const samples = [];
+    const segStart = []; // sample index at each span start
+    for (let s = 0; s < spanCount; s += 1) {
+        segStart.push(samples.length);
+        const p0 = at(s - 1), p1 = at(s), p2 = at(s + 1), p3 = at(s + 2);
+        const n = s === spanCount - 1 ? SAMPLES_PER_SPAN + 1 : SAMPLES_PER_SPAN;
+        for (let i = 0; i < n; i += 1) {
+            const u = i / SAMPLES_PER_SPAN;
+            samples.push(catmullRomPoint(p0, p1, p2, p3, Math.min(u, 1)));
+        }
+    }
+    // arc-length table
+    const cum = [0];
+    for (let i = 1; i < samples.length; i += 1)
+        cum.push(cum[i - 1] + len(sub(samples[i], samples[i - 1])));
+    const length = cum[cum.length - 1];
+    const N = samples.length;
+    const indexAt = (s) => {
+        const clamped = Math.max(0, Math.min(length, s));
+        let lo = 0, hi = N - 1;
+        while (lo < hi) {
+            const mid = (lo + hi) >> 1;
+            if (cum[mid] < clamped)
+                lo = mid + 1;
+            else
+                hi = mid;
+        }
+        return Math.max(1, lo);
+    };
+    const pointAtDistance = (s) => {
+        const i = indexAt(s);
+        const s0 = cum[i - 1], s1 = cum[i];
+        const f = s1 > s0 ? (Math.max(0, Math.min(length, s)) - s0) / (s1 - s0) : 0;
+        return lerp(samples[i - 1], samples[i], f);
+    };
+    const pointAt = (t) => pointAtDistance(Math.max(0, Math.min(1, t)) * length);
+    const tangentAt = (t) => {
+        const s = Math.max(0, Math.min(1, t)) * length;
+        const ds = Math.max(length * 1e-4, 1e-4);
+        return norm(sub(pointAtDistance(s + ds), pointAtDistance(s - ds)));
+    };
+    // Rotation-minimizing frames by parallel transport along the sample table,
+    // then banking roll around the tangent. Bank is interpolated across control
+    // stations (option bankDeg[i] applies at control point i's t).
+    const frames = new Array(N);
+    const initialT = norm(sub(samples[1], samples[0]));
+    let right = Math.abs(initialT[1]) > 0.999 ? norm(cross([1, 0, 0], initialT)) : norm(cross([0, 1, 0], initialT));
+    for (let i = 0; i < N; i += 1) {
+        const t_i = norm(sub(samples[Math.min(i + 1, N - 1)], samples[Math.max(i - 1, 0)]));
+        // project previous right onto the plane ⟂ tangent → parallel transport
+        right = norm(sub(right, scale(t_i, dot(t_i, right))));
+        const up = norm(cross(t_i, right));
+        frames[i] = { right, up, forward: t_i };
+    }
+    const bank = (t) => {
+        const arr = options.bankDeg;
+        if (!arr || arr.length === 0)
+            return 0;
+        if (arr.length === 1)
+            return (arr[0] * Math.PI) / 180;
+        const spanT = t * (closed ? arr.length : arr.length - 1);
+        const i0 = Math.floor(spanT);
+        const i1 = closed ? (i0 + 1) % arr.length : Math.min(i0 + 1, arr.length - 1);
+        const f = spanT - i0;
+        return (arr[i0 % arr.length] * (1 - f) + arr[i1] * f) * (Math.PI / 180);
+    };
+    const frameAt = (t) => {
+        const s = Math.max(0, Math.min(1, t)) * length;
+        const i = indexAt(s);
+        const s0 = cum[i - 1], s1 = cum[i];
+        const f = s1 > s0 ? (s - s0) / (s1 - s0) : 0;
+        const a = frames[i - 1], b = frames[i];
+        const forward = norm(lerp(a.forward, b.forward, f));
+        let r = norm(lerp(a.right, b.right, f));
+        r = norm(sub(r, scale(forward, dot(forward, r))));
+        let u = norm(cross(forward, r));
+        const theta = bank(t);
+        if (theta !== 0) {
+            const c = Math.cos(theta), sn = Math.sin(theta);
+            const r2 = add(scale(r, c), scale(u, sn));
+            u = add(scale(u, c), scale(r, -sn));
+            r = r2;
+        }
+        return { right: r, up: u, forward };
+    };
+    const closestT = (point) => {
+        let best = 0, bestD = Infinity;
+        for (let i = 0; i < N; i += 1) {
+            const d = len(sub(samples[i], point));
+            if (d < bestD) {
+                bestD = d;
+                best = i;
+            }
+        }
+        // refine inside the neighbouring arc window with a golden-section search
+        let lo = cum[Math.max(0, best - 1)], hi = cum[Math.min(N - 1, best + 1)];
+        for (let it = 0; it < 20 && hi - lo > 1e-6; it += 1) {
+            const m1 = lo + (hi - lo) / 3, m2 = hi - (hi - lo) / 3;
+            const d1 = len(sub(pointAtDistance(m1), point));
+            const d2 = len(sub(pointAtDistance(m2), point));
+            if (d1 < d2)
+                hi = m2;
+            else
+                lo = m1;
+        }
+        return Math.max(0, Math.min(1, (lo + hi) / 2 / length));
+    };
+    return { length, pointAt, tangentAt, frameAt, closestT };
+}
+const ring = (radius, n, yBase) => {
+    const out = [];
+    for (let i = 0; i < n; i += 1) {
+        const a = (i / n) * Math.PI * 2;
+        out.push([Math.cos(a) * radius, yBase + Math.sin(a) * radius + radius]);
+    }
+    return out;
+};
+const EXTRUDE_PROFILES = {
+    "road-2-lane": { points: [[-3.7, 0], [3.7, 0], [3.7, -0.15], [-3.7, -0.15]], closed: true },
+    "road-4-lane": { points: [[-7.4, 0], [7.4, 0], [7.4, -0.15], [-7.4, -0.15]], closed: true },
+    "race-track": { points: [[-6, 0], [-6, 0.06], [-5.6, 0.12], [5.6, 0.12], [6, 0.06], [6, 0], [6, -0.3], [-6, -0.3]], closed: true },
+    "curb": { points: [[0, 0], [0.15, 0], [0.15, 0.18], [0, 0.18]], closed: true },
+    "rail": { points: [[-0.072, 0], [0.072, 0], [0.06, 0.1], [0.033, 0.16], [-0.033, 0.16], [-0.06, 0.1]], closed: true },
+    "tunnel-round": { points: ring(6, 12, -1.5), closed: true },
+    "tunnel-box": { points: [[-4.5, 0], [4.5, 0], [4.5, 4.5], [-4.5, 4.5]], closed: true },
+    "fence": { points: [[-0.05, 0], [0.05, 0], [0.05, 1], [-0.05, 1]], closed: true },
+    // thin emissive strip for lane markings (§7.1.8 street markings)
+    "marking-line": { points: [[-0.075, 0.015], [0.075, 0.015], [0.075, 0.0175], [-0.075, 0.0175]], closed: true }
+};
+function resolveProfile(profile) {
+    if (typeof profile !== "string") {
+        if (profile.length < 3)
+            throw new Error("world.extrude: a custom profile needs at least three [x, y] points");
+        return { points: profile, closed: true };
+    }
+    const def = EXTRUDE_PROFILES[profile];
+    if (!def)
+        throw new Error(`world.extrude: unknown profile "${profile}"`);
+    return def;
+}
+/** Write the spline's flatten mask into a terrain's height grid (pre-upload). */
+function conformToTerrain(spline, terrainId, falloff, offsetY, halfWidth) {
+    const record = terrainRecordFor(terrainId);
+    const grid = record?.grid;
+    if (!record || !grid) {
+        // Asset-source terrains resolve their grid at compile time; emit a warning
+        // rather than silently skipping so the caller can see the flatten is lost.
+        console.warn(`world.extrude conformToTerrain: terrain "${terrainId}" has no resolved height grid — flatten skipped`);
+        return;
+    }
+    const cols = grid.columns, rows = grid.rows;
+    const [sx, sz] = record.size;
+    const reach = halfWidth + falloff;
+    // marching stations — samples every ~1 m along the strip
+    const stations = Math.max(2, Math.ceil(spline.length));
+    for (let gz = 0; gz < rows; gz += 1) {
+        const wz = record.origin[2] + (gz / (rows - 1)) * sz;
+        for (let gx = 0; gx < cols; gx += 1) {
+            const wx = record.origin[0] + (gx / (cols - 1)) * sx;
+            const t = spline.closestT([wx, 0, wz]);
+            const center = spline.pointAt(t);
+            const dist = Math.hypot(wx - center[0], wz - center[2]);
+            if (dist > reach)
+                continue;
+            const target = center[1] + offsetY;
+            const w = dist <= halfWidth ? 1 : 1 - (dist - halfWidth) / Math.max(falloff, 1e-3);
+            const i = gz * cols + gx;
+            const cur = grid.heights[i] * record.heightScale;
+            grid.heights[i] = (cur * (1 - w) + target * w) / record.heightScale;
+        }
+    }
+    record.gridVersion = (record.gridVersion ?? 0) + 1;
+}
+export function worldExtrude(spline, options) {
+    if (spline.length <= 0)
+        throw new Error("world.extrude: spline has zero length");
+    const profile = resolveProfile(options.profile);
+    const ppts = profile.points;
+    const M = ppts.length;
+    const edges = profile.closed ? M : M - 1;
+    const edgeNormals = [];
+    for (let i = 0; i < edges; i += 1) {
+        const a = ppts[i], b = ppts[(i + 1) % M];
+        const dx = b[0] - a[0], dy = b[1] - a[1];
+        const l = Math.hypot(dx, dy) || 1;
+        edgeNormals.push([dy / l, -dx / l]); // 2D outward normal in frame space
+    }
+    // Station spacing: base density + one adaptive pass that splits spans whose
+    // tangent turn exceeds ~0.05 rad (curvature adaptive, §7.1.7).
+    const spm = options.segmentsPerMeter ?? 0.5;
+    let stations = [];
+    const base = Math.max(2, Math.ceil(spline.length * spm) + 1);
+    for (let i = 0; i < base; i += 1)
+        stations.push(i / (base - 1));
+    for (let pass = 0; pass < 2; pass += 1) {
+        const out = [stations[0]];
+        for (let i = 1; i < stations.length; i += 1) {
+            const a = spline.tangentAt(stations[i - 1]);
+            const b = spline.tangentAt(stations[i]);
+            if (dot(a, b) < Math.cos(0.05)) {
+                const mid = (stations[i - 1] + stations[i]) / 2;
+                if (out[out.length - 1] !== mid)
+                    out.push(mid);
+            }
+            out.push(stations[i]);
+        }
+        stations = out;
+    }
+    const S = stations.length;
+    const positions = [];
+    const normals = [];
+    const uvs = [];
+    const indices = [];
+    const uScale = options.uv?.uScale ?? 1;
+    const vTile = Math.max(1e-3, options.uv?.vMetersPerTile ?? 4);
+    for (let s = 0; s < S; s += 1) {
+        const t = stations[s];
+        const center = spline.pointAt(t);
+        const frame = spline.frameAt(t);
+        const v = (t * spline.length) / vTile;
+        for (let i = 0; i < M; i += 1) {
+            const [px, py] = ppts[i];
+            positions.push(add(center, add(scale(frame.right, px), scale(frame.up, py))));
+            // vertex normal = average of adjacent edge normals in frame space
+            const nA = edgeNormals[(i - 1 + edges) % edges] ?? edgeNormals[0];
+            const nB = edgeNormals[i % edges] ?? edgeNormals[edges - 1];
+            const nx = nA[0] + nB[0], ny = nA[1] + nB[1];
+            normals.push(norm(add(scale(frame.right, nx), scale(frame.up, ny))));
+            uvs.push(px * uScale, v);
+        }
+    }
+    for (let s = 0; s < S - 1; s += 1) {
+        for (let i = 0; i < edges; i += 1) {
+            const a = s * M + i;
+            const b = s * M + ((i + 1) % M);
+            const c = (s + 1) * M + ((i + 1) % M);
+            const d = (s + 1) * M + i;
+            indices.push(a, d, b, b, d, c);
+        }
+    }
+    // flat end caps for open splines
+    for (const s of [0, S - 1]) {
+        const t = stations[s];
+        const center = spline.pointAt(t);
+        const fwd = scale(spline.tangentAt(t), s === 0 ? -1 : 1);
+        const centerIdx = positions.length;
+        positions.push(center);
+        normals.push(fwd);
+        uvs.push(0, (t * spline.length) / vTile);
+        for (let i = 0; i < edges - 1; i += 1) {
+            const a = s * M + i, b = s * M + i + 1;
+            if (s === 0)
+                indices.push(centerIdx, b, a);
+            else
+                indices.push(centerIdx, a, b);
+        }
+    }
+    if (options.conformToTerrain) {
+        const conf = options.conformToTerrain;
+        const terrainId = conf === true ? undefined : (typeof conf.terrain === "string" ? conf.terrain : conf.terrain.id);
+        if (terrainId) {
+            const maxHalf = Math.max(...ppts.map((p) => Math.abs(p[0])));
+            conformToTerrain(spline, terrainId, conf === true ? 8 : (conf.falloff ?? 8), conf === true ? 0 : (conf.offsetY ?? 0), maxHalf);
+        }
+        else {
+            console.warn("world.extrude conformToTerrain: pass { terrain: <handle|id> } to target a specific terrain");
+        }
+    }
+    const spec = defineAuraCustomGeometry({
+        positions: positions.map((p) => [p[0], p[1], p[2]]),
+        normals: normals.map((n) => [n[0], n[1], n[2]]),
+        indices
+    });
+    const node = geometry.custom(spec, {
+        name: options.name ?? `extrude-${options.profile.toString()}`,
+        material: options.material
+    }).toJSON();
+    // UVs in metres are attached post-hoc: defineAuraCustomGeometry rebuilds the
+    // spec (owner-15 contract, positions/normals/indices only), so `uvs` rides
+    // as an additive field the renderer's custom-geometry upload picks up.
+    node.geometry.uvs = uvs;
+    return node;
+}
+//# sourceMappingURL=spline.js.map

package/dist/engine/agent-api/world/spline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spline.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/world/spline.ts"],"names":[],"mappings":"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"}

package/dist/engine/agent-api/world/street.d.ts

@@ -0,0 +1,49 @@
+/**
+ * PRD-10 §7.1.8 / T5.5 — `world.street`: road surface + sidewalks extruded
+ * along a spline, buildings placed from the city kit along the setback line,
+ * street props via `world.placeAlong`, and lane markings as emissive strips.
+ *
+ * Emission follows the kit/placement contract: kit pieces become ONE `scatter`
+ * node per unique asset; road/sidewalk/marking surfaces become `custom`
+ * primitive nodes from `world.extrude`. `wet` is accepted for API stability
+ * and warns once — the wet-look material variant lands with PRD-11 shaders.
+ */
+import type { AuraMaterialSpec, AuraSceneNode } from "../index.js";
+import type { AuraKit } from "./kits.js";
+import { type AuraSplineHandle } from "./spline.js";
+import type { AuraTerrainHandle } from "./terrain.js";
+export interface AuraStreetBuildings {
+    /** Relative fill weight per building piece id (default: all equal). */
+    readonly pieces?: Readonly<Record<string, number>>;
+    readonly density?: number;
+    readonly setback?: number;
+    readonly heightRange?: readonly [number, number];
+    readonly seed?: number;
+}
+export interface AuraStreetProps {
+    /** Street lamps at `spacing` metres; default {spacing: 30}. */
+    readonly lamps?: boolean | {
+        readonly spacing?: number;
+    };
+    /** Planters interleaved between lamps; default true. */
+    readonly planters?: boolean;
+    readonly seed?: number;
+}
+export interface AuraStreetOptions {
+    /** Centerline control points (or a pre-built spline). */
+    readonly path: readonly (readonly [number, number, number])[] | AuraSplineHandle;
+    readonly lanes?: 2 | 4;
+    readonly sidewalkWidth?: number;
+    readonly kit?: AuraKit;
+    readonly buildings?: AuraStreetBuildings | false;
+    readonly props?: AuraStreetProps | false;
+    readonly markings?: boolean;
+    /** Accepted; emits a warning (wet-look shader variant lands separately). */
+    readonly wet?: boolean;
+    readonly conformToTerrain?: AuraTerrainHandle | string;
+    readonly roadMaterial?: AuraMaterialSpec;
+    readonly sidewalkMaterial?: AuraMaterialSpec;
+    readonly name?: string;
+}
+export declare function worldStreet(options: AuraStreetOptions): readonly AuraSceneNode[];
+//# sourceMappingURL=street.d.ts.map

package/dist/engine/agent-api/world/street.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"street.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/world/street.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAY,MAAM,aAAa,CAAC;AAE7E,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,WAAW,CAAC;AAG3D,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,gBAAgB,CAAC;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAC;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,KAAK,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC;IACzC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,aAAa,EAAE,CAqIhF"}

package/dist/engine/agent-api/world/street.js

@@ -0,0 +1,147 @@
+import { material } from "../index.js";
+import { worldKits } from "./kits.js";
+import { worldPlaceAlong } from "./placement.js";
+import { worldExtrude, worldSpline } from "./spline.js";
+export function worldStreet(options) {
+    const spline = "pointAt" in options.path ? options.path : worldSpline(options.path);
+    const lanes = options.lanes ?? 2;
+    const profile = lanes === 4 ? "road-4-lane" : "road-2-lane";
+    const roadHalf = lanes === 4 ? 7.4 : 3.7;
+    const sidewalkWidth = options.sidewalkWidth ?? 3;
+    const kit = options.kit ?? worldKits.city;
+    const name = options.name ?? "street";
+    const nodes = [];
+    const roadMat = options.roadMaterial ?? material.pbr({ color: "#2b2f33", roughness: 0.82 });
+    if (options.wet) {
+        console.warn("world.street: `wet` is accepted but the wet-look material variant is not wired yet (see PRD-10 §7.1.8); emitting dry asphalt");
+    }
+    // ---------------- road surface ----------------
+    nodes.push(worldExtrude(spline, {
+        profile,
+        material: roadMat,
+        name: `${name}-road`,
+        uv: { uScale: 0.5, vMetersPerTile: 8 },
+        ...(options.conformToTerrain ? { conformToTerrain: { terrain: options.conformToTerrain } } : {})
+    }));
+    // ---------------- sidewalks (raised slabs beside the road) ---------------
+    if (sidewalkWidth > 0) {
+        const sidewalkMat = options.sidewalkMaterial ?? material.pbr({ color: "#9aa3a8", roughness: 0.86 });
+        const slab = [
+            [-sidewalkWidth, 0.12], [0, 0.12], [0, -0.03], [-sidewalkWidth, -0.03]
+        ];
+        for (const side of [-1, 1]) {
+            // offset the profile outward by road edge + sidewalk half-width
+            const off = (roadHalf + sidewalkWidth) * side;
+            const shifted = slab.map(([x, y]) => [x + off, y]);
+            nodes.push(worldExtrude(spline, {
+                profile: shifted,
+                material: sidewalkMat,
+                name: `${name}-sidewalk-${side === -1 ? "l" : "r"}`,
+                uv: { uScale: 0.4, vMetersPerTile: 4 }
+            }));
+        }
+    }
+    // ---------------- lane markings ----------------
+    if (options.markings !== false) {
+        const markingMat = material.emissive({ color: "#e8e4da", emissive: "#d9d2c4", emissiveIntensity: 0.35 });
+        nodes.push(worldExtrude(spline, {
+            profile: "marking-line",
+            material: markingMat,
+            name: `${name}-centerline`,
+            segmentsPerMeter: 1
+        }));
+        if (lanes === 4) {
+            for (const side of [-3.7, 3.7]) {
+                const shifted = [[side - 0.075, 0.015], [side + 0.075, 0.015], [side + 0.075, 0.0175], [side - 0.075, 0.0175]];
+                nodes.push(worldExtrude(spline, {
+                    profile: shifted,
+                    material: markingMat,
+                    name: `${name}-lane-${side}`,
+                    segmentsPerMeter: 1
+                }));
+            }
+        }
+    }
+    // ---------------- buildings on the setback line ----------------
+    const buildings = options.buildings === false ? undefined : (options.buildings ?? {});
+    if (buildings) {
+        const density = buildings.density ?? 0.65;
+        const setback = buildings.setback ?? 4;
+        const placements = [];
+        const rng = mulberryish(buildings.seed ?? 7);
+        const buildingPieces = kit.definition.pieces.filter((p) => p.footprint[0] >= 4 || p.id === "tower");
+        const spacing = 12;
+        const rows = [{ side: "left" }, { side: "right" }];
+        for (const { side } of rows) {
+            for (let s = spacing / 2; s < spline.length; s += spacing) {
+                if (rng() > density)
+                    continue;
+                const t = s / spline.length;
+                const center = spline.pointAt(t);
+                const frame = spline.frameAt(t);
+                const sign = side === "left" ? -1 : 1;
+                const p = buildingPieces[Math.floor(rng() * buildingPieces.length)];
+                const off = sign * (roadHalf + sidewalkWidth + setback + p.footprint[0] / 2);
+                const pos = [
+                    center[0] + frame.right[0] * off,
+                    0,
+                    center[2] + frame.right[2] * off
+                ];
+                // face the street: yaw so the piece's +x runs along the tangent
+                const yawSteps = Math.round((Math.atan2(frame.forward[0], frame.forward[2]) * 180) / Math.PI / 90);
+                placements.push({ piece: p.id, position: pos, rotationSteps: side === "left" ? yawSteps + 2 : yawSteps });
+            }
+        }
+        if (placements.length > 0)
+            nodes.push(...kit.place(placements).nodes);
+    }
+    // ---------------- props: lamps + planters along the sidewalk -------------
+    const props = options.props === false ? undefined : (options.props ?? {});
+    if (props) {
+        const lampSpacing = typeof props.lamps === "object" ? (props.lamps.spacing ?? 30) : (props.lamps === false ? 0 : 30);
+        const inner = roadHalf + sidewalkWidth - 0.4;
+        try {
+            if (lampSpacing > 0) {
+                const lampPiece = kit.piece("street-lamp");
+                for (const side of ["left", "right"]) {
+                    nodes.push(...worldPlaceAlong(spline, lampPiece, {
+                        spacing: lampSpacing,
+                        offset: inner,
+                        side,
+                        alignToTangent: false,
+                        seed: (props.seed ?? 11) + (side === "left" ? 1 : 0)
+                    }).nodes);
+                }
+            }
+            if (props.planters !== false) {
+                const planterPiece = kit.piece("planter");
+                nodes.push(...worldPlaceAlong(spline, planterPiece, {
+                    spacing: lampSpacing > 0 ? lampSpacing : 20,
+                    offset: inner - 0.8,
+                    side: "right",
+                    alignToTangent: true,
+                    jitter: [2, 0.2, 15],
+                    seed: (props.seed ?? 11) + 5,
+                    start: 0.02,
+                    end: 0.98
+                }).nodes);
+            }
+        }
+        catch (e) {
+            console.warn(`world.street: prop placement skipped — ${e.message}`);
+        }
+    }
+    return nodes;
+}
+/** Deterministic 0..1 stream (same mulberry32 core as scatterRng). */
+function mulberryish(seed) {
+    let a = seed >>> 0;
+    return () => {
+        a |= 0;
+        a = (a + 0x6d2b79f5) | 0;
+        let t = Math.imul(a ^ (a >>> 15), 1 | a);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+//# sourceMappingURL=street.js.map