@walkthru-earth/objex-utils 1.1.0 → 1.2.0

package/dist/index.d.cts

@@ -11,8 +11,12 @@ declare const STORAGE_KEYS: {
 };
 /** EPSG codes considered WGS84 (no reprojection needed). */
 declare const WGS84_CODES: Set<number>;
-/** Default target CRS for ST_Transform. */
-declare const DEFAULT_TARGET_CRS = "EPSG:4326";
+/**
+ * Default target CRS for ST_Transform. Uses OGC:CRS84 (longitude, latitude)
+ * to match GeoParquet 1.1+ spec and DuckDB v1.5's canonical form.
+ * Functionally equivalent to EPSG:4326 under `geometry_always_xy = true`.
+ */
+declare const DEFAULT_TARGET_CRS = "OGC:CRS84";
 /** DuckDB-WASM initialization timeout in ms. */
 declare const DUCKDB_INIT_TIMEOUT_MS = 30000;
 /** Maximum entries kept in query history. */
@@ -119,15 +123,27 @@ interface SchemaField {
     type: string;
     nullable: boolean;
 }
+/**
+ * Abstraction over a DuckDB query source. Decouples schema / CRS / count
+ * helpers from assuming a file-backed path. `ref` is the FROM-clause target
+ * inserted into generated SQL (e.g. `read_parquet('url')` for files, or
+ * `attached_db."schema"."table"` for attached databases). `filePath` is
+ * optional and only used as a shortcut for Parquet file-level metadata
+ * queries (`parquet_kv_metadata`, `parquet_file_metadata`), not for SQL.
+ */
+interface QuerySource {
+    ref: string;
+    filePath?: string;
+}
 interface QueryEngine {
     query(connId: string, sql: string): Promise<QueryResult>;
     queryForMap(connId: string, sql: string, geomCol: string, geomColType: string, sourceCrs?: string | null): Promise<MapQueryResult>;
-    getSchema(connId: string, path: string): Promise<SchemaField[]>;
-    getRowCount(connId: string, path: string): Promise<number>;
+    getSchema(connId: string, source: QuerySource): Promise<SchemaField[]>;
+    getRowCount(connId: string, source: QuerySource): Promise<number>;
     /** Detect CRS from GeoParquet metadata. Returns e.g. 'EPSG:27700' or null if WGS84/unknown. */
-    detectCrs(connId: string, path: string, geomCol: string): Promise<string | null>;
+    detectCrs(connId: string, source: QuerySource, geomCol: string): Promise<string | null>;
     /** Combined schema + CRS detection in a single connection (fewer web worker round-trips). */
-    getSchemaAndCrs?(connId: string, path: string, findGeoCol: (schema: SchemaField[]) => string | null): Promise<{
+    getSchemaAndCrs?(connId: string, source: QuerySource, findGeoCol: (schema: SchemaField[]) => string | null): Promise<{
         schema: SchemaField[];
         geomCol: string | null;
         crs: string | null;
@@ -135,6 +151,10 @@ interface QueryEngine {
     queryCancellable?(connId: string, sql: string): QueryHandle;
     queryForMapCancellable?(connId: string, sql: string, geomCol: string, geomColType: string, sourceCrs?: string | null): MapQueryHandle;
     forceCancel?(): Promise<void>;
+    /** Register a file buffer in DuckDB-WASM's virtual filesystem for ATTACH. */
+    registerFileBuffer?(name: string, buffer: Uint8Array): Promise<void>;
+    /** Drop a previously registered file from DuckDB-WASM's virtual filesystem. */
+    dropFile?(name: string): Promise<void>;
     releaseMemory(): Promise<void>;
     dispose(): Promise<void>;
 }
@@ -179,6 +199,17 @@ interface Tab {
     connectionId?: string;
     extension: string;
     size?: number;
+    /**
+     * When set, the tab reads data from a SQL FROM-clause target (e.g. an
+     * attached DuckLake/DuckDB/SQLite table) rather than a file URL. The ref
+     * is inserted directly into generated SQL, so it must be fully-qualified
+     * and pre-quoted, e.g. `__objex_db__."main"."air_quality"`.
+     *
+     * When `sourceRef` is set, file-specific loading paths (hyparquet
+     * metadata, `parquet_kv_metadata`, etc.) are skipped, and schema / CRS /
+     * row count are derived from the SQL source directly via DuckDB.
+     */
+    sourceRef?: string;
 }
 interface WriteResult {
     key: string;
@@ -308,6 +339,32 @@ declare function safeDecodeURIComponent(s: string): string;
  */
 declare function resolveCloudUrl(url: string): string;
 
+/** SampleFormat tag value → human label. */
+declare const SF_LABELS: Record<number, string>;
+interface GeoBounds {
+    west: number;
+    south: number;
+    east: number;
+    north: number;
+}
+interface CogInfo {
+    width: number;
+    height: number;
+    bandCount: number;
+    dataType: string;
+    bounds: GeoBounds;
+    downsampled?: boolean;
+}
+/** Safely clamp a number to a range, treating NaN/Infinity as the fallback. */
+declare function safeClamp(v: number, lo: number, hi: number, fallback: number): number;
+/** Clamp geographic bounds to valid MapLibre web-Mercator range. */
+declare function clampBounds(b: GeoBounds): GeoBounds;
+/**
+ * Build a data-type label from GeoTIFF sample format and bits per sample.
+ * e.g. "uint8", "float32", "int16"
+ */
+declare function buildDataTypeLabel(sampleFormat: number, bitsPerSample: number): string;
+
 type TypeCategory = 'number' | 'string' | 'date' | 'boolean' | 'geo' | 'binary' | 'json' | 'other';
 declare function classifyType(duckdbType: string): TypeCategory;
 declare function typeColor(category: TypeCategory): string;
@@ -464,7 +521,7 @@ interface ParsedMarkdownDocument {
  * SELECT * FROM table
  * ```
  */
-declare function parseMarkdownDocument(markdown: string): ParsedMarkdownDocument;
+declare function parseMarkdownDocument(markdown: string): Promise<ParsedMarkdownDocument>;
 /**
  * Interpolate template variables in markdown text.
  * Supports {queryName.rows[0].columnName} syntax.
@@ -644,4 +701,4 @@ declare function findGeoColumnFromRows(rows: Record<string, unknown>[], schema:
     type: string;
 }[]): string | null;
 
-export { COPY_FEEDBACK_MS, type Connection, type ConnectionConfig, DEFAULT_TARGET_CRS, DUCKDB_INIT_TIMEOUT_MS, type Defaults, type DuckDbReadFn, type FileCategory, type FileEntry, type FileTypeInfo, type GeoArrowGeomType, type GeoArrowResult, type GeoColumnMeta, type GeoParquetMeta, type GeoType, type HexRow, LAYER_HUE_MULTIPLIER, type ListPage, MAX_QUERY_HISTORY_ENTRIES, type MapQueryHandle, type MapQueryResult, PROVIDERS, PROVIDER_IDS, type ParquetFileMetadata, type ParsedGeometry, type ParsedMarkdownDocument, type ParsedStorageUrl, type ProviderDef, type ProviderId, type ProviderRegion, QueryCancelledError, type QueryEngine, type QueryHandle, type QueryResult, SQL_PREVIEW_LENGTH, STORAGE_KEYS, type SchemaField, type SortConfig, type SortDirection, type SortField, type SqlBlock, type StorageAdapter, type StorageProvider, type Tab, type Theme, type TypeCategory, UrlAdapter, VIEWER_DIR_EXTENSIONS, type ViewerKind, WGS84_CODES, type WriteResult, buildDuckDbSource, buildEndpointFromTemplate, buildGeoArrowTables, buildProviderBaseUrl, classifyType, describeParseResult, escapeCsvField, extractBounds, extractEpsgFromGeoMeta, extractGeometryTypes, findGeoColumn, findGeoColumnFromRows, formatDate, formatFileSize, formatValue, generateHexDump, getDuckDbReadFn, getFileExtension, getFileTypeInfo, getMimeType, getNativeScheme, getProvider, getViewerKind, handleLoadError, interpolateTemplates, isCloudNativeFormat, isGcsProvider, isQueryable, jsonReplacerBigInt, loadFromStorage, looksLikeUrl, markSqlBlocks, normalizeGeomType, parseMarkdownDocument, parseStorageUrl, parseWKB, persistToStorage, readParquetMetadata, resolveCloudUrl, safeDecodeURIComponent, serializeToCsv, serializeToJson, sortFileEntries, toBinary, toggleSortField, typeBadgeClass, typeColor, typeLabel };
+export { COPY_FEEDBACK_MS, type CogInfo, type Connection, type ConnectionConfig, DEFAULT_TARGET_CRS, DUCKDB_INIT_TIMEOUT_MS, type Defaults, type DuckDbReadFn, type FileCategory, type FileEntry, type FileTypeInfo, type GeoArrowGeomType, type GeoArrowResult, type GeoBounds, type GeoColumnMeta, type GeoParquetMeta, type GeoType, type HexRow, LAYER_HUE_MULTIPLIER, type ListPage, MAX_QUERY_HISTORY_ENTRIES, type MapQueryHandle, type MapQueryResult, PROVIDERS, PROVIDER_IDS, type ParquetFileMetadata, type ParsedGeometry, type ParsedMarkdownDocument, type ParsedStorageUrl, type ProviderDef, type ProviderId, type ProviderRegion, QueryCancelledError, type QueryEngine, type QueryHandle, type QueryResult, SF_LABELS, SQL_PREVIEW_LENGTH, STORAGE_KEYS, type SchemaField, type SortConfig, type SortDirection, type SortField, type SqlBlock, type StorageAdapter, type StorageProvider, type Tab, type Theme, type TypeCategory, UrlAdapter, VIEWER_DIR_EXTENSIONS, type ViewerKind, WGS84_CODES, type WriteResult, buildDataTypeLabel, buildDuckDbSource, buildEndpointFromTemplate, buildGeoArrowTables, buildProviderBaseUrl, clampBounds, classifyType, describeParseResult, escapeCsvField, extractBounds, extractEpsgFromGeoMeta, extractGeometryTypes, findGeoColumn, findGeoColumnFromRows, formatDate, formatFileSize, formatValue, generateHexDump, getDuckDbReadFn, getFileExtension, getFileTypeInfo, getMimeType, getNativeScheme, getProvider, getViewerKind, handleLoadError, interpolateTemplates, isCloudNativeFormat, isGcsProvider, isQueryable, jsonReplacerBigInt, loadFromStorage, looksLikeUrl, markSqlBlocks, normalizeGeomType, parseMarkdownDocument, parseStorageUrl, parseWKB, persistToStorage, readParquetMetadata, resolveCloudUrl, safeClamp, safeDecodeURIComponent, serializeToCsv, serializeToJson, sortFileEntries, toBinary, toggleSortField, typeBadgeClass, typeColor, typeLabel };

package/dist/index.d.ts

@@ -11,8 +11,12 @@ declare const STORAGE_KEYS: {
 };
 /** EPSG codes considered WGS84 (no reprojection needed). */
 declare const WGS84_CODES: Set<number>;
-/** Default target CRS for ST_Transform. */
-declare const DEFAULT_TARGET_CRS = "EPSG:4326";
+/**
+ * Default target CRS for ST_Transform. Uses OGC:CRS84 (longitude, latitude)
+ * to match GeoParquet 1.1+ spec and DuckDB v1.5's canonical form.
+ * Functionally equivalent to EPSG:4326 under `geometry_always_xy = true`.
+ */
+declare const DEFAULT_TARGET_CRS = "OGC:CRS84";
 /** DuckDB-WASM initialization timeout in ms. */
 declare const DUCKDB_INIT_TIMEOUT_MS = 30000;
 /** Maximum entries kept in query history. */
@@ -119,15 +123,27 @@ interface SchemaField {
     type: string;
     nullable: boolean;
 }
+/**
+ * Abstraction over a DuckDB query source. Decouples schema / CRS / count
+ * helpers from assuming a file-backed path. `ref` is the FROM-clause target
+ * inserted into generated SQL (e.g. `read_parquet('url')` for files, or
+ * `attached_db."schema"."table"` for attached databases). `filePath` is
+ * optional and only used as a shortcut for Parquet file-level metadata
+ * queries (`parquet_kv_metadata`, `parquet_file_metadata`), not for SQL.
+ */
+interface QuerySource {
+    ref: string;
+    filePath?: string;
+}
 interface QueryEngine {
     query(connId: string, sql: string): Promise<QueryResult>;
     queryForMap(connId: string, sql: string, geomCol: string, geomColType: string, sourceCrs?: string | null): Promise<MapQueryResult>;
-    getSchema(connId: string, path: string): Promise<SchemaField[]>;
-    getRowCount(connId: string, path: string): Promise<number>;
+    getSchema(connId: string, source: QuerySource): Promise<SchemaField[]>;
+    getRowCount(connId: string, source: QuerySource): Promise<number>;
     /** Detect CRS from GeoParquet metadata. Returns e.g. 'EPSG:27700' or null if WGS84/unknown. */
-    detectCrs(connId: string, path: string, geomCol: string): Promise<string | null>;
+    detectCrs(connId: string, source: QuerySource, geomCol: string): Promise<string | null>;
     /** Combined schema + CRS detection in a single connection (fewer web worker round-trips). */
-    getSchemaAndCrs?(connId: string, path: string, findGeoCol: (schema: SchemaField[]) => string | null): Promise<{
+    getSchemaAndCrs?(connId: string, source: QuerySource, findGeoCol: (schema: SchemaField[]) => string | null): Promise<{
         schema: SchemaField[];
         geomCol: string | null;
         crs: string | null;
@@ -135,6 +151,10 @@ interface QueryEngine {
     queryCancellable?(connId: string, sql: string): QueryHandle;
     queryForMapCancellable?(connId: string, sql: string, geomCol: string, geomColType: string, sourceCrs?: string | null): MapQueryHandle;
     forceCancel?(): Promise<void>;
+    /** Register a file buffer in DuckDB-WASM's virtual filesystem for ATTACH. */
+    registerFileBuffer?(name: string, buffer: Uint8Array): Promise<void>;
+    /** Drop a previously registered file from DuckDB-WASM's virtual filesystem. */
+    dropFile?(name: string): Promise<void>;
     releaseMemory(): Promise<void>;
     dispose(): Promise<void>;
 }
@@ -179,6 +199,17 @@ interface Tab {
     connectionId?: string;
     extension: string;
     size?: number;
+    /**
+     * When set, the tab reads data from a SQL FROM-clause target (e.g. an
+     * attached DuckLake/DuckDB/SQLite table) rather than a file URL. The ref
+     * is inserted directly into generated SQL, so it must be fully-qualified
+     * and pre-quoted, e.g. `__objex_db__."main"."air_quality"`.
+     *
+     * When `sourceRef` is set, file-specific loading paths (hyparquet
+     * metadata, `parquet_kv_metadata`, etc.) are skipped, and schema / CRS /
+     * row count are derived from the SQL source directly via DuckDB.
+     */
+    sourceRef?: string;
 }
 interface WriteResult {
     key: string;
@@ -308,6 +339,32 @@ declare function safeDecodeURIComponent(s: string): string;
  */
 declare function resolveCloudUrl(url: string): string;
 
+/** SampleFormat tag value → human label. */
+declare const SF_LABELS: Record<number, string>;
+interface GeoBounds {
+    west: number;
+    south: number;
+    east: number;
+    north: number;
+}
+interface CogInfo {
+    width: number;
+    height: number;
+    bandCount: number;
+    dataType: string;
+    bounds: GeoBounds;
+    downsampled?: boolean;
+}
+/** Safely clamp a number to a range, treating NaN/Infinity as the fallback. */
+declare function safeClamp(v: number, lo: number, hi: number, fallback: number): number;
+/** Clamp geographic bounds to valid MapLibre web-Mercator range. */
+declare function clampBounds(b: GeoBounds): GeoBounds;
+/**
+ * Build a data-type label from GeoTIFF sample format and bits per sample.
+ * e.g. "uint8", "float32", "int16"
+ */
+declare function buildDataTypeLabel(sampleFormat: number, bitsPerSample: number): string;
+
 type TypeCategory = 'number' | 'string' | 'date' | 'boolean' | 'geo' | 'binary' | 'json' | 'other';
 declare function classifyType(duckdbType: string): TypeCategory;
 declare function typeColor(category: TypeCategory): string;
@@ -464,7 +521,7 @@ interface ParsedMarkdownDocument {
  * SELECT * FROM table
  * ```
  */
-declare function parseMarkdownDocument(markdown: string): ParsedMarkdownDocument;
+declare function parseMarkdownDocument(markdown: string): Promise<ParsedMarkdownDocument>;
 /**
  * Interpolate template variables in markdown text.
  * Supports {queryName.rows[0].columnName} syntax.
@@ -644,4 +701,4 @@ declare function findGeoColumnFromRows(rows: Record<string, unknown>[], schema:
     type: string;
 }[]): string | null;
 
-export { COPY_FEEDBACK_MS, type Connection, type ConnectionConfig, DEFAULT_TARGET_CRS, DUCKDB_INIT_TIMEOUT_MS, type Defaults, type DuckDbReadFn, type FileCategory, type FileEntry, type FileTypeInfo, type GeoArrowGeomType, type GeoArrowResult, type GeoColumnMeta, type GeoParquetMeta, type GeoType, type HexRow, LAYER_HUE_MULTIPLIER, type ListPage, MAX_QUERY_HISTORY_ENTRIES, type MapQueryHandle, type MapQueryResult, PROVIDERS, PROVIDER_IDS, type ParquetFileMetadata, type ParsedGeometry, type ParsedMarkdownDocument, type ParsedStorageUrl, type ProviderDef, type ProviderId, type ProviderRegion, QueryCancelledError, type QueryEngine, type QueryHandle, type QueryResult, SQL_PREVIEW_LENGTH, STORAGE_KEYS, type SchemaField, type SortConfig, type SortDirection, type SortField, type SqlBlock, type StorageAdapter, type StorageProvider, type Tab, type Theme, type TypeCategory, UrlAdapter, VIEWER_DIR_EXTENSIONS, type ViewerKind, WGS84_CODES, type WriteResult, buildDuckDbSource, buildEndpointFromTemplate, buildGeoArrowTables, buildProviderBaseUrl, classifyType, describeParseResult, escapeCsvField, extractBounds, extractEpsgFromGeoMeta, extractGeometryTypes, findGeoColumn, findGeoColumnFromRows, formatDate, formatFileSize, formatValue, generateHexDump, getDuckDbReadFn, getFileExtension, getFileTypeInfo, getMimeType, getNativeScheme, getProvider, getViewerKind, handleLoadError, interpolateTemplates, isCloudNativeFormat, isGcsProvider, isQueryable, jsonReplacerBigInt, loadFromStorage, looksLikeUrl, markSqlBlocks, normalizeGeomType, parseMarkdownDocument, parseStorageUrl, parseWKB, persistToStorage, readParquetMetadata, resolveCloudUrl, safeDecodeURIComponent, serializeToCsv, serializeToJson, sortFileEntries, toBinary, toggleSortField, typeBadgeClass, typeColor, typeLabel };
+export { COPY_FEEDBACK_MS, type CogInfo, type Connection, type ConnectionConfig, DEFAULT_TARGET_CRS, DUCKDB_INIT_TIMEOUT_MS, type Defaults, type DuckDbReadFn, type FileCategory, type FileEntry, type FileTypeInfo, type GeoArrowGeomType, type GeoArrowResult, type GeoBounds, type GeoColumnMeta, type GeoParquetMeta, type GeoType, type HexRow, LAYER_HUE_MULTIPLIER, type ListPage, MAX_QUERY_HISTORY_ENTRIES, type MapQueryHandle, type MapQueryResult, PROVIDERS, PROVIDER_IDS, type ParquetFileMetadata, type ParsedGeometry, type ParsedMarkdownDocument, type ParsedStorageUrl, type ProviderDef, type ProviderId, type ProviderRegion, QueryCancelledError, type QueryEngine, type QueryHandle, type QueryResult, SF_LABELS, SQL_PREVIEW_LENGTH, STORAGE_KEYS, type SchemaField, type SortConfig, type SortDirection, type SortField, type SqlBlock, type StorageAdapter, type StorageProvider, type Tab, type Theme, type TypeCategory, UrlAdapter, VIEWER_DIR_EXTENSIONS, type ViewerKind, WGS84_CODES, type WriteResult, buildDataTypeLabel, buildDuckDbSource, buildEndpointFromTemplate, buildGeoArrowTables, buildProviderBaseUrl, clampBounds, classifyType, describeParseResult, escapeCsvField, extractBounds, extractEpsgFromGeoMeta, extractGeometryTypes, findGeoColumn, findGeoColumnFromRows, formatDate, formatFileSize, formatValue, generateHexDump, getDuckDbReadFn, getFileExtension, getFileTypeInfo, getMimeType, getNativeScheme, getProvider, getViewerKind, handleLoadError, interpolateTemplates, isCloudNativeFormat, isGcsProvider, isQueryable, jsonReplacerBigInt, loadFromStorage, looksLikeUrl, markSqlBlocks, normalizeGeomType, parseMarkdownDocument, parseStorageUrl, parseWKB, persistToStorage, readParquetMetadata, resolveCloudUrl, safeClamp, safeDecodeURIComponent, serializeToCsv, serializeToJson, sortFileEntries, toBinary, toggleSortField, typeBadgeClass, typeColor, typeLabel };

package/dist/index.js

@@ -1,5 +1,9 @@
+import '@developmentseed/epsg/all';
+import '@developmentseed/epsg/all.csv.gz?url';
+import '@developmentseed/geotiff';
+import '@developmentseed/proj';
+import 'proj4';
 import { Field, Float64, FixedSizeList, Schema, Struct, makeData, RecordBatch, Table, List, Utf8 } from 'apache-arrow';
-import YAML from 'yaml';
 
 // ../../src/lib/constants.ts
 var STORAGE_KEYS = {
@@ -8,7 +12,7 @@ var STORAGE_KEYS = {
   QUERY_HISTORY: "obstore-explore-query-history"
 };
 var WGS84_CODES = /* @__PURE__ */ new Set([4326, 4979]);
-var DEFAULT_TARGET_CRS = "EPSG:4326";
+var DEFAULT_TARGET_CRS = "OGC:CRS84";
 var DUCKDB_INIT_TIMEOUT_MS = 3e4;
 var MAX_QUERY_HISTORY_ENTRIES = 200;
 var SQL_PREVIEW_LENGTH = 120;
@@ -888,6 +892,16 @@ var EXTENSIONS = {
     duckdbReadFn: null,
     mimeType: "application/octet-stream"
   },
+  ".ducklake": {
+    icon: "Database",
+    color: "text-teal-600 dark:text-teal-400",
+    label: "DuckLake",
+    category: "database",
+    viewer: "database",
+    queryable: true,
+    duckdbReadFn: null,
+    mimeType: "application/octet-stream"
+  },
   ".sqlite": {
     icon: "Database",
     color: "text-sky-600 dark:text-sky-400",
@@ -1035,7 +1049,7 @@ function buildDuckDbSource(pathOrExt, url) {
   const readFn = EXTENSIONS[ext]?.duckdbReadFn ?? "read_parquet";
   return `${readFn}('${url}')`;
 }
-var CLOUD_NATIVE_EXTS = /* @__PURE__ */ new Set([".parquet", ".geoparquet", ".gpq", ".gparquet"]);
+var CLOUD_NATIVE_EXTS = /* @__PURE__ */ new Set([".parquet", ".geoparquet", ".gpq", ".gparquet", ".ducklake"]);
 function isCloudNativeFormat(pathOrExt) {
   const ext = pathOrExt.includes(".") ? `.${pathOrExt.split(".").pop().toLowerCase()}` : "";
   return CLOUD_NATIVE_EXTS.has(ext);
@@ -1432,6 +1446,28 @@ function resolveCloudUrl(url) {
   }
   return url;
 }
+var SF_LABELS = {
+  1: "uint",
+  2: "int",
+  3: "float",
+  4: "void",
+  5: "complex int",
+  6: "complex float"
+};
+function safeClamp(v, lo, hi, fallback) {
+  return Number.isFinite(v) ? Math.max(lo, Math.min(hi, v)) : fallback;
+}
+function clampBounds(b) {
+  return {
+    west: safeClamp(b.west, -180, 180, -180),
+    south: safeClamp(b.south, -85.051129, 85.051129, -85.051129),
+    east: safeClamp(b.east, -180, 180, 180),
+    north: safeClamp(b.north, -85.051129, 85.051129, 85.051129)
+  };
+}
+function buildDataTypeLabel(sampleFormat, bitsPerSample) {
+  return `${SF_LABELS[sampleFormat] ?? `sf${sampleFormat}`}${bitsPerSample ?? ""}`;
+}
 
 // ../../src/lib/utils/column-types.ts
 var NUMBER_TYPES = [
@@ -2283,12 +2319,15 @@ function persistToStorage(key, value) {
   } catch {
   }
 }
-function parseMarkdownDocument(markdown) {
+
+// ../../src/lib/utils/markdown-sql.ts
+async function parseMarkdownDocument(markdown) {
   let frontmatter = {};
   let content = markdown;
   const fmMatch = markdown.match(/^---\n([\s\S]*?)\n---\n/);
   if (fmMatch) {
     try {
+      const { default: YAML } = await import('yaml');
       frontmatter = YAML.parse(fmMatch[1]) || {};
     } catch {
     }
@@ -3053,6 +3092,6 @@ function isWKT(value) {
   return WKT_TYPES.some((t) => s.startsWith(t) || s.startsWith(`MULTI${t}`));
 }
 
-export { COPY_FEEDBACK_MS, DEFAULT_TARGET_CRS, DUCKDB_INIT_TIMEOUT_MS, LAYER_HUE_MULTIPLIER, MAX_QUERY_HISTORY_ENTRIES, PROVIDERS, PROVIDER_IDS, QueryCancelledError, SQL_PREVIEW_LENGTH, STORAGE_KEYS, UrlAdapter, VIEWER_DIR_EXTENSIONS, WGS84_CODES, buildDuckDbSource, buildEndpointFromTemplate, buildGeoArrowTables, buildProviderBaseUrl, classifyType, describeParseResult, escapeCsvField, extractBounds, extractEpsgFromGeoMeta, extractGeometryTypes, findGeoColumn, findGeoColumnFromRows, formatDate, formatFileSize, formatValue, generateHexDump, getDuckDbReadFn, getFileExtension, getFileTypeInfo, getMimeType, getNativeScheme, getProvider, getViewerKind, handleLoadError, interpolateTemplates, isCloudNativeFormat, isGcsProvider, isQueryable, jsonReplacerBigInt, loadFromStorage, looksLikeUrl, markSqlBlocks, normalizeGeomType, parseMarkdownDocument, parseStorageUrl, parseWKB, persistToStorage, readParquetMetadata, resolveCloudUrl, safeDecodeURIComponent, serializeToCsv, serializeToJson, sortFileEntries, toBinary, toggleSortField, typeBadgeClass, typeColor, typeLabel };
+export { COPY_FEEDBACK_MS, DEFAULT_TARGET_CRS, DUCKDB_INIT_TIMEOUT_MS, LAYER_HUE_MULTIPLIER, MAX_QUERY_HISTORY_ENTRIES, PROVIDERS, PROVIDER_IDS, QueryCancelledError, SF_LABELS, SQL_PREVIEW_LENGTH, STORAGE_KEYS, UrlAdapter, VIEWER_DIR_EXTENSIONS, WGS84_CODES, buildDataTypeLabel, buildDuckDbSource, buildEndpointFromTemplate, buildGeoArrowTables, buildProviderBaseUrl, clampBounds, classifyType, describeParseResult, escapeCsvField, extractBounds, extractEpsgFromGeoMeta, extractGeometryTypes, findGeoColumn, findGeoColumnFromRows, formatDate, formatFileSize, formatValue, generateHexDump, getDuckDbReadFn, getFileExtension, getFileTypeInfo, getMimeType, getNativeScheme, getProvider, getViewerKind, handleLoadError, interpolateTemplates, isCloudNativeFormat, isGcsProvider, isQueryable, jsonReplacerBigInt, loadFromStorage, looksLikeUrl, markSqlBlocks, normalizeGeomType, parseMarkdownDocument, parseStorageUrl, parseWKB, persistToStorage, readParquetMetadata, resolveCloudUrl, safeClamp, safeDecodeURIComponent, serializeToCsv, serializeToJson, sortFileEntries, toBinary, toggleSortField, typeBadgeClass, typeColor, typeLabel };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map