@loaders.gl/tile-converter 5.0.0-alpha.11 → 5.0.0-alpha.14

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

@@ -0,0 +1,19 @@
+import type { Mesh, MeshArrowTable } from '@loaders.gl/core/schema';
+/** Explicit source-name mapping and authorized semantic losses. */
+export interface PointCloudAttributeMapping {
+    /** Destination attribute name to source attribute name. Values and normalization remain unchanged. */
+    readonly attributes: Readonly<Record<string, string>>;
+    /** Source attributes intentionally omitted, each with a nonempty reason. */
+    readonly drop?: Readonly<Record<string, string>>;
+}
+/** Decoded mapped rows and a record of every authorized omission. */
+export interface MappedPointCloud {
+    /** Mesh with renamed attributes sharing immutable source values. */
+    readonly mesh: Mesh;
+    /** Explicit source-name/reason pairs, sorted deterministically. */
+    readonly droppedAttributes: Readonly<Record<string, string>>;
+}
+/** Maps decoded point attributes without implicit aliases, casts, projection or silent omissions. */
+export declare function mapPointCloudAttributes(input: Mesh | MeshArrowTable, mapping: PointCloudAttributeMapping): MappedPointCloud;
+/** Converts decoded point input after optional retained-buffer accounting and null validation. */
+export declare function getPointCloudMesh(input: Mesh | MeshArrowTable, maxInputBytes?: number): Mesh;

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

@@ -1,4 +1,4 @@
-import type { PointCloudTilesetSource } from '@loaders.gl/tiles';
+import type { PointCloudTilesetSource } from '@loaders.gl/tiles-3d';
 import type { TileConversionProgress, TileConversionReport, TileConversionSink } from '@loaders.gl/tile-converter/v5/core';
 import type { PointCloudSourceTile } from '@loaders.gl/tile-converter/v5/core';
 import type { EncodedPointCloudSourceTile, EncodePointCloudSourceOptions } from './point-cloud-source-encoder.js';

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

@@ -0,0 +1,44 @@
+import { type COPCWriterOptions } from '@loaders.gl/tiles-3d/copc';
+import type { Mesh, MeshArrowTable } from '@loaders.gl/core/schema';
+import { type TileConversionCodec } from '@loaders.gl/tile-converter/v5/core';
+import { type PointCloudAttributeMapping } from './point-cloud-attributes.js';
+/** Bounded, explicitly placed COPC batch authoring. */
+export interface EncodePointCloudCOPCOptions {
+    /** All attribute aliases and semantic omissions must be explicit. */
+    readonly mapping: PointCloudAttributeMapping;
+    /** LAS axis scales; positions must already be absolute coordinates in the declared CRS. */
+    readonly scale: readonly [number, number, number];
+    /** LAS axis offsets used for signed int32 quantization. */
+    readonly offset: readonly [number, number, number];
+    /** Explicit OGC WKT CRS declaration; no inference or reprojection is performed. */
+    readonly wkt: string;
+    /** Maximum Euclidean quantization error in source units. */
+    readonly maxPositionError: number;
+    /** Maximum distinct retained source buffer bytes; default 64 MiB. */
+    readonly maxInputBytes?: number;
+    /** Maximum rows in one batch; default 1000000. */
+    readonly maxPoints?: number;
+    /** Maximum completed encoded bytes; default 128 MiB. Writer temporary memory is additional. */
+    readonly maxOutputBytes?: number;
+    /** Explicit LAS Extra Bytes names for custom typed attributes, including exact 64-bit IDs. */
+    readonly extraBytes?: NonNullable<COPCWriterOptions['copc']>['extraBytes'];
+    /** Optional octree organization forwarded to the owning COPC writer. */
+    readonly organization?: Pick<NonNullable<COPCWriterOptions['copc']>, 'nodePointLimit' | 'maximumDepth' | 'hierarchyPageDepth' | 'spacing'>;
+    /** Cancellation before validation and before/after synchronous writer execution. */
+    readonly signal?: AbortSignal;
+}
+/** A complete COPC file and its explicit precision/loss report. */
+export interface EncodedPointCloudCOPC {
+    /** Range-readable COPC 1.0 / LAZ 1.4 bytes. */
+    readonly copc: ArrayBuffer;
+    /** Exact encoded point count. */
+    readonly pointCount: number;
+    /** Maximum reconstructed Euclidean position error. */
+    readonly maximumPositionError: number;
+    /** Authorized attribute omissions and reasons. */
+    readonly droppedAttributes: Readonly<Record<string, string>>;
+}
+/** Encodes one decoded point batch as COPC with explicit mappings, CRS and precision gates. */
+export declare function encodePointCloudCOPC(input: Mesh | MeshArrowTable, options: EncodePointCloudCOPCOptions): Promise<EncodedPointCloudCOPC>;
+/** Creates a v5 codec for one independently authored COPC file per decoded input batch. */
+export declare function createCOPCConversionCodec(options: EncodePointCloudCOPCOptions): TileConversionCodec<unknown, Mesh | MeshArrowTable, EncodedPointCloudCOPC>;

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

