@hypersoniclabs/helix-cli 0.1.27-helix3.538 → 0.1.27-helix3.539

package/dist/city/colliders/apply.d.ts

@@ -0,0 +1,34 @@
+import { type BuildingColliderOptions } from './buildingBoxes';
+import { type DeckColliderOptions } from './deckColliders';
+export interface PrefixSource {
+    read(path: string): Promise<Uint8Array>;
+    readRange(path: string, offset: number, length: number): Promise<Uint8Array>;
+}
+export declare function prefixSource(base: string): PrefixSource;
+/** A 1 m unit cube centred on the origin: the one mesh every building box scales, rotates and places. */
+export declare function unitBoxGlb(): Promise<Uint8Array>;
+export interface ApplyOptions {
+    source: PrefixSource;
+    /** The root's folder name under `scene/`. */
+    rootName: string;
+    /** The folder name the new root is written as. */
+    newRootName: string;
+    buildings: Partial<BuildingColliderOptions> & {
+        enabled: boolean;
+    };
+    decks: Partial<DeckColliderOptions> & {
+        enabled: boolean;
+        roadCellM: number;
+    };
+    log: (message: string) => void;
+    concurrency?: number;
+}
+export interface ApplyResult {
+    files: Array<{
+        path: string;
+        bytes: Uint8Array;
+    }>;
+    report: Record<string, unknown>;
+}
+export declare function applyColliders(options: ApplyOptions): Promise<ApplyResult>;
+export declare function writeFiles(out: string, files: ApplyResult['files']): Promise<void>;

package/dist/city/colliders/apply.js

