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

package/dist/discontinuous/layout.js

@@ -0,0 +1,114 @@
+const boundsOf = (points) => {
+    let left = Infinity, bottom = Infinity, right = -Infinity, top = -Infinity;
+    for (const [x, y] of points) {
+        left = Math.min(left, x);
+        right = Math.max(right, x);
+        bottom = Math.min(bottom, y);
+        top = Math.max(top, y);
+    }
+    return Object.freeze([left, bottom, right, top]);
+};
+const corners = ([left, bottom, right, top]) => [
+    [left, bottom],
+    [right, top]
+];
+/** Sample actual projected edges, not just region corners. Bounds are approximate
+ * to the supplied angular/chord sampling criteria; callbacks must remain stable.
+ */
+export function getMapLayout(map, options = {}) {
+    const regions = map.regions
+        .map((region) => {
+        const outlines = map
+            .getRegionOutlines(region.id, options)
+            .map(p => Object.freeze(p.map(point => Object.freeze([...point]))));
+        const points = outlines.flat();
+        const interior = map.projectPoint(region.interior, region.id);
+        if (interior)
+            points.push(interior.position);
+        if (!points.length)
+            throw new Error(`Cannot measure region ${region.id}`);
+        return Object.freeze({
+            id: region.id,
+            label: region.layout?.label ?? region.id,
+            kind: region.layout?.kind ?? 'panel',
+            parentId: region.layout?.parentId,
+            relativeScale: region.layout?.relativeScale,
+            drawOrder: region.layout?.drawOrder ?? 0,
+            placement: region.placement,
+            bounds: boundsOf(points),
+            frame: region.layout?.frame,
+            outlines: Object.freeze(outlines)
+        });
+    })
+        .sort((a, b) => a.drawOrder - b.drawOrder);
+    return Object.freeze({
+        bounds: boundsOf(regions.flatMap(r => [...corners(r.bounds), ...(r.frame ? corners(r.frame) : [])])),
+        regions: Object.freeze(regions)
+    });
+}
+/** Uniformly fit canonical placement to a viewport. Preserves inset spacing and
+ * scale ratios. Use project/unproject for screen picking and renderer conversion.
+ */
+export function fitMapLayout(layout, options) {
+    const { width, height, padding = 0, flipY = true } = options;
+    const pad = typeof padding === 'number'
+        ? { left: padding, right: padding, top: padding, bottom: padding }
+        : padding;
+    const { left = 0, right = 0, top = 0, bottom = 0 } = pad;
+    if (![width, height].every(v => Number.isFinite(v) && v > 0) ||
+        ![left, right, top, bottom].every(v => Number.isFinite(v) && v >= 0) ||
+        left + right >= width ||
+        top + bottom >= height)
+        throw new Error('Invalid viewport or padding');
+    const [minX, minY, maxX, maxY] = layout.bounds;
+    const spanX = maxX - minX, spanY = maxY - minY;
+    if (!layout.bounds.every(Number.isFinite) ||
+        !Number.isFinite(spanX) ||
+        !Number.isFinite(spanY) ||
+        spanX <= 0 ||
+        spanY <= 0)
+        throw new Error('Layout bounds must have finite positive extents');
+    const scale = Math.min((width - left - right) / spanX, (height - top - bottom) / spanY);
+    const sx = scale, sy = flipY ? -scale : scale;
+    const centerX = minX + spanX / 2, centerY = minY + spanY / 2;
+    const targetX = left + (width - left - right) / 2;
+    const targetY = (flipY ? top : bottom) + (height - top - bottom) / 2;
+    if (!Number.isFinite(scale) || scale <= 0)
+        throw new Error('Viewport scale is not representable');
+    const project = ([x, y]) => [
+        (x - centerX) * sx + targetX,
+        (y - centerY) * sy + targetY
+    ];
+    const unproject = ([x, y]) => [
+        (x - targetX) / sx + centerX,
+        (y - targetY) / sy + centerY
+    ];
+    const transformBounds = (b) => boundsOf(corners(b).map(project));
+    return Object.freeze({
+        width,
+        height,
+        scale,
+        flipY,
+        project,
+        unproject,
+        bounds: transformBounds(layout.bounds),
+        regions: Object.freeze(layout.regions.map((r, index) => Object.freeze({
+            ...r,
+            layer: index,
+            bounds: transformBounds(r.bounds),
+            frame: r.frame ? transformBounds(r.frame) : undefined,
+            outlines: Object.freeze(r.outlines.map(line => Object.freeze(line.map(p => Object.freeze(project(p))))))
+        })))
+    });
+}
+/** Inverse candidates at a viewport pixel, ordered from the visible top layer.
+ * A renderer can still reject candidates hidden by its own geometry or styling.
+ */
+export function pickMapLayout(map, fitted, pixel) {
+    const xy = fitted.unproject(pixel);
+    return fitted.regions
+        .slice()
+        .reverse()
+        .flatMap(region => map.unprojectPoint(xy, region.id).map(point => ({ ...point, layer: region.layer })));
+}
+//# sourceMappingURL=layout.js.map

