@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/placements/assets.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preparePlacementsInventory = preparePlacementsInventory;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const source_1 = require("./source");
+/** The prepared inventory is local input; emitted Scene references use the ordinary resource table. */
+async function preparePlacementsInventory(catalogPath, out, prototypeIds) {
+    if ((await (0, promises_1.stat)(catalogPath)).size > 1_048_576)
+        throw new Error('placements: inventory exceeds 1 MiB');
+    const catalog = JSON.parse(await (0, promises_1.readFile)(catalogPath, 'utf8'));
+    if (catalog?.schema !== 'helix.placements-assets/1' || !Array.isArray(catalog.prototypes) || catalog.prototypes.length > 32) {
+        throw new Error('placements: expected a prepared helix.placements-assets/1 inventory');
+    }
+    const source = (0, node_path_1.dirname)(catalogPath), files = new Map();
+    await (0, promises_1.mkdir)((0, node_path_1.resolve)(out, 'objects'), { recursive: true });
+    async function copy(path, expected, mimeType) {
+        const absolute = (0, source_1.placementsFilePath)(source, path);
+        if ((await (0, promises_1.stat)(absolute)).size > 67_108_864)
+            throw new Error(`placements: asset exceeds 64 MiB: ${path}`);
+        const data = await (0, promises_1.readFile)(absolute), sha256 = (0, source_1.placementsDigest)(data);
+        if (sha256 !== expected)
+            throw new Error(`placements: inventory hash mismatch: ${path}`);
+        const id = `placements.${sha256}`, extension = mimeType === 'image/ktx2' ? 'ktx2' : 'glb', target = `objects/${sha256}.${extension}`;
+        await (0, promises_1.writeFile)((0, node_path_1.resolve)(out, target), data);
+        files.set(id, { id, sha256, bytes: data.length, mimeType, path: target });
+        return { id, data };
+    }
+    const prototypes = [];
+    if (prototypeIds?.some(id => !catalog.prototypes.some((p) => p.id === id))) {
+        throw new Error('placements: selected prototype is absent from the prepared inventory');
+    }
+    for (const item of catalog.prototypes.filter((p) => !prototypeIds || prototypeIds.includes(p.id))) {
+        const families = [];
+        for (const [familyId, entry] of Object.entries(item.families ?? {})) {
+            const family = entry;
+            if (!['small', 'full'].includes(familyId) || !Array.isArray(family.textures) || family.textures.length > 32
+                || !Array.isArray(family.lods) || family.lods.length < 1 || family.lods.length > 4)
+                throw new Error('placements: invalid inventory family');
+            const textures = [], textureBytes = { bc7: 0, astc: 0, etc2: 0, rgba8: 0 };
+            for (const uri of family.textures) {
+                const receipt = catalog.textures?.[uri];
+                if (!receipt)
+                    throw new Error(`placements: unpinned texture ${uri}`);
+                const { id, data } = await copy(uri, receipt.sha256, 'image/ktx2');
+                if (data.length < 80 || data.subarray(0, 12).toString('hex') !== 'ab4b5458203230bb0d0a1a0a')
+                    throw new Error(`placements: invalid KTX2 ${uri}`);
+                const width = data.readUInt32LE(20), height = data.readUInt32LE(24), levels = data.readUInt32LE(40);
+                if (width < 1 || height < 1 || width > 8192 || height > 8192 || levels !== Math.floor(Math.log2(Math.max(width, height))) + 1
+                    || data.readUInt32LE(28) !== 0 || data.readUInt32LE(32) !== 0 || data.readUInt32LE(36) !== 1)
+                    throw new Error(`placements: unsupported KTX2 shape ${uri}`);
+                for (let level = 0; level < levels; level++) {
+                    const w = Math.max(1, width >> level), h = Math.max(1, height >> level), blocks = Math.ceil(w / 4) * Math.ceil(h / 4) * 16;
+                    textureBytes.bc7 += blocks;
+                    textureBytes.etc2 += blocks;
+                    textureBytes.astc += blocks;
+                    textureBytes.rgba8 += w * h * 4;
+                }
+                textures.push({ uri, resource: id });
+            }
+            const lods = [], referencedTextures = new Set();
+            for (const lod of family.lods) {
+                const { id, data } = await copy(lod.file, lod.sha256, 'model/gltf-binary');
+                if (data.length < 20 || data.readUInt32LE(0) !== 0x46546c67 || data.readUInt32LE(4) !== 2
+                    || data.readUInt32LE(8) !== data.length || data.readUInt32LE(16) !== 0x4e4f534a || data.readUInt32LE(12) > 1_048_576) {
+                    throw new Error(`placements: invalid GLB ${lod.file}`);
+                }
+                const gltf = JSON.parse(data.subarray(20, 20 + data.readUInt32LE(12)).toString('utf8'));
+                if (gltf.animations?.length || gltf.skins?.length || gltf.buffers?.some((b) => b.uri))
+                    throw new Error('placements: prototypes must be static self-contained geometry');
+                for (const image of gltf.images ?? []) {
+                    if (!textures.some(t => t.uri === image.uri) || image.bufferView !== undefined)
+                        throw new Error(`placements: undeclared GLB texture ${image.uri}`);
+                    referencedTextures.add(image.uri);
+                }
+                let triangles = 0, primitives = 0;
+                for (const mesh of gltf.meshes ?? [])
+                    for (const primitive of mesh.primitives ?? []) {
+                        if ((primitive.mode ?? 4) !== 4 || primitive.targets?.length || primitive.attributes?.POSITION === undefined
+                            || primitive.attributes?.NORMAL === undefined)
+                            throw new Error('placements: prototypes require static triangle positions and normals');
+                        if (item.wind.model !== 'off' && primitive.attributes._HELIX_WIND === undefined)
+                            throw new Error('placements: wind prototype has no explicit weights');
+                        const accessor = gltf.accessors?.[primitive.indices ?? primitive.attributes.POSITION];
+                        if (!accessor || !Number.isInteger(accessor.count) || accessor.count % 3)
+                            throw new Error('placements: invalid triangle count');
+                        triangles += accessor.count / 3;
+                        primitives++;
+                    }
+                if (triangles !== lod.triangles || primitives < 1 || primitives > 8)
+                    throw new Error('placements: triangle receipt mismatch or too many primitives');
+                lods.push({ model: id, triangles, materials: primitives, minPixels: lod.minPixels });
+            }
+            if (referencedTextures.size !== textures.length)
+                throw new Error('placements: unused or duplicate family texture');
+            families.push({ id: familyId, lods, textures, textureBytes });
+        }
+        const proxyLod = item.giProxy === null ? null : Object.values(item.families)
+            .flatMap(f => f.lods).find(lod => lod.file === item.giProxy);
+        if (item.giProxy !== null && !proxyLod)
+            throw new Error('placements: GI proxy must reference a pinned prepared LOD');
+        prototypes.push({ id: item.id, category: item.category, structural: item.structural, bounds: item.bounds, families,
+            wind: { model: item.wind.model, maxDisplacementM: item.wind.maxDisplacementM }, collider: item.collider,
+            giProxy: proxyLod ? `placements.${proxyLod.sha256}` : null, shadowDistanceM: item.structural ? 96 : 0 });
+    }
+    const errors = (0, helix_manifest_1.validatePlacementsDeclaration)({ version: 1, regionSize: 256, prototypes,
+        regions: [{ x: 0, z: 0, resource: 'pending', bytes: 32, structuralCount: 0, bounds: { min: [0, 0, 0], max: [256, 1, 256] } }] }, (value, path, mime, issues) => { if (value !== 'pending' && files.get(value)?.mimeType !== mime)
+        issues.push(`${path}: invalid resource`); });
+    if (errors.length)
+        throw new Error(errors.join('; '));
+    return { prototypes, files: [...files.values()] };
+}
+//# sourceMappingURL=assets.js.map