@@ -0,0 +1,167 @@
+"use strict";
+// `helix city colliders apply`: completes the collision of a published city Scene without touching the data it ships.
+//
+//   - elevated decks, ramps and rails: additional collider cells from the render tier (deckColliders.ts)
+//   - buildings: a collider-only child Scene of oriented boxes (buildingBoxes.ts), mounted by the root
+//
+// Reads the root and everything it needs from a data prefix (an https origin or a folder) and writes ONLY the new objects,
+// in the prefix's own layout, to --out: the new root folder (the old root's document, resealed, plus its pin), the new
+// deck-collider cells beside it, and the child Scene's folder. Everything else the new root points at is referenced by the same
+// relative paths, so uploading --out next to a copy of the old root folder is the whole publication.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prefixSource = prefixSource;
+exports.unitBoxGlb = unitBoxGlb;
+exports.applyColliders = applyColliders;
+exports.writeFiles = writeFiles;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const node_crypto_1 = require("node:crypto");
+const core_1 = require("@gltf-transform/core");
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const glbBounds_1 = require("./glbBounds");
+const buildingBoxes_1 = require("./buildingBoxes");
+const deckColliders_1 = require("./deckColliders");
+function prefixSource(base) {
+    if (/^https?:\/\//.test(base)) {
+        const url = (path) => `${base.replace(/\/$/, '')}/${path}`;
+        const headers = { 'user-agent': 'Mozilla/5.0 helix-cli' };
+        const get = async (path, extra = {}) => {
+            for (let attempt = 0;; attempt += 1) {
+                try {
+                    const response = await fetch(url(path), { headers: { ...headers, ...extra } });
+                    if (!response.ok && response.status !== 206)
+                        throw new Error(`${response.status} ${url(path)}`);
+                    return new Uint8Array(await response.arrayBuffer());
+                }
+                catch (error) {
+                    if (attempt >= 4)
+                        throw error;
+                    await new Promise((r) => setTimeout(r, 500 * (attempt + 1)));
+                }
+            }
+        };
+        return { read: (path) => get(path), readRange: (path, offset, length) => get(path, { range: `bytes=${offset}-${offset + length - 1}` }) };
+    }
+    return {
+        read: async (path) => new Uint8Array(await (0, promises_1.readFile)((0, node_path_1.join)(base, path))),
+        readRange: async (path, offset, length) => new Uint8Array((await (0, promises_1.readFile)((0, node_path_1.join)(base, path))).subarray(offset, offset + length)),
+    };
+}
+/** A 1 m unit cube centred on the origin: the one mesh every building box scales, rotates and places. */
+async function unitBoxGlb() {
+    const document = new core_1.Document();
+    const buffer = document.createBuffer();
+    const h = 0.5;
+    const corners = [[-h, -h, -h], [h, -h, -h], [h, h, -h], [-h, h, -h], [-h, -h, h], [h, -h, h], [h, h, h], [-h, h, h]].flat();
+    // Counter-clockwise outward faces.
+    const quads = [[0, 3, 2, 1], [4, 5, 6, 7], [0, 1, 5, 4], [3, 7, 6, 2], [0, 4, 7, 3], [1, 2, 6, 5]];
+    const indices = quads.flatMap(([a, b, c, d]) => [a, b, c, a, c, d]);
+    const position = document.createAccessor().setType('VEC3').setArray(new Float32Array(corners)).setBuffer(buffer);
+    const index = document.createAccessor().setType('SCALAR').setArray(new Uint16Array(indices)).setBuffer(buffer);
+    const mesh = document.createMesh('unit-box').addPrimitive(document.createPrimitive().setAttribute('POSITION', position).setIndices(index));
+    document.createScene('unit-box').addChild(document.createNode('unit-box').setMesh(mesh));
+    return new core_1.NodeIO().writeBinary(document);
+}
+const sha256 = (bytes) => (0, node_crypto_1.createHash)('sha256').update(bytes).digest('hex');
+const json = (value) => new TextEncoder().encode(JSON.stringify(value));
+async function pool(items, size, work) {
+    const out = new Array(items.length);
+    let next = 0;
+    await Promise.all(Array.from({ length: Math.min(size, items.length) }, async () => {
+        for (let at = next++; at < items.length; at = next++)
+            out[at] = await work(items[at]);
+    }));
+    return out;
+}
+async function applyColliders(options) {
+    const { source, log } = options;
+    const concurrency = options.concurrency ?? 24;
+    const rootPath = `scene/${options.rootName}/scene.helix-scene.json`;
+    const root = JSON.parse(new TextDecoder().decode(await source.read(rootPath)));
+    const files = [];
+    const report = { root: options.rootName, newRoot: options.newRootName, rootRevision: root.revision };
+    let next = root;
+    if (options.decks.enabled) {
+        const resources = root.resources.filter((resource) => resource.kind === 'model' || resource.kind === 'collider');
+        const under = (dir) => resources.map((resource) => resource.source.uri ?? '').filter((uri) => uri.startsWith(dir)).sort();
+        const roads = {
+            cellSizeM: options.decks.roadCellM,
+            originX: root.terrain.kind === 'heightfield' ? root.terrain.grid.originX : 0,
+            originZ: root.terrain.kind === 'heightfield' ? root.terrain.grid.originZ : 0,
+            render: under('roads/render/'),
+            collision: under('roads/collider/'),
+            read: (path) => source.read(`scene/${options.rootName}/${path}`),
+        };
+        log(`decks: ${roads.render.length} render cells, ${roads.collision.length} collider cells, origin ${roads.originX},${roads.originZ}, cell ${roads.cellSizeM} m`);
+        const { cells, report: deck } = await (0, deckColliders_1.buildDeckColliders)(roads, { ...options.decks, log });
+        for (const cell of cells)
+            files.push({ path: `scene/${options.newRootName}/roads/${cell.file}`, bytes: cell.bytes });
+        next = (0, deckColliders_1.patchSceneDeckColliders)(next, cells, 'roads').scene;
+        report.decks = deck;
+    }
+    if (options.buildings.enabled) {
+        const mountIds = (next.mounts ?? []).map((mount) => mount);
+        const parts = [];
+        const boundsBySha = new Map();
+        for (const mount of mountIds) {
+            const folder = `scene/${mount.integrity.sha256}`;
+            const part = JSON.parse(new TextDecoder().decode(await source.read(`${folder}/scene.helix-scene.json`)));
+            const wanted = part.nodes.filter((node) => node.resource && node.components?.some((c) => c.type === 'render.mesh')).map((node) => node.resource);
+            const resourceIds = [...new Set(wanted)];
+            const byId = new Map(part.resources.map((resource) => [resource.id, resource]));
+            const bounds = new Map();
+            await pool(resourceIds, concurrency, async (id) => {
+                const resource = byId.get(id);
+                const uri = resource?.source?.uri;
+                if (!resource || !uri || resource.kind !== 'model')
+                    return;
+                const key = `${resource.integrity.sha256}`;
+                let box = boundsBySha.get(key);
+                if (!box) {
+                    box = await (0, glbBounds_1.glbBounds)((offset, length) => source.readRange(`${folder}/${uri}`, offset, length));
+                    boundsBySha.set(key, box);
+                }
+                bounds.set(id, box);
+            });
+            log(`buildings: mount ${mount.id} -> ${part.nodes.length} nodes, ${bounds.size}/${resourceIds.length} model bounds`);
+            parts.push({ part, bounds });
+        }
+        const unit = await unitBoxGlb();
+        const unitSha = sha256(unit);
+        const unitUri = `colliders/unit-box.${unitSha.slice(0, 16)}.glb`;
+        const planOptions = { ...buildingBoxes_1.DEFAULT_BUILDING_COLLIDER_OPTIONS, ...options.buildings };
+        const { boxes, stats } = (0, buildingBoxes_1.planBuildingBoxes)(parts, planOptions);
+        const { scene: childUnsealed, stats: sets } = (0, buildingBoxes_1.buildColliderScene)(boxes, {
+            ...planOptions, unitBox: { sha256: unitSha, bytes: unit.length, uri: unitUri }, adapters: root.adapters,
+        });
+        const child = (0, buildingBoxes_1.sealScene)(childUnsealed);
+        const checked = (0, helix_manifest_1.validateSceneDocument)(child);
+        if (!checked.valid)
+            throw new Error(`the collider child does not validate: ${checked.errors.slice(0, 5).join('; ')}`);
+        const childBytes = json(child);
+        files.push({ path: `scene/${child.integrity.sha256}/scene.helix-scene.json`, bytes: childBytes });
+        files.push({ path: `scene/${child.integrity.sha256}/${unitUri}`, bytes: unit });
+        next = (0, buildingBoxes_1.mountColliderChild)(next, child);
+        report.buildings = { ...stats, ...sets, childSha256: child.integrity.sha256, childBytes: childBytes.length, unitBox: buildingBoxes_1.UNIT_BOX_RESOURCE_ID, streamRadiusM: planOptions.streamRadiusM };
+    }
+    next = (0, buildingBoxes_1.sealScene)(next);
+    const checked = (0, helix_manifest_1.validateSceneDocument)(next);
+    if (!checked.valid)
+        throw new Error(`the patched root does not validate: ${checked.errors.slice(0, 5).join('; ')}`);
+    const rootBytes = json(next);
+    files.push({ path: `scene/${options.newRootName}/scene.helix-scene.json`, bytes: rootBytes });
+    const pinOld = JSON.parse(new TextDecoder().decode(await source.read(`scene/${options.rootName}/pin.json`)));
+    files.push({ path: `scene/${options.newRootName}/pin.json`, bytes: json({ ...pinOld, revision: next.revision, integrity: { sha256: next.integrity.sha256 } }) });
+    report.newRootRevision = next.revision;
+    report.newRootSha256 = next.integrity.sha256;
+    report.newRootBytes = rootBytes.length;
+    return { files, report };
+}
+async function writeFiles(out, files) {
+    for (const file of files) {
+        const target = (0, node_path_1.join)(out, file.path);
+        await (0, promises_1.mkdir)((0, node_path_1.dirname)(target), { recursive: true });
+        await (0, promises_1.writeFile)(target, file.bytes);
+    }
+}
+//# sourceMappingURL=apply.js.map

