@hypersoniclabs/helix-cli 0.1.27-helix3.550 → 0.1.27-helix3.552

package/dist/city/assemble/oceanFile.d.ts

@@ -0,0 +1,33 @@
+import type { CitySource } from '../source';
+import { type HeightGrid } from '../../terrain/grid';
+import { type OceanBathymetry } from '../../terrain/island';
+export interface OceanFileOptions {
+    /** The height grid the ground height is read from; omitted, the source's DEM resampled at `groundMetresPerSample`. */
+    grid?: HeightGrid;
+    /** Ground sampling when no grid is given (default 8: the ocean file never needs finer). */
+    groundMetresPerSample?: number;
+    /** Metres between ocean samples, 1..8. Default: the smallest that keeps the file within the format's 2049 samples a side (at least 2). */
+    spacingM?: number;
+    /** A sea cell this far above the surface is dry (the polygon edge and a beach overlap by a few decimetres). Default 2 m, the baker's own flood-fill threshold. */
+    dryAboveM?: number;
+    log?: (line: string) => void;
+}
+export interface OceanFileResult {
+    written: boolean;
+    /** Why nothing was written. */
+    reason?: string;
+    /** Surface height the file is pinned to; the visuals' `ocean.level` must equal it (the shell default is 0). */
+    level?: number;
+    info?: OceanBathymetry;
+    files?: string[];
+    /** Share of the ocean samples that are open sea. */
+    wetFraction?: number;
+    warnings: string[];
+}
+/**
+ * Writes `ocean.json` and `ocean.rgba` into `packageDir` (the Scene package folder, beside `scene.helix-scene.json`) from a city
+ * source's open sea: the `sea`/`ocean` water bodies (the same bodies `citySeaFromWater` turns into the `water.sea` volume) as the
+ * wet area, the DEM as the ground. A source without an open sea writes nothing. The Scene document does not reference the pair, so
+ * it can be called after `createCityScene` or `composeWorld` and neither document's integrity moves.
+ */
+export declare function writeCityOceanFile(source: CitySource, packageDir: string, options?: OceanFileOptions): OceanFileResult;

package/dist/city/assemble/oceanFile.js