package/dist/placements/assets.js.map

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

package/dist/placements/attachFoliageLods.d.ts

@@ -0,0 +1,4 @@
+import { type HelixSceneV2, type PlacementsDeclaration } from '@hypersoniclabs/helix-manifest';
+export declare function validateFoliageLodReplacement(original: PlacementsDeclaration, replacement: PlacementsDeclaration): void;
+/** Apply a local foliage bake after checking that placement population, LOD0, GI and distant coverage are unchanged. */
+export declare function attachFoliageLods(sceneFile: string, directory: string): Promise<HelixSceneV2>;

package/dist/placements/attachFoliageLods.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFoliageLodReplacement = validateFoliageLodReplacement;
+exports.attachFoliageLods = attachFoliageLods;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const node_util_1 = require("node:util");
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const source_1 = require("./source");
+function validateFoliageLodReplacement(original, replacement) {
+    const restored = JSON.parse(JSON.stringify(replacement));
+    for (const [index, prototype] of original.prototypes.entries()) {
+        const next = restored.prototypes[index];
+        if (!next || next.families.length !== prototype.families.length)
+            throw new Error('Foliage prototype mismatch');
+        for (const [familyIndex, family] of prototype.families.entries()) {
+            const nextFamily = next.families[familyIndex];
+            if (nextFamily.lods.length !== family.lods.length || !(0, node_util_1.isDeepStrictEqual)(nextFamily.lods[0], family.lods[0])) {
+                throw new Error('Foliage replacement must preserve the finest LOD');
+            }
+            if (prototype.category !== 'tree')
+                continue;
+            for (let level = 1; level < family.lods.length; level++) {
+                const before = family.lods[level], after = nextFamily.lods[level];
+                if (after.triangles > before.triangles || after.materials > before.materials || after.minPixels !== before.minPixels) {
+                    throw new Error('Foliage replacement exceeds existing geometry/material budgets or changes LOD thresholds');
+                }
+            }
+            nextFamily.lods = family.lods;
+            nextFamily.textures = family.textures;
+            nextFamily.textureBytes = family.textureBytes;
+        }
+    }
+    if (!(0, node_util_1.isDeepStrictEqual)(original, restored))
+        throw new Error('Foliage replacement changes placements, bounds, GI or distant trees');
+}
+/** Apply a local foliage bake after checking that placement population, LOD0, GI and distant coverage are unchanged. */
+async function attachFoliageLods(sceneFile, directory) {
+    const original = JSON.parse(await (0, promises_1.readFile)(sceneFile, 'utf8'));
+    if (!(0, helix_manifest_1.validateSceneDocument)(original).valid || !(0, helix_manifest_1.verifySceneDocumentIntegrity)(original) || !original.placements) {
+        throw new Error('Expected a valid sealed Scene v2 document with placements');
+    }
+    const bake = (0, source_1.readPlacementsBake)(directory);
+    validateFoliageLodReplacement(original.placements, bake.placements);
+    const bundle = (0, source_1.placementsBundle)(directory), resources = new Map(original.resources.map(resource => [resource.id, resource]));
+    for (const resource of bundle.resources) {
+        const previous = resources.get(resource.id);
+        if (previous && !(0, node_util_1.isDeepStrictEqual)(previous, resource))
+            throw new Error('Conflicting existing foliage resource: ' + resource.id);
+        resources.set(resource.id, resource);
+    }
+    const scene = { ...original, placements: bake.placements, resources: [...resources.values()],
+        revision: (0, source_1.placementsDigest)(Buffer.from(JSON.stringify(bake.placements))).slice(0, 16) };
+    scene.integrity = { sha256: (0, helix_manifest_1.computeSceneDocumentIntegrity)(scene) };
+    const validation = (0, helix_manifest_1.validateSceneDocument)(scene);
+    if (!validation.valid)
+        throw new Error(validation.errors.join('; '));
+    const root = (0, node_path_1.dirname)(sceneFile);
+    for (const file of bundle.bundleFiles) {
+        const destination = (0, node_path_1.resolve)(root, file.uri);
+        await (0, promises_1.mkdir)((0, node_path_1.dirname)(destination), { recursive: true });
+        await (0, promises_1.copyFile)(file.path, destination);
+    }
+    const pending = sceneFile + '.pending';
+    await (0, promises_1.writeFile)(pending, JSON.stringify(scene, null, 2) + '\n');
+    await (0, promises_1.rename)(pending, sceneFile);
+    await (0, promises_1.writeFile)((0, node_path_1.resolve)(root, 'placements/placements.json'), JSON.stringify(bake, null, 2) + '\n');
+    return scene;
+}
+//# sourceMappingURL=attachFoliageLods.js.map

