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

package/README.md

@@ -104,7 +104,8 @@ The token is stored in `~/.helix/credentials.json` (mode `600`). It's sent as
 | `helix world audit\|source-audit\|perf-gate\|prove-live` | Run the blocking world QA, performance, and deployed-build identity gates. |
 | `helix world performance-report [bundle] [--scene <scene-v2.json>] [--package <package-version.json>] [--snapshot <inspect.json>] [--perf <receipt.json>]` | Analyze exact declared scene resources and existing reference-profile budgets, while keeping authored geometry/material/delivery estimates separate from supplied runtime claims. Prints actionable instancing, Palette, lighting, transfer, and visual-QA guidance; it never predicts FPS from static counts. |
 | `helix world scene-source inventory\|compile <helsinki\|bistro> <archive>` | Verify and safely inventory a known CC BY source archive, then compile deterministic local proxy/detail GLBs and an existing-schema Scene v2 package. |
-| `helix world scene-source publish <world-id> <package-dir> [--publish]` | Validate the Scene v2 package and print its multipart build receipt. Execution remains dry-run-only until backend private-pin entitlement lands; `--publish` currently fails closed, and access control never changes CC BY rights. |
+| `helix world scene-source publish <world-id> <package-dir> [--publish]` | Validate the Scene v2 package, refuse it if it breaks the open-world performance rules (docs/scene-perf.md; no override), and print its multipart build receipt. Execution remains dry-run-only until backend private-pin entitlement lands; `--publish` currently fails closed, and access control never changes CC BY rights. |
+| `helix scene validate <dir\|file> [--perf] [--tier desktop\|mobile\|desktop,mobile] [--out <report.json>]` | Check a Scene v2 package against the shared validator and, with `--perf`, the 14 open-world performance rules (textures, geometry, cells, draws, budget, first-playable bytes). Exit 0 pass, 1 refused, 2 cannot be judged. See `docs/scene-perf.md`. |
 | `helix continuum publish-source-map\|publish-scratch\|publish-package\|publish-glb\|make-item\|publish-owned-item` | Resume exact-CID object adoption/ingestion, Package lease/seal, optional explicitly authorized Listing, and WorldRelease publication through one creator-owned pipeline. |
 | `helix continuum receipt <job-id>` | Read the sanitized durable receipt for a completed Continuum publication. |
 | `helix unreal init\|validate\|doctor\|package [project]` | Create and gate a shared-runtime or native-game publish manifest, check optional editor MCP, and assemble a local upload-shaped package. |

package/dist/city/dem/despike.d.ts

@@ -0,0 +1,12 @@
+import type { DemWindow } from './window';
+/**
+ * GLO-30 is a surface model, and in a skyscraper canyon the radar returns small pits (downtown San Francisco has 3-4 sample wide
+ * holes 18 m below sea level on a 20 m hill). A pit is a connected cluster of samples more than `depthM` under the median of
+ * their 7 x 7 neighbourhood; clusters of at most `maxSamples` are filled with that median, while larger ones are real basins
+ * (quarries, docks, lakes under the surface model) and stay. Mutates `window.heights` in place, so `sampleAt` sees it, and
+ * recomputes `min`/`max`. Returns how many samples were filled.
+ */
+export declare function despikeDemWindow(window: DemWindow, opts?: {
+    depthM?: number;
+    maxSamples?: number;
+}): number;

