@loaders.gl/tile-converter 4.5.3 → 5.0.0-alpha.10

package/dist/v5/point-cloud.d.ts

@@ -0,0 +1,24 @@
+import type { Mesh, MeshArrowTable } from '@loaders.gl/schema';
+/** Options for encoding one Arrow or mesh point batch as a 3D Tiles point tile. */
+export interface EncodePointCloudTileOptions {
+    /** Optional origin subtracted from absolute positions and stored as the PNTS RTC_CENTER. */
+    readonly rtcCenter?: readonly [number, number, number];
+    /** Optional source-wide RGBA color stored as the PNTS CONSTANT_RGBA property. */
+    readonly constantRGBA?: readonly number[];
+    /** Optional per-point values indexed by the tile's `BATCH_ID` attribute. */
+    readonly batchTableJson?: Readonly<Record<string, readonly (string | number)[]>>;
+}
+/**
+ * Encodes one mesh or Mesh Arrow point batch as a PNTS resource.
+ *
+ * The input position field must be named `POSITION` and contain xyz values. `COLOR_0` or `COLOR`
+ * is written when present; `constantRGBA` supplies a fallback PNTS `CONSTANT_RGBA` feature-table
+ * property. `NORMAL` and `BATCH_ID` are also written when present. Arrow batches should be passed
+ * one at a time so callers can bound memory and apply their own tiling and output policy.
+ * Unsupported attributes, including a second color attribute, fail instead of being discarded.
+ *
+ * @param pointBatch - Point data produced by a LAS, COPC, I3S, or other point source.
+ * @param options - Optional RTC center and batch-table values.
+ * @returns A 3D Tiles PNTS resource.
+ */
+export declare function encodePointCloudTile(pointBatch: Mesh | MeshArrowTable, options?: EncodePointCloudTileOptions): ArrayBuffer;

package/dist/v5/resource-manifest.d.ts

@@ -0,0 +1,58 @@
+import type { TileConversionReport, TileConversionSink } from './conversion-api.js';
+/** Durable record for one successfully written, deterministic output resource. */
+export interface TileResourceManifestEntry {
+    /** Stable resource identifier supplied by the output profile. */
+    readonly resourceId: string;
+    /** Byte length of the output resource. */
+    readonly byteLength: number;
+    /** Stable caller-computed content fingerprint, such as a SHA-256 digest. */
+    readonly fingerprint: string;
+}
+/** Versioned progress record used to resume deterministic output packaging. */
+export interface TileResourceManifest {
+    /** Manifest format version. */
+    readonly version: 1;
+    /** True only after the destination and report have been finalized successfully. */
+    readonly complete: boolean;
+    /** Resources durably written before interruption or completion. */
+    readonly resources: readonly TileResourceManifestEntry[];
+    /** Conversion summary saved after successful destination finalization. */
+    readonly report?: TileConversionReport;
+}
+/** Application-owned persistence for a conversion manifest. */
+export interface TileResourceManifestStore {
+    /** Loads the previous manifest, or returns null when starting a new conversion. */
+    load(): Promise<TileResourceManifest | null>;
+    /** Atomically replaces the saved manifest with the supplied snapshot. */
+    save(manifest: TileResourceManifest): Promise<void>;
+}
+/** Options for decorating a resource sink with restart-safe manifest tracking. */
+export interface ManifestBackedTileConversionSinkOptions<TResource> {
+    /** Output destination with deterministic, idempotent resource writes. */
+    readonly sink: TileConversionSink<TResource>;
+    /** Persistence adapter for snapshots written after each resource. */
+    readonly manifestStore: TileResourceManifestStore;
+    /** Stable profile-specific path or resource key. */
+    readonly getResourceId: (resource: TResource) => string;
+    /** Byte length used to detect changed content under an existing resource ID. */
+    readonly measureResourceBytes: (resource: TResource) => number;
+    /** Stable fingerprint used to detect changed content under an existing resource ID. */
+    readonly fingerprintResource: (resource: TResource) => string;
+}
+/**
+ * Creates a sink that skips matching checkpointed resources when a process restarts.
+ *
+ * The destination must write resources idempotently by the ID returned from `getResourceId`.
+ * The manifest is persisted after every successful write; the store should replace snapshots
+ * atomically. Existing IDs must retain their byte length and fingerprint or the resumed job fails
+ * rather than silently mixing output from different conversion inputs. Writes are serialized even
+ * when callers issue them concurrently. Reports count resources processed by the current run,
+ * including writes skipped because the matching resource was already present. A graceful abort
+ * clears the manifest checkpoint before asking the destination to clean partial output, so the
+ * next run starts cleanly. A process interruption that does not call `abort` can resume from its
+ * last saved checkpoint.
+ *
+ * @param options - Destination, manifest store, stable IDs, byte measurement, and fingerprinting.
+ * @returns A `TileConversionSink` with resumable per-resource progress.
+ */
+export declare function createManifestBackedTileConversionSink<TResource>(options: ManifestBackedTileConversionSinkOptions<TResource>): Promise<TileConversionSink<TResource>>;

