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

package/dist/placements/impostors.js

@@ -0,0 +1,279 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.partitionDistantTrees = partitionDistantTrees;
+exports.dilateImpostorColors = dilateImpostorColors;
+exports.bakeTreeImpostors = bakeTreeImpostors;
+const node_http_1 = require("node:http");
+const promises_1 = require("node:fs/promises");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const hostSlots_1 = require("../browser/hostSlots");
+const nonSystemChrome_1 = require("../browser/nonSystemChrome");
+const sharp_1 = __importDefault(require("sharp"));
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const source_1 = require("./source");
+const impostorCapture_1 = require("./impostorCapture");
+const launch_1 = require("../browser/launch");
+const esm_1 = require("../character/esm");
+function partitionDistantTrees(records, treePrototypes) {
+    const pages = new Map();
+    for (const record of records) {
+        if (!treePrototypes.has(record.prototype))
+            continue;
+        const x = Math.floor(Math.fround(record.position[0]) / 1024), z = Math.floor(Math.fround(record.position[2]) / 1024);
+        const key = `${x}:${z}:${record.prototype}`;
+        let page = pages.get(key);
+        if (!page) {
+            page = { x, z, prototype: record.prototype, records: [] };
+            pages.set(key, page);
+        }
+        page.records.push(record);
+    }
+    return [...pages.values()].sort((a, b) => a.z - b.z || a.x - b.x || a.prototype - b.prototype);
+}
+/** Dilate RGB within each capture tile while retaining alpha; empty atlas gutters do not become black fringes. */
+function dilateImpostorColors(data, size, steps = 4) {
+    const result = Uint8Array.from(data), cell = size / 8, occupied = new Uint8Array(size * size);
+    for (let i = 0; i < occupied.length; i++)
+        occupied[i] = data[i * 4 + 3] > 0 ? 1 : 0;
+    for (let step = 0; step < steps; step++) {
+        const next = occupied.slice(), previous = result.slice();
+        for (let y = 0; y < size; y++)
+            for (let x = 0; x < size; x++) {
+                const i = y * size + x;
+                if (occupied[i])
+                    continue;
+                const candidates = [x % cell ? i - 1 : -1, x % cell < cell - 1 ? i + 1 : -1,
+                    y % cell ? i - size : -1, y % cell < cell - 1 ? i + size : -1];
+                const neighbor = candidates.find(n => n >= 0 && occupied[n]);
+                if (neighbor === undefined)
+                    continue;
+                for (let c = 0; c < 3; c++)
+                    result[i * 4 + c] = previous[neighbor * 4 + c];
+                next[i] = 1;
+            }
+        occupied.set(next);
+    }
+    return result;
+}
+/** Reusable offline bake over any validated structural-tree placement inventory; no world-specific assets or paths. */
+async function bakeTreeImpostors(directory, output, options = {}) {
+    const input = (0, source_1.readPlacementsBake)(directory), size = options.size ?? 512;
+    if (size !== 512 && size !== 1024)
+        throw new Error('Tree impostor size must be 512 or 1024');
+    if ((0, node_fs_1.existsSync)((0, node_path_1.resolve)(output, 'placements.json')))
+        throw new Error('Impostor output already has placements.json; use a new output folder');
+    const trees = input.placements.prototypes.map((prototype, index) => ({ prototype, index }))
+        .filter(({ prototype }) => prototype.category === 'tree' && prototype.structural);
+    if (!trees.length)
+        throw new Error('No structural tree prototypes to bake');
+    await (0, promises_1.mkdir)((0, node_path_1.resolve)(output, 'objects'), { recursive: true });
+    const sourceFiles = new Map(input.files.map(file => [file.id, file]));
+    const files = [], atlases = [], pages = [];
+    const { distant: _oldDistant, ...declaration } = input.placements;
+    const used = new Set();
+    for (const prototype of declaration.prototypes) {
+        if (prototype.giProxy)
+            used.add(prototype.giProxy);
+        for (const family of prototype.families) {
+            for (const lod of family.lods)
+                used.add(lod.model);
+            for (const texture of family.textures)
+                used.add(texture.resource);
+        }
+    }
+    for (const region of declaration.regions)
+        used.add(region.resource);
+    for (const id of used) {
+        const file = sourceFiles.get(id);
+        await (0, promises_1.mkdir)((0, node_path_1.dirname)((0, node_path_1.resolve)(output, file.path)), { recursive: true });
+        await (0, promises_1.copyFile)((0, source_1.placementsFilePath)(directory, file.path), (0, node_path_1.resolve)(output, file.path));
+        files.push(file);
+    }
+    async function put(data, mimeType, extension) {
+        const sha256 = (0, source_1.placementsDigest)(data), id = `placements.${sha256}`, path = `objects/${sha256}.${extension}`;
+        await (0, promises_1.writeFile)((0, node_path_1.resolve)(output, path), data);
+        if (!files.some(f => f.id === id))
+            files.push({ id, sha256, path, bytes: data.length, mimeType });
+        return id;
+    }
+    const threeRoot = (0, node_path_1.resolve)((0, node_path_1.dirname)(require.resolve('three')), '..');
+    const server = (0, node_http_1.createServer)(async (req, res) => {
+        try {
+            const url = new URL(req.url ?? '/', 'http://localhost'), route = decodeURIComponent(url.pathname);
+            if (route === '/favicon.ico') {
+                res.writeHead(204);
+                res.end();
+                return;
+            }
+            let data, mime = 'application/javascript';
+            if (route === '/') {
+                mime = 'text/html';
+                data = '<script type="importmap">{"imports":{"three":"/three/build/three.module.js"}}</script>'
+                    + '<script type="module" src="/capture.js"></script>';
+            }
+            else if (route === '/capture.js')
+                data = impostorCapture_1.IMPOSTOR_CAPTURE_SCRIPT;
+            else if (route.startsWith('/asset/')) {
+                const file = sourceFiles.get(route.slice(7));
+                if (!file)
+                    throw new Error('Unknown capture resource');
+                mime = file.mimeType;
+                data = await (0, promises_1.readFile)((0, source_1.placementsFilePath)(directory, file.path));
+            }
+            else if (route.startsWith('/three/')) {
+                const path = (0, node_path_1.resolve)(threeRoot, route.slice(7));
+                if (!path.startsWith(threeRoot + node_path_1.sep))
+                    throw new Error('Outside Three package');
+                mime = path.endsWith('.wasm') ? 'application/wasm' : 'application/javascript';
+                data = await (0, promises_1.readFile)(path);
+            }
+            else
+                throw new Error('Unknown capture route');
+            res.writeHead(200, { 'content-type': mime });
+            res.end(data);
+        }
+        catch {
+            res.writeHead(404);
+            res.end('Capture resource unavailable');
+        }
+    });
+    await new Promise(done => server.listen(0, '127.0.0.1', done));
+    let browser;
+    try {
+        const { chromium } = await Promise.resolve().then(() => __importStar(require('playwright')));
+        const failures = [];
+        for (const candidate of (0, launch_1.browserCandidates)()) {
+            try {
+                (0, nonSystemChrome_1.assertNotSystemChrome)(candidate.launchOptions.executablePath, candidate.launchOptions.channel);
+                browser = await (0, hostSlots_1.launchWithBrowserSlot)(() => chromium.launch(candidate.launchOptions), 'disconnected', { identity: `tree-impostors:${directory}` });
+                break;
+            }
+            catch (error) {
+                failures.push(String(error));
+            }
+        }
+        if (!browser)
+            throw new Error('Impostor capture browser could not launch: ' + failures.join('; '));
+        const page = await browser.newPage();
+        const errors = [];
+        page.on('pageerror', e => errors.push(e.message));
+        page.on('console', m => { if (m.type() === 'error')
+            errors.push(m.text()); });
+        await page.goto(`http://127.0.0.1:${server.address().port}/`);
+        await page.waitForFunction('window.captureReady === true', undefined, { timeout: 30000 });
+        const { encodeToKTX2 } = await (0, esm_1.importEsm)('ktx2-encoder');
+        for (const { prototype, index } of trees) {
+            options.onProgress?.(`Capturing ${prototype.id}: 64 full-sphere views, ${size}px atlases`);
+            const center = prototype.bounds.min.map((v, axis) => (v + prototype.bounds.max[axis]) / 2);
+            const radius = Math.hypot(...prototype.bounds.max.map((v, axis) => v - center[axis])) * 1.15;
+            const family = prototype.families.find(f => f.id === 'full') ?? prototype.families[0];
+            const captured = await page.evaluate(async (args) => globalThis.captureTree(args), {
+                model: `/asset/${family.lods[0].model}`, size, center, radius, diagnostics: Boolean(options.previewDirectory),
+                textures: Object.fromEntries(family.textures.map(t => [`/asset/${t.uri}`, `/asset/${t.resource}`])),
+            });
+            if (errors.length)
+                throw new Error('Impostor shader/capture failure: ' + errors.join('\n'));
+            if (options.previewDirectory) {
+                await (0, promises_1.mkdir)(options.previewDirectory, { recursive: true });
+                for (const [i, source] of (captured.sources ?? []).entries()) {
+                    await (0, sharp_1.default)(Buffer.from(source.image, 'base64'), { raw: { width: 256, height: 256, channels: 4 } }).flip()
+                        .toFile((0, node_path_1.resolve)(options.previewDirectory, `${prototype.id}.source-${i}.png`));
+                    options.onProgress?.(JSON.stringify({ prototype: prototype.id, material: i, alphaTest: source.alphaTest, map: source.hasMap, flipY: source.flipY }));
+                }
+            }
+            const encoded = {};
+            for (const kind of ['color', 'normal']) {
+                const raw = dilateImpostorColors(Buffer.from(captured[kind], 'base64'), size);
+                const png = await (0, sharp_1.default)(raw, { raw: { width: size, height: size, channels: 4 } }).png().toBuffer();
+                if (options.previewDirectory) {
+                    await (0, promises_1.mkdir)(options.previewDirectory, { recursive: true });
+                    await (0, sharp_1.default)(png).flip().toFile((0, node_path_1.resolve)(options.previewDirectory, `${prototype.id}.${kind}.png`));
+                }
+                const bytes = await encodeToKTX2(png, { isUASTC: true, uastcLDRQualityLevel: 2, needSupercompression: true,
+                    generateMipmap: true, isKTX2File: true, isPerceptual: kind === 'color', isSetKTX2SRGBTransferFunc: kind === 'color',
+                    imageDecoder: async (data) => {
+                        const image = await (0, sharp_1.default)(Buffer.from(data)).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+                        return { data: new Uint8Array(image.data), width: image.info.width, height: image.info.height };
+                    } });
+                encoded[kind] = await put(bytes, 'image/ktx2', 'ktx2');
+            }
+            atlases.push({ prototype: index, color: encoded.color, normal: encoded.normal, size, views: 8, center, radius });
+        }
+    }
+    finally {
+        try {
+            await browser?.close();
+        }
+        finally {
+            server.closeAllConnections();
+            await new Promise(done => server.close(() => done()));
+        }
+    }
+    const treeIndices = new Set(trees.map(t => t.index)), records = [];
+    for (const reference of declaration.regions) {
+        const file = sourceFiles.get(reference.resource);
+        records.push(...(0, helix_manifest_1.decodePlacementsRegion)(await (0, promises_1.readFile)((0, source_1.placementsFilePath)(directory, file.path))).records);
+    }
+    for (const group of partitionDistantTrees(records, treeIndices)) {
+        group.records.sort((a, b) => a.id.localeCompare(b.id));
+        const transforms = new Float32Array(group.records.length * 8), bounds = {
+            min: [Infinity, Infinity, Infinity], max: [-Infinity, -Infinity, -Infinity]
+        };
+        for (const [i, record] of group.records.entries()) {
+            transforms.set([...record.position, ...record.rotation, record.scale], i * 8);
+            const box = (0, helix_manifest_1.placementRecordBounds)(record, declaration.prototypes[record.prototype]);
+            // Full camera-facing capture spheres conservatively enclose the card, including its transparent border.
+            const atlas = atlases.find(a => a.prototype === record.prototype), reach = (Math.hypot(...atlas.center) + atlas.radius * Math.SQRT2) * record.scale;
+            for (let axis = 0; axis < 3; axis++) {
+                bounds.min[axis] = Math.min(bounds.min[axis], box.min[axis], record.position[axis] - reach);
+                bounds.max[axis] = Math.max(bounds.max[axis], box.max[axis], record.position[axis] + reach);
+            }
+        }
+        const bytes = (0, helix_manifest_1.encodeDistantTreePage)(group, transforms), resource = await put(bytes, helix_manifest_1.PLACEMENTS_DISTANT_MIME, 'dtrees');
+        pages.push({ x: group.x, z: group.z, prototype: group.prototype, count: group.records.length, bytes: bytes.length, resource, bounds });
+    }
+    const result = { schema: 'helix.placements-bake/1', placements: { ...declaration,
+            distant: { version: 1, pageSize: 1024, atlases, pages } }, files: files.sort((a, b) => a.id.localeCompare(b.id)) };
+    await (0, promises_1.writeFile)((0, node_path_1.resolve)(output, 'placements.pending.json'), JSON.stringify(result, null, 2) + '\n');
+    const checked = (0, source_1.readPlacementsBake)(output, 'placements.pending.json');
+    await (0, promises_1.rename)((0, node_path_1.resolve)(output, 'placements.pending.json'), (0, node_path_1.resolve)(output, 'placements.json'));
+    return checked;
+}
+//# sourceMappingURL=impostors.js.map

