@hypersoniclabs/helix-cli 0.1.7 → 0.1.23

package/dist/sceneImport/semantic.js

@@ -0,0 +1,296 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SOURCE_SCENE_IMPORT_BUDGETS = exports.NATIVE_SCENE_CONVERSION_CONFIDENCE = void 0;
+exports.importSourceSceneMap = importSourceSceneMap;
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const materials_1 = require("./materials");
+exports.NATIVE_SCENE_CONVERSION_CONFIDENCE = 0.95;
+exports.SOURCE_SCENE_IMPORT_BUDGETS = {
+    actors: 20_000,
+    materials: 4_096,
+    materialSlotsPerActor: 64,
+    totalMaterialSlots: 100_000,
+    hierarchyDepth: 32,
+    stringCharacters: 5_000_000,
+    stringLength: 512,
+    totalInputUnits: 1_000_000,
+};
+const STABLE_ID = /^[A-Za-z0-9][A-Za-z0-9._:-]*$/;
+const CONTAINERS = new Set(['building', 'group', 'level', 'space']);
+function propertiesFor(actor) {
+    const defaultRole = actor.kind === 'space' ? 'interior' : actor.kind === 'building' ? 'exterior' : undefined;
+    const defaultResidency = actor.kind === 'space'
+        ? { mode: 'portal', priority: 40 }
+        : actor.kind === 'building'
+            ? { mode: 'distance', priority: 80 }
+            : undefined;
+    const properties = {
+        ...(actor.role ?? defaultRole ? { role: actor.role ?? defaultRole } : {}),
+        ...(actor.collision !== undefined ? { collision: actor.collision } : {}),
+        ...(actor.residency ?? defaultResidency ? { residency: actor.residency ?? defaultResidency } : {}),
+    };
+    return Object.keys(properties).length ? properties : undefined;
+}
+function materialBindingIds(slots, known) {
+    const result = {};
+    for (const [slot, sourceMaterialId] of Object.entries(slots ?? {}).sort(([a], [b]) => a.localeCompare(b))) {
+        const binding = known.get(sourceMaterialId);
+        if (!binding)
+            throw new Error(`material slot ${slot} references unknown source material "${sourceMaterialId}"`);
+        result[slot] = binding;
+    }
+    return result;
+}
+/**
+ * Convert an already-inventoried source map into the canonical semantic tree.
+ * Classification is deliberately caller-visible: only candidates at or above
+ * the proof threshold become native elements, and even those retain the exact
+ * source mesh as a fallback object when one exists.
+ */
+function importSourceSceneMap(input) {
+    if (input.actors.length > exports.SOURCE_SCENE_IMPORT_BUDGETS.actors)
+        throw new Error(`source map exceeds ${exports.SOURCE_SCENE_IMPORT_BUDGETS.actors} actors`);
+    if (input.materials.length + Object.keys(input.canonicalMaterialPackages).length > exports.SOURCE_SCENE_IMPORT_BUDGETS.materials) {
+        throw new Error(`source map exceeds ${exports.SOURCE_SCENE_IMPORT_BUDGETS.materials} materials`);
+    }
+    let stringCharacters = 0;
+    let totalInputUnits = 0;
+    const pending = [input];
+    const seen = new WeakSet();
+    while (pending.length) {
+        const value = pending.pop();
+        totalInputUnits += 1;
+        if (totalInputUnits > exports.SOURCE_SCENE_IMPORT_BUDGETS.totalInputUnits) {
+            throw new Error(`source map exceeds ${exports.SOURCE_SCENE_IMPORT_BUDGETS.totalInputUnits} total input units`);
+        }
+        if (typeof value === 'string') {
+            if (value.length > exports.SOURCE_SCENE_IMPORT_BUDGETS.stringLength)
+                throw new Error(`source string exceeds ${exports.SOURCE_SCENE_IMPORT_BUDGETS.stringLength} characters`);
+            stringCharacters += value.length;
+            if (stringCharacters > exports.SOURCE_SCENE_IMPORT_BUDGETS.stringCharacters)
+                throw new Error(`source map exceeds ${exports.SOURCE_SCENE_IMPORT_BUDGETS.stringCharacters} string characters`);
+        }
+        else if (value && typeof value === 'object') {
+            if (seen.has(value))
+                continue;
+            seen.add(value);
+            if (Array.isArray(value)) {
+                for (const child of value)
+                    pending.push(child);
+            }
+            else {
+                for (const [key, child] of Object.entries(value)) {
+                    pending.push(key, child);
+                }
+            }
+        }
+    }
+    let totalMaterialSlots = 0;
+    for (const actor of input.actors) {
+        const slots = Object.entries(actor.materialSlots ?? {});
+        if (slots.length > exports.SOURCE_SCENE_IMPORT_BUDGETS.materialSlotsPerActor) {
+            throw new Error(`actor ${actor.id} exceeds ${exports.SOURCE_SCENE_IMPORT_BUDGETS.materialSlotsPerActor} material slots`);
+        }
+        totalMaterialSlots += slots.length;
+    }
+    if (totalMaterialSlots > exports.SOURCE_SCENE_IMPORT_BUDGETS.totalMaterialSlots)
+        throw new Error(`source map exceeds ${exports.SOURCE_SCENE_IMPORT_BUDGETS.totalMaterialSlots} total material slots`);
+    const actorById = new Map();
+    for (const actor of input.actors) {
+        if (!STABLE_ID.test(actor.id))
+            throw new Error(`actor id "${actor.id}" is not stable`);
+        if (actorById.has(actor.id))
+            throw new Error(`duplicate actor id "${actor.id}"`);
+        if (!Number.isFinite(actor.confidence) || actor.confidence < 0 || actor.confidence > 1) {
+            throw new Error(`actor ${actor.id} confidence must be between zero and one`);
+        }
+        actorById.set(actor.id, actor);
+    }
+    for (const actor of input.actors) {
+        if (actor.parentId && !actorById.has(actor.parentId)) {
+            throw new Error(`actor ${actor.id} has unknown parent "${actor.parentId}"`);
+        }
+    }
+    const receipt = {
+        schema: 'helix.creator.scene-import-receipt/1', conversions: [], materials: [],
+    };
+    const bindingIdByMaterial = new Map();
+    const sourceMaterialById = new Map();
+    const materialBindings = [];
+    for (const source of [...input.materials].sort((a, b) => a.id.localeCompare(b.id))) {
+        if (!STABLE_ID.test(source.id))
+            throw new Error(`source material id "${source.id}" is not stable`);
+        if (bindingIdByMaterial.has(source.id))
+            throw new Error(`duplicate source material id "${source.id}"`);
+        const match = (0, materials_1.matchCanonicalMaterial)(source.description, materials_1.HELIX_OFFICIAL_MATERIAL_SUBSET);
+        const canonical = match.material ? input.canonicalMaterialPackages[match.material.id] : undefined;
+        const selected = match.action === 'use-canonical' && canonical ? canonical : source.sourcePackage;
+        const bindingId = `binding.${source.id}`;
+        bindingIdByMaterial.set(source.id, bindingId);
+        sourceMaterialById.set(source.id, source);
+        const canonicalSelected = match.action === 'use-canonical' && Boolean(canonical);
+        const sourceIsPrimary = selected.packageId === source.sourcePackage.packageId &&
+            selected.version === source.sourcePackage.version &&
+            selected.manifestCid === source.sourcePackage.manifestCid;
+        materialBindings.push({
+            id: bindingId,
+            binding: (0, materials_1.createSharedMaterialBinding)({
+                material: selected,
+                slot: source.id,
+                ...(source.binding ?? {}),
+            }),
+            ...(canonicalSelected && !sourceIsPrimary
+                ? {
+                    sourceFallback: (0, materials_1.createSharedMaterialBinding)({
+                        material: source.sourcePackage,
+                        slot: source.id,
+                        ...(source.binding ?? {}),
+                    }),
+                }
+                : {}),
+        });
+        receipt.materials.push({
+            sourceMaterialId: source.id,
+            action: match.action === 'use-canonical' && !canonical ? 'preserve-source' : match.action,
+            confidence: match.confidence,
+            selectedPackageId: selected.packageId,
+            preserveSourceRendition: true,
+            reason: match.action === 'use-canonical' && !canonical
+                ? `Canonical candidate ${match.material?.id ?? 'unknown'} is not pinned; source Package retained.`
+                : match.reason,
+        });
+    }
+    const childActors = new Map();
+    for (const actor of input.actors) {
+        const children = childActors.get(actor.parentId) ?? [];
+        children.push(actor);
+        childActors.set(actor.parentId, children);
+    }
+    for (const children of childActors.values())
+        children.sort((a, b) => a.id.localeCompare(b.id));
+    const roots = childActors.get(undefined) ?? [];
+    if (!roots.length)
+        throw new Error('source map requires at least one root actor');
+    const topological = [];
+    const depths = new Map();
+    const queue = [...roots];
+    roots.forEach((actor) => depths.set(actor.id, 0));
+    for (let cursor = 0; cursor < queue.length; cursor += 1) {
+        const actor = queue[cursor];
+        topological.push(actor);
+        const depth = depths.get(actor.id);
+        for (const child of childActors.get(actor.id) ?? []) {
+            const childDepth = depth + 1;
+            if (childDepth > exports.SOURCE_SCENE_IMPORT_BUDGETS.hierarchyDepth)
+                throw new Error(`source hierarchy exceeds ${exports.SOURCE_SCENE_IMPORT_BUDGETS.hierarchyDepth} levels`);
+            depths.set(child.id, childDepth);
+            queue.push(child);
+        }
+    }
+    if (topological.length !== input.actors.length)
+        throw new Error('source hierarchy contains a cycle');
+    const convert = (actor, children) => {
+        const properties = propertiesFor(actor);
+        if (CONTAINERS.has(actor.kind)) {
+            if (actor.mesh && (!actor.transform || !actor.bounds))
+                throw new Error(`actor ${actor.id} requires transform and bounds to retain its source fallback`);
+            const fallback = actor.mesh ? {
+                object: actor.mesh,
+                transform: actor.transform,
+                bounds: actor.bounds,
+                reason: 'Source container mesh retained while semantic children stream independently.',
+                ...(actor.sourceId ? { sourceId: actor.sourceId } : {}),
+            } : undefined;
+            const element = {
+                id: actor.id,
+                type: actor.kind,
+                ...(properties ? { properties } : {}),
+                ...(actor.transform ? { transform: actor.transform } : {}),
+                ...(fallback ? { sourceFallback: fallback } : {}),
+                children,
+            };
+            receipt.conversions.push({ actorId: actor.id, action: 'container', confidence: actor.confidence, reason: 'Semantic containment is explicit in the source map.', ...(actor.mesh ? { sourceMeshCid: actor.mesh.cid } : {}) });
+            return element;
+        }
+        if (children.length)
+            throw new Error(`non-container actor ${actor.id} cannot own children`);
+        const slots = materialBindingIds(actor.materialSlots, bindingIdByMaterial);
+        const firstBinding = Object.values(slots)[0];
+        const candidate = actor.candidate;
+        const hasTrimSheetBinding = Object.values(actor.materialSlots ?? {}).some((sourceMaterialId) => Boolean(sourceMaterialById.get(sourceMaterialId)?.binding?.trimSheet));
+        const nativeEligible = candidate && actor.confidence >= exports.NATIVE_SCENE_CONVERSION_CONFIDENCE &&
+            Object.keys(slots).length <= 1 && !hasTrimSheetBinding;
+        if (nativeEligible && candidate) {
+            if (candidate.type !== actor.kind)
+                throw new Error(`actor ${actor.id} candidate type does not match kind`);
+            if (actor.mesh && (!actor.transform || !actor.bounds))
+                throw new Error(`actor ${actor.id} requires transform and bounds to retain its source fallback`);
+            const native = {
+                ...candidate,
+                id: actor.id,
+                ...(properties ? { properties } : {}),
+                ...(firstBinding ? { materialBinding: firstBinding } : {}),
+                ...(actor.mesh ? {
+                    sourceFallback: {
+                        object: actor.mesh,
+                        transform: actor.transform,
+                        bounds: actor.bounds,
+                        reason: `Native ${actor.kind} conversion exceeded ${exports.NATIVE_SCENE_CONVERSION_CONFIDENCE}; source detail remains pinned for audit and fallback.`,
+                        ...(actor.sourceId ? { sourceId: actor.sourceId } : {}),
+                    },
+                } : {}),
+            };
+            receipt.conversions.push({ actorId: actor.id, action: 'native', confidence: actor.confidence, reason: `Structural equivalence met the ${exports.NATIVE_SCENE_CONVERSION_CONFIDENCE} threshold.`, ...(actor.mesh ? { sourceMeshCid: actor.mesh.cid } : {}) });
+            return native;
+        }
+        if (!actor.mesh || !actor.transform || !actor.bounds) {
+            throw new Error(`actor ${actor.id} requires mesh, transform and bounds when native equivalence is unproven`);
+        }
+        const asset = {
+            id: actor.id,
+            type: 'asset',
+            ...(properties ? { properties } : {}),
+            transform: actor.transform,
+            bounds: actor.bounds,
+            mesh: actor.mesh,
+            ...(actor.proxy ? { proxy: actor.proxy } : {}),
+            ...(actor.collider ? { collider: actor.collider } : {}),
+            materialSlots: slots,
+            sourceDetail: {
+                preserved: true,
+                reason: actor.candidate
+                    ? hasTrimSheetBinding
+                        ? 'Trim-sheet regions require the exact source mesh UV layout.'
+                        : Object.keys(slots).length > 1
+                            ? 'Multiple material slots or trim regions require the exact source mesh binding layout.'
+                            : `Structural confidence ${actor.confidence} is below ${exports.NATIVE_SCENE_CONVERSION_CONFIDENCE}.`
+                    : 'No equivalent native Scene element was proven.',
+                ...(actor.sourceId ? { sourceId: actor.sourceId } : {}),
+            },
+        };
+        receipt.conversions.push({ actorId: actor.id, action: 'mesh-backed', confidence: actor.confidence, reason: asset.sourceDetail.reason, sourceMeshCid: actor.mesh.cid });
+        return asset;
+    };
+    const converted = new Map();
+    for (let index = topological.length - 1; index >= 0; index -= 1) {
+        const actor = topological[index];
+        const children = (childActors.get(actor.id) ?? []).map((child) => converted.get(child.id));
+        converted.set(actor.id, convert(actor, children));
+    }
+    const convertedRoots = roots.map((actor) => converted.get(actor.id));
+    const document = {
+        schema: helix_manifest_1.CONTINUUM_SCENE_DOCUMENT_SCHEMA,
+        id: input.id,
+        title: input.title,
+        units: 'meters',
+        materialBindings,
+        roots: convertedRoots,
+    };
+    const validation = (0, helix_manifest_1.validateContinuumSceneDocument)(document);
+    if (!validation.valid)
+        throw new TypeError(`imported Scene is invalid: ${validation.errors.join('; ')}`);
+    receipt.conversions.sort((a, b) => a.actorId.localeCompare(b.actorId));
+    receipt.materials.sort((a, b) => a.sourceMaterialId.localeCompare(b.sourceMaterialId));
+    return { document: validation.document, receipt };
+}
+//# sourceMappingURL=semantic.js.map

