@math.gl/geospatial 5.0.0-alpha.19 → 5.0.0-alpha.20

package/dist/discontinuous/prepare-features.d.ts

@@ -0,0 +1,78 @@
+import type { MapEngine } from "./map-engine.js";
+import type { MapSamplingOptions } from "./map-layout.js";
+/** Two-dimensional GeoJSON geometry shapes. Positions are validated as lon/lat pairs. */
+export type MapFeatureGeometry = {
+    type: 'Point';
+    coordinates: readonly number[];
+} | {
+    type: 'MultiPoint' | 'LineString';
+    coordinates: readonly (readonly number[])[];
+} | {
+    type: 'MultiLineString' | 'Polygon';
+    coordinates: readonly (readonly (readonly number[])[])[];
+} | {
+    type: 'MultiPolygon';
+    coordinates: readonly (readonly (readonly (readonly number[])[])[])[];
+} | {
+    type: 'GeometryCollection';
+    geometries: readonly MapFeatureGeometry[];
+};
+/** Properties remain with the caller; output parts address this array by featureIndex. */
+export type MapFeature = {
+    type?: 'Feature';
+    id?: string | number;
+    geometry: MapFeatureGeometry | null;
+    properties?: unknown;
+};
+/** Original feature/component identity and the chart owning one generated part. */
+export type PreparedMapPart = {
+    featureIndex: number;
+    /** Indices through GeometryCollection.geometries and multipart coordinates. */
+    geometryPath: number[];
+    regionIndex: number;
+};
+/** Only original line or polygon-boundary segments occur in the path batch. */
+export type PreparedMapPathPart = PreparedMapPart & {
+    role: 'line' | 'polygon-outline';
+    /** Original input ring index (outer = 0), only for polygon outlines. */
+    ringIndex?: number;
+    /** A complete closed ring; cut fragments remain open. */
+    closed: boolean;
+};
+/** XY in map units and corresponding longitude/latitude, both interleaved pairs. */
+export type PreparedMapVertices = {
+    positions: Float64Array;
+    sourcePositions: Float64Array;
+};
+/** Packed, structured-cloneable geometry. All offsets count vertices or rings, not scalars. */
+export type PreparedMapGeometry = {
+    version: 1;
+    mapId: string;
+    /** Optional application IDs; featureIndex remains authoritative, including duplicate IDs. */
+    featureIds: (string | number | null)[];
+    regionIds: string[];
+    /** One vertex per part. Point ownership follows MapEngine.projectPoint(). */
+    points: PreparedMapVertices & {
+        parts: PreparedMapPart[];
+    };
+    paths: PreparedMapVertices & {
+        parts: PreparedMapPathPart[];
+        pathStarts: Uint32Array;
+    };
+    polygons: PreparedMapVertices & {
+        parts: PreparedMapPart[];
+        /** Vertex offsets for all rings, with a terminal sentinel. Rings repeat their first vertex. */
+        ringStarts: Uint32Array;
+        /** Ring offsets for polygon parts, with a terminal sentinel. Outer ring comes first. */
+        polygonStarts: Uint32Array;
+    };
+};
+/** Static preparation controls. This does not triangulate, interpolate attributes or pose meshes. */
+export type MapPrepareFeaturesOptions = {
+    sampling?: MapSamplingOptions;
+    /** Project original polygon boundaries separately; default true. */
+    polygonOutlines?: boolean;
+};
+/** Internal implementation of MapEngine.prepareFeatures; no renderer dependencies. */
+export declare function prepareMapFeatures(map: MapEngine, features: readonly MapFeature[], options?: MapPrepareFeaturesOptions): PreparedMapGeometry;
+//# sourceMappingURL=prepare-features.d.ts.map

package/dist/discontinuous/prepare-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-features.d.ts","sourceRoot":"","sources":["../../src/discontinuous/prepare-features.ts"],"names":[],"mappings":"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"}

package/dist/discontinuous/prepare-features.js

