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

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;

package/dist/city/convert/optimizations.js

@@ -0,0 +1,41 @@
+"use strict";
+// Every improvement a converted CS2 map receives after the raw import, named once. A stage claims the ids it applies and the
+// run receipt lists the ones a run actually applied, so "does this map have the Granit fixes" is a lookup, not an investigation.
+// `ref` is the PR or doc that introduced it. Runtime fixes (ENGINE) are not here: every World gets them from the runtime range.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.optimizationById = exports.OPTIMIZATIONS = void 0;
+exports.OPTIMIZATIONS = [
+    { id: 'import.repeated-points', title: 'Consecutive repeated centreline points dropped', ref: 'creator-cli #482', stage: 'import' },
+    { id: 'import.scanner-chunk', title: 'Road scanner keeps a value that opens on a read-chunk boundary', ref: 'creator-cli #481', stage: 'import' },
+    { id: 'import.sea-from-water-field', title: 'Sea level taken from the water field when water.json cannot reach the terrain', ref: 'creator-cli #483', stage: 'import' },
+    { id: 'spawn.clear-street', title: 'Spawn auto-picked on a clear, dry, street-level street beside the densest downtown, facing along it', ref: 'cs2-pipeline-unify', stage: 'spawn' },
+    { id: 'spawn.exact-and-tree-clearing', title: 'Exact spawn and yaw, trees cleared around it', ref: 'creator-cli #488', stage: 'landscape' },
+    { id: 'landscape.landscape-only-source', title: 'Landscape-only source so real-mesh building parts can be mounted', ref: 'creator-cli #485', stage: 'land-source' },
+    { id: 'terrain.natural-ground', title: 'Unmapped land off the streets is grass and shore sand, not pavement', ref: 'creator-cli #486', stage: 'landscape' },
+    { id: 'terrain.dem-edge-repair', title: 'Bogus border land of the CS2 height map repaired', ref: 'creator-cli #488', stage: 'landscape' },
+    { id: 'terrain.conform-under-roads', title: 'Terrain cut and filled under the roads, banks and crisp ground classes', ref: 'creator-cli #423 #426 #427 #439 #488', stage: 'landscape' },
+    { id: 'terrain.no-copernicus-margin', title: 'No real-world Copernicus margin ring around a fictional map', ref: 'cs2-pipeline-unify', stage: 'landscape' },
+    { id: 'sea.water-volume', title: 'Open sea emitted as a water volume from the water layer', ref: 'creator-cli #484', stage: 'landscape' },
+    { id: 'vegetation.all-source-trees', title: 'Every tree of the map kept (cap raised to the source count), street trees, distant impostors', ref: 'creator-cli #439 #458 #486', stage: 'landscape' },
+    { id: 'props.street-kit', title: 'Street-furniture kit and street life placed from the Vault', ref: 'creator-cli #428 #433 #439', stage: 'landscape' },
+    { id: 'roads.generated', title: 'Roads: junctions, ramps with gores, deck profile, portals, turn arrows, legible markings, city materials', ref: 'creator-cli #423 #426 #427', stage: 'landscape' },
+    { id: 'buildings.real-prefab-meshes', title: 'Real CS2 prefab meshes as shared prototypes in building part Scenes under one World root', ref: 'creator-cli #485', stage: 'prototypes' },
+    { id: 'buildings.material-fixes', title: 'Prototype materials: normals decoded, ORM, control-mask recolour, window alpha over glass, wide prefabs cut in tiles', ref: 'creator-cli #485 #486 #431', stage: 'prototypes' },
+    { id: 'tier.phone-profile', title: 'Phone data profile: small prototypes, small groups, 20-draw groups, 128 px HLOD tiles in 1,024 m cells', ref: 'creator-cli #486 / tier profiles', stage: 'prototypes' },
+    { id: 'parts.stream-groups', title: 'Building parts cut into stream groups by median cut under the memory, side, triangle and draw caps', ref: 'creator-cli #485 #486', stage: 'parts' },
+    { id: 'hlod.complete-bake', title: 'Complete HLOD over every part: the whole skyline is always drawn', ref: 'creator-cli #477 #485', stage: 'bake' },
+    { id: 'compose.tier-roots', title: 'Per-tier World root mounting the baked parts (desktop 128 m near, phone 48 m near / 384 m stream)', ref: 'creator-cli #485', stage: 'compose' },
+    { id: 'colliders.decks', title: 'Collider cells for elevated decks, ramps and rails', ref: 'creator-cli #478', stage: 'colliders' },
+    { id: 'colliders.building-boxes', title: 'One collision box per building, inline in the root', ref: 'creator-cli #478 #488', stage: 'colliders' },
+    { id: 'colliders.lips', title: 'Kerb and deck-seam lips bevelled so wheels roll up', ref: 'creator-cli #487', stage: 'colliders' },
+    { id: 'perf.gate-both-tiers', title: 'scene validate --perf on the final desktop and phone roots; a refusal fails the run', ref: 'creator-cli #419', stage: 'validate' },
+    { id: 'publish.layout', title: 'Publish tree laid out (scene/<root>/ plus part folders) and a publish plan with the exact shell command', ref: 'cs2-pipeline-unify', stage: 'finish' },
+];
+const optimizationById = (id) => {
+    const found = exports.OPTIMIZATIONS.find((o) => o.id === id);
+    if (!found)
+        throw new Error(`unknown optimization '${id}'`);
+    return found;
+};
+exports.optimizationById = optimizationById;
+//# sourceMappingURL=optimizations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optimizations.js","sourceRoot":"","sources":["../../../src/city/convert/optimizations.ts"],"names":[],"mappings":";AAAA,6HAA6H;AAC7H,iIAAiI;AACjI,gIAAgI;;;AAInH,QAAA,aAAa,GAA4B;IACpD,EAAE,EAAE,EAAE,wBAAwB,EAAE,KAAK,EAAE,gDAAgD,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,QAAQ,EAAE;IACnI,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,gEAAgE,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,QAAQ,EAAE;IACjJ,EAAE,EAAE,EAAE,6BAA6B,EAAE,KAAK,EAAE,+EAA+E,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,QAAQ,EAAE;IACvK,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,qGAAqG,EAAE,GAAG,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,EAAE;IACrL,EAAE,EAAE,EAAE,+BAA+B,EAAE,KAAK,EAAE,8CAA8C,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,EAAE;IAC3I,EAAE,EAAE,EAAE,iCAAiC,EAAE,KAAK,EAAE,kEAAkE,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,aAAa,EAAE;IACnK,EAAE,EAAE,EAAE,wBAAwB,EAAE,KAAK,EAAE,qEAAqE,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,EAAE;IAC3J,EAAE,EAAE,EAAE,yBAAyB,EAAE,KAAK,EAAE,kDAAkD,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,EAAE;IACzI,EAAE,EAAE,EAAE,6BAA6B,EAAE,KAAK,EAAE,wEAAwE,EAAE,GAAG,EAAE,sCAAsC,EAAE,KAAK,EAAE,WAAW,EAAE;IACvL,EAAE,EAAE,EAAE,8BAA8B,EAAE,KAAK,EAAE,6DAA6D,EAAE,GAAG,EAAE,oBAAoB,EAAE,KAAK,EAAE,WAAW,EAAE;IAC3J,EAAE,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,yDAAyD,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,EAAE;IACzI,EAAE,EAAE,EAAE,6BAA6B,EAAE,KAAK,EAAE,8FAA8F,EAAE,GAAG,EAAE,4BAA4B,EAAE,KAAK,EAAE,WAAW,EAAE;IACnM,EAAE,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,4DAA4D,EAAE,GAAG,EAAE,4BAA4B,EAAE,KAAK,EAAE,WAAW,EAAE;IACtJ,EAAE,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,0GAA0G,EAAE,GAAG,EAAE,4BAA4B,EAAE,KAAK,EAAE,WAAW,EAAE;IACnM,EAAE,EAAE,EAAE,8BAA8B,EAAE,KAAK,EAAE,0FAA0F,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,YAAY,EAAE;IACvL,EAAE,EAAE,EAAE,0BAA0B,EAAE,KAAK,EAAE,sHAAsH,EAAE,GAAG,EAAE,4BAA4B,EAAE,KAAK,EAAE,YAAY,EAAE;IACzN,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,wGAAwG,EAAE,GAAG,EAAE,kCAAkC,EAAE,KAAK,EAAE,YAAY,EAAE;IAC3M,EAAE,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,oGAAoG,EAAE,GAAG,EAAE,uBAAuB,EAAE,KAAK,EAAE,OAAO,EAAE;IACxL,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,kEAAkE,EAAE,GAAG,EAAE,uBAAuB,EAAE,KAAK,EAAE,MAAM,EAAE;IACpJ,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,mGAAmG,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,SAAS,EAAE;IACnL,EAAE,EAAE,EAAE,iBAAiB,EAAE,KAAK,EAAE,oDAAoD,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,EAAE;IACnI,EAAE,EAAE,EAAE,0BAA0B,EAAE,KAAK,EAAE,oDAAoD,EAAE,GAAG,EAAE,uBAAuB,EAAE,KAAK,EAAE,WAAW,EAAE;IACjJ,EAAE,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,oDAAoD,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,EAAE;IAClI,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,qFAAqF,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,UAAU,EAAE;IACxK,EAAE,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,yGAAyG,EAAE,GAAG,EAAE,oBAAoB,EAAE,KAAK,EAAE,QAAQ,EAAE;CACvL,CAAC;AAEK,MAAM,gBAAgB,GAAG,CAAC,EAAU,EAAgB,EAAE;IAC3D,MAAM,KAAK,GAAG,qBAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;IAC5D,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAJW,QAAA,gBAAgB,oBAI3B"}

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