@@ -0,0 +1,83 @@
+import type { COPCTileSource, COPCSourceLoaderOptions } from '@loaders.gl/tiles-3d/copc';
+import { PotreeSourceLoader } from '@loaders.gl/tiles-3d/potree';
+import type { PotreeDataset, PotreeWriterNode, PotreeWriterOptions, PotreeSourceLoaderOptions } from '@loaders.gl/tiles-3d/potree';
+import type { Mesh, MeshArrowTable, MeshGeometry } from '@loaders.gl/core/schema';
+/** Explicit local-file input; no format is inferred from an extension. */
+export type OpenPointCloudFileOptions = {
+    /** Maximum retained input Blob size. This does not bound decoded heap. */
+    readonly maxFileBytes: number;
+    /** Cancellation before/after initialization and during archived resource reads. */
+    readonly signal?: AbortSignal;
+} & ({
+    /** COPC is a native single LAZ file. */
+    readonly format: 'copc';
+    /** Existing COPC source coordinate and decoder controls. */
+    readonly sourceOptions?: COPCSourceLoaderOptions;
+} | {
+    /** A loaders.gl STORE ZIP convention, not a native Potree archive standard. */
+    readonly format: 'potree-zip';
+    /** Maximum ZIP entry count, including metadata; default 100000. */
+    readonly maxEntries?: number;
+    /** Maximum requested ZIP resource/range bytes; default 64 MiB. */
+    readonly maxResourceBytes?: number;
+    /** Explicit metadata path when it is not at the ZIP root. */
+    readonly metadataPath?: string;
+    /** Existing Potree parser controls; the bundle owns its isolated fetch transport. */
+    readonly sourceOptions?: PotreeSourceLoaderOptions;
+});
+/** An initialized source with an owned local file lifetime. */
+export interface OpenedPointCloudFile {
+    /** Lazy node access through the existing unified source APIs. */
+    readonly source: ReturnType<typeof PotreeSourceLoader.createDataSource> | COPCTileSource;
+    /** Closes the source and rejects subsequent bundle reads; idempotent. */
+    readonly close: () => Promise<void>;
+}
+/** Complete Potree dataset packaging controls. */
+export interface EncodePotreeArchiveOptions {
+    /** Existing dataset version, precision, hierarchy and encoded-byte limits. */
+    readonly potree?: PotreeWriterOptions['potree'];
+    /** Maximum completed STORE ZIP32 bytes, checked before archive allocation. */
+    readonly maxArchiveBytes: number;
+}
+/**
+ * Writes a complete Potree 1.x/2.0 dataset to a deterministic uncompressed ZIP32 Blob.
+ * This is a loaders.gl bundle convention, not a native Potree archive standard. Metadata sits
+ * at the root with original relative resource paths. Writer version/attribute/precision gates
+ * apply. Inputs, dataset bytes, ZIP temporaries and the returned Blob are separate memory.
+ * @param input - Decoded points or caller-organized additive nodes; no LOD sampling is inferred.
+ * @param options - Dataset writer controls and final archive budget.
+ * @returns A downloadable ZIP Blob that openPointCloudFile can read incrementally.
+ */
+export declare function encodePotreeArchive(input: Mesh | MeshArrowTable | readonly PotreeWriterNode[], options: EncodePotreeArchiveOptions): Promise<Blob>;
+/** Packages already encoded Potree files without encoding or sampling points a second time. */
+export declare function encodePotreeDatasetArchive(dataset: PotreeDataset, maxArchiveBytes: number, signal?: AbortSignal): Promise<Blob>;
+/**
+ * Opens a COPC Blob or a Potree STORE ZIP without extracting the complete dataset.
+ * ZIP directory/local headers are checked before constructing the Potree source; modern node
+ * requests slice only their archived byte ranges. DEFLATE, encrypted entries, ambiguous
+ * metadata and noncanonical paths fail explicitly. Partial reads do not verify whole-entry CRCs.
+ * Legacy Potree retains its existing coordinate behavior; modern Potree retains native coordinates.
+ * COPC uses its existing source coordinate policy. Applications own CRS preparation and conversion.
+ * @param input - Immutable local file/Blob, bounded by maxFileBytes.
+ * @param options - Explicit format, source controls and archive transport limits.
+ * @returns An initialized lazy source; close it when conversion finishes.
+ */
+export declare function openPointCloudFile(input: Blob, options: OpenPointCloudFileOptions): Promise<OpenedPointCloudFile>;
+/** Explicit opt-in mesh-to-point selection. */
+export interface ExtractMeshVerticesOptions {
+    /** Attribute names to retain in addition to POSITION; all other semantics are omitted explicitly. */
+    readonly attributes: readonly string[];
+    /** Maximum stored vertices, not expanded triangle corners. */
+    readonly maxPoints: number;
+}
+/**
+ * Harvests one point per stored vertex from already placed triangle geometry.
+ * Does not expand indices, deduplicate coincident vertices or sample triangle interiors. Output
+ * shares immutable attribute arrays. Materials, features, topology and unselected attributes are
+ * discarded by this explicit opt-in; select compatible attributes before destination encoding.
+ * For tiles, use the mesh source adapters first so node/RTC/tile transforms are applied once.
+ * @param mesh - Decoded triangle geometry in the desired absolute coordinate frame.
+ * @param options - Explicit retained attributes and stored-vertex count budget.
+ * @returns An unindexed point Mesh ready for point-cloud writers or the dynamic tiler.
+ */
+export declare function extractMeshVertices(mesh: MeshGeometry, options: ExtractMeshVerticesOptions): Mesh;

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