@@ -0,0 +1,96 @@
+"use strict";
+// The ocean bathymetry of a city scene: `ocean.json` + `ocean.rgba` beside the Scene document, so the shell's visual ocean
+// draws the open sea and `visuals.ocean.level` exists (fly landing refuses to set down on water, a swimmer resets to dry ground, the
+// camera floor stops at the sea). `terrain island` writes the same pair for a converted CS2 landscape; a city-source scene had
+// the sea as a `water.sea` volume only (src/city/assemble/sea.ts), so the pair was missing and every World built from a city source
+// shipped without a dry-ground guard.
+//
+// Same file format as `terrain island` (src/terrain/island.ts `bakeOceanBathymetry`), which the engine loads with
+// `loadBathymetry` (systems/visual/src/ocean/bathymetry.ts): version 1, at most 2049 samples a side, R/G height bytes, B wet, A
+// distance to dry ground, SHA-256 of the bytes, `level` equal to the visuals' ocean level (0 unless the shell sets another).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeCityOceanFile = writeCityOceanFile;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const sea_1 = require("./sea");
+const terrain_1 = require("./terrain");
+const grid_1 = require("../../terrain/grid");
+const island_1 = require("../../terrain/island");
+/** Even-odd scanline fill of rings (outer ring and holes together) into `mask` at the sample positions the baker uses. */
+function fillRings(mask, rings, origin, step, width, height) {
+    const crossings = [];
+    for (let j = 0; j < height; j += 1) {
+        const z = origin[1] + j * step[1];
+        crossings.length = 0;
+        for (const ring of rings) {
+            for (let k = 0; k < ring.length; k += 1) {
+                const [x0, z0] = ring[k], [x1, z1] = ring[(k + 1) % ring.length];
+                if ((z0 <= z) === (z1 <= z))
+                    continue;
+                crossings.push(x0 + ((z - z0) / (z1 - z0)) * (x1 - x0));
+            }
+        }
+        if (crossings.length < 2)
+            continue;
+        crossings.sort((a, b) => a - b);
+        for (let c = 0; c + 1 < crossings.length; c += 2) {
+            const from = Math.max(0, Math.ceil((crossings[c] - origin[0]) / step[0]));
+            const to = Math.min(width, Math.ceil((crossings[c + 1] - origin[0]) / step[0]));
+            for (let i = from; i < to; i += 1)
+                mask[j * width + i] = 1;
+        }
+    }
+}
+/**
+ * Writes `ocean.json` and `ocean.rgba` into `packageDir` (the Scene package folder, beside `scene.helix-scene.json`) from a city
+ * source's open sea: the `sea`/`ocean` water bodies (the same bodies `citySeaFromWater` turns into the `water.sea` volume) as the
+ * wet area, the DEM as the ground. A source without an open sea writes nothing. The Scene document does not reference the pair, so
+ * it can be called after `createCityScene` or `composeWorld` and neither document's integrity moves.
+ */
+function writeCityOceanFile(source, packageDir, options = {}) {
+    const warnings = [];
+    const water = source.areas?.water ?? [];
+    const sea = (0, sea_1.citySeaFromWater)(water);
+    if (!sea)
+        return { written: false, reason: 'the source holds no open sea (no `sea` body over 20 km2 and no `ocean`)', warnings };
+    const level = sea.surfaceHeightM;
+    if (level !== 0)
+        warnings.push(`sea surface is ${level} m; the shell's visuals must set ocean.level to ${level} or the bathymetry is refused`);
+    const grid = options.grid ?? (0, terrain_1.terrainGridFor)(source, options.groundMetresPerSample ?? 8);
+    const spanX = (grid.samplesX - 1) * grid.metresPerSample, spanZ = (grid.samplesZ - 1) * grid.metresPerSample;
+    const spacing = options.spacingM ?? Math.max(2, Math.ceil(Math.max(spanX, spanZ) / 2048));
+    if (!Number.isInteger(spacing) || spacing < 1 || spacing > 8) {
+        return { written: false, reason: `a ${Math.round(Math.max(spanX, spanZ))} m map needs ${spacing} m ocean samples; the format allows 1 to 8 m and 2049 samples a side`, warnings };
+    }
+    const width = Math.ceil(spanX / spacing) + 1, height = Math.ceil(spanZ / spacing) + 1;
+    const step = [spanX / (width - 1), spanZ / (height - 1)];
+    const origin = [grid.originX, grid.originZ];
+    const bodies = water.filter((body) => (body.kind === 'sea' || body.kind === 'ocean') && body.ring);
+    const mask = new Uint8Array(width * height);
+    for (const body of bodies) {
+        const one = new Uint8Array(width * height);
+        fillRings(one, [body.ring, ...(body.holes ?? [])], origin, step, width, height);
+        for (let i = 0; i < one.length; i += 1)
+            if (one[i])
+                mask[i] = 1;
+    }
+    const dryAbove = options.dryAboveM ?? 2;
+    const wetAt = (x, z) => {
+        const i = Math.round((x - origin[0]) / step[0]), j = Math.round((z - origin[1]) / step[1]);
+        return mask[j * width + i] === 1 && (0, grid_1.sampleFieldHeight)(grid, x, z) <= level + dryAbove;
+    };
+    const ocean = (0, island_1.bakeOceanBathymetry)(grid, level, spacing, { wet: wetAt });
+    let wet = 0;
+    for (let i = 2; i < ocean.bytes.length; i += 4)
+        if (ocean.bytes[i] > 127)
+            wet += 1;
+    const wetFraction = wet / (ocean.info.width * ocean.info.height);
+    if (wet === 0)
+        return { written: false, reason: 'no ocean sample is open sea (the sea body does not overlap the terrain, or the terrain there is above the surface)', level, warnings };
+    (0, node_fs_1.mkdirSync)(packageDir, { recursive: true });
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(packageDir, 'ocean.rgba'), ocean.bytes);
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(packageDir, 'ocean.json'), `${JSON.stringify({ ...ocean.info, data: 'ocean.rgba' }, null, 2)}\n`);
+    options.log?.(`ocean: ${ocean.info.width} x ${ocean.info.height} at ${spacing} m, ${(wetFraction * 100).toFixed(1)}% open sea, level ${level}`);
+    return { written: true, level, info: ocean.info, files: ['ocean.json', 'ocean.rgba'], wetFraction, warnings };
+}
+//# sourceMappingURL=oceanFile.js.map

package/dist/city/assemble/oceanFile.js.map

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

package/dist/city/assemble/sceneVisuals.d.ts