@@ -0,0 +1,146 @@
+const vertices = () => ({ positions: [], sourcePositions: [] });
+const pack = (v) => ({
+    positions: new Float64Array(v.positions),
+    sourcePositions: new Float64Array(v.sourcePositions)
+});
+function append(v, xy, source) {
+    if (xy.length !== source.length)
+        throw new Error('Mismatched map source coordinates');
+    if (v.positions.length / 2 + xy.length >= 0xffffffff)
+        throw new Error('Map geometry exceeds Uint32 offsets');
+    for (let i = 0; i < xy.length; i++) {
+        if (!xy[i].every(Number.isFinite) || !source[i].every(Number.isFinite))
+            throw new Error('Non-finite map geometry');
+        v.positions.push(xy[i][0], xy[i][1]);
+        v.sourcePositions.push(source[i][0], source[i][1]);
+    }
+}
+function position(p) {
+    if (!Array.isArray(p) || p.length !== 2 || !p.every(Number.isFinite) || Math.abs(p[1]) > 90)
+        throw new Error('Expected two-dimensional longitude/latitude positions');
+    return [p[0], p[1]];
+}
+function closed(line) {
+    if (line.length < 4)
+        return false;
+    const a = line[0], b = line[line.length - 1];
+    return a[0] === b[0] && a[1] === b[1];
+}
+/** Internal implementation of MapEngine.prepareFeatures; no renderer dependencies. */
+export function prepareMapFeatures(map, features, options = {}) {
+    if (!Array.isArray(features))
+        throw new Error('Expected a feature array');
+    if (options.polygonOutlines !== undefined && typeof options.polygonOutlines !== 'boolean')
+        throw new Error('polygonOutlines must be boolean');
+    const regionIds = map.regions.map(r => r.id), regionIndices = new Map(regionIds.map((id, i) => [id, i]));
+    const points = vertices(), paths = vertices(), polygons = vertices();
+    const pointParts = [], pathParts = [], polygonParts = [];
+    const pathStarts = [0], ringStarts = [0], polygonStarts = [0];
+    const featureIds = [];
+    const part = (featureIndex, geometryPath, regionId) => {
+        const regionIndex = regionIndices.get(regionId);
+        if (regionIndex === undefined)
+            throw new Error('Unknown prepared map region');
+        return { featureIndex, geometryPath: [...geometryPath], regionIndex };
+    };
+    const addLine = (input, featureIndex, geometryPath, ringIndex) => {
+        const line = input.map(position);
+        if (!line.length)
+            return;
+        if (line.length < 2)
+            throw new Error('A line needs at least two positions');
+        const isRing = ringIndex !== undefined;
+        if (isRing && !closed(line))
+            line.push([...line[0]]);
+        for (const p of map.projectLine(line, options.sampling)) {
+            append(paths, p.coordinates, p.sourceCoordinates);
+            pathParts.push({
+                ...part(featureIndex, geometryPath, p.regionId),
+                role: isRing ? 'polygon-outline' : 'line',
+                ...(isRing ? { ringIndex } : {}),
+                closed: closed(p.sourceCoordinates) && closed(p.coordinates)
+            });
+            pathStarts.push(paths.positions.length / 2);
+        }
+    };
+    const addPolygon = (input, featureIndex, geometryPath) => {
+        if (!input.length)
+            return;
+        const rings = input.map(r => r.map(position));
+        for (const p of map.projectPolygon(rings, options.sampling)) {
+            for (let i = 0; i < p.coordinates.length; i++) {
+                append(polygons, p.coordinates[i], p.sourceCoordinates[i]);
+                ringStarts.push(polygons.positions.length / 2);
+            }
+            polygonParts.push(part(featureIndex, geometryPath, p.regionId));
+            polygonStarts.push(ringStarts.length - 1);
+        }
+        if (options.polygonOutlines !== false)
+            rings.forEach((r, i) => addLine(r, featureIndex, geometryPath, i));
+    };
+    const visit = (geometry, featureIndex, path, depth) => {
+        if (depth > 64)
+            throw new Error('Geometry collections are too deeply nested');
+        if (!geometry || typeof geometry !== 'object')
+            throw new Error('Invalid feature geometry');
+        switch (geometry.type) {
+            case 'Point': {
+                const source = position(geometry.coordinates), hit = map.projectPoint(source);
+                if (hit) {
+                    append(points, [hit.position], [source]);
+                    pointParts.push(part(featureIndex, path, hit.regionId));
+                }
+                break;
+            }
+            case 'MultiPoint':
+                geometry.coordinates.forEach((p, i) => visit({ type: 'Point', coordinates: p }, featureIndex, [...path, i], depth));
+                break;
+            case 'LineString':
+                addLine(geometry.coordinates, featureIndex, path);
+                break;
+            case 'MultiLineString':
+                geometry.coordinates.forEach((line, i) => addLine(line, featureIndex, [...path, i]));
+                break;
+            case 'Polygon':
+                addPolygon(geometry.coordinates, featureIndex, path);
+                break;
+            case 'MultiPolygon':
+                geometry.coordinates.forEach((rings, i) => addPolygon(rings, featureIndex, [...path, i]));
+                break;
+            case 'GeometryCollection':
+                if (depth >= 64)
+                    throw new Error('Geometry collections are too deeply nested');
+                geometry.geometries.forEach((g, i) => visit(g, featureIndex, [...path, i], depth + 1));
+                break;
+            default:
+                throw new Error('Unsupported feature geometry type');
+        }
+    };
+    for (let i = 0; i < features.length; i++) {
+        const feature = features[i];
+        if (!feature || (feature.type !== undefined && feature.type !== 'Feature'))
+            throw new Error('Expected GeoJSON features');
+        if (feature.id !== undefined &&
+            typeof feature.id !== 'string' &&
+            !(typeof feature.id === 'number' && Number.isFinite(feature.id)))
+            throw new Error('Invalid feature ID');
+        featureIds.push(feature.id ?? null);
+        if (feature.geometry !== null)
+            visit(feature.geometry, i, [], 0);
+    }
+    return {
+        version: 1,
+        mapId: map.description.id,
+        featureIds,
+        regionIds,
+        points: { ...pack(points), parts: pointParts },
+        paths: { ...pack(paths), parts: pathParts, pathStarts: new Uint32Array(pathStarts) },
+        polygons: {
+            ...pack(polygons),
+            parts: polygonParts,
+            ringStarts: new Uint32Array(ringStarts),
+            polygonStarts: new Uint32Array(polygonStarts)
+        }
+    };
+}
+//# sourceMappingURL=prepare-features.js.map

