@hypersoniclabs/helix-cli 0.1.6 → 0.1.23

package/dist/cs2/roadPieces.js

@@ -0,0 +1,263 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TERRAIN_CONFORMANCE_LIFT_METRES = exports.TERRAIN_CONFORMANCE_LIMIT_METRES = exports.GENERATED_VERTEX_STRIDE = void 0;
+exports.readCs2RoadPieces = readCs2RoadPieces;
+exports.decodeVertex = decodeVertex;
+exports.deformInstance = deformInstance;
+exports.evalTerrainConformance = evalTerrainConformance;
+exports.stripKey = stripKey;
+exports.stripLateralRanges = stripLateralRanges;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const binary_1 = require("./binary");
+const csm2_1 = require("./csm2");
+const types_1 = require("./types");
+exports.GENERATED_VERTEX_STRIDE = 32;
+/** Ground compositions cluster this close to the terrain; anything farther is deliberate structure (bridges, tunnels). */
+exports.TERRAIN_CONFORMANCE_LIMIT_METRES = 1.25;
+exports.TERRAIN_CONFORMANCE_LIFT_METRES = 0.035;
+/** Reads `road-pieces/road-composition-generated.json` and its interleaved bin. */
+async function readCs2RoadPieces(root) {
+    const dir = (0, node_path_1.join)(root, 'road-pieces');
+    const manifest = await (0, binary_1.readJsonFile)((0, node_path_1.join)(dir, 'road-composition-generated.json'), 'readCs2RoadPieces');
+    (0, binary_1.assertSchema)(manifest.schema, types_1.CS2_ROAD_GENERATED_SCHEMA, 'readCs2RoadPieces: road-composition-generated.json');
+    const bin = await (0, promises_1.readFile)((0, node_path_1.join)(dir, manifest.bin));
+    const buffer = bin.buffer.slice(bin.byteOffset, bin.byteOffset + bin.byteLength);
+    const meshes = manifest.meshes.map((record) => decodeGeneratedMesh(record, buffer));
+    const byCompositionEntityId = new Map();
+    for (const mesh of meshes)
+        for (const entityId of mesh.record.compositionEntityIds)
+            byCompositionEntityId.set(entityId, mesh);
+    return { manifest, meshes, byCompositionEntityId };
+}
+/** One vertex of the 32-byte interleaved layout. */
+function decodeVertex(mesh, vertex) {
+    if (vertex < 0 || vertex >= mesh.record.vertexCount)
+        throw new Error(`decodeVertex: vertex ${vertex} is outside the ${mesh.record.vertexCount}-vertex mesh`);
+    const offset = mesh.record.vertices.offset + vertex * mesh.record.vertexStride;
+    return {
+        lateral: mesh.bytes.getFloat32(offset, true),
+        elevation: mesh.bytes.getFloat32(offset + 4, true),
+        t: clamp(mesh.bytes.getFloat32(offset + 8, true), 0, 1),
+        normal: decodeOctahedral(mesh.bytes.getUint32(offset + 12, true)),
+        packedTangent: mesh.bytes.getUint32(offset + 16, true),
+        colourA: mesh.bytes.getUint8(offset + 20),
+        colourB: mesh.bytes.getUint8(offset + 21),
+        flags: mesh.bytes.getUint8(offset + 23),
+        uv: [(0, csm2_1.halfToFloat)(mesh.bytes.getUint16(offset + 24, true)), (0, csm2_1.halfToFloat)(mesh.bytes.getUint16(offset + 26, true))],
+    };
+}
+function deformInstance(mesh, parameters, options = {}) {
+    assertParameters(parameters);
+    const count = mesh.record.vertexCount;
+    const positions = new Float32Array(count * 3);
+    const normals = new Float32Array(count * 3);
+    const translation = [parameters.transform[9], parameters.transform[10], parameters.transform[11]];
+    const ranges = stripLateralRanges(mesh);
+    const nodePiece = options.nodePiece ?? false;
+    for (let vertex = 0; vertex < count; vertex += 1) {
+        const source = decodeVertex(mesh, vertex);
+        const matrixA = parameters.matrices[Math.min(7, source.colourA)];
+        const matrixB = parameters.matrices[Math.min(7, source.colourB)];
+        const pointA = cubicMatrixPoint(matrixA, source.t);
+        const pointB = cubicMatrixPoint(matrixB, source.t);
+        const tangentA = cubicMatrixDerivative(matrixA, source.t);
+        const tangentB = cubicMatrixDerivative(matrixB, source.t);
+        const sourceSync = selectSync(parameters.sync, source.flags & 7, false);
+        const targetSync = selectSync(parameters.sync, source.flags & 7, true);
+        const synced = stretchToInnerCurve(piecewiseSync(source.lateral, sourceSync, targetSync), source, ranges.get(stripKey(source)), sourceSync, targetSync);
+        const lateral = nodePiece ? clamp(source.lateral + (synced - source.lateral) * source.t, 0, 1) : synced;
+        const point = lerp3(pointA, pointB, lateral);
+        const tangent = normalize3(lerp3(tangentA, tangentB, lateral), [0, 0, 1]);
+        const side = normalize3([-tangent[2], 0, tangent[0]], [1, 0, 0]);
+        const normal = normalize3([
+            side[0] * source.normal[0] + tangent[0] * source.normal[2],
+            source.normal[1] + tangent[1] * source.normal[2],
+            side[2] * source.normal[0] + tangent[2] * source.normal[2],
+        ], [0, 1, 0]);
+        const offset = vertex * 3;
+        positions[offset] = point[0] + translation[0];
+        positions[offset + 1] = point[1] + source.elevation + translation[1];
+        positions[offset + 2] = -(point[2] + translation[2]);
+        normals[offset] = normal[0];
+        normals[offset + 1] = normal[1];
+        normals[offset + 2] = -normal[2];
+    }
+    const indices = new Uint32Array(mesh.indices.length);
+    for (let triangle = 0; triangle + 2 < mesh.indices.length; triangle += 3) {
+        indices[triangle] = mesh.indices[triangle];
+        indices[triangle + 1] = mesh.indices[triangle + 2];
+        indices[triangle + 2] = mesh.indices[triangle + 1];
+    }
+    return { positions, normals, indices };
+}
+/**
+ * CS2 runs a terrain-adjustment stage after deforming a composition. The per-composition median of (vertexY - terrainY)
+ * corrects the sampling datum without flattening kerbs; a median outside +/-1.25 m is a bridge or a tunnel, left alone.
+ */
+function evalTerrainConformance(positions, terrainSampleAt) {
+    const deltas = [];
+    for (let offset = 0; offset + 2 < positions.length; offset += 3) {
+        const delta = positions[offset + 1] - terrainSampleAt(positions[offset], positions[offset + 2]);
+        if (Number.isFinite(delta))
+            deltas.push(delta);
+    }
+    if (deltas.length === 0)
+        return { medianMetres: 0, shiftMetres: 0, applied: false };
+    deltas.sort((left, right) => left - right);
+    const middle = Math.floor(deltas.length / 2);
+    const medianMetres = deltas.length % 2 === 0 ? (deltas[middle - 1] + deltas[middle]) / 2 : deltas[middle];
+    const applied = medianMetres >= -exports.TERRAIN_CONFORMANCE_LIMIT_METRES && medianMetres <= exports.TERRAIN_CONFORMANCE_LIMIT_METRES;
+    return { medianMetres, shiftMetres: applied ? -medianMetres + exports.TERRAIN_CONFORMANCE_LIFT_METRES : 0, applied };
+}
+function decodeGeneratedMesh(record, buffer) {
+    if (record.vertexStride !== exports.GENERATED_VERTEX_STRIDE) {
+        throw new Error(`readCs2RoadPieces: mesh ${record.meshEntityId} has unsupported stride ${record.vertexStride}`);
+    }
+    assertSection(record.vertices, record.vertexCount * record.vertexStride, buffer.byteLength, `mesh ${record.meshEntityId} vertices`, 1);
+    assertSection(record.indices, record.indexCount * 4, buffer.byteLength, `mesh ${record.meshEntityId} indices`, 4);
+    for (const range of record.materials ?? []) {
+        const valid = Number.isInteger(range.startIndex) && range.startIndex >= 0 && range.startIndex % 3 === 0
+            && Number.isInteger(range.indexCount) && range.indexCount > 0 && range.indexCount % 3 === 0
+            && range.startIndex + range.indexCount <= record.indexCount;
+        if (!valid)
+            throw new Error(`readCs2RoadPieces: mesh ${record.meshEntityId} has an invalid material range`);
+    }
+    return { record, bytes: new DataView(buffer), indices: new Uint32Array(buffer, record.indices.offset, record.indexCount) };
+}
+function assertSection(section, expected, total, label, alignment) {
+    if (section.byteLength !== expected)
+        throw new Error(`readCs2RoadPieces: ${label} declares ${section.byteLength} bytes, the counts need ${expected}`);
+    if (section.offset % alignment !== 0)
+        throw new Error(`readCs2RoadPieces: ${label} starts at ${section.offset}, not a multiple of ${alignment}`);
+    if (section.offset + section.byteLength > total)
+        throw new Error(`readCs2RoadPieces: ${label} runs past the end of the bin`);
+}
+function assertParameters(parameters) {
+    const valid = Array.isArray(parameters.transform) && parameters.transform.length === 12
+        && Array.isArray(parameters.matrices) && parameters.matrices.length === 8
+        && parameters.matrices.every((matrix) => Array.isArray(matrix) && matrix.length === 4
+            && matrix.every((column) => Array.isArray(column) && column.length === 4))
+        && Array.isArray(parameters.sync) && parameters.sync.length === 4 && parameters.sync.every((vector) => Array.isArray(vector) && vector.length === 4);
+    if (!valid)
+        throw new Error('deformInstance: renderParameters must hold a 12-float transform, 8 4x4 matrices and 4 sync vectors');
+}
+function cubicMatrixPoint(matrix, t) {
+    const inverse = 1 - t;
+    const weights = [inverse ** 3, 3 * inverse ** 2 * t, 3 * inverse * t ** 2, t ** 3];
+    return [0, 1, 2].map((axis) => matrix.reduce((sum, column, index) => sum + column[axis] * weights[index], 0));
+}
+function cubicMatrixDerivative(matrix, t) {
+    const inverse = 1 - t;
+    return [0, 1, 2].map((axis) => 3 * inverse ** 2 * (matrix[1][axis] - matrix[0][axis])
+        + 6 * inverse * t * (matrix[2][axis] - matrix[1][axis])
+        + 3 * t ** 2 * (matrix[3][axis] - matrix[2][axis]));
+}
+/** Curves 1 and 2 run from the composition middle to the two corner points: the inner edge of either half of a node piece. */
+const INNER_CURVES = new Set([1, 2]);
+/** A strip is short of its inner curve when its remapped inner edge is farther than this from it, in lateral units. */
+const STRETCH_EPSILON = 1e-3;
+const stripRangeCache = new WeakMap();
+/** One strip = one (curve A, curve B, sync pair) triple; the key packs the three bytes the vertex carries. */
+function stripKey(vertex) {
+    return (vertex.colourA << 11) | (vertex.colourB << 3) | (vertex.flags & 7);
+}
+/** The source lateral extent of every strip in a mesh, once per mesh: what says whether a strip reaches the middle. */
+function stripLateralRanges(mesh) {
+    const cached = stripRangeCache.get(mesh);
+    if (cached)
+        return cached;
+    const ranges = new Map();
+    for (let vertex = 0; vertex < mesh.record.vertexCount; vertex += 1) {
+        const source = decodeVertex(mesh, vertex);
+        const key = stripKey(source);
+        const range = ranges.get(key);
+        if (range) {
+            range.min = Math.min(range.min, source.lateral);
+            range.max = Math.max(range.max, source.lateral);
+        }
+        else
+            ranges.set(key, { min: source.lateral, max: source.lateral });
+    }
+    stripRangeCache.set(mesh, ranges);
+    return ranges;
+}
+/**
+ * Puts a strip's inner edge ON its inner curve when the sync targets stop it short. Two shapes of "short":
+ * - the targets COLLAPSE the inner columns onto one lateral (a symmetric road's node piece maps its lane columns
+ *   0.4375..1 all to 0.4507 and bridges the carriageway to the spine): those columns are spread linearly from the
+ *   collapse point to the curve instead, so the sidewalk column stays where the game put it — rescaling the whole
+ *   strip drags the sidewalk 8 m into the carriageway;
+ * - the MESH itself ends at the last sync knot (a one-way piece's half-strip over 0.2..0.6): only that end column moves,
+ *   onto the curve; every column before it stays where the targets put it. The targets align the piece's kerb knot with
+ *   its neighbour's (Granit's ramp 0.644413 meets the Large Road's 1 − 0.355587 exactly), so rescaling the strip dragged
+ *   the ramp's tapering sidewalk 4 m into the carriageway — a 20 cm plateau across every ramp merge.
+ * Strips whose targets reach the curve, strips between two outer or two inner curves, spine strips and the dummy pass
+ * through unchanged. `vertex.lateral` is the vertex's own lateral, before the remap.
+ */
+function stretchToInnerCurve(lateral, vertex, range, sourceSync, targetSync) {
+    const innerA = INNER_CURVES.has(vertex.colourA);
+    const innerB = INNER_CURVES.has(vertex.colourB);
+    if (innerA === innerB || Math.max(vertex.colourA, vertex.colourB) > 3)
+        return lateral;
+    if (innerB) {
+        const collapsed = targetSync[3];
+        if (collapsed >= 1 - STRETCH_EPSILON || collapsed <= STRETCH_EPSILON || sourceSync[3] < range.max - STRETCH_EPSILON)
+            return lateral;
+        let start = sourceSync[3];
+        for (let knot = 2; knot >= 0 && Math.abs(targetSync[knot] - collapsed) <= STRETCH_EPSILON; knot -= 1)
+            start = Math.min(start, sourceSync[knot]);
+        if (range.max - start <= STRETCH_EPSILON)
+            return vertex.lateral >= range.max - STRETCH_EPSILON ? 1 : lateral;
+        if (vertex.lateral < start)
+            return lateral;
+        return clamp(collapsed + ((vertex.lateral - start) / (range.max - start)) * (1 - collapsed), 0, 1);
+    }
+    const collapsed = targetSync[0];
+    if (collapsed <= STRETCH_EPSILON || collapsed >= 1 - STRETCH_EPSILON || sourceSync[0] > range.min + STRETCH_EPSILON)
+        return lateral;
+    let end = sourceSync[0];
+    for (let knot = 1; knot <= 3 && Math.abs(targetSync[knot] - collapsed) <= STRETCH_EPSILON; knot += 1)
+        end = Math.max(end, sourceSync[knot]);
+    if (end - range.min <= STRETCH_EPSILON)
+        return vertex.lateral <= range.min + STRETCH_EPSILON ? 0 : lateral;
+    if (vertex.lateral > end)
+        return lateral;
+    return clamp(collapsed * ((vertex.lateral - range.min) / (end - range.min)), 0, 1);
+}
+function selectSync(sync, lowBits, second) {
+    const index = second ? lowBits - 1 : lowBits - 2;
+    return index >= 0 && index < 4 ? sync[index] : [0.2, 0.4, 0.6, 0.8];
+}
+function piecewiseSync(value, source, target) {
+    const sourcePoints = [0, ...source, 1];
+    const targetPoints = [0, ...target, 1];
+    const x = clamp(value, 0, 1);
+    for (let index = 0; index < sourcePoints.length - 1; index += 1) {
+        const start = sourcePoints[index];
+        const end = Math.max(start + 1e-6, sourcePoints[index + 1]);
+        if (x <= end || index === sourcePoints.length - 2) {
+            const share = clamp((x - start) / (end - start), 0, 1);
+            return targetPoints[index] + (targetPoints[index + 1] - targetPoints[index]) * share;
+        }
+    }
+    return x;
+}
+function decodeOctahedral(packed) {
+    const x = Math.max(-1, (packed << 16 >> 16) / 32767);
+    const y = Math.max(-1, (packed >> 16 << 16 >> 16) / 32767);
+    const z = 1 - Math.abs(x) - Math.abs(y);
+    const fold = Math.max(-z, 0);
+    return normalize3([x + (x >= 0 ? -fold : fold), y + (y >= 0 ? -fold : fold), z], [0, 1, 0]);
+}
+function lerp3(a, b, t) {
+    return [a[0] + (b[0] - a[0]) * t, a[1] + (b[1] - a[1]) * t, a[2] + (b[2] - a[2]) * t];
+}
+function normalize3(value, fallback) {
+    const length = Math.hypot(value[0], value[1], value[2]);
+    return length > 1e-8 ? [value[0] / length, value[1] / length, value[2] / length] : fallback;
+}
+function clamp(value, min, max) {
+    return value < min ? min : value > max ? max : value;
+}
+//# sourceMappingURL=roadPieces.js.map

