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

package/dist/projection/experimental/spatial-deformation.js

@@ -0,0 +1,85 @@
+import { createLocalFrameBasis, eastNorthUpBasis, localToFixed } from '@math.gl/core/local-frame';
+import { geocentricToGeodeticInPlace } from "./datum.js";
+export function createSpatialDeformationModel(options, sample, velocity = false, inverseSolver) {
+    const range = options.epochRange;
+    if (!Array.isArray(range) ||
+        range.length !== 2 ||
+        !range.every(Number.isFinite) ||
+        range[0] > range[1])
+        throw new Error('Finite ordered deformation epochRange required');
+    const start = range[0], end = range[1];
+    const a = options.ellipsoid?.semiMajorAxis ?? 6378137;
+    const f = options.ellipsoid?.flattening ?? 1 / 298.257223563;
+    if (!Number.isFinite(a) || a <= 0 || !Number.isFinite(f) || f < 0 || f >= 1)
+        throw new Error('Invalid deformation ellipsoid');
+    if (!(a * (1 - f) > 0) || !(f * (2 - f) < 1))
+        throw new Error('Invalid deformation ellipsoid');
+    const ellipsoid = Object.freeze({
+        semiMajorAxis: a,
+        semiMinorAxis: a * (1 - f),
+        eccentricitySquared: f * (2 - f)
+    });
+    function validateEpochs(source, target) {
+        if (!Number.isFinite(source) ||
+            !Number.isFinite(target) ||
+            source < start ||
+            source > end ||
+            target < start ||
+            target > end ||
+            !Number.isFinite(target - source))
+            throw new Error('Deformation epochs outside model epochRange or non-finite');
+    }
+    const frame = createLocalFrameBasis();
+    function displacement(point, source, target) {
+        geocentricToGeodeticInPlace(point, ellipsoid);
+        const longitude = point.x, latitude = point.y;
+        if (!sample(longitude, latitude, point, source, target))
+            throw new Error(velocity ? 'No velocity grid covers coordinate' : 'No deformation field covers coordinate');
+        if (!eastNorthUpBasis(longitude, latitude, frame) || !localToFixed(point, frame))
+            throw new Error('Non-finite deformation output');
+    }
+    function apply(point, source, target, inverse) {
+        validateEpochs(source, target);
+        const x = point.x, y = point.y, z = point.z;
+        if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(z))
+            throw new Error('Finite deformation XYZ required');
+        try {
+            if (inverse && inverseSolver) {
+                inverseSolver(point, x, y, z, source, target, displacement);
+                return;
+            }
+            let px = x, py = y, pz = z;
+            for (let iteration = 0; iteration < (inverse ? 32 : 1); iteration++) {
+                point.x = px;
+                point.y = py;
+                point.z = pz;
+                displacement(point, source, target);
+                const scale = (inverse ? -1 : 1) * (velocity ? target - source : 1);
+                const nx = x + scale * point.x, ny = y + scale * point.y, nz = z + scale * point.z;
+                if (!Number.isFinite(nx) || !Number.isFinite(ny) || !Number.isFinite(nz))
+                    throw new Error('Non-finite deformation output');
+                if (!inverse || Math.hypot(nx - px, ny - py, nz - pz) <= 1e-8) {
+                    point.x = nx;
+                    point.y = ny;
+                    point.z = nz;
+                    return;
+                }
+                px = nx;
+                py = ny;
+                pz = nz;
+            }
+            throw new Error('Deformation inverse did not converge');
+        }
+        catch (error) {
+            point.x = x;
+            point.y = y;
+            point.z = z;
+            throw error;
+        }
+    }
+    return Object.freeze({
+        forward: (point, source, target) => apply(point, source, target, false),
+        inverse: (point, source, target) => apply(point, source, target, true)
+    });
+}
+//# sourceMappingURL=spatial-deformation.js.map

package/dist/projection/experimental/spatial-deformation.js.map

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

package/dist/projection/experimental/types.d.ts