package/dist/city/colliders/apply.js.map

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

package/dist/city/colliders/buildingBoxes.d.ts

@@ -0,0 +1,71 @@
+import type { HelixSceneV2, SceneNode } from '@hypersoniclabs/helix-manifest';
+import type { Box3 } from './glbBounds';
+export declare const COLLIDER_CHILD_ID = "scene.city.building-colliders";
+export declare const UNIT_BOX_RESOURCE_ID = "res.collider.unit-box";
+export interface BuildingColliderOptions {
+    /** Metres around the player within which colliders are resident (the child's `streamRadiusM`). */
+    streamRadiusM: number;
+    /** Buildings per spatial block (one collision set, one stream group). Raised when the city would need more than `maxSets`. */
+    buildingsPerBlock: number;
+    maxSets: number;
+    /** Models smaller than this (footprint m2, or height m) are props, not buildings, and are left non-solid. */
+    minFootprintM2: number;
+    minHeightM: number;
+    /** The unit cube collider resource, already hashed and addressed by the caller. */
+    unitBox: {
+        sha256: string;
+        bytes: number;
+        uri: string;
+    };
+    adapters: HelixSceneV2['adapters'];
+    title?: string;
+    /** Skip instances whose resource id starts with one of these (e.g. trees) - rarely needed; models carry the filter in their bounds. */
+    skipResource?: (resourceId: string) => boolean;
+}
+export declare const DEFAULT_BUILDING_COLLIDER_OPTIONS: Readonly<{
+    streamRadiusM: 120;
+    buildingsPerBlock: 60;
+    maxSets: 240;
+    minFootprintM2: 4;
+    minHeightM: 2;
+}>;
+export interface PlannedBox {
+    id: string;
+    position: [number, number, number];
+    rotation: [number, number, number, number];
+    scale: [number, number, number];
+    /** World AABB of the oriented box. */
+    min: [number, number, number];
+    max: [number, number, number];
+    source: string;
+}
+export interface BoxPlanStats {
+    instances: number;
+    boxes: number;
+    skippedSmall: number;
+    skippedNoBounds: number;
+    sets: number;
+    maxPerSet: number;
+}
+/** The box of one placed model: the node's transform applied to the model's local AABB. */
+export declare function boxOfNode(node: SceneNode, bounds: Box3, id: string): PlannedBox;
+/** Median-split the boxes on the longer horizontal side until each block holds at most `perBlock`. */
+export declare function splitBlocks(boxes: readonly PlannedBox[], perBlock: number): PlannedBox[][];
+export declare function planBuildingBoxes(parts: ReadonlyArray<{
+    part: HelixSceneV2;
+    bounds: ReadonlyMap<string, Box3>;
+}>, options: Pick<BuildingColliderOptions, 'minFootprintM2' | 'minHeightM' | 'skipResource'>): {
+    boxes: PlannedBox[];
+    stats: Pick<BoxPlanStats, 'instances' | 'boxes' | 'skippedSmall' | 'skippedNoBounds'>;
+};
+export declare function buildColliderScene(boxes: readonly PlannedBox[], options: BuildingColliderOptions): {
+    scene: HelixSceneV2;
+    stats: BoxPlanStats;
+};
+/** The sealing order every Scene v2 builder uses: revision = first 16 hex of the digest with revision and integrity zeroed. */
+export declare function sealScene<T extends HelixSceneV2>(scene: T): T;
+/**
+ * Mounts the collider child in a root document: the mount definition, the node that places it in the root's eager city group
+ * (so it is resident whenever the city is), and the group's declared memory. Returns a new, resealed root.
+ */
+export declare function mountColliderChild(root: HelixSceneV2, child: HelixSceneV2, budgetMiB?: number): HelixSceneV2;