@@ -0,0 +1,49 @@
+import type { CitySourceManifest } from '../source';
+export interface SceneVisualsConfig {
+    version: 1;
+    mode: 'dynamic';
+    weather: {
+        enabled: boolean;
+        preset: string;
+    };
+    timeOfDay: {
+        hours: number;
+        cycleSeconds: number;
+        latitudeDeg: number;
+        declinationDeg: number;
+        noonAzimuthDeg: number;
+    };
+    probes: {
+        skyFallback: boolean;
+    };
+    shadows: {
+        extent: number;
+    };
+    fog: {
+        density: number;
+        heightDensity: number;
+    };
+    sky: {
+        model: string;
+        mieScale: number;
+        groundBounceAlbedo: number;
+    };
+    look: {
+        preset: string;
+    };
+    exposure?: {
+        compensation: number;
+    };
+}
+/** What the far edge of the map keeps of its contrast through the fog. */
+export declare const FOG_FAR_EDGE_TRANSMITTANCE = 0.2;
+/** Ground fog is this much denser than the air above it. */
+export declare const GROUND_FOG_RATIO = 1.8;
+/** The latitude and hour of a map that has no place on Earth. */
+export declare const FICTIONAL_LATITUDE_DEG = 37.8;
+export declare const DEFAULT_HOURS = 14;
+export declare const CS2_EXPOSURE_COMPENSATION = 1.5;
+/** The scene visuals a city source gets. `scale` multiplies the fog densities (default 1). Pure: same manifest, same JSON. */
+export declare function deriveSceneVisuals(manifest: Pick<CitySourceManifest, 'frame'>, scale?: number): SceneVisualsConfig;
+/** Writes `<dir>/scene-visuals/<sceneName>.json` (the path the shell fetches under its data prefix) and returns it. */
+export declare function writeSceneVisualsFile(dir: string, sceneName: string, visuals: SceneVisualsConfig): string;

package/dist/city/assemble/sceneVisuals.js

@@ -0,0 +1,66 @@
+"use strict";
+// The look of a city scene: the per-map `scene-visuals/<scene>.json` the shell loads for a World whose sky and fog are not the
+// default World's. A Leonida World's file was hand-copied from Granit's `helix.visuals.json` and edited (fog, hours, latitude); the
+// shell also had to be told the scene name. This derives the same JSON from the city source's manifest, so a new map gets its
+// own file from the pipeline: `writeSceneVisualsFile` after create/compose, and the shell reads `scene-visuals/<name>.json`.
+//
+// The shape is the visual runtime's contract (`helix.visuals.json`, audited by `helix validate`). Constants that are the same for
+// every map (sky model, probes, shadow extent, weather, the `day` look) come from Granit's file; what depends on the place is derived:
+//
+//   latitudeDeg      a geographic source (`local-tm`) takes its projection origin's latitude. A fictional map (CS2, synthetic) has
+//                    none: it gets a mid-latitude default (37.8) and an early-afternoon sun (14 h), a long warm light that
+//                    still reads a skyline's faces, not a noon top-down one.
+//   noonAzimuthDeg   180 (sun due south at noon) in the northern hemisphere, 0 in the southern one.
+//   fog              exp(-density x extent) = 0.2: the far edge of the map keeps a fifth of its contrast, so a skyline reads from
+//                    the air at any map size (Leonida, 14,336 m: 0.00011; a 6.4 km map comes out at 0.00025, the value Granit's file has).
+//                    Ground fog (`heightDensity`) is 1.8 x that. `scale` multiplies both (an art knob; 1 keeps the rule).
+//   exposure         CS2 buildings come from a game that exposes its HDR; +1.5 EV keeps the converted facades from reading dim.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CS2_EXPOSURE_COMPENSATION = exports.DEFAULT_HOURS = exports.FICTIONAL_LATITUDE_DEG = exports.GROUND_FOG_RATIO = exports.FOG_FAR_EDGE_TRANSMITTANCE = void 0;
+exports.deriveSceneVisuals = deriveSceneVisuals;
+exports.writeSceneVisualsFile = writeSceneVisualsFile;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/** What the far edge of the map keeps of its contrast through the fog. */
+exports.FOG_FAR_EDGE_TRANSMITTANCE = 0.2;
+/** Ground fog is this much denser than the air above it. */
+exports.GROUND_FOG_RATIO = 1.8;
+/** The latitude and hour of a map that has no place on Earth. */
+exports.FICTIONAL_LATITUDE_DEG = 37.8;
+exports.DEFAULT_HOURS = 14;
+exports.CS2_EXPOSURE_COMPENSATION = 1.5;
+const round5 = (value) => Math.round(value * 1e5) / 1e5;
+/** The scene visuals a city source gets. `scale` multiplies the fog densities (default 1). Pure: same manifest, same JSON. */
+function deriveSceneVisuals(manifest, scale = 1) {
+    if (!(scale > 0) || !Number.isFinite(scale))
+        throw new Error(`sceneVisuals: scale must be a positive number, got ${scale}`);
+    const { projection, boundsXZ } = manifest.frame;
+    const extentM = Math.max(boundsXZ[1][0] - boundsXZ[0][0], boundsXZ[1][1] - boundsXZ[0][1]);
+    if (!(extentM > 0))
+        throw new Error('sceneVisuals: the source frame has no extent');
+    const latitudeDeg = projection.kind === 'local-tm' ? projection.originLonLat[1] : exports.FICTIONAL_LATITUDE_DEG;
+    const density = Math.min(0.001, Math.max(0.00002, round5((-Math.log(exports.FOG_FAR_EDGE_TRANSMITTANCE) / extentM) * scale)));
+    return {
+        version: 1,
+        mode: 'dynamic',
+        weather: { enabled: true, preset: 'fair' },
+        timeOfDay: { hours: exports.DEFAULT_HOURS, cycleSeconds: 0, latitudeDeg, declinationDeg: 10, noonAzimuthDeg: latitudeDeg < 0 ? 0 : 180 },
+        probes: { skyFallback: true },
+        shadows: { extent: 200 },
+        fog: { density, heightDensity: round5(density * exports.GROUND_FOG_RATIO) },
+        sky: { model: 'hillaire', mieScale: 1.0, groundBounceAlbedo: 0.25 },
+        look: { preset: 'day' },
+        ...(projection.kind === 'cs2' ? { exposure: { compensation: exports.CS2_EXPOSURE_COMPENSATION } } : {}),
+    };
+}
+/** Writes `<dir>/scene-visuals/<sceneName>.json` (the path the shell fetches under its data prefix) and returns it. */
+function writeSceneVisualsFile(dir, sceneName, visuals) {
+    if (!/^[a-z0-9][a-z0-9._-]*$/i.test(sceneName))
+        throw new Error(`sceneVisuals: '${sceneName}' is not a scene folder name`);
+    const folder = (0, node_path_1.join)(dir, 'scene-visuals');
+    (0, node_fs_1.mkdirSync)(folder, { recursive: true });
+    const file = (0, node_path_1.join)(folder, `${sceneName}.json`);
+    (0, node_fs_1.writeFileSync)(file, JSON.stringify(visuals, null, 2));
+    return file;
+}
+//# sourceMappingURL=sceneVisuals.js.map