@@ -0,0 +1,44 @@
+export declare const CONVERT_RECEIPT_SCHEMA: "helix.city-convert-receipt/1";
+export declare const RECEIPT_FILE = "convert-receipt.json";
+export interface StageReceipt {
+    id: string;
+    title: string;
+    status: 'ok' | 'failed';
+    signature: string;
+    startedAt: string;
+    ms: number;
+    commands: string[][];
+    outputs: Record<string, string>;
+    optimizations: string[];
+    facts?: Record<string, unknown>;
+    log?: string;
+    error?: string;
+}
+export interface ConvertReceipt {
+    schema: typeof CONVERT_RECEIPT_SCHEMA;
+    cliVersion: string;
+    bundle: string;
+    out: string;
+    config: unknown;
+    stages: StageReceipt[];
+    /** Optimizations applied by the stages that finished ok. */
+    applied: Array<{
+        id: string;
+        title: string;
+        ref: string;
+        stage: string;
+    }>;
+    outcome: 'running' | 'ok' | 'failed';
+}
+export declare const sha256Json: (value: unknown) => string;
+export declare function newReceipt(init: {
+    cliVersion: string;
+    bundle: string;
+    out: string;
+    config: unknown;
+}): ConvertReceipt;
+export declare function readReceipt(out: string): ConvertReceipt | null;
+export declare function recordStage(receipt: ConvertReceipt, stage: StageReceipt): void;
+/** The optimizations named by the stages that finished ok, in first-applied order. */
+export declare function refreshApplied(receipt: ConvertReceipt): void;
+export declare function writeReceipt(out: string, receipt: ConvertReceipt): void;