package/dist/city/colliders/buildingBoxes.js

@@ -0,0 +1,214 @@
+"use strict";
+// Solid buildings for a city whose buildings are instanced models (a CS2 capture, any `granit-city` style composition): one
+// oriented box per instance, taken from the model's own bounding box, carried as a small collider-only child Scene that the
+// root mounts. The child exists because a Scene v2 document may carry 256 collision sets and a set belongs to exactly one
+// node, while a stream group's reach is the profile's radius: a mounted child has its OWN profile, so the physics radius
+// (colliders live 120 m around the player) is decoupled from the visual one (a kilometre of skyline) and phone memory and CPU
+// stay flat however large the city is. Colliders are streamed in spatial blocks of ~60 buildings.
+//
+// A box is a `convex` collider over one shared unit-cube collider resource with a per-collider transform
+// (position, rotation, scale), so a building is ~150 bytes of JSON and no per-building geometry exists anywhere.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_BUILDING_COLLIDER_OPTIONS = exports.UNIT_BOX_RESOURCE_ID = exports.COLLIDER_CHILD_ID = void 0;
+exports.boxOfNode = boxOfNode;
+exports.splitBlocks = splitBlocks;
+exports.planBuildingBoxes = planBuildingBoxes;
+exports.buildColliderScene = buildColliderScene;
+exports.sealScene = sealScene;
+exports.mountColliderChild = mountColliderChild;
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+exports.COLLIDER_CHILD_ID = 'scene.city.building-colliders';
+exports.UNIT_BOX_RESOURCE_ID = 'res.collider.unit-box';
+exports.DEFAULT_BUILDING_COLLIDER_OPTIONS = Object.freeze({
+    streamRadiusM: 120,
+    buildingsPerBlock: 60,
+    maxSets: 240,
+    minFootprintM2: 4,
+    minHeightM: 2,
+});
+const round = (value, places) => Math.round(value * 10 ** places) / 10 ** places;
+function rotate(q, v) {
+    const [x, y, z, w] = q;
+    const tx = 2 * (y * v[2] - z * v[1]);
+    const ty = 2 * (z * v[0] - x * v[2]);
+    const tz = 2 * (x * v[1] - y * v[0]);
+    return [v[0] + w * tx + (y * tz - z * ty), v[1] + w * ty + (z * tx - x * tz), v[2] + w * tz + (x * ty - y * tx)];
+}
+/** The box of one placed model: the node's transform applied to the model's local AABB. */
+function boxOfNode(node, bounds, id) {
+    if (node.parent)
+        throw new Error(`building colliders: node ${node.id} has a parent; instanced buildings are expected to be root nodes`);
+    const { position: t, rotation: q, scale: s } = node.transform;
+    const size = [0, 1, 2].map((axis) => bounds.max[axis] - bounds.min[axis]);
+    const centre = [0, 1, 2].map((axis) => (bounds.max[axis] + bounds.min[axis]) / 2);
+    const scaledCentre = centre.map((value, axis) => value * s[axis]);
+    const offset = rotate(q, scaledCentre);
+    const position = [t[0] + offset[0], t[1] + offset[1], t[2] + offset[2]];
+    const scale = [Math.abs(size[0] * s[0]), Math.abs(size[1] * s[1]), Math.abs(size[2] * s[2])];
+    // World AABB from the eight corners.
+    const min = [Infinity, Infinity, Infinity];
+    const max = [-Infinity, -Infinity, -Infinity];
+    for (const sx of [-0.5, 0.5])
+        for (const sy of [-0.5, 0.5])
+            for (const sz of [-0.5, 0.5]) {
+                const corner = rotate(q, [sx * scale[0], sy * scale[1], sz * scale[2]]);
+                for (let axis = 0; axis < 3; axis += 1) {
+                    const v = position[axis] + corner[axis];
+                    if (v < min[axis])
+                        min[axis] = v;
+                    if (v > max[axis])
+                        max[axis] = v;
+                }
+            }
+    return {
+        id, source: node.id,
+        position: position.map((v) => round(v, 3)),
+        rotation: [round(q[0], 6), round(q[1], 6), round(q[2], 6), round(q[3], 6)],
+        scale: scale.map((v) => round(v, 3)),
+        min, max,
+    };
+}
+/** Median-split the boxes on the longer horizontal side until each block holds at most `perBlock`. */
+function splitBlocks(boxes, perBlock) {
+    const blocks = [];
+    const split = (group) => {
+        if (group.length <= perBlock) {
+            blocks.push(group);
+            return;
+        }
+        let lox = Infinity, hix = -Infinity, loz = Infinity, hiz = -Infinity;
+        for (const box of group) {
+            lox = Math.min(lox, box.position[0]);
+            hix = Math.max(hix, box.position[0]);
+            loz = Math.min(loz, box.position[2]);
+            hiz = Math.max(hiz, box.position[2]);
+        }
+        const axis = hix - lox >= hiz - loz ? 0 : 2;
+        const sorted = [...group].sort((a, b) => a.position[axis] - b.position[axis] || (a.id < b.id ? -1 : 1));
+        const half = sorted.length >> 1;
+        split(sorted.slice(0, half));
+        split(sorted.slice(half));
+    };
+    if (boxes.length)
+        split([...boxes]);
+    return blocks;
+}
+function planBuildingBoxes(parts, options) {
+    const boxes = [];
+    let instances = 0, skippedSmall = 0, skippedNoBounds = 0;
+    parts.forEach(({ part, bounds }, partIndex) => {
+        for (const node of part.nodes) {
+            if (!node.resource || !node.components?.some((component) => component.type === 'render.mesh'))
+                continue;
+            if (options.skipResource?.(node.resource))
+                continue;
+            instances += 1;
+            const local = bounds.get(node.resource);
+            if (!local) {
+                skippedNoBounds += 1;
+                continue;
+            }
+            const box = boxOfNode(node, local, `p${partIndex}.${node.id.replace(/^node\./, '')}`);
+            const footprint = box.scale[0] * box.scale[2];
+            if (footprint < options.minFootprintM2 || box.scale[1] < options.minHeightM) {
+                skippedSmall += 1;
+                continue;
+            }
+            boxes.push(box);
+        }
+    });
+    return { boxes, stats: { instances, boxes: boxes.length, skippedSmall, skippedNoBounds } };
+}
+const IDENTITY = { position: [0, 0, 0], rotation: [0, 0, 0, 1], scale: [1, 1, 1] };
+function buildColliderScene(boxes, options) {
+    const perBlock = Math.max(options.buildingsPerBlock, Math.ceil(boxes.length / options.maxSets));
+    const blocks = splitBlocks(boxes, perBlock);
+    const nodes = [];
+    const groups = [];
+    const sets = [];
+    let lo = [Infinity, Infinity, Infinity];
+    let hi = [-Infinity, -Infinity, -Infinity];
+    blocks.forEach((block, index) => {
+        const bmin = [Infinity, Infinity, Infinity];
+        const bmax = [-Infinity, -Infinity, -Infinity];
+        for (const box of block)
+            for (let axis = 0; axis < 3; axis += 1) {
+                bmin[axis] = Math.min(bmin[axis], box.min[axis]);
+                bmax[axis] = Math.max(bmax[axis], box.max[axis]);
+            }
+        lo = lo.map((v, axis) => Math.min(v, bmin[axis]));
+        hi = hi.map((v, axis) => Math.max(v, bmax[axis]));
+        const node = `bc.n.${index}`, group = `bc.g.${index}`, set = `bc.s.${index}`;
+        nodes.push({ id: node, transform: { ...IDENTITY }, streamGroup: group, components: [{ type: 'collision.proxy-set', set }] });
+        groups.push({
+            id: group, mode: 'distance', priority: 50, dependencies: [], estimatedMemoryMiB: 1,
+            cells: [{ id: `bc.c.${index}`, bounds: { min: bmin.map((v) => round(v, 2)), max: bmax.map((v) => round(v, 2)) }, nodes: [node] }],
+        });
+        sets.push({
+            id: set, node,
+            static: block.map((box) => ({
+                id: `bc.${box.id}`, shape: 'convex', resource: exports.UNIT_BOX_RESOURCE_ID,
+                transform: { position: box.position, rotation: box.rotation, scale: box.scale },
+            })),
+        });
+    });
+    if (!blocks.length)
+        throw new Error('building colliders: no instance produced a box');
+    const pad = options.streamRadiusM;
+    const scene = {
+        format: 'helix.scene', version: 2, id: exports.COLLIDER_CHILD_ID, revision: '0'.repeat(16), integrity: { sha256: '0'.repeat(64) },
+        title: options.title ?? 'City building colliders',
+        units: 'meters', coordinateSystem: { handedness: 'right', up: '+Y', forward: '-Z' },
+        profiles: {
+            world: {
+                scene: 'scene.root', kind: 'world', persistence: 'session', maxPlayers: 32, overrideAuthority: 'none',
+                runtimePolicy: { memoryBudgetMiB: 32, streamRadiusM: options.streamRadiusM, allowSurfaceOverrides: false, allowItemPlacement: false },
+            },
+        },
+        scenes: [{ id: 'scene.root', nodes: nodes.map((node) => node.id), streamGroups: groups.map((group) => group.id) }],
+        resources: [{
+                id: exports.UNIT_BOX_RESOURCE_ID, kind: 'collider', source: { kind: 'bundle', assetId: `colliders:unit-box:${options.unitBox.sha256}`, uri: options.unitBox.uri },
+                integrity: { sha256: options.unitBox.sha256 }, bytes: options.unitBox.bytes, mimeType: 'model/gltf-binary', required: true,
+            }],
+        nodes, itemDefinitions: [], itemInstances: [], terrain: { kind: 'none' },
+        environment: { background: false, intensityScale: 1, rotationYDeg: 0, exposureEV100: 0, fallbackColor: '#20242b', required: false },
+        lights: [],
+        spawns: [{ id: 'spawn.main', position: [round((lo[0] + hi[0]) / 2, 2), round(hi[1] + 1, 2), round((lo[2] + hi[2]) / 2, 2)], rotation: [0, 0, 0, 1], profileAccess: ['world'], clearanceRadiusM: 0.45, clearanceHeightM: 1.9 }],
+        collision: { sets },
+        navigation: { walkableSurfaces: [], agent: { radiusM: 0.35, heightM: 1.8, stepHeightM: 0.32, maxSlopeDeg: 48 }, navmesh: null, fallback: 'physics-walkability' },
+        placement: { bounds: { min: lo.map((v) => round(v - pad, 1)), max: hi.map((v) => round(v + pad, 1)) }, maxItemInstances: 0, snapGridM: 0.05, allowedProfiles: ['world'] },
+        surfaces: [], materials: [], behaviors: [], streamGroups: groups,
+        capabilities: { required: ['helix.scene-collision/1'], optional: [] }, runtimeExtensions: [], adapters: options.adapters,
+    };
+    return { scene, stats: { instances: boxes.length, boxes: boxes.length, skippedSmall: 0, skippedNoBounds: 0, sets: sets.length, maxPerSet: Math.max(...blocks.map((block) => block.length)) } };
+}
+/** The sealing order every Scene v2 builder uses: revision = first 16 hex of the digest with revision and integrity zeroed. */
+function sealScene(scene) {
+    scene.revision = '0'.repeat(16);
+    scene.integrity = { sha256: '0'.repeat(64) };
+    const digest = (0, helix_manifest_1.computeSceneDocumentIntegrity)(scene);
+    scene.revision = digest.slice(0, 16);
+    scene.integrity = { sha256: (0, helix_manifest_1.computeSceneDocumentIntegrity)(scene) };
+    return scene;
+}
+/**
+ * Mounts the collider child in a root document: the mount definition, the node that places it in the root's eager city group
+ * (so it is resident whenever the city is), and the group's declared memory. Returns a new, resealed root.
+ */
+function mountColliderChild(root, child, budgetMiB = 32) {
+    const next = structuredClone(root);
+    const mountId = 'mount.city.colliders', nodeId = 'node.city.colliders';
+    if (next.mounts?.some((mount) => mount.id === mountId))
+        throw new Error('the root already mounts the city colliders');
+    const group = next.streamGroups.find((candidate) => next.nodes.some((node) => node.streamGroup === candidate.id && node.components?.some((c) => c.type === 'scene.mount')));
+    if (!group)
+        throw new Error('the root has no stream group that places mounts');
+    const mount = { id: mountId, scene: { id: child.id, revision: child.revision }, integrity: { sha256: child.integrity.sha256 }, profile: 'world', budgetMiB, depth: 0 };
+    next.mounts = [...(next.mounts ?? []), mount];
+    next.nodes.push({ id: nodeId, streamGroup: group.id, transform: { ...IDENTITY }, components: [{ type: 'scene.mount', mount: mountId }] });
+    group.cells[0].nodes.push(nodeId);
+    group.estimatedMemoryMiB += budgetMiB;
+    next.scenes[0].nodes.push(nodeId);
+    return sealScene(next);
+}
+//# sourceMappingURL=buildingBoxes.js.map