package/dist/city/assemble/sceneVisuals.js.map

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

package/dist/city/convert/command.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerCityConvert(city: Command, fail: (message: string) => never): void;

package/dist/city/convert/command.js

@@ -0,0 +1,98 @@
+"use strict";
+// `helix city convert cs2`: the one way to turn a Cities: Skylines II capture into a publish-ready World (docs/city-convert-cs2.md).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCityConvert = registerCityConvert;
+const node_path_1 = require("node:path");
+const lib_1 = require("../../lib");
+const config_1 = require("./config");
+const exec_1 = require("./exec");
+const optimizations_1 = require("./optimizations");
+const run_1 = require("./run");
+function parseTiers(value) {
+    const tiers = [...new Set(value.split(',').map((t) => t.trim()).filter(Boolean))];
+    if (!tiers.length || tiers.some((t) => t !== 'desktop' && t !== 'mobile'))
+        throw new Error('--tiers must be desktop, mobile or desktop,mobile');
+    return tiers;
+}
+function parsePair(value, flag) {
+    const parts = value.split(',').map(Number);
+    if (parts.length !== 2 || parts.some((n) => !Number.isFinite(n)))
+        throw new Error(`${flag} must be "x,z" in metres`);
+    return { x: parts[0], z: parts[1] };
+}
+function registerCityConvert(city, fail) {
+    const convert = city.command('convert').description('One-shot conversion of a captured city into a publish-ready World (docs/city-convert-cs2.md)');
+    convert
+        .command('cs2')
+        .description('A Cities: Skylines II source-v2 bundle to desktop and phone World roots with every shared optimization applied, collision completed, both tiers perf-gated, and a receipt that proves which ran')
+        .argument('[bundle]', 'the CS2 source-v2 bundle folder (terrain/, roads-v3/, placements/, meshes-v2/, areas/, water/, legacy/city/)')
+        .requiredOption('--name <slug>', 'World slug and scene root name (lowercase letters, digits, dashes)')
+        .option('--out <dir>', 'folder to write everything into (default ./convert-<name>)')
+        .option('--title <title>', 'the World title (default: the name, capitalised)')
+        .option('--description <text>', 'the World description')
+        .option('--config <file>', 'a helix.city-convert/1 file: spawn and the few knobs a map may need; every field has a default')
+        .option('--spawn <x,z>', 'open the World here (metres); default: a clear street-level point beside the densest downtown')
+        .option('--yaw <deg>', 'spawn heading in degrees (with --spawn); default along the street')
+        .option('--tiers <list>', 'desktop, mobile or desktop,mobile (default both)')
+        .option('--bounds <minX,minZ,maxX,maxZ>', 'convert only this window of the CS2 world, in scene metres')
+        .option('--masses', 'draw buildings as procedural masses even when the bundle has prefab meshes')
+        .option('--jobs <n>', 'parallel prototype shards (default 4)')
+        .option('--from <stage>', 'rerun this stage and everything after it')
+        .option('--stop-after <stage>', 'stop after this stage')
+        .option('--force', 'ignore the receipt and run every stage')
+        .option('--unlisted', 'the publish plan says unlisted (the default)')
+        .option('--public', 'the publish plan says public')
+        .option('--private', 'the publish plan says private')
+        .option('--list-stages', 'print the stages and the optimizations each applies, then exit')
+        .option('--json', 'print the receipt as JSON')
+        .action(async (bundle, opts) => {
+        try {
+            const overrides = {};
+            if (opts.title)
+                overrides.title = opts.title;
+            if (opts.description)
+                overrides.description = opts.description;
+            if (opts.tiers)
+                overrides.tiers = parseTiers(opts.tiers);
+            if (opts.spawn)
+                overrides.spawn = { ...parsePair(opts.spawn, '--spawn'), ...(opts.yaw !== undefined ? { yawDeg: Number(opts.yaw) } : {}) };
+            if (opts.bounds) {
+                const b = opts.bounds.split(',').map(Number);
+                if (b.length !== 4 || b.some((n) => !Number.isFinite(n)))
+                    throw new Error('--bounds must be "minX,minZ,maxX,maxZ"');
+                overrides.bounds = [b[0], b[1], b[2], b[3]];
+            }
+            const config = (0, config_1.resolveConvertConfig)(opts.name, opts.config ? (0, node_path_1.resolve)(opts.config) : undefined, overrides);
+            if (opts.masses)
+                config.buildings.meshes = 'masses';
+            const visibility = opts.public ? 'public' : opts.private ? 'private' : opts.unlisted ? 'unlisted' : undefined;
+            if (visibility)
+                config.publish.visibility = visibility;
+            if (opts.listStages) {
+                for (const stage of (0, run_1.listStages)(config))
+                    console.log(`${stage.id.padEnd(22)} ${stage.title}${stage.optimizations.length ? `\n${' '.repeat(23)}applies: ${stage.optimizations.join(', ')}` : ''}`);
+                console.log(`\n${optimizations_1.OPTIMIZATIONS.length} named optimizations; runtime (engine) fixes reach every World from the runtime range.`);
+                return;
+            }
+            if (!bundle)
+                throw new Error('give the bundle folder: helix city convert cs2 <bundle> --name <slug> --out <dir>');
+            const out = (0, node_path_1.resolve)(opts.out ?? `convert-${opts.name}`);
+            const receipt = await (0, run_1.runConvert)({
+                bundle: (0, node_path_1.resolve)(bundle), out, config, exec: (0, exec_1.childExec)({ out }), cliVersion: (0, lib_1.cliVersion)(), log: (line) => process.stderr.write(`${line}\n`),
+                ...(opts.jobs ? { jobs: Math.max(1, Number(opts.jobs)) } : {}), ...(opts.from ? { from: opts.from } : {}), ...(opts.stopAfter ? { stopAfter: opts.stopAfter } : {}), ...(opts.force ? { force: true } : {}),
+            });
+            if (opts.json) {
+                console.log(JSON.stringify(receipt, null, 2));
+                return;
+            }
+            console.log(`✔ ${config.title}: ${receipt.stages.length} stages, ${receipt.applied.length} optimizations applied -> ${out}`);
+            for (const stage of receipt.stages)
+                console.log(`  ${stage.id.padEnd(22)} ${(stage.ms / 1000).toFixed(1)} s`);
+            console.log(`  receipt: ${(0, node_path_1.resolve)(out, 'convert-receipt.json')}\n  publish plan: ${(0, node_path_1.resolve)(out, 'publish', 'publish.json')}`);
+        }
+        catch (error) {
+            fail(`✖ ${error instanceof Error ? error.message : String(error)}`);
+        }
+    });
+}
+//# sourceMappingURL=command.js.map