package/dist/v5/spatial-conversion.d.ts

@@ -0,0 +1,59 @@
+import type { CreateTilesetSpatialReferenceOptions, I3SSpatialBounds, I3STransformedPositions, Tiles3DSpatialBoundingVolume, TilesetSpatialOptions, TilesetSpatialReference } from '@loaders.gl/tiles';
+/** Portable coordinate operations and output metadata for a 3D Tiles conversion. */
+export interface Tiles3DConversionSpatialContext {
+    /** Source and selected target CRS, height reference, units, and transformation state. */
+    readonly spatialReference: TilesetSpatialReference;
+    /** Transform packed absolute xyz positions using double precision output. */
+    transformPositions(positions: ArrayLike<number>): Float64Array;
+    /** Transform packed normals using the corresponding source positions. */
+    transformNormals(normals: ArrayLike<number>, positions: ArrayLike<number>): Float32Array;
+    /** Rebuild a conservative bound in the selected target coordinate frame. */
+    transformBoundingVolume(volume: Tiles3DSpatialBoundingVolume, sourceTransform?: ArrayLike<number>): Tiles3DSpatialBoundingVolume;
+}
+/** Portable coordinate operations and output metadata for an I3S conversion. */
+export interface I3SConversionSpatialContext {
+    /** Source and selected target CRS, height reference, units, and transformation state. */
+    readonly spatialReference: TilesetSpatialReference;
+    /** Transform absolute I3S positions after applying declared height units and placement. */
+    transformPositions(positions: ArrayLike<number>, sourceOrigin: ArrayLike<number>): I3STransformedPositions;
+    /** Transform absolute I3S positions when terrain or scene sampling is asynchronous. */
+    transformPositionsAsync(positions: ArrayLike<number>, sourceOrigin: ArrayLike<number>): Promise<I3STransformedPositions>;
+    /** Transform packed normals using the corresponding source positions. */
+    transformNormals(normals: ArrayLike<number>, positions: ArrayLike<number>, normalReferenceFrame?: string): Float32Array;
+    /** Rebuild a conservative I3S bound in the selected target frame. */
+    transformBoundingVolume(bounds: I3SSpatialBounds): I3SSpatialBounds | {
+        box?: number[];
+        region?: number[];
+    };
+    /** Rebuild a bound when terrain or scene sampling is asynchronous. */
+    transformBoundingVolumeAsync(bounds: I3SSpatialBounds): Promise<I3SSpatialBounds | {
+        box?: number[];
+        region?: number[];
+    }>;
+}
+/**
+ * Creates the shared spatial operations used to write 3D Tiles in a selected CRS and height frame.
+ *
+ * Source discovery remains format-specific and should use `get3DTilesSpatialReference` or the
+ * initialized source's spatial metadata. Target choices on a normalized, transformable reference
+ * are retained unless overridden in `options`. Do not reuse a reference already marked
+ * `transformed`; that would apply the operation twice. The returned reference is the metadata to
+ * publish with transformed output; unresolved requests fail instead of guessing a CRS or height datum.
+ *
+ * @param discovered - Source CRS, units, coordinate epoch, and height metadata.
+ * @param options - Target CRS, height reference, and explicitly supplied geoid resources.
+ * @returns Shared position, normal, and bound operations with matching output metadata.
+ */
+export declare function createTiles3DConversionSpatialContext(discovered: CreateTilesetSpatialReferenceOptions | TilesetSpatialReference, options?: TilesetSpatialOptions): Tiles3DConversionSpatialContext;
+/**
+ * Creates the shared spatial operations used to write I3S in a selected CRS and height frame.
+ *
+ * I3S height units, vertical datum, elevation placement, and bounds use the same transformer as
+ * the source-backed tile runtime. Terrain or scene elevation providers are explicit application
+ * inputs and may make position and bound operations asynchronous.
+ *
+ * @param discovered - Source CRS, vertical units, height reference, and elevation mode.
+ * @param options - Target CRS, height reference, geoid, or explicit elevation providers.
+ * @returns Shared position, normal, bound, and output-metadata operations.
+ */
+export declare function createI3SConversionSpatialContext(discovered: CreateTilesetSpatialReferenceOptions | TilesetSpatialReference, options?: TilesetSpatialOptions): I3SConversionSpatialContext;