@@ -0,0 +1,47 @@
+import type { Mesh, MeshArrowTable } from '@loaders.gl/core/schema';
+import { type PointCloudTilerOptions } from '@loaders.gl/core/schema-utils';
+import type { PotreeDataset, PotreeWriterOptions } from '@loaders.gl/tiles-3d/potree';
+/** Bounded authoring of one decoded dataset in its already placed native coordinates. */
+export interface ConvertPointCloudToPotreeOptions {
+    /** Explicit CRS declaration written verbatim; coordinates are not reprojected. */
+    readonly projection: string;
+    /** Maximum bytes retained across all gathered node attribute buffers. */
+    readonly maxGatheredBytes: number;
+    /** Maximum complete encoded dataset bytes, including metadata and hierarchy. */
+    readonly maxOutputBytes: number;
+    /** Input, index, per-node and node-count limits of the shared dynamic tiler. */
+    readonly tiling?: Omit<PointCloudTilerOptions, 'signal'>;
+    /** Existing version, precision, spacing and hierarchy controls. */
+    readonly potree?: Omit<NonNullable<PotreeWriterOptions['potree']>, 'projection' | 'signal' | 'maxOutputBytes'>;
+    /** Also package the completed files as a loaders.gl STORE ZIP32 bundle. */
+    readonly archive?: {
+        readonly maxArchiveBytes: number;
+    };
+    /** Cooperative cancellation during indexing, gathering, writing and packaging. */
+    readonly signal?: AbortSignal;
+}
+/** Complete Potree files; no partial dataset is returned after a failure. */
+export interface ConvertedPointCloudPotree {
+    /** Exact input row count, emitted once across the additive octree. */
+    readonly pointCount: number;
+    /** Number of connected octree nodes, including an empty root for empty input. */
+    readonly nodeCount: number;
+    /** Metadata and encoded resources; applications own storage. */
+    readonly dataset: PotreeDataset;
+    /** Optional downloadable bundle; applications own object URL and saving lifetimes. */
+    readonly archive?: Blob;
+}
+/**
+ * Connects the portable point tiler to the existing Potree 1.x/2.0 dataset writer.
+ * Retains additive octree addresses and every source row exactly once, including terminal
+ * overflow. Input must be immutable, unindexed decoded points already placed in the declared
+ * CRS. No origins, transforms, reprojection, attribute mappings or surface sampling are inferred.
+ * The writer rejects attributes or precision that the selected version cannot represent.
+ * Gathered nodes are bounded separately from source buffers, indexes, encoded output and ZIP
+ * temporaries. This is in-memory authoring, not streaming ingestion or a peak-heap guarantee.
+ * The shared tiler's sample coverage bound is not a qualified viewer LOD/error contract.
+ * @param input - One decoded point Mesh or MeshArrowTable, including loader output.
+ * @param options - Explicit native CRS, resource budgets and existing writer controls.
+ * @returns A complete dataset and optional bundle after releasing the owned tiler.
+ */
+export declare function convertPointCloudToPotree(input: Mesh | MeshArrowTable, options: ConvertPointCloudToPotreeOptions): Promise<ConvertedPointCloudPotree>;

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

@@ -1,4 +1,4 @@
-import type { PointCloudBoundingVolume, PointCloudCoordinateSystem, PointCloudTilesetSource, TilesetSpatialReference } from '@loaders.gl/tiles';
+import type { PointCloudBoundingVolume, PointCloudCoordinateSystem, PointCloudTilesetSource, TilesetSpatialReference } from '@loaders.gl/tiles-3d';
 import type { PointCloudSpatialOptions } from './point-cloud-spatial.js';
 import type { EncodePointCloudTileOptions, EncodedPointCloudTile } from './point-cloud.js';
 import type { PointCloudSourceTile, TraversePointCloudSourceOptions } from '@loaders.gl/tile-converter/v5/core';

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