package/dist/city/convert/command.js.map

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

package/dist/city/convert/config.d.ts

@@ -0,0 +1,56 @@
+export declare const CONVERT_CONFIG_SCHEMA: "helix.city-convert/1";
+export type ConvertTier = 'desktop' | 'mobile';
+export interface ConvertSpawn {
+    x: number;
+    z: number;
+    /** Rotation about Y in degrees (0 faces -z). Omitted: along the street. */
+    yawDeg?: number;
+    /** Metres around the spawn kept free of trees. */
+    clearM?: number;
+}
+export interface ConvertConfig {
+    schema: typeof CONVERT_CONFIG_SCHEMA;
+    /** Scene root name and World slug base (`leonida` gives `leonida-c1` and `leonida-mobile-c1`). */
+    name: string;
+    title: string;
+    description?: string;
+    /** City id written into the city source (default `city.cs2-<name>`). */
+    cityId?: string;
+    /** Import only this window of the CS2 world, in scene metres. */
+    bounds?: [number, number, number, number];
+    /** Omitted: the stage `spawn` picks a clear street-level point near the densest downtown. */
+    spawn?: ConvertSpawn;
+    tiers: ConvertTier[];
+    terrain: {
+        /** 4 m is what the engine's stride ladder (4/8/16/32 m) is cut from. */
+        metresPerSample: 1 | 2 | 4;
+        /** Copernicus margin ring: real-world terrain, wrong for a fictional CS2 map, so off. */
+        marginM: number;
+        /** `natural`: a CS2 map only maps its lots, so unmapped land is grass and shore sand, not pavement. */
+        ground: 'natural' | 'urban';
+        /** CS2 height maps carry bogus land along the border that the coarse layer extrudes as a hard rectangle. */
+        demEdgeRepair: number;
+    };
+    vegetation: {
+        /** `source`: every tree the map has (the default 16,000 cap read as bare on a 292,028-tree map). */
+        maxTrees: 'source' | number;
+    };
+    buildings: {
+        /** `auto`: real prefab meshes when the bundle has them, else procedural masses. */
+        meshes: 'auto' | 'real' | 'masses';
+        /** Prototype builds run as this many parallel processes per tier. */
+        shards: number;
+    };
+    colliders: {
+        /** Building boxes inline in the root document (a document near its memory cap cannot afford the mount). */
+        inline: boolean;
+    };
+    publish: {
+        visibility: 'private' | 'unlisted' | 'public';
+        world: string | null;
+    };
+}
+export declare function defaultConvertConfig(name: string): ConvertConfig;
+export declare function validateConvertConfig(config: ConvertConfig, where?: string): ConvertConfig;
+/** Defaults, then the file on top (one level of merge per group), then validation. */
+export declare function resolveConvertConfig(name: string, file?: string, overrides?: Partial<Pick<ConvertConfig, 'title' | 'description' | 'cityId' | 'bounds' | 'spawn' | 'tiers'>>): ConvertConfig;