@@ -0,0 +1,156 @@
+import type { CRSMetadata } from "../../crs/index.js";
+import type { TypeScriptCRSInput } from "./crs/spatial-reference.js";
+import type { CreateProjectionOptions, ProjectionEngine, ProjectionCoordinate, ProjectionOutput } from "../types.js";
+/** Raw PROJ parameters. Angles are decimal degrees and lengths are meters. */
+export type ProjectionParameters = Readonly<Record<string, string | undefined>>;
+/** Mutable scratch owned by the caller. Hooks must update synchronously and never retain it. */
+export type ProjectionPoint = {
+    x: number;
+    y: number;
+    z: number;
+};
+/** Engine-validated interleaved floating-point storage. */
+export type ProjectionFlatOperation = (coordinates: Float32Array | Float64Array, dimension: number) => void;
+/** Unit conversion for a horizontal geographic/projected batch, in pipeline order. */
+export type ProjectionFlatContext = {
+    readonly inputScale: number;
+    readonly outputScale: number;
+};
+/** Greenwich longitude/latitude coverage in degrees. Longitude endpoints are in
+ * [-180, 180]; west > east crosses the dateline. [-180, south, 180, north]
+ * covers all longitudes; equal longitude endpoints describe a meridian.
+ * Latitude satisfies -90 <= south <= north <= 90.
+ */
+export type GeographicBounds = readonly [west: number, south: number, east: number, north: number];
+/** Projection-owned native reference-surface envelope and Greenwich degree normalization. */
+export type ProjectionRenderingProfile = {
+    /** Finite native XYZ envelope chosen as an appropriate rendering target.
+     * This is a rendering policy, not the algorithm's mathematical validity domain.
+     * Coordinates outside it may still be converted; membership does not validate a coordinate.
+     * Horizontal projections use zero reference height; geocentric profiles enclose XYZ.
+     */
+    readonly bounds: readonly [readonly [number, number, number], readonly [number, number, number]];
+    /** Optional rendering-domain clamp on Greenwich longitude/latitude in degrees; preserve altitude.
+     * Conversion kernels remain unrestricted by this rendering envelope.
+     */
+    normalize?(point: ProjectionPoint): void;
+};
+/** A projection operates on radians and meters; the engine handles CRS units. */
+export type ProjectionImplementation = {
+    /** Effective central longitude in native radians, including algorithm-derived origins. */
+    readonly longitudeOrigin?: number;
+    /** Resolve projection-owned bounds and normalization, optionally for declared coverage.
+     * Coverage is the declared Greenwich geographic area, in degrees; wrapped endpoints are preserved.
+     * Omit coverage for the default rendering target. Descriptor retrieval retries
+     * without coverage if the coverage-specific profile cannot be resolved.
+     * Required for CRS descriptor retrieval; ordinary conversion can omit it.
+     */
+    getRenderingProfile?(coverage?: GeographicBounds): ProjectionRenderingProfile;
+    /** Optional whole-buffer specialization. Return undefined to keep the general pipeline.
+     * Called only for geographic/projected pairs without datum, axis, prime-meridian,
+     * vertical-unit, longitude-wrap or lossy stages. The engine validates storage and stride.
+     * The operation must validate each XYZ, scale XY before/after projection, check domains
+     * and Float32 range, preserve Z/trailing ordinates, and commit only completed records.
+     * Factories run at construction; operations must not retain buffers or scratch across calls.
+     */
+    createForwardFlat?(context: ProjectionFlatContext): ProjectionFlatOperation | undefined;
+    createInverseFlat?(context: ProjectionFlatContext): ProjectionFlatOperation | undefined;
+    /** Optional mutable hooks avoid scalar coordinate arrays; preserve z for horizontal projections. */
+    forwardInPlace?(point: ProjectionPoint): void;
+    inverseInPlace?(point: ProjectionPoint): void;
+    /** Optional Cartesian operations used by geocentric plugins. */
+    forward3D?(point: [number, number, number]): [number, number, number];
+    inverse3D?(point: [number, number, number]): [number, number, number];
+    forward(longitude: number, latitude: number): [number, number];
+    inverse(x: number, y: number): [number, number];
+};
+/** Initialized geometry shared by projection plugins. No datum shift is implied. */
+export type ProjectionContext = {
+    /** Greenwich longitude of the CRS prime meridian, in radians. */
+    readonly primeMeridian?: number;
+    /** Preserve the normalized polar axis; recovering it from eccentricity can lose precision. */
+    readonly semiMinorAxis?: number;
+    readonly semiMajorAxis: number;
+    readonly eccentricitySquared: number;
+    readonly parameters: ProjectionParameters;
+};
+/** Explicit registration avoids global state and imports of unused projections. */
+export type ProjectionPlugin = {
+    readonly name: string;
+    readonly aliases?: readonly string[];
+    /** Projection-specific PROJ parameters accepted in addition to the core parameters. */
+    readonly parameters: readonly string[];
+    /** Parameters accepted without a value, such as +south. */
+    readonly flags?: readonly string[];
+    create(context: ProjectionContext): ProjectionImplementation;
+};
+/** Coordinate conventions used when resolving a single CRS. */
+export type GetCRSOptions = Pick<CreateProjectionOptions, 'enforceAxis' | 'mode'> & {
+    /** Additional source CRS strings to prepare; WGS84 is always included. */
+    converters?: readonly string[];
+};
+/** Finite target-coordinate XYZ envelope describing an appropriate rendering target.
+ * This is not the projection algorithm's validity domain or a coordinate validity test.
+ */
+export type CRSBounds = readonly [
+    minimum: readonly [number, number, number],
+    maximum: readonly [number, number, number]
+];
+/** Rendering factors in effective target-axis order. Horizontal factors measure
+ * WGS84 reference-surface metres per stored coordinate unit through the full inverse
+ * transform. For projected CRSs the vertical factor uses the square root of the
+ * inverse horizontal area scale, expressed in the declared vertical unit.
+ * This sizing convention is independent of altitude conversion; use the component
+ * unit metadata and converters for physical heights. Geocentric/identity factors
+ * are constant physical unit conversions.
+ */
+export type CRSRenderingScale = readonly [x: number, y: number, z: number];
+/** Evaluate at a position in the descriptor's CRS; null means scale calculation failed. */
+export type CRSRenderingScaleCallback = (coordinate: ProjectionCoordinate) => CRSRenderingScale | null;
+/** Synchronous conversion; omit output to allocate an array, or supply storage to reuse it. */
+export interface CRSConversion {
+    (coordinate: ProjectionCoordinate): number[];
+    <T extends ProjectionOutput>(coordinate: ProjectionCoordinate, output: T): T;
+}
+/** Prepared bidirectional conversion between a source CRS and a descriptor's target CRS. */
+export interface CRSConverter {
+    /** Convert source coordinates to target coordinates, optionally reusing output storage. */
+    readonly from: CRSConversion;
+    /** Convert target coordinates to source coordinates, optionally reusing output storage. */
+    readonly to: CRSConversion;
+    /** Normalize source coordinates for the target projection, optionally reusing output storage. */
+    readonly normalize: CRSConversion;
+}
+/** Prepared CRS metadata, target-space behavior, and converters keyed by source CRS string.
+ * WGS84 uses longitude/latitude in degrees and ellipsoidal height in metres. Converters
+ * retain the engine's datum policy; fourth and later components pass through.
+ */
+export interface CRSDescriptor extends CRSMetadata {
+    /** Original string under default conventions; otherwise a resolved @math.gl/geospatial/crs signature.
+     * Opaque to consumers; no arbitrary CRS equivalence comparison is implied.
+     * Does not fingerprint algorithm implementations or grid contents; equality does
+     * not guarantee packed-coordinate interchangeability across engines.
+     */
+    readonly signature: string;
+    /** Finite XYZ envelope chosen as an appropriate rendering target, in effective units and axis order.
+     * Bounds describe a rendering policy for the reference surface, not the algorithm's
+     * mathematical validity domain or altitude limits. Coordinates outside the envelope
+     * may still be converted; being inside it does not guarantee a valid conversion.
+     */
+    readonly renderingBounds: CRSBounds;
+    /** Constant scale or target-position callback; no viewport fallback is applied. */
+    readonly renderingScale: CRSRenderingScale | CRSRenderingScaleCallback;
+    /** Return rendering sizing factors at the anchor; null means sampling is unavailable
+     * or derivatives fail numerical agreement. Invalid finite geometry raises an error. */
+    getRenderingScale(coordinate: ProjectionCoordinate): CRSRenderingScale | null;
+    /** Prepared converters; WGS84 is always available, plus explicitly requested source strings. */
+    readonly converter: Readonly<Record<string, CRSConverter>> & {
+        readonly WGS84: CRSConverter;
+    };
+}
+/** General CRS-capable engine; specialized pair-only engines need not implement retrieval. */
+export interface CRSEngine extends ProjectionEngine {
+    /** Resolve metadata and preload only required algorithms. Returned conversions are synchronous. */
+    getCRS(definition: TypeScriptCRSInput, options?: GetCRSOptions): Promise<CRSDescriptor>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/projection/experimental/types.d.ts.map

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

package/dist/projection/experimental/types.js

@@ -0,0 +1,5 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+export {};
+//# sourceMappingURL=types.js.map

package/dist/projection/experimental/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/projection/experimental/types.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D"}

package/dist/projection/experimental/typescript-projection.d.ts

@@ -0,0 +1,76 @@
+import type { GeographicBounds } from "./types.js";
+import type { TypeScriptCRSInput } from "./crs/spatial-reference.js";
+import type { ProjectionDescriptor } from "./projection-descriptor.js";
+import type { ProjectionRenderingProfile, ProjectionPlugin } from "./types.js";
+import type { ProjectionCoordinate, ProjectionOutput } from "./scalar-output.js";
+import type { CRSCompatibilityReason, CRSNormalizationOptions } from "./crs/types.js";
+import type { DatumGridCollection, VerticalGridCollection } from "./grids/types.js";
+type ProjectionRegistration = ProjectionPlugin | ProjectionDescriptor;
+type ProjectionResult<P, Result> = Extract<P, ProjectionDescriptor> extends never ? Result : Promise<Result>;
+export type ProjectionTransformOptions<P extends ProjectionRegistration = ProjectionPlugin> = CRSNormalizationOptions & {
+    from?: TypeScriptCRSInput;
+    to?: TypeScriptCRSInput;
+    /** Only these projection implementations are available to this instance. */
+    projections?: readonly P[];
+    /** Honor declared axis order/direction. Default false, matching proj4js. */
+    enforceAxis?: boolean;
+    /** Prepared horizontal grids keyed by the names used in +nadgrids. No global registry. */
+    datumGrids?: DatumGridCollection;
+    /** Prepared geoid undulations keyed by +geoidgrids names. No implicit fetching. */
+    verticalGrids?: VerticalGridCollection;
+};
+export type ProjectionTransformCreateOptions = ProjectionTransformOptions<ProjectionRegistration>;
+export type ProjectionArray = Float32Array | Float64Array;
+/** Configurable math.gl projection engine; see the documented supported subset and accuracy limits.
+ * Third ordinates are height (gravity-related with +geoidgrids) or geocentric Z.
+ */
+export declare class ProjectionTransform<P extends ProjectionRegistration = ProjectionPlugin> {
+    /** Resolve required descriptors once, then return an ordinary synchronous instance. */
+    static create(options?: ProjectionTransformCreateOptions): Promise<ProjectionTransform>;
+    private readonly coordinateScratch;
+    private readonly forwardTransform?;
+    private readonly inverseTransform?;
+    private readonly deferred?;
+    /** Initialized target projection profile on eager/prepared transforms. @internal */
+    private readonly targetRenderingProfile?;
+    private readonly targetCoverage?;
+    get targetProfile(): ProjectionRenderingProfile | undefined;
+    /** Resolve target rendering policy independently from coordinate conversion. @internal */
+    getTargetRenderingProfile(coverage?: GeographicBounds): ProjectionRenderingProfile | undefined;
+    /** Effective target central meridian in native radians. @internal */
+    readonly targetLongitudeOrigin: number;
+    readonly lossy: boolean;
+    constructor(options?: ProjectionTransformOptions<P>);
+    private load;
+    private loadSync;
+    /** Synchronous variants never import algorithms; descriptors must be preloaded. */
+    projectSync(coordinate: readonly number[]): number[];
+    unprojectSync(coordinate: readonly number[]): number[];
+    projectFlatSync<T extends ProjectionArray>(coordinates: T, dimension?: number): T;
+    unprojectFlatSync<T extends ProjectionArray>(coordinates: T, dimension?: number): T;
+    /** Optional warm-up. Coordinate methods also load automatically on first use. */
+    preload(): Promise<void>;
+    /** Eager plugins return arrays; descriptor-backed instances return promises. */
+    project(coordinate: readonly number[]): ProjectionResult<P, number[]>;
+    unproject(coordinate: readonly number[]): ProjectionResult<P, number[]>;
+    /** Write one coordinate into caller-owned storage; return that same output. */
+    projectTo<T extends ProjectionOutput>(coordinate: ProjectionCoordinate, output: T): ProjectionResult<P, T>;
+    unprojectTo<T extends ProjectionOutput>(coordinate: ProjectionCoordinate, output: T): ProjectionResult<P, T>;
+    projectToSync<T extends ProjectionOutput>(coordinate: ProjectionCoordinate, output: T): T;
+    unprojectToSync<T extends ProjectionOutput>(coordinate: ProjectionCoordinate, output: T): T;
+    private projectToLoaded;
+    private projectLoaded;
+    /** In-place; descriptor callers must await completion before reusing the buffer. */
+    projectFlat<T extends ProjectionArray>(coordinates: T, dimension?: number): ProjectionResult<P, T>;
+    unprojectFlat<T extends ProjectionArray>(coordinates: T, dimension?: number): ProjectionResult<P, T>;
+}
+export type ProjectionCompatibility = {
+    status: 'supported' | 'unsupported' | 'unknown';
+    lossy: boolean;
+    reason?: CRSCompatibilityReason;
+    message?: string;
+};
+/** Check construction with this backend and this exact set of registered plugins/readers. */
+export declare function checkProjectionCompatibility(definition: TypeScriptCRSInput, options?: ProjectionTransformOptions): ProjectionCompatibility;
+export {};
+//# sourceMappingURL=typescript-projection.d.ts.map

package/dist/projection/experimental/typescript-projection.d.ts.map

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