package/dist/city/dem/despike.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.despikeDemWindow = despikeDemWindow;
+/**
+ * GLO-30 is a surface model, and in a skyscraper canyon the radar returns small pits (downtown San Francisco has 3-4 sample wide
+ * holes 18 m below sea level on a 20 m hill). A pit is a connected cluster of samples more than `depthM` under the median of
+ * their 7 x 7 neighbourhood; clusters of at most `maxSamples` are filled with that median, while larger ones are real basins
+ * (quarries, docks, lakes under the surface model) and stay. Mutates `window.heights` in place, so `sampleAt` sees it, and
+ * recomputes `min`/`max`. Returns how many samples were filled.
+ */
+function despikeDemWindow(window, opts = {}) {
+    const depthM = opts.depthM ?? 8;
+    const maxSamples = opts.maxSamples ?? 40;
+    const { samplesX: w, samplesZ: h, heights } = window;
+    const median = new Float32Array(heights.length);
+    const gather = [];
+    for (let j = 0; j < h; j += 1) {
+        for (let i = 0; i < w; i += 1) {
+            gather.length = 0;
+            for (let dj = -3; dj <= 3; dj += 1) {
+                for (let di = -3; di <= 3; di += 1) {
+                    const x = i + di;
+                    const z = j + dj;
+                    if (x >= 0 && z >= 0 && x < w && z < h)
+                        gather.push(heights[z * w + x]);
+                }
+            }
+            gather.sort((a, b) => a - b);
+            median[j * w + i] = gather[gather.length >> 1];
+        }
+    }
+    const pit = new Uint8Array(heights.length);
+    for (let k = 0; k < heights.length; k += 1)
+        if (median[k] - heights[k] > depthM)
+            pit[k] = 1;
+    const seen = new Uint8Array(heights.length);
+    let filled = 0;
+    for (let start = 0; start < pit.length; start += 1) {
+        if (!pit[start] || seen[start])
+            continue;
+        const cluster = [];
+        const stack = [start];
+        seen[start] = 1;
+        while (stack.length > 0) {
+            const at = stack.pop();
+            cluster.push(at);
+            const x = at % w;
+            const z = (at - x) / w;
+            for (let dj = -1; dj <= 1; dj += 1) {
+                for (let di = -1; di <= 1; di += 1) {
+                    const nx = x + di;
+                    const nz = z + dj;
+                    if (nx < 0 || nz < 0 || nx >= w || nz >= h)
+                        continue;
+                    const n = nz * w + nx;
+                    if (pit[n] && !seen[n]) {
+                        seen[n] = 1;
+                        stack.push(n);
+                    }
+                }
+            }
+        }
+        if (cluster.length <= maxSamples) {
+            for (const at of cluster)
+                heights[at] = median[at];
+            filled += cluster.length;
+        }
+    }
+    if (filled > 0) {
+        let min = Infinity;
+        let max = -Infinity;
+        for (const value of heights) {
+            if (value < min)
+                min = value;
+            if (value > max)
+                max = value;
+        }
+        window.min = min;
+        window.max = max;
+    }
+    return filled;
+}
+//# sourceMappingURL=despike.js.map

package/dist/city/dem/despike.js.map

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

package/dist/city/dem/index.d.ts

@@ -0,0 +1,8 @@
+export { copernicusTileIds, demCellId, MAX_DEM_CELLS } from './tileIds';
+export { COPERNICUS_ATTRIBUTION, COPERNICUS_BASE_URL, fetchCopernicusWindow } from './window';
+export type { DemTileReport, DemWindow, DemWindowRequest } from './window';
+export { DEM_LAYER_SCHEMA, DEM_RASTER_FILE, encodeDemLayer, writeDemLayer } from './layer';
+export type { DemLayer, DemLayerFiles, DemLayerMeta } from './layer';
+export { decodeTile, parseCogHeader } from './tiff';
+export type { CogHeader } from './tiff';
+export { despikeDemWindow } from './despike';