package/dist/discontinuous/prepare-features.js.map

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

package/dist/discontinuous/presets.d.ts

@@ -0,0 +1,71 @@
+import { DiscontinuousMap } from "./map-layout.js";
+/** 24-panel AirOcean cut arrangement with radial/gnomonic face mapping.
+ * This is NOT the Gray-Fuller projection. Output units scale with radius.
+ */
+export declare function createAirOceanMap(options?: {
+    radius?: number;
+}): DiscontinuousMap;
+/** Exact Gray–Fuller face transform on the 24-panel AirOcean net. */
+export declare function createGrayFullerMap(options?: {
+    radius?: number;
+}): DiscontinuousMap;
+/** Independent six-lobe sinusoidal layout. Coordinates are spherical radians
+ * times radius, not an ellipsoidal CRS. Equatorial joins remain continuous.
+ */
+export declare function createInterruptedSinusoidalMap(options?: {
+    radius?: number;
+}): DiscontinuousMap;
+/** Six-lobe Mollweide map using the same independent cuts as the sinusoidal preset. */
+export declare function createInterruptedMollweideMap(options?: {
+    radius?: number;
+}): DiscontinuousMap;
+/** Goode homolosine formula with independent six-lobe cuts (not PROJ's IGH layout). */
+export declare function createInterruptedHomolosineMap(options?: {
+    radius?: number;
+}): DiscontinuousMap;
+/** Goode's land-oriented homolosine interruption (two northern, four southern lobes). */
+export declare function createGoodeMap(options?: {
+    radius?: number;
+}): DiscontinuousMap;
+/** Boggs eumorphic with land-oriented equatorial interruptions. */
+export declare function createInterruptedBoggsMap(options?: {
+    radius?: number;
+}): DiscontinuousMap;
+/** Sinu-Mollweide formula with independent equatorial six-lobe cuts. */
+export declare function createInterruptedSinuMollweideMap(options?: {
+    radius?: number;
+}): DiscontinuousMap;
+/** Quartic authalic with paired hemispheric lobes. */
+export declare function createInterruptedQuarticAuthalicMap(options?: {
+    radius?: number;
+}): DiscontinuousMap;
+/** Two Mollweide hemispheres, with a -20° central meridian. */
+export declare function createInterruptedMollweideHemispheresMap(options?: {
+    radius?: number;
+}): DiscontinuousMap;
+/** Ocean-oriented Goode, centered at -160°; no duplicate extension lobes. */
+export declare function createGoodeOceanMap(options?: {
+    radius?: number;
+}): DiscontinuousMap;
+export type InterruptedProjection = 'sinusoidal' | 'mollweide' | 'homolosine' | 'boggs' | 'sinu-mollweide' | 'quartic-authalic';
+/** Longitudes relative to centralMeridian, in degrees: [west, center, east]. */
+export type InterruptedLobe = readonly [number, number, number];
+export type InterruptedMapOptions = {
+    radius?: number;
+    centralMeridian?: number;
+    projection: InterruptedProjection;
+    /** Latitude where each hemisphere starts opening its cuts. Defaults to 0°. */
+    latitudes?: {
+        north: number;
+        south: number;
+    };
+    lobes: {
+        north: readonly InterruptedLobe[];
+        south: readonly InterruptedLobe[];
+    };
+};
+/** Configurable equatorial interruptions. Each hemisphere must tile [-180, 180]
+ * in west-to-east order. Wide lobes are split into joined computational charts.
+ */
+export declare function createInterruptedMap(options: InterruptedMapOptions): DiscontinuousMap;
+//# sourceMappingURL=presets.d.ts.map

