@hypersoniclabs/helix-cli 0.1.6 → 0.1.23

package/dist/sceneImport/multiAssetSpawn.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readGlbTriangles = readGlbTriangles;
+exports.placeTriangles = placeTriangles;
+exports.probeMultiAssetSpawn = probeMultiAssetSpawn;
+const spawnProbe_1 = require("./spawnProbe");
+const gltfIo_1 = require("./gltfIo");
+/**
+ * Cross-asset ground spawn probing.
+ *
+ * The single-sheet importer probed the one mesh that backed collision. A
+ * multi-asset package's collision is spread across N placed proxy meshes, so
+ * the probe must consider candidate surfaces across ALL of them — in world
+ * space, after each instance's placement transform — and reuse the same
+ * canopy/rooftop rejection rules: a column with more than one separated surface
+ * is a roof or a canopy over ground, never a spawn point.
+ */
+async function readGlbTriangles(bytes) {
+    const document = await (0, gltfIo_1.sceneGltfIo)().readBinary(new Uint8Array(bytes));
+    const triangles = [];
+    for (const mesh of document.getRoot().listMeshes()) {
+        for (const primitive of mesh.listPrimitives()) {
+            if (primitive.getMode() !== 4)
+                continue;
+            const position = primitive.getAttribute('POSITION');
+            if (!position)
+                continue;
+            // getScalar(index) returns component 0 of ELEMENT `index` (the element
+            // stride is applied internally), so vertices are read from the flat
+            // array directly; only the optional indices accessor goes through it.
+            const flat = position.getArray();
+            if (!flat)
+                continue;
+            const indices = primitive.getIndices();
+            const count = indices ? indices.getCount() : position.getCount();
+            const at = (index) => {
+                const vertex = indices ? indices.getScalar(index) : index;
+                const base = vertex * 3;
+                return [flat[base], flat[base + 1], flat[base + 2]];
+            };
+            for (let index = 0; index + 2 < count; index += 3) {
+                triangles.push([at(index), at(index + 1), at(index + 2)]);
+            }
+        }
+    }
+    return triangles;
+}
+/** Applies a TRS placement transform to every triangle vertex. */
+function placeTriangles(triangles, transform) {
+    const [qx, qy, qz, qw] = normalizeQuaternion(transform.rotation);
+    return triangles.map((triangle) => [
+        rotateAndPlace(triangle[0], transform.position, transform.scale, qx, qy, qz, qw),
+        rotateAndPlace(triangle[1], transform.position, transform.scale, qx, qy, qz, qw),
+        rotateAndPlace(triangle[2], transform.position, transform.scale, qx, qy, qz, qw),
+    ]);
+}
+function normalizeQuaternion([x, y, z, w]) {
+    const length = Math.hypot(x, y, z, w);
+    if (!Number.isFinite(length) || length < 1e-9)
+        throw new Error('placement rotation quaternion must be non-zero');
+    return [x / length, y / length, z / length, w / length];
+}
+function rotateAndPlace([vx, vy, vz], [px, py, pz], [sx, sy, sz], qx, qy, qz, qw) {
+    // v' = q * (s * v) * q^-1 + p — expanded quaternion sandwich, no matrix allocation.
+    const x = vx * sx;
+    const y = vy * sy;
+    const z = vz * sz;
+    const tx = 2 * (qy * z - qz * y);
+    const ty = 2 * (qz * x - qx * z);
+    const tz = 2 * (qx * y - qy * x);
+    return [x + qw * tx + qy * tz - qz * ty + px, y + qw * ty + qz * tx - qx * tz + py, z + qw * tz + qx * ty - qy * tx + pz];
+}
+/**
+ * Probes a standing position against the union of all placed collider proxies.
+ * Triangle reads are deduplicated by resource and capped: a pack of thousands
+ * of high-poly proxies must not build an unbounded triangle list just to find
+ * open ground, so beyond the cap vertices are stride-sampled evenly across the
+ * whole set instead of taken from whichever asset happened to be read first.
+ */
+async function probeMultiAssetSpawn(input) {
+    const maxTriangles = input.maxTriangles ?? 120_000;
+    const perResourceCache = new Map();
+    let placed = [];
+    for (const collider of input.colliders) {
+        let local = perResourceCache.get(collider.bytes);
+        if (!local) {
+            local = await readGlbTriangles(collider.bytes);
+            perResourceCache.set(collider.bytes, local);
+        }
+        placed = placed.concat(placeTriangles(local, collider.transform));
+    }
+    if (placed.length > maxTriangles) {
+        const stride = placed.length / maxTriangles;
+        placed = Array.from({ length: maxTriangles }, (_, index) => placed[Math.floor(index * stride)]);
+    }
+    return (0, spawnProbe_1.probeSpawn)({ triangles: placed, bounds: input.bounds, clearanceHeightM: input.clearanceHeightM });
+}
+//# sourceMappingURL=multiAssetSpawn.js.map

