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

package/dist/cs2/convert/trees.d.ts

@@ -0,0 +1,33 @@
+import type { PlacementPrototype, PlacementRecord } from '@hypersoniclabs/helix-manifest';
+import { type Cs2LegacyTree } from '../cityLegacy';
+export declare const CS2_REPLACEMENT_TREES: readonly ["ponderosa-pine", "douglas-fir"];
+/** Stable source slots survive bush exclusion and repeated bakes; legacy tree records have no exported entity IDs. */
+export declare function replacementTreeRecord(tree: Cs2LegacyTree, prototypes: PlacementPrototype[], sourceHeight: number, seaLevelMetres: number, heightAt: (x: number, z: number) => number): PlacementRecord | null;
+export declare function bakeCs2Trees(root: string, input: {
+    catalog: string;
+    output: string;
+    seaLevelMetres: number;
+    heightAt: (x: number, z: number) => number;
+    /** Baked CS2 roads directory; omitted, preserve every non-bush source position. */
+    roadClearance?: string;
+}): Promise<{
+    bake: import("../../placements/source").PlacementsBake;
+    counts: Record<string, number>;
+    skippedBushes: number;
+    skippedRoads: number;
+    roadClearance: {
+        schema: string;
+        mode: string;
+        roadSlots: (0 | 1 | 2 | 3 | 5 | 6)[];
+        roadIndexSha256: string;
+        examinedTrees: number;
+        excludedTrees: number;
+        roadCells: number;
+        surfaceTriangles: number;
+        excludedSourceIndices: number[];
+    } | null;
+    sourceCount: number;
+    sourceHeights: {
+        [k: string]: number;
+    };
+}>;

package/dist/cs2/convert/trees.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CS2_REPLACEMENT_TREES = void 0;
+exports.replacementTreeRecord = replacementTreeRecord;
+exports.bakeCs2Trees = bakeCs2Trees;
+const node_path_1 = require("node:path");
+const promises_1 = require("node:fs/promises");
+const treeRoadClearance_1 = require("./treeRoadClearance");
+const authored_1 = require("../../placements/authored");
+const assets_1 = require("../../placements/assets");
+const source_1 = require("../../placements/source");
+const cityLegacy_1 = require("../cityLegacy");
+const csm2_1 = require("../csm2");
+exports.CS2_REPLACEMENT_TREES = ['ponderosa-pine', 'douglas-fir'];
+/** Stable source slots survive bush exclusion and repeated bakes; legacy tree records have no exported entity IDs. */
+function replacementTreeRecord(tree, prototypes, sourceHeight, seaLevelMetres, heightAt) {
+    if (/Bush/i.test(tree.species))
+        return null;
+    if (!/Tree/i.test(tree.species) || ![tree.x, tree.y, tree.z, tree.yaw, sourceHeight, seaLevelMetres].every(Number.isFinite)
+        || sourceHeight <= 0)
+        throw new Error(`CS2 trees: invalid tree ${tree.index} (${tree.species})`);
+    const id = (0, source_1.placementsDigest)(new TextEncoder().encode(`cs2-tree:${tree.index}`)).slice(0, 32);
+    const selected = /PineTree/i.test(tree.species) ? 'ponderosa-pine' : /SpruceTree/i.test(tree.species) ? 'douglas-fir'
+        : exports.CS2_REPLACEMENT_TREES[parseInt(id.slice(0, 8), 16) % 2];
+    const prototype = prototypes.findIndex(p => p.id === selected);
+    if (prototype < 0)
+        throw new Error(`CS2 trees: missing prepared ${selected}`);
+    const bounds = prototypes[prototype].bounds, height = bounds.max[1] - bounds.min[1];
+    if (!(height > 0))
+        throw new Error(`CS2 trees: invalid prepared height for ${selected}`);
+    const scale = sourceHeight / height;
+    // Keep elevated source trees (e.g. roof gardens); raise ground trees where the baked terrain was conformed to roads.
+    const rootY = Math.max(tree.y - seaLevelMetres, heightAt(tree.x, tree.z));
+    return { id, prototype, position: [tree.x, rootY - bounds.min[1] * scale - 0.03, tree.z],
+        rotation: [0, Math.sin(tree.yaw / 2), 0, Math.cos(tree.yaw / 2)], scale };
+}
+async function bakeCs2Trees(root, input) {
+    const { trees } = await (0, cityLegacy_1.readCs2LegacyCity)(root);
+    const clearance = input.roadClearance ? await (0, treeRoadClearance_1.findCs2TreesOnRoads)(trees, input.roadClearance) : null;
+    const inventory = await (0, assets_1.preparePlacementsInventory)(input.catalog, input.output, exports.CS2_REPLACEMENT_TREES);
+    const meshes = await (0, csm2_1.readCs2MeshDirectory)((0, node_path_1.join)(root, 'tree-meshes-v2')), heights = new Map();
+    for (const species of trees.speciesNames.filter(name => !/Bush/i.test(name))) {
+        const mesh = await (0, csm2_1.readCs2Mesh)(meshes, species), bounds = (0, csm2_1.computeBounds)(mesh.positions);
+        heights.set(species, bounds.max[1] - bounds.min[1]);
+    }
+    const counts = Object.fromEntries(exports.CS2_REPLACEMENT_TREES.map(id => [id, 0]));
+    let skippedBushes = 0;
+    function* records() {
+        for (const tree of (0, cityLegacy_1.iterateTrees)(trees)) {
+            if (/Bush/i.test(tree.species)) {
+                skippedBushes++;
+                continue;
+            }
+            if (clearance?.excluded.has(tree.index))
+                continue;
+            const record = replacementTreeRecord(tree, inventory.prototypes, heights.get(tree.species) ?? NaN, input.seaLevelMetres, input.heightAt);
+            counts[inventory.prototypes[record.prototype].id]++;
+            yield record;
+        }
+    }
+    const bake = await (0, authored_1.bakeAuthoredPlacements)({ ...inventory, output: input.output, records: records(), heightAt: input.heightAt });
+    await (0, promises_1.writeFile)((0, node_path_1.join)(input.output, 'tree-road-clearance.json'), JSON.stringify(clearance?.report ?? {
+        schema: 'helix.cs2-tree-road-clearance/1', mode: 'off', excludedTrees: 0, excludedSourceIndices: [],
+    }, null, 2) + '\n');
+    return { bake, counts, skippedBushes, skippedRoads: clearance?.excluded.size ?? 0, roadClearance: clearance?.report ?? null,
+        sourceCount: trees.count, sourceHeights: Object.fromEntries(heights) };
+}
+//# sourceMappingURL=trees.js.map