package/dist/placements/attachFoliageLods.js.map

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

package/dist/placements/attachImpostors.d.ts

@@ -0,0 +1,3 @@
+import { type HelixSceneV2 } from '@hypersoniclabs/helix-manifest';
+/** Attach a bake of the exact same fine placements to a local Scene v2 file, then reseal it. No network/publication. */
+export declare function attachTreeImpostors(sceneFile: string, directory: string): Promise<HelixSceneV2>;

package/dist/placements/attachImpostors.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attachTreeImpostors = attachTreeImpostors;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const node_util_1 = require("node:util");
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const source_1 = require("./source");
+/** Attach a bake of the exact same fine placements to a local Scene v2 file, then reseal it. No network/publication. */
+async function attachTreeImpostors(sceneFile, directory) {
+    const original = JSON.parse(await (0, promises_1.readFile)(sceneFile, 'utf8'));
+    const validation = (0, helix_manifest_1.validateSceneDocument)(original);
+    if (!validation.valid || !(0, helix_manifest_1.verifySceneDocumentIntegrity)(original))
+        throw new Error('Expected a valid, sealed local Scene v2 document');
+    if (!original.placements)
+        throw new Error('The scene has no fine placements');
+    const bake = (0, source_1.readPlacementsBake)(directory);
+    if (!bake.placements.distant)
+        throw new Error('The placements bake has no distant trees');
+    const { distant: _old, ...fine } = original.placements, { distant, ...bakedFine } = bake.placements;
+    if (!(0, node_util_1.isDeepStrictEqual)(fine, bakedFine))
+        throw new Error('Impostors were baked from different fine placements; rebuild from this scene inventory');
+    const root = (0, node_path_1.dirname)(sceneFile), resources = new Map(original.resources.map(resource => [resource.id, resource]));
+    const ids = new Set([...distant.pages.map(page => page.resource), ...distant.atlases.flatMap(atlas => [atlas.color, atlas.normal])]);
+    for (const file of bake.files.filter(file => ids.has(file.id))) {
+        const resource = { id: file.id, kind: file.mimeType === helix_manifest_1.PLACEMENTS_DISTANT_MIME ? 'component-data' : 'texture',
+            source: { kind: 'bundle', assetId: file.id, uri: `placements/${file.path}` }, mimeType: file.mimeType,
+            bytes: file.bytes, integrity: { sha256: file.sha256 }, required: true };
+        const previous = resources.get(file.id);
+        if (previous && !(0, node_util_1.isDeepStrictEqual)(previous, resource))
+            throw new Error('Conflicting existing impostor resource: ' + file.id);
+        const destination = (0, node_path_1.resolve)(root, 'placements', file.path);
+        await (0, promises_1.mkdir)((0, node_path_1.dirname)(destination), { recursive: true });
+        await (0, promises_1.copyFile)((0, source_1.placementsFilePath)(directory, file.path), destination);
+        resources.set(file.id, resource);
+    }
+    const scene = { ...original, placements: bake.placements, resources: [...resources.values()],
+        capabilities: { ...original.capabilities, required: [...new Set([...original.capabilities.required, helix_manifest_1.PLACEMENTS_DISTANT_CAPABILITY])] },
+        revision: (0, source_1.placementsDigest)(Buffer.from(JSON.stringify(distant))).slice(0, 16) };
+    scene.integrity = { sha256: (0, helix_manifest_1.computeSceneDocumentIntegrity)(scene) };
+    const checked = (0, helix_manifest_1.validateSceneDocument)(scene);
+    if (!checked.valid)
+        throw new Error(checked.errors.join('; '));
+    const pending = sceneFile + '.pending';
+    await (0, promises_1.writeFile)(pending, JSON.stringify(scene, null, 2) + '\n');
+    await (0, promises_1.rename)(pending, sceneFile);
+    // Keep the authoring inventory beside the resources for subsequent reproducible bakes.
+    await (0, promises_1.writeFile)((0, node_path_1.resolve)(root, 'placements/placements.json'), JSON.stringify(bake, null, 2) + '\n');
+    return scene;
+}
+//# sourceMappingURL=attachImpostors.js.map