package/dist/city/convert/receipt.js

@@ -0,0 +1,60 @@
+"use strict";
+// The conversion receipt: which stages ran, with what, how long, and which named optimizations each applied. Written after every
+// stage, so an interrupted run resumes from it and a finished run proves what it did.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sha256Json = exports.RECEIPT_FILE = exports.CONVERT_RECEIPT_SCHEMA = void 0;
+exports.newReceipt = newReceipt;
+exports.readReceipt = readReceipt;
+exports.recordStage = recordStage;
+exports.refreshApplied = refreshApplied;
+exports.writeReceipt = writeReceipt;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const optimizations_1 = require("./optimizations");
+exports.CONVERT_RECEIPT_SCHEMA = 'helix.city-convert-receipt/1';
+exports.RECEIPT_FILE = 'convert-receipt.json';
+const sha256Json = (value) => (0, node_crypto_1.createHash)('sha256').update(JSON.stringify(value)).digest('hex');
+exports.sha256Json = sha256Json;
+function newReceipt(init) {
+    return { schema: exports.CONVERT_RECEIPT_SCHEMA, ...init, stages: [], applied: [], outcome: 'running' };
+}
+function readReceipt(out) {
+    const file = (0, node_path_1.join)(out, exports.RECEIPT_FILE);
+    if (!(0, node_fs_1.existsSync)(file))
+        return null;
+    const receipt = JSON.parse((0, node_fs_1.readFileSync)(file, 'utf8'));
+    return receipt.schema === exports.CONVERT_RECEIPT_SCHEMA ? receipt : null;
+}
+function recordStage(receipt, stage) {
+    const at = receipt.stages.findIndex((s) => s.id === stage.id);
+    if (at >= 0)
+        receipt.stages[at] = stage;
+    else
+        receipt.stages.push(stage);
+    refreshApplied(receipt);
+}
+/** The optimizations named by the stages that finished ok, in first-applied order. */
+function refreshApplied(receipt) {
+    const seen = new Set();
+    receipt.applied = [];
+    for (const s of receipt.stages) {
+        if (s.status !== 'ok')
+            continue;
+        for (const id of s.optimizations) {
+            if (seen.has(id))
+                continue;
+            seen.add(id);
+            const { title, ref, stage: owner } = (0, optimizations_1.optimizationById)(id);
+            receipt.applied.push({ id, title, ref, stage: owner });
+        }
+    }
+}
+function writeReceipt(out, receipt) {
+    const file = (0, node_path_1.join)(out, exports.RECEIPT_FILE);
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(file), { recursive: true });
+    const tmp = `${file}.tmp`;
+    (0, node_fs_1.writeFileSync)(tmp, `${JSON.stringify(receipt, null, 2)}\n`);
+    (0, node_fs_1.renameSync)(tmp, file);
+}
+//# sourceMappingURL=receipt.js.map

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

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

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