package/dist/placements/impostors.js.map

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

package/dist/placements/source.d.ts

@@ -0,0 +1,53 @@
+import { type PlacementsDeclaration, type ContinuumObjectReference, type ContinuumScenePlacementsElement, type SceneResource } from '@hypersoniclabs/helix-manifest';
+export type PlacementsSourceFile = {
+    id: string;
+    path: string;
+    sha256: string;
+    bytes: number;
+    mimeType: string;
+};
+export type PlacementsBake = {
+    schema: 'helix.placements-bake/1';
+    placements: PlacementsDeclaration;
+    files: PlacementsSourceFile[];
+};
+export declare const placementsDigest: (data: Uint8Array) => string;
+export declare function placementsFilePath(root: string, path: string): string;
+export declare function readPlacementsBake(directory: string, manifestName?: 'placements.json' | 'placements.pending.json'): PlacementsBake;
+export declare function placementsBundle(directory: string): {
+    placements: PlacementsDeclaration;
+    resources: SceneResource[];
+    bundleFiles: Array<{
+        uri: string;
+        path: string;
+        bytes: number;
+        sha256: string;
+    }>;
+};
+export declare function placementsContinuum(directory: string, id: string): {
+    element: ContinuumScenePlacementsElement;
+    objects: ContinuumObjectReference[];
+};
+export declare function inspectPlacementsBake(directory: string): {
+    regions: number;
+    prototypes: {
+        id: string;
+        category: "grass" | "rock" | "tree" | "shrub";
+        structural: boolean;
+        triangles: number[];
+        families: ("small" | "full")[];
+    }[];
+    structuralInstances: number;
+    bytes: number;
+    files: number;
+    caps: {
+        readonly placementPrototypes: 32;
+        readonly placementRegions: 4096;
+        readonly placementRegionBytes: 8388608;
+        readonly placementRecordsPerRegion: 16384;
+        readonly placementStructuralInstances: 1000000;
+        readonly scatterLayersPerRegion: 8;
+        readonly scatterGridSamples: 515;
+        readonly scatterCandidatesPerCell: 65536;
+    };
+};