package/dist/sceneImport/semantic.js.map

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

package/dist/sceneImport/spawnProbe.d.ts

@@ -0,0 +1,55 @@
+import type { Bounds, Vec3 } from './types';
+/**
+ * Where a player should stand when they enter an imported Scene.
+ *
+ * Deriving the spawn from the bounding box alone cannot work: the box's minimum
+ * Y is the lowest point anywhere on the sheet (a shoreline, a basement, the
+ * underside of a bridge), and its centre in X/Z is a corner for any source
+ * whose local origin sits at one edge. Both mistakes put the player in open air
+ * with nothing under them, which is indistinguishable from a broken collision
+ * mesh.
+ *
+ * So probe the real geometry instead: drop a ray straight down at a candidate
+ * point, take the highest surface it hits, and require standing headroom above
+ * it so the spawn is never inside a building or under a canopy.
+ */
+export type SpawnProbeResult = {
+    position: Vec3;
+    /** Surface height the ray actually hit, before clearance was added. */
+    groundY: number;
+    /** How many candidates were rejected before this one, for the receipt. */
+    rejectedCandidates: number;
+};
+export type ProbeTriangle = readonly [Vec3, Vec3, Vec3];
+/**
+ * Highest surface at (x, z), or null when the downward ray misses the geometry
+ * entirely — which is the signal that this candidate is over open air.
+ */
+export declare function columnAt(triangles: readonly ProbeTriangle[], x: number, z: number): {
+    groundY: number;
+    surfaces: number;
+} | null;
+/**
+ * Barycentric height of a triangle at (x, z), or null when (x, z) falls outside
+ * its vertical projection or the triangle is edge-on (zero projected area).
+ */
+export declare function triangleHeightAt(triangle: ProbeTriangle, x: number, z: number): number | null;
+/**
+ * Walks candidate points outward from the centre of the sheet in a square
+ * spiral, returning the first that has real ground under it. Falls back to the
+ * top of the bounds only when the geometry is missed everywhere, which is an
+ * honest "I could not find ground" rather than a fabricated standing position.
+ */
+export declare function probeSpawn(input: {
+    triangles: readonly ProbeTriangle[];
+    bounds: Bounds;
+    clearanceHeightM: number;
+    /** Candidate grid resolution across the sheet. */
+    samples?: number;
+}): SpawnProbeResult;
+/**
+ * True when the ground within `radius` of (x, z) stays within
+ * OPEN_GROUND_TOLERANCE_M of the candidate's own height in every direction. A
+ * tree canopy, a rooftop edge and a wall all fail this; a street passes.
+ */
+export declare function isFlatNeighbourhood(triangles: readonly ProbeTriangle[], x: number, z: number, groundY: number, radius: number): boolean;

