@hypersoniclabs/helix-cli 0.1.7 → 0.1.23

package/dist/terrain/inspect.d.ts

@@ -0,0 +1,35 @@
+import { type TerrainFoldedRole, type TerrainSource } from './tile';
+export interface TerrainInspection {
+    extentM: [number, number];
+    tiles: number;
+    /** Metres between two authored samples. */
+    metresPerSample: number;
+    /** Authored samples across the whole grid, shared edges counted once. */
+    samples: number;
+    /** Delivered bytes, tiles plus the coarse layer. */
+    bytes: {
+        heights: number;
+        splats: number;
+        normals: number;
+        total: number;
+    };
+    heightRange: [number, number];
+    coarse: {
+        samples: number;
+        bytes: number;
+    };
+    folded: {
+        tiles: Array<{
+            tx: number;
+            tz: number;
+            roles: TerrainFoldedRole[];
+        }>;
+        /** Number of role-on-tile foldings, and the mean share of a tile's weight they carried. */
+        roles: number;
+        meanMass: number;
+    };
+    warnings: string[];
+}
+/** The dry run behind `helix terrain inspect`: what ships, how big it is, and what the bake had to drop. */
+export declare function inspectTerrainSource(source: TerrainSource): TerrainInspection;
+export declare function formatTerrainInspection(report: TerrainInspection): string;