package/dist/city/dem/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.despikeDemWindow = exports.parseCogHeader = exports.decodeTile = exports.writeDemLayer = exports.encodeDemLayer = exports.DEM_RASTER_FILE = exports.DEM_LAYER_SCHEMA = exports.fetchCopernicusWindow = exports.COPERNICUS_BASE_URL = exports.COPERNICUS_ATTRIBUTION = exports.MAX_DEM_CELLS = exports.demCellId = exports.copernicusTileIds = void 0;
+var tileIds_1 = require("./tileIds");
+Object.defineProperty(exports, "copernicusTileIds", { enumerable: true, get: function () { return tileIds_1.copernicusTileIds; } });
+Object.defineProperty(exports, "demCellId", { enumerable: true, get: function () { return tileIds_1.demCellId; } });
+Object.defineProperty(exports, "MAX_DEM_CELLS", { enumerable: true, get: function () { return tileIds_1.MAX_DEM_CELLS; } });
+var window_1 = require("./window");
+Object.defineProperty(exports, "COPERNICUS_ATTRIBUTION", { enumerable: true, get: function () { return window_1.COPERNICUS_ATTRIBUTION; } });
+Object.defineProperty(exports, "COPERNICUS_BASE_URL", { enumerable: true, get: function () { return window_1.COPERNICUS_BASE_URL; } });
+Object.defineProperty(exports, "fetchCopernicusWindow", { enumerable: true, get: function () { return window_1.fetchCopernicusWindow; } });
+var layer_1 = require("./layer");
+Object.defineProperty(exports, "DEM_LAYER_SCHEMA", { enumerable: true, get: function () { return layer_1.DEM_LAYER_SCHEMA; } });
+Object.defineProperty(exports, "DEM_RASTER_FILE", { enumerable: true, get: function () { return layer_1.DEM_RASTER_FILE; } });
+Object.defineProperty(exports, "encodeDemLayer", { enumerable: true, get: function () { return layer_1.encodeDemLayer; } });
+Object.defineProperty(exports, "writeDemLayer", { enumerable: true, get: function () { return layer_1.writeDemLayer; } });
+var tiff_1 = require("./tiff");
+Object.defineProperty(exports, "decodeTile", { enumerable: true, get: function () { return tiff_1.decodeTile; } });
+Object.defineProperty(exports, "parseCogHeader", { enumerable: true, get: function () { return tiff_1.parseCogHeader; } });
+var despike_1 = require("./despike");
+Object.defineProperty(exports, "despikeDemWindow", { enumerable: true, get: function () { return despike_1.despikeDemWindow; } });
+//# sourceMappingURL=index.js.map

package/dist/city/dem/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/city/dem/index.ts"],"names":[],"mappings":";;;AAAA,qCAAwE;AAA/D,4GAAA,iBAAiB,OAAA;AAAE,oGAAA,SAAS,OAAA;AAAE,wGAAA,aAAa,OAAA;AACpD,mCAA8F;AAArF,gHAAA,sBAAsB,OAAA;AAAE,6GAAA,mBAAmB,OAAA;AAAE,+GAAA,qBAAqB,OAAA;AAE3E,iCAA2F;AAAlF,yGAAA,gBAAgB,OAAA;AAAE,wGAAA,eAAe,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,sGAAA,aAAa,OAAA;AAEzE,+BAAoD;AAA3C,kGAAA,UAAU,OAAA;AAAE,sGAAA,cAAc,OAAA;AAEnC,qCAA6C;AAApC,2GAAA,gBAAgB,OAAA"}

package/dist/city/dem/layer.d.ts

@@ -0,0 +1,46 @@
+import { type DemWindow } from './window';
+/** The `terrain/dem.json` sidecar of `helix.city-source/1` (lane city-source's `CityDemMeta`). */
+export interface DemLayerMeta {
+    schema: 'helix.city-source-dem/1';
+    file: string;
+    format: 'r16';
+    /** [columns, rows] */
+    samples: [number, number];
+    metresPerSample: number;
+    originXZ: [number, number];
+    /** Scene Y metres that raw 0 and raw 65535 stand for (already minus the manifest's originAltitudeM). */
+    heightRangeM: [number, number];
+    /** Over the raster bytes. */
+    sha256: string;
+    note?: string;
+}
+export interface DemLayer {
+    meta: DemLayerMeta;
+    r16: Buffer;
+    originAltitudeM: number;
+}
+export interface DemLayerFiles {
+    r16Path: string;
+    jsonPath: string;
+    sha256: {
+        r16: string;
+        json: string;
+    };
+    originAltitudeM: number;
+    heightRange: [number, number];
+}
+export declare const DEM_LAYER_SCHEMA: "helix.city-source-dem/1";
+export declare const DEM_RASTER_FILE = "dem.r16";
+/**
+ * The window as a city-source terrain layer: little-endian uint16 R16, row 0 north, encoding altitude relative to the window's
+ * floor over `[0, span]` in whole metres (as the terrain-world engine script does), so
+ * `helix terrain import dem.r16 --metres-per-sample N --samples <columns> --height-range 0,<span>` reads it back.
+ * Pure and deterministic: the same window gives the same bytes, and dem.json carries no timestamps.
+ */
+export declare function encodeDemLayer(window: DemWindow, opts?: {
+    originAltitudeM?: number;
+}): DemLayer;
+/** Writes `dir/dem.r16` and `dir/dem.json` for a standalone consumer (the city-source writer writes its own copy). */
+export declare function writeDemLayer(window: DemWindow, dir: string, opts?: {
+    originAltitudeM?: number;
+}): Promise<DemLayerFiles>;