package/dist/city/convert/config.js

@@ -0,0 +1,78 @@
+"use strict";
+// `helix.city-convert/1`: the one small file a CS2 conversion reads for what only a person knows (a name, optionally a spawn).
+// Everything else has a default that every converted map gets, so two maps converted with the same CLI differ only in what the
+// map itself says. A field here is never a place to hand-apply an optimisation: those are stages (`stages.ts`).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONVERT_CONFIG_SCHEMA = void 0;
+exports.defaultConvertConfig = defaultConvertConfig;
+exports.validateConvertConfig = validateConvertConfig;
+exports.resolveConvertConfig = resolveConvertConfig;
+const node_fs_1 = require("node:fs");
+exports.CONVERT_CONFIG_SCHEMA = 'helix.city-convert/1';
+function defaultConvertConfig(name) {
+    const title = name.replace(/[-_]+/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase());
+    return {
+        schema: exports.CONVERT_CONFIG_SCHEMA,
+        name,
+        title,
+        tiers: ['desktop', 'mobile'],
+        terrain: { metresPerSample: 4, marginM: 0, ground: 'natural', demEdgeRepair: 5 },
+        vegetation: { maxTrees: 'source' },
+        buildings: { meshes: 'auto', shards: 8 },
+        colliders: { inline: true },
+        publish: { visibility: 'unlisted', world: null },
+    };
+}
+const SLUG = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function validateConvertConfig(config, where = 'convert config') {
+    if (config.schema !== exports.CONVERT_CONFIG_SCHEMA)
+        throw new Error(`${where}: schema must be ${exports.CONVERT_CONFIG_SCHEMA}`);
+    if (!SLUG.test(config.name))
+        throw new Error(`${where}: name must be a lowercase slug (letters, digits, dashes), got '${config.name}'`);
+    if (!config.tiers.length || config.tiers.some((t) => t !== 'desktop' && t !== 'mobile'))
+        throw new Error(`${where}: tiers must list desktop and/or mobile`);
+    if (config.bounds && (config.bounds.length !== 4 || config.bounds.some((n) => !Number.isFinite(n))))
+        throw new Error(`${where}: bounds must be [minX, minZ, maxX, maxZ] in metres`);
+    if (config.spawn && !(Number.isFinite(config.spawn.x) && Number.isFinite(config.spawn.z)))
+        throw new Error(`${where}: spawn needs numeric x and z`);
+    if (![1, 2, 4].includes(config.terrain.metresPerSample))
+        throw new Error(`${where}: terrain.metresPerSample must be 1, 2 or 4`);
+    if (!Number.isInteger(config.terrain.demEdgeRepair) || config.terrain.demEdgeRepair < 0 || config.terrain.demEdgeRepair > 16)
+        throw new Error(`${where}: terrain.demEdgeRepair must be an integer from 0 to 16`);
+    if (config.terrain.ground !== 'natural' && config.terrain.ground !== 'urban')
+        throw new Error(`${where}: terrain.ground must be natural or urban`);
+    if (config.vegetation.maxTrees !== 'source' && !(Number.isInteger(config.vegetation.maxTrees) && config.vegetation.maxTrees >= 0))
+        throw new Error(`${where}: vegetation.maxTrees must be 'source' or a count`);
+    if (!['auto', 'real', 'masses'].includes(config.buildings.meshes))
+        throw new Error(`${where}: buildings.meshes must be auto, real or masses`);
+    if (!Number.isInteger(config.buildings.shards) || config.buildings.shards < 1 || config.buildings.shards > 32)
+        throw new Error(`${where}: buildings.shards must be 1 to 32`);
+    if (!['private', 'unlisted', 'public'].includes(config.publish.visibility))
+        throw new Error(`${where}: publish.visibility must be private, unlisted or public`);
+    return config;
+}
+/** Defaults, then the file on top (one level of merge per group), then validation. */
+function resolveConvertConfig(name, file, overrides = {}) {
+    const base = defaultConvertConfig(name);
+    let given = {};
+    if (file) {
+        if (!(0, node_fs_1.existsSync)(file))
+            throw new Error(`convert config ${file} does not exist`);
+        given = JSON.parse((0, node_fs_1.readFileSync)(file, 'utf8'));
+    }
+    const merged = {
+        ...base, ...given,
+        terrain: { ...base.terrain, ...given.terrain },
+        vegetation: { ...base.vegetation, ...given.vegetation },
+        buildings: { ...base.buildings, ...given.buildings },
+        colliders: { ...base.colliders, ...given.colliders },
+        publish: { ...base.publish, ...given.publish },
+    };
+    if (given.name === undefined)
+        merged.name = name;
+    for (const [key, value] of Object.entries(overrides))
+        if (value !== undefined)
+            merged[key] = value;
+    return validateConvertConfig(merged, file ?? 'convert config');
+}
+//# sourceMappingURL=config.js.map