package/dist/discontinuous/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/discontinuous/layout.ts"],"names":[],"mappings":"AAuCA,MAAM,QAAQ,GAAG,CAAC,MAAqC,EAAa,EAAE;IACpE,IAAI,IAAI,GAAG,QAAQ,EACjB,MAAM,GAAG,QAAQ,EACjB,KAAK,GAAG,CAAC,QAAQ,EACjB,GAAG,GAAG,CAAC,QAAQ,CAAC;IAClB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACzB,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3B,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC7B,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAc,CAAC;AAChE,CAAC,CAAC;AACF,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAY,EAAQ,EAAE,CAAC;IAC/D,CAAC,IAAI,EAAE,MAAM,CAAC;IACd,CAAC,KAAK,EAAE,GAAG,CAAC;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAe,EAAE,UAA8B,EAAE;IAC5E,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO;SACxB,GAAG,CAAC,CAAC,MAAM,EAAmB,EAAE;QAC/B,MAAM,QAAQ,GAAG,GAAG;aACjB,iBAAiB,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC;aACrC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAuB,CAAC,CAAC,CAAC,CAAC;QAC5F,MAAM,MAAM,GAAyB,QAAQ,CAAC,IAAI,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9D,IAAI,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,MAAM,CAAC,EAAE;YACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,OAAO;YACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ;YACjC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa;YAC3C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC;YACxC,SAAS,EAAE,MAAM,CAAC,SAAU;YAC5B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;YACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK;YAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;SAClC,CAAC,CAAC;IACL,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,QAAQ,CACd,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CACnF;QACD,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;KAChC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAiB,EAAE,OAA2B;IACzE,MAAM,EAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,EAAC,GAAG,OAAO,CAAC;IAC3D,MAAM,GAAG,GACP,OAAO,OAAO,KAAK,QAAQ;QACzB,CAAC,CAAC,EAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAC;QAChE,CAAC,CAAC,OAAO,CAAC;IACd,MAAM,EAAC,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,EAAC,GAAG,GAAG,CAAC;IACvD,IACE,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxD,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,IAAI,GAAG,KAAK,IAAI,KAAK;QACrB,GAAG,GAAG,MAAM,IAAI,MAAM;QAEtB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,MAAM,KAAK,GAAG,IAAI,GAAG,IAAI,EACvB,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;IACtB,IACE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QACrC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACvB,KAAK,IAAI,CAAC;QACV,KAAK,IAAI,CAAC;QAEV,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC;IACxF,MAAM,EAAE,GAAG,KAAK,EACd,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,CAAC,EAC9B,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAClG,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAqB,EAAM,EAAE,CAAC;QAClD,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO;QAC5B,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO;KAC7B,CAAC;IACF,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAqB,EAAM,EAAE,CAAC;QACpD,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO;QAC5B,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO;KAC7B,CAAC;IACF,MAAM,eAAe,GAAG,CAAC,CAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5E,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK;QACL,MAAM;QACN,KAAK;QACL,KAAK;QACL,OAAO;QACP,SAAS;QACT,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC;QACtC,OAAO,EAAE,MAAM,CAAC,MAAM,CACpB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAC9B,MAAM,CAAC,MAAM,CAAC;YACZ,GAAG,CAAC;YACJ,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC;YACjC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;YACrD,QAAQ,EAAE,MAAM,CAAC,MAAM,CACrB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAChF;SACF,CAAC,CACH,CACF;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAe,EACf,MAAuC,EACvC,KAAyB;IAEzB,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC,OAAO;SAClB,KAAK,EAAE;SACP,OAAO,EAAE;SACT,OAAO,CAAC,MAAM,CAAC,EAAE,CAChB,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAC,GAAG,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAC,CAAC,CAAC,CAClF,CAAC;AACN,CAAC"}

package/dist/discontinuous/map-engine.d.ts