package/dist/city/dem/layer.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEM_RASTER_FILE = exports.DEM_LAYER_SCHEMA = void 0;
+exports.encodeDemLayer = encodeDemLayer;
+exports.writeDemLayer = writeDemLayer;
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const window_1 = require("./window");
+exports.DEM_LAYER_SCHEMA = 'helix.city-source-dem/1';
+exports.DEM_RASTER_FILE = 'dem.r16';
+/**
+ * The window as a city-source terrain layer: little-endian uint16 R16, row 0 north, encoding altitude relative to the window's
+ * floor over `[0, span]` in whole metres (as the terrain-world engine script does), so
+ * `helix terrain import dem.r16 --metres-per-sample N --samples <columns> --height-range 0,<span>` reads it back.
+ * Pure and deterministic: the same window gives the same bytes, and dem.json carries no timestamps.
+ */
+function encodeDemLayer(window, opts) {
+    const floor = Math.floor(window.min);
+    const originAltitudeM = opts?.originAltitudeM ?? floor;
+    if (!Number.isFinite(originAltitudeM))
+        throw new Error(`encodeDemLayer: originAltitudeM must be finite, received ${originAltitudeM}`);
+    if (originAltitudeM > window.min) {
+        // R16 has no room below zero: a higher origin would clamp the lowest ground flat, silently.
+        throw new Error(`encodeDemLayer: originAltitudeM ${originAltitudeM} is above the window's lowest ground (${window.min} m)`);
+    }
+    const span = Math.max(1, Math.ceil(window.max) - originAltitudeM);
+    if (window.heights.length !== window.samplesX * window.samplesZ) {
+        throw new Error(`encodeDemLayer: ${window.heights.length} heights is not ${window.samplesX} x ${window.samplesZ}`);
+    }
+    const r16 = Buffer.alloc(window.heights.length * 2);
+    for (let index = 0; index < window.heights.length; index += 1) {
+        const encoded = Math.round(((window.heights[index] - originAltitudeM) / span) * 65535);
+        r16.writeUInt16LE(Math.min(65535, Math.max(0, encoded)), index * 2);
+    }
+    return {
+        meta: {
+            schema: exports.DEM_LAYER_SCHEMA,
+            file: exports.DEM_RASTER_FILE,
+            format: 'r16',
+            samples: [window.samplesX, window.samplesZ],
+            metresPerSample: window.metresPerSample,
+            originXZ: [window.originXZ[0], window.originXZ[1]],
+            heightRangeM: [0, span],
+            sha256: (0, node_crypto_1.createHash)('sha256').update(r16).digest('hex'),
+            note: `Copernicus GLO-30 DSM (EGM2008), altitude ${originAltitudeM} m is scene Y 0; ${window_1.COPERNICUS_ATTRIBUTION}`,
+        },
+        r16,
+        originAltitudeM,
+    };
+}
+/** Writes `dir/dem.r16` and `dir/dem.json` for a standalone consumer (the city-source writer writes its own copy). */
+async function writeDemLayer(window, dir, opts) {
+    const layer = encodeDemLayer(window, opts);
+    const json = `${JSON.stringify(layer.meta, null, 2)}\n`;
+    await (0, promises_1.mkdir)(dir, { recursive: true });
+    const r16Path = (0, node_path_1.join)(dir, layer.meta.file);
+    const jsonPath = (0, node_path_1.join)(dir, 'dem.json');
+    await (0, promises_1.writeFile)(r16Path, layer.r16);
+    await (0, promises_1.writeFile)(jsonPath, json);
+    return {
+        r16Path,
+        jsonPath,
+        sha256: { r16: layer.meta.sha256, json: (0, node_crypto_1.createHash)('sha256').update(json).digest('hex') },
+        originAltitudeM: layer.originAltitudeM,
+        heightRange: layer.meta.heightRangeM,
+    };
+}
+//# sourceMappingURL=layer.js.map

package/dist/city/dem/layer.js.map

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

package/dist/city/dem/mosaic.d.ts

