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

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

@@ -0,0 +1,83 @@
+import type { COPCTileSource, COPCSourceLoaderOptions } from '@loaders.gl/copc';
+import { PotreeSourceLoader } from '@loaders.gl/potree';
+import type { PotreeDataset, PotreeWriterNode, PotreeWriterOptions, PotreeSourceLoaderOptions } from '@loaders.gl/potree';
+import type { Mesh, MeshArrowTable, MeshGeometry } from '@loaders.gl/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/schema';
+import { type PointCloudTilerOptions } from '@loaders.gl/schema-utils';
+import type { PotreeDataset, PotreeWriterOptions } from '@loaders.gl/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-tileset.d.ts

@@ -0,0 +1,44 @@
+import type { Mesh, MeshArrowTable } from '@loaders.gl/schema';
+import type { PointCloudTilerOptions } from '@loaders.gl/schema-utils';
+import type { TilesetSpatialReference } from '@loaders.gl/tiles';
+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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/tile-converter",
-  "version": "5.0.0-alpha.11",
+  "version": "5.0.0-alpha.12",
   "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",
@@ -71,30 +77,32 @@
     "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/3d-tiles": "5.0.0-alpha.12",
+    "@loaders.gl/compression": "5.0.0-alpha.12",
+    "@loaders.gl/copc": "5.0.0-alpha.12",
+    "@loaders.gl/crypto": "5.0.0-alpha.12",
+    "@loaders.gl/draco": "5.0.0-alpha.12",
+    "@loaders.gl/gltf": "5.0.0-alpha.12",
+    "@loaders.gl/i3s": "5.0.0-alpha.12",
+    "@loaders.gl/images": "5.0.0-alpha.12",
+    "@loaders.gl/loader-utils": "5.0.0-alpha.12",
+    "@loaders.gl/polyfills": "5.0.0-alpha.12",
+    "@loaders.gl/potree": "5.0.0-alpha.12",
+    "@loaders.gl/schema": "5.0.0-alpha.12",
+    "@loaders.gl/schema-utils": "5.0.0-alpha.12",
+    "@loaders.gl/textures": "5.0.0-alpha.12",
+    "@loaders.gl/tiles": "5.0.0-alpha.12",
+    "@loaders.gl/worker-utils": "5.0.0-alpha.12",
+    "@loaders.gl/zip": "5.0.0-alpha.12",
+    "@math.gl/core": "5.0.0-alpha.16",
+    "@math.gl/crs": "5.0.0-alpha.16",
+    "@math.gl/culling": "5.0.0-alpha.16",
+    "@math.gl/geoid": "5.0.0-alpha.16",
+    "@math.gl/geometry-utils": "5.0.0-alpha.16",
+    "@math.gl/geospatial": "5.0.0-alpha.16",
     "ajv": "^8.12.0",
     "archiver": "^5.0.0",
     "cors": "^2.8.5",
@@ -119,5 +127,5 @@
   "peerDependencies": {
     "@loaders.gl/core": "~5.0.0-alpha.0"
   },
-  "gitHead": "e9694544adb0bc7dac68a35adbc8bdae35f64dae"
+  "gitHead": "8cbff6cb3e55c4eb1305072743992af27ff0c171"
 }

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/helpers/load-i3s.ts

@@ -8,7 +8,7 @@ import {
   parseSLPKArchive
 } from '@loaders.gl/i3s';
 import {NodeFile} from '@loaders.gl/loader-utils';
-import {ZipFileSystem, makeZipCDHeaderIterator} from '@loaders.gl/zip';
+import {ZipFileSystem} from '@loaders.gl/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/converter-cli.ts

@@ -11,7 +11,7 @@ import {
   getURLValue,
   validateOptionsWithEqual
 } from './lib/utils/cli-utils';