package/dist/cs2/convert/trees.js.map

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

package/dist/cs2/csm2.d.ts

@@ -0,0 +1,58 @@
+import { type Cs2MeshGroupRecord, type Cs2PrefabMeshEntry, type Cs2PrefabMeshManifest } from './types';
+export declare const CSM2_MAGIC = 843928387;
+export declare const CSM2_HEADER_BYTES = 32;
+export declare const CSM2_GROUPED_HEADER_BYTES = 36;
+export declare const CSM2_GROUP_BYTES = 16;
+/** @deprecated Triangle ratios are not LOD metadata. Retained only for API compatibility. */
+export declare const CSM2_LOD_REDUCED_SHARE = 0.25;
+export interface Csm2Mesh {
+    version: number;
+    flags: number;
+    /** Positions are metres in the world frame; the Z mirror is already applied and the winding is already correct. */
+    positions: Float32Array;
+    /** Stored i16, divided by 32767 here. */
+    normals: Float32Array;
+    /** Stored IEEE half, widened here. */
+    uvs: Float32Array;
+    indices: Uint16Array | Uint32Array;
+    groups: Cs2MeshGroupRecord[];
+}
+export interface Csm2Bounds {
+    min: [number, number, number];
+    max: [number, number, number];
+    centre: [number, number, number];
+    /** Radius of the sphere around `centre` that contains every vertex. */
+    radius: number;
+}
+export interface Csm2LodSplit {
+    /** Largest source mesh, for diagnostics only. Every source group is retained. */
+    largestMeshIndex: number;
+    reducedMeshIndices: number[];
+    nearMeshIndices: number[];
+    farMeshIndices: number[];
+    near: Cs2MeshGroupRecord[];
+    far: Cs2MeshGroupRecord[];
+    nearTriangles: number;
+    farTriangles: number;
+    /** Without explicit LOD metadata, `far` repeats the complete `near` assembly. */
+    farIsNear: boolean;
+}
+/** Decodes one CSM2 container. Every header invariant the writer enforces is enforced here too. */
+export declare function decodeCsm2(bytes: Uint8Array): Csm2Mesh;
+/** No bounds are stored anywhere in the container, so every consumer computes them. */
+export declare function computeBounds(positions: Float32Array): Csm2Bounds;
+/**
+ * @deprecated CSM2 groups identify component/material ranges, not interchangeable LODs.
+ * Without authored LOD metadata, retain the complete assembly at both distances. Use generateCsm2Lods to reduce it.
+ */
+export declare function splitLodBuckets(groups: readonly Cs2MeshGroupRecord[], indices?: ArrayLike<number>): Csm2LodSplit;
+export interface Cs2MeshDirectory {
+    manifest: Cs2PrefabMeshManifest;
+    dir: string;
+    byPrefab: Map<string, Cs2PrefabMeshEntry>;
+}
+/** Reads `prefab-meshes-v2.json` from a `meshes-v2/` or `tree-meshes-v2/` folder. No container bytes are touched. */
+export declare function readCs2MeshDirectory(dir: string, manifestName?: string): Promise<Cs2MeshDirectory>;
+/** Loads one prefab's container. The file name is opaque and comes only from `entries[].file`. */
+export declare function readCs2Mesh(directory: Cs2MeshDirectory, prefab: string): Promise<Csm2Mesh>;
+export declare function halfToFloat(value: number): number;

