@fxi/zartigl 0.6.0 → 0.7.1

package/dist/projversor.d.ts

@@ -1,919 +0,0 @@
-import { GeoRawProjection } from 'd3';
-
-/** Interpolation state of the projection between two world projections. */
-declare interface Blend {
-    a: ProjectionDef;
-    b: ProjectionDef;
-    /** Fit scales (pixels per raw unit) of a and b. */
-    ka: number;
-    kb: number;
-    /** 0 = a, 1 = b. */
-    t: number;
-}
-
-declare interface CatalogEntry {
-    id: string;
-    aliases?: string[];
-    title: LocalizedText;
-    description?: LocalizedText;
-    category: string;
-    tags?: string[];
-    kind: "scalar" | "vector";
-    sources: CatalogSource[];
-    defaults: {
-        sourceId: string;
-        querySourceId?: string;
-        palette?: string;
-        renderMode?: "particles" | "raster" | "raster+particles";
-        particles?: {
-            density?: number;
-            speed?: number;
-            fade?: number;
-        };
-        raster?: {
-            opacity?: number;
-            logScale?: boolean;
-            vibrance?: number;
-            colorDomain?: [number, number];
-        };
-    };
-}
-
-/**
- * An incremental archive of calendar-aligned artifacts listed by a mutable
- * index; zartigl resolves it to the chunk covering the requested time.
- */
-declare interface CatalogGeoVideoArchiveSource extends CatalogSourceBase {
-    type: "geovideo";
-    indexUrl: string;
-    manifestUrl?: never;
-}
-
-/** One published artifact. */
-declare interface CatalogGeoVideoSource extends CatalogSourceBase {
-    type: "geovideo";
-    manifestUrl: string;
-    indexUrl?: never;
-}
-
-declare type CatalogSource = CatalogZarrSource | CatalogWmtsSource | CatalogGeoVideoSource | CatalogGeoVideoArchiveSource;
-
-declare interface CatalogSourceBase {
-    id: string;
-    title: LocalizedText;
-    provenance?: CatalogSourceProvenance;
-    temporal?: CatalogTemporalSummary;
-}
-
-declare interface CatalogSourceProvenance {
-    provider: string;
-    identifiers?: Record<string, string>;
-}
-
-declare interface CatalogTemporalSummary {
-    cadence?: string;
-    mode: "historical" | "near-real-time" | "analysis-forecast" | "fixed";
-    start?: string;
-    end?: string;
-}
-
-declare type CatalogVariables = {
-    kind: "scalar";
-    value: string;
-} | {
-    kind: "vector";
-    u?: string;
-    v?: string;
-    derivation?: CatalogVectorDerivation;
-};
-
-declare interface CatalogVectorDerivation {
-    kind: "direction_magnitude";
-    direction_variable: string;
-    magnitude_variable: string;
-    direction_convention: "from" | "toward";
-    output_direction: "from" | "toward";
-}
-
-declare interface CatalogWmtsSource extends CatalogSourceBase {
-    type: "wmts";
-    capabilitiesUrl: string;
-    baseUrl?: string;
-    layer: string;
-    tileMatrixSet?: string;
-    format?: string;
-    style?: string;
-    tileUrlTemplate?: string;
-}
-
-declare interface CatalogZarrSource extends CatalogSourceBase {
-    type: "zarr";
-    endpoints: {
-        field: string;
-        pointSeries?: string;
-    };
-    variables: CatalogVariables;
-}
-
-/**
- * Chunk picker label, as short as a month one: "Sep ’26" for a chunk of a
- * month at most, else the years its samples cover, "’20–’26".
- */
-export declare function chunkLabel(start?: string, end?: string): string;
-
-export declare function clampZoom(zoom: number): number;
-
-/**
- * Optional color grade applied when particle trails are composited
- * (`shaders/color-grade.glsl`): more intense highlights, deeper shadows and
- * richer colors, without hard clipping. Off by default; when off, the
- * composite returns the trail colors unchanged.
- */
-declare interface ColorGrade {
-    enabled: boolean;
-    /** Mid-tone lift [0, 4]; 0 keeps the tones. */
-    exposure: number;
-    /** S-curve strength [0, 1]. */
-    contrast: number;
-    /** Vibrance-weighted saturation [-1, 1]. */
-    saturation: number;
-    /** Push of the bright half toward white [0, 1]. */
-    highlights: number;
-}
-
-/**
- * Valid fields of a hash written by {@link encodeShare}; the caller checks the
- * layer, preset and palette ids and the speed against its choices.
- */
-export declare function decodeShare(hash: string): Partial<ShareState>;
-
-/** Readable url hash, without the leading "#". */
-export declare function encodeShare(state: ShareState): string;
-
-/** Layer of a share key: a layer id, or the entry id older links carry. */
-export declare function findLayer(key: string | undefined, layers?: readonly ProjversorLayer[]): ProjversorLayer | undefined;
-
-export declare function findPreset(id: string | undefined): Preset | undefined;
-
-/** "m s-1" → "m/s", "degrees_C" → "°C". */
-export declare function formatUnit(unit: string | undefined): string;
-
-declare type GeoVideoBounds = [
-west: number,
-south: number,
-east: number,
-north: number
-];
-
-/**
- * GeoVideo frames as float textures, decoded ahead of the playhead: vector
- * frames as (u, v, validity, 0), scalar frames as (value, validity). Binds
- * two consecutive time steps and their mix under VELOCITY_UNIFORMS for a
- * vector field, TINT_UNIFORMS for a scalar one.
- */
-export declare class GeoVideoField {
-    private readonly gl;
-    readonly manifest: GeoVideoManifest;
-    readonly times: number[];
-    readonly bounds: GeoVideoBounds;
-    private readonly source;
-    private readonly texels;
-    /** 4 for vector texels, 2 for scalar ones. */
-    private readonly channels;
-    private readonly uniforms;
-    private readonly textures;
-    private readonly pending;
-    private pair;
-    private destroyed;
-    constructor(gl: WebGL2RenderingContext, manifest: GeoVideoManifest);
-    /** Vector field (particles); false for a scalar one (raster or tint). */
-    get vector(): boolean;
-    /** Fixed catalog color domain of a scalar field. */
-    get domain(): [number, number];
-    /** Top of the color ramp and of the particle speed normalization. */
-    get maxSpeed(): number;
-    /** Resolves once the step at `ms` is uploaded. */
-    prime(ms: number): Promise<void>;
-    /** True once the frames interpolated at `ms` are uploaded. */
-    ready(ms: number): boolean;
-    /**
-     * Latest wins while scrubbing: drop queued decodes outside the frames at
-     * `ms`, then request those first.
-     */
-    focus(ms: number): void;
-    /** False until a first frame is available. */
-    bind(program: Program, ms: number, unit?: number): boolean;
-    destroy(): void;
-    private request;
-    private upload;
-    /** Keep a small window around the playhead. */
-    private evict;
-}
-
-declare interface GeoVideoManifest {
-    schemaVersion: 3;
-    id: string;
-    type: "geovideo";
-    projection: "equirectangular";
-    bounds: GeoVideoBounds;
-    media: {
-        url: string;
-        mimeType: "video/mp4" | string;
-        width: number;
-        height: number;
-        fps: number;
-        durationSeconds: number;
-        codec: "h264" | string;
-    };
-    encoding: GeoVideoScalarEncoding | GeoVideoVectorEncoding;
-    mask: {
-        kind: "static-validity";
-        url: string;
-        mimeType: "image/png" | string;
-        width: number;
-        height: number;
-        threshold: number;
-    };
-    timeline: GeoVideoRangeTimeline | GeoVideoSnapshotLoopTimeline | GeoVideoSampleSequenceTimeline;
-    provenance: {
-        catalogEntryId: string;
-        inputSourceId: string;
-        provider?: string;
-        identifiers?: Record<string, string>;
-        variables: string[];
-        generatedAt: string;
-    };
-    style: {
-        palette: string;
-        colorDomain: [number, number];
-        unit?: string;
-        logScale?: boolean;
-        vibrance?: number;
-    };
-}
-
-declare interface GeoVideoRangeTimeline {
-    kind: "range";
-    dateStart: string;
-    dateEnd: string;
-    interpolation: "linear" | "nearest";
-}
-
-declare interface GeoVideoSampleSequenceTimeline {
-    kind: "sample-sequence";
-    values: string[];
-}
-
-declare interface GeoVideoScalarEncoding {
-    kind: "scalar-luma";
-    bits: 8;
-    codeMin: number;
-    codeMax: number;
-    valueMin: number;
-    valueMax: number;
-    transfer: "linear";
-    colorSpace: "bt709";
-    colorRange: "limited" | "full";
-}
-
-declare interface GeoVideoSnapshotLoopTimeline {
-    kind: "snapshot-loop";
-    date: string;
-}
-
-/**
- * u and v stacked vertically in luma (u rows on top). Each component maps
- * [-valueDomain, valueDomain] to [codeMin, codeMax]; "sqrt" stores
- * sign(x)·sqrt(|x|/valueDomain) to keep precision on slow flows. The static
- * mask covers one component (media height / 2).
- */
-declare interface GeoVideoVectorEncoding {
-    kind: "vector-luma";
-    bits: 8;
-    codeMin: number;
-    codeMax: number;
-    valueDomain: number;
-    transfer: "linear" | "sqrt";
-    layout: "stacked-uv";
-    colorSpace: "bt709";
-    colorRange: "limited" | "full";
-}
-
-/** Margins of the free zone the sphere is centered and fitted in, css px. */
-export declare interface Inset {
-    top: number;
-    right: number;
-    bottom: number;
-    left: number;
-}
-
-export declare function isTintEntry(id: string | undefined): id is string;
-
-export declare function layerPalettes(layer: ProjversorLayer): PaletteMeta[];
-
-declare interface LegendField {
-    readonly vector: boolean;
-    readonly domain: [number, number];
-    readonly maxSpeed: number;
-    readonly manifest: {
-        style: {
-            unit?: string;
-        };
-    };
-}
-
-/**
- * Legend ends rounded to the precision of their range (about a hundredth of
- * it), so a domain of 0.00000537–0.665 reads "0" and "0.67".
- */
-export declare function legendLabels(min: number, max: number, locale?: string): [string, string];
-
-/** The colored quantity of a month: its range, unit and ramp. */
-export declare interface LegendScale {
-    min: number;
-    max: number;
-    unit: string;
-    /** Linear over a scalar domain; square root over a particle speed. */
-    ramp: "linear" | "sqrt";
-}
-
-/** Rounded legend values spread evenly along a square-root ramp. */
-export declare function legendTicks(max: number): number[];
-
-/**
- * Round values (1, 2, 2.5 or 5 × 10ⁿ apart, about five intervals) within
- * [min, max], with their linear position on the ramp.
- */
-export declare function linearTicks(min: number, max: number): {
-    value: number;
-    position: number;
-}[];
-
-declare type LocalizedText = Record<string, string>;
-
-/** Column-major 3×3, as WebGL uniformMatrix3fv expects. */
-declare type Mat3 = [
-number,
-number,
-number,
-number,
-number,
-number,
-number,
-number,
-number
-];
-
-/**
- * What the colors of a month mean: the raster of a scalar layer, else the
- * tint coloring the particles, over its domain; else the particle speed.
- */
-export declare function monthLegend(month: {
-    field: LegendField;
-    tint: LegendField | null;
-}): LegendScale;
-
-export declare const NO_INSET: Inset;
-
-/** Wrap degrees into [-180, 180). */
-export declare function normalizeBearing(deg: number): number;
-
-declare interface PaletteMeta {
-    id: string;
-    label: string;
-    tags: string[];
-    colors: string[];
-}
-
-/** Validate a view's config against the projversor layers and presets. */
-export declare function parseProjversorView(view: ProjversorViewDefinition): ProjversorViewConfig;
-
-/** zartigl particle settings, as in catalog `defaults.particles`. */
-declare interface ParticleSettings {
-    /** Particles per device pixel. */
-    density: number;
-    /** Css px per frame at the top of the speed range. */
-    speed: number;
-    /** Trail length, 0–1 (20 to 600 frames). */
-    fade: number;
-}
-
-/**
- * Playhead date and hour on a timeline stepping `stepMs`: the hour only
- * below daily steps (else ""), the day only below monthly ones.
- */
-export declare function playheadLabel(ms: number, stepMs: number): {
-    date: string;
-    hour: string;
-};
-
-/** Screen angle of (x, y) around (cx, cy), clockwise from up, in degrees. */
-export declare function pointerBearing(cx: number, cy: number, x: number, y: number): number;
-
-/** A named projection with its default rotation and zoom. */
-export declare interface Preset {
-    id: string;
-    label: string;
-    projection: ProjectionId;
-    rotate: [number, number, number];
-    zoom: number;
-}
-
-export declare const PRESETS: Preset[];
-
-/** WebGL2 program with cached uniform locations. */
-declare class Program {
-    readonly gl: WebGL2RenderingContext;
-    readonly program: WebGLProgram;
-    private readonly locations;
-    constructor(gl: WebGL2RenderingContext, vert: string, frag: string);
-    use(): this;
-    private loc;
-    int(name: string, v: number): void;
-    uint(name: string, v: number): void;
-    float(name: string, v: number): void;
-    vec2(name: string, x: number, y: number): void;
-    vec4(name: string, v: readonly number[]): void;
-    mat3(name: string, m: Mat3): void;
-    texture(name: string, unit: number, texture: WebGLTexture, target?: number): void;
-    /** Uniforms of shaders/project.glsl. */
-    projection(frame: ViewFrame): void;
-    delete(): void;
-}
-
-declare interface ProjectionDef {
-    id: ProjectionId;
-    label: string;
-    glslId: number;
-    raw: GeoRawProjection;
-    /** Half width and half height of the world outline, in raw units. */
-    extent: [number, number];
-    /** Hemisphere-limited projections clip at this angle (degrees). */
-    clipAngle: number;
-    /** Azimuthal projections are cut around the antipode, not along a meridian. */
-    azimuthal: boolean;
-}
-
-/**
- * World projections shared by d3 (overlay) and GLSL (raster, particles).
- * Each raw formula has a twin in shaders/project.glsl keyed by `glslId`;
- * both sides must stay identical or the coastlines drift off the raster.
- */
-export declare type ProjectionId = "equirectangular" | "equalEarth" | "mollweide" | "azimuthalEqualArea" | "azimuthalEquidistant" | "orthographic";
-
-export declare const PROJECTIONS: Record<ProjectionId, ProjectionDef>;
-
-/**
- * GeoVideo archives on a sphere that morphs between projections: particles
- * for vector layers, a raster for scalar ones. Owns the GL context, the
- * frame loop, archive loading and the view; controls stay with the caller.
- */
-export declare class Projversor {
-    private readonly canvases;
-    private readonly gl;
-    private readonly particles;
-    private readonly raster;
-    private readonly overlay;
-    private readonly trailFade;
-    private readonly listeners;
-    private readonly resizer;
-    private frameId;
-    private destroyed;
-    /** Drop-rate boost after a view change, and the view it was measured on. */
-    private redistribution;
-    private lastScale;
-    private lastCenter;
-    /** Frames left to animate while paused. */
-    private settle;
-    private north;
-    private readonly speeds;
-    private paletteId;
-    private ramp;
-    private gradeValue;
-    private layerValue;
-    private opened;
-    private presetValue;
-    private rasterOpacity;
-    private rasterVibrance;
-    private field;
-    private tint;
-    private tintIdValue;
-    private tintChunks;
-    private chunksValue;
-    private chunkIndexValue;
-    private particleSettings;
-    private upcoming;
-    /** Bumped on every layer or month switch; stale loads drop out. */
-    private loadId;
-    private readonly view;
-    private dpr;
-    private ms;
-    private playingValue;
-    private held;
-    private pendingRespawn;
-    private overlayKey;
-    private lastMove;
-    private detailed;
-    private last;
-    private insetTransition;
-    private transition;
-    private drag;
-    constructor(canvases: ProjversorCanvases, initial?: Partial<ShareState>);
-    /** Listen to an event; returns the unsubscribe function. */
-    on<K extends keyof ProjversorEvents>(type: K, listener: (detail: ProjversorEvents[K]) => void): () => void;
-    private emit;
-    get layer(): ProjversorLayer;
-    /** Scalar entry id coloring the particles, or null. */
-    get tintId(): string | null;
-    get palette(): string;
-    get grade(): ColorGrade;
-    get preset(): Preset;
-    get playing(): boolean;
-    /** Playback speed multiplier of the open layer. */
-    get speed(): number;
-    /** Month chunks of the open layer and the displayed one. */
-    get chunks(): readonly CatalogGeoVideoSource[];
-    get chunkIndex(): number;
-    /** Playhead, epoch ms. */
-    get time(): number;
-    /** Frame times of the displayed month. */
-    get times(): readonly number[];
-    /** Playhead position in the displayed month, 0–1. */
-    get progress(): number;
-    get rotate(): Rotate;
-    get zoom(): number;
-    get bearing(): number;
-    /** Drags keep north up (gamma 0), as d3-geo-zoom's northUp. */
-    get northLocked(): boolean;
-    set northLocked(locked: boolean);
-    /** Everything needed to reproduce the displayed view. */
-    getState(): ShareState;
-    /**
-     * Show a state: unknown ids fall back to the layer's own choices. The
-     * layer reopens only when it or its tint changes. A view in the state
-     * keeps its own framing, else a regional layer is framed.
-     */
-    apply(state: Partial<ShareState>, options?: {
-        animate?: boolean;
-        durationMs?: number;
-    }): Promise<void>;
-    /**
-     * Switch layer, opening the month that holds `at`, else the displayed
-     * month when the archive has it, else the latest. Palette and tint default
-     * to the layer's own; `frame` centers the view on a regional layer.
-     */
-    open(layerOrId: ProjversorLayer | string, options?: {
-        at?: number;
-        palette?: string;
-        tint?: string | null;
-        /** Playback speed, applied with the layer when it is one of its kind. */
-        speed?: number;
-        frame?: boolean;
-    }): Promise<void>;
-    /** Open month `index` of the open layer at its start. */
-    openMonth(index: number): Promise<void>;
-    /** Move the playhead, opening the month that holds `ms` when needed. */
-    seek(ms: number): Promise<void>;
-    /** Move the playhead within the displayed month. */
-    scrub(ms: number): void;
-    /**
-     * Warm the HTTP cache with a layer's index and the manifest of the month
-     * holding `at`, so a later {@link open} starts sooner.
-     */
-    preload(layerId: string, at?: number): Promise<void>;
-    /** Open a month at `at`, or at its start. */
-    private openChunk;
-    /**
-     * Field of a month and, when a tint is chosen, the tint for the same
-     * month. A missing or unreadable tint falls back to speed colors.
-     */
-    private loadMonth;
-    /** Manifest and first decoded frame (at `at`, else the start) of a month. */
-    private loadField;
-    private adopt;
-    /**
-     * Decode the next month in the background so playback runs through the
-     * whole archive like a film, wrapping to the first month after the last.
-     */
-    private prefetchNext;
-    private dropUpcoming;
-    /** Recolor the particles or the raster. */
-    setPalette(id: string): void;
-    /** Particle color grade, applied when the trails are composited. */
-    setGrade(grade: ColorGrade): void;
-    /** Set a kind's speed when it is one of that kind's {@link SPEEDS}. */
-    private setKindSpeed;
-    /** Playback speed multiplier of the open layer's kind. */
-    setSpeed(speed: number): void;
-    setPlaying(playing: boolean): void;
-    /** Hold playback, e.g. while a timeline thumb is held. */
-    setHeld(held: boolean): void;
-    private setStatus;
-    /**
-     * Morph to a preset (with its own rotation and zoom unless given), or
-     * ease rotation and zoom alone.
-     */
-    goTo(target: ProjversorViewTarget): void;
-    /** Show a preset, rotation and zoom at once. */
-    jumpTo(target: ProjversorViewTarget): void;
-    private morph;
-    private setPreset;
-    /**
-     * Ease rotation and zoom from the current view; repeated calls chain from
-     * the previous target. Waits out a projection morph.
-     */
-    easeTo(rotate: Rotate, zoom: number, duration?: number): void;
-    zoomBy(factor: number): void;
-    /** Spin the globe around its axis; positive moves the map content right. */
-    rotateBy(deg: number): void;
-    /** Rotate the map around the view center; frees the bearing. */
-    setBearing(deg: number): void;
-    /** Free the bearing, or ease back to north up and lock it. */
-    toggleNorth(): void;
-    /** Where the running view easing ends, else the current view. */
-    target(): {
-        rotate: Rotate;
-        zoom: number;
-    };
-    /** Lock north up for a near-zero bearing, and snap it to zero. */
-    private lockNorth;
-    /**
-     * Ease the free zone to `inset` (at once for a zero duration); the sphere
-     * slides and refits with it.
-     */
-    setInset(inset: Inset, durationMs?: number): void;
-    /** Free zone, css px. */
-    get inset(): Inset;
-    /**
-     * Screen direction of north at the center of the free zone, degrees
-     * clockwise from up; null near a pole, where it has none.
-     */
-    northAngle(): number | null;
-    /**
-     * Outline of the projected sphere, css px: the globe limb, or the edge of
-     * a world map. The largest ring when the projection splits it.
-     */
-    outline(): [number, number][];
-    /** Fit scales of both blended projections to the free zone. */
-    private refit;
-    private animateInset;
-    private animate;
-    private resize;
-    /**
-     * Versor drag, pinch and wheel zoom on the front canvas; the stage gets
-     * the `dragging` class during a drag. Returns the detach function.
-     */
-    attachInteraction(): () => void;
-    private invert;
-    /** Playing and not held. */
-    private get advancing();
-    private tick;
-    /** Trail length in frames, capped: how long a paused view keeps animating. */
-    private settleFrames;
-    /** Clear the GL canvas, then draw the open field as particles or a raster. */
-    private drawField;
-    /**
-     * zartigl's particle pipeline: advect, fade the trails, draw the new
-     * segments, composite. While paused, particles only animate for a while
-     * after a change, to rebuild trails, then the image holds.
-     */
-    private drawParticles;
-    /** zartigl's drop-rate boost, from the per-frame zoom and center change. */
-    private redistribute;
-    /** Coastlines and graticule: coarse while the view moves, then detailed. */
-    private drawOverlay;
-    private advanceTime;
-    /** Stop the frame loop and free GL resources and listeners. */
-    destroy(): void;
-}
-
-export declare const PROJVERSOR_LAYERS: ProjversorLayer[];
-
-/** The stage and its three stacked canvases: land below, GL, lines above. */
-export declare interface ProjversorCanvases {
-    stage: HTMLElement;
-    back: HTMLCanvasElement;
-    gl: HTMLCanvasElement;
-    front: HTMLCanvasElement;
-}
-
-/** Events and their payloads. */
-export declare interface ProjversorEvents {
-    status: string;
-    /** A layer was chosen; its month chunks are known, not yet decoded. */
-    layer: ProjversorLayer;
-    /** A month was decoded and is displayed. */
-    month: ProjversorMonth;
-    palette: string;
-    playing: boolean;
-    preset: Preset;
-    north: boolean;
-    /** After each drawn frame. */
-    frame: undefined;
-}
-
-/**
- * A catalog entry with a GeoVideo archive, with the styling this projversor
- * renderer gives it: vector entries play as particles, scalar ones as a raster.
- */
-export declare interface ProjversorLayer {
-    /** Picker and share key: the entry's first alias, else its id. */
-    id: string;
-    /** zartigl catalog entry id. */
-    entryId: string;
-    kind: CatalogEntry["kind"];
-    label: string;
-    palette: string;
-    /** Draw land opaque: off for fields that also cover land. */
-    fillLand: boolean;
-    /** Overrides of the catalog entry `defaults.particles` (density, speed, fade). */
-    particles?: Partial<ParticleSettings>;
-    /**
-     * Default scalar entry id whose GeoVideo archive colors the particles (over
-     * its catalog color domain); speed then sets their brightness. Its monthly
-     * chunks pair with the vector ones by calendar period.
-     */
-    tint?: string;
-}
-
-/** The fields of one month: the layer field and its optional tint. */
-export declare interface ProjversorMonth {
-    field: GeoVideoField;
-    tint: GeoVideoField | null;
-}
-
-/** The projversor state a view config shows. */
-export declare function projversorState(config: ProjversorViewConfig): Partial<ShareState>;
-
-/**
- * Story view on one persistent projversor: each scene morphs the view from
- * the previous one, and the layer reopens only when it changes.
- */
-export declare class ProjversorStoryView {
-    private readonly projversor;
-    private readonly animate;
-    private readonly onError;
-    /**
-     * @param animate Morph between views; off for still frames and reduced
-     *   motion, where each view is shown at once.
-     * @param onError Reports a failed time seek.
-     */
-    constructor(projversor: Projversor, animate?: boolean, onError?: (error: unknown) => void);
-    activate(view: ProjversorViewDefinition): Promise<void>;
-    /** Warm the cache for a view shown next. */
-    preload(view: ProjversorViewDefinition): Promise<void>;
-    play(): void;
-    pause(): void;
-    setTime(time: number): void;
-    destroy(): void;
-}
-
-/** `config` of a `projversor` view, validated by {@link parseProjversorView}. */
-export declare interface ProjversorViewConfig {
-    /** projversor layer id (catalog alias, or a tinted pairing id). */
-    layer: string;
-    preset: string;
-    rotate?: [number, number, number];
-    zoom?: number;
-    palette?: string;
-    /** Scalar entry id coloring the particles; "" colors them by speed. */
-    tint?: string;
-    speed?: number;
-    /** ISO date of the playhead; the latest month when omitted. */
-    time?: string;
-    /** Projection morph duration from the previous scene. */
-    transitionMs?: number;
-    /** Vibrant particle color grade. */
-    vibrant?: boolean;
-    /** Side layouts: the paragraph follows the globe limb. */
-    wrap?: boolean;
-}
-
-/**
- * A story view, as `@fxi/zartigl/story` defines it. Declared here so this
- * entry stays independent: the adapter fits the story registry structurally.
- */
-export declare interface ProjversorViewDefinition {
-    id: string;
-    config: Record<string, unknown>;
-}
-
-/** View target: a preset morphs, rotate and zoom alone ease. */
-export declare interface ProjversorViewTarget {
-    preset?: string;
-    rotate?: Rotate;
-    zoom?: number;
-    /** Free zone the sphere is centered and fitted in; eases with the view. */
-    inset?: Inset;
-    durationMs?: number;
-}
-
-/**
- * Css gradient of a palette, bottom to top. Stops are sorted numerically:
- * integer-like keys ("0", "1") would otherwise enumerate first and scramble
- * the gradient.
- */
-export declare function rampGradient(palette: string): string;
-
-/** Position on the ramp of a value; the shaders color by sqrt(value / max). */
-export declare function rampPosition(value: number, max: number): number;
-
-declare type Rotate = [number, number, number];
-
-/**
- * Screen direction of north at css point `at`, in degrees clockwise from
- * up: the angle toward a point just north of it. Unlike the rotation's
- * bearing, it holds on any projection, tilted or not. Null off the map and
- * near a pole, where every direction is north (or south).
- */
-export declare function screenNorth(projection: ScreenProjection, at: [number, number]): number | null;
-
-/** A projection from [lon, lat] to css px, with its inverse. */
-export declare interface ScreenProjection {
-    (point: [number, number]): [number, number] | null;
-    invert?(point: [number, number]): [number, number] | null;
-}
-
-/** Everything needed to reproduce the displayed view. */
-export declare interface ShareState {
-    /** zartigl catalog entry id. */
-    layer: string;
-    /** Playhead, epoch ms. */
-    time: number;
-    /** Projection preset id. */
-    preset: string;
-    rotate: [number, number, number];
-    zoom: number;
-    playing: boolean;
-    /** Playback speed multiplier. */
-    speed: number;
-    /** Palette id. */
-    palette: string;
-    /** Scalar entry id coloring the particles; "" colors them by speed. */
-    tint: string;
-    /** Particle color grade; written only when enabled. */
-    grade?: ColorGrade;
-}
-
-/**
- * Playback speeds and defaults per layer kind: particles need slow steps to
- * keep stable trails, while a raster only shows change when played faster.
- */
-export declare const SPEEDS: Record<ProjversorLayer["kind"], number[]>;
-
-export declare interface TimeTick {
-    label: string;
-    position: number;
-    major: boolean;
-}
-
-/**
- * UTC marks as positions along [first, last], at a unit fitting the span:
- * days (the 1st and every 5th major) up to two months, months (quarters
- * major, January labelled with its year) up to two and a half years, else
- * years (every one major, every 5th past twelve years).
- */
-export declare function timeTicks(first: number, last: number): TimeTick[];
-
-/** Scalar layers offered to color the particles. */
-export declare const TINT_LAYERS: ProjversorLayer[];
-
-/** Projection morph duration. */
-export declare const TRANSITION_MS = 2200;
-
-/** Everything that places the sphere on screen. */
-declare interface View {
-    blend: Blend;
-    /** d3 rotate([λ, φ, γ]) in degrees. */
-    rotate: [number, number, number];
-    zoom: number;
-    /** Css px. */
-    width: number;
-    height: number;
-    /** Free zone; the whole viewport when omitted. */
-    inset?: Inset;
-}
-
-/** Easing of compass, zoom and rotate controls. */
-export declare const VIEW_MS = 450;
-
-/** The free zone: its center and size in css px, at least 1 px wide. */
-export declare function viewArea(view: View): {
-    cx: number;
-    cy: number;
-    width: number;
-    height: number;
-};
-
-/** Values derived once per frame from a View, shared by every pass. */
-declare interface ViewFrame extends View {
-    /** Clip angle in degrees; 180 = antimeridian cut only. */
-    clipAngle: number;
-    /** Geographic → rotated frame, and its inverse. */
-    rot: Mat3;
-    rotInv: Mat3;
-    /** Approximate px per radian at the projection center. */
-    pxPerRadian: number;
-}
-
-export { }