package/dist/sceneImport/multiAssetSpawn.js.map

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

package/dist/sceneImport/obj.d.ts

@@ -0,0 +1,41 @@
+import type { CompiledSceneArtifact, SourceConversionReceipt, Vec3 } from './types';
+type AxisMapping = (source: Vec3) => Vec3;
+export type ObjSourcePart = {
+    /** Distinguishes this part's materials from every other part's. */
+    name: string;
+    obj: Buffer;
+    texture?: {
+        bytes: Buffer;
+        mimeType: 'image/jpeg' | 'image/png';
+    };
+};
+export declare function compileObjGlb(input: {
+    sourceName: string;
+    obj: Buffer;
+    localOrigin: Vec3;
+    receipt: SourceConversionReceipt;
+    texture?: {
+        bytes: Buffer;
+        mimeType: 'image/jpeg' | 'image/png';
+    };
+    axisMapping?: AxisMapping;
+}): Promise<CompiledSceneArtifact>;
+/**
+ * Compile one GLB from several source OBJs that share a coordinate space.
+ *
+ * A photogrammetry quadtree stores each refinement level as N sibling meshes,
+ * each with its OWN texture atlas -- level 18 of a Helsinki tile is 16 pieces,
+ * not one. Compiling a single piece throws away fifteen sixteenths of the tile,
+ * so the only way to serve a deeper level as one resource is to carry every
+ * sibling and its texture into the same document. Materials are namespaced per
+ * part, because sibling OBJs reuse the same `usemtl` names against different
+ * atlases and merging them would paint one part with another's texture.
+ */
+export declare function compileObjParts(input: {
+    sourceName: string;
+    parts: ObjSourcePart[];
+    localOrigin: Vec3;
+    receipt: SourceConversionReceipt;
+    axisMapping?: AxisMapping;
+}): Promise<CompiledSceneArtifact>;
+export {};

package/dist/sceneImport/obj.js