@@ -1,4 +1,4 @@
-import type { PointCloudTileContent, PointCloudTileHeader, PointCloudTilesetSource } from '@loaders.gl/tiles';
+import type { PointCloudTileContent, PointCloudTileHeader, PointCloudTilesetSource } from '@loaders.gl/tiles-3d';
 /** A source tile and its decoded point content, including null content when no payload exists. */
 export type PointCloudSourceTile = {
     /** Header with the source tile's hierarchy, bounds, and LOD metadata. */

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

@@ -0,0 +1,44 @@
+import type { Mesh, MeshArrowTable } from '@loaders.gl/core/schema';
+import type { PointCloudTilerOptions } from '@loaders.gl/core/schema-utils';
+import type { TilesetSpatialReference } from '@loaders.gl/tiles-3d';
+import type { BrowserTileConversionFile, TileConversionProgress, TileConversionReport } from '@loaders.gl/tile-converter/v5/core';
+import type { PointCloudTilesetSinkOptions } from './point-cloud-tileset-sink.js';
+import type { TileConversionArchiveOptions } from './conversion-archive.js';
+/** Bounded authoring of a complete decoded ECEF point dataset. */
+export interface ConvertPointCloudToTilesetOptions extends PointCloudTilesetSinkOptions {
+    /** Explicit native EPSG:4978 XYZ meters with ellipsoidal heights. No CRS is inferred. */
+    readonly spatialReference: TilesetSpatialReference;
+    /** In-memory input, index, gathered-tile and node limits; defaults belong to PointCloudTiler. */
+    readonly tiling?: Omit<PointCloudTilerOptions, 'signal'>;
+    /** Also create an indexed 3TZ Blob within this final archive-size budget. */
+    readonly archive?: Pick<TileConversionArchiveOptions, 'maxArchiveBytes'>;
+    /** Cooperative cancellation during indexing, traversal, encoding and packaging. */
+    readonly signal?: AbortSignal;
+    /** PNTS conversion progress; excludes tileset JSON and optional archive packaging. */
+    readonly onProgress?: (progress: TileConversionProgress) => void;
+}
+/** Completed point authoring result; no partial files are returned on failure. */
+export interface ConvertedPointCloudTileset {
+    /** Exact number of input points, each emitted once across the complete collection. */
+    readonly pointCount: number;
+    /** PNTS resource counts and bytes; input bytes count gathered Arrow column buffers. */
+    readonly report: TileConversionReport;
+    /** PNTS resources and tileset.json, including JSON in the retained output byte budget. */
+    readonly files: readonly BrowserTileConversionFile[];
+    /** Optional indexed 3TZ Blob. Applications own saving and object URL lifetimes. */
+    readonly archive?: Blob;
+}
+/**
+ * Tiles decoded point Mesh/Arrow data and authors a flat additive 3D Tiles 1.0 collection.
+ * All input rows are emitted once, including remaining rows at the tiler's maximum depth.
+ * Per-tile RTC centers reduce float32 rounding; geometricError gates measured reconstruction error.
+ * The flat collection does not preserve octree LOD or provide a sampling-error guarantee.
+ * Input must remain immutable until completion. Arrow normalization can copy buffers; retained
+ * input, row indexes, gathered tiles, output Blobs and optional ZIP temporaries are separate memory.
+ * This is bounded in-memory authoring, not streaming ingestion or an out-of-core converter.
+ * Unsupported PNTS attributes fail; callers must explicitly map or remove them beforehand.
+ * @param input - One decoded unindexed point-list with finite floating-point XYZ positions.
+ * @param options - Explicit ECEF frame, precision and resource limits, and optional 3TZ packaging.
+ * @returns Completed files and report after releasing the privately owned dynamic source.
+ */
+export declare function convertPointCloudToTileset(input: Mesh | MeshArrowTable, options: ConvertPointCloudToTilesetOptions): Promise<ConvertedPointCloudTileset>;

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

@@ -1,4 +1,4 @@
-import type { Mesh, MeshArrowTable, MeshAttribute } from '@loaders.gl/schema';
+import type { Mesh, MeshArrowTable, MeshAttribute } from '@loaders.gl/core/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. */

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

@@ -32,6 +32,14 @@ export interface ManifestBackedTileConversionSinkOptions<TResource> {
     readonly sink: TileConversionSink<TResource>;
     /** Persistence adapter for snapshots written after each resource. */
     readonly manifestStore: TileResourceManifestStore;
+    /** Optional cap on unique checkpoint entries loaded or written; defaults to no cap. */
+    readonly maxResources?: number;
+    /**
+     * Checks destination bytes before skipping a matching checkpoint. Return true only when
+     * stored bytes match the entry's size and fingerprint; false rewrites the resource.
+     * Without this callback the caller guarantees checkpointed destination bytes remain intact.
+     */
+    readonly verifyResource?: (entry: TileResourceManifestEntry, signal?: AbortSignal) => Promise<boolean>;
     /** Stable profile-specific path or resource key. */
     readonly getResourceId: (resource: TResource) => string;
     /** Byte length used to detect changed content under an existing resource ID. */
@@ -50,7 +58,8 @@ export interface ManifestBackedTileConversionSinkOptions<TResource> {
  * 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.
+ * last saved checkpoint. Optional destination verification repairs missing or changed stored
+ * resources before treating them as complete. maxResources caps unique checkpoint entries.
  *
  * @param options - Destination, manifest store, stable IDs, byte measurement, and fingerprinting.
  * @returns A `TileConversionSink` with resumable per-resource progress.

package/dist/v5/selected-mesh-source.d.ts

@@ -0,0 +1,53 @@
+import type { DracoLibraryOptions } from '@loaders.gl/draco/bundled';
+import { createTiles3DConversionSpatialContext } from '@loaders.gl/tile-converter/v5/core';
+import type { BrowserTilesetConversionInspection, BrowserTilesetConversionInputResource, TileConversionSource } from '@loaders.gl/tile-converter/v5/core';
+import type { MeshSourceResource, MeshSourceFeatureOptions } from '@loaders.gl/tile-converter/v5/adapters';
+/** Required transport, decoded geometry, retained output, and archive budgets for this demo. */
+export declare const SELECTED_MESH_LIMITS: {
+    /** Root JSON plus selected content transport bytes; also the decoded geometry/image/feature byte gate. */
+    readonly maxInputBytes: number;
+    /** Maximum declared content placements inspected. */
+    readonly maxInputResources: 1000;
+    /** Maximum inspected root/external document placements. */
+    readonly maxTilesetDocuments: 32;
+    /** Maximum explicitly selected content placements in one partial archive. */
+    readonly maxSelectedResources: 64;
+    /** Maximum primitive placements authored across all selected contents. */
+    readonly maxMeshResources: 64;
+    /** Maximum retained file bytes and final archive bytes. */
+    readonly maxOutputBytes: number;
+    /** Maximum measured reconstruction error in meters. */
+    readonly maxPositionError: 0.01;
+};
+/** Injected transport and decoder assets for the bounded selected mesh profile. */
+export interface SelectedMeshSourceOptions {
+    /** Require a complete qualified explicit tree; pair with createMeshHierarchyTilesetSink. */
+    readonly preserveHierarchy?: boolean;
+    /** Inspected content placement identifiers; one to 64 distinct selections. */
+    readonly resourceIds: readonly string[];
+    /** Cancellation across qualification, raw reads and decoding. */
+    readonly signal: AbortSignal;
+    /** Application-owned decoder asset locations or modules. */
+    readonly dracoLibraryOptions: DracoLibraryOptions;
+    /** Transport for decoded buffers/images, confined by a platform adapter when local. */
+    readonly fetcher?: typeof fetch;
+    /** Optional source owning the raw input lifetime, such as a Node file/archive adapter. */
+    readonly source?: TileConversionSource<BrowserTilesetConversionInspection, BrowserTilesetConversionInputResource>;
+    /** Explicit feature mapping, or the qualified inline structural metadata profile. */
+    readonly features?: MeshSourceFeatureOptions;
+    /** Lower the shared 16 MiB transport and decoded mesh limit. */
+    readonly maxInputBytes?: number;
+}
+/** Qualified selected-mesh decoding and source error policy. */
+export interface SelectedMeshConversionSource {
+    /** Lazy source that releases each dedicated mesh runtime after use. */
+    readonly source: TileConversionSource<BrowserTilesetConversionInspection, MeshSourceResource>;
+    /** Native ECEF coordinate context, qualified before reading mesh content. */
+    readonly spatialContext: ReturnType<typeof createTiles3DConversionSpatialContext>;
+    /** Conservative metric source error plus the position reconstruction allowance. */
+    readonly geometricError: number;
+}
+/** Qualifies and constructs a lazy selected mesh source without platform I/O or output ownership. */
+export declare function createSelectedMeshConversionSource(inspection: BrowserTilesetConversionInspection, options: SelectedMeshSourceOptions): Promise<SelectedMeshConversionSource>;
+/** Charges geometry, encoded image bytes, triangle associations and Arrow columns after extraction. */
+export declare function measureMeshBytes(resource: MeshSourceResource): number;

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

@@ -1,4 +1,4 @@
-import type { CreateTilesetSpatialReferenceOptions, I3SSpatialBounds, I3STransformedPositions, I3STransformedGeometry, Tiles3DSpatialBoundingVolume, TilesetSpatialOptions, TilesetSpatialReference } from '@loaders.gl/tiles';
+import type { CreateTilesetSpatialReferenceOptions, I3SSpatialBounds, I3STransformedPositions, I3STransformedGeometry, Tiles3DSpatialBoundingVolume, TilesetSpatialOptions, TilesetSpatialReference } from '@loaders.gl/tiles-3d';
 /** 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. */

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

@@ -1,4 +1,4 @@
-import type { Tileset3D, TilesetContentTraversalItem, TilesetSourceMetadata, TraverseTilesetContentsOptions } from '@loaders.gl/tiles';
+import type { Tileset3D, TilesetContentTraversalItem, TilesetSourceMetadata, TraverseTilesetContentsOptions } from '@loaders.gl/tiles-3d';
 import type { TileConversionSource } from './conversion-api.js';
 /** Decoded-content lifetime options for source-backed conversion. */
 export type TilesetConversionSourceOptions = Pick<TraverseTilesetContentsOptions, 'unloadContent'>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/tile-converter",
-  "version": "5.0.0-alpha.11",
+  "version": "5.0.0-alpha.14",
   "description": "Converter",
   "license": "MIT",
   "type": "module",
@@ -44,12 +44,18 @@
       "types": "./dist/v5/adapters.d.ts",
       "import": "./dist/v5/adapters.js",
       "require": "./dist/v5/adapters.cjs"
+    },
+    "./v5/node": {
+      "types": "./dist/v5/node.d.ts",
+      "import": "./dist/v5/node.js",
+      "require": "./dist/v5/node.cjs"
     }
   },
   "sideEffects": false,
   "bin": {
     "i3s-server": "./bin/i3s-server.js",
-    "tile-converter": "./bin/converter.js"
+    "tile-converter": "./bin/converter.js",
+    "tile-converter-v5": "./bin/converter-v5.js"
   },
   "files": [
     "src",
@@ -58,7 +64,6 @@
     "README.md"
   ],
   "browser": {
-    "archiver": false,
     "fs": false,
     "join-images": false,
     "path": false,
@@ -71,41 +76,29 @@
     "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"
+    "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 && esbuild src/v5/node.ts src/v5/converter-cli.ts --bundle --packages=external --external:@loaders.gl/* --platform=node --outdir=dist/v5 --format=esm && esbuild src/v5/node.ts --bundle --packages=external --external:@loaders.gl/* --platform=node --outdir=dist/v5 --format=cjs --out-extension:.js=.cjs"
   },
   "dependencies": {
-    "@loaders.gl/3d-tiles": "5.0.0-alpha.11",
-    "@loaders.gl/compression": "5.0.0-alpha.11",
-    "@loaders.gl/crypto": "5.0.0-alpha.11",
-    "@loaders.gl/draco": "5.0.0-alpha.11",
-    "@loaders.gl/gltf": "5.0.0-alpha.11",
-    "@loaders.gl/i3s": "5.0.0-alpha.11",
-    "@loaders.gl/images": "5.0.0-alpha.11",
-    "@loaders.gl/loader-utils": "5.0.0-alpha.11",
-    "@loaders.gl/polyfills": "5.0.0-alpha.11",
-    "@loaders.gl/schema": "5.0.0-alpha.11",
-    "@loaders.gl/schema-utils": "5.0.0-alpha.11",
-    "@loaders.gl/textures": "5.0.0-alpha.11",
-    "@loaders.gl/tiles": "5.0.0-alpha.11",
-    "@loaders.gl/worker-utils": "5.0.0-alpha.11",
-    "@loaders.gl/zip": "5.0.0-alpha.11",
-    "@math.gl/core": "5.0.0-alpha.15",
-    "@math.gl/crs": "5.0.0-alpha.15",
-    "@math.gl/culling": "5.0.0-alpha.15",
-    "@math.gl/geoid": "5.0.0-alpha.15",
-    "@math.gl/geometry-utils": "5.0.0-alpha.15",
-    "@math.gl/geospatial": "5.0.0-alpha.15",
+    "@loaders.gl/archives": "5.0.0-alpha.14",
+    "@loaders.gl/compression": "5.0.0-alpha.14",
+    "@loaders.gl/core": "5.0.0-alpha.14",
+    "@loaders.gl/crypto": "5.0.0-alpha.14",
+    "@loaders.gl/draco": "5.0.0-alpha.14",
+    "@loaders.gl/gltf": "5.0.0-alpha.14",
+    "@loaders.gl/images": "5.0.0-alpha.14",
+    "@loaders.gl/textures": "5.0.0-alpha.14",
+    "@loaders.gl/tiles": "5.0.0-alpha.14",
+    "@loaders.gl/tiles-3d": "5.0.0-alpha.14",
+    "@math.gl/core": "5.0.0-alpha.20",
+    "@math.gl/earth": "5.0.0-alpha.20",
+    "@math.gl/geometry": "5.0.0-alpha.20",
+    "@math.gl/geospatial": "5.0.0-alpha.20",
     "ajv": "^8.12.0",
-    "archiver": "^5.0.0",
     "cors": "^2.8.5",
-    "crypt": "^0.0.2",
     "debug": "~4.3.4",
     "express": "~4.19.2",
     "inquirer": "^8.0.0",
-    "json-map-transform": "^1.2.6",
-    "md5": "^2.3.0",
-    "morgan": "~1.9.1",
-    "uuid": "^9.0.0"
+    "morgan": "~1.12.1"
   },
   "quarantinedDependencies": {
     "join-images": "^1.1.3",
@@ -119,5 +112,5 @@
   "peerDependencies": {
     "@loaders.gl/core": "~5.0.0-alpha.0"
   },
-  "gitHead": "e9694544adb0bc7dac68a35adbc8bdae35f64dae"
+  "gitHead": "226b7bca7ecb3684b7386487ee76565ca240d7d9"
 }

package/src/index.ts

@@ -1 +1,4 @@
-export * from './v4/index.js';
+export {
+  I3SConverter,
+  Tiles3DConverter
+} from './v4/index.js';

package/src/v4/3d-tiles-converter/3d-tiles-converter.ts

@@ -4,15 +4,14 @@ import type {
   NodeReference,
   I3STilesetHeader,
   I3STileAttributes
-} from '@loaders.gl/i3s';
-import type {Tile3DBoundingVolume, Tiles3DTileJSON} from '@loaders.gl/3d-tiles';
+} from '@loaders.gl/tiles-3d/i3s';
+import type {Tile3DBoundingVolume, Tiles3DTileJSON} from '@loaders.gl/tiles-3d/3d-tiles';
 
 import {join} from 'path';
 import process from 'process';