package/dist/cs2/roadPieces.js.map

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

package/dist/cs2/roads.d.ts

@@ -0,0 +1,92 @@
+import { type Cs2CompositionParameters, type Cs2CompositionPart, type Cs2RoadEdge, type Cs2RoadNode, type Cs2RoadsHeader } from './types';
+export declare const ROAD_CURVE_STRIDE = 13;
+export declare const ROAD_LANE_STRIDE = 7;
+export declare const ROAD_EDGE_SURFACE_STRIDE = 14;
+export declare const ROAD_KINDS: Readonly<{
+    car: 1;
+    bicycle: 2;
+    pedestrian: 3;
+    parking: 4;
+    track: 5;
+    marking: 6;
+}>;
+export declare const ROAD_OWNER_KINDS: Readonly<{
+    edge: 0;
+    node: 1;
+}>;
+/** The writer's 22 substring-derived bits (`road-surface-bundle.mjs:23-46`) — a heuristic, not source truth. */
+export declare const ROAD_FLAGS: Readonly<{
+    twoWay: number;
+    invert: number;
+    forward: number;
+    turnLeft: number;
+    turnRight: number;
+    uTurn: number;
+    yield: number;
+    roundabout: number;
+    highway: number;
+    trafficLight: number;
+    starting: number;
+    ending: number;
+    onWater: number;
+    levelCrossing: number;
+    markingDashed: number;
+    markingYellow: number;
+    markingStop: number;
+    markingYield: number;
+    markingParking: number;
+    markingEdge: number;
+    markingCentre: number;
+    markingMerge: number;
+}>;
+export type Cs2RoadFlagName = keyof typeof ROAD_FLAGS;
+export interface Cs2RoadCurve {
+    /** Four explicit cubic Bezier control points, mirrored. */
+    a: [number, number, number];
+    b: [number, number, number];
+    c: [number, number, number];
+    d: [number, number, number];
+    widthMetres: number;
+}
+export interface Cs2RoadLane {
+    kind: number;
+    flags: number;
+    /** Index into `edges[]` or `nodes[]` per `ownerKind`. */
+    ownerIndex: number;
+    prefabIndex: number;
+    entityId: number;
+    prefabEntityId: number;
+    ownerKind: number;
+}
+export interface Cs2RoadEdgeSurface extends Cs2RoadCurve {
+    lateralOffsetMetres: number;
+}
+export interface Cs2RoadBins {
+    header: Cs2RoadsHeader;
+    curves: Float32Array;
+    lanes: Uint32Array;
+    edgeSurfaces: Float32Array;
+}
+/**
+ * Parses only the small top-level fields of `roads-v2.json` and stops there. The file is 84 MB because every edge
+ * carries its `renderParameters`; `edges`, `nodes` and `appliedCompositions` all stream separately.
+ */
+export declare function readRoadsHeader(root: string): Promise<Cs2RoadsHeader>;
+/** Reads the three index-parallel bins declared by the header. */
+export declare function readCs2RoadBins(root: string, header?: Cs2RoadsHeader): Promise<Cs2RoadBins>;
+export declare function curveAt(bins: Cs2RoadBins, index: number): Cs2RoadCurve;
+export declare function laneAt(bins: Cs2RoadBins, index: number): Cs2RoadLane;
+export declare function edgeSurfaceAt(bins: Cs2RoadBins, index: number): Cs2RoadEdgeSurface;
+export declare function roadKindName(kind: number): string;
+export declare function roadFlagNames(flags: number): Cs2RoadFlagName[];
+/** Streams `edges[]` one element at a time; nothing else in the file is buffered. */
+export declare function iterateRoadEdges(root: string): AsyncGenerator<Cs2RoadEdge>;
+/**
+ * The deformation payload of one edge, by position in `edges[]`. This rescans from the start of the array, so a bulk
+ * consumer should walk `iterateRoadEdges` once instead of calling this in a loop.
+ */
+export declare function readEdgeRenderParameters(root: string, edgeIndex: number): Promise<Partial<Record<Cs2CompositionPart, Cs2CompositionParameters>>>;
+/** Buffers the `nodes[]` member (about 2 MB of JSON on Granit) and leaves `edges[]` unread. */
+export declare function readRoadNodes(root: string): Promise<Cs2RoadNode[]>;
+/** Buffers the `appliedCompositions[]` member (about 3.5 MB of JSON on Granit). Unmirrored, like `renderParameters`. */
+export declare function readAppliedCompositions(root: string): Promise<Array<Record<string, unknown>>>;