@@ -0,0 +1,197 @@
+import { MapTransition, type MapTransitionOptions } from "./map-transition.js";
+import { type MapFeature, type MapPrepareFeaturesOptions, type PreparedMapGeometry } from "./prepare-features.js";
+import type { ElasticMapData } from "./elastic/data.js";
+import { type GeographicPosition, type MapBounds, type MapRegion, type MapSamplingOptions } from "./map-layout.js";
+import { fitMapLayout, type MapViewportOptions } from "./layout.js";
+import { type InterruptedMapOptions } from "./presets.js";
+import { type ProjectionMapOptions } from "./projection-catalog.js";
+import { type RegionalMapOptions } from "./regional-map.js";
+import { type WorldMapOptions } from "./world-map.js";
+import { type MyriahedralOptions, type MyriahedralLayout } from "./myriahedral.js";
+/** Serializable chart: runtime projection callbacks are resolved by key. */
+export type MapChartDescription = Omit<MapRegion, 'project' | 'unproject'> & {
+    projection: string;
+};
+export type MapDefinition = {
+    type: 'elastic';
+    data: ElasticMapData;
+} | ({
+    type: 'projection';
+} & Omit<ProjectionMapOptions, 'radius'>) | ({
+    type: 'regional';
+} & Omit<RegionalMapOptions, 'radius'>) | ({
+    type: 'world';
+} & Omit<WorldMapOptions, 'radius'>) | {
+    type: 'gray-fuller' | 'isea' | 'dsea';
+} | {
+    type: 'petroff';
+    centralMeridian?: number;
+} | {
+    type: 'healpix';
+    centralMeridian?: number;
+} | {
+    type: 'gingery';
+    centralMeridian?: number;
+    lobes?: number;
+    coreAngle?: number;
+} | ({
+    type: 'interrupted';
+} & Omit<InterruptedMapOptions, 'radius'>) | {
+    type: 'butterfly' | 'collignon-butterfly' | 'waterman' | 'goode-ocean' | 'interrupted-boggs' | 'interrupted-sinu-mollweide' | 'interrupted-quartic-authalic' | 'interrupted-mollweide-hemispheres';
+} | {
+    type: 'peirce-quincuncial' | 'guyou' | 'gringorten-quincuncial';
+    centralMeridian?: number;
+} | {
+    type: 'berghaus';
+    centralMeridian?: number;
+    lobes?: number;
+} | {
+    type: 'mercator';
+    centralMeridian?: number;
+    maxLatitude?: number;
+} | {
+    type: 'goode' | 'interrupted-sinusoidal' | 'interrupted-mollweide' | 'interrupted-homolosine' | 'air-ocean';
+} | {
+    type: 'albers-usa';
+    includeTerritories?: boolean;
+} | ({
+    type: 'myriahedral';
+} & Omit<MyriahedralOptions, 'radius' | 'isLand' | 'edgeWeight'>) | {
+    type: 'custom';
+    charts: readonly MapChartDescription[];
+};
+/** Data only. All inputs are spherical longitude/latitude in degrees. */
+export type MapDescription = {
+    version: 1;
+    id: string;
+    title?: string;
+    /** Positive output scale; default 1. Does not select an ellipsoidal datum. */
+    radius?: number;
+    attribution?: readonly string[];
+    definition: MapDefinition;
+};
+export type MapEngineOptions = {
+    projections?: Readonly<Record<string, Pick<MapRegion, 'project' | 'unproject'>>>;
+    isLand?: MyriahedralOptions['isLand'];
+    edgeWeight?: MyriahedralOptions['edgeWeight'];
+    sampling?: MapSamplingOptions;
+};
+export type MapCapabilities = Readonly<{
+    hasCuts: boolean;
+    hasInsets: boolean;
+    /** More than one connected component of the sampled continuous-join graph. */
+    disjoint: boolean;
+    hinged: boolean;
+    globe: true;
+}>;
+export type MapState = {
+    type: 'map' | 'globe';
+} | {
+    type: 'hinge';
+    amount: number;
+};
+export type MapPosition3D = [number, number, number];
+export type MapTransitionPlan = Readonly<{
+    strategy: 'direct' | 'via-globe';
+    reason: string;
+    /** Geometry is re-split for the destination; correspondence uses source coordinates. */
+    resplit: boolean;
+    coverage: 'preserve' | 'fade-unmatched';
+    sourceHinge: boolean;
+    targetHinge: boolean;
+}>;
+/** One spherical chart pipeline for ordinary, interrupted, inset and hinged maps. */
+export declare class MapEngine {
+    readonly description: Readonly<MapDescription>;
+    readonly capabilities: MapCapabilities;
+    readonly motion?: MyriahedralLayout;
+    private readonly map;
+    private readonly sampling;
+    private cachedLayout?;
+    private flat?;
+    constructor(description: MapDescription, options?: MapEngineOptions);
+    get regions(): readonly MapRegion[];
+    get seams(): readonly import("./map-layout").MapSeam[];
+    findRegions(position: GeographicPosition): string[];
+    /** True only when a convex source ring needs no coverage or chart clipping. */
+    containsConvexPolygon(ring: readonly GeographicPosition[], regionId: string): boolean;
+    projectPoint(position: GeographicPosition, regionId?: string): import("./map-layout").MapPoint;
+    unprojectPoint(position: GeographicPosition, regionId?: string): import("./map-layout").MapPoint[];
+    projectLine(line: readonly GeographicPosition[], options?: MapSamplingOptions): import("./map-layout").MapLine[];
+    projectPolygon(rings: readonly (readonly GeographicPosition[])[], options?: MapSamplingOptions): import("./map-layout").MapPolygon[];
+    /** Prepare static feature geometry with packed buffers and original-feature identity.
+     * Polygon fills and original outlines are separate, so clipping edges are not stroked. */
+    prepareFeatures(features: readonly MapFeature[], options?: MapPrepareFeaturesOptions): PreparedMapGeometry;
+    getLayout(): Readonly<{
+        bounds: MapBounds;
+        regions: readonly import("./layout").MapLayoutRegion[];
+    }>;
+    fit(options: MapViewportOptions): Readonly<{
+        width: number;
+        height: number;
+        scale: number;
+        flipY: boolean;
+        project: ([x, y]: GeographicPosition) => [number, number];
+        unproject: ([x, y]: GeographicPosition) => [number, number];
+        bounds: MapBounds;
+        regions: readonly Readonly<{
+            layer: number;
+            bounds: MapBounds;
+            frame: MapBounds;
+            outlines: readonly (readonly (readonly [number, number])[])[];
+            id: string;
+            label: string;
+            kind: NonNullable<import("./map-layout").MapRegionLayout["kind"]>;
+            parentId?: string;
+            relativeScale?: number;
+            drawOrder: number;
+            placement: import("./map-layout").MapPlacement;
+        }>[];
+    }>;
+    pick(viewport: ReturnType<typeof fitMapLayout>, pixel: GeographicPosition): {
+        layer: number;
+        regionId: string;
+        position: import("./math").Position;
+    }[];
+    /** One sampling footprint per chart. Tile fetching and LOD selection remain renderer work. */
+    getSamplingRegions(viewport: ReturnType<typeof fitMapLayout>): {
+        boundary: readonly GeographicPosition[];
+        pixelsPerMapUnit: number;
+        /** Local pixel lengths per longitude/latitude radian, or null at a singularity/outside coverage. */
+        getPixelScale: (position: GeographicPosition) => [number, number] | null;
+        layer: number;
+        bounds: MapBounds;
+        frame: MapBounds;
+        outlines: readonly (readonly (readonly [number, number])[])[];
+        id: string;
+        label: string;
+        kind: NonNullable<import("./map-layout").MapRegionLayout["kind"]>;
+        parentId?: string;
+        relativeScale?: number;
+        drawOrder: number;
+        placement: import("./map-layout").MapPlacement;
+    }[];
+    /** Freeze a pose once per animation frame; reuse for every vertex in that frame. */
+    evaluate(state?: MapState): Readonly<{
+        projectPoint: (position: GeographicPosition, regionId?: string) => {
+            regionId: string;
+            position: MapPosition3D;
+        };
+        projectPlacedPoint: (xy: GeographicPosition, regionId: string) => MapPosition3D | null;
+        projectLine: (line: readonly GeographicPosition[], options?: MapSamplingOptions) => {
+            coordinates: MapPosition3D[];
+            regionId: string;
+            sourceCoordinates: import("./math").Position[];
+        }[];
+        projectPolygon: (rings: readonly (readonly GeographicPosition[])[], options?: MapSamplingOptions) => {
+            coordinates: MapPosition3D[][];
+            regionId: string;
+            sourceCoordinates: import("./math").Position[][];
+        }[];
+    }>;
+    /** Prepare source-corresponding geometry for a direct morph or a globe route. */
+    createTransitionTo(target: MapEngine, options?: MapTransitionOptions): MapTransition;
+    /** Conservative recommendation, not a camera animation or a topology morph. */
+    planTransitionTo(target: MapEngine): MapTransitionPlan;
+}
+//# sourceMappingURL=map-engine.d.ts.map

package/dist/discontinuous/map-engine.d.ts.map

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