package/dist/v5/tileset-source.d.ts

@@ -0,0 +1,21 @@
+import type { Tileset3D, TilesetContentTraversalItem, TilesetSourceMetadata, TraverseTilesetContentsOptions } from '@loaders.gl/tiles';
+import type { TileConversionSource } from './conversion-api.js';
+/** Decoded-content lifetime options for source-backed conversion. */
+export type TilesetConversionSourceOptions = Pick<TraverseTilesetContentsOptions, 'unloadContent'>;
+/**
+ * Adapts a source-backed tileset to the portable v5 conversion source contract.
+ *
+ * Inspection waits for initialization and returns the source's normalized metadata. Reading uses
+ * camera-independent shared traversal, retaining each placement and its ordered decoded contents.
+ * Source adapters own content, subtree, node-page, nested tileset, and archive resolution.
+ *
+ * Enable `unloadContent` on a dedicated runtime to release newly loaded payloads after the codec
+ * and awaited writes finish, or iteration closes on failure. Preloaded payloads remain attached.
+ * Applications own tileset destruction, format codecs, byte accounting, and output packaging.
+ * This adapter does not impose an aggregate input memory limit or transform coordinates.
+ *
+ * @param tileset - An initializing or initialized runtime backed by a 3D Tiles or I3S source.
+ * @param options - Optional cleanup of content loaded during conversion.
+ * @returns A source accepted by `inspectTileset` and `convertTileset`.
+ */
+export declare function createTilesetConversionSource(tileset: Tileset3D, options?: TilesetConversionSourceOptions): TileConversionSource<TilesetSourceMetadata, TilesetContentTraversalItem>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/tile-converter",
-  "version": "4.5.3",
+  "version": "5.0.0-alpha.10",
   "description": "Converter",
   "license": "MIT",
   "type": "module",
@@ -24,6 +24,26 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./v5": {
+      "types": "./dist/v5/index.d.ts",
+      "import": "./dist/v5/index.js",
+      "require": "./dist/v5/index.cjs"
+    },
+    "./v5/browser": {
+      "types": "./dist/v5/browser.d.ts",
+      "import": "./dist/v5/browser.js",
+      "require": "./dist/v5/browser.cjs"
+    },
+    "./v5/core": {
+      "types": "./dist/v5/core.d.ts",
+      "import": "./dist/v5/core.js",
+      "require": "./dist/v5/core.cjs"
+    },
+    "./v5/adapters": {
+      "types": "./dist/v5/adapters.d.ts",
+      "import": "./dist/v5/adapters.js",
+      "require": "./dist/v5/adapters.cjs"
     }
   },
   "sideEffects": false,