package/dist/placements/attachImpostors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachImpostors.js","sourceRoot":"","sources":["../../src/placements/attachImpostors.ts"],"names":[],"mappings":";;AAQA,kDA+BC;AAvCD,+CAAgF;AAChF,yCAA6C;AAC7C,yCAA8C;AAC9C,mEACyG;AACzG,qCAAoF;AAEpF,wHAAwH;AACjH,KAAK,UAAU,mBAAmB,CAAC,SAAiB,EAAE,SAAiB;IAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAA,mBAAQ,EAAC,SAAS,EAAE,MAAM,CAAC,CAAiB,CAAC;IAC/E,MAAM,UAAU,GAAG,IAAA,sCAAqB,EAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,IAAA,6CAA4B,EAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtI,IAAI,CAAC,QAAQ,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,IAAA,2BAAkB,EAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC1F,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;IACpG,IAAI,CAAC,IAAA,6BAAiB,EAAC,IAAI,EAAE,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wFAAwF,CAAC,CAAC;IACnJ,MAAM,IAAI,GAAG,IAAA,mBAAO,EAAC,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAClH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACrI,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC/D,MAAM,QAAQ,GAAkB,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,KAAK,wCAAuB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;YAC3H,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,cAAc,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACrG,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC1E,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,QAAQ,IAAI,CAAC,IAAA,6BAAiB,EAAC,QAAQ,EAAE,QAAQ,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9H,MAAM,WAAW,GAAG,IAAA,mBAAO,EAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,IAAA,gBAAK,EAAC,IAAA,mBAAO,EAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,IAAA,mBAAQ,EAAC,IAAA,2BAAkB,EAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;QAC9H,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,KAAK,GAAiB,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;QACxG,YAAY,EAAE,EAAE,GAAG,QAAQ,CAAC,YAAY,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,8CAA6B,CAAC,CAAC,CAAC,EAAE;QACtI,QAAQ,EAAE,IAAA,yBAAgB,EAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAClF,KAAK,CAAC,SAAS,GAAG,EAAE,MAAM,EAAE,IAAA,8CAA6B,EAAC,KAAK,CAAC,EAAE,CAAC;IACnE,MAAM,OAAO,GAAG,IAAA,sCAAqB,EAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;IAAC,MAAM,IAAA,oBAAS,EAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAAC,MAAM,IAAA,iBAAM,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC1I,uFAAuF;IACvF,MAAM,IAAA,oBAAS,EAAC,IAAA,mBAAO,EAAC,IAAI,EAAE,4BAA4B,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACnG,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/placements/authored.d.ts

@@ -0,0 +1,11 @@
+import { type PlacementRecord, type PlacementPrototype } from '@hypersoniclabs/helix-manifest';
+import { type PlacementsBake, type PlacementsSourceFile } from './source';
+export interface AuthoredPlacementsInput {
+    output: string;
+    prototypes: PlacementPrototype[];
+    files: PlacementsSourceFile[];
+    records: Iterable<PlacementRecord>;
+    heightAt: (x: number, z: number) => number;
+}
+/** Stream exact imported records into occupied regions without a procedural scatter pass or a giant authoring JSON. */
+export declare function bakeAuthoredPlacements(input: AuthoredPlacementsInput): Promise<PlacementsBake>;

