@walkthru-earth/objex 1.2.0 → 1.3.0

package/dist/components/viewers/ZarrMapViewer.svelte

@@ -1,15 +1,20 @@
 <script lang="ts">
+import { MapboxOverlay } from '@deck.gl/mapbox';
 import type maplibregl from 'maplibre-gl';
 import maplibreModule from 'maplibre-gl';
 import { onDestroy, untrack } from 'svelte';
 import { t } from '../../i18n/index.svelte.js';
 import { tabResources } from '../../stores/tab-resources.svelte.js';
-import type { Tab } from '../../types';
-import { buildHttpsUrl } from '../../utils/url.js';
+import type { Tab } from '../../types.js';
+import { createEpsgResolver } from '../../utils/cog.js';
+import { buildHttpsUrlAsync } from '../../utils/url.js';
 import {
+	detectGeoZarr,
 	ensureCodecsRegistered,
 	extractZarrStoreUrl,
+	type GeoZarrInfo,
 	inferDims,
+	type ZarrHierarchy,
 	type ZarrNode
 } from '../../utils/zarr.js';
 import MapContainer from './map/MapContainer.svelte';
@@ -40,21 +45,40 @@ let {
 	variables,
 	coords = [],
 	spatialRefAttrs,
-	zarrVersion = null
+	zarrVersion = null,
+	hierarchy = null
 }: {
 	tab: Tab;
 	variables: ZarrNode[];
 	coords?: ZarrNode[];
 	spatialRefAttrs: Record<string, any> | null;
 	zarrVersion?: number | null;
+	/**
+	 * Full pre-loaded hierarchy. When present, `detectGeoZarr` can short-circuit
+	 * to the `@developmentseed/deck.gl-zarr` path for GeoZarr-valid stores.
+	 * Non-GeoZarr stores fall through to `@carbonplan/zarr-layer`.
+	 */
+	hierarchy?: ZarrHierarchy | null;
 } = $props();
 
+// GeoZarr detection runs once per hierarchy so the branch decision is stable
+// across selector-slider tweaks. Returns null for non-GeoZarr stores, which
+// sends everything through the existing carbonplan path.
+const geoZarrInfo = $derived<GeoZarrInfo | null>(hierarchy ? detectGeoZarr(hierarchy) : null);
+
+// MapboxOverlay holder for the deck.gl-zarr path. Separate from zarrLayer so
+// the two paths can be cleaned up independently.
+let dsZarrOverlay: MapboxOverlay | null = null;
+const dsZarrEpsg = createEpsgResolver();
+
 let loading = $state(true);
 let error = $state<string | null>(null);
 let selectedVar = $state('');
 let zarrLayer: any = null;
 let mapRef: maplibregl.Map | null = null;
 let inspectPopup: maplibregl.Popup | null = null;
+let loadGen = 0;
+let addAbort = new AbortController();
 
 // Extract proj4 from spatial_ref if available
 const proj4String = $derived(extractProj4(spatialRefAttrs));