@@ -0,0 +1,60 @@
+import { type DemCell } from './tileIds';
+import { type CogHeader } from './tiff';
+/** One 1x1 degree GLO-30 cell once its header is known (`header` undefined means the bucket has no such tile: open ocean). */
+export interface LoadedCell {
+    cell: DemCell;
+    id: string;
+    url: string;
+    header?: CogHeader;
+    note?: string;
+    /** Decoded internal tiles by tile index; undefined until fetched. NaN marks nodata. */
+    tiles: Array<Float32Array | undefined>;
+    /** Every byte range this build used (header at 0, then tiles), keyed by start offset: the cache-independent record the digest covers. */
+    ranges: Map<number, Uint8Array>;
+    bytesFetched: number;
+}
+export declare function cellKey(cell: DemCell): number;
+/** Raster <-> geographic mapping of one cell's header. */
+export interface CellGeometry {
+    colOf(lon: number): number;
+    rowOf(lat: number): number;
+    lonOf(col: number): number;
+    latOf(row: number): number;
+}
+/**
+ * Copernicus GLO-30 COGs carry GTRasterTypeGeoKey = 2 (PixelIsPoint) with the tie point raster (0,0) -> (cell west lon,
+ * cell north lat): sample (0,0) is CENTRED on the integer-degree north-west corner, so column c sits at lon = west + c *
+ * scale. (Seen in the real N37 W123 and N46 E007 headers; GDAL reports the same file with a half-pixel-shifted geotransform
+ * and AREA_OR_POINT=Point.) A PixelIsArea raster's tie point names the pixel CORNER, so its centre is half a pixel further in.
+ */
+export declare function cellGeometry(header: CogHeader): CellGeometry;
+/**
+ * The cells as one continuous sample field. A sample is looked up in the cell that owns it (west edge inclusive, north
+ * edge inclusive: the cell's row 0 sits ON its north degree line). The bilinear footprint of a sample near a seam reaches
+ * one pixel into the neighbour; that pixel is the neighbour's nearest sample to the exact position (the neighbour may have
+ * a coarser longitude posting at high latitude), so a seam interpolates across both tiles. If the neighbour was not loaded
+ * the footprint clamps to the edge of its own cell instead; a missing (ocean) neighbour reads as 0 m.
+ *
+ * Two passes share this code: `collectNeeded` records which internal tiles a window touches without reading any, then the
+ * caller fetches exactly those and runs `heightAt` for real.
+ */
+export declare class Mosaic {
+    private readonly cells;
+    /** Output samples that needed any nodata fill. */
+    filled: number;
+    private collected;
+    private readonly geometry;
+    constructor(cells: Map<number, LoadedCell>);
+    startCollecting(): void;
+    /** Ends the collecting pass and returns, per cell, the internal tile indices it touched. */
+    finishCollecting(): Map<LoadedCell, Set<number>>;
+    private geometryOf;
+    private cellAt;
+    /** Bilinear height at lon/lat (0 over a missing tile); NaN never leaves. */
+    heightAt(lon: number, lat: number): number;
+    /** The valid sample nearest `(col, row)` by Euclidean distance within a bounded search, walking square rings outward. */
+    private nearestValid;
+    /** One source sample, crossing into the neighbouring cell when the index is off this cell's raster. NaN = nodata / not loaded. */
+    private pixel;
+    private read;
+}