package/dist/city/convert/config.js.map

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

package/dist/city/convert/exec.d.ts

@@ -0,0 +1,5 @@
+import type { Exec } from './stages';
+export declare function childExec(options: {
+    out: string;
+    entry?: string;
+}): Exec;

package/dist/city/convert/exec.js

@@ -0,0 +1,36 @@
+"use strict";
+// Runs `helix <args>` as a child process of this very CLI (same node, same entry), with the output in a log file per step. A child
+// per heavy step keeps each step's memory separate (the landscape of a 14 km map wants a 14 GiB heap, a validate does not).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.childExec = childExec;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const TAIL_BYTES = 6000;
+function tailOf(file) {
+    try {
+        const size = (0, node_fs_1.statSync)(file).size;
+        const text = (0, node_fs_1.readFileSync)(file, 'utf8');
+        return size > TAIL_BYTES ? text.slice(-TAIL_BYTES) : text;
+    }
+    catch {
+        return '';
+    }
+}
+function childExec(options) {
+    const entry = options.entry ?? process.argv[1];
+    const logs = (0, node_path_1.join)(options.out, 'logs');
+    (0, node_fs_1.mkdirSync)(logs, { recursive: true });
+    return (args, { id, memMiB }) => new Promise((resolve) => {
+        const log = (0, node_path_1.join)(logs, `${id}.log`);
+        const fd = (0, node_fs_1.openSync)(log, 'w');
+        const child = (0, node_child_process_1.spawn)(process.execPath, [...(memMiB ? [`--max-old-space-size=${memMiB}`] : []), entry, ...args], { stdio: ['ignore', fd, fd], env: process.env });
+        const done = (code) => { try {
+            (0, node_fs_1.closeSync)(fd);
+        }
+        catch { /* already closed */ } resolve({ code, tail: tailOf(log) }); };
+        child.on('error', () => done(127));
+        child.on('close', (code) => done(code ?? 1));
+    });
+}
+//# sourceMappingURL=exec.js.map