package/dist/sceneImport/spawnProbe.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.columnAt = columnAt;
+exports.triangleHeightAt = triangleHeightAt;
+exports.probeSpawn = probeSpawn;
+exports.isFlatNeighbourhood = isFlatNeighbourhood;
+/**
+ * Highest surface at (x, z), or null when the downward ray misses the geometry
+ * entirely — which is the signal that this candidate is over open air.
+ */
+function columnAt(triangles, x, z) {
+    const hits = [];
+    for (const triangle of triangles) {
+        const y = triangleHeightAt(triangle, x, z);
+        if (y !== null)
+            hits.push(y);
+    }
+    if (!hits.length)
+        return null;
+    // The topmost hit is the surface a falling capsule comes to rest on, which is
+    // what the spawn must sit above. `surfaces` counts distinct levels in the
+    // column: more than one means something is stacked here -- a canopy over a
+    // street, a floor over a basement -- so the topmost hit is a roof, not ground.
+    hits.sort((a, b) => a - b);
+    let surfaces = 1;
+    for (let i = 1; i < hits.length; i += 1) {
+        if (hits[i] - hits[i - 1] > OPEN_GROUND_TOLERANCE_M)
+            surfaces += 1;
+    }
+    return { groundY: hits[hits.length - 1], surfaces };
+}
+/**
+ * Barycentric height of a triangle at (x, z), or null when (x, z) falls outside
+ * its vertical projection or the triangle is edge-on (zero projected area).
+ */
+function triangleHeightAt(triangle, x, z) {
+    const [a, b, c] = triangle;
+    const denominator = (b[2] - c[2]) * (a[0] - c[0]) + (c[0] - b[0]) * (a[2] - c[2]);
+    if (!Number.isFinite(denominator) || Math.abs(denominator) < 1e-9)
+        return null;
+    const u = ((b[2] - c[2]) * (x - c[0]) + (c[0] - b[0]) * (z - c[2])) / denominator;
+    const v = ((c[2] - a[2]) * (x - c[0]) + (a[0] - c[0]) * (z - c[2])) / denominator;
+    const w = 1 - u - v;
+    const epsilon = -1e-6;
+    if (u < epsilon || v < epsilon || w < epsilon)
+        return null;
+    const y = u * a[1] + v * b[1] + w * c[1];
+    return Number.isFinite(y) ? y : null;
+}
+/**
+ * Walks candidate points outward from the centre of the sheet in a square
+ * spiral, returning the first that has real ground under it. Falls back to the
+ * top of the bounds only when the geometry is missed everywhere, which is an
+ * honest "I could not find ground" rather than a fabricated standing position.
+ */
+function probeSpawn(input) {
+    // First pass insists on open, flat ground. If the source has none -- a dense
+    // interior, a hillside -- the second pass drops that requirement rather than
+    // failing, so a harder scene still gets a real surface instead of the bounds
+    // fallback.
+    const open = probeSpawnPass(input, OPEN_GROUND_RADIUS_M);
+    if (open)
+        return open;
+    const any = probeSpawnPass(input, 0);
+    if (any)
+        return any;
+    const centreX = (input.bounds.min[0] + input.bounds.max[0]) / 2;
+    const centreZ = (input.bounds.min[2] + input.bounds.max[2]) / 2;
+    return {
+        position: [centreX, input.bounds.max[1] + input.clearanceHeightM, centreZ],
+        groundY: input.bounds.max[1],
+        rejectedCandidates: -1,
+    };
+}
+/** How far around a candidate the ground must stay walkably flat. */
+const OPEN_GROUND_RADIUS_M = 3;
+/** How much the ground may rise or fall across that radius. */
+const OPEN_GROUND_TOLERANCE_M = 1;
+/**
+ * True when the ground within `radius` of (x, z) stays within
+ * OPEN_GROUND_TOLERANCE_M of the candidate's own height in every direction. A
+ * tree canopy, a rooftop edge and a wall all fail this; a street passes.
+ */
+function isFlatNeighbourhood(triangles, x, z, groundY, radius) {
+    for (const [dx, dz] of [
+        [radius, 0],
+        [-radius, 0],
+        [0, radius],
+        [0, -radius],
+    ]) {
+        const neighbour = columnAt(triangles, x + dx, z + dz);
+        if (!neighbour)
+            return false;
+        if (Math.abs(neighbour.groundY - groundY) > OPEN_GROUND_TOLERANCE_M) {
+            return false;
+        }
+    }
+    return true;
+}
+function probeSpawnPass(input, openGround) {
+    const { bounds, clearanceHeightM } = input;
+    const samples = Math.max(3, input.samples ?? 9);
+    const centreX = (bounds.min[0] + bounds.max[0]) / 2;
+    const centreZ = (bounds.min[2] + bounds.max[2]) / 2;
+    const spanX = bounds.max[0] - bounds.min[0];
+    const spanZ = bounds.max[2] - bounds.min[2];
+    let rejected = 0;
+    // Ring 0 is the centre; each subsequent ring steps a fraction of the sheet
+    // outward, so a spawn stays as close to the middle of the map as the geometry
+    // allows rather than jumping to an arbitrary corner.
+    for (let ring = 0; ring < samples; ring += 1) {
+        const offsets = ringOffsets(ring);
+        for (const [dx, dz] of offsets) {
+            const x = centreX + (dx * spanX) / (samples * 2);
+            const z = centreZ + (dz * spanZ) / (samples * 2);
+            if (x < bounds.min[0] || x > bounds.max[0])
+                continue;
+            if (z < bounds.min[2] || z > bounds.max[2])
+                continue;
+            const column = columnAt(input.triangles, x, z);
+            if (!column) {
+                rejected += 1;
+                continue;
+            }
+            // Ground under the player is necessary but not sufficient. The geometric
+            // centre of a city sheet is as likely to be inside a park canopy as on a
+            // street, and a player who spawns in a thicket walks three steps into
+            // black geometry and concludes the world is broken. Require the
+            // neighbourhood to be walkably flat -- a street, a plaza, a courtyard --
+            // before accepting the candidate.
+            if (openGround > 0) {
+                // Standing on top of a tree canopy is flat and open too, so flatness
+                // alone is not enough: insist the column hold a single surface, which
+                // is what open sky over a street or a plaza looks like.
+                if (column.surfaces !== 1 ||
+                    !isFlatNeighbourhood(input.triangles, x, z, column.groundY, openGround)) {
+                    rejected += 1;
+                    continue;
+                }
+            }
+            return {
+                position: [x, column.groundY + clearanceHeightM * 0.1, z],
+                groundY: column.groundY,
+                rejectedCandidates: rejected,
+            };
+        }
+    }
+    return null;
+}
+function ringOffsets(ring) {
+    if (ring === 0)
+        return [[0, 0]];
+    const offsets = [];
+    for (let d = -ring; d <= ring; d += 1) {
+        offsets.push([d, -ring], [d, ring], [-ring, d], [ring, d]);
+    }
+    return offsets;
+}
+//# sourceMappingURL=spawnProbe.js.map

