@walkthru-earth/objex 1.3.1 → 1.4.0

package/dist/utils/cog-pure.d.ts

@@ -1,25 +0,0 @@
-/** SampleFormat tag value → human label. */
-export declare const SF_LABELS: Record<number, string>;
-export interface GeoBounds {
-    west: number;
-    south: number;
-    east: number;
-    north: number;
-}
-export interface CogInfo {
-    width: number;
-    height: number;
-    bandCount: number;
-    dataType: string;
-    bounds: GeoBounds;
-    downsampled?: boolean;
-}
-/** Safely clamp a number to a range, treating NaN/Infinity as the fallback. */
-export declare function safeClamp(v: number, lo: number, hi: number, fallback: number): number;
-/** Clamp geographic bounds to valid MapLibre web-Mercator range. */
-export declare function clampBounds(b: GeoBounds): GeoBounds;
-/**
- * Build a data-type label from GeoTIFF sample format and bits per sample.
- * e.g. "uint8", "float32", "int16"
- */
-export declare function buildDataTypeLabel(sampleFormat: number, bitsPerSample: number): string;

package/dist/utils/cog-pure.js

@@ -1,35 +0,0 @@
-// Dependency-free subset of `cog.ts` so that `@walkthru-earth/objex-utils`
-// can re-export these helpers without dragging in `@developmentseed/epsg`,
-// `@developmentseed/geotiff`, `@developmentseed/proj`, `proj4`, or
-// `maplibre-gl`. tsup preserves bare side-effect imports from externalized
-// modules even when all named bindings are tree-shaken, so the pure surface
-// MUST live in a module that has zero heavy imports.
-/** SampleFormat tag value → human label. */
-export const SF_LABELS = {
-    1: 'uint',
-    2: 'int',
-    3: 'float',
-    4: 'void',
-    5: 'complex int',
-    6: 'complex float'
-};
-/** Safely clamp a number to a range, treating NaN/Infinity as the fallback. */
-export function safeClamp(v, lo, hi, fallback) {
-    return Number.isFinite(v) ? Math.max(lo, Math.min(hi, v)) : fallback;
-}
-/** Clamp geographic bounds to valid MapLibre web-Mercator range. */
-export 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)
-    };
-}
-/**
- * Build a data-type label from GeoTIFF sample format and bits per sample.
- * e.g. "uint8", "float32", "int16"
- */
-export function buildDataTypeLabel(sampleFormat, bitsPerSample) {
-    return `${SF_LABELS[sampleFormat] ?? `sf${sampleFormat}`}${bitsPerSample ?? ''}`;
-}

package/dist/utils/column-types.d.ts

@@ -1,5 +0,0 @@
-export type TypeCategory = 'number' | 'string' | 'date' | 'boolean' | 'geo' | 'binary' | 'json' | 'other';
-export declare function classifyType(duckdbType: string): TypeCategory;
-export declare function typeColor(category: TypeCategory): string;
-export declare function typeBadgeClass(category: TypeCategory): string;
-export declare function typeLabel(category: TypeCategory): string;

package/dist/utils/column-types.js

