Add the Data Library: live regional datasets, tiles and packs

DATA LAYERS keeps its curated core layers; regional and niche sources
live in the Data Library, opened from Browse data library at the foot
of the panel. Each entry is a JSON manifest in src/library/entries/
pointing at a live upstream (query API, provider-hosted file or tile
endpoint), so nothing is bundled and a self-hosted instance hosts no
data. Sources without CORS go through one allowlisted /api/library
route. Kinds: dataset (GeoJSON, CSV, JSON records, ArcGIS, partitioned
GeoParquet), tiles (XYZ, WMS/ArcGIS bbox export, terrarium relief) and
pack. Selections persist and travel in share links as lib=, separate
from the core layer tokens. Library rows get Zoom and Remove icon
chips that work while the layer is off, rendered through RailChips.
Strings are translated in every locale.
This commit is contained in:
Said Turksever committed 2026-11-12 12:26:45 +00:00
1 parent 10a788db78
commit db80d82b8d
182 files changed
+15805 -44

No files matched your search

+95
View File
@@ -0,0 +1,95 @@
import test from 'node:test';
import assert from 'node:assert/strict';
import {
RELIEF_CLASSES,
metresPerPixel,
terrariumHeight,
terrariumToRelief,
} from './relief.js';
import { libraryEntry } from './catalog.js';
import { validateLibraryManifest } from './manifest.js';
/** Terrarium RGB for a height in metres. */
function encode(height) {
const value = height + 32768;
const r = Math.floor(value / 256);
const g = Math.floor(value - r * 256);
const b = Math.round((value - Math.floor(value)) * 256);
return [r, g, b, 255];
}
function tile(width, height, heightAt) {
const pixels = new Uint8ClampedArray(width * height * 4);
for (let y = 0; y < height; y++)
for (let x = 0; x < width; x++)
pixels.set(encode(heightAt(x, y)), (y * width + x) * 4);
return pixels;
}
test('Terrarium pixels decode to metres', () => {
assert.equal(terrariumHeight(...encode(0)), 0);
assert.equal(terrariumHeight(...encode(4478)), 4478);
assert.equal(terrariumHeight(...encode(-432)), -432);
});
test('sea is transparent and flat land takes its elevation class colour', () => {
const flat = (height) =>
terrariumToRelief(
tile(3, 3, () => height),
3,
3,
30,
);
assert.equal(flat(0)[3], 0, 'sea (exactly 0 m) stays transparent');
const near = (out, hex) => {
const target = [1, 3, 5].map((i) => parseInt(hex.slice(i, i + 2), 16));
return target.every((value, i) => Math.abs(out[16 + i] - value) <= 12);
};
assert.equal(flat(-6)[19], 255);
assert.ok(
near(flat(-6), RELIEF_CLASSES[0].color),
'land below sea level is the lowest class',
);
assert.ok(near(flat(600), RELIEF_CLASSES[2].color), '600 m is 500–1,000 m');
assert.ok(
near(flat(3500), RELIEF_CLASSES[5].color),
'3,500 m is the top class',
);
});
test('a north-west sun lights north-west slopes and shades south-east ones', () => {
// Height rises to the south-east: the slope faces north-west, into the sun.
const facingSun = terrariumToRelief(
tile(5, 5, (x, y) => 400 + 40 * (x + y)),
5,
5,
10,
);
const facingAway = terrariumToRelief(
tile(5, 5, (x, y) => 800 - 40 * (x + y)),
5,
5,
10,
);
const centre = 12 * 4;
assert.ok(facingSun[centre] > facingAway[centre]);
});
test('pixel size shrinks with zoom and latitude', () => {
assert.ok(Math.abs(metresPerPixel(0, 0, 256) - 156543 * Math.cos(0)) > 0);
assert.ok(metresPerPixel(10, 300, 512) < metresPerPixel(9, 150, 512));
const equator = metresPerPixel(4, 7.5, 512);
assert.ok(Math.abs(equator - 40075016.686 / (512 * 16)) / equator < 0.01);
});
test('only xyz tiles may declare an encoding and a 512 px tile size', () => {
const mapterhorn = libraryEntry('mapterhorn-terrain');
assert.equal(mapterhorn.source.encoding, 'terrarium');
assert.equal(mapterhorn.source.tileSize, 512);
const raw = structuredClone(mapterhorn);
raw.source.encoding = 'mapbox';
raw.source.tileSize = 300;
const { errors } = validateLibraryManifest(raw);
assert.ok(errors.some((e) => e.startsWith('source.encoding is for tiles')));
assert.ok(errors.includes('source.tileSize is 256 or 512, for tiles'));
});