package/dist/sceneImport/spawnProbe.js.map

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

package/dist/sceneImport/streamLayout.d.ts

@@ -0,0 +1,96 @@
+import type { Bounds, Vec3 } from './types';
+/**
+ * Spatial clustering of many placed assets into Scene v2 streaming cells and
+ * 'distance'-mode stream groups.
+ *
+ * The single-sheet importer put every node in one eager cell: correct for one
+ * baked mesh, wasteful for a pack of N individually placed props where a player
+ * only ever stands near a few of them. Cells follow the ground-plane grid model
+ * proven by the Helsinki mosaic tiles — square regions of world X/Z, each
+ * holding the nodes whose centroids fall inside them — so the runtime can
+ * activate only the neighbourhood a player is actually in.
+ */
+/**
+ * Platform Scene caps, re-exported straight from the shared contract. Copying
+ * the numbers here would let the CLI and the validator drift apart silently and
+ * the CLI's "named offender" errors would start naming the wrong limit.
+ */
+export declare const SCENE_V2_MAX_CELLS: 1024;
+export declare const SCENE_V2_MAX_STREAM_GROUPS: 512;
+export declare const SCENE_V2_MAX_NODES: 4096;
+export declare const SCENE_V2_MAX_RESOURCES: 8192;
+export declare const SCENE_V2_MAX_NODES_PER_CELL: 1024;
+/** Ground-plane grid cells below this stop earning their streaming overhead. */
+export declare const MIN_CELL_SIZE_M = 16;
+/** Above this, cell activation latency outweighs any residency saving. */
+export declare const MAX_CELL_SIZE_M = 128;
+export type Placement = {
+    id: string;
+    name: string;
+    transform: {
+        position: Vec3;
+        rotation: [number, number, number, number];
+        scale: Vec3;
+    };
+    /** World-space bounds of the placed instance (local bounds after its transform). */
+    worldBounds: Bounds;
+    detailResourceKey: string;
+    proxyResourceKey: string;
+};
+export type StreamCellPlan = {
+    id: string;
+    bounds: Bounds;
+    /** Placement ids whose nodes live in this cell. */
+    placementIds: string[];
+};
+export type StreamGroupPlan = {
+    id: string;
+    priority: number;
+    mode: 'distance';
+    cells: StreamCellPlan[];
+    /**
+     * Sum of unique resource MiB referenced by this group's nodes and colliders.
+     * Deliberately ignores sharing across groups: the validator's residency union
+     * adds group estimates, so crediting a shared resource twice would promise
+     * memory the residency check does not know is shared.
+     */
+    estimatedMemoryMiB: number;
+};
+export type PlannedPlacement = Placement & {
+    cellId: string;
+    groupId: string;
+};
+export type StreamLayoutPlan = {
+    cellSizeM: number;
+    streamRadiusM: number;
+    groups: StreamGroupPlan[];
+    placements: PlannedPlacement[];
+};
+export declare function centroidOf(bounds: Bounds): Vec3;
+/**
+ * Cell size from the pack's own asset scale: four median horizontal extents,
+ * clamped to the band where streaming pays for itself, then grown until the
+ * plan fits the platform cell cap.
+ */
+export declare function chooseCellSizeM(placements: readonly Placement[]): number;
+/**
+ * Clusters placements into grid cells, chunks spatially coherent cells into at
+ * most SCENE_V2_MAX_STREAM_GROUPS distance-mode groups, and estimates each
+ * group's decoded memory from the unique resources its nodes reference.
+ *
+ * `resourceMiB` maps resource keys (the same keys carried on placements) to the
+ * decoded size the runtime must hold for that resource. Group memory is the sum
+ * over the detail AND proxy keys its placements reference — proxies included,
+ * because LOD selection can swap them in while the rest of the group streams.
+ */
+export declare function planStreamLayout(input: {
+    placements: readonly Placement[];
+    resourceMiB: ReadonlyMap<string, number>;
+    cellSizeM?: number;
+}): StreamLayoutPlan;
+/**
+ * The activation radius a player needs before a distance group streams in:
+ * half the largest cell diagonal plus the largest asset radius, so a group is
+ * resident before anything inside it can be seen, not after.
+ */
+export declare function deriveStreamRadiusM(placements: readonly Placement[], cellSizeM: number): number;