package/dist/cs2/csm2.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CSM2_LOD_REDUCED_SHARE = exports.CSM2_GROUP_BYTES = exports.CSM2_GROUPED_HEADER_BYTES = exports.CSM2_HEADER_BYTES = exports.CSM2_MAGIC = void 0;
+exports.decodeCsm2 = decodeCsm2;
+exports.computeBounds = computeBounds;
+exports.splitLodBuckets = splitLodBuckets;
+exports.readCs2MeshDirectory = readCs2MeshDirectory;
+exports.readCs2Mesh = readCs2Mesh;
+exports.halfToFloat = halfToFloat;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const binary_1 = require("./binary");
+const types_1 = require("./types");
+exports.CSM2_MAGIC = 0x324d5343;
+exports.CSM2_HEADER_BYTES = 32;
+exports.CSM2_GROUPED_HEADER_BYTES = 36;
+exports.CSM2_GROUP_BYTES = 16;
+/** @deprecated Triangle ratios are not LOD metadata. Retained only for API compatibility. */
+exports.CSM2_LOD_REDUCED_SHARE = 0.25;
+/** Decodes one CSM2 container. Every header invariant the writer enforces is enforced here too. */
+function decodeCsm2(bytes) {
+    if (bytes.byteLength < exports.CSM2_HEADER_BYTES)
+        throw new Error(`decodeCsm2: a container is at least ${exports.CSM2_HEADER_BYTES} bytes, received ${bytes.byteLength}`);
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const magic = view.getUint32(0, true);
+    if (magic !== exports.CSM2_MAGIC)
+        throw new Error(`decodeCsm2: magic 0x${magic.toString(16)} is not CSM2 (0x${exports.CSM2_MAGIC.toString(16)})`);
+    const version = view.getUint16(4, true);
+    if (version !== 1 && version !== 2)
+        throw new Error(`decodeCsm2: unsupported container version ${version}`);
+    const flags = view.getUint16(6, true);
+    const index32 = (flags & 1) !== 0;
+    const vertexCount = view.getUint32(8, true);
+    const indexCount = view.getUint32(12, true);
+    const sizes = [view.getUint32(16, true), view.getUint32(20, true), view.getUint32(24, true), view.getUint32(28, true)];
+    const groupCount = version === 2 ? view.getUint32(32, true) : 1;
+    const groups = version === 2
+        ? Array.from({ length: groupCount }, (_unused, index) => {
+            const offset = exports.CSM2_GROUPED_HEADER_BYTES + index * exports.CSM2_GROUP_BYTES;
+            if (offset + exports.CSM2_GROUP_BYTES > bytes.byteLength)
+                throw new Error('decodeCsm2: the group table is truncated');
+            return {
+                meshIndex: view.getUint32(offset, true),
+                subMeshIndex: view.getUint32(offset + 4, true),
+                indexStart: view.getUint32(offset + 8, true),
+                indexCount: view.getUint32(offset + 12, true),
+            };
+        })
+        : [{ meshIndex: 0, subMeshIndex: 0, indexStart: 0, indexCount }];
+    assertCsm2Groups(groups, indexCount);
+    let cursor = version === 2 ? exports.CSM2_GROUPED_HEADER_BYTES + groupCount * exports.CSM2_GROUP_BYTES : exports.CSM2_HEADER_BYTES;
+    const offsets = [];
+    for (const size of sizes) {
+        cursor = align4(cursor);
+        offsets.push(cursor);
+        cursor += size;
+    }
+    if (cursor !== bytes.byteLength)
+        throw new Error(`decodeCsm2: sections end at ${cursor} but the container is ${bytes.byteLength} bytes`);
+    const section = (index) => bytes.buffer.slice(bytes.byteOffset + offsets[index], bytes.byteOffset + offsets[index] + sizes[index]);
+    const positions = new Float32Array(section(0));
+    const quantizedNormals = new Int16Array(section(1));
+    const halfUvs = new Uint16Array(section(2));
+    const indices = index32 ? new Uint32Array(section(3)) : new Uint16Array(section(3));
+    const payloadMatches = positions.length === vertexCount * 3 && quantizedNormals.length === vertexCount * 3
+        && halfUvs.length === vertexCount * 2 && indices.length === indexCount;
+    if (!payloadMatches) {
+        throw new Error(`decodeCsm2: the header declares ${vertexCount} vertices and ${indexCount} indices, the payload disagrees`);
+    }
+    return {
+        version,
+        flags,
+        positions,
+        normals: Float32Array.from(quantizedNormals, (value) => value / 32767),
+        uvs: Float32Array.from(halfUvs, halfToFloat),
+        indices,
+        groups,
+    };
+}
+/** No bounds are stored anywhere in the container, so every consumer computes them. */
+function computeBounds(positions) {
+    if (positions.length === 0 || positions.length % 3 !== 0)
+        throw new Error(`computeBounds: ${positions.length} floats is not a whole number of positions`);
+    const min = [Infinity, Infinity, Infinity];
+    const max = [-Infinity, -Infinity, -Infinity];
+    for (let offset = 0; offset < positions.length; offset += 3) {
+        for (let axis = 0; axis < 3; axis += 1) {
+            const value = positions[offset + axis];
+            if (value < min[axis])
+                min[axis] = value;
+            if (value > max[axis])
+                max[axis] = value;
+        }
+    }
+    const centre = [(min[0] + max[0]) / 2, (min[1] + max[1]) / 2, (min[2] + max[2]) / 2];
+    let radiusSquared = 0;
+    for (let offset = 0; offset < positions.length; offset += 3) {
+        const dx = positions[offset] - centre[0];
+        const dy = positions[offset + 1] - centre[1];
+        const dz = positions[offset + 2] - centre[2];
+        const distance = dx * dx + dy * dy + dz * dz;
+        if (distance > radiusSquared)
+            radiusSquared = distance;
+    }
+    return { min, max, centre, radius: Math.sqrt(radiusSquared) };
+}
+/**
+ * @deprecated CSM2 groups identify component/material ranges, not interchangeable LODs.
+ * Without authored LOD metadata, retain the complete assembly at both distances. Use generateCsm2Lods to reduce it.
+ */
+function splitLodBuckets(groups, indices) {
+    if (groups.length === 0)
+        throw new Error('splitLodBuckets: a container has at least one group');
+    if (indices) {
+        const covered = groups.reduce((total, group) => total + group.indexCount, 0);
+        if (covered !== indices.length)
+            throw new Error(`splitLodBuckets: the groups cover ${covered} indices but the buffer holds ${indices.length}`);
+    }
+    const byMesh = new Map();
+    for (const group of groups) {
+        const bucket = byMesh.get(group.meshIndex) ?? [];
+        bucket.push(group);
+        byMesh.set(group.meshIndex, bucket);
+    }
+    const meshIndices = [...byMesh.keys()].sort((left, right) => left - right);
+    const triangles = (meshIndex) => (byMesh.get(meshIndex) ?? []).reduce((total, group) => total + group.indexCount / 3, 0);
+    const largestMeshIndex = meshIndices.reduce((best, index) => (triangles(index) > triangles(best) ? index : best), meshIndices[0]);
+    const reducedMeshIndices = [];
+    const nearMeshIndices = meshIndices;
+    const farIsNear = true;
+    const farMeshIndices = meshIndices;
+    const collect = (indexes) => indexes.flatMap((index) => byMesh.get(index) ?? []);
+    return {
+        largestMeshIndex,
+        reducedMeshIndices,
+        nearMeshIndices,
+        farMeshIndices,
+        near: collect(nearMeshIndices),
+        far: collect(farMeshIndices),
+        nearTriangles: nearMeshIndices.reduce((total, index) => total + triangles(index), 0),
+        farTriangles: farMeshIndices.reduce((total, index) => total + triangles(index), 0),
+        farIsNear,
+    };
+}
+/** Reads `prefab-meshes-v2.json` from a `meshes-v2/` or `tree-meshes-v2/` folder. No container bytes are touched. */
+async function readCs2MeshDirectory(dir, manifestName = 'prefab-meshes-v2.json') {
+    const manifest = await (0, binary_1.readJsonFile)((0, node_path_1.join)(dir, manifestName), 'readCs2MeshDirectory');
+    (0, binary_1.assertSchema)(manifest.schema, types_1.CS2_PREFAB_MESH_SCHEMA, `readCs2MeshDirectory: ${manifestName}`);
+    const byPrefab = new Map(manifest.entries.map((entry) => [entry.prefab, entry]));
+    return { manifest, dir, byPrefab };
+}
+/** Loads one prefab's container. The file name is opaque and comes only from `entries[].file`. */
+async function readCs2Mesh(directory, prefab) {
+    const entry = directory.byPrefab.get(prefab);
+    if (!entry)
+        throw new Error(`readCs2Mesh: no mesh entry for prefab "${prefab}"`);
+    return decodeCsm2(await (0, promises_1.readFile)((0, node_path_1.join)(directory.dir, entry.file)));
+}
+function assertCsm2Groups(groups, indexCount) {
+    let cursor = 0;
+    const seen = new Set();
+    for (const group of groups) {
+        const key = `${group.meshIndex}:${group.subMeshIndex}`;
+        if (seen.has(key))
+            throw new Error(`decodeCsm2: duplicate group ${key}`);
+        seen.add(key);
+        if (group.indexStart !== cursor || group.indexCount <= 0 || group.indexCount % 3 !== 0) {
+            throw new Error(`decodeCsm2: group ${key} is not a contiguous triangle range at ${cursor}`);
+        }
+        cursor += group.indexCount;
+    }
+    if (cursor !== indexCount)
+        throw new Error(`decodeCsm2: groups cover ${cursor} indices, the header declares ${indexCount}`);
+}
+function halfToFloat(value) {
+    const sign = (value & 0x8000) ? -1 : 1;
+    const exponent = (value >> 10) & 0x1f;
+    const fraction = value & 0x3ff;
+    if (exponent === 0)
+        return sign * 2 ** -14 * (fraction / 1024);
+    if (exponent === 31)
+        return fraction ? Number.NaN : sign * Number.POSITIVE_INFINITY;
+    return sign * 2 ** (exponent - 15) * (1 + fraction / 1024);
+}
+function align4(value) {
+    return (value + 3) & ~3;
+}
+//# sourceMappingURL=csm2.js.map