@@ -1,137 +0,0 @@
-const NUMBER_TYPES = [
-    'TINYINT',
-    'SMALLINT',
-    'INTEGER',
-    'BIGINT',
-    'HUGEINT',
-    'UTINYINT',
-    'USMALLINT',
-    'UINTEGER',
-    'UBIGINT',
-    'FLOAT',
-    'DOUBLE',
-    'DECIMAL',
-    'NUMERIC',
-    'REAL',
-    'INT',
-    'INT1',
-    'INT2',
-    'INT4',
-    'INT8',
-    'SIGNED',
-    'SHORT',
-    'LONG'
-];
-const STRING_TYPES = ['VARCHAR', 'TEXT', 'STRING', 'CHAR', 'BPCHAR', 'NAME', 'UUID', 'ENUM'];
-const DATE_TYPES = [
-    'DATE',
-    'TIME',
-    'TIMESTAMP',
-    'TIMESTAMP_S',
-    'TIMESTAMP_MS',
-    'TIMESTAMP_NS',
-    'TIMESTAMP WITH TIME ZONE',
-    'TIMESTAMPTZ',
-    'INTERVAL',
-    'TIMESTAMP_TZ'
-];
-const BOOLEAN_TYPES = ['BOOLEAN', 'BOOL', 'LOGICAL'];
-const GEO_TYPES = [
-    'GEOMETRY',
-    'POINT',
-    'LINESTRING',
-    'POLYGON',
-    'MULTIPOINT',
-    'MULTILINESTRING',
-    'MULTIPOLYGON',
-    'GEOMETRYCOLLECTION',
-    'WKB_GEOMETRY'
-];
-const BINARY_TYPES = ['BLOB', 'BYTEA', 'BINARY', 'VARBINARY'];
-const JSON_TYPES = ['JSON', 'JSONB'];
-export function classifyType(duckdbType) {
-    const upper = duckdbType.toUpperCase().trim();
-    // Handle parameterized types like DECIMAL(18,3), VARCHAR(100)
-    const base = upper.replace(/\(.*\)/, '').trim();
-    if (NUMBER_TYPES.includes(base))
-        return 'number';
-    if (STRING_TYPES.includes(base))
-        return 'string';
-    if (DATE_TYPES.includes(base))
-        return 'date';
-    if (BOOLEAN_TYPES.includes(base))
-        return 'boolean';
-    if (GEO_TYPES.includes(base))
-        return 'geo';
-    if (BINARY_TYPES.includes(base))
-        return 'binary';
-    if (JSON_TYPES.includes(base))
-        return 'json';
-    // Compound types
-    if (base.startsWith('STRUCT') || base.startsWith('MAP') || base.startsWith('UNION'))
-        return 'json';
-    if (base.endsWith('[]') || base.startsWith('LIST'))
-        return 'json';
-    // Fallback checks
-    if (upper.includes('INT') ||
-        upper.includes('FLOAT') ||
-        upper.includes('DOUBLE') ||
-        upper.includes('DECIMAL') ||
-        upper.includes('NUMERIC'))
-        return 'number';
-    if (upper.includes('CHAR') || upper.includes('TEXT') || upper.includes('STRING'))
-        return 'string';
-    if (upper.includes('TIME') || upper.includes('DATE'))
-        return 'date';
-    if (upper.includes('BOOL'))
-        return 'boolean';
-    if (upper.includes('GEOMETRY') || upper.includes('GEO') || upper.includes('WKB'))
-        return 'geo';
-    if (upper.includes('BLOB') || upper.includes('BINARY'))
-        return 'binary';
-    if (upper.includes('JSON') ||
-        upper.includes('STRUCT') ||
-        upper.includes('MAP') ||
-        upper.includes('LIST'))
-        return 'json';
-    return 'other';
-}
-const TYPE_COLORS = {
-    number: 'text-blue-500',
-    string: 'text-green-500',
-    date: 'text-amber-500',
-    boolean: 'text-purple-500',
-    geo: 'text-teal-500',
-    binary: 'text-zinc-500',
-    json: 'text-orange-500',
-    other: 'text-zinc-400'
-};
-const TYPE_BADGE_CLASSES = {
-    number: 'bg-blue-500/10 text-blue-600 dark:text-blue-400 border-blue-500/20',
-    string: 'bg-green-500/10 text-green-600 dark:text-green-400 border-green-500/20',
-    date: 'bg-amber-500/10 text-amber-600 dark:text-amber-400 border-amber-500/20',
-    boolean: 'bg-purple-500/10 text-purple-600 dark:text-purple-400 border-purple-500/20',
-    geo: 'bg-teal-500/10 text-teal-600 dark:text-teal-400 border-teal-500/20',
-    binary: 'bg-zinc-500/10 text-zinc-600 dark:text-zinc-400 border-zinc-500/20',
-    json: 'bg-orange-500/10 text-orange-600 dark:text-orange-400 border-orange-500/20',
-    other: 'bg-zinc-500/10 text-zinc-500 dark:text-zinc-400 border-zinc-500/20'
-};
-const TYPE_LABELS = {
-    number: '#',
-    string: 'Aa',
-    date: 'dt',
-    boolean: 'T/F',
-    geo: 'geo',
-    binary: '01',
-    json: '{}',
-    other: '?'
-};
-export function typeColor(category) {
-    return TYPE_COLORS[category];
-}
-export function typeBadgeClass(category) {
-    return TYPE_BADGE_CLASSES[category];
-}
-export function typeLabel(category) {
-    return TYPE_LABELS[category];
-}

