@hypersoniclabs/helix-cli 0.1.7 → 0.1.23

package/dist/sceneImport/streamLayout.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_CELL_SIZE_M = exports.MIN_CELL_SIZE_M = exports.SCENE_V2_MAX_NODES_PER_CELL = exports.SCENE_V2_MAX_RESOURCES = exports.SCENE_V2_MAX_NODES = exports.SCENE_V2_MAX_STREAM_GROUPS = exports.SCENE_V2_MAX_CELLS = void 0;
+exports.centroidOf = centroidOf;
+exports.chooseCellSizeM = chooseCellSizeM;
+exports.planStreamLayout = planStreamLayout;
+exports.deriveStreamRadiusM = deriveStreamRadiusM;
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+/**
+ * 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.
+ */
+exports.SCENE_V2_MAX_CELLS = helix_manifest_1.HELIX_SCENE_CAPS.cells;
+exports.SCENE_V2_MAX_STREAM_GROUPS = helix_manifest_1.HELIX_SCENE_CAPS.streamGroups;
+exports.SCENE_V2_MAX_NODES = helix_manifest_1.HELIX_SCENE_CAPS.nodes;
+exports.SCENE_V2_MAX_RESOURCES = helix_manifest_1.HELIX_SCENE_CAPS.resources;
+exports.SCENE_V2_MAX_NODES_PER_CELL = helix_manifest_1.HELIX_SCENE_CAPS.nodesPerCell;
+/** Ground-plane grid cells below this stop earning their streaming overhead. */
+exports.MIN_CELL_SIZE_M = 16;
+/** Above this, cell activation latency outweighs any residency saving. */
+exports.MAX_CELL_SIZE_M = 128;
+function centroidOf(bounds) {
+    return [
+        (bounds.min[0] + bounds.max[0]) / 2,
+        (bounds.min[1] + bounds.max[1]) / 2,
+        (bounds.min[2] + bounds.max[2]) / 2,
+    ];
+}
+function horizontalExtent(bounds) {
+    return Math.max(bounds.max[0] - bounds.min[0], bounds.max[2] - bounds.min[2]);
+}
+function cellKey(centroid, cellSizeM) {
+    const gx = Math.floor(centroid[0] / cellSizeM);
+    const gz = Math.floor(centroid[2] / cellSizeM);
+    return `${gx}:${gz}`;
+}
+function parseCellKey(key) {
+    const [gx, gz] = key.split(':');
+    return [Number(gx), Number(gz)];
+}
+/**
+ * Cell keys are grid COORDINATES, so they order numerically. Sorting the
+ * strings puts "10:0" between "1:0" and "2:0", which scatters each chunk of
+ * cells across the whole map and destroys the spatial coherence that makes a
+ * stream group worth activating as a unit.
+ */
+function compareCellKeys(a, b) {
+    const [ax, az] = parseCellKey(a);
+    const [bx, bz] = parseCellKey(b);
+    return ax - bx || az - bz;
+}
+function slug(key) {
+    const [gx, gz] = key.split(':').map((part) => (Number(part) < 0 ? `n${Math.abs(Number(part))}` : part));
+    return `${gx}.${gz}`;
+}
+/**
+ * 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.
+ */
+function chooseCellSizeM(placements) {
+    if (!placements.length)
+        throw new Error('cannot derive a cell size from an empty placement set');
+    const extents = placements.map((placement) => horizontalExtent(placement.worldBounds));
+    extents.sort((a, b) => a - b);
+    const median = extents[Math.floor(extents.length / 2)];
+    let cellSizeM = Math.min(exports.MAX_CELL_SIZE_M, Math.max(exports.MIN_CELL_SIZE_M, median * 4));
+    while (countCells(placements, cellSizeM) > exports.SCENE_V2_MAX_CELLS && cellSizeM < exports.MAX_CELL_SIZE_M * 16) {
+        cellSizeM *= 1.6;
+    }
+    return cellSizeM;
+}
+function countCells(placements, cellSizeM) {
+    const keys = new Set();
+    for (const placement of placements) {
+        keys.add(cellKey(centroidOf(placement.worldBounds), cellSizeM));
+    }
+    return keys.size;
+}
+/**
+ * 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.
+ */
+function planStreamLayout(input) {
+    if (!input.placements.length)
+        throw new Error('stream layout requires at least one placement');
+    const cellSizeM = input.cellSizeM ?? chooseCellSizeM(input.placements);
+    if (!Number.isFinite(cellSizeM) || cellSizeM <= 0) {
+        throw new Error('cell size must be a positive finite number');
+    }
+    // Deterministic order: identical inputs must always produce identical cell
+    // ids, group boundaries and therefore scene revisions.
+    const byCell = new Map();
+    for (const placement of [...input.placements].sort((a, b) => a.id.localeCompare(b.id))) {
+        const key = cellKey(centroidOf(placement.worldBounds), cellSizeM);
+        const members = byCell.get(key);
+        if (members)
+            members.push(placement);
+        else
+            byCell.set(key, [placement]);
+    }
+    if (byCell.size > exports.SCENE_V2_MAX_CELLS) {
+        throw new Error(`${byCell.size} streaming cells exceed the ${exports.SCENE_V2_MAX_CELLS}-cell Scene cap`);
+    }
+    const sortedKeys = [...byCell.keys()].sort(compareCellKeys);
+    for (const key of sortedKeys) {
+        // +2: the group's collision anchor and, in the first group, the sun join a
+        // cell's node list too. Checked here, where the offending cell can still be
+        // named, rather than surfacing later as an anonymous validator rejection.
+        const nodes = byCell.get(key).length + 2;
+        if (nodes > exports.SCENE_V2_MAX_NODES_PER_CELL) {
+            throw new Error(`${nodes} nodes in cell ${slug(key)} exceed the ${exports.SCENE_V2_MAX_NODES_PER_CELL}-node per-cell Scene cap`);
+        }
+    }
+    // Chunk size first, then the group count it implies. Deriving the count from
+    // the cap instead (min(cap, cells)) leaves trailing groups holding no cells
+    // whenever the division is uneven -- 300 cells produced 150 real groups and
+    // 106 empty ones, and package assembly throws on the first empty group.
+    const cellsPerGroup = Math.ceil(byCell.size / Math.min(exports.SCENE_V2_MAX_STREAM_GROUPS, byCell.size));
+    const groupCount = Math.ceil(byCell.size / cellsPerGroup);
+    const groups = [];
+    const planned = [];
+    for (let groupIndex = 0; groupIndex < groupCount; groupIndex += 1) {
+        const memberKeys = sortedKeys.filter((_, index) => Math.floor(index / cellsPerGroup) === groupIndex);
+        const cells = [];
+        const memoryKeys = new Set();
+        for (const key of memberKeys) {
+            const members = byCell.get(key);
+            const bounds = {
+                min: [Number.POSITIVE_INFINITY, Number.POSITIVE_INFINITY, Number.POSITIVE_INFINITY],
+                max: [Number.NEGATIVE_INFINITY, Number.NEGATIVE_INFINITY, Number.NEGATIVE_INFINITY],
+            };
+            for (const placement of members) {
+                bounds.min = bounds.min.map((value, axis) => Math.min(value, placement.worldBounds.min[axis]));
+                bounds.max = bounds.max.map((value, axis) => Math.max(value, placement.worldBounds.max[axis]));
+                // Unprefixed keys: when detail and proxy are the same content-hash
+                // resource they collapse here instead of being billed twice.
+                memoryKeys.add(placement.detailResourceKey);
+                memoryKeys.add(placement.proxyResourceKey);
+            }
+            const cellId = `cell.${slug(key)}.${groupIndex}`;
+            for (const placement of members) {
+                planned.push({
+                    ...placement,
+                    cellId,
+                    groupId: `group.${groupIndex}`,
+                });
+            }
+            cells.push({ id: cellId, bounds, placementIds: members.map((member) => member.id) });
+        }
+        let estimatedMemoryMiB = 0;
+        for (const key of memoryKeys) {
+            estimatedMemoryMiB += input.resourceMiB.get(key) ?? 0;
+        }
+        groups.push({
+            id: `group.${groupIndex}`,
+            // Descending from the group cap keeps every priority positive and ordered
+            // even at the maximum group count; `100 - groupIndex` went negative for
+            // any pack needing more than 100 groups.
+            priority: exports.SCENE_V2_MAX_STREAM_GROUPS - groupIndex,
+            mode: 'distance',
+            cells,
+            estimatedMemoryMiB: Math.max(1, Math.ceil(estimatedMemoryMiB)),
+        });
+    }
+    const streamRadiusM = deriveStreamRadiusM(input.placements, cellSizeM);
+    return { cellSizeM, streamRadiusM, groups, placements: planned };
+}
+/**
+ * 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.
+ */
+function deriveStreamRadiusM(placements, cellSizeM) {
+    let maxAssetRadius = 0;
+    for (const placement of placements) {
+        const centre = centroidOf(placement.worldBounds);
+        for (const corner of [placement.worldBounds.min, placement.worldBounds.max]) {
+            maxAssetRadius = Math.max(maxAssetRadius, Math.hypot(corner[0] - centre[0], corner[1] - centre[1], corner[2] - centre[2]));
+        }
+    }
+    const cellDiagonal = Math.hypot(cellSizeM, cellSizeM);
+    return Math.ceil(cellDiagonal + maxAssetRadius + 8);
+}
+//# sourceMappingURL=streamLayout.js.map