package/dist/city/dem/mosaic.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Mosaic = void 0;
+exports.cellKey = cellKey;
+exports.cellGeometry = cellGeometry;
+const tileIds_1 = require("./tileIds");
+const tiff_1 = require("./tiff");
+/** How far a nodata sample looks for a valid neighbour before the void is declared sea level. */
+const NODATA_SEARCH_PIXELS = 16;
+function cellKey(cell) {
+    return (cell.latIdx + 90) * 400 + (cell.lonIdx + 180);
+}
+/**
+ * Copernicus GLO-30 COGs carry GTRasterTypeGeoKey = 2 (PixelIsPoint) with the tie point raster (0,0) -> (cell west lon,
+ * cell north lat): sample (0,0) is CENTRED on the integer-degree north-west corner, so column c sits at lon = west + c *
+ * scale. (Seen in the real N37 W123 and N46 E007 headers; GDAL reports the same file with a half-pixel-shifted geotransform
+ * and AREA_OR_POINT=Point.) A PixelIsArea raster's tie point names the pixel CORNER, so its centre is half a pixel further in.
+ */
+function cellGeometry(header) {
+    const shift = header.rasterType === 'area' ? 0.5 : 0;
+    const { tiePoint: tie, pixelScale: [sx, sy] } = header;
+    return {
+        colOf: (lon) => (lon - tie.lon) / sx + tie.i - shift,
+        rowOf: (lat) => (tie.lat - lat) / sy + tie.j - shift,
+        lonOf: (col) => tie.lon + (col + shift - tie.i) * sx,
+        latOf: (row) => tie.lat - (row + shift - tie.j) * sy,
+    };
+}
+/**
+ * The cells as one continuous sample field. A sample is looked up in the cell that owns it (west edge inclusive, north
+ * edge inclusive: the cell's row 0 sits ON its north degree line). The bilinear footprint of a sample near a seam reaches
+ * one pixel into the neighbour; that pixel is the neighbour's nearest sample to the exact position (the neighbour may have
+ * a coarser longitude posting at high latitude), so a seam interpolates across both tiles. If the neighbour was not loaded
+ * the footprint clamps to the edge of its own cell instead; a missing (ocean) neighbour reads as 0 m.
+ *
+ * Two passes share this code: `collectNeeded` records which internal tiles a window touches without reading any, then the
+ * caller fetches exactly those and runs `heightAt` for real.
+ */
+class Mosaic {
+    cells;
+    /** Output samples that needed any nodata fill. */
+    filled = 0;
+    collected = null;
+    geometry = new Map();
+    constructor(cells) {
+        this.cells = cells;
+    }
+    startCollecting() {
+        this.collected = new Map();
+    }
+    /** Ends the collecting pass and returns, per cell, the internal tile indices it touched. */
+    finishCollecting() {
+        const result = this.collected ?? new Map();
+        this.collected = null;
+        return result;
+    }
+    geometryOf(cell) {
+        let geometry = this.geometry.get(cell);
+        if (geometry === undefined) {
+            geometry = cellGeometry(cell.header);
+            this.geometry.set(cell, geometry);
+        }
+        return geometry;
+    }
+    cellAt(lon, lat) {
+        return this.cells.get(cellKey((0, tileIds_1.owningCell)(lon, lat)));
+    }
+    /** Bilinear height at lon/lat (0 over a missing tile); NaN never leaves. */
+    heightAt(lon, lat) {
+        const cell = this.cellAt(lon, lat);
+        if (cell === undefined || cell.header === undefined)
+            return 0;
+        const geometry = this.geometryOf(cell);
+        const u = geometry.colOf(lon);
+        const v = geometry.rowOf(lat);
+        const c0 = Math.floor(u);
+        const r0 = Math.floor(v);
+        const fu = u - c0;
+        const fv = v - r0;
+        let sum = 0;
+        let weight = 0;
+        let sawNodata = false;
+        for (let dr = 0; dr < 2; dr += 1) {
+            for (let dc = 0; dc < 2; dc += 1) {
+                const w = (dc === 0 ? 1 - fu : fu) * (dr === 0 ? 1 - fv : fv);
+                if (w <= 0)
+                    continue;
+                const value = this.pixel(cell, c0 + dc, r0 + dr);
+                if (Number.isNaN(value)) {
+                    sawNodata = true;
+                    continue;
+                }
+                sum += value * w;
+                weight += w;
+            }
+        }
+        // Interpolate over the valid corners only: a void must not drag its neighbours to a sentinel.
+        if (weight > 0) {
+            if (sawNodata)
+                this.filled += 1;
+            return sum / weight;
+        }
+        this.filled += 1;
+        return this.nearestValid(cell, Math.round(u), Math.round(v)) ?? 0;
+    }
+    /** The valid sample nearest `(col, row)` by Euclidean distance within a bounded search, walking square rings outward. */
+    nearestValid(cell, col, row) {
+        let bestSquared = Infinity;
+        let bestValue = null;
+        // Ring r is at least r away, so once r*r passes the best hit nothing beyond can beat it.
+        for (let radius = 1; radius <= NODATA_SEARCH_PIXELS && radius * radius <= bestSquared; radius += 1) {
+            for (let dr = -radius; dr <= radius; dr += 1) {
+                const step = Math.abs(dr) === radius ? 1 : 2 * radius;
+                for (let dc = -radius; dc <= radius; dc += step) {
+                    const squared = dc * dc + dr * dr;
+                    if (squared >= bestSquared)
+                        continue;
+                    const value = this.pixel(cell, col + dc, row + dr);
+                    if (!Number.isNaN(value)) {
+                        bestSquared = squared;
+                        bestValue = value;
+                    }
+                }
+            }
+        }
+        return bestValue;
+    }
+    /** One source sample, crossing into the neighbouring cell when the index is off this cell's raster. NaN = nodata / not loaded. */
+    pixel(cell, col, row) {
+        const header = cell.header;
+        if (col >= 0 && col < header.width && row >= 0 && row < header.height)
+            return this.read(cell, col, row);
+        const geometry = this.geometryOf(cell);
+        const lon = geometry.lonOf(col);
+        const lat = geometry.latOf(row);
+        const neighbour = this.cellAt(lon, lat);
+        if (neighbour === undefined || neighbour === cell) {
+            return this.read(cell, Math.min(Math.max(col, 0), header.width - 1), Math.min(Math.max(row, 0), header.height - 1));
+        }
+        if (neighbour.header === undefined)
+            return 0;
+        const other = this.geometryOf(neighbour);
+        const nc = Math.min(Math.max(Math.round(other.colOf(lon)), 0), neighbour.header.width - 1);
+        const nr = Math.min(Math.max(Math.round(other.rowOf(lat)), 0), neighbour.header.height - 1);
+        return this.read(neighbour, nc, nr);
+    }
+    read(cell, col, row) {
+        const header = cell.header;
+        const tx = Math.floor(col / header.tileWidth);
+        const ty = Math.floor(row / header.tileHeight);
+        const index = ty * (0, tiff_1.tilesAcross)(header) + tx;
+        if (this.collected !== null) {
+            let set = this.collected.get(cell);
+            if (set === undefined) {
+                set = new Set();
+                this.collected.set(cell, set);
+            }
+            set.add(index);
+            return 0;
+        }
+        const tile = cell.tiles[index];
+        if (tile === undefined)
+            return Number.NaN;
+        return tile[(row - ty * header.tileHeight) * header.tileWidth + (col - tx * header.tileWidth)];
+    }
+}
+exports.Mosaic = Mosaic;
+//# sourceMappingURL=mosaic.js.map

