@walkthru-earth/objex 1.0.0 → 1.1.0

package/README.md

@@ -1,5 +1,10 @@
 # objex
 
+[![npm](https://img.shields.io/npm/v/@walkthru-earth/objex?label=%40walkthru-earth%2Fobjex&color=cb3837)](https://www.npmjs.com/package/@walkthru-earth/objex)
+[![npm](https://img.shields.io/npm/v/@walkthru-earth/objex-utils?label=%40walkthru-earth%2Fobjex-utils&color=cb3837)](https://www.npmjs.com/package/@walkthru-earth/objex-utils)
+[![CI](https://github.com/walkthru-earth/objex/actions/workflows/ci.yml/badge.svg)](https://github.com/walkthru-earth/objex/actions/workflows/ci.yml)
+[![License: CC BY 4.0](https://img.shields.io/badge/license-CC%20BY%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)
+
 Cloud storage explorer that runs entirely in the browser. Connect to S3, Azure, GCS, R2, MinIO -- browse files, query data with SQL, and visualize geospatial formats on interactive maps. No backend required.
 
 ```mermaid
@@ -92,12 +97,14 @@ import {
 | `./utils/geoarrow` | `buildGeoArrowTables`, `normalizeGeomType` |
 | `./utils/storage-url` | `parseStorageUrl`, `looksLikeUrl` |
 | `./utils/parquet-metadata` | `readParquetMetadata`, `extractEpsgFromGeoMeta` |
-| `./utils/format` | `formatFileSize`, `formatDate`, `getFileExtension` |
+| `./utils/format` | `formatFileSize`, `formatDate`, `formatValue`, `getFileExtension`, `jsonReplacerBigInt` |
 | `./utils/hex` | `generateHexDump` |
 | `./utils/column-types` | `classifyType`, `typeColor`, `typeBadgeClass` |
 | `./file-icons` | `getFileTypeInfo`, `getDuckDbReadFn`, `getViewerKind` |
 | `./types` | `FileEntry`, `Connection`, `Tab`, `WriteResult`, `Theme` |
 
+The main export also includes `copyToClipboard`, `handleLoadError`, and shared constants (`WGS84_CODES`, `STORAGE_KEYS`, `DEFAULT_TARGET_CRS`, etc.).
+
 ## Quick Start (Development)
 
 ```bash

package/dist/components/browser/FileBrowser.svelte

@@ -8,6 +8,12 @@ import { browser } from '../../stores/browser.svelte.js';
 import { safeLock } from '../../stores/safelock.svelte.js';
 import { tabs } from '../../stores/tabs.svelte.js';
 import type { FileEntry } from '../../types.js';
+import {
+	type SortConfig,
+	type SortField,
+	sortFileEntries,
+	toggleSortField
+} from '../../utils/file-sort.js';
 import { detectZarrMarkers } from '../../utils/zarr.js';
 import Breadcrumb from './Breadcrumb.svelte';
 import CreateFolderDialog from './CreateFolderDialog.svelte';
@@ -18,12 +24,8 @@ import RenameDialog from './RenameDialog.svelte';
 import SearchBar from './SearchBar.svelte';
 import UploadButton from './UploadButton.svelte';
 
-type SortField = 'name' | 'size' | 'modified' | 'extension';
-type SortDirection = 'asc' | 'desc';
-
 let filterQuery = $state('');
-let sortField = $state<SortField>('name');
-let sortDirection = $state<SortDirection>('asc');
+let sortConfig = $state<SortConfig>({ field: 'name', direction: 'asc' });
 
 let deleteDialogOpen = $state(false);
 let deleteTarget = $state<FileEntry | null>(null);
@@ -50,7 +52,7 @@ function openAsZarr() {
 }
 
 const sortedAndFilteredEntries = $derived.by(() => {
-	let result = [...browser.entries];
+	let result = browser.entries;
 
 	// Filter
 	if (filterQuery) {
@@ -58,28 +60,7 @@ const sortedAndFilteredEntries = $derived.by(() => {
 		result = result.filter((entry: FileEntry) => entry.name.toLowerCase().includes(q));
 	}
 
-	// Sort
-	const dir = sortDirection === 'asc' ? 1 : -1;
-	result.sort((a, b) => {
-		// Directories always come first
-		if (a.is_dir && !b.is_dir) return -1;
-		if (!a.is_dir && b.is_dir) return 1;
-
-		switch (sortField) {
-			case 'name':
-				return dir * a.name.localeCompare(b.name, undefined, { sensitivity: 'base' });
-			case 'size':
-				return dir * (a.size - b.size);
-			case 'modified':
-				return dir * (a.modified - b.modified);
-			case 'extension':
-				return dir * a.extension.localeCompare(b.extension, undefined, { sensitivity: 'base' });
-			default:
-				return 0;
-		}
-	});
-
-	return result;
+	return sortFileEntries(result, sortConfig);
 });
 
 function handleFilter(query: string) {
@@ -91,12 +72,7 @@ function handleNavigate(path: string) {
 }
 
 function handleSort(field: SortField) {
-	if (sortField === field) {
-		sortDirection = sortDirection === 'asc' ? 'desc' : 'asc';
-	} else {
-		sortField = field;
-		sortDirection = 'asc';
-	}
+	sortConfig = toggleSortField(sortConfig, field);
 }
 
 function handleDelete(entry: FileEntry) {
@@ -152,8 +128,8 @@ function handleRename(entry: FileEntry) {
 			onclick={() => handleSort('name')}
 		>
 			{t('fileBrowser.name')}
-			{#if sortField === 'name'}
-				{#if sortDirection === 'asc'}
+			{#if sortConfig.field === 'name'}
+				{#if sortConfig.direction === 'asc'}
 					<ArrowUp class="size-3" />
 				{:else}
 					<ArrowDown class="size-3" />
@@ -166,8 +142,8 @@ function handleRename(entry: FileEntry) {
 			class="text-muted-foreground hover:text-foreground flex w-20 shrink-0 items-center justify-end gap-1 transition-colors"
 			onclick={() => handleSort('size')}
 		>
-			{#if sortField === 'size'}
-				{#if sortDirection === 'asc'}
+			{#if sortConfig.field === 'size'}
+				{#if sortConfig.direction === 'asc'}
 					<ArrowUp class="size-3" />
 				{:else}
 					<ArrowDown class="size-3" />
@@ -179,8 +155,8 @@ function handleRename(entry: FileEntry) {
 			class="text-muted-foreground hover:text-foreground flex w-24 shrink-0 items-center justify-end gap-1 transition-colors"
 			onclick={() => handleSort('modified')}
 		>
-			{#if sortField === 'modified'}
-				{#if sortDirection === 'asc'}
+			{#if sortConfig.field === 'modified'}
+				{#if sortConfig.direction === 'asc'}
 					<ArrowUp class="size-3" />
 				{:else}
 					<ArrowDown class="size-3" />

package/dist/components/browser/FileTreeSidebar.svelte

@@ -17,7 +17,7 @@ import { getAdapter } from '../../storage/index.js';
 import { browser } from '../../stores/browser.svelte.js';
 import { tabs } from '../../stores/tabs.svelte.js';
 import type { Connection, FileEntry } from '../../types.js';
-import { getNativeScheme } from '../../utils/url.js';
+import { getNativeScheme } from '../../utils/cloud-url.js';
 import { syncUrlParam } from '../../utils/url-state.js';
 
 let {

package/dist/index.d.ts

@@ -4,17 +4,26 @@ export { buildDuckDbSource, getDuckDbReadFn, getFileTypeInfo, getMimeType, getVi
 export type { MapQueryHandle, MapQueryResult, QueryEngine, QueryHandle, QueryResult, SchemaField } from './query/engine.js';
 export { QueryCancelledError } from './query/engine.js';
 export type { ListPage, StorageAdapter } from './storage/adapter.js';
+export type { ProviderDef, ProviderId, ProviderRegion } from './storage/providers.js';
+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 { TypeCategory } from './utils/column-types.js';
 export { classifyType, typeBadgeClass, typeColor, typeLabel } from './utils/column-types.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 { Defaults, ParsedStorageUrl, StorageProvider } from './utils/storage-url.js';

package/dist/index.js

@@ -4,15 +4,24 @@ export { COPY_FEEDBACK_MS, DEFAULT_TARGET_CRS, DUCKDB_INIT_TIMEOUT_MS, LAYER_HUE
 // File icons registry
 export { buildDuckDbSource, getDuckDbReadFn, getFileTypeInfo, getMimeType, getViewerKind, isCloudNativeFormat, isQueryable } from './file-icons/index.js';
 export { QueryCancelledError } from './query/engine.js';
+export { buildEndpointFromTemplate, buildProviderBaseUrl, getProvider, isGcsProvider, PROVIDER_IDS, PROVIDERS } from './storage/providers.js';
 export { UrlAdapter } from './storage/url-adapter.js';
 // Clipboard
 export { copyToClipboard, wireCodeCopyButtons } from './utils/clipboard.js';
+// Cloud URL resolution
+export { getNativeScheme, resolveCloudUrl, safeDecodeURIComponent } from './utils/cloud-url.js';
 export { classifyType, typeBadgeClass, typeColor, typeLabel } from './utils/column-types.js';
 // Error handling
 export { handleLoadError } from './utils/error.js';
+// Data export / serialization
+export { escapeCsvField, serializeToCsv, serializeToJson } from './utils/export.js';
+export { sortFileEntries, toggleSortField } from './utils/file-sort.js';
 export { formatDate, formatFileSize, formatValue, getFileExtension, jsonReplacerBigInt } from './utils/format.js';
 export { buildGeoArrowTables, normalizeGeomType } from './utils/geoarrow.js';
 export { generateHexDump } from './utils/hex.js';
+// localStorage helpers
+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 { describeParseResult, looksLikeUrl, parseStorageUrl } from './utils/storage-url.js';
 // Utilities

package/dist/stores/connections.svelte.js

@@ -1,33 +1,7 @@
 import { STORAGE_KEYS } from '../constants.js';
+import { loadFromStorage, persistToStorage } from '../utils/local-storage.js';
 import { credentialStore, storeToNative } from './credentials.svelte.js';
 // ---------------------------------------------------------------------------
-// localStorage helpers
-// ---------------------------------------------------------------------------
-function loadFromLocalStorage() {
-    if (typeof window === 'undefined')
-        return [];
-    try {
-        const raw = localStorage.getItem(STORAGE_KEYS.CONNECTIONS);
-        if (raw) {
-            return JSON.parse(raw);
-        }
-    }
-    catch {
-        // ignore parse errors
-    }
-    return [];
-}
-function persistToLocalStorage(connections) {
-    if (typeof window === 'undefined')
-        return;
-    try {
-        localStorage.setItem(STORAGE_KEYS.CONNECTIONS, JSON.stringify(connections));
-    }
-    catch {
-        // ignore storage errors
-    }
-}
-// ---------------------------------------------------------------------------
 // Store
 // ---------------------------------------------------------------------------
 function createConnectionsStore() {
@@ -48,7 +22,7 @@ function createConnectionsStore() {
         async load() {
             if (loaded)
                 return;
-            connections = loadFromLocalStorage();
+            connections = loadFromStorage(STORAGE_KEYS.CONNECTIONS, []);
             loaded = true;
         },
         /**
@@ -75,7 +49,7 @@ function createConnectionsStore() {
                 rootPrefix: config.rootPrefix
             };
             connections = [...connections, conn];
-            persistToLocalStorage(connections);
+            persistToStorage(STORAGE_KEYS.CONNECTIONS, connections);
             // Store credentials in memory (never persisted to localStorage).
             if (!config.anonymous) {
                 if (config.sas_token) {
@@ -114,7 +88,7 @@ function createConnectionsStore() {
                 rootPrefix: config.rootPrefix
             };
             connections = [...connections];
-            persistToLocalStorage(connections);
+            persistToStorage(STORAGE_KEYS.CONNECTIONS, connections);
             // Invalidate cached adapter for this connection
             import('../storage/index.js').then(({ clearAdapterCache }) => clearAdapterCache(id));
             // Update in-memory credentials.
@@ -148,7 +122,7 @@ function createConnectionsStore() {
         async remove(id) {
             const before = connections.length;
             connections = connections.filter((c) => c.id !== id);
-            persistToLocalStorage(connections);
+            persistToStorage(STORAGE_KEYS.CONNECTIONS, connections);
             credentialStore.remove(id);
             // Invalidate cached adapter for this connection
             import('../storage/index.js').then(({ clearAdapterCache }) => clearAdapterCache(id));

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

@@ -1,10 +1,5 @@
 import type { FileEntry } from '../types.js';
-export type SortField = 'name' | 'size' | 'modified' | 'extension';
-export type SortDirection = 'asc' | 'desc';
-export interface SortConfig {
-    field: SortField;
-    direction: SortDirection;
-}
+import { type SortConfig, type SortField } from '../utils/file-sort.js';
 export declare const fileStore: {
     readonly entries: FileEntry[];
     readonly currentPath: string;

package/dist/stores/files.svelte.js

@@ -1,27 +1,4 @@
-function sortEntries(entries, config) {
-    const sorted = [...entries];
-    const dir = config.direction === 'asc' ? 1 : -1;
-    sorted.sort((a, b) => {
-        // Directories always come first
-        if (a.is_dir && !b.is_dir)
-            return -1;
-        if (!a.is_dir && b.is_dir)
-            return 1;
-        switch (config.field) {
-            case 'name':
-                return dir * a.name.localeCompare(b.name, undefined, { sensitivity: 'base' });
-            case 'size':
-                return dir * (a.size - b.size);
-            case 'modified':
-                return dir * (a.modified - b.modified);
-            case 'extension':
-                return dir * a.extension.localeCompare(b.extension, undefined, { sensitivity: 'base' });
-            default:
-                return 0;
-        }
-    });
-    return sorted;
-}
+import { sortFileEntries, toggleSortField } from '../utils/file-sort.js';
 function createFilesStore() {
     let files = $state([]);
     let currentPath = $state('');
@@ -45,7 +22,7 @@ function createFilesStore() {
             return sortConfig;
         },
         setFiles(entries) {
-            files = sortEntries(entries, sortConfig);
+            files = sortFileEntries(entries, sortConfig);
             error = null;
         },
         setPath(path) {
@@ -58,17 +35,8 @@ function createFilesStore() {
             error = message;
         },
         sort(field) {
-            if (sortConfig.field === field) {
-                // Toggle direction if clicking the same field
-                sortConfig = {
-                    field,
-                    direction: sortConfig.direction === 'asc' ? 'desc' : 'asc'
-                };
-            }
-            else {
-                sortConfig = { field, direction: 'asc' };
-            }
-            files = sortEntries(files, sortConfig);
+            sortConfig = toggleSortField(sortConfig, field);
+            files = sortFileEntries(files, sortConfig);
         }
     };
 }

package/dist/stores/query-history.svelte.js

@@ -1,31 +1,9 @@
 import { MAX_QUERY_HISTORY_ENTRIES, STORAGE_KEYS } from '../constants.js';
-function loadEntries() {
-    if (typeof window === 'undefined')
-        return [];
-    try {
-        const raw = localStorage.getItem(STORAGE_KEYS.QUERY_HISTORY);
-        if (raw)
-            return JSON.parse(raw);
-    }
-    catch {
-        // ignore parse errors
-    }
-    return [];
-}
-function persistEntries(entries) {
-    if (typeof window === 'undefined')
-        return;
-    try {
-        localStorage.setItem(STORAGE_KEYS.QUERY_HISTORY, JSON.stringify(entries));
-    }
-    catch {
-        // ignore storage errors
-    }
-}
+import { loadFromStorage, persistToStorage } from '../utils/local-storage.js';
 function createQueryHistoryStore() {
-    let entries = $state(loadEntries());
+    let entries = $state(loadFromStorage(STORAGE_KEYS.QUERY_HISTORY, []));
     function save() {
-        persistEntries(entries);
+        persistToStorage(STORAGE_KEYS.QUERY_HISTORY, entries);
     }
     return {
         get entries() {

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

@@ -1,5 +1,6 @@
 import { type Locale } from '../i18n/index.svelte.js';
 import type { Theme } from '../types.js';
+export declare function resolveTheme(theme: Theme): 'light' | 'dark';
 export declare const settings: {
     readonly theme: Theme;
     readonly resolved: "light" | "dark";

package/dist/stores/settings.svelte.js

@@ -1,36 +1,16 @@
 import { STORAGE_KEYS } from '../constants.js';
 import { setLocale } from '../i18n/index.svelte.js';
+import { loadFromStorage, persistToStorage } from '../utils/local-storage.js';
+const SETTINGS_DEFAULTS = { theme: 'system', locale: 'en', featureLimit: 1000 };
 function loadSettings() {
-    if (typeof window === 'undefined') {
-        return { theme: 'system', locale: 'en', featureLimit: 1000 };
-    }
-    try {
-        const raw = localStorage.getItem(STORAGE_KEYS.SETTINGS);
-        if (raw) {
-            const parsed = JSON.parse(raw);
-            return {
-                theme: parsed.theme ?? 'system',
-                locale: parsed.locale ?? 'en',
-                featureLimit: parsed.featureLimit ?? 1000
-            };
-        }
-    }
-    catch {
-        // ignore parse errors
-    }
-    return { theme: 'system', locale: 'en', featureLimit: 1000 };
-}
-function persistSettings(settings) {
-    if (typeof window === 'undefined')
-        return;
-    try {
-        localStorage.setItem(STORAGE_KEYS.SETTINGS, JSON.stringify(settings));
-    }
-    catch {
-        // ignore storage errors
-    }
+    const stored = loadFromStorage(STORAGE_KEYS.SETTINGS, {});
+    return {
+        theme: stored.theme ?? SETTINGS_DEFAULTS.theme,
+        locale: stored.locale ?? SETTINGS_DEFAULTS.locale,
+        featureLimit: stored.featureLimit ?? SETTINGS_DEFAULTS.featureLimit
+    };
 }
-function resolveTheme(theme) {
+export function resolveTheme(theme) {
     if (theme !== 'system')
         return theme;
     if (typeof window === 'undefined')
@@ -51,7 +31,7 @@ function createSettingsStore() {
         document.documentElement.lang = initial.locale;
     }
     function persist() {
-        persistSettings({ theme, locale, featureLimit });
+        persistToStorage(STORAGE_KEYS.SETTINGS, { theme, locale, featureLimit });
     }
     function applyTheme(t) {
         theme = t;

package/dist/utils/cloud-url.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Cloud storage protocol URL utilities — pure TS, no Svelte dependency.
+ *
+ * Converts cloud protocol URLs (s3://, gs://) to HTTPS URLs for browser access.
+ * Provider-aware native scheme lookup.
+ */
+/**
+ * Map provider to its native URI scheme prefix.
+ * Derived from the registry's `schemes` array (first entry is the primary scheme).
+ * Falls back to 's3' for providers without a scheme (S3-compatible).
+ */
+export declare function getNativeScheme(provider: string): string;
+/**
+ * Safely decode a percent-encoded URI component.
+ * Returns the original string if decoding fails (malformed sequences).
+ */
+export declare function safeDecodeURIComponent(s: string): string;
+/**
+ * Convert a cloud storage protocol URL (s3://, gs://) to an HTTPS URL
+ * for browser access. Returns the original URL if already HTTP(S) or unknown.
+ *
+ * Supported:
+ * - `s3://bucket/key` → `https://s3.{region}.amazonaws.com/{bucket}/{key}`
+ *   (region auto-detected from bucket name when possible)
+ * - `gs://bucket/key` → `https://storage.googleapis.com/{bucket}/{key}`
+ */
+export declare function resolveCloudUrl(url: string): string;

package/dist/utils/cloud-url.js

@@ -0,0 +1,61 @@
+/**
+ * Cloud storage protocol URL utilities — pure TS, no Svelte dependency.
+ *
+ * Converts cloud protocol URLs (s3://, gs://) to HTTPS URLs for browser access.
+ * Provider-aware native scheme lookup.
+ */
+import { buildProviderBaseUrl, PROVIDERS } from '../storage/providers.js';
+/** AWS region pattern — matches prefixes like "us-west-2", "eu-central-1", etc. */
+const AWS_REGION_RE = /^(us|eu|ap|sa|ca|me|af|il)-(north|south|east|west|central|northeast|southeast|northwest|southwest)-\d+/;
+/**
+ * Map provider to its native URI scheme prefix.
+ * Derived from the registry's `schemes` array (first entry is the primary scheme).
+ * Falls back to 's3' for providers without a scheme (S3-compatible).
+ */
+export function getNativeScheme(provider) {
+    const def = PROVIDERS[provider];
+    if (def?.schemes.length)
+        return def.schemes[0];
+    return 's3';
+}
+/**
+ * Safely decode a percent-encoded URI component.
+ * Returns the original string if decoding fails (malformed sequences).
+ */
+export function safeDecodeURIComponent(s) {
+    try {
+        return decodeURIComponent(s);
+    }
+    catch {
+        return s;
+    }
+}
+/**
+ * Convert a cloud storage protocol URL (s3://, gs://) to an HTTPS URL
+ * for browser access. Returns the original URL if already HTTP(S) or unknown.
+ *
+ * Supported:
+ * - `s3://bucket/key` → `https://s3.{region}.amazonaws.com/{bucket}/{key}`
+ *   (region auto-detected from bucket name when possible)
+ * - `gs://bucket/key` → `https://storage.googleapis.com/{bucket}/{key}`
+ */
+export function resolveCloudUrl(url) {
+    // S3 / S3-compatible: s3://, s3a://, s3n://
+    const s3Match = url.match(/^s3[an]?:\/\/([^/]+)\/?(.*)$/);
+    if (s3Match) {
+        const [, bucket, key] = s3Match;
+        // Detect region from bucket name (e.g. "us-west-2.opendata.source.coop")
+        const regionMatch = bucket.match(AWS_REGION_RE);
+        const region = regionMatch ? regionMatch[0] : 'us-east-1';
+        const base = buildProviderBaseUrl('s3', '', bucket, region);
+        return key ? `${base}/${key}` : base;
+    }
+    // Google Cloud Storage: gs://, gcs://
+    const gcsMatch = url.match(/^gcs?:\/\/([^/]+)\/?(.*)$/);
+    if (gcsMatch) {
+        const [, bucket, key] = gcsMatch;
+        const base = buildProviderBaseUrl('gcs', '', bucket, '');
+        return key ? `${base}/${key}` : base;
+    }
+    return url;
+}

package/dist/utils/export.d.ts

@@ -1,2 +1,22 @@
-export declare function exportToCsv(columns: string[], rows: Record<string, any>[], filename: string): void;
-export declare function exportToJson(columns: string[], rows: Record<string, any>[], filename: string): void;
+/**
+ * Escape a CSV field value per RFC 4180.
+ */
+export declare function escapeCsvField(value: string): string;
+/**
+ * Serialize column/row data to a CSV string.
+ * Pure function — no browser APIs, works in Node.js.
+ */
+export declare function serializeToCsv(columns: string[], rows: Record<string, unknown>[]): string;
+/**
+ * Serialize column/row data to a formatted JSON string.
+ * Pure function — no browser APIs, works in Node.js.
+ */
+export declare function serializeToJson(columns: string[], rows: Record<string, unknown>[]): string;
+/**
+ * Export data as CSV file (triggers browser download).
+ */
+export declare function exportToCsv(columns: string[], rows: Record<string, unknown>[], filename: string): void;
+/**
+ * Export data as JSON file (triggers browser download).
+ */
+export declare function exportToJson(columns: string[], rows: Record<string, unknown>[], filename: string): void;

package/dist/utils/export.js

@@ -1,3 +1,4 @@
+import { jsonReplacerBigInt } from './format.js';
 function triggerDownload(content, filename, mimeType) {
     const blob = new Blob([content], { type: mimeType });
     const url = URL.createObjectURL(blob);
@@ -9,30 +10,43 @@ function triggerDownload(content, filename, mimeType) {
     document.body.removeChild(a);
     URL.revokeObjectURL(url);
 }
-function formatValue(value) {
+/** Format a cell value for export (empty string for null/undefined). */
+function formatCellValue(value) {
     if (value === null || value === undefined)
         return '';
     if (value instanceof Date)
         return value.toISOString();
+    if (typeof value === 'bigint')
+        return value.toString();
     if (typeof value === 'object')
-        return JSON.stringify(value);
+        return JSON.stringify(value, jsonReplacerBigInt);
     return String(value);
 }
-function escapeCsvField(value) {
+/**
+ * Escape a CSV field value per RFC 4180.
+ */
+export function escapeCsvField(value) {
     if (value.includes(',') || value.includes('"') || value.includes('\n') || value.includes('\r')) {
         return `"${value.replace(/"/g, '""')}"`;
     }
     return value;
 }
-export function exportToCsv(columns, rows, filename) {
+/**
+ * Serialize column/row data to a CSV string.
+ * Pure function — no browser APIs, works in Node.js.
+ */
+export function serializeToCsv(columns, rows) {
     const header = columns.map(escapeCsvField).join(',');
     const body = rows
-        .map((row) => columns.map((col) => escapeCsvField(formatValue(row[col]))).join(','))
+        .map((row) => columns.map((col) => escapeCsvField(formatCellValue(row[col]))).join(','))
         .join('\n');
-    const csv = `${header}\n${body}`;
-    triggerDownload(csv, filename.endsWith('.csv') ? filename : `${filename}.csv`, 'text/csv;charset=utf-8;');
+    return `${header}\n${body}`;
 }
-export function exportToJson(columns, rows, filename) {
+/**
+ * Serialize column/row data to a formatted JSON string.
+ * Pure function — no browser APIs, works in Node.js.
+ */
+export function serializeToJson(columns, rows) {
     const data = rows.map((row) => {
         const obj = {};
         for (const col of columns) {
@@ -46,6 +60,17 @@ export function exportToJson(columns, rows, filename) {
         }
         return obj;
     });
-    const json = JSON.stringify(data, null, 2);
-    triggerDownload(json, filename.endsWith('.json') ? filename : `${filename}.json`, 'application/json');
+    return JSON.stringify(data, jsonReplacerBigInt, 2);
+}
+/**
+ * Export data as CSV file (triggers browser download).
+ */
+export function exportToCsv(columns, rows, filename) {
+    triggerDownload(serializeToCsv(columns, rows), filename.endsWith('.csv') ? filename : `${filename}.csv`, 'text/csv;charset=utf-8;');
+}
+/**
+ * Export data as JSON file (triggers browser download).
+ */
+export function exportToJson(columns, rows, filename) {
+    triggerDownload(serializeToJson(columns, rows), filename.endsWith('.json') ? filename : `${filename}.json`, 'application/json');
 }

package/dist/utils/file-sort.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Pure file entry sorting — framework-agnostic, works in Node.js.
+ */
+import type { FileEntry } from '../types.js';
+export type SortField = 'name' | 'size' | 'modified' | 'extension';
+export type SortDirection = 'asc' | 'desc';
+export interface SortConfig {
+    field: SortField;
+    direction: SortDirection;
+}
+/**
+ * Sort file entries by the given config.
+ * Directories always sort before files regardless of sort field.
+ * Returns a new array (does not mutate the input).
+ */
+export declare function sortFileEntries(entries: FileEntry[], config: SortConfig): FileEntry[];
+/**
+ * Toggle sort config: same field flips direction, new field starts ascending.
+ */
+export declare function toggleSortField(current: SortConfig, field: SortField): SortConfig;

package/dist/utils/file-sort.js

@@ -0,0 +1,41 @@
+/**
+ * Pure file entry sorting — framework-agnostic, works in Node.js.
+ */
+/**
+ * Sort file entries by the given config.
+ * Directories always sort before files regardless of sort field.
+ * Returns a new array (does not mutate the input).
+ */
+export function sortFileEntries(entries, config) {
+    const sorted = [...entries];
+    const dir = config.direction === 'asc' ? 1 : -1;
+    sorted.sort((a, b) => {
+        // Directories always come first
+        if (a.is_dir && !b.is_dir)
+            return -1;
+        if (!a.is_dir && b.is_dir)
+            return 1;
+        switch (config.field) {
+            case 'name':
+                return dir * a.name.localeCompare(b.name, undefined, { sensitivity: 'base' });
+            case 'size':
+                return dir * (a.size - b.size);
+            case 'modified':
+                return dir * (a.modified - b.modified);
+            case 'extension':
+                return dir * a.extension.localeCompare(b.extension, undefined, { sensitivity: 'base' });
+            default:
+                return 0;
+        }
+    });
+    return sorted;
+}
+/**
+ * Toggle sort config: same field flips direction, new field starts ascending.
+ */
+export function toggleSortField(current, field) {
+    if (current.field === field) {
+        return { field, direction: current.direction === 'asc' ? 'desc' : 'asc' };
+    }
+    return { field, direction: 'asc' };
+}

package/dist/utils/local-storage.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generic localStorage helpers with SSR safety.
+ *
+ * Used by connection, settings, and query-history stores to avoid
+ * repeating the same load/persist/try-catch/SSR-guard pattern.
+ */
+/**
+ * Load a JSON value from localStorage.
+ * Returns `defaultValue` on SSR, missing key, or parse error.
+ */
+export declare function loadFromStorage<T>(key: string, defaultValue: T): T;
+/**
+ * Persist a JSON-serializable value to localStorage.
+ * Silently no-ops on SSR or storage errors (quota, private browsing).
+ */
+export declare function persistToStorage(key: string, value: unknown): void;

package/dist/utils/local-storage.js

@@ -0,0 +1,37 @@
+/**
+ * Generic localStorage helpers with SSR safety.
+ *
+ * Used by connection, settings, and query-history stores to avoid
+ * repeating the same load/persist/try-catch/SSR-guard pattern.
+ */
+/**
+ * Load a JSON value from localStorage.
+ * Returns `defaultValue` on SSR, missing key, or parse error.
+ */
+export function loadFromStorage(key, defaultValue) {
+    if (typeof window === 'undefined')
+        return defaultValue;
+    try {
+        const raw = localStorage.getItem(key);
+        if (raw)
+            return JSON.parse(raw);
+    }
+    catch {
+        // ignore parse errors
+    }
+    return defaultValue;
+}
+/**
+ * Persist a JSON-serializable value to localStorage.
+ * Silently no-ops on SSR or storage errors (quota, private browsing).
+ */
+export function persistToStorage(key, value) {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        localStorage.setItem(key, JSON.stringify(value));
+    }
+    catch {
+        // ignore storage errors
+    }
+}

package/dist/utils/url.d.ts

@@ -4,12 +4,6 @@ import type { Tab } from '../types.js';
  * Works for any viewer that needs an HTTP-accessible URL (COG, PMTiles, Zarr, etc.)
  */
 export declare function buildHttpsUrl(tab: Tab): string;
-/**
- * Map provider to its native URI scheme prefix.
- * Derived from the registry's `schemes` array (first entry is the primary scheme).
- * Falls back to 's3' for providers without a scheme (S3-compatible).
- */
-export declare function getNativeScheme(provider: string): string;
 /**
  * Build a provider-native protocol URL (s3://bucket/path, sj://bucket/path, etc.).
  */
@@ -29,13 +23,3 @@ export declare function buildDuckDbUrl(tab: Tab): string;
  * False for authenticated S3 (needs signed URLs or blob download via adapter).
  */
 export declare function canStreamDirectly(tab: Tab): boolean;
-/**
- * Convert a cloud storage protocol URL (s3://, gs://) to an HTTPS URL
- * for browser access. Returns the original URL if already HTTP(S) or unknown.
- *
- * Supported:
- * - `s3://bucket/key` → `https://s3.{region}.amazonaws.com/{bucket}/{key}`
- *   (region auto-detected from bucket name when possible, e.g. "us-west-2.opendata.source.coop")
- * - `gs://bucket/key` → `https://storage.googleapis.com/{bucket}/{key}`
- */
-export declare function resolveCloudUrl(url: string): string;

package/dist/utils/url.js

@@ -1,6 +1,7 @@
-import { buildProviderBaseUrl, PROVIDERS } from '../storage/providers.js';
+import { buildProviderBaseUrl } from '../storage/providers.js';
 import { connections } from '../stores/connections.svelte.js';
 import { credentialStore } from '../stores/credentials.svelte.js';
+import { getNativeScheme, safeDecodeURIComponent } from './cloud-url.js';
 /**
  * Build an HTTPS URL for a tab's file.
  * Works for any viewer that needs an HTTP-accessible URL (COG, PMTiles, Zarr, etc.)
@@ -19,17 +20,6 @@ export function buildHttpsUrl(tab) {
     }
     return `${buildProviderBaseUrl(conn.provider, conn.endpoint, conn.bucket, conn.region)}/${cleanPath}`;
 }
-/**
- * Map provider to its native URI scheme prefix.
- * Derived from the registry's `schemes` array (first entry is the primary scheme).
- * Falls back to 's3' for providers without a scheme (S3-compatible).
- */
-export function getNativeScheme(provider) {
-    const def = PROVIDERS[provider];
-    if (def?.schemes.length)
-        return def.schemes[0];
-    return 's3';
-}
 /**
  * Build a provider-native protocol URL (s3://bucket/path, sj://bucket/path, etc.).
  */
@@ -68,14 +58,6 @@ export function buildDuckDbUrl(tab) {
     const rawPath = safeDecodeURIComponent(tab.path.replace(/^\//, ''));
     return `s3://${conn.bucket}/${rawPath}`;
 }
-function safeDecodeURIComponent(s) {
-    try {
-        return decodeURIComponent(s);
-    }
-    catch {
-        return s;
-    }
-}
 /**
  * Check if a tab's file can be loaded directly via HTTPS URL (streaming).
  * True for URL-sourced tabs, anonymous buckets, and Azure (SAS token in URL).
@@ -105,37 +87,3 @@ function appendAzureSas(url, connectionId) {
     const sep = url.includes('?') ? '&' : '?';
     return `${url}${sep}${cleanToken}`;
 }
-// ---------------------------------------------------------------------------
-// Cloud protocol URL → HTTPS conversion
-// ---------------------------------------------------------------------------
-/** AWS region pattern — matches prefixes like "us-west-2", "eu-central-1", etc. */
-const AWS_REGION_RE = /^(us|eu|ap|sa|ca|me|af|il)-(north|south|east|west|central|northeast|southeast|northwest|southwest)-\d+/;
-/**
- * Convert a cloud storage protocol URL (s3://, gs://) to an HTTPS URL
- * for browser access. Returns the original URL if already HTTP(S) or unknown.
- *
- * Supported:
- * - `s3://bucket/key` → `https://s3.{region}.amazonaws.com/{bucket}/{key}`
- *   (region auto-detected from bucket name when possible, e.g. "us-west-2.opendata.source.coop")
- * - `gs://bucket/key` → `https://storage.googleapis.com/{bucket}/{key}`
- */
-export function resolveCloudUrl(url) {
-    // S3 / S3-compatible: s3://, s3a://, s3n://
-    const s3Match = url.match(/^s3[an]?:\/\/([^/]+)\/?(.*)$/);
-    if (s3Match) {
-        const [, bucket, key] = s3Match;
-        // Detect region from bucket name (e.g. "us-west-2.opendata.source.coop")
-        const regionMatch = bucket.match(AWS_REGION_RE);
-        const region = regionMatch ? regionMatch[0] : 'us-east-1';
-        const base = buildProviderBaseUrl('s3', '', bucket, region);
-        return key ? `${base}/${key}` : base;
-    }
-    // Google Cloud Storage: gs://, gcs://
-    const gcsMatch = url.match(/^gcs?:\/\/([^/]+)\/?(.*)$/);
-    if (gcsMatch) {
-        const [, bucket, key] = gcsMatch;
-        const base = buildProviderBaseUrl('gcs', '', bucket, '');
-        return key ? `${base}/${key}` : base;
-    }
-    return url;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walkthru-earth/objex",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Svelte 5 components and utilities for exploring geospatial object storage — S3, GCS, Azure, R2",
   "author": "Youssef Harby <yharby@walkthru.earth>",
   "license": "CC-BY-4.0",
@@ -123,13 +123,14 @@
     }
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.6",
+    "@biomejs/biome": "^2.4.7",
     "@changesets/changelog-github": "^0.5.2",
     "@changesets/cli": "^2.30.0",
+    "@fontsource/cairo": "^5.2.7",
     "@internationalized/date": "^3.12.0",
     "@lucide/svelte": "^0.561.0",
     "@sveltejs/adapter-static": "^3.0.10",
-    "@sveltejs/kit": "^2.53.4",
+    "@sveltejs/kit": "^2.55.0",
     "@sveltejs/package": "^2.5.7",
     "@sveltejs/vite-plugin-svelte": "^6.2.4",
     "@tailwindcss/forms": "^0.5.11",
@@ -137,12 +138,11 @@
     "@tailwindcss/vite": "^4.2.1",
     "bits-ui": "^2.16.3",
     "clsx": "^2.1.1",
-    "@fontsource/cairo": "^5.2.7",
-    "lefthook": "^2.1.3",
+    "lefthook": "^2.1.4",
     "paneforge": "^1.0.2",
-    "posthog-js": "^1.360.0",
+    "posthog-js": "^1.360.2",
     "publint": "^0.3.18",
-    "svelte": "^5.53.9",
+    "svelte": "^5.53.12",
     "svelte-check": "^4.4.5",
     "tailwind-merge": "^3.5.0",
     "tailwind-variants": "^3.2.2",
@@ -152,16 +152,16 @@
     "vite": "^7.3.1"
   },
   "dependencies": {
-    "@babylonjs/core": "^8.54.1",
-    "@babylonjs/loaders": "^8.54.1",
+    "@babylonjs/core": "^8.55.3",
+    "@babylonjs/loaders": "^8.55.3",
     "@carbonplan/zarr-layer": "^0.3.1",
     "@codemirror/autocomplete": "^6.20.1",
-    "@codemirror/commands": "^6.10.2",
+    "@codemirror/commands": "^6.10.3",
     "@codemirror/lang-sql": "^6.10.0",
     "@codemirror/language": "^6.12.2",
-    "@codemirror/state": "^6.5.4",
+    "@codemirror/state": "^6.6.0",
     "@codemirror/theme-one-dark": "^6.1.3",
-    "@codemirror/view": "^6.39.16",
+    "@codemirror/view": "^6.40.0",
     "@deck.gl/core": "^9.2.11",
     "@deck.gl/geo-layers": "^9.2.11",
     "@deck.gl/layers": "^9.2.11",
@@ -182,12 +182,12 @@
     "chart.js": "^4.5.1",
     "deck.gl": "^9.2.11",
     "flatgeobuf": "^4.4.0",
-    "geotiff": "^3.0.4",
+    "geotiff": "^3.0.5",
     "geotiff-geokeys-to-proj4": "^2024.4.13",
     "hyparquet": "^1.25.1",
     "hyparquet-compressors": "^1.1.1",
     "lz-string": "^1.5.0",
-    "maplibre-gl": "^5.19.0",
+    "maplibre-gl": "^5.20.1",
     "marked": "^17.0.4",
     "mermaid": "^11.13.0",
     "pbf": "^4.0.1",