package/dist/utils/connection-identity.d.ts

@@ -1,51 +0,0 @@
-/**
- * Canonical connection identity.
- *
- * Single source of truth for deciding when two connection configs point at
- * the same bucket. Used by the connections store to deduplicate auto-detect,
- * manual add, and edit flows, so one physical bucket never ends up with
- * multiple competing local records.
- *
- * Identity rules, per provider:
- *
- *   azure  → (provider, endpoint, bucket)     endpoint carries the account
- *   gcs    → (provider, bucket)               GCS bucket names are global
- *   s3     → (provider, bucket, region)       AWS native: same bucket name
- *                                             can exist in exactly one region,
- *                                             but the region is load-bearing
- *                                             for signing, so a paste with a
- *                                             different region is a distinct
- *                                             connection until the user merges
- *   other  → (provider, endpoint, bucket)     r2, b2, minio, wasabi, storj,
- *                                             digitalocean, contabo, hetzner,
- *                                             linode, ovhcloud, custom
- *
- * Endpoint normalization is aggressive: scheme + host + non-default port +
- * pathname, with trailing slashes and default ports stripped, host lowercased.
- * That collapses the common trip hazards — http vs https, :443 vs empty,
- * trailing slash drift, mixed case host.
- */
-import type { ProviderId } from '../storage/providers.js';
-export interface ConnectionIdentityInput {
-    provider: string;
-    endpoint: string;
-    bucket: string;
-    region: string;
-}
-/**
- * Normalize an endpoint URL to a canonical form suitable for equality checks.
- * Empty / whitespace-only input returns `''` (the "no endpoint" sentinel).
- * Non-URL strings are lowercased and stripped of trailing slashes as a best
- * effort so the comparison is still deterministic.
- */
-export declare function normalizeEndpoint(raw: string | undefined | null): string;
-/** Collapse unknown / empty providers to `'s3'`; otherwise lowercase. */
-export declare function normalizeProvider(provider: string | undefined | null): ProviderId;
-/**
- * Produce a canonical key for a connection's identity. Two connection
- * configs with the same identity key point at the same physical bucket.
- * Returns `''` when the config is too incomplete to identify a bucket.
- */
-export declare function connectionIdentityKey(input: ConnectionIdentityInput): string;
-/** Convenience: true when both inputs share the same non-empty identity. */
-export declare function isSameConnectionIdentity(a: ConnectionIdentityInput, b: ConnectionIdentityInput): boolean;

package/dist/utils/connection-identity.js