@@ -45,30 +65,36 @@
     "process": false
   },
   "scripts": {
-    "pre-build": "npm run build-converter-bundle && npm run build-i3s-server-bundle && npm run copy-certificates",
-    "build-converter-bundle": "esbuild src/converter-cli.ts --outfile=dist/converter.min.cjs --platform=node --target=esnext,node14 --external:join-images --minify --bundle --define:__VERSION__=\\\"$npm_package_version\\\"",
-    "build-i3s-server-bundle": "esbuild src/i3s-server/bin/www.ts --outfile=dist/i3s-server/bin/i3s-server.min.cjs --platform=node --target=esnext,node14 --minify --bundle --define:__VERSION__=\\\"$npm_package_version\\\"",
-    "copy-certificates": "cp -R src/i3s-server/certs dist/i3s-server"
+    "pre-build": "npm run build-package-entrypoints && npm run build-converter-bundle && npm run build-i3s-server-bundle && npm run copy-certificates",
+    "build-package-entrypoints": "esbuild src/index.ts --bundle --packages=external --platform=node --format=esm --outfile=dist/index.js && esbuild src/index.ts --bundle --packages=external --platform=node --format=cjs --outfile=dist/index.cjs && npm run build-v5-entrypoints && npm run build-v5-declarations",
+    "build-v5-declarations": "tsc --project tsconfig.v5.json",
+    "build-converter-bundle": "esbuild src/v4/converter-cli.ts --outfile=dist/converter.min.cjs --platform=node --target=esnext,node14 --external:join-images --minify --bundle --define:__VERSION__=\\\"$npm_package_version\\\"",
+    "build-i3s-server-bundle": "esbuild src/v4/i3s-server/bin/www.ts --outfile=dist/i3s-server/bin/i3s-server.min.cjs --platform=node --target=esnext,node14 --minify --bundle --define:__VERSION__=\\\"$npm_package_version\\\"",
+    "copy-certificates": "cp -R src/v4/i3s-server/certs dist/i3s-server",
+    "build-v5-entrypoints": "esbuild src/v5/core.ts src/v5/adapters.ts src/v5/index.ts src/v5/browser.ts --bundle --packages=external --external:@loaders.gl/* --platform=browser --outdir=dist/v5 --format=esm && esbuild src/v5/core.ts src/v5/adapters.ts src/v5/index.ts src/v5/browser.ts --bundle --packages=external --external:@loaders.gl/* --platform=browser --outdir=dist/v5 --format=cjs --out-extension:.js=.cjs"
   },
   "dependencies": {
-    "@loaders.gl/3d-tiles": "4.5.3",
-    "@loaders.gl/compression": "4.5.3",
-    "@loaders.gl/crypto": "4.5.3",
-    "@loaders.gl/draco": "4.5.3",
-    "@loaders.gl/gltf": "4.5.3",
-    "@loaders.gl/i3s": "4.5.3",
-    "@loaders.gl/images": "4.5.3",
-    "@loaders.gl/loader-utils": "4.5.3",
-    "@loaders.gl/math": "4.5.3",
-    "@loaders.gl/polyfills": "4.5.3",
-    "@loaders.gl/textures": "4.5.3",
-    "@loaders.gl/tiles": "4.5.3",
-    "@loaders.gl/worker-utils": "4.5.3",
-    "@loaders.gl/zip": "4.5.3",
-    "@math.gl/core": "^4.1.0",
-    "@math.gl/culling": "^4.1.0",
-    "@math.gl/geoid": "^4.1.0",
-    "@math.gl/geospatial": "^4.1.0",
+    "@loaders.gl/3d-tiles": "5.0.0-alpha.10",
+    "@loaders.gl/compression": "5.0.0-alpha.10",
+    "@loaders.gl/crypto": "5.0.0-alpha.10",
+    "@loaders.gl/draco": "5.0.0-alpha.10",
+    "@loaders.gl/gltf": "5.0.0-alpha.10",
+    "@loaders.gl/i3s": "5.0.0-alpha.10",
+    "@loaders.gl/images": "5.0.0-alpha.10",
+    "@loaders.gl/loader-utils": "5.0.0-alpha.10",
+    "@loaders.gl/polyfills": "5.0.0-alpha.10",
+    "@loaders.gl/schema": "5.0.0-alpha.10",
+    "@loaders.gl/schema-utils": "5.0.0-alpha.10",
+    "@loaders.gl/textures": "5.0.0-alpha.10",
+    "@loaders.gl/tiles": "5.0.0-alpha.10",
+    "@loaders.gl/worker-utils": "5.0.0-alpha.10",
+    "@loaders.gl/zip": "5.0.0-alpha.10",
+    "@math.gl/core": "5.0.0-alpha.13",
+    "@math.gl/crs": "5.0.0-alpha.13",
+    "@math.gl/culling": "5.0.0-alpha.13",
+    "@math.gl/geoid": "5.0.0-alpha.13",
+    "@math.gl/geometry-utils": "5.0.0-alpha.13",
+    "@math.gl/geospatial": "5.0.0-alpha.13",
     "ajv": "^8.12.0",
     "archiver": "^5.0.0",
     "cors": "^2.8.5",
@@ -77,7 +103,6 @@
     "express": "~4.19.2",
     "inquirer": "^8.0.0",
     "json-map-transform": "^1.2.6",
-    "jszip": "^3.5.0",
     "md5": "^2.3.0",
     "morgan": "~1.9.1",
     "uuid": "^9.0.0"
@@ -88,10 +113,11 @@
   },
   "devDependencies": {
     "@types/express": "^4.17.17",
-    "@types/inquirer": "^9.0.7"
+    "@types/inquirer": "^9.0.7",
+    "typescript": "^6.0.3"
   },
   "peerDependencies": {
-    "@loaders.gl/core": "~4.5.0"
+    "@loaders.gl/core": "~5.0.0-alpha.0"
   },