@@ -359,20 +383,39 @@ async function onMapReady(map: maplibregl.Map) {
 }
 
 async function addZarrLayer(map: maplibregl.Map) {
+	addAbort.abort();
+	addAbort = new AbortController();
+	const signal = addAbort.signal;
+	const gen = ++loadGen;
 	loading = true;
 	error = null;
 
 	try {
-		// Remove existing layer
 		if (zarrLayer && map.getLayer(zarrLayer.id)) {
 			map.removeLayer(zarrLayer.id);
 		}
+		if (dsZarrOverlay) {
+			try {
+				map.removeControl(dsZarrOverlay as unknown as maplibregl.IControl);
+			} catch {
+				/* already removed */
+			}
+			dsZarrOverlay = null;
+		}
+
+		if (geoZarrInfo) {
+			const used = await tryAddGeoZarrLayer(map, gen, signal);
+			if (gen !== loadGen || signal.aborted) return;
+			if (used) return;
+		}
 
-		// Ensure numcodecs codecs (shuffle, zlib, etc.) are registered before zarr-layer uses zarrita
 		await ensureCodecsRegistered();
+		if (gen !== loadGen || signal.aborted) return;
 		const { ZarrLayer } = await import('@carbonplan/zarr-layer');
+		if (gen !== loadGen || signal.aborted) return;
 
-		const storeUrl = buildStoreUrl();
+		const storeUrl = await buildStoreUrl();
+		if (gen !== loadGen || signal.aborted) return;
 		const selector = buildSelector();
 
 		const opts: any = {
@@ -452,11 +495,102 @@ async function addZarrLayer(map: maplibregl.Map) {
 	}
 }
 
-function buildStoreUrl(): string {
-	const rawUrl = buildHttpsUrl(tab).replace(/\/+$/, '');
+async function buildStoreUrl(): Promise<string> {
+	const rawUrl = (await buildHttpsUrlAsync(tab)).replace(/\/+$/, '');
 	return extractZarrStoreUrl(rawUrl) ?? rawUrl;
 }
 
+/**
+ * Attempt to render via `@developmentseed/deck.gl-zarr`. Returns true on
+ * success (carbonplan fallback is skipped), false on any setup error so the
+ * caller can fall through to the legacy path. Errors thrown inside the layer
+ * after setup propagate through the overlay's `onError`.
+ */
+async function tryAddGeoZarrLayer(
+	map: maplibregl.Map,
+	gen: number,
+	signal: AbortSignal
+): Promise<boolean> {
+	if (!geoZarrInfo) return false;
+	try {
+		const zarrita = await import('zarrita');
+		if (gen !== loadGen || signal.aborted) return false;
+		const { ZarrLayer } = await import('@developmentseed/deck.gl-zarr');
+		if (gen !== loadGen || signal.aborted) return false;
+		const storeUrl = await buildStoreUrl();
+		if (gen !== loadGen || signal.aborted) return false;
+		const store = new zarrita.FetchStore(storeUrl);
+		const group = await zarrita.open(store, { kind: 'group' });
+		if (gen !== loadGen || signal.aborted) return false;
+
+		const zarrInfoSnapshot = $state.snapshot(geoZarrInfo) as GeoZarrInfo;
+		const layer = new ZarrLayer({
+			id: `geozarr-${tab.id}`,
+			source: group,
+			variable: zarrInfoSnapshot.variantPath || undefined,
+			selection: {},
+			epsgResolver: dsZarrEpsg,
+			getTileData: async (arr, options) => {
+				const chunk = await zarrita.get(arr, options.sliceSpec);
+				if (gen !== loadGen || signal.aborted) {
+					throw new DOMException('Aborted', 'AbortError');
+				}
+				const data = chunk.data as unknown as ArrayLike<number> & { length: number };
+				return {
+					width: options.width,
+					height: options.height,
+					data,
+					byteLength: data.length
+				};
+			},
+			renderTile: (data) => {
+				const raw = (data as unknown as { data: ArrayLike<number> & { length: number } }).data;
+				if (!raw) return { image: undefined } as never;
+				let clamped: Uint8ClampedArray;
+				const asTyped = raw as unknown as {
+					buffer?: ArrayBufferLike;
+					byteOffset?: number;
+					byteLength?: number;
+				};
+				if (
+					asTyped.buffer &&
+					typeof asTyped.byteOffset === 'number' &&
+					typeof asTyped.byteLength === 'number'
+				) {
+					clamped = new Uint8ClampedArray(asTyped.buffer, asTyped.byteOffset, asTyped.byteLength);
+				} else {
+					clamped = new Uint8ClampedArray(raw as unknown as Uint8Array);
+				}
+				const img = new ImageData(
+					clamped as unknown as Uint8ClampedArray<ArrayBuffer>,
+					data.width,
+					data.height
+				);
+				return { image: img };
+			}
+		});
+
+		const overlay = new MapboxOverlay({
+			interleaved: false,
+			layers: [layer],
+			onError: (err) => {
+				error = err?.message || String(err);
+				loading = false;
+			}
+		});
+		dsZarrOverlay = overlay;
+		map.addControl(overlay as unknown as maplibregl.IControl);
+		loading = false;
+		return true;
+	} catch {
+		// Fall back to carbonplan path on any setup failure (e.g. the store
+		// looked like GeoZarr by shape but zarrita open failed, or the group
+		// attrs don't actually parse). Silent by design, the caller will mount
+		// carbonplan's ZarrLayer which surfaces its own errors.
+		return false;
+	}
+}
+
 // Re-render when selector changes
 async function updateSelector() {
 	if (!zarrLayer) return;
@@ -476,6 +610,7 @@ async function changeVariable() {
 }
 
 function cleanup() {
+	addAbort.abort();
 	inspectPopup?.remove();
 	inspectPopup = null;
 	try {
@@ -483,10 +618,14 @@ function cleanup() {
 		if (zarrLayer && mapRef?.getLayer('zarr-data')) {
 			mapRef.removeLayer('zarr-data');
 		}
+		if (mapRef && dsZarrOverlay) {
+			mapRef.removeControl(dsZarrOverlay as unknown as maplibregl.IControl);
+		}
 	} catch {
 		// map may already be destroyed
 	}
 	zarrLayer = null;
+	dsZarrOverlay = null;
 	mapRef = null;
 }
 

package/dist/components/viewers/ZarrMapViewer.svelte.d.ts

@@ -1,11 +1,17 @@
-import type { Tab } from '../../types';
-import { type ZarrNode } from '../../utils/zarr.js';
+import type { Tab } from '../../types.js';
+import { type ZarrHierarchy, type ZarrNode } from '../../utils/zarr.js';
 type $$ComponentProps = {
     tab: Tab;
     variables: ZarrNode[];
     coords?: ZarrNode[];
     spatialRefAttrs: Record<string, any> | null;
     zarrVersion?: number | null;
+    /**
+     * Full pre-loaded hierarchy. When present, `detectGeoZarr` can short-circuit
+     * to the `@developmentseed/deck.gl-zarr` path for GeoZarr-valid stores.
+     * Non-GeoZarr stores fall through to `@carbonplan/zarr-layer`.
+     */
+    hierarchy?: ZarrHierarchy | null;
 };
 declare const ZarrMapViewer: import("svelte").Component<$$ComponentProps, {}, "">;
 type ZarrMapViewer = ReturnType<typeof ZarrMapViewer>;

package/dist/components/viewers/ZarrViewer.svelte

@@ -9,7 +9,7 @@ import {
 } from '../ui/resizable/index.js';
 import { t } from '../../i18n/index.svelte.js';
 import type { Tab } from '../../types';
-import { buildHttpsUrl } from '../../utils/url.js';
+import { buildHttpsUrlAsync } from '../../utils/url.js';
 import { getUrlView, updateUrlView } from '../../utils/url-state.js';
 import {
 	computeChunkCount,
@@ -120,7 +120,7 @@ async function loadHierarchy() {
 	error = null;
 
 	try {
-		const rawUrl = buildHttpsUrl(tab).replace(/\/+$/, '');
+		const rawUrl = (await buildHttpsUrlAsync(tab)).replace(/\/+$/, '');
 		const url = extractZarrStoreUrl(rawUrl) ?? rawUrl;
 		const storeName = tab.name.replace(/\.(zarr|zr3)$/, '');
 
@@ -474,6 +474,7 @@ function selectStoreAttrs() {
 					coords={coordArrays}
 					spatialRefAttrs={hierarchy?.spatialRefAttrs ?? null}
 					zarrVersion={hierarchy?.zarrVersion}
+					hierarchy={hierarchy ?? null}
 				/>
 			{/await}
 		{/key}

package/dist/components/viewers/pmtiles/PmtilesMapView.svelte

@@ -12,7 +12,6 @@ import type { Tab } from '../../../types';
 import { setupSelectionLayer, updateSelection } from '../../../utils/map-selection.js';
 import { buildPmtilesLayers, getPmtilesProtocol, type PmtilesMetadata } from '../../../utils/pmtiles';
 import { layerHue } from '../../../utils/pmtiles-tile.js';
-import { buildHttpsUrl } from '../../../utils/url.js';
 import AttributeTable from '../map/AttributeTable.svelte';
 import MapContainer from '../map/MapContainer.svelte';
 

package/dist/i18n/ar.js

@@ -40,6 +40,8 @@ export const ar = {
     'connection.readOnlyCliTitle': 'تقييد عبر سطر الأوامر',
     'connection.testSuccess': 'الاتصال ناجح',
     'connection.testFail': 'فشل الاتصال. تحقق من الإعدادات وحاول مرة أخرى.',
+    'connection.duplicateMerged': 'تم العثور على اتصال موجود ("{name}") لهذه الحاوية. تم تحديث بيانات الاعتماد.',
+    'connection.duplicateBlocked': 'يوجد بالفعل اتصال آخر ("{name}") يستخدم هذه الحاوية. عدّله بدلاً من ذلك.',
     'connection.testButton': 'اختبار الاتصال',
     'connection.testing': 'جارٍ الاختبار...',
     'connection.cancel': 'إلغاء',
@@ -300,6 +302,7 @@ export const ar = {
     'code.stacCatalog': 'كتالوج STAC',
     'code.stacCollection': 'مجموعة STAC',
     'code.stacItem': 'عنصر STAC',
+    'code.stacGeoparquet': 'stac-geoparquet',
     'code.browseStac': 'تصفح',
     'code.keplerGl': 'Kepler.gl',
     'code.openKepler': 'فتح الخريطة',
@@ -342,6 +345,7 @@ export const ar = {
     'map.flatgeobufInfo': 'معلومات FlatGeobuf',
     'map.cogInfo': 'معلومات COG',
     'map.cogCorsError': 'تعذّر تحميل COG: الخادم لا يسمح بطلبات عبر النطاقات (CORS). يجب استضافة الملف مع تفعيل ترويسات CORS.',
+    'map.cogInvalidTiff': 'هذا الملف ليس ملف TIFF صالح. نوع المحتوى image/tiff لكن الأجزاء الأولى من الملف لا تطابق توقيع TIFF، قد يكون الملف تالفاً أو مشفّراً أو مُعنوناً بشكل خاطئ.',
     'map.cogUnsupportedFormat': 'يستخدم هذا الملف صيغة {{type}} غير مدعومة لعرض الخريطة. يمكن عرض ملفات COG بصيغة RGB فقط.',
     'map.noGeoColumn': 'لم يتم اكتشاف عمود هندسي في المخطط',
     'map.noData': 'لا تتوفر بيانات لعرض الخريطة',
@@ -381,11 +385,35 @@ export const ar = {
     'mapInfo.columns': 'الأعمدة',
     'mapInfo.size': 'الحجم',
     'mapInfo.bands': 'النطاقات',
+    'map.mosaicEmpty': 'كتالوج STAC لا يحتوي على عناصر بها أصول COG.',
+    'map.mosaicNoAssets': 'لا تحتوي عناصر STAC على عنوان URL صالح لأصل COG.',
+    'map.multiCogMissingBands': 'عنصر STAC هذا ينقصه نطاقات الأحمر والأخضر والأزرق اللازمة للتركيب.',
+    'map.multiCogPreset.label': 'الإعداد المسبق',
+    'map.multiCogPreset.trueColor': 'ألوان طبيعية',
+    'map.multiCogPreset.falseColorIR': 'أشعة تحت حمراء كاذبة اللون',
+    'map.multiCogPreset.swir': 'الأشعة تحت الحمراء قصيرة الموجة',
+    'map.multiCogPreset.vegetation': 'الغطاء النباتي',
+    'map.multiCogPreset.agriculture': 'الزراعة',
+    // تبديل عرض STAC (StacTabViewer)
+    'stac.viewMosaic': 'خريطة',
+    'stac.viewMultiCog': 'خريطة (نطاقات)',
+    'stac.viewStacMap': 'stac-map',
+    'stac.viewBrowser': 'متصفح STAC',
+    'stac.viewJson': 'JSON',
+    'stac.viewTable': 'جدول',
+    'stac.stacBrowserJsonOnly': 'متصفح STAC يدعم كتالوجات JSON فقط. استخدم stac-map لملفات parquet.',
+    'stac.iframeDisabledPrivate': 'معطل للبكتات الخاصة، الإطار الخارجي لا يستطيع توقيع طلباته. استخدم الخريطة أو JSON بدلاً من ذلك.',
+    'stac.iframePrivateBucketWarning': 'بكت خاص، الإطار الخارجي لا يستطيع توقيع طلباته، لذا ستفشل طلبات العناصر الفرعية بـ 403. لكن المانيفست الجذري سيعمل.',
+    'stac.mosaicSourcesOne': 'فسيفساء، {count} مصدر',
+    'stac.mosaicSourcesOther': 'فسيفساء، {count} مصادر',
+    'stac.mosaicInfo': 'معلومات الفسيفساء',
+    'stac.mosaicSourcesLabel': 'المصادر',
     // COG Controls
     'cog.style': 'النمط',
     'cog.band': 'النطاق',
     'cog.singleBand': 'نطاق واحد',
     'cog.colorRamp': 'تدرج الألوان',
+    'cog.colorRampSearch': 'بحث في التدرجات…',
     'cog.pixelValue': 'قيمة البكسل',
     'cog.reading': 'قراءة البكسل...',
     'cog.rescale': 'إعادة القياس',

package/dist/i18n/en.js

@@ -40,6 +40,8 @@ export const en = {
     'connection.readOnlyCliTitle': 'Restrict via CLI',
     'connection.testSuccess': 'Connection successful',
     'connection.testFail': 'Connection failed. Check your settings and try again.',
+    'connection.duplicateMerged': 'Matched an existing connection ("{name}") for this bucket. Credentials were updated.',
+    'connection.duplicateBlocked': 'Another connection ("{name}") already uses this bucket. Edit that one instead.',
     'connection.testButton': 'Test Connection',
     'connection.testing': 'Testing...',
     'connection.cancel': 'Cancel',
@@ -300,6 +302,7 @@ export const en = {
     'code.stacCatalog': 'STAC Catalog',
     'code.stacCollection': 'STAC Collection',
     'code.stacItem': 'STAC Item',
+    'code.stacGeoparquet': 'stac-geoparquet',
     'code.browseStac': 'Browse',
     'code.keplerGl': 'Kepler.gl',
     'code.openKepler': 'Open Map',
@@ -342,6 +345,7 @@ export const en = {
     'map.flatgeobufInfo': 'FlatGeobuf Info',
     'map.cogInfo': 'COG Info',
     'map.cogCorsError': 'Cannot load COG: the server does not allow cross-origin requests (CORS). The file must be hosted with CORS headers enabled.',
+    'map.cogInvalidTiff': 'This file is not a valid TIFF. The server advertises image/tiff but the bytes do not match the TIFF signature, the file may be corrupt, encrypted, or mislabeled.',
     'map.cogUnsupportedFormat': 'This COG uses {{type}} format which is not supported for map rendering. Only RGB COGs can be displayed.',
     'map.noGeoColumn': 'No geometry column detected in schema',
     'map.noData': 'No data available for map view',
@@ -381,11 +385,35 @@ export const en = {
     'mapInfo.columns': 'Columns',
     'mapInfo.size': 'Size',
     'mapInfo.bands': 'Bands',
+    'map.mosaicEmpty': 'STAC catalog has no items with COG assets.',
+    'map.mosaicNoAssets': 'None of the STAC items expose a usable COG asset URL.',
+    'map.multiCogMissingBands': 'This STAC item is missing the red/green/blue bands required for a composite.',
+    'map.multiCogPreset.label': 'Preset',
+    'map.multiCogPreset.trueColor': 'True Color',
+    'map.multiCogPreset.falseColorIR': 'False-Color IR',
+    'map.multiCogPreset.swir': 'SWIR',
+    'map.multiCogPreset.vegetation': 'Vegetation',
+    'map.multiCogPreset.agriculture': 'Agriculture',
+    // STAC tab toggle (StacTabViewer)
+    'stac.viewMosaic': 'Map',
+    'stac.viewMultiCog': 'Map (Bands)',
+    'stac.viewStacMap': 'stac-map',
+    'stac.viewBrowser': 'STAC Browser',
+    'stac.viewJson': 'JSON',
+    'stac.viewTable': 'Table',
+    'stac.stacBrowserJsonOnly': 'STAC Browser supports JSON catalogs only. Use stac-map for parquet.',
+    'stac.iframeDisabledPrivate': 'Disabled for private buckets, the external iframe cannot sign its own crawl. Use Map or JSON instead.',
+    'stac.iframePrivateBucketWarning': 'Private bucket, the external iframe cannot sign its own crawl, so child items will 403. The top manifest still renders.',
+    'stac.mosaicSourcesOne': 'Mosaic, {count} source',
+    'stac.mosaicSourcesOther': 'Mosaic, {count} sources',
+    'stac.mosaicInfo': 'Mosaic info',
+    'stac.mosaicSourcesLabel': 'Sources',
     // COG Controls
     'cog.style': 'Style',
     'cog.band': 'Band',
     'cog.singleBand': 'Single',
     'cog.colorRamp': 'Color ramp',
+    'cog.colorRampSearch': 'Search ramps…',
     'cog.pixelValue': 'Pixel Value',
     'cog.reading': 'Reading pixel...',
     'cog.rescale': 'Rescale',

package/dist/index.d.ts

@@ -14,6 +14,8 @@ export type { CogInfo, GeoBounds } from './utils/cog.js';
 export { buildDataTypeLabel, clampBounds, SF_LABELS, safeClamp } from './utils/cog.js';
 export type { TypeCategory } from './utils/column-types.js';
 export { classifyType, typeBadgeClass, typeColor, typeLabel } from './utils/column-types.js';
+export type { ConnectionIdentityInput } from './utils/connection-identity.js';
+export { connectionIdentityKey, isSameConnectionIdentity, normalizeEndpoint, normalizeProvider } from './utils/connection-identity.js';
 export { handleLoadError } from './utils/error.js';
 export { escapeCsvField, serializeToCsv, serializeToJson } from './utils/export.js';
 export type { SortConfig, SortDirection, SortField } from './utils/file-sort.js';
@@ -28,6 +30,8 @@ export type { ParsedMarkdownDocument, SqlBlock } from './utils/markdown-sql.js';
 export { interpolateTemplates, markSqlBlocks, parseMarkdownDocument } from './utils/markdown-sql.js';
 export type { GeoColumnMeta, GeoParquetMeta, ParquetFileMetadata } from './utils/parquet-metadata.js';
 export { extractBounds, extractEpsgFromGeoMeta, extractGeometryTypes, readParquetMetadata } from './utils/parquet-metadata.js';
+export type { StacBboxStruct, StacGeoparquetRow, StacGeoparquetSchemaColumn, StacRowToItemOptions } from './utils/stac-geoparquet.js';
+export { flattenStacBbox, isStacGeoparquetSchema, pickStacPrimaryAsset, resolveStacAssetHref, STAC_GEOPARQUET_REQUIRED_COLUMNS, stacRowToItem } from './utils/stac-geoparquet.js';
 export type { Defaults, ParsedStorageUrl, StorageProvider } from './utils/storage-url.js';
 export { describeParseResult, looksLikeUrl, parseStorageUrl } from './utils/storage-url.js';
 export type { GeoType, ParsedGeometry } from './utils/wkb.js';

package/dist/index.js

@@ -12,6 +12,7 @@ export { copyToClipboard, wireCodeCopyButtons } from './utils/clipboard.js';
 export { getNativeScheme, resolveCloudUrl, safeDecodeURIComponent } from './utils/cloud-url.js';
 export { buildDataTypeLabel, clampBounds, SF_LABELS, safeClamp } from './utils/cog.js';
 export { classifyType, typeBadgeClass, typeColor, typeLabel } from './utils/column-types.js';
+export { connectionIdentityKey, isSameConnectionIdentity, normalizeEndpoint, normalizeProvider } from './utils/connection-identity.js';
 // Error handling
 export { handleLoadError } from './utils/error.js';
 // Data export / serialization
@@ -24,6 +25,7 @@ export { generateHexDump } from './utils/hex.js';
 export { loadFromStorage, persistToStorage } from './utils/local-storage.js';
 export { interpolateTemplates, markSqlBlocks, parseMarkdownDocument } from './utils/markdown-sql.js';
 export { extractBounds, extractEpsgFromGeoMeta, extractGeometryTypes, readParquetMetadata } from './utils/parquet-metadata.js';
+export { flattenStacBbox, isStacGeoparquetSchema, pickStacPrimaryAsset, resolveStacAssetHref, STAC_GEOPARQUET_REQUIRED_COLUMNS, stacRowToItem } from './utils/stac-geoparquet.js';
 export { describeParseResult, looksLikeUrl, parseStorageUrl } from './utils/storage-url.js';
 // Utilities
 export { findGeoColumn, findGeoColumnFromRows, parseWKB, toBinary } from './utils/wkb.js';

package/dist/query/index.d.ts

@@ -2,4 +2,4 @@ import type { QueryEngine } from './engine';
 export declare function getQueryEngine(): Promise<QueryEngine>;
 export type { MapQueryHandle, MapQueryResult, QueryEngine, QueryHandle, QueryResult, QuerySource, SchemaField } from './engine';
 export { QueryCancelledError } from './engine';
-export { type ResolvedTableSource, resolveTableSource } from './source.js';
+export { type ResolvedTableSource, resolveTableSource, resolveTableSourceAsync } from './source.js';

package/dist/query/index.js

@@ -17,4 +17,4 @@ export async function getQueryEngine() {
     return enginePromise;
 }
 export { QueryCancelledError } from './engine';
-export { resolveTableSource } from './source.js';
+export { resolveTableSource, resolveTableSourceAsync } from './source.js';

package/dist/query/source.d.ts

@@ -10,6 +10,12 @@
  */
 import type { Tab } from '../types.js';
 import type { QuerySource } from './engine.js';
+/**
+ * True when a source ref points at a self-authenticating HTTPS URL (e.g. a
+ * presigned `read_parquet('https://...?X-Amz-Signature=...')`). Used to decide
+ * whether DuckDB needs S3 credential config — presigned URLs don't.
+ */
+export declare function isHttpsSourceRef(ref: string): boolean;
 export interface ResolvedTableSource extends QuerySource {
     /**
      * True when the tab is file-backed and hyparquet / parquet metadata
@@ -28,3 +34,9 @@ export interface ResolvedTableSource extends QuerySource {
  * over a tab's lifetime.
  */
 export declare function resolveTableSource(tab: Tab): ResolvedTableSource;
+/**
+ * Async counterpart of `resolveTableSource`. Returns a presigned HTTPS URL
+ * for `signed-s3` connections so DuckDB httpfs can fetch without the
+ * `Authorization` header preflight.
+ */
+export declare function resolveTableSourceAsync(tab: Tab): Promise<ResolvedTableSource>;

package/dist/query/source.js

@@ -9,13 +9,16 @@
  * stay free of ad-hoc branching.
  */
 import { buildDuckDbSource } from '../file-icons/index.js';
-import { buildDuckDbUrl } from '../utils/url.js';
+import { buildDuckDbUrl, buildDuckDbUrlAsync } from '../utils/url.js';
 /**
- * Resolve a tab to its QuerySource. Must be called lazily (inside reactive
- * expressions or functions) because `tab.sourceRef` and `tab.path` can change
- * over a tab's lifetime.
+ * True when a source ref points at a self-authenticating HTTPS URL (e.g. a
+ * presigned `read_parquet('https://...?X-Amz-Signature=...')`). Used to decide
+ * whether DuckDB needs S3 credential config — presigned URLs don't.
  */
-export function resolveTableSource(tab) {
+export function isHttpsSourceRef(ref) {
+    return /(?:^|\(\s*['"])https:\/\//.test(ref);
+}
+function toResolved(tab, fileUrl) {
     if (tab.sourceRef) {
         return {
             ref: tab.sourceRef,
@@ -25,13 +28,27 @@ export function resolveTableSource(tab) {
             label: tab.name
         };
     }
-    const fileUrl = buildDuckDbUrl(tab);
-    const ref = buildDuckDbSource(tab.path, fileUrl);
     return {
-        ref,
+        ref: buildDuckDbSource(tab.path, fileUrl ?? ''),
         filePath: tab.path,
         isFileSource: true,
         fileUrl,
         label: tab.name
     };
 }
+/**
+ * Resolve a tab to its QuerySource. Must be called lazily (inside reactive
+ * expressions or functions) because `tab.sourceRef` and `tab.path` can change
+ * over a tab's lifetime.
+ */
+export function resolveTableSource(tab) {
+    return toResolved(tab, tab.sourceRef ? null : buildDuckDbUrl(tab));
+}
+/**
+ * Async counterpart of `resolveTableSource`. Returns a presigned HTTPS URL
+ * for `signed-s3` connections so DuckDB httpfs can fetch without the
+ * `Authorization` header preflight.
+ */
+export async function resolveTableSourceAsync(tab) {
+    return toResolved(tab, tab.sourceRef ? null : await buildDuckDbUrlAsync(tab));
+}

package/dist/query/stac-geoparquet.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Read a stac-geoparquet file through the existing DuckDB-WASM engine and
+ * materialize a standard STAC FeatureCollection in memory.
+ *
+ * Reuses:
+ *   - `getQueryEngine()` + `queryCancellable`/`query` for the single worker
+ *   - `resolveTableSourceAsync(tab)` for presigned `signed-s3` URL handling
+ *   - `stacRowToItem` from `utils/stac-geoparquet.js` for the pure transform
+ *   - `parseWKB` from `utils/wkb.js` for geometry decoding
+ *
+ * The returned `FeatureCollection` is the same shape `classifyStac()` returns
+ * as `{ kind: 'item-collection', fc }`, so downstream viewers
+ * (`StacMosaicViewer`, `MultiCogViewer`) consume it unchanged.
+ */
+import type { Tab } from '../types.js';
+import type { StacFeatureCollection } from '../utils/stac.js';
+export interface QueryStacGeoparquetOptions {
+    signal?: AbortSignal;
+    /** Hard cap on rows. Matches `hydrateStacItems` default. */
+    limit?: number;
+}
+/**
+ * Query a stac-geoparquet tab and return a STAC FeatureCollection whose
+ * features are proper STAC Items (assets absolutized, WKB decoded, bbox
+ * flattened).
+ *
+ * @param tab - the tab pointing at the `.parquet` file
+ * @param connId - connection id used for DuckDB's httpfs S3 config; pass
+ *   an empty string for URL-source tabs (DuckDB will use anonymous httpfs)
+ */
+export declare function queryStacGeoparquetFeatureCollection(tab: Tab, connId: string, opts?: QueryStacGeoparquetOptions): Promise<StacFeatureCollection>;