-import transform from 'json-map-transform';
 import {load, isBrowser} from '@loaders.gl/core';
-import {I3SLoader, I3SAttributeLoader, COORDINATE_SYSTEM} from '@loaders.gl/i3s';
-import {Geoid} from '@math.gl/geoid';
+import {I3SLoader, I3SAttributeLoader, COORDINATE_SYSTEM} from '@loaders.gl/tiles-3d/i3s';
+import {Geoid} from '@math.gl/earth/geoid';
 
 import {validateI3SConversionSpatialReference} from './helpers/validate-i3s-spatial-reference';
 import {PGMLoader} from '../pgm-loader';
@@ -20,18 +19,18 @@ import {i3sObbTo3dTilesObb} from './helpers/i3s-obb-to-3d-tiles-obb';
 import {convertScreenThresholdToGeometricError} from '../lib/utils/lod-conversion-utils';
 import {writeFile, removeDir} from '../lib/utils/file-utils';
 import {calculateDatasetSize, timeConverter} from '../lib/utils/statistic-utils';
-import {TILESET as tilesetTemplate} from './json-templates/tileset';
+import {createTileset} from './json-templates/tileset';
 import {createObbFromMbs} from '../i3s-converter/helpers/coordinate-converter';
-import {WorkerFarm} from '@loaders.gl/worker-utils';
+import {WorkerFarm} from '@loaders.gl/core/worker-utils';
 import {BROWSER_ERROR_MESSAGE} from '../constants';
 import {
   Tiles3DContentConverter,
   type I3SAttributesData
 } from './helpers/3d-tiles-content-converter';