-  "gitHead": "3ad4ab002b4a53ac5d88feb856117a8a1e8c5bb0"
+  "gitHead": "7cbfaef633e86356c946541dab4977b522745b6c"
 }

package/src/common/README.md

@@ -0,0 +1,5 @@
+# Shared tile-converter code
+
+Place code here when it is intentionally shared by multiple converter versions.
+Version-specific implementations belong in `v4/` or `v5/` so their APIs and
+runtime requirements remain independent.

package/src/index.ts

@@ -1,2 +1 @@
-export {default as I3SConverter} from './i3s-converter/i3s-converter';
-export {default as Tiles3DConverter} from './3d-tiles-converter/3d-tiles-converter';
+export * from './v4/index.js';

package/src/{3d-tiles-converter → v4/3d-tiles-converter}/3d-tiles-converter.ts

@@ -14,6 +14,7 @@ import {load, isBrowser} from '@loaders.gl/core';
 import {I3SLoader, I3SAttributeLoader, COORDINATE_SYSTEM} from '@loaders.gl/i3s';
 import {Geoid} from '@math.gl/geoid';
 
+import {validateI3SConversionSpatialReference} from './helpers/validate-i3s-spatial-reference';
 import {PGMLoader} from '../pgm-loader';
 import {i3sObbTo3dTilesObb} from './helpers/i3s-obb-to-3d-tiles-obb';
 import {convertScreenThresholdToGeometricError} from '../lib/utils/lod-conversion-utils';
@@ -134,8 +135,6 @@ export default class Tiles3DConverter {
       }
     }
 