@@ -1,97 +0,0 @@
-/**
- * Canonical connection identity.
- *
- * Single source of truth for deciding when two connection configs point at
- * the same bucket. Used by the connections store to deduplicate auto-detect,
- * manual add, and edit flows, so one physical bucket never ends up with
- * multiple competing local records.
- *
- * Identity rules, per provider:
- *
- *   azure  → (provider, endpoint, bucket)     endpoint carries the account
- *   gcs    → (provider, bucket)               GCS bucket names are global
- *   s3     → (provider, bucket, region)       AWS native: same bucket name
- *                                             can exist in exactly one region,
- *                                             but the region is load-bearing
- *                                             for signing, so a paste with a
- *                                             different region is a distinct
- *                                             connection until the user merges
- *   other  → (provider, endpoint, bucket)     r2, b2, minio, wasabi, storj,
- *                                             digitalocean, contabo, hetzner,
- *                                             linode, ovhcloud, custom
- *
- * Endpoint normalization is aggressive: scheme + host + non-default port +
- * pathname, with trailing slashes and default ports stripped, host lowercased.
- * That collapses the common trip hazards — http vs https, :443 vs empty,
- * trailing slash drift, mixed case host.
- */
-const DEFAULT_PORTS = {
-    'https:': '443',
-    'http:': '80'
-};
-/**
- * Normalize an endpoint URL to a canonical form suitable for equality checks.
- * Empty / whitespace-only input returns `''` (the "no endpoint" sentinel).
- * Non-URL strings are lowercased and stripped of trailing slashes as a best
- * effort so the comparison is still deterministic.
- */
-export function normalizeEndpoint(raw) {
-    if (!raw)
-        return '';
-    const trimmed = raw.trim();
-    if (!trimmed)
-        return '';
-    try {
-        const url = new URL(trimmed);
-        const scheme = url.protocol.toLowerCase();
-        const host = url.hostname.toLowerCase();
-        const defaultPort = DEFAULT_PORTS[scheme] ?? '';
-        const port = url.port && url.port !== defaultPort ? `:${url.port}` : '';
-        const path = url.pathname.replace(/\/+$/, '');
-        return `${scheme}//${host}${port}${path}`;
-    }
-    catch {
-        return trimmed.toLowerCase().replace(/\/+$/, '');
-    }
-}
-/** Collapse unknown / empty providers to `'s3'`; otherwise lowercase. */
-export function normalizeProvider(provider) {
-    if (!provider)
-        return 's3';
-    const p = provider.trim().toLowerCase();
-    if (!p || p === 'unknown')
-        return 's3';
-    return p;
-}
-/** Bucket names are case-sensitive on some backends, so preserve case. */
-function normalizeBucket(bucket) {
-    return (bucket ?? '').trim().replace(/^\/+|\/+$/g, '');
-}
-function normalizeRegion(region) {
-    return (region ?? '').trim().toLowerCase();
-}
-/**
- * Produce a canonical key for a connection's identity. Two connection
- * configs with the same identity key point at the same physical bucket.
- * Returns `''` when the config is too incomplete to identify a bucket.
- */
-export function connectionIdentityKey(input) {
-    const provider = normalizeProvider(input.provider);
-    const bucket = normalizeBucket(input.bucket);
-    if (!bucket)
-        return '';
-    const endpoint = normalizeEndpoint(input.endpoint);
-    const region = normalizeRegion(input.region);
-    if (provider === 'azure')
-        return `azure|${endpoint}|${bucket}`;
-    if (provider === 'gcs')
-        return `gcs|${bucket}`;
-    if (provider === 's3' && !endpoint)
-        return `s3|${bucket}|${region}`;
-    return `${provider}|${endpoint}|${bucket}`;
-}
-/** Convenience: true when both inputs share the same non-empty identity. */
-export function isSameConnectionIdentity(a, b) {
-    const key = connectionIdentityKey(a);
-    return key !== '' && key === connectionIdentityKey(b);
-}

package/dist/utils/error.d.ts

@@ -1,8 +0,0 @@
-/**
- * Shared error handling for async viewer load operations.
- */
-/**
- * Extract an error message from an unknown caught value.
- * Returns null for AbortError (caller should silently return).
- */
-export declare function handleLoadError(err: unknown): string | null;

package/dist/utils/error.js

@@ -1,12 +0,0 @@
-/**
- * Shared error handling for async viewer load operations.
- */
-/**
- * Extract an error message from an unknown caught value.
- * Returns null for AbortError (caller should silently return).
- */
-export function handleLoadError(err) {
-    if (err instanceof DOMException && err.name === 'AbortError')
-        return null;
-    return err instanceof Error ? err.message : String(err);
-}

package/dist/utils/evidence-context.d.ts

@@ -1,22 +0,0 @@
-import type { QueryResult } from '../query/engine';
-export declare class EvidenceContext {
-    private connId;
-    private prefix;
-    private results;
-    constructor(connId: string, prefix?: string);
-    /**
-     * Execute a SQL query and store the result under the given name.
-     */
-    executeSql(sql: string, queryName: string): Promise<Record<string, any>[]>;
-    /**
-     * Transform relative file paths in SQL to full S3 URLs.
-     * e.g., read_parquet('data.parquet') → read_parquet('s3://bucket/prefix/data.parquet')
-     */
-    private transformPaths;
-    getResult(queryName: string): {
-        result: QueryResult;
-        rows: Record<string, any>[];
-    } | undefined;
-    getAllResults(): Map<string, Record<string, any>[]>;
-    getColumns(queryName: string): string[];
-}