-import {I3STileHeader} from '@loaders.gl/i3s/src/types';
+import type {I3STileHeader} from '@loaders.gl/tiles-3d/i3s';
 import {getNodeCount, loadFromArchive, loadI3SContent, openSLPK} from './helpers/load-i3s';
-import {I3SLoaderOptions} from '@loaders.gl/i3s/src/i3s-loader';
-import {ZipFileSystem} from '../../../zip/src';
+import type {I3SLoaderOptions} from '@loaders.gl/tiles-3d/i3s';
+import type {ZipFileSystem} from '@loaders.gl/archives/zip';
 import {ConversionDump, ConversionDumpOptions} from '../lib/utils/conversion-dump';
 import {Progress} from '../i3s-converter/helpers/progress';
 import {PromptModule} from 'inquirer';
@@ -61,7 +60,7 @@ export default class Tiles3DConverter {
     i3s: {coordinateSystem: COORDINATE_SYSTEM.LNGLAT_OFFSETS, decodeTextures: false},
     // We need to load local fs workers because nodejs can't load workers from the Internet
     'i3s-content': {
-      workerUrl: './modules/i3s/dist/i3s-content-worker-node.js'
+      workerUrl: './modules/tiles-3d/dist/i3s-content-worker-node.js'
     }
   };
   conversionDump: ConversionDump;