package/dist/placements/authored.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bakeAuthoredPlacements = bakeAuthoredPlacements;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const source_1 = require("./source");
+/** Stream exact imported records into occupied regions without a procedural scatter pass or a giant authoring JSON. */
+async function bakeAuthoredPlacements(input) {
+    const regions = new Map(), ids = new Set();
+    for (const record of input.records) {
+        if (ids.has(record.id))
+            throw new Error(`placements: duplicate stable ID ${record.id}`);
+        ids.add(record.id);
+        if (ids.size > helix_manifest_1.PLACEMENTS_CAPS.placementStructuralInstances)
+            throw new Error('placements: document structural cap exceeded');
+        if (!input.prototypes[record.prototype]?.structural)
+            throw new Error('placements: exact records require a structural prototype');
+        const x = Math.floor(record.position[0] / 256), z = Math.floor(record.position[2] / 256), key = `${x},${z}`;
+        let region = regions.get(key);
+        if (!region) {
+            if (regions.size >= helix_manifest_1.PLACEMENTS_CAPS.placementRegions)
+                throw new Error('placements: region cap exceeded');
+            // Exact records carry their own elevation. This canonical grid is only the region's ground reference.
+            const metresPerSample = 16, samples = (0, helix_manifest_1.scatterGridSamples)(metresPerSample), heights = new Float32Array(samples ** 2);
+            for (let j = 0; j < samples; j++)
+                for (let i = 0; i < samples; i++) {
+                    heights[j * samples + i] = input.heightAt(x * 256 + (i - 1) * metresPerSample, z * 256 + (j - 1) * metresPerSample);
+                }
+            region = { x, z, size: 256, metresPerSample, heights, records: [], layers: [] };
+            regions.set(key, region);
+        }
+        region.records.push(record);
+        if (region.records.length > helix_manifest_1.PLACEMENTS_CAPS.placementRecordsPerRegion)
+            throw new Error(`placements: region ${key} exceeds record cap`);
+    }
+    if (!regions.size)
+        throw new Error('placements: no authored records');
+    await (0, promises_1.mkdir)((0, node_path_1.resolve)(input.output, 'objects'), { recursive: true });
+    const files = [...input.files];
+    const placements = { version: 1, regionSize: 256, prototypes: input.prototypes, regions: [] };
+    for (const region of [...regions.values()].sort((a, b) => a.z - b.z || a.x - b.x)) {
+        region.records.sort((a, b) => a.id.localeCompare(b.id));
+        const bounds = (0, helix_manifest_1.placementRecordBounds)(region.records[0], input.prototypes[region.records[0].prototype]);
+        for (const record of region.records.slice(1)) {
+            const next = (0, helix_manifest_1.placementRecordBounds)(record, input.prototypes[record.prototype]);
+            for (let axis = 0; axis < 3; axis++) {
+                bounds.min[axis] = Math.min(bounds.min[axis], next.min[axis]);
+                bounds.max[axis] = Math.max(bounds.max[axis], next.max[axis]);
+            }
+        }
+        const bytes = (0, helix_manifest_1.encodePlacementsRegion)(region), sha256 = (0, source_1.placementsDigest)(bytes), id = `placements.${sha256}`;
+        const path = `objects/${sha256}.placements`;
+        await (0, promises_1.writeFile)((0, node_path_1.resolve)(input.output, path), bytes);
+        files.push({ id, path, sha256, bytes: bytes.length, mimeType: helix_manifest_1.PLACEMENTS_REGION_MIME });
+        placements.regions.push({ x: region.x, z: region.z, resource: id, bytes: bytes.length, structuralCount: region.records.length, bounds });
+    }
+    const bake = { schema: 'helix.placements-bake/1', placements, files: files.sort((a, b) => a.id.localeCompare(b.id)) };
+    const pending = (0, node_path_1.resolve)(input.output, 'placements.pending.json');
+    await (0, promises_1.writeFile)(pending, JSON.stringify(bake) + '\n');
+    const checked = (0, source_1.readPlacementsBake)(input.output, 'placements.pending.json');
+    await (0, promises_1.rename)(pending, (0, node_path_1.resolve)(input.output, 'placements.json'));
+    return checked;
+}
+//# sourceMappingURL=authored.js.map

package/dist/placements/authored.js.map

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

package/dist/placements/bake.d.ts

@@ -0,0 +1,2 @@
+import { type PlacementsBake } from './source';
+export declare function bakePlacements(sourceFile: string, output: string): Promise<PlacementsBake>;

package/dist/placements/bake.js