package/dist/utils/evidence-context.js

@@ -1,56 +0,0 @@
-import { getQueryEngine } from '../query/index.js';
-export class EvidenceContext {
-    connId;
-    prefix;
-    results = new Map();
-    constructor(connId, prefix = '') {
-        this.connId = connId;
-        this.prefix = prefix;
-    }
-    /**
-     * Execute a SQL query and store the result under the given name.
-     */
-    async executeSql(sql, queryName) {
-        const engine = await getQueryEngine();
-        // Transform relative file paths to full paths
-        const transformedSql = this.transformPaths(sql);
-        const result = await engine.query(this.connId, transformedSql);
-        const rows = result.rows ?? [];
-        this.results.set(queryName, { result, rows });
-        return rows;
-    }
-    /**
-     * Transform relative file paths in SQL to full S3 URLs.
-     * e.g., read_parquet('data.parquet') → read_parquet('s3://bucket/prefix/data.parquet')
-     */
-    transformPaths(sql) {
-        if (!this.connId || !this.prefix)
-            return sql;
-        // Match read_parquet('path'), read_csv('path'), read_json('path')
-        return sql.replace(/(read_(?:parquet|csv|json|csv_auto))\('([^']+)'\)/g, (match, fn, path) => {
-            // Skip absolute paths and URLs
-            if (path.startsWith('s3://') || path.startsWith('http') || path.startsWith('/')) {
-                return match;
-            }
-            // Resolve relative path
-            const fullPath = `s3://${this.prefix}/${path}`;
-            return `${fn}('${fullPath}')`;
-        });
-    }
-    getResult(queryName) {
-        return this.results.get(queryName);
-    }
-    getAllResults() {
-        const map = new Map();
-        for (const [name, { rows }] of this.results) {
-            map.set(name, rows);
-        }
-        return map;
-    }
-    getColumns(queryName) {
-        const entry = this.results.get(queryName);
-        if (!entry)
-            return [];
-        return entry.result.columns;
-    }
-}

package/dist/utils/export.d.ts

@@ -1,22 +0,0 @@
-/**
- * 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,76 +0,0 @@
-import { jsonReplacerBigInt } from './format.js';
-function triggerDownload(content, filename, mimeType) {
-    const blob = new Blob([content], { type: mimeType });
-    const url = URL.createObjectURL(blob);
-    const a = document.createElement('a');
-    a.href = url;
-    a.download = filename;
-    document.body.appendChild(a);
-    a.click();
-    document.body.removeChild(a);
-    URL.revokeObjectURL(url);
-}
-/** 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, jsonReplacerBigInt);
-    return String(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;
-}
-/**
- * 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(formatCellValue(row[col]))).join(','))
-        .join('\n');
-    return `${header}\n${body}`;
-}
-/**
- * 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) {
-            const val = row[col];
-            if (val instanceof Date) {
-                obj[col] = val.toISOString();
-            }
-            else {
-                obj[col] = val ?? null;
-            }
-        }
-        return obj;
-    });
-    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

@@ -1,20 +0,0 @@
-/**
- * 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

@@ -1,41 +0,0 @@
-/**
- * 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/format.d.ts

@@ -1,24 +0,0 @@
-/**
- * Formats a byte count into a human-readable string.
- */
-export declare function formatFileSize(bytes: number): string;
-/**
- * Formats a unix timestamp (milliseconds) to a human-readable date string.
- * Shows relative time for recent dates, absolute for older ones.
- */
-export declare function formatDate(timestamp: number): string;
-/**
- * Extracts the file extension from a filename, including the leading dot.
- * Returns an empty string if no extension is found.
- */
-export declare function getFileExtension(filename: string): string;
-/**
- * JSON replacer that converts BigInt values to strings.
- * Use with `JSON.stringify(value, jsonReplacerBigInt)`.
- */
-export declare function jsonReplacerBigInt(_key: string, value: unknown): unknown;
-/**
- * Format a value for display in tables, attribute panels, and exports.
- * Handles null, undefined, Date, BigInt, and objects uniformly.
- */
-export declare function formatValue(value: unknown): string;