package/dist/terrain/inspect.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inspectTerrainSource = inspectTerrainSource;
+exports.formatTerrainInspection = formatTerrainInspection;
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const grid_1 = require("./grid");
+const tile_1 = require("./tile");
+/** The dry run behind `helix terrain inspect`: what ships, how big it is, and what the bake had to drop. */
+function inspectTerrainSource(source) {
+    const { tilesX, tilesZ, metresPerSample } = source.grid;
+    const warnings = [];
+    let heights = 0;
+    let splats = 0;
+    let normals = 0;
+    let splatless = 0;
+    const foldedTiles = [];
+    let foldedRoles = 0;
+    let foldedMass = 0;
+    for (const tile of source.tiles) {
+        const tileBytes = (0, helix_manifest_1.heightfieldByteLength)(tile.field.samples, tile.field.hasHoleMask);
+        heights += tileBytes;
+        if (tileBytes > helix_manifest_1.HELIX_SCENE_CAPS.terrainHeightfieldBytes) {
+            warnings.push(`tile (${tile.tx}, ${tile.tz}) is ${tileBytes} bytes, over the ${helix_manifest_1.HELIX_SCENE_CAPS.terrainHeightfieldBytes}-byte cap`);
+        }
+        if (tile.splat)
+            splats += tile.splat.png.byteLength;
+        else
+            splatless += 1;
+        if (tile.normals)
+            normals += tile.normals.png.byteLength;
+        if (tile.folded.length > 0) {
+            foldedTiles.push({ tx: tile.tx, tz: tile.tz, roles: tile.folded });
+            foldedRoles += tile.folded.length;
+            foldedMass += tile.folded.reduce((sum, item) => sum + item.mass, 0);
+        }
+    }
+    const coarseBytes = (0, helix_manifest_1.heightfieldByteLength)(source.coarse.field.samples, source.coarse.field.hasHoleMask);
+    const coarseSplatBytes = source.coarse.splat ? source.coarse.splat.png.byteLength : 0;
+    const coarseNormalBytes = source.coarse.normals ? source.coarse.normals.png.byteLength : 0;
+    heights += coarseBytes;
+    splats += coarseSplatBytes;
+    normals += coarseNormalBytes;
+    if (source.tiles.length > helix_manifest_1.HELIX_SCENE_CAPS.terrainTiles) {
+        warnings.push(`${source.tiles.length} tiles exceeds the cap of ${helix_manifest_1.HELIX_SCENE_CAPS.terrainTiles}`);
+    }
+    if (tilesX > grid_1.MAX_GRID_TILES || tilesZ > grid_1.MAX_GRID_TILES)
+        warnings.push(`a ${tilesX} x ${tilesZ} grid exceeds the ${grid_1.MAX_GRID_TILES} x ${grid_1.MAX_GRID_TILES} cap`);
+    if (source.coarse.field.samples > helix_manifest_1.HELIX_SCENE_CAPS.terrainCoarseSamples) {
+        warnings.push(`the coarse layer is ${source.coarse.field.samples} samples, over the cap of ${helix_manifest_1.HELIX_SCENE_CAPS.terrainCoarseSamples}`);
+    }
+    if (coarseBytes > helix_manifest_1.HELIX_SCENE_CAPS.terrainHeightfieldBytes) {
+        warnings.push(`the coarse layer is ${coarseBytes} bytes, over the ${helix_manifest_1.HELIX_SCENE_CAPS.terrainHeightfieldBytes}-byte cap`);
+    }
+    if (!source.material)
+        warnings.push('no material block: the terrain has not been baked, so it would ship untextured');
+    else if (source.material.layers.length > helix_manifest_1.HELIX_SCENE_CAPS.terrainLayers) {
+        warnings.push(`the preset declares ${source.material.layers.length} layers, over the cap of ${helix_manifest_1.HELIX_SCENE_CAPS.terrainLayers}`);
+    }
+    if (splatless > 0)
+        warnings.push(`${splatless} of ${source.tiles.length} tiles have no splat`);
+    if (!source.coarse.splat)
+        warnings.push('the coarse layer has no splat');
+    for (const role of foldedRoleNames(foldedTiles)) {
+        const count = foldedTiles.filter((tile) => tile.roles.some((item) => item.role === role)).length;
+        warnings.push(`role "${role}" was folded into a kept role on ${count} of ${source.tiles.length} tiles`);
+    }
+    return {
+        extentM: [tilesX * (0, grid_1.tileMetresFor)(metresPerSample), tilesZ * (0, grid_1.tileMetresFor)(metresPerSample)],
+        tiles: source.tiles.length,
+        metresPerSample,
+        samples: (tilesX * grid_1.TILE_CELLS + 1) * (tilesZ * grid_1.TILE_CELLS + 1),
+        bytes: { heights, splats, normals, total: heights + splats + normals },
+        heightRange: (0, tile_1.terrainHeightRange)(source),
+        coarse: { samples: source.coarse.field.samples, bytes: coarseBytes + coarseSplatBytes + coarseNormalBytes },
+        folded: { tiles: foldedTiles, roles: foldedRoles, meanMass: foldedTiles.length > 0 ? foldedMass / foldedTiles.length : 0 },
+        warnings,
+    };
+}
+function formatTerrainInspection(report) {
+    const lines = [
+        `extent        ${report.extentM[0]} x ${report.extentM[1]} m`,
+        `tiles         ${report.tiles} (${report.samples.toLocaleString('en-US')} samples at ${report.metresPerSample} m)`,
+        `height range  ${report.heightRange[0].toFixed(2)} m to ${report.heightRange[1].toFixed(2)} m`,
+        `coarse layer  ${report.coarse.samples} samples, ${formatBytes(report.coarse.bytes)}`,
+        `bytes         ${formatBytes(report.bytes.total)} total (${formatBytes(report.bytes.heights)} heights, `
+            + `${formatBytes(report.bytes.splats)} splats, ${formatBytes(report.bytes.normals)} normals)`,
+    ];
+    if (report.folded.roles === 0)
+        lines.push('layer folding none');
+    else {
+        const share = `${(report.folded.meanMass * 100).toFixed(1)}%`;
+        lines.push(`layer folding ${report.folded.roles} role(s) on ${report.folded.tiles.length} tile(s), mean ${share} of tile weight`);
+        for (const tile of report.folded.tiles) {
+            lines.push(`  tile ${tile.tx},${tile.tz}  ${tile.roles.map((item) => `${item.role} ${(item.mass * 100).toFixed(1)}%`).join(', ')}`);
+        }
+    }
+    for (const warning of report.warnings)
+        lines.push(`warning       ${warning}`);
+    return lines.join('\n');
+}
+function foldedRoleNames(tiles) {
+    const names = new Set();
+    for (const tile of tiles)
+        for (const item of tile.roles)
+            names.add(item.role);
+    return [...names].sort();
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KiB`;
+    return `${(bytes / (1024 * 1024)).toFixed(2)} MiB`;
+}
+//# sourceMappingURL=inspect.js.map

package/dist/terrain/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/terrain/inspect.ts"],"names":[],"mappings":";;AAyBA,oDAkEC;AAED,0DAmBC;AAhHD,mEAAyF;AACzF,iCAAmE;AACnE,iCAAwF;AAsBxF,4GAA4G;AAC5G,SAAgB,oBAAoB,CAAC,MAAqB;IACxD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IACxD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,WAAW,GAAyC,EAAE,CAAC;IAC7D,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,IAAA,sCAAqB,EAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACpF,OAAO,IAAI,SAAS,CAAC;QACrB,IAAI,SAAS,GAAG,iCAAgB,CAAC,uBAAuB,EAAE,CAAC;YACzD,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,QAAQ,SAAS,oBAAoB,iCAAgB,CAAC,uBAAuB,WAAW,CAAC,CAAC;QACtI,CAAC;QACD,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;;YAC/C,SAAS,IAAI,CAAC,CAAC;QACpB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;QACzD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACnE,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YAClC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,IAAA,sCAAqB,EAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACxG,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACtF,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3F,OAAO,IAAI,WAAW,CAAC;IACvB,MAAM,IAAI,gBAAgB,CAAC;IAC3B,OAAO,IAAI,iBAAiB,CAAC;IAE7B,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,iCAAgB,CAAC,YAAY,EAAE,CAAC;QACxD,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,6BAA6B,iCAAgB,CAAC,YAAY,EAAE,CAAC,CAAC;IACpG,CAAC;IACD,IAAI,MAAM,GAAG,qBAAc,IAAI,MAAM,GAAG,qBAAc;QAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,MAAM,MAAM,MAAM,qBAAqB,qBAAc,MAAM,qBAAc,MAAM,CAAC,CAAC;IAC5J,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,iCAAgB,CAAC,oBAAoB,EAAE,CAAC;QACxE,QAAQ,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,6BAA6B,iCAAgB,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACxI,CAAC;IACD,IAAI,WAAW,GAAG,iCAAgB,CAAC,uBAAuB,EAAE,CAAC;QAC3D,QAAQ,CAAC,IAAI,CAAC,uBAAuB,WAAW,oBAAoB,iCAAgB,CAAC,uBAAuB,WAAW,CAAC,CAAC;IAC3H,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ;QAAE,QAAQ,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAAC;SACjH,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,iCAAgB,CAAC,aAAa,EAAE,CAAC;QACxE,QAAQ,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,4BAA4B,iCAAgB,CAAC,aAAa,EAAE,CAAC,CAAC;IAClI,CAAC;IACD,IAAI,SAAS,GAAG,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,sBAAsB,CAAC,CAAC;IAC/F,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK;QAAE,QAAQ,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IACzE,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QACjG,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,oCAAoC,KAAK,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;IAC1G,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,MAAM,GAAG,IAAA,oBAAa,EAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAA,oBAAa,EAAC,eAAe,CAAC,CAAC;QAC3F,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;QAC1B,eAAe;QACf,OAAO,EAAE,CAAC,MAAM,GAAG,iBAAU,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,iBAAU,GAAG,CAAC,CAAC;QAC9D,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,EAAE;QACtE,WAAW,EAAE,IAAA,yBAAkB,EAAC,MAAM,CAAC;QACvC,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,gBAAgB,GAAG,iBAAiB,EAAE;QAC3G,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;QAC1H,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAgB,uBAAuB,CAAC,MAAyB;IAC/D,MAAM,KAAK,GAAG;QACZ,iBAAiB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QAC7D,iBAAiB,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,eAAe,MAAM,CAAC,eAAe,KAAK;QAClH,iBAAiB,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QAC9F,iBAAiB,MAAM,CAAC,MAAM,CAAC,OAAO,aAAa,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QACrF,iBAAiB,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY;cACpG,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW;KAChG,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;SAC3D,CAAC;QACJ,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,MAAM,CAAC,KAAK,eAAe,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,kBAAkB,KAAK,iBAAiB,CAAC,CAAC;QAClI,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtI,CAAC;IACH,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAC;IAC9E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,eAAe,CAAC,KAA2C;IAClE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9E,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACnE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AACrD,CAAC"}

package/dist/terrain/island.d.ts

@@ -0,0 +1,31 @@
+import { type HeightGrid } from './grid';
+import type { TerrainPreset } from './presets';
+export interface IslandOptions {
+    seed?: number;
+    level?: number;
+    shelfDepth?: number;
+}
+/** Derive a closed coast inside the source footprint; the source and the interior samples remain untouched. */
+export declare function deriveIsland(source: HeightGrid, options?: IslandOptions): HeightGrid;
+/** Preserve the original absolute snow/altitude rules after adding a submerged shelf; sand occupies the shore. */
+export declare function islandPreset(preset: TerrainPreset, original: HeightGrid, island: HeightGrid, level?: number): TerrainPreset;
+export interface OceanBathymetry {
+    version: 1;
+    width: number;
+    height: number;
+    origin: [number, number];
+    span: [number, number];
+    heightRange: [number, number];
+    level: number;
+    sha256: string;
+}
+export interface OceanBathymetryOptions {
+    /** Names the wet ground itself, in world metres; the boundary-connected flood fill is skipped when it is given. */
+    wet?: (x: number, z: number) => boolean;
+}
+/** R/G = high/low height bytes, B = boundary-connected ocean, A = distance to dry ground (0..32 m).
+ * A <= 2 m grid stays resident, so a streaming terrain LOD does not change the shoreline. Maximum 16.1 MiB. */
+export declare function bakeOceanBathymetry(grid: HeightGrid, level?: number, spacing?: number, options?: OceanBathymetryOptions): {
+    info: OceanBathymetry;
+    bytes: Uint8Array;
+};

package/dist/terrain/island.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveIsland = deriveIsland;
+exports.islandPreset = islandPreset;
+exports.bakeOceanBathymetry = bakeOceanBathymetry;
+const node_crypto_1 = require("node:crypto");
+const grid_1 = require("./grid");
+const noise_1 = require("./noise");
+/** Derive a closed coast inside the source footprint; the source and the interior samples remain untouched. */
+function deriveIsland(source, options = {}) {
+    const { seed = 1, level = 0, shelfDepth = 40 } = options;
+    if (![seed, level, shelfDepth].every(Number.isFinite) || shelfDepth < 4 || shelfDepth > 256)
+        throw new Error('island: invalid seed, level or shelf depth');
+    const grid = { ...source, heights: source.heights.slice(), holes: source.holes?.slice() ?? null };
+    const halfX = ((grid.samplesX - 1) / 2) * grid.metresPerSample, halfZ = ((grid.samplesZ - 1) / 2) * grid.metresPerSample;
+    const extent = Math.min(halfX, halfZ), inland = Math.min(260, extent * 0.32);
+    const phase = ((seed >>> 0) % 65536) / 65536 * Math.PI * 2;
+    for (let j = 0; j < grid.samplesZ; j++)
+        for (let i = 0; i < grid.samplesX; i++) {
+            // Metres from the centre over the half-extent: the shape is the same at any sample spacing.
+            const x = (i * grid.metresPerSample - halfX) / halfX, z = (j * grid.metresPerSample - halfZ) / halfZ, angle = Math.atan2(z, x);
+            const radius = 0.78 + 0.06 * Math.sin(angle * 3 + phase) + 0.045 * Math.sin(angle * 5 - phase) + 0.02 * Math.sin(angle * 9 + phase * 2);
+            const r = Math.pow(Math.abs(x) ** 2.6 + Math.abs(z) ** 2.6, 1 / 2.6);
+            const distance = (radius - r) * extent;
+            const at = j * grid.samplesX + i;
+            if (distance >= inland)
+                continue;
+            const beachSlope = 0.1 + 0.16 * (0.5 + 0.5 * Math.sin(angle * 4 + phase));
+            const shore = level + (distance >= 0 ? distance * beachSlope : Math.max(-shelfDepth, distance * 0.32));
+            const blend = (0, noise_1.smoothstep)(inland * 0.2, inland, Math.max(0, distance));
+            grid.heights[at] = shore + (source.heights[at] - shore) * blend;
+            if (grid.holes && distance <= 0)
+                grid.holes[at] = 0;
+        }
+    return grid;
+}
+/** Preserve the original absolute snow/altitude rules after adding a submerged shelf; sand occupies the shore. */
+function islandPreset(preset, original, island, level = 0) {
+    const old = (0, grid_1.fieldHeightRange)(original), next = (0, grid_1.fieldHeightRange)(island);
+    const normalize = (height) => Math.max(0, Math.min(1, (height - next[0]) / (next[1] - next[0])));
+    const rules = Object.fromEntries(Object.entries(preset.rules).map(([role, rule]) => [role, {
+            ...rule, ...(rule.height ? { height: rule.height.map(v => normalize(old[0] + v * (old[1] - old[0]))) } : {}),
+        }]));
+    rules.low = { height: [normalize(level + 8), normalize(level + 1)], maxWeight: 4 };
+    return { ...preset, preset: 'alpine-island', rules,
+        layers: preset.layers.map(layer => layer.role === 'low' ? { ...layer, material: 'sand', tilingMetres: 2.5 } : { ...layer }) };
+}
+/** R/G = high/low height bytes, B = boundary-connected ocean, A = distance to dry ground (0..32 m).
+ * A <= 2 m grid stays resident, so a streaming terrain LOD does not change the shoreline. Maximum 16.1 MiB. */
+function bakeOceanBathymetry(grid, level = 0, spacing = 2, options = {}) {
+    if (!Number.isFinite(level) || !Number.isInteger(spacing) || spacing < 1 || spacing > 8)
+        throw new Error('ocean bathymetry: invalid level or spacing');
+    const span = [(grid.samplesX - 1) * grid.metresPerSample, (grid.samplesZ - 1) * grid.metresPerSample];
+    const width = Math.ceil(span[0] / spacing) + 1, height = Math.ceil(span[1] / spacing) + 1;
+    if (width > 2049 || height > 2049)
+        throw new Error('ocean bathymetry: maximum 2049 samples per side; increase spacing');
+    const count = width * height, heights = new Float32Array(count), wet = new Uint8Array(count), queue = new Uint32Array(count);
+    const dx = span[0] / (width - 1), dz = span[1] / (height - 1);
+    for (let z = 0; z < height; z++)
+        for (let x = 0; x < width; x++) {
+            heights[z * width + x] = (0, grid_1.sampleFieldHeight)(grid, grid.originX + x * dx, grid.originZ + z * dz);
+        }
+    if (options.wet) {
+        for (let z = 0; z < height; z++)
+            for (let x = 0; x < width; x++) {
+                wet[z * width + x] = options.wet(grid.originX + x * dx, grid.originZ + z * dz) ? 1 : 0;
+            }
+    }
+    else {
+        let read = 0, write = 0;
+        const visit = (index) => {
+            if (wet[index] || heights[index] > level + 2)
+                return;
+            wet[index] = 1;
+            queue[write++] = index;
+        };
+        for (let x = 0; x < width; x++) {
+            visit(x);
+            visit((height - 1) * width + x);
+        }
+        for (let z = 0; z < height; z++) {
+            visit(z * width);
+            visit(z * width + width - 1);
+        }
+        while (read < write) {
+            const at = queue[read++], x = at % width, z = Math.floor(at / width);
+            if (x > 0)
+                visit(at - 1);
+            if (x + 1 < width)
+                visit(at + 1);
+            if (z > 0)
+                visit(at - width);
+            if (z + 1 < height)
+                visit(at + width);
+        }
+    }
+    const distance = new Float32Array(count);
+    for (let i = 0; i < count; i++)
+        distance[i] = (options.wet ? wet[i] === 0 : heights[i] > level) ? 0 : 32;
+    const diagonal = Math.hypot(dx, dz);
+    for (const step of [1, -1]) {
+        for (let z = step > 0 ? 0 : height - 1; z >= 0 && z < height; z += step) {
+            for (let x = step > 0 ? 0 : width - 1; x >= 0 && x < width; x += step) {
+                const at = z * width + x, previousX = x - step, previousZ = z - step;
+                if (previousX >= 0 && previousX < width)
+                    distance[at] = Math.min(distance[at], distance[at - step] + dx);
+                if (previousZ >= 0 && previousZ < height) {
+                    distance[at] = Math.min(distance[at], distance[at - step * width] + dz);
+                    for (const side of [-1, 1])
+                        if (x + side >= 0 && x + side < width) {
+                            distance[at] = Math.min(distance[at], distance[at - step * width + side] + diagonal);
+                        }
+                }
+            }
+        }
+    }
+    const bytes = new Uint8Array(count * 4), heightRange = [level - 64, level + 64];
+    for (let i = 0; i < count; i++) {
+        const packed = Math.round(Math.max(0, Math.min(1, (heights[i] - heightRange[0]) / 128)) * 65535);
+        bytes[i * 4] = packed >>> 8;
+        bytes[i * 4 + 1] = packed & 255;
+        bytes[i * 4 + 2] = wet[i] * 255;
+        bytes[i * 4 + 3] = Math.round(distance[i] / 32 * 255);
+    }
+    return { bytes, info: { version: 1, width, height, origin: [grid.originX, grid.originZ], span, heightRange, level,
+            sha256: (0, node_crypto_1.createHash)('sha256').update(bytes).digest('hex') } };
+}
+//# sourceMappingURL=island.js.map

package/dist/terrain/island.js.map

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

package/dist/terrain/noise.d.ts

@@ -0,0 +1,79 @@
+export declare function clamp(v: number, lo: number, hi: number): number;
+export declare function smoothstep(edge0: number, edge1: number, x: number): number;
+export declare function mix(a: number, b: number, t: number): number;
+/** A small deterministic PRNG, used to place stamps: the same seed gives the same world in a test and in the browser. */
+export declare function makeRng(seed: number): () => number;
+export declare function hash2(ix: number, iz: number, seed: number): number;
+export declare function valueNoise(x: number, z: number, seed: number): number;
+/** Fractal value noise, -1..1. */
+export declare function fbm(x: number, z: number, octaves: number, seed: number): number;
+/** Creased noise, 0..1. Smooth noise on a dome reads as a bubble; the creases are what the eye reads as rock. */
+export declare function ridgedFbm(x: number, z: number, octaves: number, seed: number): number;
+/** Billowed noise, 0..1 - rounded lumps: dunes, ash mounds, meadow swells. */
+export declare function billowFbm(x: number, z: number, octaves: number, seed: number): number;
+/** Offsets the sample point by a low-frequency noise field so ridges bend instead of running straight. */
+export declare function domainWarp(x: number, z: number, metres: number, amplitude: number, seed: number): {
+    x: number;
+    z: number;
+};
+/** 1 inside the rect, falling smoothly to 0 `falloff` metres outside it. */
+export declare function rectMask(x: number, z: number, minX: number, maxX: number, minZ: number, maxZ: number, falloff: number): number;
+/** 1 within `radius` of the centre, falling smoothly to 0 `falloff` metres further out. */
+export declare function radialMask(x: number, z: number, centreX: number, centreZ: number, radius: number, falloff: number): number;
+export interface DomeStamp {
+    x: number;
+    z: number;
+    radius: number;
+    height: number;
+    /** Share of the height carried by ridged noise: 0 is a smooth bubble, 1 is all creases. */
+    ridge?: number;
+    grain?: number;
+    seed: number;
+}
+/** Metres a hill adds at (x, z), 0 outside its radius. */
+export declare function domeStamp(x: number, z: number, s: DomeStamp): number;
+export interface BasinStamp {
+    x: number;
+    z: number;
+    radiusX: number;
+    radiusZ: number;
+    /** Bed height at the centre, metres. */
+    floor: number;
+    /** Normalized radius the bed holds flat to before it climbs; a bowl that climbs from the centre leaves no usable water. */
+    flatTo: number;
+    rise: number;
+    blend?: number;
+}
+/** The bed height a basin wants at (x, z) and how strongly it claims the point; mix rather than min, or the shore is a crease. */
+export declare function basinStamp(x: number, z: number, s: BasinStamp): {
+    height: number;
+    weight: number;
+};
+export interface DuneStamp {
+    height: number;
+    wavelength: number;
+    angleDeg: number;
+    seed: number;
+    /** Above 1 this sharpens the crests and widens the troughs. */
+    sharpness?: number;
+}
+/** Metres a transverse dune field adds at (x, z): crests across one wind direction, wandered by noise. */
+export declare function duneStamp(x: number, z: number, s: DuneStamp): number;
+export interface CraterStamp {
+    x: number;
+    z: number;
+    radius: number;
+    /** Cone height at the rim, metres. */
+    rimHeight: number;
+    /** Depth of the bowl below the rim, metres. */
+    depth: number;
+    seed: number;
+}
+/** Metres a volcanic cone adds: flanks peaking at `radius`, a bowl sunk inside them. */
+export declare function craterStamp(x: number, z: number, s: CraterStamp): number;
+/**
+ * A one-sided soft limit: values below `limit - softness` pass through, above it they converge on `limit` with a
+ * continuous derivative. A hard clamp terraces every peak into a plateau.
+ */
+export declare function softMax(value: number, limit: number, softness: number): number;
+export declare function softMin(value: number, limit: number, softness: number): number;

package/dist/terrain/noise.js

@@ -0,0 +1,162 @@
+"use strict";
+// Ported from helix-web-engine-new/examples/Development/playground/src/map/terrain.ts. SYNC OBLIGATION: keep the noise primitives in step.
+// Pure and deterministic by contract: the shipped collider is quantized from these numbers, so a machine-dependent result desyncs physics.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clamp = clamp;
+exports.smoothstep = smoothstep;
+exports.mix = mix;
+exports.makeRng = makeRng;
+exports.hash2 = hash2;
+exports.valueNoise = valueNoise;
+exports.fbm = fbm;
+exports.ridgedFbm = ridgedFbm;
+exports.billowFbm = billowFbm;
+exports.domainWarp = domainWarp;
+exports.rectMask = rectMask;
+exports.radialMask = radialMask;
+exports.domeStamp = domeStamp;
+exports.basinStamp = basinStamp;
+exports.duneStamp = duneStamp;
+exports.craterStamp = craterStamp;
+exports.softMax = softMax;
+exports.softMin = softMin;
+function clamp(v, lo, hi) {
+    return v < lo ? lo : v > hi ? hi : v;
+}
+function smoothstep(edge0, edge1, x) {
+    if (edge0 === edge1)
+        return x < edge0 ? 0 : 1;
+    const t = clamp((x - edge0) / (edge1 - edge0), 0, 1);
+    return t * t * (3 - 2 * t);
+}
+function mix(a, b, t) {
+    return a + (b - a) * t;
+}
+/** A small deterministic PRNG, used to place stamps: the same seed gives the same world in a test and in the browser. */
+function makeRng(seed) {
+    let s = seed >>> 0 || 1;
+    return () => {
+        s ^= s << 13;
+        s >>>= 0;
+        s ^= s >>> 17;
+        s ^= s << 5;
+        s >>>= 0;
+        return s / 4294967296;
+    };
+}
+function hash2(ix, iz, seed) {
+    let h = (Math.imul(ix, 374761393) + Math.imul(iz, 668265263) + Math.imul(seed, 1442695041)) | 0;
+    h = Math.imul(h ^ (h >>> 13), 1274126177);
+    return ((h ^ (h >>> 16)) >>> 0) / 4294967296;
+}
+function valueNoise(x, z, seed) {
+    const x0 = Math.floor(x);
+    const z0 = Math.floor(z);
+    const fx = x - x0;
+    const fz = z - z0;
+    const u = fx * fx * (3 - 2 * fx);
+    const v = fz * fz * (3 - 2 * fz);
+    const n00 = hash2(x0, z0, seed);
+    const n10 = hash2(x0 + 1, z0, seed);
+    const n01 = hash2(x0, z0 + 1, seed);
+    const n11 = hash2(x0 + 1, z0 + 1, seed);
+    return (n00 * (1 - u) + n10 * u) * (1 - v) + (n01 * (1 - u) + n11 * u) * v;
+}
+/** Fractal value noise, -1..1. */
+function fbm(x, z, octaves, seed) {
+    let amp = 0.5;
+    let freq = 1;
+    let sum = 0;
+    let norm = 0;
+    for (let i = 0; i < octaves; i++) {
+        sum += amp * (valueNoise(x * freq, z * freq, seed + i * 977) * 2 - 1);
+        norm += amp;
+        amp *= 0.5;
+        freq *= 2;
+    }
+    return norm === 0 ? 0 : sum / norm;
+}
+/** Creased noise, 0..1. Smooth noise on a dome reads as a bubble; the creases are what the eye reads as rock. */
+function ridgedFbm(x, z, octaves, seed) {
+    return 1 - Math.abs(fbm(x, z, octaves, seed));
+}
+/** Billowed noise, 0..1 - rounded lumps: dunes, ash mounds, meadow swells. */
+function billowFbm(x, z, octaves, seed) {
+    return Math.abs(fbm(x, z, octaves, seed));
+}
+/** Offsets the sample point by a low-frequency noise field so ridges bend instead of running straight. */
+function domainWarp(x, z, metres, amplitude, seed) {
+    if (metres <= 0 || amplitude === 0)
+        return { x, z };
+    const wx = fbm(x / metres, z / metres, 3, seed);
+    const wz = fbm(x / metres + 5.2, z / metres + 1.3, 3, seed + 7919);
+    return { x: x + wx * amplitude, z: z + wz * amplitude };
+}
+/** 1 inside the rect, falling smoothly to 0 `falloff` metres outside it. */
+function rectMask(x, z, minX, maxX, minZ, maxZ, falloff) {
+    const dx = Math.max(minX - x, 0, x - maxX);
+    const dz = Math.max(minZ - z, 0, z - maxZ);
+    const d = Math.hypot(dx, dz);
+    return 1 - smoothstep(0, falloff, d);
+}
+/** 1 within `radius` of the centre, falling smoothly to 0 `falloff` metres further out. */
+function radialMask(x, z, centreX, centreZ, radius, falloff) {
+    const d = Math.hypot(x - centreX, z - centreZ);
+    return 1 - smoothstep(radius, radius + falloff, d);
+}
+/** Metres a hill adds at (x, z), 0 outside its radius. */
+function domeStamp(x, z, s) {
+    const d = Math.hypot(x - s.x, z - s.z) / s.radius;
+    if (d >= 1)
+        return 0;
+    const dome = Math.cos(clamp(d, 0, 1) * Math.PI) * 0.5 + 0.5;
+    const ridgeAmount = s.ridge ?? 0.24;
+    const grainAmount = s.grain ?? 0.06;
+    const ridge = ridgedFbm(x / (s.radius * 0.38), z / (s.radius * 0.38), 4, s.seed);
+    const grain = fbm(x / (s.radius * 0.12), z / (s.radius * 0.12), 3, s.seed + 641);
+    return s.height * dome * dome * (1 - ridgeAmount - grainAmount + ridgeAmount * ridge + grainAmount * grain);
+}
+/** The bed height a basin wants at (x, z) and how strongly it claims the point; mix rather than min, or the shore is a crease. */
+function basinStamp(x, z, s) {
+    const dx = (x - s.x) / s.radiusX;
+    const dz = (z - s.z) / s.radiusZ;
+    const t = Math.hypot(dx, dz);
+    const blend = s.blend ?? 0.18;
+    if (t >= 1 + blend)
+        return { height: 0, weight: 0 };
+    const height = s.floor + s.rise * Math.pow(smoothstep(s.flatTo, 1, t), 1.1);
+    return { height, weight: 1 - smoothstep(1 - blend, 1 + blend, t) };
+}
+/** Metres a transverse dune field adds at (x, z): crests across one wind direction, wandered by noise. */
+function duneStamp(x, z, s) {
+    const a = (s.angleDeg * Math.PI) / 180;
+    const u = x * Math.cos(a) + z * Math.sin(a);
+    const wander = fbm(x / (s.wavelength * 2.4), z / (s.wavelength * 2.4), 3, s.seed) * s.wavelength * 0.55;
+    const crest = 0.5 + 0.5 * Math.sin(((u + wander) / s.wavelength) * Math.PI * 2);
+    const field = 0.55 + 0.45 * fbm(x / (s.wavelength * 6), z / (s.wavelength * 6), 3, s.seed + 313);
+    return s.height * Math.pow(crest, s.sharpness ?? 1.6) * field;
+}
+/** Metres a volcanic cone adds: flanks peaking at `radius`, a bowl sunk inside them. */
+function craterStamp(x, z, s) {
+    const d = Math.hypot(x - s.x, z - s.z) / s.radius;
+    if (d >= 2.4)
+        return 0;
+    const flank = s.rimHeight * Math.pow(1 - smoothstep(1, 2.4, d), 1.4);
+    const bowl = s.depth * (1 - smoothstep(0.35, 1, d));
+    const rough = 1 + 0.14 * fbm(x / (s.radius * 0.2), z / (s.radius * 0.2), 3, s.seed);
+    return flank * rough - bowl;
+}
+/**
+ * A one-sided soft limit: values below `limit - softness` pass through, above it they converge on `limit` with a
+ * continuous derivative. A hard clamp terraces every peak into a plateau.
+ */
+function softMax(value, limit, softness) {
+    if (softness <= 0)
+        return Math.min(value, limit);
+    const knee = limit - softness;
+    return value <= knee ? value : limit - softness * Math.exp(-(value - knee) / softness);
+}
+function softMin(value, limit, softness) {
+    return -softMax(-value, -limit, softness);
+}
+//# sourceMappingURL=noise.js.map

package/dist/terrain/noise.js.map

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

package/dist/terrain/normals.d.ts

@@ -0,0 +1,21 @@
+import { type SampleField } from './grid';
+/** Channels one normal pixel carries: the WORLD-space unit normal, `rgb = n * 0.5 + 0.5`, +Y up and no tangent frame. */
+export declare const NORMAL_CHANNELS = 3;
+export interface TerrainNormalMap {
+    width: number;
+    height: number;
+    png: Uint8Array;
+}
+/** The pixel window a normal map covers, in samples of the field it is taken from. */
+export interface NormalRegion {
+    originI: number;
+    originJ: number;
+    pixels: number;
+}
+/**
+ * Encodes one RGB8 normal per sample cell. The runtime derives its normals from the u16 heights, which terraces a
+ * gentle slope into a handful of directions; these come from the float field, so the shader reads a smooth one.
+ */
+export declare function encodeNormalPixels(field: SampleField, region: NormalRegion): Uint8Array;
+/** One tile's or the coarse layer's normal map as the PNG the source folder and the scene resource both ship. */
+export declare function bakeNormalMap(field: SampleField, region: NormalRegion): Promise<TerrainNormalMap>;