package/dist/placements/source.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.placementsDigest = void 0;
+exports.placementsFilePath = placementsFilePath;
+exports.readPlacementsBake = readPlacementsBake;
+exports.placementsBundle = placementsBundle;
+exports.placementsContinuum = placementsContinuum;
+exports.inspectPlacementsBake = inspectPlacementsBake;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const placementsDigest = (data) => (0, node_crypto_1.createHash)('sha256').update(data).digest('hex');
+exports.placementsDigest = placementsDigest;
+function placementsFilePath(root, path) {
+    if (typeof path !== 'string' || (0, node_path_1.isAbsolute)(path))
+        throw new Error('placements: expected relative resource path');
+    const base = (0, node_fs_1.realpathSync)(root), target = (0, node_fs_1.realpathSync)((0, node_path_1.resolve)(base, path)), inside = (0, node_path_1.relative)(base, target);
+    if (!inside || inside === '..' || inside.startsWith(`..${node_path_1.sep}`) || (0, node_path_1.isAbsolute)(inside))
+        throw new Error(`placements: resource escapes source directory: ${path}`);
+    return target;
+}
+function readPlacementsBake(directory, manifestName = 'placements.json') {
+    const path = (0, node_path_1.resolve)(directory, manifestName);
+    if ((0, node_fs_1.statSync)(path).size > 8_388_608)
+        throw new Error('placements: bake manifest exceeds 8 MiB');
+    const bake = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+    if (!bake || bake.schema !== 'helix.placements-bake/1' || Object.keys(bake).some(k => !['schema', 'placements', 'files'].includes(k))
+        || !Array.isArray(bake.files) || bake.files.length > helix_manifest_1.HELIX_SCENE_CAPS.resources)
+        throw new Error('placements: invalid bake manifest');
+    const files = new Map(), used = new Set();
+    for (const file of bake.files) {
+        if (!file || Object.keys(file).sort().join(',') !== 'bytes,id,mimeType,path,sha256' || !/^placements\.[a-f0-9]{64}$/.test(file.id)
+            || !/^[a-f0-9]{64}$/.test(file.sha256) || file.id !== `placements.${file.sha256}` || files.has(file.id)
+            || !Number.isSafeInteger(file.bytes) || file.bytes < 1 || file.bytes > 67_108_864)
+            throw new Error('placements: invalid or duplicate file descriptor');
+        const path = placementsFilePath(directory, file.path);
+        if ((0, node_fs_1.statSync)(path).size !== file.bytes)
+            throw new Error(`placements: byte mismatch for ${file.path}`);
+        const bytes = (0, node_fs_1.readFileSync)(path);
+        if ((0, exports.placementsDigest)(bytes) !== file.sha256)
+            throw new Error(`placements: integrity mismatch for ${file.path}`);
+        files.set(file.id, file);
+    }
+    const errors = (0, helix_manifest_1.validatePlacementsDeclaration)(bake.placements, (value, path, mime, issues, bytes) => {
+        const file = files.get(value);
+        if (!file || file.mimeType !== mime || (bytes !== undefined && bytes !== file.bytes))
+            issues.push(`${path}: missing exact ${mime} file`);
+        used.add(value);
+    });
+    if (errors.length)
+        throw new Error(errors.join('; '));
+    if (used.size !== files.size || [...files.keys()].some(id => !used.has(id)))
+        throw new Error('placements: file table contains objects outside the declared closure');
+    const ids = new Set(), distantPrototypes = new Set(bake.placements.distant?.atlases.map(atlas => atlas.prototype));
+    const distantRecords = new Map();
+    const transformKey = (prototype, values) => `${prototype}:${values.join(',')}`;
+    for (const reference of bake.placements.regions) {
+        const file = files.get(reference.resource);
+        const region = (0, helix_manifest_1.decodePlacementsRegion)((0, node_fs_1.readFileSync)(placementsFilePath(directory, file.path)));
+        (0, helix_manifest_1.validatePlacementsRegionReferences)(region, bake.placements);
+        for (const row of region.records) {
+            if (ids.has(row.id))
+                throw new Error(`placements: duplicate stable placement identity ${row.id}`);
+            ids.add(row.id);
+            if (distantPrototypes.has(row.prototype)) {
+                const key = transformKey(row.prototype, new Float32Array([...row.position, ...row.rotation, row.scale]));
+                distantRecords.set(key, (distantRecords.get(key) ?? 0) + 1);
+            }
+        }
+    }
+    for (const page of bake.placements.distant?.pages ?? []) {
+        const file = files.get(page.resource), values = (0, helix_manifest_1.decodeDistantTreePage)((0, node_fs_1.readFileSync)(placementsFilePath(directory, file.path)), page);
+        for (let offset = 0; offset < values.length; offset += 8) {
+            const key = transformKey(page.prototype, values.subarray(offset, offset + 8)), count = distantRecords.get(key) ?? 0;
+            if (!count)
+                throw new Error('placements: stale, extra or duplicate distant tree transform');
+            if (count === 1)
+                distantRecords.delete(key);
+            else
+                distantRecords.set(key, count - 1);
+        }
+    }
+    if (distantRecords.size)
+        throw new Error('placements: distant trees omit structural source transforms');
+    return bake;
+}
+function placementsBundle(directory) {
+    const bake = readPlacementsBake(directory);
+    return { placements: bake.placements, resources: bake.files.map(file => ({ id: file.id,
+            kind: [helix_manifest_1.PLACEMENTS_REGION_MIME, helix_manifest_1.PLACEMENTS_DISTANT_MIME].includes(file.mimeType) ? 'component-data' : file.mimeType === 'image/ktx2' ? 'texture' : 'model',
+            source: { kind: 'bundle', assetId: file.id, uri: `placements/${file.path}` }, bytes: file.bytes,
+            integrity: { sha256: file.sha256 }, mimeType: file.mimeType, required: true })),
+        bundleFiles: bake.files.map(file => ({ uri: `placements/${file.path}`, path: placementsFilePath(directory, file.path), bytes: file.bytes, sha256: file.sha256 })) };
+}
+function placementsContinuum(directory, id) {
+    const bake = readPlacementsBake(directory), objects = bake.files.map(file => ({
+        cid: `cid:sha256:${file.sha256}`, bytes: file.bytes, mediaType: file.mimeType,
+        role: file.mimeType === helix_manifest_1.PLACEMENTS_DISTANT_MIME ? 'stream-proxy' : file.mimeType === helix_manifest_1.PLACEMENTS_REGION_MIME ? 'placements-region' : file.mimeType === 'image/ktx2' ? 'placements-texture' : 'placements-model',
+    }));
+    const byId = new Map(bake.files.map((file, index) => [file.id, objects[index]]));
+    return { element: { id, type: 'placements', placements: (0, helix_manifest_1.mapPlacementsReferences)(bake.placements, id => byId.get(id)) }, objects };
+}
+function inspectPlacementsBake(directory) {
+    const { placements, files } = readPlacementsBake(directory);
+    return { regions: placements.regions.length, prototypes: placements.prototypes.map(p => ({ id: p.id, category: p.category,
+            structural: p.structural, triangles: p.families[0].lods.map(lod => lod.triangles), families: p.families.map(f => f.id) })),
+        structuralInstances: placements.regions.reduce((sum, r) => sum + r.structuralCount, 0),
+        bytes: files.reduce((sum, file) => sum + file.bytes, 0), files: files.length, caps: helix_manifest_1.PLACEMENTS_CAPS };
+}
+//# sourceMappingURL=source.js.map

