@walkthru-earth/objex 1.2.0 → 1.3.0

package/dist/utils/wkb.js

@@ -190,8 +190,22 @@ const GEO_TYPE_KEYWORDS = [
     'geometrycollection',
     'sdo_geometry'
 ];
-/** Substrings in column names that hint at geometry content. */
-const GEO_NAME_HINTS = ['geom', 'geometry', 'geo_', '_geo', 'wkb', 'wkt', 'shape', 'spatial'];
+/**
+ * Tokens in column names that hint at geometry content. Matched against
+ * snake_case / kebab-case / camelCase tokens only — never as loose substrings
+ * (e.g. `_geographic_` must not match `geo` via the `_geo` substring, because
+ * count columns like `n_geographic_entities` are INT, not geometry).
+ */
+const GEO_NAME_HINTS = ['geom', 'geometry', 'wkb', 'wkt', 'shape', 'spatial', 'geo'];
+/** Split a column name into lowercase tokens for hint matching. */
+function tokenizeColumnName(name) {
+    return name
+        .replace(/([a-z])([A-Z])/g, '$1_$2')
+        .replace(/([a-z])([0-9])/g, '$1_$2')
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter(Boolean);
+}
 /** Valid GeoJSON geometry type names. */
 const GEOJSON_TYPES = [
     'Point',
@@ -242,18 +256,18 @@ export function findGeoColumn(schema) {
         if (GEO_NAMES.includes(f.name.toLowerCase()))
             return f.name;
     }
-    // Priority 4: name contains geo hint with binary type
+    // Priority 4: name token matches geo hint with binary type
     for (const f of schema) {
-        const n = f.name.toLowerCase();
+        const tokens = tokenizeColumnName(f.name);
         const t = f.type.toLowerCase();
         const isBinary = t.includes('blob') || t.includes('binary') || t.includes('bytea');
-        if (isBinary && GEO_NAME_HINTS.some((hint) => n.includes(hint)))
+        if (isBinary && tokens.some((tok) => GEO_NAME_HINTS.includes(tok)))
             return f.name;
     }
-    // Priority 5: name contains geo hint, any type
+    // Priority 5: name token matches geo hint, any type
     for (const f of schema) {
-        const n = f.name.toLowerCase();
-        if (GEO_NAME_HINTS.some((hint) => n.includes(hint)))
+        const tokens = tokenizeColumnName(f.name);
+        if (tokens.some((tok) => GEO_NAME_HINTS.includes(tok)))
             return f.name;
     }
     return null;

package/dist/utils/zarr.d.ts

@@ -44,6 +44,40 @@ export interface ZarrHierarchy {
     storeAttrs: Record<string, any>;
     spatialRefAttrs: Record<string, any> | null;
 }
+export interface GeoZarrInfo {
+    /** Relative path within the store to the group carrying GeoZarr attrs. */
+    variantPath: string;
+    /** Raw attributes object that parses as GeoZarr (for caller re-use). */
+    attrs: Record<string, any>;
+}
+/**
+ * Walk the hierarchy looking for a node whose attributes satisfy the core
+ * GeoZarr convention: `multiscales` + a spatial convention (`spatial` /
+ * `spatial:dimensions`) + CRS info (`geo-proj`, `proj:code`, or `crs_wkt`).
+ *
+ * Check is shape-only (no zarrita I/O), so it's safe to call synchronously
+ * after `fetchHierarchy`. A non-null return indicates the store should be
+ * rendered via `@developmentseed/deck.gl-zarr`; a null return sends the
+ * caller to the `@carbonplan/zarr-layer` fallback.
+ */
+export declare function detectGeoZarr(hierarchy: ZarrHierarchy): GeoZarrInfo | null;
+/**
+ * Convert a decoded GeoZarr tile (band-planar or packed RGB) into RGBA
+ * `ImageData` for deck.gl-zarr's `renderTile` callback. Input is expected to
+ * be a Uint8 or Uint16 typed array with either 3 interleaved bytes per pixel
+ * or 3 planar bands of width*height values.
+ *
+ * For 16-bit data the caller supplies the rescale range so the CPU
+ * normalization matches what the GPU `LinearRescale` module would produce.
+ */
+export declare function zarrTileToImageData(raw: ArrayLike<number> & {
+    length: number;
+}, width: number, height: number, opts?: {
+    layout?: 'packed' | 'planar';
+    bands?: 1 | 3;
+    rescaleMin?: number;
+    rescaleMax?: number;
+}): ImageData;
 /** Dimension-like variable names treated as coordinates. */
 export declare const DIM_LIKE_NAMES: Set<string>;
 /** Guess dimension names from shape length when metadata is absent. */

package/dist/utils/zarr.js

@@ -113,6 +113,100 @@ export function extractZarrStoreUrl(url) {
     }
     return null;
 }
