@walkthru-earth/objex 1.3.1 → 1.5.0

package/dist/components/viewers/stac/StacItemStrip.svelte

@@ -0,0 +1,228 @@
+<script lang="ts">
+import type { StacItemView } from '@walkthru-earth/objex-utils';
+import { formatDate } from '@walkthru-earth/objex-utils';
+import { onDestroy, untrack } from 'svelte';
+import { t } from '../../../i18n/index.svelte.js';
+
+/**
+ * Bottom-anchored, horizontally-scrolling strip of STAC items. Each card
+ * shows a thumbnail (when available), the id, datetime, and cloud cover.
+ * Hovering a card highlights the matching footprint via `onHover`,
+ * clicking selects/pins it via `onSelect`.
+ *
+ * Thumbnails are presigned via the parent's `presign` callback (the same
+ * helper the mosaic uses) so private buckets work without a duplicate
+ * cache. Errors are swallowed quietly, a missing thumbnail is just an
+ * empty box, never a console flood.
+ *
+ * Layout choice: the strip is `position: absolute` instead of part of the
+ * MapContainer's flow because both the inspector (right slide-over) and
+ * the existing pixel inspector (`bottom-2 left-2`) need to coexist with
+ * it on the same map surface. `bottom-12` leaves room above the pixel
+ * inspector overlay.
+ */
+let {
+	views,
+	hoveredId,
+	selectedId,
+	presign,
+	onHover,
+	onSelect
+}: {
+	views: readonly StacItemView[];
+	hoveredId: string | null;
+	selectedId: string | null;
+	presign: (href: string) => Promise<string>;
+	onHover: (id: string | null) => void;
+	onSelect: (id: string | null) => void;
+} = $props();
+
+// Resolved thumbnail URLs, keyed by item id. Held as a Map in $state.raw
+// so per-resolve writes are O(1) instead of the O(n) object-spread the
+// previous `{...thumbs, [id]: url}` did (which accumulated to O(n²) over a
+// viewport of 1000+ items, per the project's $state.raw rule for large
+// collections). Reactivity is triggered by bumping `thumbsTick`; readers
+// in the template subscribe to that tick + read `thumbs.get(id)`.
+const thumbs = new Map<string, string | null>();
+let thumbsTick = $state(0);
+const inflight = new Set<string>();
+// Mirror of the current `views[].id` set. The .then() handler for each
+// presign checks against this so a presign that settles AFTER its item
+// scrolled out of the viewport does not re-insert a stale entry into
+// `thumbs` (which the cleanup $effect just removed). Mutated by the
+// cleanup effect, read by load handlers.
+let liveIds = new Set<string>();
+
+function loadThumbnail(view: StacItemView): void {
+	if (!view.thumbnailHref) return;
+	if (thumbs.has(view.id)) return;
+	if (inflight.has(view.id)) return;
+	inflight.add(view.id);
+	presign(view.thumbnailHref)
+		.then((url) => {
+			if (!liveIds.has(view.id)) return;
+			thumbs.set(view.id, url);
+			thumbsTick++;
+		})
+		.catch(() => {
+			if (!liveIds.has(view.id)) return;
+			thumbs.set(view.id, null);
+			thumbsTick++;
+		})
+		.finally(() => {
+			inflight.delete(view.id);
+		});
+}
+
+// Eagerly kick presigning for every view as soon as it appears. `presign`
+// is local crypto (SigV4 query-string sign or HTTPS pass-through), not a
+// network call, so resolving all thumbnails up-front is cheap. Each
+// resulting `<img>` carries `loading="lazy"`, so the actual GET is still
+// deferred to scroll-into-view by the browser. The previous mouseenter /
+// focus trigger never fired on touch devices and required the user to
+// hover every card individually on desktop.
+$effect(() => {
+	for (const view of views) loadThumbnail(view);
+});
+
+// Drop thumbs for items no longer in the views list. Without this, panning
+// across a STAC API would grow `thumbs` forever as the user discovers new
+// regions, and the cache would dominate memory before any other leak.
+$effect(() => {
+	const ids = new Set(views.map((v) => v.id));
+	liveIds = ids;
+	untrack(() => {
+		let mutated = false;
+		for (const id of thumbs.keys()) {
+			if (!ids.has(id)) {
+				thumbs.delete(id);
+				mutated = true;
+			}
+		}
+		if (mutated) thumbsTick++;
+	});
+});
+
+// Scroll the selected card into view when selection comes from outside
+// (footprint click). Only fires when the id changes, not on every render.
+let scrollContainer: HTMLDivElement | null = $state(null);
+let lastScrolled: string | null = null;
+$effect(() => {
+	if (!selectedId || selectedId === lastScrolled) return;
+	if (!scrollContainer) return;
+	const el = scrollContainer.querySelector(`[data-item-id="${CSS.escape(selectedId)}"]`);
+	if (el && 'scrollIntoView' in el) {
+		(el as HTMLElement).scrollIntoView({ behavior: 'smooth', block: 'nearest', inline: 'center' });
+		lastScrolled = selectedId;
+	}
+});
+
+onDestroy(() => {
+	thumbs.clear();
+	inflight.clear();
+	liveIds = new Set();
+});
+
+function formatItemDate(iso: string | null): string {
+	if (!iso) return '';
+	const t = Date.parse(iso);
+	return Number.isFinite(t) ? formatDate(t) : iso;
+}
+
+/**
+ * Template reader for the thumbs Map. Reading `thumbsTick` first registers
+ * a Svelte reactive dependency on the tick counter, so any tick bump
+ * (resolve / failure / cleanup) re-evaluates this call site without us
+ * having to wrap the entire Map in a reactive Proxy via `$state(Map)`.
+ * Returns the same tri-state the template branches on:
+ *   string → resolved URL, render `<img>`
+ *   null   → presign failed, render "no thumbnail" placeholder
+ *   undefined → still in flight (or has no thumbnailHref), render "loading"
+ */
+function thumbFor(id: string): string | null | undefined {
+	void thumbsTick;
+	return thumbs.get(id);
+}
+</script>
+
+<div
+	class="pointer-events-auto rounded-md bg-card/90 shadow-lg backdrop-blur-sm"
+>
+	<div class="flex items-center justify-between border-b border-border px-2 py-1 text-xs text-muted-foreground sm:text-[10px]">
+		<span class="tabular-nums">{t('stac.stripCount', { count: views.length })}</span>
+		{#if selectedId}
+			<button
+				class="inline-flex min-h-8 items-center rounded px-2 py-1 text-xs hover:bg-accent hover:text-accent-foreground sm:min-h-0 sm:px-1.5 sm:py-0.5 sm:text-[10px]"
+				style="touch-action: manipulation;"
+				onclick={() => onSelect(null)}
+			>
+				{t('stac.clearSelection')}
+			</button>
+		{/if}
+	</div>
+	<div
+		bind:this={scrollContainer}
+		role="list"
+		class="flex snap-x snap-mandatory gap-1.5 overflow-x-auto overscroll-x-contain px-2 py-1.5"
+		style="-webkit-overflow-scrolling: touch;"
+		onmouseleave={() => onHover(null)}
+	>
+		{#each views as view (view.id)}
+			{@const thumb = thumbFor(view.id)}
+			<button
+				type="button"
+				data-item-id={view.id}
+				class="group relative flex w-24 shrink-0 snap-start flex-col gap-1 overflow-hidden rounded border bg-background text-left transition-colors sm:w-32"
+				class:border-border={view.id !== hoveredId && view.id !== selectedId}
+				class:border-white={view.id === hoveredId && view.id !== selectedId}
+				class:border-amber-400={view.id === selectedId}
+				class:ring-1={view.id === selectedId}
+				class:ring-amber-400={view.id === selectedId}
+				onmouseenter={() => onHover(view.id)}
+				onfocus={() => onHover(view.id)}
+				onclick={() => onSelect(view.id)}
+			>
+				<div class="relative aspect-square w-full bg-muted">
+					{#if thumb}
+						<img
+							src={thumb}
+							alt=""
+							loading="lazy"
+							decoding="async"
+							fetchpriority="low"
+							class="h-full w-full object-cover"
+							onerror={() => {
+								thumbs.set(view.id, null);
+								thumbsTick++;
+							}}
+						/>
+					{:else if thumb === null}
+						<div class="flex h-full w-full items-center justify-center text-[9px] text-muted-foreground">
+							{t('stac.thumbNone')}
+						</div>
+					{:else if view.thumbnailHref}
+						<div class="flex h-full w-full items-center justify-center text-[9px] text-muted-foreground">
+							{t('stac.thumbLoading')}
+						</div>
+					{:else}
+						<div class="flex h-full w-full items-center justify-center text-[9px] text-muted-foreground">
+							{t('stac.thumbNone')}
+						</div>
+					{/if}
+					{#if view.cloudCover != null}
+						<span
+							class="absolute right-0.5 top-0.5 rounded bg-black/60 px-1 text-[9px] tabular-nums text-white"
+							title={t('stac.cloudCover')}
+						>
+							{Math.round(view.cloudCover)}%
+						</span>
+					{/if}
+				</div>
+				<div class="px-1.5 pb-1 text-[10px] leading-tight">
+					<div class="truncate font-medium" title={view.id}>{view.id}</div>
+					<div class="truncate text-muted-foreground">{formatItemDate(view.datetime)}</div>
+				</div>
+			</button>
+		{/each}
+	</div>
+</div>

package/dist/components/viewers/stac/StacItemStrip.svelte.d.ts

@@ -0,0 +1,12 @@
+import type { StacItemView } from '@walkthru-earth/objex-utils';
+type $$ComponentProps = {
+    views: readonly StacItemView[];
+    hoveredId: string | null;
+    selectedId: string | null;
+    presign: (href: string) => Promise<string>;
+    onHover: (id: string | null) => void;
+    onSelect: (id: string | null) => void;
+};
+declare const StacItemStrip: import("svelte").Component<$$ComponentProps, {}, "">;
+type StacItemStrip = ReturnType<typeof StacItemStrip>;
+export default StacItemStrip;

package/dist/constants.d.ts

@@ -30,3 +30,9 @@ export declare const VIEWER_DIR_EXTENSIONS: Set<string>;
 export declare const LAYER_HUE_MULTIPLIER = 137;
 /** Duration (ms) to show "Copied!" feedback before resetting. */
 export declare const COPY_FEEDBACK_MS = 2000;
+/** Region assumed when a connection or bucket name yields none. AWS's global default. */
+export declare const DEFAULT_AWS_REGION = "us-east-1";
+/** deck.gl tile-layer debounce (ms) before fetching after a viewport change. */
+export declare const TILE_DEBOUNCE_MS = 200;
+/** Zoom level used when flying to the first feature of a vector dataset. */
+export declare const FIRST_FEATURE_FLY_ZOOM = 14;

package/dist/constants.js

@@ -36,3 +36,11 @@ export const LAYER_HUE_MULTIPLIER = 137;
 // ── Clipboard ──
 /** Duration (ms) to show "Copied!" feedback before resetting. */
 export const COPY_FEEDBACK_MS = 2000;
+// ── AWS defaults ──
+/** Region assumed when a connection or bucket name yields none. AWS's global default. */
+export const DEFAULT_AWS_REGION = 'us-east-1';
+// ── Map / tiles ──
+/** deck.gl tile-layer debounce (ms) before fetching after a viewport change. */
+export const TILE_DEBOUNCE_MS = 200;
+/** Zoom level used when flying to the first feature of a vector dataset. */
+export const FIRST_FEATURE_FLY_ZOOM = 14;

package/dist/file-icons/index.d.ts

@@ -4,7 +4,7 @@
  * Single source of truth for extension → icon, color, label, category,
  * viewer, DuckDB read function, MIME type, and queryability.
  *
- * Used by: FileRow, FileTreeSidebar, ViewerRouter, TableViewer, WasmQueryEngine, etc.
+ * Used by: FileTreeSidebar, ViewerRouter, TableViewer, WasmQueryEngine, etc.
  */
 export type FileCategory = 'data' | 'geo' | 'code' | 'document' | 'config' | 'image' | 'video' | 'audio' | 'archive' | 'database' | '3d' | 'other';
 export type ViewerKind = 'table' | 'image' | 'video' | 'audio' | 'markdown' | 'code' | 'cog' | 'pmtiles' | 'flatgeobuf' | 'pdf' | '3d' | 'archive' | 'database' | 'zarr' | 'copc' | 'notebook' | 'raw';

package/dist/file-icons/index.js

@@ -4,7 +4,7 @@
  * Single source of truth for extension → icon, color, label, category,
  * viewer, DuckDB read function, MIME type, and queryability.
  *
- * Used by: FileRow, FileTreeSidebar, ViewerRouter, TableViewer, WasmQueryEngine, etc.
+ * Used by: FileTreeSidebar, ViewerRouter, TableViewer, WasmQueryEngine, etc.
  */
 // ---------------------------------------------------------------------------
 // Defaults

package/dist/i18n/ar.js

@@ -1,4 +1,7 @@
 export const ar = {
+    // Common
+    'common.loading': 'جارٍ التحميل...',
+    'common.error': 'خطأ',
     // Sidebar
     'sidebar.deleteConfirm': 'حذف الاتصال "{name}"؟',
     'sidebar.browseDetected': 'تصفح الحاوية المكتشفة: {name}',
@@ -53,6 +56,26 @@ export const ar = {
     'theme.dark': 'داكن',
     'theme.system': 'النظام',
     'theme.tooltip': 'وضع {mode}',
+    // Settings
+    'settings.title': 'الإعدادات',
+    'settings.tooltip': 'الإعدادات',
+    'settings.appearance': 'المظهر',
+    'settings.language': 'اللغة',
+    'settings.data': 'البيانات',
+    'settings.interface': 'الواجهة',
+    'settings.map': 'الخريطة',
+    'settings.basemapAuto': 'تلقائي (حسب السمة)',
+    'settings.rowLimit': 'حد الصفوف الافتراضي',
+    'settings.rowLimitHelp': 'عدد الصفوف المحملة لكل صفحة في عارض الجدول.',
+    'settings.mosaicLimit': 'حد عناصر STAC',
+    'settings.mosaicLimitHelp': 'أقصى عدد لعناصر STAC المحملة في الفسيفساء.',
+    'settings.showConnectionRail': 'شريط الاتصالات الجانبي',
+    'settings.showFileTree': 'شجرة الملفات',
+    'settings.lockedByLink': 'يتم التحكم به عبر معامل الرابط',
+    'settings.copyConfig': 'نسخ إعدادات JSON',
+    'settings.copied': 'تم النسخ',
+    'settings.reset': 'إعادة الضبط الافتراضي',
+    'settings.customConfig': 'تم تحميل إعدادات مخصصة',
     // Safe Lock
     'safeLock.enabledAria': 'قفل الأمان مفعّل (قراءة فقط)',
     'safeLock.disabledAria': 'قفل الأمان معطّل (الكتابة مسموحة)',
@@ -73,6 +96,10 @@ export const ar = {
     'fileTree.filterPlaceholder': 'تصفية الملفات...',
     'fileTree.noMatch': 'لا توجد ملفات مطابقة',
     'fileTree.emptyBucket': 'حاوية فارغة',
+    'fileTree.corsError': 'تعذّر عرض محتوى هذه الحاوية',
+    'fileTree.corsHint': 'استجاب الخادم لكنه لم يُرسل ترويسات CORS، فحجب المتصفح الاستجابة. هذا إعداد يتحكم به مالك الحاوية ولا يمكن تغييره من هنا. تحتاج الحاوية إلى سياسة CORS تسمح بهذا المصدر، أو الوصول عبر وسيط.',
+    'fileTree.loadError': 'تعذّر تحميل هذه الحاوية',
+    'fileTree.loadErrorHint': 'تحقق من إعدادات الاتصال والشبكة، وتأكد من صحة اسم الحاوية والمنطقة.',
     'fileTree.expandDir': 'توسيع المجلد',
     'fileTree.copyHttpUrl': 'نسخ رابط HTTPS',
     'fileTree.copyNativeUri': 'نسخ رابط {scheme}',
@@ -386,14 +413,21 @@ export const ar = {
     'mapInfo.size': 'الحجم',
     'mapInfo.bands': 'النطاقات',
     'map.mosaicEmpty': 'كتالوج STAC لا يحتوي على عناصر بها أصول COG.',
+    'map.mosaicEmptyViewport': 'لا توجد عناصر في نطاق الخريطة الحالي. حرّك أو ابتعد، أو ارفع حد العناصر.',
     'map.mosaicNoAssets': 'لا تحتوي عناصر STAC على عنوان URL صالح لأصل COG.',
     'map.multiCogMissingBands': 'عنصر STAC هذا ينقصه نطاقات الأحمر والأخضر والأزرق اللازمة للتركيب.',
+    'map.multiCogMosaicHeavy': 'فسيفساء متعددة الأصول مع عدد كبير من العناصر، قد يتأثر الأداء',
     'map.multiCogPreset.label': 'الإعداد المسبق',
     'map.multiCogPreset.trueColor': 'ألوان طبيعية',
     'map.multiCogPreset.falseColorIR': 'أشعة تحت حمراء كاذبة اللون',
     'map.multiCogPreset.swir': 'الأشعة تحت الحمراء قصيرة الموجة',
     'map.multiCogPreset.vegetation': 'الغطاء النباتي',
     'map.multiCogPreset.agriculture': 'الزراعة',
+    'map.multiCogPreset.custom': 'مخصص',
+    'map.multiCogBands': 'النطاقات',
+    'map.multiCogBandsTooltip': 'اختر النطاق المُسند إلى كل قناة إخراج',
+    'map.multiCogChannelNone': '(بدون)',
+    'map.mosaicAsset': 'الأصل',
     // تبديل عرض STAC (StacTabViewer)
     'stac.viewMosaic': 'خريطة',
     'stac.viewMultiCog': 'خريطة (نطاقات)',
@@ -408,16 +442,93 @@ export const ar = {
     'stac.mosaicSourcesOther': 'فسيفساء، {count} مصادر',
     'stac.mosaicInfo': 'معلومات الفسيفساء',
     'stac.mosaicSourcesLabel': 'المصادر',
+    'stac.explainHeading': 'تحليل',
+    'stac.explainItems': 'العناصر، {visible} ظاهر / {total} إجمالي',
+    'stac.explainAssets': 'أصول مميزة، {count}',
+    'stac.explainOverlap': 'تداخل في المركز، {count} عناصر',
+    'stac.explainBytes': 'تقدير بايت البلاطة لكل عنصر، {bytes}',
+    'stac.explainTimeSpan': 'الفترة، من {start} إلى {end}',
+    'stac.viewportMode': 'منطقة الخريطة',
+    'stac.timeRange': 'الوقت',
+    'stac.timeLatest': 'الأحدث',
+    'stac.time7d': 'آخر 7 أيام',
+    'stac.time30d': 'آخر 30 يومًا',
+    'stac.time90d': 'آخر 90 يومًا',
+    'stac.time1y': 'آخر سنة',
+    'stac.timeAll': 'كل الوقت',
+    'stac.refresh': 'تحديث',
+    'stac.filters': 'المرشحات',
+    'stac.itemLimit': 'حد العناصر',
+    'stac.itemLimitHint': 'الحد الأقصى لعدد العناصر التي يتم جلبها لكل عرض. القيم الأعلى تكشف عن مصادر أكثر لكنها تبطئ التحميل.',
+    'stac.capReached': 'تم بلوغ الحد {limit}. ارفع الحد لجلب المزيد.',
+    'stac.lastRefresh': 'آخر تحديث، منذ {seconds} ثانية',
+    'stac.stageIdle': 'في وضع الانتظار',
+    'stac.stageClassify': 'تصنيف STAC',
+    'stac.stageFetch': 'جلب العناصر',
+    'stac.stageIndex': 'فهرسة المساحات',
+    'stac.stageRender': 'رسم البلاطات',
+    'stac.stageEmpty': 'لا توجد عناصر في العرض',
+    'stac.stageError': 'خطأ',
+    'stac.stageSuperseded': 'تم استبدال الجلب السابق بتحريك جديد',
+    'stac.smokeWarning': 'فشل اختبار التخزين، {reason}',
+    'stac.smokeWarningHint': 'تعذّر الوصول إلى أحد ملفات COG التمثيلية. تحقّق من بيانات الاعتماد للاتصال، أو CORS للحاوية، أو من صحة عنوان الأصل.',
+    'stac.modeViewportApi': 'الوضع، تحديث عند التحريك، STAC API',
+    'stac.modeViewportParquet': 'الوضع، تحديث عند التحريك، stac-geoparquet',
+    'stac.modeStatic': 'الوضع، كتالوج ثابت (جلب لمرة واحدة، قص محلي حسب النطاق)',
+    'stac.footprints': 'البصمات',
+    'stac.footprintsHint': 'إظهار حدود كل عنصر محمّل',
+    'stac.strip': 'الشريط',
+    'stac.stripCount': '{count} عنصر',
+    'stac.clearSelection': 'مسح التحديد',
+    'stac.thumbLoading': 'جارٍ التحميل…',
+    'stac.thumbNone': 'لا توجد معاينة',
+    'stac.cloudCover': 'الغطاء السحابي',
+    'stac.datetime': 'التاريخ والوقت',
+    'stac.endDatetime': 'تاريخ النهاية',
+    'stac.gsd': 'دقة العينة الأرضية',
+    'stac.platform': 'المنصة',
+    'stac.constellation': 'الكوكبة',
+    'stac.instruments': 'الأجهزة',
+    'stac.epsg': 'النظام المرجعي',
+    'stac.assets': 'الأصول ({count})',
+    'stac.assetOpen': 'فتح',
+    'stac.flyTo': 'الانتقال',
+    'stac.filterDatetime': 'تصفية حسب التاريخ',
+    'stac.granularityLabel': 'المدرج التكراري، فواصل {granularity}',
+    'stac.granularity.day': 'يوم',
+    'stac.granularity.week': 'أسبوع',
+    'stac.granularity.month': 'شهر',
+    'stac.granularity.year': 'سنة',
+    'stac.facetTotal': '{count} محمَّل',
+    'stac.facetNoneAvailable': 'لا توجد حقول قابلة للتصفية في هذه البيانات.',
+    'stac.resetFilters': 'إعادة',
+    'stac.filtersActive': 'فلاتر نشطة',
+    'stac.collection': 'المجموعة',
+    'stac.assetRoles': 'أدوار الأصول',
+    'stac.copyId': 'نسخ المعرف',
+    'stac.copyJson': 'نسخ JSON',
+    'stac.copied': 'تم النسخ',
+    'stac.close': 'إغلاق',
+    'stac.showRaw': 'عرض JSON الخام',
+    'stac.hideRaw': 'إخفاء JSON الخام',
     // COG Controls
     'cog.style': 'النمط',
+    'cog.asset': 'الأصل',
     'cog.band': 'النطاق',
     'cog.singleBand': 'نطاق واحد',
     'cog.colorRamp': 'تدرج الألوان',
     'cog.colorRampSearch': 'بحث في التدرجات…',
     'cog.pixelValue': 'قيمة البكسل',
     'cog.reading': 'قراءة البكسل...',
-    'cog.rescale': 'إعادة القياس',
-    'cog.rescaleReset': 'إعادة تعيين',
+    'cog.rescale.label': 'إعادة القياس',
+    'cog.rescale.reset': 'إعادة تعيين',
+    'cog.nodata.label': 'بيانات مفقودة',
+    'cog.nodata.auto': 'تلقائي',
+    'cog.nodata.value': 'قيمة',
+    'cog.nodata.off': 'إيقاف',
+    'cog.nodata.autoHint': 'من الملف: {value}',
+    'cog.nodata.autoNone': 'لا يوجد وسم GDAL_NODATA',
+    'cog.nodata.valuePlaceholder': 'مثال: -9999',
     // PMTiles Viewer
     'pmtiles.mapView': 'خريطة',
     'pmtiles.archiveView': 'الأرشيف',

package/dist/i18n/en.js

@@ -1,4 +1,7 @@
 export const en = {
+    // Common
+    'common.loading': 'Loading...',
+    'common.error': 'Error',
     // Sidebar
     'sidebar.deleteConfirm': 'Delete connection "{name}"?',
     'sidebar.browseDetected': 'Browse detected bucket: {name}',
@@ -53,6 +56,26 @@ export const en = {
     'theme.dark': 'Dark',
     'theme.system': 'System',
     'theme.tooltip': '{mode} mode',
+    // Settings
+    'settings.title': 'Settings',
+    'settings.tooltip': 'Settings',
+    'settings.appearance': 'Appearance',
+    'settings.language': 'Language',
+    'settings.data': 'Data',
+    'settings.interface': 'Interface',
+    'settings.map': 'Map',
+    'settings.basemapAuto': 'Auto (match theme)',
+    'settings.rowLimit': 'Default row limit',
+    'settings.rowLimitHelp': 'Rows loaded per page in the table viewer.',
+    'settings.mosaicLimit': 'STAC item limit',
+    'settings.mosaicLimitHelp': 'Maximum STAC items loaded into a mosaic.',
+    'settings.showConnectionRail': 'Connection sidebar',
+    'settings.showFileTree': 'File tree',
+    'settings.lockedByLink': 'Controlled by a link parameter',
+    'settings.copyConfig': 'Copy config JSON',
+    'settings.copied': 'Copied',
+    'settings.reset': 'Reset to defaults',
+    'settings.customConfig': 'Custom config loaded',
     // Safe Lock
     'safeLock.enabledAria': 'Safe lock enabled (read-only)',
     'safeLock.disabledAria': 'Safe lock disabled (writes allowed)',
@@ -73,6 +96,10 @@ export const en = {
     'fileTree.filterPlaceholder': 'Filter files...',
     'fileTree.noMatch': 'No matching files',
     'fileTree.emptyBucket': 'Empty bucket',
+    'fileTree.corsError': "Can't list this bucket",
+    'fileTree.corsHint': 'The server replied but sent no CORS headers, so the browser blocked the response. This is set by the bucket owner and cannot be changed here. The bucket needs a CORS policy that allows this origin, or access through a proxy.',
+    'fileTree.loadError': "Couldn't load this bucket",
+    'fileTree.loadErrorHint': 'Check the connection settings and your network, and confirm the bucket name and region are correct.',
     'fileTree.expandDir': 'Expand directory',
     'fileTree.copyHttpUrl': 'Copy HTTPS URL',
     'fileTree.copyNativeUri': 'Copy {scheme} URI',
@@ -386,14 +413,21 @@ export const en = {
     'mapInfo.size': 'Size',
     'mapInfo.bands': 'Bands',
     'map.mosaicEmpty': 'STAC catalog has no items with COG assets.',
+    'map.mosaicEmptyViewport': 'No items in the current map view. Pan or zoom out, or raise the item cap.',
     '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.multiCogMosaicHeavy': 'Multi-asset mosaic with many items, performance may degrade',
     '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',
+    'map.multiCogPreset.custom': 'Custom',
+    'map.multiCogBands': 'Bands',
+    'map.multiCogBandsTooltip': 'Pick which STAC asset feeds each output channel',
+    'map.multiCogChannelNone': '(none)',
+    'map.mosaicAsset': 'Asset',
     // STAC tab toggle (StacTabViewer)
     'stac.viewMosaic': 'Map',
     'stac.viewMultiCog': 'Map (Bands)',
@@ -408,16 +442,93 @@ export const en = {
     'stac.mosaicSourcesOther': 'Mosaic, {count} sources',
     'stac.mosaicInfo': 'Mosaic info',
     'stac.mosaicSourcesLabel': 'Sources',
+    'stac.explainHeading': 'Explain',
+    'stac.explainItems': 'Items, {visible} visible / {total} total',
+    'stac.explainAssets': 'Distinct assets, {count}',
+    'stac.explainOverlap': 'Center overlap, {count} items',
+    'stac.explainBytes': 'Est tile bytes per item, {bytes}',
+    'stac.explainTimeSpan': 'Time span, {start} to {end}',
+    'stac.viewportMode': 'Map area',
+    'stac.timeRange': 'Time',
+    'stac.timeLatest': 'Latest',
+    'stac.time7d': 'Last 7 days',
+    'stac.time30d': 'Last 30 days',
+    'stac.time90d': 'Last 90 days',
+    'stac.time1y': 'Last year',
+    'stac.timeAll': 'All time',
+    'stac.refresh': 'Refresh',
+    'stac.filters': 'Filters',
+    'stac.itemLimit': 'Item cap',
+    'stac.itemLimitHint': 'Maximum items to fetch per viewport. Higher values reveal more sources but slow loading.',
+    'stac.capReached': 'Cap of {limit} items reached. Raise the cap to fetch more.',
+    'stac.lastRefresh': 'Last refresh, {seconds}s ago',
+    'stac.stageIdle': 'Idle',
+    'stac.stageClassify': 'Classifying STAC',
+    'stac.stageFetch': 'Fetching items',
+    'stac.stageIndex': 'Indexing footprints',
+    'stac.stageRender': 'Rendering tiles',
+    'stac.stageEmpty': 'No items in view',
+    'stac.stageError': 'Error',
+    'stac.stageSuperseded': 'Previous fetch superseded by new pan',
+    'stac.smokeWarning': 'Storage probe failed, {reason}',
+    'stac.smokeWarningHint': 'A representative COG could not be reached. Check connection credentials, bucket CORS, or whether the asset href resolves.',
+    'stac.modeViewportApi': 'Mode, viewport refresh on pan, STAC API',
+    'stac.modeViewportParquet': 'Mode, viewport refresh on pan, stac-geoparquet',
+    'stac.modeStatic': 'Mode, static catalog (one-shot fetch, client-side bbox clipping)',
+    'stac.footprints': 'Footprints',
+    'stac.footprintsHint': 'Toggle bbox outlines for every loaded item',
+    'stac.strip': 'Strip',
+    'stac.stripCount': '{count} items',
+    'stac.clearSelection': 'Clear selection',
+    'stac.thumbLoading': 'Loading…',
+    'stac.thumbNone': 'No preview',
+    'stac.cloudCover': 'Cloud cover',
+    'stac.datetime': 'Datetime',
+    'stac.endDatetime': 'End datetime',
+    'stac.gsd': 'GSD',
+    'stac.platform': 'Platform',
+    'stac.constellation': 'Constellation',
+    'stac.instruments': 'Instruments',
+    'stac.epsg': 'CRS',
+    'stac.assets': 'Assets ({count})',
+    'stac.assetOpen': 'Open',
+    'stac.flyTo': 'Fly to',
+    'stac.filterDatetime': 'Filter by datetime',
+    'stac.granularityLabel': 'Histogram, {granularity} buckets',
+    'stac.granularity.day': 'day',
+    'stac.granularity.week': 'week',
+    'stac.granularity.month': 'month',
+    'stac.granularity.year': 'year',
+    'stac.facetTotal': '{count} loaded',
+    'stac.facetNoneAvailable': 'No filterable fields detected for this dataset.',
+    'stac.resetFilters': 'Reset',
+    'stac.filtersActive': 'Filters active',
+    'stac.collection': 'Collection',
+    'stac.assetRoles': 'Asset roles',
+    'stac.copyId': 'Copy id',
+    'stac.copyJson': 'Copy JSON',
+    'stac.copied': 'Copied',
+    'stac.close': 'Close',
+    'stac.showRaw': 'Show raw JSON',
+    'stac.hideRaw': 'Hide raw JSON',
     // COG Controls
     'cog.style': 'Style',
+    'cog.asset': 'Asset',
     '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',
-    'cog.rescaleReset': 'Reset',
+    'cog.rescale.label': 'Rescale',
+    'cog.rescale.reset': 'Reset',
+    'cog.nodata.label': 'No-data',
+    'cog.nodata.auto': 'Auto',
+    'cog.nodata.value': 'Value',
+    'cog.nodata.off': 'Off',
+    'cog.nodata.autoHint': 'from file: {value}',
+    'cog.nodata.autoNone': 'no GDAL_NODATA tag',
+    'cog.nodata.valuePlaceholder': 'e.g. -9999',
     // PMTiles Viewer
     'pmtiles.mapView': 'Map',
     'pmtiles.archiveView': 'Archive',

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+export type { ChannelComposite, ChannelRef, CogAsset, CogInfo, ConnectionIdentityInput, DatetimeFacet, Defaults, EnumFacet, EnumFacetField, Facet, FacetSet, FacetSort, FacetState, GeoArrowGeomType, GeoArrowResult, GeoBounds, GeoColumnMeta, GeoParquetMeta, GeoType, HexRow, NumericFacet, NumericFacetField, ParquetFileMetadata, ParsedGeometry, ParsedMarkdownDocument, ParsedStorageUrl, PresetDef, SortConfig, SortDirection, SortField, SqlBlock, StacApiCapabilities, StacBboxStruct, StacGeoparquetRow, StacGeoparquetSchemaColumn, StacItemView, StacNativeQuery, StacRowToItemOptions, StacSource, StacSourceBatch, StacSourceCapabilities, StacSourceKind, StacSourceRequest, StorageExtensionVersion, StorageHints, StorageProvider, ToNativeQueryOptions, TypeCategory } from '@walkthru-earth/objex-utils';
+export { allChannelsBand0, applyFacets, applyPreset, applyStorageHintsToConnection, availablePresets, buildDataTypeLabel, buildFacets, buildGeoArrowTables, clampBounds, classifyType, compositeFromUrl, compositeToUrl, connectionIdentityKey, copyToClipboard, DATETIME_HISTOGRAM_BINS, describeParseResult, detectStorageExtensionVersion, emptyFacetState, emptyPushdown, emptyStorageHints, escapeCsvField, extractBounds, extractCogAssets, extractEpsgFromGeoMeta, extractGeometryTypes, extractItemView, extractStorageHints, findGeoColumn, findGeoColumnFromRows, flattenStacBbox, formatDate, formatFileSize, formatValue, generateHexDump, getFileExtension, getNativeScheme, handleLoadError, hasActiveFilters, interpolateTemplates, isAbortError, isSameConnectionIdentity, isSingleAssetComposite, isStacGeoparquetSchema, jsonReplacerBigInt, loadFromStorage, looksLikeUrl, markSqlBlocks, normalizeEndpoint, normalizeGeomType, normalizeProvider, PRESETS, parseMarkdownDocument, parseStorageUrl, parseWKB, persistToStorage, pickNaturalColorComposite, pickStacPrimaryAsset, presetMatchesComposite, readParquetMetadata, residualState, resolveCloudUrl, resolveStacAssetHref, SF_LABELS, STAC_GEOPARQUET_REQUIRED_COLUMNS, safeClamp, safeDecodeURIComponent, serializeToCsv, serializeToJson, sniffApiCapabilities, sortFileEntries, sortViews, stacRowToItem, syntheticSelfAsset, toBinary, toCql2Filter, toggleSortField, toNativeQuery, typeBadgeClass, typeColor, typeLabel, wireCodeCopyButtons } from '@walkthru-earth/objex-utils';
 export { COPY_FEEDBACK_MS, DEFAULT_TARGET_CRS, DUCKDB_INIT_TIMEOUT_MS, LAYER_HUE_MULTIPLIER, MAX_QUERY_HISTORY_ENTRIES, SQL_PREVIEW_LENGTH, STORAGE_KEYS, VIEWER_DIR_EXTENSIONS, WGS84_CODES } from './constants.js';
 export type { DuckDbReadFn, FileCategory, FileTypeInfo, ViewerKind } from './file-icons/index.js';
 export { buildDuckDbSource, getDuckDbReadFn, getFileTypeInfo, getMimeType, getViewerKind, isCloudNativeFormat, isQueryable } from './file-icons/index.js';
@@ -8,31 +10,3 @@ export type { ProviderDef, ProviderId, ProviderRegion } from './storage/provider
 export { buildEndpointFromTemplate, buildProviderBaseUrl, getProvider, isGcsProvider, PROVIDER_IDS, PROVIDERS } from './storage/providers.js';
 export { UrlAdapter } from './storage/url-adapter.js';
 export type { Connection, ConnectionConfig, FileEntry, Tab, Theme, WriteResult } from './types.js';
-export { copyToClipboard, wireCodeCopyButtons } from './utils/clipboard.js';
-export { getNativeScheme, resolveCloudUrl, safeDecodeURIComponent } from './utils/cloud-url.js';
-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';
-export { sortFileEntries, toggleSortField } from './utils/file-sort.js';
-export { formatDate, formatFileSize, formatValue, getFileExtension, jsonReplacerBigInt } from './utils/format.js';
-export type { GeoArrowGeomType, GeoArrowResult } from './utils/geoarrow.js';
-export { buildGeoArrowTables, normalizeGeomType } from './utils/geoarrow.js';
-export type { HexRow } from './utils/hex.js';
-export { generateHexDump } from './utils/hex.js';
-export { loadFromStorage, persistToStorage } from './utils/local-storage.js';
-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';
-export { findGeoColumn, findGeoColumnFromRows, parseWKB, toBinary } from './utils/wkb.js';