package/dist/placements/source.js.map

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

package/dist/product.d.ts

@@ -0,0 +1,84 @@
+/**
+ * What a purchase DOES. `item_grant` / `non_consumable` hand the player a
+ * UniversalItem (non_consumable additionally caps ownership via maxPerUser);
+ * `consumable` grants nothing durable — the world applies the effect itself.
+ */
+export declare const WORLD_PRODUCT_TYPES: readonly ["consumable", "non_consumable", "item_grant"];
+export type WorldProductType = (typeof WORLD_PRODUCT_TYPES)[number];
+/** Up to 64 chars, lowercase letters/digits/`_`/`-`, starting alphanumeric. */
+export declare const PRODUCT_KEY_PATTERN: RegExp;
+export declare const PRODUCT_KEY_MAX = 64;
+export declare const PRODUCT_TITLE_MAX = 120;
+export declare const PRODUCT_DESCRIPTION_MAX = 2000;
+export declare const isProductKey: (value: unknown) => value is string;
+/** The two types that must name the UniversalItem they hand over. */
+export declare const productTypeGrantsItem: (type: WorldProductType) => boolean;
+export type ProductGrantDisplay = 'wallet' | 'uses';
+export type ProductGrant = {
+    kind: 'item';
+    itemId: string;
+    quantity?: number;
+} | {
+    kind: 'pass';
+    passKey?: string;
+    durationSeconds?: number;
+} | {
+    kind: 'currency';
+    code: string;
+    amount: number;
+    display?: ProductGrantDisplay;
+};
+export declare const MAX_GRANT_EFFECTS = 8;
+export declare const MAX_GRANT_ITEM_QUANTITY = 100;
+export declare const MAX_GRANT_CURRENCY_AMOUNT = 1000000000;
+export declare const MAX_PASS_DURATION_SECONDS: number;
+/** Currency codes and pass keys share the product-key charset — world code spells all three. */
+export declare const GRANT_CODE_PATTERN: RegExp;
+export declare const GRANT_CODE_MAX = 64;
+export type ProductRegistrationInput = {
+    key?: string;
+    title: string;
+    description?: string;
+    priceLix: number;
+    /** Legacy authoring: required only when `grants` is absent, refused alongside it. */
+    type?: string;
+    itemId?: string;
+    /** The authored effect list — replaces type/itemId, and is immutable once registered. */
+    grants?: ProductGrant[];
+    maxPerUser?: number;
+};
+export type ProductRegistrationFields = {
+    key?: string;
+    title: string;
+    description?: string;
+    priceLix: number;
+    type?: WorldProductType;
+    itemId?: string;
+    grants?: ProductGrant[];
+    maxPerUser?: number;
+};
+export type ProductRegistrationPlan = {
+    fields: ProductRegistrationFields;
+    warnings: string[];
+};
+/**
+ * Build the JSON body, applying every local rule first. Keys the caller did not
+ * set are OMITTED rather than sent empty — an empty description and no
+ * description are the same row, and sending "" would look like intent.
+ */
+export declare function buildProductRegistration(input: ProductRegistrationInput): ProductRegistrationPlan;
+export type ProductUpdateInput = {
+    title?: string;
+    description?: string;
+    /** null clears the cap. */
+    maxPerUser?: number | null;
+    priceLix?: number;
+    active?: boolean;
+    /** Not patchable — carried only so an attempted rename fails HERE, with a reason. */
+    key?: string;
+    /** Not patchable either — carried only so an attempted re-grant fails HERE, with a reason. */
+    grants?: ProductGrant[];
+};
+export type ProductPatch = Omit<ProductUpdateInput, 'key' | 'grants'>;
+/** Validate a PATCH body locally and refuse an empty one (a no-op round trip that reads as success). */
+export declare function buildProductUpdate(input: ProductUpdateInput): ProductPatch;