+/**
+ * Walk the hierarchy looking for a node whose attributes satisfy the core
+ * GeoZarr convention: `multiscales` + a spatial convention (`spatial` /
+ * `spatial:dimensions`) + CRS info (`geo-proj`, `proj:code`, or `crs_wkt`).
+ *
+ * Check is shape-only (no zarrita I/O), so it's safe to call synchronously
+ * after `fetchHierarchy`. A non-null return indicates the store should be
+ * rendered via `@developmentseed/deck.gl-zarr`; a null return sends the
+ * caller to the `@carbonplan/zarr-layer` fallback.
+ */
+export function detectGeoZarr(hierarchy) {
+    const candidate = findGeoZarrNode(hierarchy.root);
+    if (candidate)
+        return candidate;
+    // Also check the top-level storeAttrs — some stores put GeoZarr metadata on
+    // the outer zarr.json where the root node wasn't re-attrs'd.
+    if (isGeoZarrAttrs(hierarchy.storeAttrs)) {
+        return { variantPath: '', attrs: hierarchy.storeAttrs };
+    }
+    return null;
+}
+function findGeoZarrNode(node) {
+    if (isGeoZarrAttrs(node.attributes)) {
+        return {
+            variantPath: node.path === '/' ? '' : node.path.replace(/^\//, ''),
+            attrs: node.attributes
+        };
+    }
+    for (const child of node.children) {
+        const match = findGeoZarrNode(child);
+        if (match)
+            return match;
+    }
+    return null;
+}
+function isGeoZarrAttrs(attrs) {
+    if (!attrs)
+        return false;
+    const hasMultiscales = Array.isArray(attrs.multiscales) || Boolean(attrs.multiscales?.layout);
+    const hasSpatial = Boolean(attrs.spatial) ||
+        Boolean(attrs['spatial:dimensions']) ||
+        Boolean(attrs['spatial:shape']);
+    const hasCrs = Boolean(attrs['geo-proj']) ||
+        Boolean(attrs['proj:code']) ||
+        Boolean(attrs['proj:wkt2']) ||
+        Boolean(attrs['proj:projjson']) ||
+        Boolean(attrs.crs) ||
+        Boolean(attrs.crs_wkt);
+    return hasMultiscales && hasSpatial && hasCrs;
+}
+/**
+ * Convert a decoded GeoZarr tile (band-planar or packed RGB) into RGBA
+ * `ImageData` for deck.gl-zarr's `renderTile` callback. Input is expected to
+ * be a Uint8 or Uint16 typed array with either 3 interleaved bytes per pixel
+ * or 3 planar bands of width*height values.
+ *
+ * For 16-bit data the caller supplies the rescale range so the CPU
+ * normalization matches what the GPU `LinearRescale` module would produce.
+ */
+export function zarrTileToImageData(raw, width, height, opts = {}) {
+    const bands = opts.bands ?? 3;
+    const layout = opts.layout ?? 'packed';
+    const min = opts.rescaleMin ?? 0;
+    const max = opts.rescaleMax ?? 255;
+    const range = max - min || 1;
+    const pixelCount = width * height;
+    const rgba = new Uint8ClampedArray(pixelCount * 4);
+    for (let i = 0; i < pixelCount; i++) {
+        let r = 0;
+        let g = 0;
+        let b = 0;
+        if (bands === 1) {
+            const v = Number(raw[i]);
+            r = g = b = (v - min) / range;
+        }
+        else if (layout === 'planar') {
+            r = (Number(raw[i]) - min) / range;
+            g = (Number(raw[pixelCount + i]) - min) / range;
+            b = (Number(raw[2 * pixelCount + i]) - min) / range;
+        }
+        else {
+            const base = i * 3;
+            r = (Number(raw[base]) - min) / range;
+            g = (Number(raw[base + 1]) - min) / range;
+            b = (Number(raw[base + 2]) - min) / range;
+        }
+        const idx = i * 4;
+        rgba[idx] = Math.round(Math.max(0, Math.min(1, r)) * 255);
+        rgba[idx + 1] = Math.round(Math.max(0, Math.min(1, g)) * 255);
+        rgba[idx + 2] = Math.round(Math.max(0, Math.min(1, b)) * 255);
+        rgba[idx + 3] = 255;
+    }
+    return new ImageData(rgba, width, height);
+}
 // ---------------------------------------------------------------------------
 // Kept helpers
 // ---------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walkthru-earth/objex",
-  "version": "1.2.0",
+  "version": "1.3.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,14 +123,14 @@
     }
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.12",
+    "@biomejs/biome": "^2.4.13",
     "@changesets/changelog-github": "^0.5.2",
     "@changesets/cli": "^2.31.0",
     "@fontsource/cairo": "^5.2.7",
     "@internationalized/date": "^3.12.1",
     "@lucide/svelte": "^0.561.0",
     "@sveltejs/adapter-static": "^3.0.10",