@@ -0,0 +1,20 @@
+import type { ConvertConfig } from './config';
+import { type ConvertReceipt } from './receipt';
+import { type Exec, type Facts, type StageDef } from './stages';
+export interface RunOptions {
+    bundle: string;
+    out: string;
+    config: ConvertConfig;
+    exec: Exec;
+    cliVersion: string;
+    log?: (line: string) => void;
+    jobs?: number;
+    /** Rerun this stage and everything after it. */
+    from?: string;
+    /** Stop after this stage (it still counts as run). */
+    stopAfter?: string;
+    /** Ignore the receipt; run every stage. */
+    force?: boolean;
+}
+export declare function listStages(config: ConvertConfig, meshMode?: Facts['meshMode'] | 'unknown'): StageDef[];
+export declare function runConvert(options: RunOptions): Promise<ConvertReceipt>;

package/dist/city/convert/run.js

@@ -0,0 +1,82 @@
+"use strict";
+// The conversion runner: stages in dependency order, a receipt after each, resume from the receipt, stop on the first failure.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listStages = listStages;
+exports.runConvert = runConvert;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const receipt_1 = require("./receipt");
+const stages_1 = require("./stages");
+function listStages(config, meshMode = 'unknown') {
+    return (0, stages_1.buildStages)(config, meshMode);
+}
+async function runConvert(options) {
+    const { config, out } = options;
+    const log = options.log ?? (() => undefined);
+    (0, node_fs_1.mkdirSync)(out, { recursive: true });
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(out, 'convert.json'), `${JSON.stringify(config, null, 2)}\n`);
+    const paths = (0, stages_1.convertPaths)(options.bundle, out, config.name);
+    const ctx = { config, paths, exec: options.exec, log, jobs: options.jobs ?? 4 };
+    const prior = options.force ? null : (0, receipt_1.readReceipt)(out);
+    const receipt = (0, receipt_1.newReceipt)({ cliVersion: options.cliVersion, bundle: options.bundle, out, config });
+    if (prior && prior.bundle === options.bundle) {
+        receipt.stages = prior.stages.filter((s) => s.status === 'ok');
+        (0, receipt_1.refreshApplied)(receipt);
+    }
+    let meshMode = 'unknown';
+    let stages = (0, stages_1.buildStages)(config, meshMode);
+    if (options.from && !stages.some((s) => s.id === options.from))
+        throw new Error(`--from ${options.from}: no such stage (${stages.map((s) => s.id).join(', ')})`);
+    if (options.stopAfter && !stages.some((s) => s.id === options.stopAfter))
+        throw new Error(`--stop-after ${options.stopAfter}: no such stage (${stages.map((s) => s.id).join(', ')})`);
+    let chain = (0, receipt_1.sha256Json)({ bundle: options.bundle, cli: options.cliVersion });
+    let rerun = Boolean(options.force);
+    for (let index = 0; index < stages.length; index += 1) {
+        const stage = stages[index];
+        if (stage.id === options.from)
+            rerun = true;
+        const signature = (0, receipt_1.sha256Json)({ chain, id: stage.id, own: stage.signature(ctx) });
+        chain = signature;
+        const done = receipt.stages.find((s) => s.id === stage.id);
+        const upToDate = !rerun && done !== undefined && done.signature === signature && stage.outputs(ctx).every((p) => (0, node_fs_1.existsSync)(p));
+        if (upToDate) {
+            log(`${stage.id}: up to date`);
+        }
+        else {
+            rerun = true;
+            log(`${stage.id}: ${stage.title}`);
+            const startedAt = new Date().toISOString();
+            const t0 = performance.now();
+            try {
+                const result = await stage.run(ctx);
+                (0, receipt_1.recordStage)(receipt, {
+                    id: stage.id, title: stage.title, status: 'ok', signature, startedAt, ms: Math.round(performance.now() - t0), commands: result.commands,
+                    outputs: result.outputs ?? {}, optimizations: stage.optimizations, ...(result.facts ? { facts: result.facts } : {}), log: (0, node_path_1.join)(out, 'logs'),
+                });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                (0, receipt_1.recordStage)(receipt, {
+                    id: stage.id, title: stage.title, status: 'failed', signature, startedAt, ms: Math.round(performance.now() - t0), commands: [], outputs: {}, optimizations: [], error: message, log: (0, node_path_1.join)(out, 'logs'),
+                });
+                receipt.outcome = 'failed';
+                (0, receipt_1.writeReceipt)(out, receipt);
+                throw new Error(`stage ${stage.id} failed: ${message}`);
+            }
+            (0, receipt_1.writeReceipt)(out, receipt);
+        }
+        if (stage.id === 'facts') {
+            meshMode = (0, stages_1.loadFacts)(paths).meshMode;
+            const next = (0, stages_1.buildStages)(config, meshMode);
+            stages = next;
+        }
+        if (stage.id === options.stopAfter) {
+            (0, receipt_1.writeReceipt)(out, receipt);
+            return receipt;
+        }
+    }
+    receipt.outcome = 'ok';
+    (0, receipt_1.writeReceipt)(out, receipt);
+    return receipt;
+}
+//# sourceMappingURL=run.js.map