package/dist/sceneImport/streamLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamLayout.js","sourceRoot":"","sources":["../../src/sceneImport/streamLayout.ts"],"names":[],"mappings":";;;AA0EA,gCAMC;AAuCD,0CAUC;AAoBD,4CAiGC;AAOD,kDAaC;AA1QD,mEAAkE;AAGlE;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACU,QAAA,kBAAkB,GAAG,iCAAgB,CAAC,KAAK,CAAC;AAC5C,QAAA,0BAA0B,GAAG,iCAAgB,CAAC,YAAY,CAAC;AAC3D,QAAA,kBAAkB,GAAG,iCAAgB,CAAC,KAAK,CAAC;AAC5C,QAAA,sBAAsB,GAAG,iCAAgB,CAAC,SAAS,CAAC;AACpD,QAAA,2BAA2B,GAAG,iCAAgB,CAAC,YAAY,CAAC;AAEzE,gFAAgF;AACnE,QAAA,eAAe,GAAG,EAAE,CAAC;AAClC,0EAA0E;AAC7D,QAAA,eAAe,GAAG,GAAG,CAAC;AA6CnC,SAAgB,UAAU,CAAC,MAAc;IACvC,OAAO;QACL,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACnC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACnC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,OAAO,CAAC,QAAc,EAAE,SAAiB;IAChD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC/C,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC/C,OAAO,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,CAAS,EAAE,CAAS;IAC3C,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,IAAI,CAAC,GAAW;IACvB,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACxG,OAAO,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe,CAAC,UAAgC;IAC9D,IAAI,CAAC,UAAU,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACjG,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,gBAAgB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;IACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,uBAAe,EAAE,IAAI,CAAC,GAAG,CAAC,uBAAe,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACjF,OAAO,UAAU,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,0BAAkB,IAAI,SAAS,GAAG,uBAAe,GAAG,EAAE,EAAE,CAAC;QAClG,SAAS,IAAI,GAAG,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,UAAU,CAAC,UAAgC,EAAE,SAAiB;IACrE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,gBAAgB,CAAC,KAIhC;IACC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC/F,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,eAAe,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACvE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,2EAA2E;IAC3E,uDAAuD;IACvD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,KAAK,MAAM,SAAS,IAAI,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACvF,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;;YAChC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,GAAG,0BAAkB,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,+BAA+B,0BAAkB,iBAAiB,CAAC,CAAC;IACpG,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5D,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,2EAA2E;QAC3E,4EAA4E;QAC5E,0EAA0E;QAC1E,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1C,IAAI,KAAK,GAAG,mCAA2B,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,kBAAkB,IAAI,CAAC,GAAG,CAAC,eAAe,mCAA2B,0BAA0B,CACxG,CAAC;QACJ,CAAC;IACH,CAAC;IACD,6EAA6E;IAC7E,4EAA4E;IAC5E,4EAA4E;IAC5E,wEAAwE;IACxE,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,kCAA0B,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACjG,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,aAAa,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,UAAU,IAAI,CAAC,EAAE,CAAC;QAClE,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAClC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,UAAU,CAC/D,CAAC;QACF,MAAM,KAAK,GAAqB,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;YACjC,MAAM,MAAM,GAAW;gBACrB,GAAG,EAAE,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,CAAC;gBACnF,GAAG,EAAE,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,CAAC;aACpF,CAAC;YACF,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;gBAChC,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CACzB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAC1D,CAAC;gBACV,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CACzB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAC1D,CAAC;gBACV,mEAAmE;gBACnE,6DAA6D;gBAC7D,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;gBAC5C,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YAC7C,CAAC;YACD,MAAM,MAAM,GAAG,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,UAAU,EAAE,CAAC;YACjD,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC;oBACX,GAAG,SAAS;oBACZ,MAAM;oBACN,OAAO,EAAE,SAAS,UAAU,EAAE;iBAC/B,CAAC,CAAC;YACL,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,kBAAkB,GAAG,CAAC,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,kBAAkB,IAAI,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,SAAS,UAAU,EAAE;YACzB,0EAA0E;YAC1E,wEAAwE;YACxE,yCAAyC;YACzC,QAAQ,EAAE,kCAA0B,GAAG,UAAU;YACjD,IAAI,EAAE,UAAU;YAChB,KAAK;YACL,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;SAC/D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,aAAa,GAAG,mBAAmB,CAAC,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACvE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,UAAgC,EAAE,SAAiB;IACrF,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACjD,KAAK,MAAM,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5E,cAAc,GAAG,IAAI,CAAC,GAAG,CACvB,cAAc,EACd,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAChF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,cAAc,GAAG,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/sceneImport/textureDecode.d.ts