-    this.progress.startMonitoring();
-
     this.sourceTileset = await loadFromArchive(
       inputUrl,
       I3SLoader,
@@ -151,6 +150,18 @@ export default class Tiles3DConverter {
       return undefined;
     }
 
+    try {
+      validateI3SConversionSpatialReference(this.sourceTileset);
+    } catch (error) {
+      try {
+        await this.slpkFilesystem?.destroy();
+      } finally {
+        this.slpkFilesystem = null;
+      }
+      throw error;
+    }
+    this.progress.startMonitoring();
+
     const rootNode = this.sourceTileset?.root;
     if (!rootNode.obb) {
       rootNode.obb = createObbFromMbs(rootNode.mbs);
@@ -177,7 +188,7 @@ export default class Tiles3DConverter {
     if (!this.conversionDump.restored) {
       try {
         await removeDir(this.tilesetPath);
-      } catch (e) {
+      } catch (_e) {
         // do nothing
       }
     }

package/src/{3d-tiles-converter → v4/3d-tiles-converter}/helpers/3d-tiles-content-converter.ts

@@ -209,7 +209,7 @@ export class Tiles3DContentConverter {
     featureAttributes: I3STileAttributes
   ): PropertyAttribute | null {
     const attributeValues = featureAttributes[attributeName];
-    const info = attributeStorageInfo.find((e) => e.name === attributeName);
+    const info = attributeStorageInfo.find(e => e.name === attributeName);
     if (!info) {
       return null;
     }
@@ -477,6 +477,6 @@ export class Tiles3DContentConverter {
    */
   _checkNormals(normals) {
     // If all normals === 0, the resulting tileset is all in black colors on Cesium
-    return normals.find((value) => value);
+    return normals.find(value => value);
   }
 }

package/src/v4/3d-tiles-converter/helpers/validate-i3s-spatial-reference.ts

@@ -0,0 +1,124 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+
+import {parseWKTCRS, type WKTCRSNode} from '@math.gl/crs';
+import {getSpatialCoordinateFrame} from '@loaders.gl/tiles';
+
+/** Horizontal CRS declarations consumed by the legacy I3S converter. */
+export type I3SConversionSpatialReference = {
+  /** Layer-level horizontal coordinate reference system. */
+  spatialReference?: {
+    /** Original spatial reference identifier. */
+    wkid?: number;
+    /** Current spatial reference identifier. */
+    latestWkid?: number;
+    /** Custom spatial reference definition. */
+    wkt?: string;
+  };
+  /** Fallback CRS declaration on the layer extent. */
+  fullExtent?: {
+    /** Coordinate system shared by the extent and layer. */
+    spatialReference?: I3SConversionSpatialReference['spatialReference'];
+  };
+  /** Coordinate systems declared for node bounds and geometry. */
+  store?: {
+    /** Coordinate system used by node bounds. */
+    indexCRS?: string;
+    /** Coordinate system used by geometry positions. */
+    vertexCRS?: string;
+  };
+};
+
+/**
+ * Reject explicit horizontal CRS declarations that the legacy converter cannot transform.
+ * Undeclared CRS metadata retains the historical WGS-84 assumption.
+ * @param layer - Source layer metadata, before interpreting any coordinates as longitude/latitude.
+ */
+export function validateI3SConversionSpatialReference(layer: I3SConversionSpatialReference): void {
+  const spatialReferences = [layer.spatialReference, layer.fullExtent?.spatialReference];
+  const unsupportedSpatialReference = spatialReferences.find(spatialReference => {
+    if (!spatialReference) {
+      return false;
+    }
+    const identifier = spatialReference.latestWkid ?? spatialReference.wkid;
+    return (
+      (identifier !== undefined && identifier !== 4326 && identifier !== 4979) ||
+      (spatialReference.wkt !== undefined && !isWgs84GeographicWkt(spatialReference.wkt))
+    );
+  });
+  const declarations = [layer.store?.indexCRS, layer.store?.vertexCRS].filter(
+    (declaration): declaration is string => Boolean(declaration)
+  );
+  const unsupportedDeclaration = declarations.find(
+    declaration =>
+      !/^(?:EPSG:(?:4326|4979)|urn:ogc:def:crs:EPSG::(?:4326|4979)|https?:\/\/www\.opengis\.net\/def\/crs\/EPSG\/0\/(?:4326|4979)\/?)$/i.test(
+        declaration
+      )
+  );
+  if (unsupportedSpatialReference || unsupportedDeclaration) {
+    const identifier = unsupportedSpatialReference?.latestWkid ?? unsupportedSpatialReference?.wkid;
+    const description =
+      unsupportedDeclaration || (identifier !== undefined ? `EPSG:${identifier}` : 'custom WKT');
+    throw new Error(
+      `The legacy I3S-to-3D Tiles converter requires WGS-84 (EPSG:4326) input; received ${description}. Reproject the source I3S dataset to EPSG:4326 before conversion.`
+    );
+  }
+}
+
+/** Recognize geographic WGS-84 WKT with degree units and the Greenwich prime meridian. */
+function isWgs84GeographicWkt(wellKnownText: string): boolean {
+  try {
+    if (getSpatialCoordinateFrame(wellKnownText) !== 'geographic') {
+      return false;
+    }
+    const {root} = parseWKTCRS(wellKnownText);
+    const nodes = collectWktNodes(root);
+    const datum = root.values.find(
+      value =>
+        value.type === 'node' &&
+        ['DATUM', 'ENSEMBLE', 'GEODETICDATUM'].includes(value.keyword.toUpperCase())
+    );
+    if (datum?.type !== 'node' || datum.values[0]?.type !== 'string') {
+      return false;
+    }
+    const datumName = datum.values[0].value.toLowerCase().replace(/[^a-z0-9]/g, '');
+    if (
+      ![
+        'wgs84',
+        'wgs1984',
+        'dwgs1984',
+        'worldgeodeticsystem1984',
+        'worldgeodeticsystem1984ensemble'
+      ].includes(datumName)
+    ) {
+      return false;
+    }
+    const angularUnits = nodes.filter(
+      node =>
+        ['UNIT', 'ANGLEUNIT'].includes(node.keyword.toUpperCase()) &&
+        (node === root || root.values.includes(node) || node.keyword.toUpperCase() === 'ANGLEUNIT')
+    );
+    const primeMeridian = nodes.find(node => node.keyword.toUpperCase() === 'PRIMEM');
+    return (
+      angularUnits.length > 0 &&
+      angularUnits.every(
+        node =>
+          node.values[1]?.type === 'number' &&
+          Math.abs(node.values[1].value - Math.PI / 180) < 1e-12
+      ) &&
+      (!primeMeridian ||
+        (primeMeridian.values[1]?.type === 'number' && primeMeridian.values[1].value === 0))
+    );
+  } catch {
+    return false;
+  }
+}
+
+/** Collect WKT nodes for semantic checks without inspecting quoted text as syntax. */
+function collectWktNodes(node: WKTCRSNode): WKTCRSNode[] {
+  return [
+    node,
+    ...node.values.flatMap(value => (value.type === 'node' ? collectWktNodes(value) : []))
+  ];
+}

package/src/{3d-tiles-converter → v4/3d-tiles-converter}/json-templates/tileset.ts

@@ -22,21 +22,21 @@ const TILE = () => ({
   },
   children: {
     path: 'children',
-    transform: (val) => val.map((tile) => transform(tile, TILE()))
+    transform: val => val.map(tile => transform(tile, TILE()))
   }
 });
 
 export const TILESET = () => ({
   asset: {
     path: 'asset',
-    transform: (val) => transform(val, ASSET())
+    transform: val => transform(val, ASSET())
   },
   geometricError: {
     path: 'root',
-    transform: (val) => val.geometricError
+    transform: val => val.geometricError
   },
   root: {
     path: 'root',
-    transform: (val) => transform(val, TILE())
+    transform: val => transform(val, TILE())
   }
 });

package/src/{converter-cli.ts → v4/converter-cli.ts}

@@ -152,7 +152,7 @@ async function main() {
   await convert(validatedOptions);
 }
 
-main().catch((error) => {
+main().catch(error => {
   console.log(error);
   process.exit(1); // eslint-disable-line no-process-exit
 });
@@ -280,13 +280,13 @@ function validateOptions(
     inputType: {
       getMessage: () =>
         console.log('Missed/Incorrect: --input-type [tileset input type: I3S or 3DTILES]'),
-      condition: (value) =>
+      condition: value =>
         addHash || (Boolean(value) && Object.values(TILESET_TYPE).includes(value.toUpperCase()))
     },
     outputVersion: {
       getMessage: () =>
         console.log('Incorrect: --output-version [1.0 or 1.1] is for --input-type "I3S" only'),
-      condition: (value) =>
+      condition: value =>
         addHash ||
         (Boolean(value) &&
           Object.values(['1.0', '1.1']).includes(value) &&
@@ -307,7 +307,7 @@ function validateOptions(
     }
   }
   if (exceptions.length) {
-    exceptions.forEach((exeption) => exeption());
+    exceptions.forEach(exeption => exeption());
     process.exit(1); // eslint-disable-line no-process-exit
   }
   return <ValidatedTileConversionOptions>options;

package/src/{deps-installer → v4/deps-installer}/deps-installer.ts

@@ -48,13 +48,13 @@ export class DepsInstaller {
     await this.installFromNpm('draco', 'draco-worker-node.js');
 
     console.log('Installing "Draco Writer" worker'); // eslint-disable-line no-console
-    await this.installFromNpm('draco', 'draco-writer-worker-node.js');
+    await this.installFromNpm('draco', 'draco-writer-worker-node.cjs');
 
     console.log('Installing "Basis Loader" worker'); // eslint-disable-line no-console
-    await this.installFromNpm('textures', 'basis-worker-node.js');
+    await this.installFromNpm('textures', 'basis-worker-node.cjs');
 
     console.log('Installing "KTX2 Basis Writer" worker'); // eslint-disable-line no-console
-    await this.installFromNpm('textures', 'ktx2-basis-writer-worker-node.js');
+    await this.installFromNpm('textures', 'ktx2-basis-writer-worker-node.cjs');
 
     console.log('Installing "Draco decoder" library'); // eslint-disable-line no-console
     await this.installFromUrl(
@@ -101,13 +101,16 @@ export class DepsInstaller {
     console.log('All dependencies were installed succesfully.'); // eslint-disable-line no-console
   }
 
+  /** Download a published worker or library into the converter's local resource directory. */
   private async installFromNpm(module: string, name: string, extraPath: string = '') {
-    const fileResponse = await fetchFile(
-      `https://unpkg.com/@loaders.gl/${module}@${VERSION}/dist/${extraPath}/${name}`
-    );
+    const resourcePath = ['dist', extraPath, name].filter(Boolean).join('/');
+    const resourceUrl = `https://unpkg.com/@loaders.gl/${module}@${VERSION}/${resourcePath}`;
+    const fileResponse = await fetchFile(resourceUrl);
 
     if (fileResponse.status < 200 || fileResponse.status >= 300) {
-      throw new Error(`Failed to load resource ${name}`);
+      throw new Error(
+        `Failed to load resource ${name} from ${resourceUrl}: HTTP ${fileResponse.status}`
+      );
     }
 
     const fileData = await fileResponse.arrayBuffer();

package/src/{i3s-converter → v4/i3s-converter}/helpers/attribute-metadata-info.ts

@@ -74,7 +74,7 @@ export class AttributeMetadataInfo {
       /*
       We will append a new attribute only in case it has not been added to the attribute storage info yet.
       */
-      const elementFound = this._attributeStorageInfo.find((element) => element.name === key);
+      const elementFound = this._attributeStorageInfo.find(element => element.name === key);
       if (!elementFound) {
         const attributeType = attributeTypes[key];
 

package/src/{i3s-converter → v4/i3s-converter}/helpers/batch-ids-extensions.ts

@@ -10,7 +10,7 @@ import type {
 } from '@loaders.gl/gltf';
 import {EXT_MESH_FEATURES, EXT_FEATURE_METADATA} from '@loaders.gl/gltf';
 import {Tiles3DTileContent} from '@loaders.gl/3d-tiles';
-import {emod} from '@loaders.gl/math';
+import {emod} from '@math.gl/geometry-utils';
 import {TypedArray} from '@math.gl/core';
 import {TextureImageProperties} from '../types';
 

package/src/v4/i3s-converter/helpers/encode-string-attribute.ts

@@ -0,0 +1,23 @@
+/**
+ * Encodes I3S string attributes as little-endian counts followed by UTF-8 strings.
+ * Each string's byte count includes its trailing null byte. Values retain the
+ * converter's existing JavaScript string coercion, including null and undefined.
+ */
+export function encodeStringAttribute(values: readonly unknown[]): ArrayBuffer {
+  const textEncoder = new TextEncoder();
+  const encodedValues = Array.from(values, value => textEncoder.encode(`${String(value)}\0`));
+  const stringByteLength = encodedValues.reduce((total, value) => total + value.byteLength, 0);
+  const headerByteLength = (2 + values.length) * Uint32Array.BYTES_PER_ELEMENT;
+  const output = new Uint8Array(headerByteLength + stringByteLength);
+  const header = new DataView(output.buffer);
+  header.setUint32(0, values.length, true);
+  header.setUint32(4, stringByteLength, true);
+
+  let byteOffset = headerByteLength;
+  for (const [index, encodedValue] of encodedValues.entries()) {
+    header.setUint32(8 + index * Uint32Array.BYTES_PER_ELEMENT, encodedValue.byteLength, true);
+    output.set(encodedValue, byteOffset);
+    byteOffset += encodedValue.byteLength;
+  }
+  return output.buffer;
+}

package/src/{i3s-converter → v4/i3s-converter}/helpers/geometry-attributes.ts

@@ -211,7 +211,7 @@ function unifyObjectsByFeatureId(
     attributes: GroupedByFeatureIdAttributes[];
   }[] = [];
   for (const data of sortedData) {
-    const existingObject = groupedMetadata.find((obj) => obj.featureId === data.featureId);
+    const existingObject = groupedMetadata.find(obj => obj.featureId === data.featureId);
     if (existingObject) {
       existingObject.attributes.push(data);
     } else {