package/dist/cs2/csm2.js.map

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

package/dist/cs2/fixtures.d.ts

@@ -0,0 +1,5 @@
+/** Byte slices of the real Granit bundle, cut by `scripts/cs2-cut-fixtures.mjs`. */
+export declare const CS2_FIXTURES: string;
+/** The 2.5 GB source bundle, which is not in this repo; the integration test skips itself when it is absent. */
+export declare const CS2_REAL_BUNDLE: string;
+export declare function hasRealBundle(): boolean;

package/dist/cs2/fixtures.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CS2_REAL_BUNDLE = exports.CS2_FIXTURES = void 0;
+exports.hasRealBundle = hasRealBundle;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/** Byte slices of the real Granit bundle, cut by `scripts/cs2-cut-fixtures.mjs`. */
+exports.CS2_FIXTURES = (0, node_path_1.join)(__dirname, '..', '..', 'test', 'fixtures', 'cs2');
+/** The 2.5 GB source bundle, which is not in this repo; the integration test skips itself when it is absent. */
+exports.CS2_REAL_BUNDLE = process.env.CS2_BUNDLE
+    ?? (0, node_path_1.join)(__dirname, '..', '..', '..', 'OtherRepos', 'cs2-granit', 'bundle', 'granit-source-v2');
+function hasRealBundle() {
+    return (0, node_fs_1.existsSync)((0, node_path_1.join)(exports.CS2_REAL_BUNDLE, 'placements', 'placements.json'));
+}
+//# sourceMappingURL=fixtures.js.map