package/dist/city/dem/mosaic.js.map

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

package/dist/city/dem/rangeClient.d.ts

@@ -0,0 +1,40 @@
+export interface RangeClientOptions {
+    fetch: typeof fetch;
+    retries: number;
+    /** First backoff delay; doubles per attempt. Tests drop it to a millisecond. */
+    backoffBaseMs: number;
+    cacheDir?: string;
+}
+export type RangeResult = {
+    status: 'ok';
+    bytes: Uint8Array;
+    networkBytes: number;
+}
+/** 404 / 403: S3 answers 403 for an absent key when the bucket forbids listing, so both mean "no such object". */
+ | {
+    status: 'missing';
+    code: number;
+    networkBytes: number;
+};
+export interface RangeStats {
+    requests: number;
+    bytesFetched: number;
+    cacheHits: number;
+}
+/**
+ * Ranged GETs with a bounded retry and an optional on-disk cache of every range, so a rerun is offline-capable and
+ * polite to the bucket. A range is a pure function of (url, start, end) because the bucket's objects are immutable.
+ */
+export declare class RangeClient {
+    private readonly options;
+    readonly stats: RangeStats;
+    constructor(options: RangeClientOptions);
+    /** Bytes `[start, endInclusive]` of `url`; a range past the end of a short object comes back short (the header read relies on that). */
+    getRange(url: string, start: number, endInclusive: number, exact: boolean): Promise<RangeResult>;
+    private fetchWithRetry;
+    private cachePath;
+    private readCache;
+    private writeCache;
+}
+/** Runs `worker` over `items` with at most `limit` in flight; results keep input order. */
+export declare function mapPool<T, R>(items: readonly T[], limit: number, worker: (item: T, index: number) => Promise<R>): Promise<R[]>;