@@ -0,0 +1,235 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bakePlacements = bakePlacements;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const sharp_1 = __importDefault(require("sharp"));
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const source_1 = require("../terrain/source");
+const tile_1 = require("../terrain/tile");
+const grid_1 = require("../terrain/grid");
+const bake_1 = require("../terrain/bake");
+const noise_1 = require("../terrain/noise");
+const assets_1 = require("./assets");
+const source_2 = require("./source");
+function keys(value, allowed, label) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error(`placements: ${label} must be an object`);
+    for (const key of Object.keys(value))
+        if (!allowed.includes(key))
+            throw new Error(`placements: unknown ${label}.${key}`);
+}
+function range(value, min, max, label) {
+    if (!Array.isArray(value) || value.length !== 2 || value.some(n => typeof n !== 'number' || !Number.isFinite(n) || n < min || n > max)
+        || value[0] > value[1])
+        throw new Error(`placements: invalid ${label} range`);
+    return value;
+}
+function parse(data) {
+    keys(data, ['schema', 'terrain', 'catalog', 'layers', 'placements', 'metresPerSample'], 'source');
+    if (data.schema !== 'helix.placements-source/1' || typeof data.terrain !== 'string' || typeof data.catalog !== 'string'
+        || !Array.isArray(data.layers) || data.layers.length > 8)
+        throw new Error('placements: invalid source or layer cap');
+    const ids = new Set();
+    const layers = data.layers.map((entry, i) => {
+        keys(entry, ['id', 'prototype', 'seed', 'spacing', 'minSpacing', 'scale', 'alignToNormal', 'embedM', 'density',
+            'height', 'slope', 'waterLevel', 'include', 'exclude', 'mask', 'roles', 'cluster'], `layers[${i}]`);
+        const layer = { minSpacing: 0, scale: [1, 1], alignToNormal: 0, embedM: 0.05, density: 1, height: [-1e6, 1e6], slope: [0, 90], ...entry };
+        const rule = toRule(layer, 0);
+        (0, helix_manifest_1.assertScatterRule)(rule);
+        if (ids.has(layer.id) || typeof layer.prototype !== 'string')
+            throw new Error('placements: duplicate layer ID or missing prototype');
+        ids.add(layer.id);
+        range(layer.height, -1e6, 1e6, 'height');
+        range(layer.slope, 0, 90, 'slope');
+        range([layer.density, layer.density], 0, 1, 'density');
+        if (layer.waterLevel !== undefined)
+            range([layer.waterLevel, layer.waterLevel], -1e6, 1e6, 'waterLevel');
+        if (layer.mask !== undefined && typeof layer.mask !== 'string')
+            throw new Error('placements: mask must name an image');
+        for (const kind of ['include', 'exclude'])
+            if (layer[kind] !== undefined) {
+                const polygons = layer[kind];
+                if (!Array.isArray(polygons) || polygons.length > 64)
+                    throw new Error('placements: polygon count exceeds cap');
+                for (const polygon of polygons) {
+                    if (!Array.isArray(polygon) || polygon.length < 3 || polygon.length > 128)
+                        throw new Error('placements: polygons need 3..128 vertices');
+                    for (const vertex of polygon) {
+                        if (!Array.isArray(vertex) || vertex.length !== 2 || vertex.some(n => !Number.isFinite(n) || Math.abs(n) > 1e6))
+                            throw new Error('placements: invalid polygon vertex');
+                    }
+                }
+            }
+        if (layer.roles) {
+            keys(layer.roles, [...helix_manifest_1.SCENE_TERRAIN_MATERIAL_ROLES], 'roles');
+            for (const value of Object.values(layer.roles))
+                range([value, value], 0, 1, 'role weight');
+        }
+        if (layer.cluster) {
+            keys(layer.cluster, ['metres', 'strength'], 'cluster');
+            range([layer.cluster.metres, layer.cluster.metres], 1, 4096, 'cluster meters');
+            range([layer.cluster.strength, layer.cluster.strength], 0, 1, 'cluster strength');
+        }
+        return layer;
+    });
+    const metresPerSample = (data.metresPerSample ?? 1);
+    if (![0.5, 1, 2, 4, 8, 16].includes(metresPerSample))
+        throw new Error('placements: invalid canonical spacing');
+    const placements = data.placements ?? [];
+    if (!Array.isArray(placements) || placements.length > 16384)
+        throw new Error('placements: manual placement count exceeds cap');
+    for (const row of placements) {
+        keys(row, ['id', 'prototype', 'position', 'rotation', 'scale'], 'placement');
+        if (typeof row.id !== 'string' || row.id.length < 1 || row.id.length > 128 || typeof row.prototype !== 'string')
+            throw new Error('placements: invalid manual identity');
+    }
+    return { schema: 'helix.placements-source/1', terrain: data.terrain, catalog: data.catalog, layers,
+        placements: placements, metresPerSample };
+}
+function toRule(layer, prototype) {
+    return { id: layer.id, prototype, seed: layer.seed, spacing: layer.spacing, minSpacing: layer.minSpacing, scale: layer.scale,
+        alignToNormal: layer.alignToNormal, embedM: layer.embedM };
+}
+function inside(polygon, x, z) {
+    let inside = false;
+    for (let i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {
+        const [xi, zi] = polygon[i], [xj, zj] = polygon[j];
+        if ((zi > z) !== (zj > z) && x < (xj - xi) * (z - zi) / (zj - zi) + xi)
+            inside = !inside;
+    }
+    return inside;
+}
+function expand(target, next) {
+    for (let i = 0; i < 3; i++) {
+        target.min[i] = Math.min(target.min[i], next.min[i]);
+        target.max[i] = Math.max(target.max[i], next.max[i]);
+    }
+}
+async function bakePlacements(sourceFile, output) {
+    if ((await (0, promises_1.stat)(sourceFile)).size > 1_048_576)
+        throw new Error('placements: authoring source exceeds 1 MiB');
+    const config = parse(JSON.parse(await (0, promises_1.readFile)(sourceFile, 'utf8'))), base = (0, node_path_1.dirname)(sourceFile);
+    const terrain = await (0, source_1.readTerrainSource)((0, node_path_1.resolve)(base, config.terrain));
+    // Shared edge selection remains canonical even when terrain.json lists its tiles in another order.
+    terrain.tiles.sort((a, b) => a.tz - b.tz || a.tx - b.tx);
+    const grid = (0, tile_1.gridFromTerrainSource)(terrain), inventory = await (0, assets_1.preparePlacementsInventory)((0, node_path_1.resolve)(base, config.catalog), output);
+    const { prototypes, files } = inventory, prototypeIndex = (id) => {
+        const index = prototypes.findIndex(p => p.id === id);
+        if (index < 0)
+            throw new Error(`placements: unknown prototype ${id}`);
+        return index;
+    };
+    const roleSampler = terrain.preset ? (0, bake_1.createTerrainRoleSampler)(grid, terrain.preset) : null;
+    if (!roleSampler && config.layers.some(l => l.roles))
+        throw new Error('placements: terrain roles require the source preset; GPU splat channels are not semantic roles');
+    const layers = await Promise.all(config.layers.map(async (layer) => ({ rule: toRule(layer, prototypeIndex(layer.prototype)), source: layer,
+        image: layer.mask ? await (0, sharp_1.default)((0, node_path_1.resolve)(base, layer.mask), { limitInputPixels: 16_777_216 }).greyscale().raw().toBuffer({ resolveWithObject: true }) : null })));
+    const maxX = grid.originX + (grid.samplesX - 1) * grid.metresPerSample, maxZ = grid.originZ + (grid.samplesZ - 1) * grid.metresPerSample;
+    const x0 = Math.floor(grid.originX / 256), x1 = Math.ceil(maxX / 256), z0 = Math.floor(grid.originZ / 256), z1 = Math.ceil(maxZ / 256);
+    if ((x1 - x0) * (z1 - z0) > helix_manifest_1.PLACEMENTS_CAPS.placementRegions)
+        throw new Error('placements: region cap exceeded');
+    const declaration = { version: 1, regionSize: 256, prototypes, regions: [] }, stableIds = new Set();
+    let total = 0;
+    for (let z = z0; z < z1; z++)
+        for (let x = x0; x < x1; x++) {
+            const step = config.metresPerSample, samples = (0, helix_manifest_1.scatterGridSamples)(step), count = samples ** 2;
+            const region = { x, z, size: 256, metresPerSample: step, heights: new Float32Array(count), records: [],
+                layers: layers.map(layer => ({ rule: layer.rule, mask: new Uint8Array(count) })) };
+            let low = Infinity, high = -Infinity;
+            for (let j = 0; j < samples; j++)
+                for (let i = 0; i < samples; i++) {
+                    const wx = x * 256 + (i - 1) * step, wz = z * 256 + (j - 1) * step, k = j * samples + i;
+                    const y = Math.fround((0, grid_1.sampleFieldHeight)(grid, wx, wz));
+                    region.heights[k] = y;
+                    low = Math.min(low, y);
+                    high = Math.max(high, y);
+                    const gx = Math.max(0, Math.min(grid.samplesX - 1, Math.round((wx - grid.originX) / grid.metresPerSample)));
+                    const gz = Math.max(0, Math.min(grid.samplesZ - 1, Math.round((wz - grid.originZ) / grid.metresPerSample)));
+                    const slope = (0, grid_1.slopeDeg)(grid, gx, gz), roles = roleSampler && layers.some(l => l.source.roles) ? roleSampler(gx, gz) : null;
+                    for (const [n, layer] of layers.entries()) {
+                        const source = layer.source;
+                        // Expand the hole veto to cover the canonical sample's footprint when this bake uses a coarser grid.
+                        let hole = false;
+                        for (let dz = -Math.ceil(step / 2); dz <= Math.ceil(step / 2) && !hole; dz++) {
+                            for (let dx = -Math.ceil(step / 2); dx <= Math.ceil(step / 2); dx++)
+                                if ((0, grid_1.isHoleAt)(grid, gx + dx, gz + dz)) {
+                                    hole = true;
+                                    break;
+                                }
+                        }
+                        if (wx < grid.originX || wx > maxX || wz < grid.originZ || wz > maxZ || hole
+                            || y < source.height[0] || y > source.height[1] || slope < source.slope[0] || slope > source.slope[1]
+                            || (source.waterLevel !== undefined && y <= source.waterLevel)
+                            || (source.include?.length && !source.include.some(p => inside(p, wx, wz))) || source.exclude?.some(p => inside(p, wx, wz)))
+                            continue;
+                        let weight = source.density;
+                        if (source.roles && roles)
+                            weight *= Object.entries(source.roles).reduce((sum, [role, gain]) => sum + (roles[role] ?? 0) * gain, 0);
+                        if (source.cluster)
+                            weight *= 1 - source.cluster.strength + source.cluster.strength
+                                * (0.5 + (0, noise_1.fbm)(wx / source.cluster.metres, wz / source.cluster.metres, 3, source.seed) * 0.5);
+                        if (layer.image) {
+                            const { data, info } = layer.image, ix = Math.round((wx - grid.originX) / (maxX - grid.originX) * (info.width - 1));
+                            const iz = Math.round((wz - grid.originZ) / (maxZ - grid.originZ) * (info.height - 1));
+                            weight *= data[(iz * info.width + ix) * info.channels] / 255;
+                        }
+                        region.layers[n].mask[k] = Math.round(Math.max(0, Math.min(1, weight)) * 255);
+                    }
+                }
+            const structural = region.layers.filter(l => prototypes[l.rule.prototype].structural);
+            for (let cz = z * 16; cz < (z + 1) * 16; cz++)
+                for (let cx = x * 16; cx < (x + 1) * 16; cx++) {
+                    region.records.push(...(0, helix_manifest_1.generateScatterCell)({ ...region, layers: structural }, cx, cz, 16));
+                    if (region.records.length > helix_manifest_1.PLACEMENTS_CAPS.placementRecordsPerRegion)
+                        throw new Error(`placements: region ${x},${z} exceeds structural cap; increase spacing`);
+                }
+            region.layers = region.layers.filter(l => !prototypes[l.rule.prototype].structural);
+            for (const manual of config.placements) {
+                if (!Array.isArray(manual.position) || manual.position.length !== 3 || manual.position.some(n => !Number.isFinite(n)))
+                    throw new Error('placements: invalid manual position');
+                if (Math.floor(manual.position[0] / 256) !== x || Math.floor(manual.position[2] / 256) !== z)
+                    continue;
+                const prototype = prototypeIndex(manual.prototype);
+                if (!prototypes[prototype].structural)
+                    throw new Error('placements: manual exact placements require a structural prototype');
+                region.records.push({ ...manual, id: (0, source_2.placementsDigest)(new TextEncoder().encode(`manual:${manual.id}`)).slice(0, 32), prototype });
+            }
+            const bounds = { min: [x * 256, low, z * 256], max: [(x + 1) * 256, high, (z + 1) * 256] };
+            region.records.sort((a, b) => a.id.localeCompare(b.id));
+            for (const record of region.records) {
+                if (stableIds.has(record.id))
+                    throw new Error(`placements: duplicate stable ID ${record.id}`);
+                stableIds.add(record.id);
+                expand(bounds, (0, helix_manifest_1.placementRecordBounds)(record, prototypes[record.prototype]));
+            }
+            for (const layer of region.layers) {
+                const prototype = prototypes[layer.rule.prototype];
+                const radius = Math.hypot(...prototype.bounds.min.map((n, i) => Math.max(Math.abs(n), Math.abs(prototype.bounds.max[i])))) * layer.rule.scale[1]
+                    + prototype.wind.maxDisplacementM * layer.rule.scale[1] + layer.rule.embedM;
+                expand(bounds, { min: [x * 256 - radius, low - radius, z * 256 - radius], max: [(x + 1) * 256 + radius, high + radius, (z + 1) * 256 + radius] });
+            }
+            total += region.records.length;
+            if (total > helix_manifest_1.PLACEMENTS_CAPS.placementStructuralInstances)
+                throw new Error('placements: document structural cap exceeded');
+            const bytes = (0, helix_manifest_1.encodePlacementsRegion)(region), sha256 = (0, source_2.placementsDigest)(bytes), id = `placements.${sha256}`, path = `objects/${sha256}.placements`;
+            await (0, promises_1.writeFile)((0, node_path_1.resolve)(output, path), bytes);
+            files.push({ id, path, sha256, bytes: bytes.length, mimeType: helix_manifest_1.PLACEMENTS_REGION_MIME });
+            declaration.regions.push({ x, z, resource: id, bytes: bytes.length, structuralCount: region.records.length, bounds });
+        }
+    for (const manual of config.placements) {
+        if (!declaration.regions.some(r => r.x === Math.floor(manual.position[0] / 256) && r.z === Math.floor(manual.position[2] / 256))) {
+            throw new Error(`placements: manual placement ${manual.id} is outside the authored terrain regions`);
+        }
+    }
+    const bake = { schema: 'helix.placements-bake/1', placements: declaration, files: files.sort((a, b) => a.id.localeCompare(b.id)) };
+    const pending = (0, node_path_1.resolve)(output, 'placements.pending.json');
+    await (0, promises_1.writeFile)(pending, JSON.stringify(bake, null, 2) + '\n');
+    const checked = (0, source_2.readPlacementsBake)(output, 'placements.pending.json');
+    await (0, promises_1.rename)(pending, (0, node_path_1.resolve)(output, 'placements.json'));
+    return checked;
+}
+//# sourceMappingURL=bake.js.map