package/dist/cs2/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../src/cs2/fixtures.ts"],"names":[],"mappings":";;;AAUA,sCAEC;AAZD,qCAAqC;AACrC,yCAAiC;AAEjC,oFAAoF;AACvE,QAAA,YAAY,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;AAEnF,gHAAgH;AACnG,QAAA,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU;OAChD,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AAEjG,SAAgB,aAAa;IAC3B,OAAO,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,uBAAe,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/cs2/impostors.d.ts

@@ -0,0 +1,31 @@
+import type { Cs2ImpostorManifest, Cs2ImpostorSpecies } from './types';
+export interface Cs2ImpostorAtlas {
+    manifest: Cs2ImpostorManifest;
+    dir: string;
+    atlasFile: string;
+    width: number;
+    height: number;
+    azimuths: number;
+    gutterPx: number;
+    /** 19 species are baked and Granit uses 15: join by NAME, never by index. */
+    speciesByName: Map<string, Cs2ImpostorSpecies>;
+}
+export interface Cs2ImpostorRect {
+    /** Atlas pixels from the TOP-left; `flipY` must be false at the runtime. */
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** Reads `impostors/tree-impostors.json`. The atlas PNG itself is left on disk. */
+export declare function readCs2Impostors(root: string): Promise<Cs2ImpostorAtlas>;
+/** Azimuths run horizontally from `origin`: `px = origin + (index * cell, 0)`, `cell = tile + 2 * gutter`. */
+export declare function tileRectPx(species: Cs2ImpostorSpecies, azimuth: number): Cs2ImpostorRect;
+/**
+ * Tile `a` shows the tree from world direction (sin 2*pi*a/N, 0, cos 2*pi*a/N) in its OWN frame, so the instance's yaw
+ * comes out of the view azimuth before quantising.
+ */
+export declare function azimuthIndex(toCam: {
+    x: number;
+    z: number;
+}, yaw: number, azimuths: number): number;

package/dist/cs2/impostors.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readCs2Impostors = readCs2Impostors;
+exports.tileRectPx = tileRectPx;
+exports.azimuthIndex = azimuthIndex;
+const node_path_1 = require("node:path");
+const binary_1 = require("./binary");
+/** Reads `impostors/tree-impostors.json`. The atlas PNG itself is left on disk. */
+async function readCs2Impostors(root) {
+    const dir = (0, node_path_1.join)(root, 'impostors');
+    const manifest = await (0, binary_1.readJsonFile)((0, node_path_1.join)(dir, 'tree-impostors.json'), 'readCs2Impostors');
+    if (!manifest.atlas || !Array.isArray(manifest.species))
+        throw new Error('readCs2Impostors: tree-impostors.json has no atlas or species block');
+    return {
+        manifest,
+        dir,
+        atlasFile: (0, node_path_1.join)(dir, manifest.atlas.file),
+        width: manifest.atlas.width,
+        height: manifest.atlas.height,
+        azimuths: manifest.azimuths,
+        gutterPx: manifest.atlas.gutterPx,
+        speciesByName: new Map(manifest.species.map((species) => [species.name, species])),
+    };
+}
+/** Azimuths run horizontally from `origin`: `px = origin + (index * cell, 0)`, `cell = tile + 2 * gutter`. */
+function tileRectPx(species, azimuth) {
+    if (!Number.isInteger(azimuth) || azimuth < 0)
+        throw new Error(`tileRectPx: azimuth ${azimuth} must be a non-negative integer`);
+    return { x: species.origin[0] + azimuth * species.cell, y: species.origin[1], width: species.tile, height: species.tile };
+}
+/**
+ * Tile `a` shows the tree from world direction (sin 2*pi*a/N, 0, cos 2*pi*a/N) in its OWN frame, so the instance's yaw
+ * comes out of the view azimuth before quantising.
+ */
+function azimuthIndex(toCam, yaw, azimuths) {
+    if (!Number.isInteger(azimuths) || azimuths < 1)
+        throw new Error(`azimuthIndex: ${azimuths} azimuths is not a positive integer`);
+    const step = (2 * Math.PI) / azimuths;
+    const index = Math.round((Math.atan2(toCam.x, toCam.z) - yaw) / step);
+    return ((index % azimuths) + azimuths) % azimuths;
+}
+//# sourceMappingURL=impostors.js.map

package/dist/cs2/impostors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impostors.js","sourceRoot":"","sources":["../../src/cs2/impostors.ts"],"names":[],"mappings":";;AAyBA,4CAcC;AAGD,gCAGC;AAMD,oCAKC;AAxDD,yCAAiC;AACjC,qCAAwC;AAuBxC,mFAAmF;AAC5E,KAAK,UAAU,gBAAgB,CAAC,IAAY;IACjD,MAAM,GAAG,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,IAAA,qBAAY,EAAsB,IAAA,gBAAI,EAAC,GAAG,EAAE,qBAAqB,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAC/G,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IAChJ,OAAO;QACL,QAAQ;QACR,GAAG;QACH,SAAS,EAAE,IAAA,gBAAI,EAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QACzC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK;QAC3B,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;QAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ;QACjC,aAAa,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;KACnF,CAAC;AACJ,CAAC;AAED,8GAA8G;AAC9G,SAAgB,UAAU,CAAC,OAA2B,EAAE,OAAe;IACrE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,OAAO,iCAAiC,CAAC,CAAC;IAChI,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;AAC5H,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,KAA+B,EAAE,GAAW,EAAE,QAAgB;IACzF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,qCAAqC,CAAC,CAAC;IACjI,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACtE,OAAO,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC;AACpD,CAAC"}

package/dist/cs2/index.d.ts

@@ -0,0 +1,22 @@
+export * from './types';
+export { generateCsm2Lods, CSM2_BUILDING_LOD_TARGETS, type Csm2LodTarget, type Csm2GeneratedLod } from './lods';
+export { bakeCs2Trees, replacementTreeRecord, CS2_REPLACEMENT_TREES } from './convert/trees';
+export { CSM2_GROUPED_HEADER_BYTES, CSM2_GROUP_BYTES, CSM2_HEADER_BYTES, CSM2_LOD_REDUCED_SHARE, CSM2_MAGIC, computeBounds, decodeCsm2, halfToFloat, readCs2Mesh, readCs2MeshDirectory, splitLodBuckets, type Cs2MeshDirectory, type Csm2Bounds, type Csm2LodSplit, type Csm2Mesh, } from './csm2';
+export { PLACEMENT_LOT_SIZE_STRIDE, PLACEMENT_RECORD_STRIDE, PLACEMENT_TRANSFORM_STRIDE, iterate, prefabName, readCs2Placements, tileBoundsWorld, tileRange, type Cs2Placement, type Cs2PlacementCollection, type Cs2Placements, type Cs2TileBounds, } from './placements';
+export { loadCs2TerrainGrid, loadCs2TerrainSplat, metresPerSampleForRes, readCs2Terrain, type Cs2Terrain, type Cs2TerrainGrid, type Cs2TerrainSplat, } from './terrain';
+export { readCs2Water, sampleToWorld, worldToSample, type Cs2WaterField, type Cs2WaterSample } from './water';
+export { ROAD_CURVE_STRIDE, ROAD_EDGE_SURFACE_STRIDE, ROAD_FLAGS, ROAD_KINDS, ROAD_LANE_STRIDE, ROAD_OWNER_KINDS, curveAt, edgeSurfaceAt, iterateRoadEdges, laneAt, readAppliedCompositions, readCs2RoadBins, readEdgeRenderParameters, readRoadNodes, readRoadsHeader, roadFlagNames, roadKindName, type Cs2RoadBins, type Cs2RoadCurve, type Cs2RoadEdgeSurface, type Cs2RoadFlagName, type Cs2RoadLane, } from './roads';
+export { GENERATED_VERTEX_STRIDE, TERRAIN_CONFORMANCE_LIFT_METRES, TERRAIN_CONFORMANCE_LIMIT_METRES, decodeVertex, deformInstance, evalTerrainConformance, readCs2RoadPieces, type Cs2DeformedInstance, type Cs2GeneratedMesh, type Cs2GeneratedVertex, type Cs2RoadPieces, type Cs2TerrainConformance, } from './roadPieces';
+export { AREA_POSITION_STRIDE, AREA_RECORD_STRIDE, AREA_Y_LIFT_METRES, areaRecord, readCs2Areas, triangleNormal, triangles, type Cs2AreaRecord, type Cs2AreaTriangle, type Cs2Areas, } from './areas';
+export { IDENTITY_MAP_CHROMA, IDENTITY_MAP_PURITY, bindingKey, contentKey, distinctTextureFiles, isDecalShader, isIdentityMap, materialForGroup, readCs2MaterialBundle, resolveTextureRoles, textureFileBytes, textureRoleScore, type Cs2MaterialBundle, type Cs2SelectedTexture, type Cs2TextureRole, } from './materials';
+export { azimuthIndex, readCs2Impostors, tileRectPx, type Cs2ImpostorAtlas, type Cs2ImpostorRect } from './impostors';
+export { LEGACY_TREE_STRIDE, iterateTrees, readCs2LegacyCity, treeAt, type Cs2LegacyCity, type Cs2LegacyTree, type Cs2LegacyTrees } from './cityLegacy';
+export { formatCs2BundleReport, inspectCs2Bundle, type Cs2BundleReport } from './inspect';
+export { applyCs2WaterCut, convertCs2Terrain, cs2HeightGrid, cs2TerrainPreset, cs2WaterDepth, type Cs2HeightGridOptions, type Cs2TerrainConversion, type Cs2TerrainOptions, type Cs2WaterCut, } from './convert/terrain';
+export { CS2_AREA_COLOUR, CS2_AREA_EXCLUDED_PREFABS, CS2_AREA_ROUGHNESS, CS2_AREA_TILE_METRES, bakeCs2AreaCells, type Cs2AreaBake, type Cs2AreaBakeOptions, type Cs2AreaCell, type Cs2AreaMesh, } from './convert/areas';
+export { CS2_QUANTIZE_POSITION_BITS, computeVertexNormals, cs2GltfIo, linearFromSrgbHex, weldAndSimplify, writeCs2Glb, type Cs2GlbMaterial, type Cs2GlbPrimitive, type Cs2WeldedSimplification, } from './convert/glb';
+export { CS2_MARKING_DASH_FILL, CS2_MARKING_DASH_PERIOD_METRES, CS2_MARKING_LIFT_METRES, CS2_MARKING_ROAD_LIFT_METRES, CS2_MARKING_SEAT_REACH_METRES, CS2_MARKING_SEGMENTS, CS2_MARKING_WHITE, CS2_MARKING_YELLOW, CS2_MARKING_YIELD_FILL, CS2_MARKING_YIELD_PERIOD_METRES, buildMarkingCellA, buildMarkingCellB, collectCs2Markings, cubicBezier, dashIntervals, encodeCs2StripeKtx2, markingMaterialB, markingStations, type Cs2Marking, type Cs2MarkingMesh, type Cs2MarkingPattern, type Cs2MarkingSeating, type Cs2MarkingStation, } from './convert/markings';
+export { CS2_CELL_SIZE_METRES, CS2_COLLIDER_FAMILIES, CS2_ELEVATED_STRUCTURE_METRES, CS2_FAMILY_COLOUR, CS2_FAMILY_ROUGHNESS, CS2_FAMILY_TILE_METRES, CS2_MARKING_SEAT_FAMILIES, bakeCs2RoadCell, cellIndexAt, cellKey, collectCs2RoadInstances, compositionBounds, compositionMean, packCompositionParameters, roadSlotFamily, unpackCompositionParameters, type Cs2RoadCellGeometry, type Cs2RoadFamily, type Cs2RoadInstance, type Cs2RoadInstanceWalk, type Cs2RoadSlotGeometry, type Cs2SlotUv, } from './convert/roadBake';
+export { SURFACE_INDEX_BUCKET_METRES, TERRAIN_CONFORM_CLEARANCE_METRES, TERRAIN_CONFORM_MAX_DEVIATION_METRES, TERRAIN_CONFORM_MIN_UP_FACING, buildSurfaceHeightIndex, conformGridToSurfaces, type SurfaceHeightIndex, type SurfaceHeightIndexOptions, type TerrainConformOptions, type TerrainConformStats, type TerrainConformSurface, } from './convert/terrainConform';
+export { CS2_COLLIDER_ERROR_METRES, CS2_COLLIDER_MAX_TRIANGLES, CS2_MESH_CELLS_SCHEMA, CS2_ROAD_NETWORK_SCHEMA, CS2_WORLDSPACE_TILE_METRES, bakeCs2Roads, type Cs2ColliderReport, type Cs2MarkingVariant, type Cs2MeshCellBounds, type Cs2MeshCellFile, type Cs2MeshCellIndex, type Cs2MeshRenderCellFile, type Cs2MeshTextureFile, type Cs2RoadBakeOptions, type Cs2RoadBakeTelemetry, type Cs2RoadBakeTerrain, } from './convert/roads';
+export { findCs2TreesOnRoads, CS2_TREE_CLEARANCE_ROAD_SLOTS } from './convert/treeRoadClearance';