@hypersoniclabs/helix-cli 0.1.25-helix3.476 → 0.1.25-helix3.478

package/dist/city/source/canonical.d.ts

@@ -0,0 +1,21 @@
+export declare function sha256Hex(bytes: Uint8Array | string): string;
+/** Round to 1 mm. Idempotent: rounding an already rounded value returns it unchanged. */
+export declare function roundMm(value: number): number;
+export interface CanonicalOptions {
+    /** Round every number to 1 mm. Rows yes; manifest no (a longitude needs more digits). */
+    quantise?: boolean;
+}
+/** Compact canonical JSON of any JSON-shaped value. */
+export declare function canonicalJson(value: unknown, options?: CanonicalOptions): string;
+/** Human-readable canonical JSON for small documents (manifest, dem.json, overrides). */
+export declare function prettyCanonicalJson(value: unknown): string;
+/** A document of row arrays, one row per line: roads.json and areas.json. A non-array section is written inline. */
+export declare function rowsDocument(sections: Array<[name: string, rows: unknown[] | Record<string, unknown> | undefined]>): string;
+export declare function ndjsonDocument(rows: unknown[]): string;
+export declare function sortById<T extends {
+    id: string;
+}>(rows: readonly T[]): T[];
+/** gzip with a fixed header (no mtime, OS = unix), so the same bytes in give the same bytes out on every machine zlib agrees on. */
+export declare function gzipStable(bytes: Uint8Array): Buffer;
+export declare function gunzipBytes(bytes: Uint8Array): Buffer;
+export declare function isGzipUri(uri: string): boolean;

package/dist/city/source/canonical.js