package/dist/city/colliders/buildingBoxes.js.map

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

package/dist/city/colliders/command.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerCityColliders(city: Command, fail: (message: string) => never): void;

package/dist/city/colliders/command.js

@@ -0,0 +1,46 @@
+"use strict";
+// `helix city colliders apply`.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCityColliders = registerCityColliders;
+const node_path_1 = require("node:path");
+const apply_1 = require("./apply");
+function registerCityColliders(city, fail) {
+    const colliders = city
+        .command('colliders')
+        .description('Complete the collision of a published city Scene: collider cells for elevated decks, ramps and rails, and a collider-only child Scene of building boxes');
+    colliders
+        .command('apply')
+        .description('Read a published city root from a data prefix (https origin or folder) and write the new objects (resealed root, deck-collider cells, building-box child Scene) to --out')
+        .requiredOption('--source <prefix>', 'data prefix holding scene/<root>/ (https origin or folder)')
+        .requiredOption('--root <name>', 'the root Scene folder under scene/ to complete')
+        .requiredOption('--new-root <name>', 'the folder name the completed root is written as')
+        .requiredOption('--out <dir>', 'output folder (mirrors the prefix layout)')
+        .option('--road-cell <m>', 'road render/collider cell size in metres', '1024')
+        .option('--no-decks', 'skip the elevated-deck collider cells')
+        .option('--no-buildings', 'skip the building-box child Scene')
+        .option('--stream-radius <m>', 'physics radius of the building colliders in metres', '120')
+        .option('--per-block <n>', 'buildings per collider set', '60')
+        .option('--json', 'print the report as JSON')
+        .action(async (opts) => {
+        try {
+            const roadCellM = Number(opts.roadCell);
+            const streamRadiusM = Number(opts.streamRadius);
+            const buildingsPerBlock = Number(opts.perBlock);
+            if (!(roadCellM > 0) || !(streamRadiusM > 0) || !(Number.isInteger(buildingsPerBlock) && buildingsPerBlock >= 1))
+                fail('✖ --road-cell, --stream-radius and --per-block must be positive numbers');
+            const source = /^https?:\/\//.test(opts.source) ? opts.source : (0, node_path_1.resolve)(opts.source);
+            const result = await (0, apply_1.applyColliders)({
+                source: (0, apply_1.prefixSource)(source), rootName: opts.root, newRootName: opts.newRoot,
+                buildings: { enabled: opts.buildings, streamRadiusM, buildingsPerBlock },
+                decks: { enabled: opts.decks, roadCellM },
+                log: (message) => console.error(message),
+            });
+            await (0, apply_1.writeFiles)((0, node_path_1.resolve)(opts.out), result.files);
+            console.log(opts.json ? JSON.stringify(result.report, null, 2) : `✔ ${result.files.length} files written to ${opts.out}\n${JSON.stringify(result.report, null, 2)}`);
+        }
+        catch (err) {
+            fail(`✖ ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+}
+//# sourceMappingURL=command.js.map

package/dist/city/colliders/command.js.map

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