@@ -204,7 +203,7 @@ export default class Tiles3DConverter {
 
     await this._addChildren(rootNode, rootTile, 1);
 
-    const tileset = transform({asset: {version: outputVersion}, root: rootTile}, tilesetTemplate());
+    const tileset = createTileset({asset: {version: outputVersion}, root: rootTile});
     await writeFile(this.tilesetPath, JSON.stringify(tileset), 'tileset.json');
     await this.conversionDump.deleteDumpFile();
 

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

@@ -1,4 +1,8 @@
-import type {I3STileContent, AttributeStorageInfo, I3STileAttributes} from '@loaders.gl/i3s';
+import type {
+  I3STileContent,
+  AttributeStorageInfo,
+  I3STileAttributes
+} from '@loaders.gl/tiles-3d/i3s';
 import {encodeSync} from '@loaders.gl/core';
 import {
   GLTFScenegraph,
@@ -7,9 +11,9 @@ import {
   createExtMeshFeatures,
   type PropertyAttribute
 } from '@loaders.gl/gltf';
-import {Tile3DWriter, TILE3D_TYPE} from '@loaders.gl/3d-tiles';
+import {Tile3DWriter, TILE3D_TYPE} from '@loaders.gl/tiles-3d/3d-tiles';
 import {Matrix4, Vector3} from '@math.gl/core';
-import {isTypedArray} from '@math.gl/types';
+import {isTypedArray} from '@math.gl/core/types';
 import {Ellipsoid} from '@math.gl/geospatial';
 import {convertTextureAtlas} from './texture-atlas';
 import {generateSyntheticIndices} from '../../lib/utils/geometry-utils';

package/src/v4/3d-tiles-converter/helpers/i3s-obb-to-3d-tiles-obb.ts

@@ -1,6 +1,6 @@
 import {Vector3} from '@math.gl/core';
 import {Ellipsoid} from '@math.gl/geospatial';
-import {OrientedBoundingBox} from '@math.gl/culling';
+import {makeOrientedBoundingBoxFromQuaternion} from '@math.gl/geometry/culling';
 // @ts-expect-error
 import {GeoidHeightModel} from '@loaders.gl/tile-converter/lib/geoid-height-model';
 
@@ -24,7 +24,7 @@ export function i3sObbTo3dTilesObb(
     i3SObb.center[2] + geoidHeightModel.getHeight(i3SObb.center[1], i3SObb.center[0])
   ];
   const cartesianCenter = Ellipsoid.WGS84.cartographicToCartesian(tiles3DCenter, new Vector3());
-  const tiles3DObb = new OrientedBoundingBox().fromCenterHalfSizeQuaternion(
+  const tiles3DObb = makeOrientedBoundingBoxFromQuaternion(
     cartesianCenter,
     i3SObb.halfSize,
     i3SObb.quaternion

package/src/v4/3d-tiles-converter/helpers/load-i3s.ts

@@ -6,9 +6,9 @@ import {
   I3SLoader,
   I3SLoaderOptions,
   parseSLPKArchive
-} from '@loaders.gl/i3s';
-import {NodeFile} from '@loaders.gl/loader-utils';
-import {ZipFileSystem, makeZipCDHeaderIterator} from '@loaders.gl/zip';
+} from '@loaders.gl/tiles-3d/i3s';
+import {NodeFile} from '@loaders.gl/core/loader-utils';
+import {ZipFileSystem} from '@loaders.gl/archives/zip';
 
 export type SLPKUrlParts = {slpkFileName: string; internalFileName: string};
 
@@ -116,9 +116,7 @@ export async function getNodeCount(fileSystem: ZipFileSystem | null): Promise<nu
     return 0;
   }
   const nodeSet = new Set();
-  const filesIterator = makeZipCDHeaderIterator(fileSystem.file);
-  for await (const file of filesIterator) {
-    const filename = file.fileName;
+  for (const filename of await fileSystem.readdir()) {
     const nodeNumberSearchResult = /^nodes\/(\d+)\//.exec(filename);
     if (nodeNumberSearchResult) {
       nodeSet.add(nodeNumberSearchResult[1]);

package/src/v4/3d-tiles-converter/helpers/texture-atlas.ts

@@ -1,4 +1,4 @@
-import type {TypedArray} from '@loaders.gl/loader-utils';
+import type {TypedArray} from '@loaders.gl/core/loader-utils';
 
 /**
  * Apply uvRegions to texture coordinates.

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

@@ -2,8 +2,8 @@
 // SPDX-License-Identifier: MIT
 // Copyright vis.gl contributors
 
-import {parseWKTCRS, type WKTCRSNode} from '@math.gl/crs';
-import {getSpatialCoordinateFrame} from '@loaders.gl/tiles';
+import {parseWKTCRS, type WKTCRSNode} from '@math.gl/geospatial/crs';
+import {getSpatialCoordinateFrame} from '@loaders.gl/tiles-3d';
 
 /** Horizontal CRS declarations consumed by the legacy I3S converter. */
 export type I3SConversionSpatialReference = {