@@ -0,0 +1,140 @@
+"use strict";
+// Canonical serialisation: the single place that decides which bytes a city-source layer is. Two sources with the same
+// content produce the same bytes, so a layer's sha256 is its identity and a re-import of unchanged data is a no-op.
+//
+// Rules (docs/city-source.md "Canonical form"): UTF-8, LF, no BOM, a trailing newline; object keys in code-unit order with
+// `schema` and `id` first; undefined fields omitted; numbers in layer rows rounded to 1 mm; -0 written as 0; non-finite
+// numbers refused; rows sorted by id; one row per line in NDJSON and in the row arrays of roads.json / areas.json.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sha256Hex = sha256Hex;
+exports.roundMm = roundMm;
+exports.canonicalJson = canonicalJson;
+exports.prettyCanonicalJson = prettyCanonicalJson;
+exports.rowsDocument = rowsDocument;
+exports.ndjsonDocument = ndjsonDocument;
+exports.sortById = sortById;
+exports.gzipStable = gzipStable;
+exports.gunzipBytes = gunzipBytes;
+exports.isGzipUri = isGzipUri;
+const node_crypto_1 = require("node:crypto");
+const node_zlib_1 = require("node:zlib");
+const types_1 = require("./types");
+function sha256Hex(bytes) {
+    return (0, node_crypto_1.createHash)('sha256').update(bytes).digest('hex');
+}
+/** Round to 1 mm. Idempotent: rounding an already rounded value returns it unchanged. */
+function roundMm(value) {
+    if (!Number.isFinite(value))
+        throw new Error(`city-source: cannot write a non-finite number (${value})`);
+    const rounded = Number(value.toFixed(types_1.CITY_SOURCE_DECIMALS));
+    return rounded === 0 ? 0 : rounded;
+}
+function compareKeys(a, b) {
+    const rank = (key) => (key === 'schema' ? 0 : key === 'id' ? 1 : 2);
+    const ra = rank(a);
+    const rb = rank(b);
+    if (ra !== rb)
+        return ra - rb;
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/** Compact canonical JSON of any JSON-shaped value. */
+function canonicalJson(value, options = {}) {
+    const quantise = options.quantise === true;
+    const walk = (v, path) => {
+        if (v === null)
+            return 'null';
+        switch (typeof v) {
+            case 'number':
+                if (!Number.isFinite(v))
+                    throw new Error(`city-source: non-finite number at ${path}`);
+                return String(quantise ? roundMm(v) : v === 0 ? 0 : v);
+            case 'string':
+                return JSON.stringify(v);
+            case 'boolean':
+                return v ? 'true' : 'false';
+            case 'object': {
+                if (Array.isArray(v)) {
+                    let out = '[';
+                    for (let i = 0; i < v.length; i += 1)
+                        out += (i === 0 ? '' : ',') + (v[i] === undefined ? 'null' : walk(v[i], `${path}[${i}]`));
+                    return `${out}]`;
+                }
+                const record = v;
+                const keys = Object.keys(record).filter((key) => record[key] !== undefined).sort(compareKeys);
+                let out = '{';
+                for (let i = 0; i < keys.length; i += 1)
+                    out += `${i === 0 ? '' : ','}${JSON.stringify(keys[i])}:${walk(record[keys[i]], `${path}.${keys[i]}`)}`;
+                return `${out}}`;
+            }
+            default:
+                throw new Error(`city-source: cannot serialise ${typeof v} at ${path}`);
+        }
+    };
+    return walk(value, '$');
+}
+function isFlat(value) {
+    if (value === null || typeof value !== 'object')
+        return true;
+    return Array.isArray(value) && value.every((item) => item === null || typeof item !== 'object' || (Array.isArray(item) && item.every((leaf) => leaf === null || typeof leaf !== 'object')));
+}
+function inlineArray(value) {
+    return `[${value.map((item) => (Array.isArray(item) ? inlineArray(item) : canonicalJson(item, {}))).join(', ')}]`;
+}
+/** Human-readable canonical JSON for small documents (manifest, dem.json, overrides). */
+function prettyCanonicalJson(value) {
+    const walk = (v, depth, path) => {
+        if (v === null || typeof v !== 'object')
+            return canonicalJson(v, {});
+        const pad = '  '.repeat(depth + 1);
+        const close = '  '.repeat(depth);
+        if (Array.isArray(v)) {
+            if (v.length === 0)
+                return '[]';
+            if (isFlat(v))
+                return inlineArray(v);
+            return `[\n${v.map((item, i) => pad + walk(item, depth + 1, `${path}[${i}]`)).join(',\n')}\n${close}]`;
+        }
+        const record = v;
+        const keys = Object.keys(record).filter((key) => record[key] !== undefined).sort(compareKeys);
+        if (keys.length === 0)
+            return '{}';
+        return `{\n${keys.map((key) => `${pad}${JSON.stringify(key)}: ${walk(record[key], depth + 1, `${path}.${key}`)}`).join(',\n')}\n${close}}`;
+    };
+    return `${walk(value, 0, '$')}\n`;
+}
+/** A document of row arrays, one row per line: roads.json and areas.json. A non-array section is written inline. */
+function rowsDocument(sections) {
+    const parts = [];
+    for (const [name, rows] of sections) {
+        if (rows === undefined)
+            continue;
+        if (Array.isArray(rows)) {
+            parts.push(rows.length === 0 ? `"${name}": []` : `"${name}": [\n${rows.map((row) => canonicalJson(row, { quantise: true })).join(',\n')}\n]`);
+        }
+        else {
+            parts.push(`"${name}": ${canonicalJson(rows, { quantise: true })}`);
+        }
+    }
+    return `{\n${parts.join(',\n')}\n}\n`;
+}
+function ndjsonDocument(rows) {
+    return rows.map((row) => `${canonicalJson(row, { quantise: true })}\n`).join('');
+}
+function sortById(rows) {
+    return [...rows].sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+}
+/** gzip with a fixed header (no mtime, OS = unix), so the same bytes in give the same bytes out on every machine zlib agrees on. */
+function gzipStable(bytes) {
+    const out = (0, node_zlib_1.gzipSync)(bytes, { level: 9 });
+    out.writeUInt32LE(0, 4); // mtime
+    out[8] = 0; // xfl
+    out[9] = 3; // OS: unix
+    return out;
+}
+function gunzipBytes(bytes) {
+    return (0, node_zlib_1.gunzipSync)(bytes);
+}
+function isGzipUri(uri) {
+    return uri.endsWith('.gz');
+}
+//# sourceMappingURL=canonical.js.map

package/dist/city/source/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../../../src/city/source/canonical.ts"],"names":[],"mappings":";AAAA,uHAAuH;AACvH,oHAAoH;AACpH,EAAE;AACF,2HAA2H;AAC3H,wHAAwH;AACxH,mHAAmH;;AAMnH,8BAEC;AAGD,0BAIC;AAgBD,sCA6BC;AAYD,kDAgBC;AAGD,oCAWC;AAED,wCAEC;AAED,4BAEC;AAGD,gCAMC;AAED,kCAEC;AAED,8BAEC;AA7HD,6CAAyC;AACzC,yCAAiD;AACjD,mCAA+C;AAE/C,SAAgB,SAAS,CAAC,KAA0B;IAClD,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,yFAAyF;AACzF,SAAgB,OAAO,CAAC,KAAa;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,KAAK,GAAG,CAAC,CAAC;IACzG,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,4BAAoB,CAAC,CAAC,CAAC;IAC5D,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACrC,CAAC;AAED,SAAS,WAAW,CAAC,CAAS,EAAE,CAAS;IACvC,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAOD,uDAAuD;AACvD,SAAgB,aAAa,CAAC,KAAc,EAAE,UAA4B,EAAE;IAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC;IAC3C,MAAM,IAAI,GAAG,CAAC,CAAU,EAAE,IAAY,EAAU,EAAE;QAChD,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAC9B,QAAQ,OAAO,CAAC,EAAE,CAAC;YACjB,KAAK,QAAQ;gBACX,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;gBACtF,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzD,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAC3B,KAAK,SAAS;gBACZ,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9B,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrB,IAAI,GAAG,GAAG,GAAG,CAAC;oBACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;wBAAE,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBAChI,OAAO,GAAG,GAAG,GAAG,CAAC;gBACnB,CAAC;gBACD,MAAM,MAAM,GAAG,CAA4B,CAAC;gBAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC9F,IAAI,GAAG,GAAG,GAAG,CAAC;gBACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;oBAAE,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjJ,OAAO,GAAG,GAAG,GAAG,CAAC;YACnB,CAAC;YACD;gBACE,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC,CAAC;IACF,OAAO,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7D,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC9L,CAAC;AAED,SAAS,WAAW,CAAC,KAAgB;IACnC,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACpH,CAAC;AAED,yFAAyF;AACzF,SAAgB,mBAAmB,CAAC,KAAc;IAChD,MAAM,IAAI,GAAG,CAAC,CAAU,EAAE,KAAa,EAAE,IAAY,EAAU,EAAE;QAC/D,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrE,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAChC,IAAI,MAAM,CAAC,CAAC,CAAC;gBAAE,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,GAAG,CAAC;QACzG,CAAC;QACD,MAAM,MAAM,GAAG,CAA4B,CAAC;QAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9F,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,GAAG,CAAC;IAC7I,CAAC,CAAC;IACF,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC;AACpC,CAAC;AAED,oHAAoH;AACpH,SAAgB,YAAY,CAAC,QAAsF;IACjH,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACpC,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QACjC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,SAAS,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChJ,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,MAAM,aAAa,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IACD,OAAO,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;AACxC,CAAC;AAED,SAAgB,cAAc,CAAC,IAAe;IAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,aAAa,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,SAAgB,QAAQ,CAA2B,IAAkB;IACnE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,oIAAoI;AACpI,SAAgB,UAAU,CAAC,KAAiB;IAC1C,MAAM,GAAG,GAAG,IAAA,oBAAQ,EAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1C,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ;IACjC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM;IAClB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW;IACvB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,WAAW,CAAC,KAAiB;IAC3C,OAAO,IAAA,sBAAU,EAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,SAAgB,SAAS,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/city/source/commands.d.ts

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

package/dist/city/source/commands.js

@@ -0,0 +1,71 @@
+"use strict";
+// `helix city source validate|inspect`: how an agent hands the CLI a city-source folder and gets a verdict and a picture.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCitySourceCommands = registerCitySourceCommands;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const inspect_1 = require("./inspect");
+const io_1 = require("./io");
+const preview_1 = require("./preview");
+const validate_1 = require("./validate");
+function registerCitySourceCommands(city, fail) {
+    const source = city
+        .command('source')
+        .description('The neutral city format helix.city-source/1 (docs/city-source.md): check a folder, read its numbers, draw its plan');
+    source
+        .command('validate')
+        .description('Check a city-source folder: files and hashes, then rings, road graph, extents, projection. Exits 1 on any error.')
+        .argument('<dir>', 'folder holding city-source.json')
+        .option('--json', 'print the report as JSON')
+        .option('--max-issues <n>', 'issues listed per code (the rest are counted)', '25')
+        .action(async (dir, opts) => {
+        try {
+            const max = Number(opts.maxIssues);
+            if (!Number.isInteger(max) || max < 1)
+                fail('✖ --max-issues must be a whole number >= 1');
+            const report = await (0, io_1.validateCitySourceFolder)((0, node_path_1.resolve)(dir), { maxIssuesPerCode: max });
+            console.log(opts.json ? JSON.stringify(report, null, 2) : (0, validate_1.formatValidationReport)(report));
+            if (!report.ok)
+                process.exitCode = 1;
+        }
+        catch (err) {
+            fail(`✖ ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+    source
+        .command('inspect')
+        .description('Counts, lengths, areas and hashes of a city-source folder; with --preview, a PNG plan of roads, footprints, water and land use')
+        .argument('<dir>', 'folder holding city-source.json')
+        .option('--json', 'print the numbers as JSON')
+        .option('--preview <png>', 'also write a north-up plan image (at most 1000 px)')
+        .option('--size <px>', 'longest edge of the preview, 200 to 1000', '1000')
+        .action(async (dir, opts) => {
+        try {
+            const size = Number(opts.size);
+            if (!Number.isInteger(size) || size < 200 || size > 1000)
+                fail('✖ --size must be a whole number from 200 to 1000');
+            const loaded = await (0, io_1.loadCitySource)((0, node_path_1.resolve)(dir));
+            if (loaded.sink.totals['manifest.missing'] || loaded.sink.totals['manifest.parse']) {
+                fail(`✖ ${loaded.sink.issues.map((issue) => issue.message).join('\n')}`);
+            }
+            const verdict = (0, validate_1.validateCitySource)(loaded.source, { sink: loaded.sink, layerFacts: loaded.layerFacts });
+            const report = (0, inspect_1.inspectCitySource)(loaded.source, loaded.layerFacts);
+            const lines = [];
+            if (!verdict.ok)
+                lines.push(`✖ ${verdict.errors} error${verdict.errors === 1 ? '' : 's'} in this source (numbers below are as found); run: helix city source validate ${dir}`);
+            lines.push(opts.json ? JSON.stringify({ valid: verdict.ok, errors: verdict.errors, warnings: verdict.warnings, ...report }, null, 2) : (0, inspect_1.formatCitySourceInspection)(report));
+            if (opts.preview) {
+                const preview = (0, preview_1.renderCitySourcePreview)(loaded.source, { size });
+                const out = (0, node_path_1.resolve)(opts.preview);
+                await (0, promises_1.mkdir)((0, node_path_1.dirname)(out), { recursive: true });
+                await (0, promises_1.writeFile)(out, preview.png);
+                lines.push(`✔ preview ${out} (${preview.width} x ${preview.height} px, ${preview.scale.toFixed(3)} px per metre)`);
+            }
+            console.log(lines.join('\n'));
+        }
+        catch (err) {
+            fail(`✖ ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+}
+//# sourceMappingURL=commands.js.map

package/dist/city/source/commands.js.map

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

package/dist/city/source/fixtures.d.ts

@@ -0,0 +1,13 @@
+import type { CitySource, CitySourceDraft } from './types';
+export declare function buildSyntheticFixture(): CitySourceDraft;
+export declare function buildOsmSliceFixture(): CitySourceDraft;
+export declare function buildCs2SliceFixture(): CitySourceDraft;
+export declare const CITY_SOURCE_FIXTURES: {
+    readonly 'osm-slice': typeof buildOsmSliceFixture;
+    readonly 'cs2-slice': typeof buildCs2SliceFixture;
+    readonly synthetic: typeof buildSyntheticFixture;
+};
+export type CitySourceFixtureName = keyof typeof CITY_SOURCE_FIXTURES;
+/** The schema string, re-exported for specs that build variants by hand. */
+export declare const FIXTURE_SCHEMA: "helix.city-source/1";
+export type { CitySource };