-import {addOneFile, composeHashFile, makeZipCDHeaderIterator} from '@loaders.gl/zip';
+import {addOneFile, composeHashFile, openZipArchive} from '@loaders.gl/zip';
 import {NodeFile} from '@loaders.gl/loader-utils';
 // @ts-ignore
 import {copyFile} from 'node:fs/promises';
@@ -141,7 +141,13 @@ async function main() {
     if (finalPath !== validatedOptions.tileset) {
       await copyFile(validatedOptions.tileset, finalPath);
     }
-    const hashTable = await composeHashFile(makeZipCDHeaderIterator(new NodeFile(finalPath)));
+    const archive = await openZipArchive(new NodeFile(finalPath));
+    let hashTable: ArrayBuffer;
+    try {
+      hashTable = await composeHashFile(archive.entries());
+    } finally {
+      await archive.close();
+    }
     await addOneFile(finalPath, hashTable, '@specialIndexFileHASH128@');
 
     return;

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

@@ -4,19 +4,11 @@ import type {
   Tiles3DTileJSONPostprocessed,
   Tiles3DTilesetJSONPostprocessed
 } from '@loaders.gl/3d-tiles';
-import {Tiles3DArchive} from '@loaders.gl/3d-tiles';
+import {parse3DTilesArchive} from '@loaders.gl/3d-tiles';
 import {LoaderWithParser, load} from '@loaders.gl/core';
 import type {ReadableFile} from '@loaders.gl/loader-utils';
 import {HttpFile, NodeFile, isBrowser} from '@loaders.gl/loader-utils';
-import {
-  CD_HEADER_SIGNATURE,
-  ZipFileSystem,
-  parseHashTable,
-  parseZipCDFileHeader,
-  parseZipLocalFileHeader,
-  searchFromTheEnd,
-  readRange
-} from '@loaders.gl/zip';
+import {ZipFileSystem} from '@loaders.gl/zip';
 
 /**
  * Load nested 3DTiles tileset. If the sourceTile is not nested tileset - do nothing
@@ -116,8 +108,7 @@ export async function loadFromArchive(
   if (filename) {
     const tz3Path = `${tz3UrlParts[0]}.3tz`;
     const fileProvider = createReadableFile(tz3Path);
-    const hashTable = await loadHashTable(fileProvider);
-    const archive = new Tiles3DArchive(fileProvider, hashTable, tz3Path);
+    const archive = await parse3DTilesArchive(fileProvider, undefined, tz3Path);
     const fileSystem = new ZipFileSystem(archive);
     const archiveLoadOptions = {
       ...loadOptions,
@@ -145,42 +136,3 @@ function createReadableFile(path: string): ReadableFile {
   }
   return isBrowser ? new HttpFile(path) : new NodeFile(path);
 }
-
-/**
- * Load hash file from 3TZ
- * @param fileProvider - binary reader of 3TZ
- * @returns hash table of the 3TZ file content or undefined if the hash file is not presented inside
- */
-async function loadHashTable(
-  fileProvider: ReadableFile
-): Promise<undefined | Record<string, bigint>> {
-  let hashTable: undefined | Record<string, bigint>;
-
-  const hashCDOffset = await searchFromTheEnd(fileProvider, CD_HEADER_SIGNATURE);
-
-  const cdFileHeader = await parseZipCDFileHeader(hashCDOffset, fileProvider);
-
-  // '@3dtilesIndex1@' is index file that must be the last in the archive. It allows
-  // to improve load and read performance when the archive contains a very large number
-  // of files.
-  if (cdFileHeader?.fileName === '@3dtilesIndex1@') {
-    const localFileHeader = await parseZipLocalFileHeader(
-      cdFileHeader.localHeaderOffset,
-      fileProvider
-    );
-    if (!localFileHeader) {
-      throw new Error('corrupted 3tz');
-    }
-
-    const fileDataOffset = localFileHeader.fileDataOffset;
-    const hashFile = await readRange(
-      fileProvider,
-      fileDataOffset,
-      fileDataOffset + localFileHeader.compressedSize
-    );
-
-    hashTable = parseHashTable(hashFile);
-  }
-
-  return hashTable;
-}

package/src/v4/i3s-converter/helpers/node-index-document.ts

@@ -97,7 +97,7 @@ export class NodeIndexDocument {
   }
 
   /**
-   * Add neighbors to child nodes of this node
+   * Add neighbors, save leaf documents and children, then release finalized child data.
    */
   public async addNeighbors(): Promise<void> {
     if (this.finalized) {
@@ -130,7 +130,10 @@ export class NodeIndexDocument {
       }
       await childNode.save();
     }
-    // The save after adding neighbors is the last one. Finalize the the node
+    // Internal documents were saved during child traversal. A root mesh leaf has no such traversal.
+    if (!this.children.length) {
+      await this.save();
+    }
     this.finalize();
   }
 

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

@@ -43,7 +43,7 @@ export const analyzeTileContent = async (
   }
 
   const gltfData = await parse(tileContent.gltfArrayBuffer, GLTFLoader, {
-    gltf: {normalize: false, loadBuffers: false, loadImages: false, decompressMeshes: false}
+    gltf: {normalize: true, loadBuffers: false, loadImages: false, decompressMeshes: false}
   });
   const gltf = gltfData.json;
 

package/src/v4/i3s-converter/json-templates/store.ts

@@ -32,7 +32,8 @@ export const STORE = {
   },
   normalReferenceFrame: {
     path: 'normalReferenceFrame',
-    default: 'east-north-up'
+    // Geometry conversion rotates normals into the ECEF frame.
+    default: 'earth-centered'
   },
   attributeEncoding: {
     path: 'attributeEncoding',

package/src/v5/adapters.ts

@@ -73,3 +73,51 @@ export type {PointCloudSpatialOptions} from './point-cloud-spatial.js';
 
 export {createI3SMeshTilesetConversionSource} from './i3s-mesh-source.js';
 export type {I3SMeshTilesetSourceOptions, I3SMeshSourceFeatureOptions} from './i3s-mesh-source.js';
+
+export {convertPointCloudToTileset} from './point-cloud-tileset.js';
+export type {
+  ConvertPointCloudToTilesetOptions,
+  ConvertedPointCloudTileset
+} from './point-cloud-tileset.js';
+
+export {encodePotreeArchive, openPointCloudFile, extractMeshVertices} from './point-cloud-file.js';
+export type {
+  EncodePotreeArchiveOptions,
+  OpenPointCloudFileOptions,
+  OpenedPointCloudFile,
+  ExtractMeshVerticesOptions
+} from './point-cloud-file.js';
+
+export {createMeshSourceFeatureOptions} from './mesh-source-schema.js';
+export type {MeshSourceSchemaOptions} from './mesh-source-schema.js';
+export {convertPointCloudToPotree} from './point-cloud-potree.js';
+export type {
+  ConvertPointCloudToPotreeOptions,
+  ConvertedPointCloudPotree
+} from './point-cloud-potree.js';
+
+export {
+  createSelectedMeshConversionSource,
+  measureMeshBytes,
+  SELECTED_MESH_LIMITS
+} from './selected-mesh-source.js';
+export type {
+  SelectedMeshSourceOptions,
+  SelectedMeshConversionSource
+} from './selected-mesh-source.js';
+
+export {openTileConversionArchive, createTileConversionArchiveTransport} from './archive-source.js';
+export type {TileConversionArchiveInput} from './archive-source.js';
+
+export {
+  inspectI3SMeshConversionSource,
+  createSelectedI3SMeshConversionSource
+} from './i3s-selection-source.js';
+export type {
+  I3SMeshSelectionOptions,
+  I3SMeshConversionInspection,
+  I3SMeshConversionResourceDescriptor
+} from './i3s-selection-source.js';
+
+export {createMeshHierarchyTilesetSink} from './mesh-hierarchy.js';
+export type {MeshHierarchyTilesetSinkOptions} from './mesh-hierarchy.js';