-    "@sveltejs/kit": "^2.57.1",
+    "@sveltejs/kit": "^2.58.0",
     "@sveltejs/package": "^2.5.7",
     "@sveltejs/vite-plugin-svelte": "^6.2.4",
     "@tailwindcss/forms": "^0.5.11",
@@ -138,12 +138,12 @@
     "@tailwindcss/vite": "^4.2.4",
     "bits-ui": "^2.18.0",
     "clsx": "^2.1.1",
-    "knip": "^6.6.0",
+    "knip": "^6.6.2",
     "lefthook": "^2.1.6",
     "paneforge": "^1.0.2",
-    "posthog-js": "^1.369.5",
+    "posthog-js": "^1.371.3",
     "publint": "^0.3.18",
-    "svelte": "^5.55.4",
+    "svelte": "^5.55.5",
     "svelte-check": "^4.4.6",
     "tailwind-merge": "^3.5.0",
     "tailwind-variants": "^3.2.2",
@@ -168,11 +168,12 @@
     "@deck.gl/layers": "^9.3.1",
     "@deck.gl/mapbox": "^9.3.1",
     "@deck.gl/mesh-layers": "^9.3.1",
-    "@developmentseed/deck.gl-geotiff": "^0.5.0",
-    "@developmentseed/deck.gl-raster": "^0.5.0",
-    "@developmentseed/epsg": "^0.5.0",
-    "@developmentseed/geotiff": "^0.5.0",
-    "@developmentseed/proj": "^0.5.0",
+    "@developmentseed/deck.gl-geotiff": "0.6.0-alpha.1",
+    "@developmentseed/deck.gl-raster": "0.6.0-alpha.1",
+    "@developmentseed/deck.gl-zarr": "0.6.0-alpha.1",
+    "@developmentseed/epsg": "0.6.0-alpha.1",
+    "@developmentseed/geotiff": "0.6.0-alpha.1",
+    "@developmentseed/proj": "0.6.0-alpha.1",
     "@duckdb/duckdb-wasm": "1.33.1-dev53.0",
     "@geoarrow/deck.gl-layers": "^0.3.2",
     "@luma.gl/core": "^9.3.3",
@@ -190,7 +191,7 @@
     "hyparquet": "^1.25.6",
     "hyparquet-compressors": "^1.1.1",
     "lz-string": "^1.5.0",
-    "maplibre-gl": "^5.23.0",
+    "maplibre-gl": "^5.24.0",
     "marked": "^17.0.6",
     "mermaid": "^11.14.0",
     "pbf": "^4.0.1",
@@ -200,7 +201,7 @@
     "shiki": "^3.23.0",
     "sql-formatter": "^15.7.3",
     "yaml": "^2.8.3",
-    "zarrita": "^0.6.2"
+    "zarrita": "^0.7.2"
   },
   "scripts": {
     "dev": "vite dev",