@@ -0,0 +1,21 @@
+export type DecodedTexture = {
+    width: number;
+    height: number;
+    data: Uint8Array;
+};
+/** Maximum RGBA allocation made while decoding one source texture. */
+export declare const DEFAULT_MAX_DECODED_TEXTURE_BYTES: number;
+/**
+ * Decodes the subset of DDS actually present in the Bistro archive: BC1/DXT1
+ * (base color, with punch-through alpha), BC3/DXT5 (packed specular/ORM), and
+ * BC5/ATI2 (DirectX tangent-space normals, X/Y only). Anything else fails
+ * loudly so an unrecognized compression format becomes an explicit
+ * unsupported-material receipt rather than a silently wrong texture.
+ */
+export declare function decodeDds(buffer: Buffer, maxDecodedBytes?: number): DecodedTexture;
+/** Decodes uncompressed truecolor TGA (image types 2 and 10), 24 or 32 bpp. */
+export declare function decodeTga(buffer: Buffer, maxDecodedBytes?: number): DecodedTexture;
+/** DirectX (Y-down) tangent-space normal -> glTF/OpenGL (Y-up) normal, reconstructing Z. */
+export declare function directXNormalToGlNormal(source: DecodedTexture): DecodedTexture;
+/** Resamples to a bounded resolution and encodes as PNG, keeping detail GLBs within the package cap. */
+export declare function encodeBoundedPng(texture: DecodedTexture, maxDimension: number): Promise<Buffer>;