package/dist/city/convert/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../../src/city/convert/exec.ts"],"names":[],"mappings":";AAAA,mIAAmI;AACnI,4HAA4H;;AAiB5H,8BAYC;AA3BD,2DAA2C;AAC3C,qCAAiF;AACjF,yCAAiC;AAGjC,MAAM,UAAU,GAAG,IAAI,CAAC;AAExB,SAAS,MAAM,CAAC,IAAY;IAC1B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAA,kBAAQ,EAAC,IAAI,CAAC,CAAC,IAAI,CAAC;QACjC,MAAM,IAAI,GAAG,IAAA,sBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;AACxB,CAAC;AAED,SAAgB,SAAS,CAAC,OAAwC;IAChE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAA,gBAAI,EAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACvC,IAAA,mBAAS,EAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,EAAE;QACnE,MAAM,GAAG,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QACpC,MAAM,EAAE,GAAG,IAAA,kBAAQ,EAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAA,0BAAK,EAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAChK,MAAM,IAAI,GAAG,CAAC,IAAY,EAAQ,EAAE,GAAG,IAAI,CAAC;YAAC,IAAA,mBAAS,EAAC,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACrI,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACnC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/city/convert/landscapeSource.d.ts

@@ -0,0 +1,6 @@
+export interface LandscapeSourceResult {
+    dir: string;
+    buildingsRemoved: number;
+    manifestSha256: string;
+}
+export declare function deriveLandscapeSource(sourceDir: string, outDir: string): Promise<LandscapeSourceResult>;

package/dist/city/convert/landscapeSource.js

@@ -0,0 +1,19 @@
+"use strict";
+// A landscape-only copy of a city source: same frame, roads, areas, trees and terrain, no buildings. `scene create city` builds the
+// landscape root from it and the real-mesh building parts are mounted on top (docs/cs2-mesh-buildings.md). Until now this was a
+// hand script per map (Leonida's `masses.py`); it is a stage so every CS2 map gets the same landscape.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveLandscapeSource = deriveLandscapeSource;
+const source_1 = require("../source");
+async function deriveLandscapeSource(sourceDir, outDir) {
+    const source = await (0, source_1.readCitySource)(sourceDir);
+    const { manifest, ...layers } = source;
+    const draft = {
+        ...layers,
+        manifest: { ...manifest, provenance: [...manifest.provenance, { source: 'helix-city-convert', note: 'landscape-only: buildings removed, real-mesh parts are mounted on this root' }] },
+        buildings: [],
+    };
+    const written = await (0, source_1.writeCitySource)(outDir, draft);
+    return { dir: written.dir, buildingsRemoved: source.buildings?.length ?? 0, manifestSha256: written.manifestSha256 };
+}
+//# sourceMappingURL=landscapeSource.js.map

package/dist/city/convert/landscapeSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"landscapeSource.js","sourceRoot":"","sources":["../../../src/city/convert/landscapeSource.ts"],"names":[],"mappings":";AAAA,oIAAoI;AACpI,gIAAgI;AAChI,uGAAuG;;AAMvG,sDAUC;AAdD,sCAAkF;AAI3E,KAAK,UAAU,qBAAqB,CAAC,SAAiB,EAAE,MAAc;IAC3E,MAAM,MAAM,GAAG,MAAM,IAAA,uBAAc,EAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;IACvC,MAAM,KAAK,GAAoB;QAC7B,GAAG,MAAM;QACT,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,CAAC,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,IAAI,EAAE,6EAA6E,EAAE,CAAC,EAAE;QACtL,SAAS,EAAE,EAAE;KACd,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,IAAA,wBAAe,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrD,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC;AACvH,CAAC"}

package/dist/city/convert/optimizations.d.ts

@@ -0,0 +1,8 @@
+export interface Optimization {
+    id: string;
+    title: string;
+    ref: string;
+    stage: string;
+}
+export declare const OPTIMIZATIONS: readonly Optimization[];
+export declare const optimizationById: (id: string) => Optimization;