@@ -0,0 +1,276 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileObjGlb = compileObjGlb;
+exports.compileObjParts = compileObjParts;
+const node_crypto_1 = require("node:crypto");
+const core_1 = require("@gltf-transform/core");
+const spawnProbe_1 = require("./spawnProbe");
+const types_1 = require("./types");
+const gltfIo_1 = require("./gltfIo");
+async function compileObjGlb(input) {
+    return compileObjParts({
+        sourceName: input.sourceName,
+        parts: [
+            {
+                name: input.sourceName,
+                obj: input.obj,
+                ...(input.texture ? { texture: input.texture } : {}),
+            },
+        ],
+        localOrigin: input.localOrigin,
+        receipt: input.receipt,
+        ...(input.axisMapping ? { axisMapping: input.axisMapping } : {}),
+    });
+}
+/**
+ * Compile one GLB from several source OBJs that share a coordinate space.
+ *
+ * A photogrammetry quadtree stores each refinement level as N sibling meshes,
+ * each with its OWN texture atlas -- level 18 of a Helsinki tile is 16 pieces,
+ * not one. Compiling a single piece throws away fifteen sixteenths of the tile,
+ * so the only way to serve a deeper level as one resource is to carry every
+ * sibling and its texture into the same document. Materials are namespaced per
+ * part, because sibling OBJs reuse the same `usemtl` names against different
+ * atlases and merging them would paint one part with another's texture.
+ */
+async function compileObjParts(input) {
+    (0, types_1.assertFiniteVec3)(input.localOrigin, 'local origin');
+    if (!input.parts.length)
+        throw new Error(`${input.sourceName} has no source parts`);
+    const document = new core_1.Document();
+    const buffer = document.createBuffer();
+    const scene = document.createScene('scene');
+    const materialByName = new Map();
+    let textureCount = 0;
+    const allTriangles = [];
+    const bounds = {
+        min: [Infinity, Infinity, Infinity],
+        max: [-Infinity, -Infinity, -Infinity],
+    };
+    let groupCount = 0;
+    for (const part of input.parts) {
+        const parsed = parseObj(part.obj.toString('utf8'), input.localOrigin, input.axisMapping);
+        if (!parsed.triangles.length)
+            throw new Error(`${part.name} contains no triangles`);
+        allTriangles.push(...parsed.triangles);
+        groupCount += parsed.groups.length;
+        for (let axis = 0; axis < 3; axis++) {
+            bounds.min[axis] = Math.min(bounds.min[axis], parsed.bounds.min[axis]);
+            bounds.max[axis] = Math.max(bounds.max[axis], parsed.bounds.max[axis]);
+        }
+        let texture;
+        if (part.texture) {
+            texture = document
+                .createTexture(`${part.name}-base-color`)
+                .setImage(new Uint8Array(part.texture.bytes))
+                .setMimeType(part.texture.mimeType);
+            textureCount += 1;
+        }
+        for (const group of parsed.groups) {
+            const positions = [];
+            const normals = [];
+            const uvs = [];
+            const indices = [];
+            for (const triangle of group.triangles) {
+                for (const vertex of triangle) {
+                    indices.push(indices.length);
+                    positions.push(...vertex.position);
+                    if (vertex.normal)
+                        normals.push(...vertex.normal);
+                    if (vertex.uv)
+                        uvs.push(...vertex.uv);
+                }
+            }
+            const primitive = document
+                .createPrimitive()
+                .setMode(4)
+                .setIndices(document
+                .createAccessor()
+                .setType('SCALAR')
+                .setArray(new Uint32Array(indices))
+                .setBuffer(buffer))
+                .setAttribute('POSITION', document
+                .createAccessor()
+                .setType('VEC3')
+                .setArray(new Float32Array(positions))
+                .setBuffer(buffer));
+            const normalsOut = normals.length === positions.length ? normals : computeFlatNormals(positions);
+            primitive.setAttribute('NORMAL', document.createAccessor().setType('VEC3').setArray(new Float32Array(normalsOut)).setBuffer(buffer));
+            if (uvs.length * 3 === positions.length * 2) {
+                primitive.setAttribute('TEXCOORD_0', document
+                    .createAccessor()
+                    .setType('VEC2')
+                    .setArray(new Float32Array(uvs))
+                    .setBuffer(buffer));
+            }
+            const materialKey = `${part.name}\u0000${group.material}`;
+            let material = materialByName.get(materialKey);
+            if (!material) {
+                material = document
+                    .createMaterial(group.material)
+                    .setBaseColorFactor([0.72, 0.72, 0.72, 1])
+                    .setRoughnessFactor(1)
+                    .setMetallicFactor(0);
+                if (texture && group.material !== 'default') {
+                    material.setBaseColorTexture(texture);
+                    // glTF multiplies the sampled base color by this factor. The neutral fallback gray is
+                    // only for untextured proxies; retaining it here darkens source imagery by 28%.
+                    material.setBaseColorFactor([1, 1, 1, 1]);
+                }
+                materialByName.set(materialKey, material);
+            }
+            primitive.setMaterial(material);
+            const mesh = document.createMesh(group.name).addPrimitive(primitive);
+            scene.addChild(document.createNode(group.name).setMesh(mesh));
+        }
+    }
+    document.getRoot().setExtras({
+        helixSource: {
+            ...input.receipt,
+            sourceFile: input.sourceName,
+            localOrigin: input.localOrigin,
+        },
+    });
+    const bytes = Buffer.from(await (0, gltfIo_1.sceneGltfIo)().writeBinary(document));
+    return {
+        filename: input.sourceName.replace(/\.obj$/i, '.glb'),
+        bytes,
+        contentSha256: (0, node_crypto_1.createHash)('sha256').update(bytes).digest('hex'),
+        bounds,
+        summary: {
+            triangles: allTriangles.length,
+            materials: materialByName.size,
+            textures: textureCount,
+            nodes: groupCount,
+        },
+        spawn: (0, spawnProbe_1.probeSpawn)({
+            triangles: allTriangles.map((triangle) => [triangle[0].position, triangle[1].position, triangle[2].position]),
+            bounds,
+            clearanceHeightM: 1.9,
+        }),
+    };
+}
+function parseObj(text, origin, axisMapping) {
+    const positions = [];
+    const normals = [];
+    const uvs = [];
+    const groups = new Map();
+    const triangles = [];
+    const bounds = {
+        min: [Number.POSITIVE_INFINITY, Number.POSITIVE_INFINITY, Number.POSITIVE_INFINITY],
+        max: [Number.NEGATIVE_INFINITY, Number.NEGATIVE_INFINITY, Number.NEGATIVE_INFINITY],
+    };
+    let objectName = 'source';
+    let materialName = 'default';
+    for (const [lineNumber, raw] of text.split(/\r?\n/).entries()) {
+        const line = raw.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const [keyword, ...parts] = line.split(/\s+/);
+        if (keyword === 'v') {
+            const source = parseNumbers(parts.slice(0, 3), `vertex on line ${lineNumber + 1}`);
+            const local = [source[0] - origin[0], source[1] - origin[1], source[2] - origin[2]];
+            const mapped = axisMapping ? axisMapping(local) : local;
+            (0, types_1.assertFiniteVec3)(mapped, `mapped vertex on line ${lineNumber + 1}`);
+            positions.push(mapped);
+        }
+        else if (keyword === 'vn') {
+            const normal = parseNumbers(parts.slice(0, 3), `normal on line ${lineNumber + 1}`);
+            normals.push(axisMapping ? axisMapping(normal) : normal);
+        }
+        else if (keyword === 'vt') {
+            const [u, v] = parseNumbers(parts.slice(0, 2), `texture coordinate on line ${lineNumber + 1}`);
+            // OBJ's texture origin is bottom-left (V grows up); glTF's is top-left (V grows down).
+            // Passing V through unflipped samples each triangle from the vertically mirrored spot
+            // in the source atlas — individually plausible-looking image data, but scrambled
+            // relative to its neighbors, which is what made textured detail look shattered.
+            uvs.push([u, 1 - v]);
+        }
+        else if (keyword === 'o' || keyword === 'g') {
+            objectName = stableName(parts.join('_') || objectName);
+        }
+        else if (keyword === 'usemtl') {
+            materialName = stableName(parts.join('_') || 'default');
+        }
+        else if (keyword === 'f') {
+            if (parts.length < 3)
+                throw new Error(`face on line ${lineNumber + 1} has fewer than three vertices`);
+            const vertices = parts.map((part) => parseFaceVertex(part, positions, uvs, normals, lineNumber + 1));
+            const key = `${objectName}\0${materialName}`;
+            let group = groups.get(key);
+            if (!group) {
+                group = { name: `${objectName}.${groups.size}`, material: materialName, triangles: [] };
+                groups.set(key, group);
+            }
+            for (let index = 1; index < vertices.length - 1; index++) {
+                const triangle = [vertices[0], vertices[index], vertices[index + 1]];
+                group.triangles.push(triangle);
+                triangles.push(triangle);
+                for (const vertex of triangle) {
+                    for (let axis = 0; axis < 3; axis++) {
+                        bounds.min[axis] = Math.min(bounds.min[axis], vertex.position[axis]);
+                        bounds.max[axis] = Math.max(bounds.max[axis], vertex.position[axis]);
+                    }
+                }
+            }
+        }
+    }
+    return { groups: [...groups.values()], triangles, bounds };
+}
+function parseFaceVertex(token, positions, uvs, normals, lineNumber) {
+    const [positionToken, uvToken, normalToken] = token.split('/');
+    const position = indexed(positions, positionToken, `position on face line ${lineNumber}`);
+    const uv = uvToken ? indexed(uvs, uvToken, `UV on face line ${lineNumber}`) : undefined;
+    const normal = normalToken ? indexed(normals, normalToken, `normal on face line ${lineNumber}`) : undefined;
+    return { position, ...(uv ? { uv } : {}), ...(normal ? { normal } : {}) };
+}
+function indexed(values, raw, label) {
+    const parsed = Number(raw);
+    if (!Number.isInteger(parsed) || parsed === 0)
+        throw new Error(`${label} has an invalid index`);
+    const index = parsed > 0 ? parsed - 1 : values.length + parsed;
+    const value = values[index];
+    if (!value)
+        throw new Error(`${label} references a missing value`);
+    return value;
+}
+function parseNumbers(parts, label) {
+    const values = parts.map(Number);
+    if (!values.length || values.some((value) => !Number.isFinite(value))) {
+        throw new Error(`${label} must contain finite numbers`);
+    }
+    return values;
+}
+function stableName(value) {
+    return value.replace(/[^A-Za-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'unnamed';
+}
+/**
+ * Aerial-photogrammetry OBJs (Helsinki's reality mesh included) ship `f v/vt` faces with no
+ * `vn` at all. Neither the glTF 2.0 spec's "compute flat normals" fallback nor three.js's
+ * GLTFLoader actually run when NORMAL is omitted from a primitive, so skipping the attribute
+ * left every face lit by whatever the shader's uninitialized default normal happened to be —
+ * rendering as a field of black/garbled shards instead of the source geometry. Each triangle
+ * here is already unshared per-vertex (no index reuse), so per-triangle flat normals are exact.
+ */
+function computeFlatNormals(positions) {
+    const normals = new Array(positions.length);
+    for (let i = 0; i < positions.length; i += 9) {
+        const [ax, ay, az, bx, by, bz, cx, cy, cz] = positions.slice(i, i + 9);
+        const ux = bx - ax, uy = by - ay, uz = bz - az;
+        const vx = cx - ax, vy = cy - ay, vz = cz - az;
+        let nx = uy * vz - uz * vy;
+        let ny = uz * vx - ux * vz;
+        let nz = ux * vy - uy * vx;
+        const length = Math.hypot(nx, ny, nz) || 1;
+        nx /= length;
+        ny /= length;
+        nz /= length;
+        for (let vertex = 0; vertex < 3; vertex++) {
+            normals[i + vertex * 3] = nx;
+            normals[i + vertex * 3 + 1] = ny;
+            normals[i + vertex * 3 + 2] = nz;
+        }
+    }
+    return normals;
+}
+//# sourceMappingURL=obj.js.map

package/dist/sceneImport/obj.js.map

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

package/dist/sceneImport/package.d.ts

@@ -0,0 +1,104 @@
+import { type HelixSceneV2 } from '@hypersoniclabs/helix-manifest';
+import { type ProxyReduction } from './proxy';
+import type { Bounds, CompiledSceneArtifact, SourceConversionReceipt, Vec3 } from './types';
+/**
+ * The World-build endpoint's multipart limits, taken from the shared contract
+ * rather than re-typed here: a package can sit under the aggregate cap and
+ * still be refused for a single oversized resource, so both are checked before
+ * anything is uploaded, and a copied number would let the CLI reject packages
+ * the server accepts (or worse, the reverse).
+ */
+export declare const SCENE_V2_PACKAGE_MAX_BYTES: number;
+export declare const SCENE_V2_RESOURCE_MAX_BYTES: number;
+/** One member of the bundle is the scene document itself; the rest are resources. */
+export declare const SCENE_V2_RESOURCE_MAX_FILES: number;
+export declare function createSceneV2Package(input: {
+    outputDir: string;
+    title: string;
+    sourceId: string;
+    /**
+     * Optional: a proxy is only supplied when it measurably beat the detail (see
+     * proxy.ts). Absent, the node declares a single-level `only-available` LOD and
+     * the collider falls back to the detail GLB rather than dangling.
+     */
+    proxy?: CompiledSceneArtifact;
+    detail: CompiledSceneArtifact;
+    bounds: Bounds;
+    receipt: SourceConversionReceipt;
+}): Promise<{
+    scenePath: string;
+    receiptPath: string;
+    resourcePaths: string[];
+    totalBytes: number;
+    scene: HelixSceneV2;
+}>;
+/**
+ * A short write is the realistic partial-failure mode and it does not throw:
+ * `writeFile` resolving says nothing about how many bytes reached the disk.
+ * Refuse to promote a staged member whose on-disk size disagrees with what the
+ * receipt and Scene document already claim about it.
+ */
+export declare function assertStagedPackageMembers(stagingDir: string, members: ReadonlyArray<readonly [string, number]>): Promise<void>;
+export declare function assertEmptySceneOutput(outputDir: string): Promise<void>;
+/**
+ * A Scene v2 package built from N individually placed asset instances instead
+ * of one baked environment mesh.
+ *
+ * Every placed instance becomes its own node carrying its own detail/proxy LOD
+ * pair and its own real transform, so the runtime streams, swaps and culls it
+ * independently. Identical meshes compile once and share their resources by
+ * content-hash dedup. Instances cluster into ground-plane grid cells inside
+ * 'distance'-mode stream groups (planStreamLayout), collision rides one proxy
+ * set per group so streamed content carries its own colliders, and the profile
+ * memory budget covers the validator's residency union honestly.
+ */
+export type MultiAssetPlacementInput = {
+    name: string;
+    transform: {
+        position: Vec3;
+        rotation: [number, number, number, number];
+        scale: Vec3;
+    };
+    /** World-space bounds after the transform, used for cells, LOD ranges and spawn. */
+    worldBounds: Bounds;
+    /** Content-hash key into `resources` for this instance's detail GLB. */
+    detailResourceKey: string;
+    /** Content-hash key into `resources` for this instance's proxy/collider GLB. */
+    proxyResourceKey: string;
+};
+export type MultiAssetSpawn = {
+    position: Vec3;
+    groundY: number;
+    rejectedCandidates: number;
+};
+export declare function createSceneV2MultiAssetPackage(input: {
+    outputDir: string;
+    title: string;
+    sourceId: string;
+    receipt: SourceConversionReceipt;
+    placements: ReadonlyArray<MultiAssetPlacementInput>;
+    /**
+     * One entry per UNIQUE mesh, keyed by content-hash resource key. `proxy` is
+     * absent for every mesh whose proxy did not measurably beat its detail (see
+     * proxy.ts): those meshes declare a single-level LOD and cost ONE file, not two.
+     */
+    resources: ReadonlyMap<string, {
+        detail: CompiledSceneArtifact;
+        proxy?: CompiledSceneArtifact;
+    }>;
+    cellSizeM?: number;
+    /**
+     * Per-mesh proxy before/after, recorded in the compile receipt. The measurement
+     * that decided each keep/drop is evidence, not a debug print: a proxy that
+     * silently failed to reduce is exactly the defect this ledger exists to expose.
+     */
+    proxyReductions?: readonly ProxyReduction[];
+    /** Cross-asset probe result; falls back to the top of the placement bounds when absent. */
+    spawn?: MultiAssetSpawn;
+}): Promise<{
+    scenePath: string;
+    receiptPath: string;
+    resourcePaths: string[];
+    totalBytes: number;
+    scene: HelixSceneV2;
+}>;