package/dist/sceneImport/textureDecode.js

@@ -0,0 +1,292 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MAX_DECODED_TEXTURE_BYTES = void 0;
+exports.decodeDds = decodeDds;
+exports.decodeTga = decodeTga;
+exports.directXNormalToGlNormal = directXNormalToGlNormal;
+exports.encodeBoundedPng = encodeBoundedPng;
+const sharp_1 = __importDefault(require("sharp"));
+/** Maximum RGBA allocation made while decoding one source texture. */
+exports.DEFAULT_MAX_DECODED_TEXTURE_BYTES = 256 * 1024 * 1024;
+const DDS_MAGIC = 0x20534444; // 'DDS '
+const DDPF_FOURCC = 0x4;
+/**
+ * Decodes the subset of DDS actually present in the Bistro archive: BC1/DXT1
+ * (base color, with punch-through alpha), BC3/DXT5 (packed specular/ORM), and
+ * BC5/ATI2 (DirectX tangent-space normals, X/Y only). Anything else fails
+ * loudly so an unrecognized compression format becomes an explicit
+ * unsupported-material receipt rather than a silently wrong texture.
+ */
+function decodeDds(buffer, maxDecodedBytes = exports.DEFAULT_MAX_DECODED_TEXTURE_BYTES) {
+    if (buffer.length < 128 || buffer.readUInt32LE(0) !== DDS_MAGIC) {
+        throw new Error('not a DDS file (missing "DDS " magic)');
+    }
+    const height = buffer.readUInt32LE(12);
+    const width = buffer.readUInt32LE(16);
+    if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) {
+        throw new Error('DDS header declares non-finite or non-positive dimensions');
+    }
+    assertDecodedTextureAllocation(width, height, maxDecodedBytes, 'DDS');
+    const pfFlags = buffer.readUInt32LE(80);
+    const fourCC = buffer.toString('ascii', 84, 88);
+    const pixels = buffer.subarray(128);
+    if ((pfFlags & DDPF_FOURCC) === 0) {
+        throw new Error('DDS pixel format has no FourCC; uncompressed DDS is not a supported converter input');
+    }
+    if (fourCC === 'DXT1')
+        return { width, height, data: decodeBlockTexture(pixels, width, height, 8, decodeBc1Block) };
+    if (fourCC === 'DXT5')
+        return { width, height, data: decodeBlockTexture(pixels, width, height, 16, decodeBc3Block) };
+    if (fourCC === 'ATI2' || fourCC === 'BC5U') {
+        return { width, height, data: decodeBlockTexture(pixels, width, height, 16, decodeBc5Block) };
+    }
+    throw new Error(`unsupported DDS FourCC "${fourCC}"; add an explicit decoder before converting this texture`);
+}
+/** Decodes uncompressed truecolor TGA (image types 2 and 10), 24 or 32 bpp. */
+function decodeTga(buffer, maxDecodedBytes = exports.DEFAULT_MAX_DECODED_TEXTURE_BYTES) {
+    if (buffer.length < 18)
+        throw new Error('TGA file is smaller than its own header');
+    const idLength = buffer.readUInt8(0);
+    const colorMapType = buffer.readUInt8(1);
+    const imageType = buffer.readUInt8(2);
+    const width = buffer.readUInt16LE(12);
+    const height = buffer.readUInt16LE(14);
+    const pixelDepth = buffer.readUInt8(16);
+    const imageDescriptor = buffer.readUInt8(17);
+    if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) {
+        throw new Error('TGA header declares non-finite or non-positive dimensions');
+    }
+    assertDecodedTextureAllocation(width, height, maxDecodedBytes, 'TGA');
+    if (colorMapType !== 0)
+        throw new Error('TGA color-mapped images are not a supported converter input');
+    if (imageType !== 2 && imageType !== 10) {
+        throw new Error(`unsupported TGA image type ${imageType}; only uncompressed/RLE truecolor is supported`);
+    }
+    if (pixelDepth !== 24 && pixelDepth !== 32) {
+        throw new Error(`unsupported TGA pixel depth ${pixelDepth}; only 24 and 32 bpp are supported`);
+    }
+    const bytesPerPixel = pixelDepth / 8;
+    let offset = 18 + idLength;
+    const pixelCount = width * height;
+    const raw = new Uint8Array(pixelCount * bytesPerPixel);
+    if (imageType === 2) {
+        const needed = pixelCount * bytesPerPixel;
+        if (offset + needed > buffer.length)
+            throw new Error('TGA file is truncated');
+        raw.set(buffer.subarray(offset, offset + needed));
+    }
+    else {
+        let written = 0;
+        while (written < raw.length) {
+            if (offset >= buffer.length)
+                throw new Error('TGA RLE stream is truncated');
+            const packet = buffer.readUInt8(offset);
+            offset += 1;
+            const count = (packet & 0x7f) + 1;
+            if (packet & 0x80) {
+                if (offset + bytesPerPixel > buffer.length)
+                    throw new Error('TGA RLE stream is truncated');
+                const pixel = buffer.subarray(offset, offset + bytesPerPixel);
+                offset += bytesPerPixel;
+                for (let i = 0; i < count && written < raw.length; i++) {
+                    raw.set(pixel, written);
+                    written += bytesPerPixel;
+                }
+            }
+            else {
+                const needed = count * bytesPerPixel;
+                if (offset + needed > buffer.length)
+                    throw new Error('TGA RLE stream is truncated');
+                raw.set(buffer.subarray(offset, offset + needed), written);
+                offset += needed;
+                written += needed;
+            }
+        }
+    }
+    const data = new Uint8Array(pixelCount * 4);
+    for (let i = 0; i < pixelCount; i++) {
+        const src = i * bytesPerPixel;
+        const dst = i * 4;
+        data[dst] = raw[src + 2]; // TGA stores BGR(A)
+        data[dst + 1] = raw[src + 1];
+        data[dst + 2] = raw[src];
+        data[dst + 3] = bytesPerPixel === 4 ? raw[src + 3] : 255;
+    }
+    const topLeftOrigin = (imageDescriptor & 0x20) !== 0;
+    if (!topLeftOrigin)
+        flipRowsInPlace(data, width, height);
+    return { width, height, data };
+}
+function assertDecodedTextureAllocation(width, height, maxDecodedBytes, format) {
+    if (!Number.isSafeInteger(maxDecodedBytes) || maxDecodedBytes <= 0) {
+        throw new Error('decoded texture byte limit must be a positive safe integer');
+    }
+    // Division-first avoids overflowing Number's safe integer range for hostile
+    // DDS dimensions before either the intermediate TGA buffer or RGBA output is
+    // allocated.
+    if (width > Math.floor(Math.floor(maxDecodedBytes / 4) / height)) {
+        throw new Error(`${format} decoded pixels exceed the ${maxDecodedBytes}-byte RGBA texture limit ` +
+            `(${width}x${height})`);
+    }
+}
+/** DirectX (Y-down) tangent-space normal -> glTF/OpenGL (Y-up) normal, reconstructing Z. */
+function directXNormalToGlNormal(source) {
+    const data = new Uint8Array(source.data.length);
+    for (let i = 0; i < data.length; i += 4) {
+        const nx = (source.data[i] / 255) * 2 - 1;
+        const nyDx = (source.data[i + 1] / 255) * 2 - 1;
+        const nyGl = -nyDx;
+        const nzSquared = 1 - nx * nx - nyGl * nyGl;
+        const nz = Math.sqrt(Math.max(0, nzSquared));
+        data[i] = clampByte((nx * 0.5 + 0.5) * 255);
+        data[i + 1] = clampByte((nyGl * 0.5 + 0.5) * 255);
+        data[i + 2] = clampByte((nz * 0.5 + 0.5) * 255);
+        data[i + 3] = 255;
+    }
+    return { width: source.width, height: source.height, data };
+}
+/** Resamples to a bounded resolution and encodes as PNG, keeping detail GLBs within the package cap. */
+async function encodeBoundedPng(texture, maxDimension) {
+    return (0, sharp_1.default)(Buffer.from(texture.data), { raw: { width: texture.width, height: texture.height, channels: 4 } })
+        .resize(maxDimension, maxDimension, { fit: 'inside', withoutEnlargement: true })
+        .png({ compressionLevel: 9 })
+        .toBuffer();
+}
+function flipRowsInPlace(data, width, height) {
+    const stride = width * 4;
+    const row = new Uint8Array(stride);
+    for (let y = 0; y < Math.floor(height / 2); y++) {
+        const top = y * stride;
+        const bottom = (height - 1 - y) * stride;
+        row.set(data.subarray(top, top + stride));
+        data.copyWithin(top, bottom, bottom + stride);
+        data.set(row, bottom);
+    }
+}
+function clampByte(value) {
+    return Math.max(0, Math.min(255, Math.round(value)));
+}
+function decodeBlockTexture(pixels, width, height, blockBytes, decodeBlock) {
+    const blocksWide = Math.ceil(width / 4);
+    const blocksHigh = Math.ceil(height / 4);
+    const needed = blocksWide * blocksHigh * blockBytes;
+    if (pixels.length < needed)
+        throw new Error('DDS pixel data is smaller than its top mip level requires');
+    const out = new Uint8Array(width * height * 4);
+    for (let by = 0; by < blocksHigh; by++) {
+        for (let bx = 0; bx < blocksWide; bx++) {
+            const blockOffset = (by * blocksWide + bx) * blockBytes;
+            const block = decodeBlock(pixels.subarray(blockOffset, blockOffset + blockBytes));
+            for (let py = 0; py < 4; py++) {
+                const y = by * 4 + py;
+                if (y >= height)
+                    continue;
+                for (let px = 0; px < 4; px++) {
+                    const x = bx * 4 + px;
+                    if (x >= width)
+                        continue;
+                    const src = (py * 4 + px) * 4;
+                    const dst = (y * width + x) * 4;
+                    out[dst] = block[src];
+                    out[dst + 1] = block[src + 1];
+                    out[dst + 2] = block[src + 2];
+                    out[dst + 3] = block[src + 3];
+                }
+            }
+        }
+    }
+    return out;
+}
+function unpack565(value) {
+    const r5 = (value >> 11) & 0x1f;
+    const g6 = (value >> 5) & 0x3f;
+    const b5 = value & 0x1f;
+    return [(r5 << 3) | (r5 >> 2), (g6 << 2) | (g6 >> 4), (b5 << 3) | (b5 >> 2)];
+}
+function decodeColorBlockPalette(block, forceFourColor) {
+    const c0 = block.readUInt16LE(0);
+    const c1 = block.readUInt16LE(2);
+    const rgb0 = unpack565(c0);
+    const rgb1 = unpack565(c1);
+    const fourColor = forceFourColor || c0 > c1;
+    const palette = [
+        [rgb0[0], rgb0[1], rgb0[2], 255],
+        [rgb1[0], rgb1[1], rgb1[2], 255],
+        [0, 0, 0, 255],
+        [0, 0, 0, 255],
+    ];
+    if (fourColor) {
+        for (let c = 0; c < 3; c++) {
+            palette[2][c] = Math.round((2 * rgb0[c] + rgb1[c]) / 3);
+            palette[3][c] = Math.round((rgb0[c] + 2 * rgb1[c]) / 3);
+        }
+    }
+    else {
+        for (let c = 0; c < 3; c++)
+            palette[2][c] = Math.round((rgb0[c] + rgb1[c]) / 2);
+        palette[3] = [0, 0, 0, 0];
+    }
+    return palette;
+}
+function decodeBc1Block(block) {
+    const palette = decodeColorBlockPalette(block, false);
+    const indices = block.readUInt32LE(4);
+    const out = new Uint8Array(64);
+    for (let i = 0; i < 16; i++) {
+        const idx = (indices >> (i * 2)) & 0x3;
+        out.set(palette[idx], i * 4);
+    }
+    return out;
+}
+function decodeAlphaPalette(a0, a1) {
+    const palette = [a0, a1, 0, 0, 0, 0, 0, 0];
+    if (a0 > a1) {
+        for (let i = 2; i <= 7; i++)
+            palette[i] = Math.round(((8 - i) * a0 + (i - 1) * a1) / 7);
+    }
+    else {
+        for (let i = 2; i <= 5; i++)
+            palette[i] = Math.round(((6 - i) * a0 + (i - 1) * a1) / 5);
+        palette[6] = 0;
+        palette[7] = 255;
+    }
+    return palette;
+}
+function readAlphaIndices(block) {
+    const low = block.readUIntLE(2, 3);
+    const high = block.readUIntLE(5, 3);
+    const indices = [];
+    for (let i = 0; i < 8; i++)
+        indices.push((low >> (i * 3)) & 0x7);
+    for (let i = 0; i < 8; i++)
+        indices.push((high >> (i * 3)) & 0x7);
+    return indices;
+}
+function decodeBc3Block(block) {
+    const alphaPalette = decodeAlphaPalette(block.readUInt8(0), block.readUInt8(1));
+    const alphaIndices = readAlphaIndices(block);
+    const colorPalette = decodeColorBlockPalette(block.subarray(8, 16), true);
+    const colorIndices = block.readUInt32LE(12);
+    const out = new Uint8Array(64);
+    for (let i = 0; i < 16; i++) {
+        const colorIdx = (colorIndices >> (i * 2)) & 0x3;
+        const [r, g, b] = colorPalette[colorIdx];
+        out.set([r, g, b, alphaPalette[alphaIndices[i]]], i * 4);
+    }
+    return out;
+}
+function decodeBc5Block(block) {
+    const redPalette = decodeAlphaPalette(block.readUInt8(0), block.readUInt8(1));
+    const redIndices = readAlphaIndices(block.subarray(0, 8));
+    const greenPalette = decodeAlphaPalette(block.readUInt8(8), block.readUInt8(9));
+    const greenIndices = readAlphaIndices(block.subarray(8, 16));
+    const out = new Uint8Array(64);
+    for (let i = 0; i < 16; i++) {
+        out.set([redPalette[redIndices[i]], greenPalette[greenIndices[i]], 0, 255], i * 4);
+    }
+    return out;
+}
+//# sourceMappingURL=textureDecode.js.map