package/dist/discontinuous/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/discontinuous/presets.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,gBAAgB,EAAoC,wBAAqB;AAiBjF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAM,GAAG,gBAAgB,CAEnF;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,OAAO,GAAE;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAM,GAAG,gBAAgB,CAErF;AAkGD;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,GAAE;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAM,GAAG,gBAAgB,CAEhG;AAED,uFAAuF;AACvF,wBAAgB,6BAA6B,CAAC,OAAO,GAAE;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAM,GAAG,gBAAgB,CAE/F;AAED,uFAAuF;AACvF,wBAAgB,8BAA8B,CAAC,OAAO,GAAE;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAM,GAAG,gBAAgB,CAEhG;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,OAAO,GAAE;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAM,GAAG,gBAAgB,CAEhF;AAED,mEAAmE;AACnE,wBAAgB,yBAAyB,CAAC,OAAO,GAAE;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAM,oBAExE;AACD,wEAAwE;AACxE,wBAAgB,iCAAiC,CAAC,OAAO,GAAE;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAM,oBAEhF;AACD,sDAAsD;AACtD,wBAAgB,mCAAmC,CAAC,OAAO,GAAE;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAM,oBAElF;AACD,+DAA+D;AAC/D,wBAAgB,wCAAwC,CAAC,OAAO,GAAE;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAM,oBAEvF;AACD,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,OAAO,GAAE;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAM,oBAElE;AAiMD,MAAM,MAAM,qBAAqB,GAC7B,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,OAAO,GACP,gBAAgB,GAChB,kBAAkB,CAAC;AACvB,gFAAgF;AAChF,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAChE,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,qBAAqB,CAAC;IAClC,8EAA8E;IAC9E,SAAS,CAAC,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC;IAC3C,KAAK,EAAE;QACL,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;QAClC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;KACnC,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,gBAAgB,CAwDrF"}