@walkthru-earth/objex 1.1.0 → 1.2.0

package/dist/storage/providers.js

@@ -266,6 +266,148 @@ export const PROVIDERS = {
         schemes: []
     }
 };
+export const CORS_HELP = {
+    s3: {
+        defaultEnabled: false,
+        docsUrl: 'https://docs.aws.amazon.com/AmazonS3/latest/userguide/enabling-cors-examples.html',
+        note: 'Enable via S3 Console: Bucket > Permissions > CORS, or use the AWS CLI.'
+    },
+    gcs: {
+        defaultEnabled: false,
+        docsUrl: 'https://cloud.google.com/storage/docs/using-cors',
+        note: 'CORS cannot be configured via the Cloud Console. Use the gcloud CLI.',
+        cliSteps: [
+            'Create a cors.json file:\n[\n  {\n    "origin": ["*"],\n    "method": ["GET", "HEAD"],\n    "responseHeader": [\n      "Content-Type",\n      "Content-Length",\n      "Content-Range",\n      "Accept-Ranges",\n      "ETag"\n    ],\n    "maxAgeSeconds": 3600\n  }\n]',
+            'gcloud storage buckets update gs://BUCKET --cors-file=cors.json'
+        ]
+    },
+    r2: {
+        defaultEnabled: false,
+        docsUrl: 'https://developers.cloudflare.com/r2/buckets/cors/',
+        note: 'Enable via R2 Dashboard: Bucket > Settings > CORS Policy.'
+    },
+    azure: {
+        defaultEnabled: false,
+        docsUrl: 'https://learn.microsoft.com/en-us/rest/api/storageservices/cross-origin-resource-sharing--cors--support-for-the-azure-storage-services',
+        note: 'Enable via Azure Portal: Storage Account > Blob Service > CORS, or use the Azure CLI.',
+        cliSteps: [
+            'az storage cors add --services b --methods GET HEAD \\\n  --origins "*" --allowed-headers "*" \\\n  --exposed-headers "*" --max-age 3600 \\\n  --account-name ACCOUNT'
+        ]
+    },
+    minio: {
+        defaultEnabled: true,
+        docsUrl: 'https://docs.min.io/enterprise/aistor-object-store/reference/cli/mc-cors/',
+        note: 'MinIO allows all origins by default. For custom rules, use mc cors set.'
+    },
+    storj: {
+        defaultEnabled: true,
+        note: 'Storj S3 gateway returns CORS headers by default.'
+    },
+    b2: {
+        defaultEnabled: false,
+        docsUrl: 'https://www.backblaze.com/docs/cloud-storage-cross-origin-resource-sharing-rules',
+        note: 'Enable via B2 Console: Bucket Settings > CORS Rules, or use the B2 CLI.',
+        cliSteps: [
+            'b2 bucket update --cors-rules \'[{\n  "corsRuleName": "allow-all",\n  "allowedOrigins": ["*"],\n  "allowedOperations": ["s3_head", "s3_get"],\n  "allowedHeaders": ["*"],\n  "maxAgeSeconds": 3600\n}]\' BUCKET allPublic'
+        ]
+    },
+    digitalocean: {
+        defaultEnabled: false,
+        docsUrl: 'https://docs.digitalocean.com/products/spaces/how-to/configure-cors/',
+        note: 'Enable via Control Panel: Space > Settings > CORS Configurations.'
+    },
+    wasabi: {
+        defaultEnabled: true,
+        docsUrl: 'https://docs.wasabi.com/docs/bucket-policy',
+        note: 'Wasabi returns CORS headers by default for all buckets.'
+    },
+    contabo: {
+        defaultEnabled: false,
+        note: 'S3-compatible CORS via the AWS CLI.',
+        cliSteps: [
+            'Create a cors.json file:\n{\n  "CORSRules": [{\n    "AllowedOrigins": ["*"],\n    "AllowedMethods": ["GET", "HEAD"],\n    "AllowedHeaders": ["*"],\n    "ExposeHeaders": ["ETag", "Content-Length", "Content-Type", "Content-Range", "Accept-Ranges"],\n    "MaxAgeSeconds": 3600\n  }]\n}',
+            'aws s3api put-bucket-cors --bucket BUCKET \\\n  --cors-configuration file://cors.json \\\n  --endpoint-url https://REGION.contaboobj.com'
+        ]
+    },
+    hetzner: {
+        defaultEnabled: false,
+        docsUrl: 'https://docs.hetzner.com/storage/object-storage/howto-protect-objects/cors/',
+        note: 'S3-compatible CORS via the AWS CLI.',
+        cliSteps: [
+            'Create a cors.json file:\n{\n  "CORSRules": [{\n    "AllowedOrigins": ["*"],\n    "AllowedMethods": ["GET", "HEAD"],\n    "AllowedHeaders": ["*"],\n    "ExposeHeaders": ["ETag", "Content-Length", "Content-Type", "Content-Range", "Accept-Ranges"],\n    "MaxAgeSeconds": 3600\n  }]\n}',
+            'aws s3api put-bucket-cors --bucket BUCKET \\\n  --cors-configuration file://cors.json \\\n  --endpoint-url https://REGION.your-objectstorage.com \\\n  --region REGION'
+        ]
+    },
+    linode: {
+        defaultEnabled: false,
+        docsUrl: 'https://www.linode.com/docs/guides/working-with-cors-linode-object-storage/',
+        note: 'S3-compatible CORS via the AWS CLI.',
+        cliSteps: [
+            'Create a cors.json file:\n{\n  "CORSRules": [{\n    "AllowedOrigins": ["*"],\n    "AllowedMethods": ["GET", "HEAD"],\n    "AllowedHeaders": ["*"],\n    "ExposeHeaders": ["ETag", "Content-Length", "Content-Type", "Content-Range", "Accept-Ranges"],\n    "MaxAgeSeconds": 3600\n  }]\n}',
+            'aws s3api put-bucket-cors --bucket BUCKET \\\n  --cors-configuration file://cors.json \\\n  --endpoint-url https://REGION.linodeobjects.com'
+        ]
+    },
+    ovhcloud: {
+        defaultEnabled: false,
+        docsUrl: 'https://help.ovhcloud.com/csm/en-public-cloud-storage-s3-cors?id=kb_article_view&sysparm_article=KB0058291',
+        note: 'S3-compatible CORS via the AWS CLI.',
+        cliSteps: [
+            'Create a cors.json file:\n{\n  "CORSRules": [{\n    "AllowedOrigins": ["*"],\n    "AllowedMethods": ["GET", "HEAD"],\n    "AllowedHeaders": ["*"],\n    "ExposeHeaders": ["ETag", "Content-Length", "Content-Type", "Content-Range", "Accept-Ranges"],\n    "MaxAgeSeconds": 3600\n  }]\n}',
+            'aws s3api put-bucket-cors --bucket BUCKET \\\n  --cors-configuration file://cors.json \\\n  --endpoint-url https://s3.REGION.io.cloud.ovh.net'
+        ]
+    }
+};
+export const READ_ONLY_HELP = {
+    s3: {
+        note: 'Use IAM policies to create a read-only user, or apply a bucket policy that allows only s3:GetObject and s3:ListBucket.',
+        docsUrl: 'https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-policies-s3.html'
+    },
+    gcs: {
+        note: 'Assign the Storage Object Viewer role (roles/storage.objectViewer) to the service account.',
+        docsUrl: 'https://cloud.google.com/storage/docs/access-control/iam-roles'
+    },
+    r2: {
+        note: 'Create an API token with Object Read permissions in the R2 dashboard.',
+        docsUrl: 'https://developers.cloudflare.com/r2/api/tokens/'
+    },
+    azure: {
+        note: 'Generate a SAS token with Read and List permissions only. Avoid granting Write or Delete.',
+        docsUrl: 'https://learn.microsoft.com/en-us/azure/storage/common/storage-sas-overview'
+    },
+    b2: {
+        note: 'Create an application key with readFiles and listBuckets capabilities only.',
+        docsUrl: 'https://www.backblaze.com/docs/cloud-storage-application-keys'
+    },
+    hetzner: {
+        note: 'Keys have full read/write by default. Use a bucket policy with the correct ARN format to deny write and policy actions. To undo, generate a new admin key from the Hetzner Console.',
+        docsUrl: 'https://docs.hetzner.com/storage/object-storage/faq/s3-credentials/#how-do-i-restrict-access-per-key',
+        cliSteps: [
+            'Find your project ID from the Hetzner Console URL:\nhttps://console.hetzner.com/projects/<PROJECT_ID>/servers',
+            'Create a policy.json file:\n{\n  "Version": "2012-10-17",\n  "Statement": [\n    {\n      "Sid": "DenyWrites",\n      "Effect": "Deny",\n      "Principal": {\n        "AWS": "arn:aws:iam:::user/p<PROJECT_ID>:<ACCESS_KEY>"\n      },\n      "Action": [\n        "s3:PutObject",\n        "s3:DeleteObject",\n        "s3:AbortMultipartUpload",\n        "s3:PutBucketPolicy",\n        "s3:DeleteBucketPolicy"\n      ],\n      "Resource": [\n        "arn:aws:s3:::BUCKET",\n        "arn:aws:s3:::BUCKET/*"\n      ]\n    }\n  ]\n}',
+            'aws s3api put-bucket-policy --bucket BUCKET \\\n  --policy file://policy.json \\\n  --endpoint-url https://REGION.your-objectstorage.com \\\n  --region REGION',
+            'Note: This key can no longer modify the policy.\nTo restore write access, generate a new key in the\nHetzner Console and use it to delete the policy.'
+        ]
+    },
+    minio: {
+        note: 'Create a read-only policy with mc admin policy, or use the built-in readonly canned policy.',
+        docsUrl: 'https://docs.min.io/enterprise/aistor-object-store/administration/iam/access/'
+    },
+    digitalocean: {
+        note: 'Spaces keys are project-wide. Use a bucket policy to restrict write actions for a specific key.',
+        docsUrl: 'https://docs.digitalocean.com/products/spaces/how-to/manage-access/'
+    },
+    wasabi: {
+        note: 'Create a sub-user with a read-only policy in the Wasabi Console.',
+        docsUrl: 'https://docs.wasabi.com/docs/creating-a-user-account-and-access-key'
+    },
+    contabo: {
+        note: 'S3-compatible bucket policies. Use a Deny policy for write actions with the key ARN.',
+        cliSteps: [
+            'Create a policy.json with a Deny statement for s3:PutObject and s3:DeleteObject.',
+            'aws s3api put-bucket-policy --bucket BUCKET \\\n  --policy file://policy.json \\\n  --endpoint-url https://REGION.contaboobj.com'
+        ]
+    }
+};
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -316,3 +458,21 @@ export function buildProviderBaseUrl(provider, endpoint, bucket, region) {
 export function isGcsProvider(provider, endpoint) {
     return provider === 'gcs' || (!!endpoint && /storage\.googleapis\.com/i.test(endpoint));
 }
+export function getAccessMode(conn) {
+    if (conn.provider === 'azure')
+        return 'sas-https';
+    // Anonymous buckets: every provider serves files over plain HTTPS without
+    // signing (AWS path/vhost, GCS, R2 public, Storj, Wasabi, DO, etc.).
+    if (conn.anonymous)
+        return 'public-https';
+    // Authenticated: needs SigV4 signing.
+    return 'signed-s3';
+}
+/**
+ * True when the connection's files can be fetched by any HTTP client
+ * (fetch/img/video/DuckDB httpfs/COG/Zarr/etc.) without the storage adapter.
+ */
+export function isPubliclyStreamable(conn) {
+    const mode = getAccessMode(conn);
+    return mode === 'public-https' || mode === 'sas-https';
+}

package/dist/stores/files.svelte.d.ts

@@ -1,6 +1,6 @@
 import type { FileEntry } from '../types.js';
 import { type SortConfig, type SortField } from '../utils/file-sort.js';
-export declare const fileStore: {
+export declare const files: {
     readonly entries: FileEntry[];
     readonly currentPath: string;
     readonly loading: boolean;
@@ -12,4 +12,3 @@ export declare const fileStore: {
     setError(message: string | null): void;
     sort(field: SortField): void;
 };
-export { fileStore as files };

package/dist/stores/files.svelte.js

@@ -40,5 +40,4 @@ function createFilesStore() {
         }
     };
 }
-export const fileStore = createFilesStore();
-export { fileStore as files };
+export const files = createFilesStore();

package/dist/stores/tabs.svelte.d.ts

@@ -1,5 +1,13 @@
 import type { Tab } from '../types.js';
-export declare const tabStore: {
+/**
+ * Tab-id for eagerly-opened direct-URL tabs (`source: 'url'`).
+ * The Sidebar's host-detection auto-migration closes an eager tab by its id
+ * and re-opens as a remote tab once a connection is available; the eager id
+ * is built in `+page.svelte::openUrlTab` and matched in `Sidebar.svelte::
+ * handleAutoDetection`, so both sides must agree on the format.
+ */
+export declare function eagerUrlTabId(url: string): string;
+export declare const tabs: {
     readonly items: Tab[];
     readonly activeTabId: string | null;
     readonly active: Tab | undefined;
@@ -14,4 +22,3 @@ export declare const tabStore: {
     setActive(id: string): void;
     update(id: string, partial: Partial<Omit<Tab, "id">>): void;
 };
-export { tabStore as tabs };

package/dist/stores/tabs.svelte.js

@@ -1,6 +1,16 @@
 import { tabResources } from './tab-resources.svelte.js';
 /** Maximum number of viewer instances kept alive (mounted but hidden). */
 const MAX_ALIVE = 5;
+/**
+ * Tab-id for eagerly-opened direct-URL tabs (`source: 'url'`).
+ * The Sidebar's host-detection auto-migration closes an eager tab by its id
+ * and re-opens as a remote tab once a connection is available; the eager id
+ * is built in `+page.svelte::openUrlTab` and matched in `Sidebar.svelte::
+ * handleAutoDetection`, so both sides must agree on the format.
+ */
+export function eagerUrlTabId(url) {
+    return `url:${url}`;
+}
 function releaseDuckDbMemory() {
     import('../query/index.js')
         .then(({ getQueryEngine }) => getQueryEngine().then((engine) => engine.releaseMemory()))
@@ -106,5 +116,4 @@ function createTabsStore() {
         }
     };
 }
-export const tabStore = createTabsStore();
-export { tabStore as tabs };
+export const tabs = createTabsStore();

package/dist/types.d.ts

@@ -38,6 +38,17 @@ export interface Tab {
     connectionId?: string;
     extension: string;
     size?: number;
+    /**
+     * When set, the tab reads data from a SQL FROM-clause target (e.g. an
+     * attached DuckLake/DuckDB/SQLite table) rather than a file URL. The ref
+     * is inserted directly into generated SQL, so it must be fully-qualified
+     * and pre-quoted, e.g. `__objex_db__."main"."air_quality"`.
+     *
+     * When `sourceRef` is set, file-specific loading paths (hyparquet
+     * metadata, `parquet_kv_metadata`, etc.) are skipped, and schema / CRS /
+     * row count are derived from the SQL source directly via DuckDB.
+     */
+    sourceRef?: string;
 }
 export interface WriteResult {
     key: string;

package/dist/utils/cog.d.ts

@@ -0,0 +1,244 @@
+import type { GetTileDataOptions, MinimalDataT } from '@developmentseed/deck.gl-geotiff';
+import type { RenderTileResult } from '@developmentseed/deck.gl-raster';
+import type { GeoTIFF as GeoTIFFType, Overview } from '@developmentseed/geotiff';
+import { GeoTIFF } from '@developmentseed/geotiff';
+import type { EpsgResolver } from '@developmentseed/proj';
+import type maplibregl from 'maplibre-gl';
+/** SampleFormat tag value → human label. */
+export declare const SF_LABELS: Record<number, string>;
+export type ColorRampId = 'grayscale' | 'terrain' | 'viridis' | 'magma' | 'turbo' | 'spectral';
+export declare const COLOR_RAMP_STOPS: Record<ColorRampId, [number, number, number][]>;
+/** Interpolate a normalized value (0..1) into an RGB color from a ramp. */
+export declare function interpolateRamp(stops: [number, number, number][], t: number): [number, number, number];
+/** Generate a CSS linear-gradient string for a color ramp. */
+export declare function rampToGradientCss(id: ColorRampId): string;
+export interface BandConfig {
+    mode: 'rgb' | 'single';
+    /** 0-indexed band indices for RGB channels */
+    rBand: number;
+    gBand: number;
+    bBand: number;
+    /** 0-indexed band index for single-band mode */
+    band: number;
+    colorRamp: ColorRampId;
+}
+/** Create a sensible default band config based on COG metadata. */
+export declare function defaultBandConfig(bandCount: number, sampleFormat: number): BandConfig;
+/** Check if the config matches the default for this COG (no user changes). */
+export declare function isDefaultBandConfig(config: BandConfig, bandCount: number, sampleFormat: number): boolean;
+export interface CogTagInfo {
+    /** TIFF SampleFormat[0] value. 1=uint, 2=int, 3=float. Defaults to 1 when absent. */
+    sampleFormat: number;
+    /** True when SampleFormat[0] === 1 (unsigned integer). */
+    isUint: boolean;
+    /**
+     * True when Photometric === 3 (Palette) and the ColorMap tag is present.
+     * These COGs should defer to the library's default Colormap GPU module,
+     * not our custom JS pipeline, so the embedded palette renders correctly.
+     */
+    isPaletteIndexed: boolean;
+}
+/**
+ * Inspect the TIFF tags that drive pipeline selection. Centralizes the
+ * Photometric.Palette === 3 magic number and the SampleFormat fallback in one
+ * place so viewers don't reimplement raw tag reads. Photometric values come
+ * from the @cogeotiff/core Photometric enum.
+ */
+export declare function inspectCogTags(geotiff: GeoTIFFType): CogTagInfo;
+/**
+ * Check if a given band config requires a custom pipeline (vs library default).
+ * Library default only works for uint with standard RGB band order, or for
+ * palette-indexed uint COGs where the embedded ColorMap tag auto-renders.
+ */
+export declare function needsCustomPipelineForConfig(geotiff: GeoTIFFType, config: BandConfig): boolean;
+/**
+ * Min/max rescale values applied via the `LinearRescale` shader module. Values
+ * are in normalized shader space [0, 1]. Default `{ min: 0, max: 1 }` is a
+ * no-op and the library-default pipeline is used as-is.
+ */
+export interface RescaleConfig {
+    min: number;
+    max: number;
+}
+export declare const DEFAULT_RESCALE: RescaleConfig;
+/** True when the rescale values would produce a visible change on the GPU. */
+export declare function isRescaleActive(cfg: RescaleConfig): boolean;
+/**
+ * Build a `getTileData` + `renderTile` pair that reuses the library-default
+ * uint pipeline (via `inferRenderPipeline`) and appends `LinearRescale` to the
+ * returned render pipeline. Only safe to use when the default pipeline would
+ * have been chosen anyway, i.e. `needsCustomPipelineForConfig(geotiff, cfg)`
+ * is false. For non-uint or custom band configs the custom JS pipeline already
+ * bakes RGBA in CPU and a GPU rescale would be cosmetic.
+ *
+ * `inferRenderPipeline` needs the GPU `Device` which arrives in the first
+ * tile's `GetTileDataOptions`, so the pipeline is built lazily on first call.
+ */
+export declare function createRescaledPipeline(geotiff: GeoTIFFType, rescale: RescaleConfig): {
+    getTileData: (image: GeoTIFFType | Overview, options: GetTileDataOptions) => Promise<MinimalDataT>;
+    renderTile: (data: MinimalDataT) => RenderTileResult;
+};
+/**
+ * Apply the two upstream-bug workarounds a GeoTIFF needs before being handed
+ * to `COGLayer`:
+ * 1. Strip oversized overviews (image smaller than tile size). These produce
+ *    out-of-domain proj4 NaN during pre-flight reprojection.
+ * 2. Clamp EPSG:4326 bbox to Web Mercator's safe range. Global 4326 COGs with
+ *    ±90° extents crash the tile matrix generator.
+ *
+ * Mutates the GeoTIFF in place. Safe to call repeatedly. Kept out of the
+ * Svelte component so MultiCOG/Mosaic can apply the same fix per sub-COG.
+ */
+export declare function normalizeCogGeotiff(geotiff: GeoTIFFType): void;
+/**
+ * Resolved COGLayer data props. Empty object means "library default pipeline".
+ * Spread into `new COGLayer({ ..., ...resolved })` to activate.
+ *
+ * COGLayer's data-prop types are a discriminated XOR and the four pipelines we
+ * dispatch to return different DataT shapes (`CustomTileData`, `MinimalDataT`).
+ * Typing this as `Record<string, any>` matches the `customProps` pattern
+ * already used at the COGLayer boundary and keeps the dispatch site simple.
+ */
+export type ResolvedCogPipeline = Record<string, any>;
+export interface SelectCogPipelineOptions {
+    /** Active band/color config, or null/undefined when not yet resolved. */
+    bandConfig?: BandConfig | null;
+    /** Linear rescale GPU module values. No-op when omitted or at defaults. */
+    rescale?: RescaleConfig;
+}
+/**
+ * Decide which getTileData/renderTile pair COGLayer should use for a GeoTIFF.
+ * Four outcomes, in priority order:
+ *
+ * 1. Custom configurable (band swap, color ramp) — when bandConfig is active
+ *    and needsCustomPipelineForConfig is true (non-uint, mode=single, or
+ *    non-standard RGB band order).
+ * 2. Custom non-uint (Int/Float source) — when no bandConfig yet but the
+ *    GeoTIFF itself forces custom handling.
+ * 3. Library default + LinearRescale — uint path is fine AND the user moved
+ *    the rescale slider away from defaults.
+ * 4. Library default — returns `{}`, caller spreads into COGLayer props.
+ *
+ * Pure dispatch. Kept separate from the Svelte component so MultiCOG/Mosaic
+ * viewers can call it per sub-COG without re-implementing the decision tree.
+ */
+export declare function selectCogPipeline(geotiff: GeoTIFFType, opts?: SelectCogPipelineOptions): ResolvedCogPipeline;
+export interface GeoBounds {
+    west: number;
+    south: number;
+    east: number;
+    north: number;
+}
+export interface CogInfo {
+    width: number;
+    height: number;
+    bandCount: number;
+    dataType: string;
+    bounds: GeoBounds;
+    downsampled?: boolean;
+}
+/** Safely clamp a number to a range, treating NaN/Infinity as the fallback. */
+export declare function safeClamp(v: number, lo: number, hi: number, fallback: number): number;
+/** Clamp geographic bounds to valid MapLibre web-Mercator range. */
+export declare function clampBounds(b: GeoBounds): GeoBounds;
+/**
+ * Build a data-type label from GeoTIFF sample format and bits per sample.
+ * e.g. "uint8", "float32", "int16"
+ */
+export declare function buildDataTypeLabel(sampleFormat: number, bitsPerSample: number): string;
+/**
+ * Query the GPU's MAX_TEXTURE_SIZE from MapLibre's WebGL context.
+ * Falls back to 4096 (lowest common denominator for mobile GPUs).
+ */
+export declare function getMaxTextureSize(map: maplibregl.Map): number;
+/**
+ * Fit the map to COG bounds with responsive padding.
+ * Uses smaller padding on mobile to zoom in closer, ensuring overviews load
+ * properly instead of appearing black at very low zoom levels.
+ * After fitting, bumps zoom +2 when the viewport settles at a very low level.
+ */
+export declare function fitCogBounds(map: maplibregl.Map, b: GeoBounds): void;
+/** Remove the native bitmap source/layer from the map (idempotent). */
+export declare function cleanupNativeBitmap(map: maplibregl.Map): void;
+/**
+ * Render a non-tiled GeoTIFF as a MapLibre native image source (bitmap).
+ * Opens the file with @developmentseed/geotiff, reads band 0, normalizes
+ * to grayscale RGBA, and adds to the map as a raster layer.
+ *
+ * Returns CogInfo for the metadata panel.
+ */
+export declare function renderNonTiledBitmap(options: {
+    url: string;
+    map: maplibregl.Map;
+    signal: AbortSignal;
+    geotiff?: GeoTIFF;
+}): Promise<CogInfo>;
+/** Result type returned by our custom getTileData. */
+export interface CustomTileData {
+    imageData: ImageData;
+    width: number;
+    height: number;
+}
+/**
+ * Check whether a GeoTIFF needs a custom render pipeline.
+ * v0.3's inferRenderPipeline only supports unsigned integers (SampleFormat 1).
+ * Signed int (2) and float (3) need custom getTileData/renderTile.
+ */
+export declare function needsCustomPipeline(geotiff: GeoTIFFType): boolean;
+/**
+ * Create custom getTileData for non-uint COGs.
+ * Reads band 0, normalizes using GDAL statistics / per-tile adaptive stretch,
+ * applies terrain color ramp for single-band data.
+ */
+export declare function createCustomGetTileData(geotiff: GeoTIFFType): (image: GeoTIFFType | Overview, options: {
+    x: number;
+    y: number;
+    pool: unknown;
+    signal?: AbortSignal;
+}) => Promise<CustomTileData>;
+/**
+ * Custom renderTile for non-uint COGs.
+ * v0.5 RasterLayer requires a RenderTileResult with `image` or `renderPipeline`.
+ * We produce an ImageData and pass it through the `image` slot. deck.gl manages
+ * the texture lifecycle and prepends a CreateTexture module automatically.
+ */
+export declare function customRenderTile(data: CustomTileData): {
+    image: ImageData;
+};
+/**
+ * Create a configurable getTileData that respects BandConfig.
+ * Supports both RGB mode (multi-band → R,G,B) and single-band mode (color ramp).
+ */
+export declare function createConfigurableGetTileData(geotiff: GeoTIFFType, config: BandConfig): (image: GeoTIFFType | Overview, options: {
+    x: number;
+    y: number;
+    pool: unknown;
+    signal?: AbortSignal;
+}) => Promise<CustomTileData>;
+export interface PixelValue {
+    lng: number;
+    lat: number;
+    values: number[];
+    row: number;
+    col: number;
+}
+/**
+ * Create an async EPSG resolver for `@developmentseed/deck.gl-geotiff`.
+ * Looks up the numeric EPSG code in the bundled WKT database and returns the
+ * `ProjectionDefinition` produced by `parseWkt`. Throws a clear error when the
+ * code is not present in the database.
+ */
+export declare function createEpsgResolver(): EpsgResolver;
+/**
+ * Resolve a proj4-compatible definition for a CRS read from a GeoTIFF.
+ * For numeric EPSG codes this returns the WKT string from the bundled EPSG
+ * database, which `proj4()` accepts directly. For ProjJSON it falls back to a
+ * JSON string. Returns null for EPSG:4326 (no conversion needed) or when the
+ * code is not present in the database.
+ */
+export declare function resolveProj4Def(crs: number | unknown, _signal: AbortSignal): Promise<string | null>;
+/**
+ * Read pixel values at a given lng/lat from a GeoTIFF.
+ * Converts WGS84 → source CRS → pixel coords, fetches the tile, reads all bands.
+ */
+export declare function readPixelAtLngLat(geotiff: GeoTIFFType, lng: number, lat: number, proj4Def: string | null, pool: any, signal?: AbortSignal): Promise<PixelValue | null>;