package/dist/sceneImport/textureDecode.js.map

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

package/dist/sceneImport/types.d.ts

@@ -0,0 +1,84 @@
+export type Vec3 = [number, number, number];
+export type Bounds = {
+    min: Vec3;
+    max: Vec3;
+};
+/**
+ * Explicit recipient-rights statement for a converted source. Helsinki's CC BY
+ * terms are one instance of this shape, not the shape itself: a pack-agnostic
+ * importer must let non-CC-BY sources declare their own open license without
+ * false-failing on a literal string comparison.
+ */
+export type SourceRights = {
+    /** Slug form of the license class, e.g. 'open-cc-by', 'open-cc0', 'open-mit'. */
+    licenseClass: string;
+    accessControlChangesLicense: false;
+    additionalRestrictions: string;
+    drm: 'not-permitted';
+};
+export type SourceConversionReceipt = {
+    schemaVersion: 'helix.scene-source-conversion/1';
+    sourceId: string;
+    originalSha256: string;
+    attribution: {
+        license: string;
+        licenseUrl: string;
+        creator: string;
+        title: string;
+        url: string;
+        citation?: string;
+        changes: string;
+    };
+    rights: SourceRights;
+    sourceCrs: string | null;
+    sourceOrigin: Vec3;
+    conversion: {
+        geometry: string;
+        materials: string;
+        normalMaps: string;
+        orm: string;
+    };
+    unsupported: string[];
+};
+export type CompiledSceneArtifact = {
+    filename: string;
+    bytes: Buffer;
+    contentSha256: string;
+    bounds: Bounds;
+    summary: {
+        triangles: number;
+        materials: number;
+        textures: number;
+        nodes: number;
+    };
+    /**
+     * Where a player can actually stand in this geometry, probed against the real
+     * triangles. Only the artifact that also backs collision carries one.
+     */
+    spawn?: {
+        position: Vec3;
+        groundY: number;
+        rejectedCandidates: number;
+    };
+};
+export declare function assertFiniteVec3(value: Vec3, label: string): void;
+/** Derives the receipt rights block from a license string, e.g. 'CC BY 4.0' → 'open-cc-by'. */
+export declare function sourceRightsForLicense(license: string): SourceRights;
+export declare function assertSourceRights(rights: SourceRights): void;
+/**
+ * The ONE way a Scene v2 document is turned into bytes.
+ *
+ * Compact, no indent. This is not a style choice: the server enforces a 1 MiB
+ * cap on the Scene document's FILE bytes, and pretty-printing at two spaces is
+ * 52% of the file. Measured on the Pacifica mall exterior — the same 842-node
+ * document is 1,422,213 B indented and 678,160 B compact, so the indent alone
+ * decided whether the world could be published at all, and it halved the
+ * placement ceiling everyone was sizing groups against (805 B/placement, not
+ * 1,576). Nothing is lost: `integrity.sha256` is RFC 8785 canonical over the
+ * PARSED object (canonicalSceneDocumentPayload deletes `integrity`, then
+ * canonicalizes), so whitespace was never in the hash and a compact document
+ * verifies identically.
+ *
+ * Keep every scene write going through here, and keep it compact.
+ */
+export declare function serializeSceneDocument(scene: unknown): string;