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

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

@@ -0,0 +1,36 @@
+import type { HttpFileIdentity, ReadableFile } from '@loaders.gl/core/loader-utils';
+/** Cloneable archive input; a remote identity is retained across inspection and conversion. */
+export interface TileConversionArchiveInput {
+    /** Immutable local Blob or HTTP(S) archive URL, including any query credentials. */
+    readonly input: Blob | string;
+    /** Explicit archive format, including for URLs without a filename extension. */
+    readonly format: 'slpk' | '3tz';
+    /** Pinned remote length and validator; local File contents are immutable. */
+    readonly identity?: HttpFileIdentity;
+}
+/** Opens an indexed archive with bounded reads and confines dependency URLs to its virtual root. */
+export declare function openTileConversionArchive(descriptor: TileConversionArchiveInput, maxInputBytes: number, signal: AbortSignal, fetcher?: typeof fetch): Promise<{
+    rootUrl: string;
+    descriptor: {
+        identity?: HttpFileIdentity;
+        input: Blob | string;
+        format: "slpk" | "3tz";
+    } | undefined;
+    /** Resolves only resources belonging to this archive, without external network fallback. */
+    fetcher: (input: URL | RequestInfo, options: RequestInit | undefined) => Promise<Response>;
+    /** Releases the readable file on success, failure or cancellation. */
+    close: () => Promise<void>;
+}>;
+/** Owns an indexed readable file and confines entry/dependency requests to its virtual root. */
+export declare function createTileConversionArchiveTransport(file: ReadableFile, format: 'slpk' | '3tz', maxInputBytes: number, signal: AbortSignal, descriptor?: TileConversionArchiveInput): Promise<{
+    rootUrl: string;
+    descriptor: {
+        identity?: HttpFileIdentity;
+        input: Blob | string;
+        format: "slpk" | "3tz";
+    } | undefined;
+    /** Resolves only resources belonging to this archive, without external network fallback. */
+    fetcher: (input: URL | RequestInfo, options: RequestInit | undefined) => Promise<Response>;
+    /** Releases the readable file on success, failure or cancellation. */
+    close: () => Promise<void>;
+}>;

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

@@ -4,6 +4,8 @@ type TilesetContent = {
     url?: string;
 };
 type TilesetTile = {
+    /** Source metric error, scaled conservatively during selected mesh extraction. */
+    geometricError?: number;
     content?: TilesetContent;
     contents?: TilesetContent[];
     children?: TilesetTile[];
@@ -17,27 +19,46 @@ type TilesetDocument = {
     };
     root?: TilesetTile;
 };
-/** Input options for bounded traversal of one explicit 3D Tiles tileset. */
+/** Input options for bounded traversal of explicit 3D Tiles documents. */
 export interface BrowserTilesetConversionSourceOptions {
     /** URL of the root tileset JSON document. */
     readonly input: string;
-    /** Maximum bytes retained across the tileset JSON and all content resources. */
+    /** Maximum aggregate response bytes across root/nested JSON and content resources. */
     readonly maxInputBytes: number;
-    /** Maximum number of content resources to visit. */
+    /** Maximum content declarations across all documents, including external JSON references. */
     readonly maxInputResources: number;
+    /** Maximum documents read, including the root and repeated placements; defaults to 1 (no nesting). */
+    readonly maxTilesetDocuments?: number;
+    /** Inspect declared .json external tilesets without fetching mesh content; defaults to false. */
+    readonly inspectNestedTilesets?: boolean;
     /** Fetch implementation, defaulting to the browser global. */
     readonly fetcher?: typeof fetch;
 }
 /** Inspection result for an explicit 3D Tiles source. */
 export interface BrowserTilesetConversionInspection {
-    /** Absolute URL of the root tileset document. */
+    /** Final response URL of the root document, falling back to the requested URL for virtual transports. */
     readonly rootUrl: string;
     /** Parsed root document used for deterministic content traversal. */
     readonly tileset: TilesetDocument;
-    /** Ordered content descriptors. */
+    /** Ordered root declarations, or binary candidates from an expanded metadata inspection. */
     readonly resources: readonly BrowserTilesetResourceDescriptor[];
-    /** Root document bytes charged against the input limit. */
+    /** Inspected root/nested metadata bytes charged against the aggregate input limit. */
     readonly tilesetBytes: number;
+    /** Inspected document placements, including repeated references; absent for root-only inspection. */
+    readonly documents?: readonly BrowserTilesetDocumentPlacement[];
+}
+/** One inspected document at a distinct external placement. */
+export interface BrowserTilesetDocumentPlacement {
+    /** Full external content placement introducing this document; absent for the entry root. */
+    readonly parentResourceId?: string;
+    /** Effective document URL, including inherited query credentials. */
+    readonly url: string;
+    /** Original parsed document; its metadata and glTF conventions stay scoped to this document. */
+    readonly tileset: TilesetDocument;
+    /** Combined placement above this document's root. */
+    readonly parentTransform: readonly number[];
+    /** Conservative inherited metric error, when declared by all external ancestors. */
+    readonly parentGeometricError?: number;
 }
 /** Placement metadata for one ordered content resource. */
 export interface BrowserTilesetResourceDescriptor {
@@ -45,9 +66,13 @@ export interface BrowserTilesetResourceDescriptor {
     readonly resourceId: string;
     /** Original URI declared by the tileset. */
     readonly uri: string;
-    /** Tile child indexes from the tileset root. */
+    /** Tile child indexes within the declaring document. */
     readonly tilePath: readonly number[];
-    /** Combined root-to-tile transform in column-major order. */
+    /** Declaring nested document URL; absent for root-document content. */
+    readonly tilesetUrl?: string;
+    /** Placement index in an expanded inspection's documents. */
+    readonly documentIndex?: number;
+    /** Combined entry-root-to-tile transform in column-major order, including external roots. */
     readonly transform: readonly number[];
 }
 /** One raw content resource from a browser-readable explicit tileset. */
@@ -56,15 +81,34 @@ export interface BrowserTilesetConversionInputResource extends BrowserTilesetRes
     readonly data: Uint8Array;
     /** Optional content type reported by the response. */
     readonly contentType?: string;
+    /** Effective content response URL used to resolve decoder dependencies after redirects. */
+    readonly contentUrl?: string;
 }
 /**
  * Creates a bounded browser source for explicit 3D Tiles 1.0 and 1.1 tilesets.
  *
- * Traversal visits each declared content placement once in depth-first order. Implicit tiling and
- * nested external tilesets are rejected; content decoding and conversion remain codec work.
+ * Traversal visits declared placements in depth-first order. Set maxTilesetDocuments above 1
+ * to follow explicit external tilesets, with shared byte/declaration limits and active-path cycle
+ * detection. Inspection reads the root by default; inspectNestedTilesets follows declared .json
+ * references without fetching binary content. Other nested metadata is discovered during reading.
+ * Implicit tiling remains unsupported; content decoding and conversion remain codec work.
+ * Bounds, metadata and LOD authoring policy remain application responsibilities.
  *
  * @param options - Tileset URL and aggregate byte and resource limits.
- * @returns A source yielding ordered raw tile resources with placement transforms.
+ * @returns A source yielding raw resources and placement transforms; it does not preserve output LOD.
  */
 export declare function createBrowserTilesetConversionSource(options: BrowserTilesetConversionSourceOptions): TileConversionSource<BrowserTilesetConversionInspection, BrowserTilesetConversionInputResource>;
+/** A selected document and conservative source error for one content placement. */
+export interface BrowserTilesetContentSelection {
+    /** Cloned document retaining its metadata, ancestor transforms and only the selected content. */
+    readonly tileset: TilesetDocument;
+    /** Resolved resource URL, carrying same-origin document query parameters. */
+    readonly contentUrl: string;
+    /** Conservative source geometric error in meters, including transform scaling. */
+    readonly geometricError: number;
+    /** Whether the original selected tile has no children. */
+    readonly isLeaf: boolean;
+}
+/** Selects one inspected content while keeping declaring-document conventions and placement. */
+export declare function selectBrowserTilesetContent(inspection: BrowserTilesetConversionInspection, descriptor: BrowserTilesetResourceDescriptor): BrowserTilesetContentSelection;
 export {};

package/dist/v5/browser.cjs

@@ -20,8 +20,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/v5/browser.ts
 var browser_exports = {};
 __export(browser_exports, {
+  SELECTED_MESH_LIMITS: () => import_adapters19.SELECTED_MESH_LIMITS,
   TileConversionError: () => import_core.TileConversionError,
   convertPointCloudSource: () => import_adapters3.convertPointCloudSource,
+  convertPointCloudToPotree: () => import_adapters18.convertPointCloudToPotree,
+  convertPointCloudToTileset: () => import_adapters15.convertPointCloudToTileset,
   convertTileset: () => import_core.convertTileset,
   createBoundedMemoryTileConversionSink: () => import_core3.createBoundedMemoryTileConversionSink,
   createBrowserTileConversionSource: () => import_core4.createBrowserTileConversionSource,
@@ -31,8 +34,11 @@ __export(browser_exports, {
   createI3SMeshSink: () => import_adapters11.createI3SMeshSink,
   createI3SMeshTilesetConversionSource: () => import_adapters14.createI3SMeshTilesetConversionSource,
   createMeshConversionCodec: () => import_adapters5.createMeshConversionCodec,
+  createMeshHierarchyTilesetSink: () => import_adapters20.createMeshHierarchyTilesetSink,
+  createMeshSourceFeatureOptions: () => import_adapters17.createMeshSourceFeatureOptions,
   createMeshTilesetConversionSource: () => import_adapters9.createMeshTilesetConversionSource,
   createPointCloudTilesetSink: () => import_adapters12.createPointCloudTilesetSink,
+  createSelectedMeshConversionSource: () => import_adapters19.createSelectedMeshConversionSource,
   createSingleMeshI3SSink: () => import_adapters10.createSingleMeshI3SSink,
   createSingleMeshTilesetArchive: () => import_adapters8.createSingleMeshTilesetArchive,
   createSingleMeshTilesetSink: () => import_adapters6.createSingleMeshTilesetSink,
@@ -45,8 +51,13 @@ __export(browser_exports, {
   encodePointCloudSourceTile: () => import_adapters2.encodePointCloudSourceTile,
   encodePointCloudTile: () => import_adapters.encodePointCloudTile,
   encodePointCloudTileWithMetadata: () => import_adapters.encodePointCloudTileWithMetadata,
+  encodePotreeArchive: () => import_adapters16.encodePotreeArchive,
   encodeTileConversionArchiveInBatches: () => import_adapters7.encodeTileConversionArchiveInBatches,
+  extractMeshVertices: () => import_adapters16.extractMeshVertices,
   inspectTileset: () => import_core.inspectTileset,
+  measureMeshBytes: () => import_adapters19.measureMeshBytes,
+  openPointCloudFile: () => import_adapters16.openPointCloudFile,
+  selectBrowserTilesetContent: () => import_core9.selectBrowserTilesetContent,
   transformPointCloudSourceTile: () => import_adapters13.transformPointCloudSourceTile,
   traversePointCloudSource: () => import_core6.traversePointCloudSource,
   validateTileset: () => import_core.validateTileset
@@ -74,3 +85,10 @@ var import_adapters12 = require("@loaders.gl/tile-converter/v5/adapters");
 var import_adapters13 = require("@loaders.gl/tile-converter/v5/adapters");
 var import_core8 = require("@loaders.gl/tile-converter/v5/core");
 var import_adapters14 = require("@loaders.gl/tile-converter/v5/adapters");
+var import_adapters15 = require("@loaders.gl/tile-converter/v5/adapters");
+var import_adapters16 = require("@loaders.gl/tile-converter/v5/adapters");
+var import_adapters17 = require("@loaders.gl/tile-converter/v5/adapters");
+var import_adapters18 = require("@loaders.gl/tile-converter/v5/adapters");
+var import_core9 = require("@loaders.gl/tile-converter/v5/core");
+var import_adapters19 = require("@loaders.gl/tile-converter/v5/adapters");
+var import_adapters20 = require("@loaders.gl/tile-converter/v5/adapters");

package/dist/v5/browser.d.ts

@@ -1,7 +1,7 @@
 export { convertTileset, inspectTileset, TileConversionError, validateTileset } from '@loaders.gl/tile-converter/v5/core';
 export { createTilesetConversionSource } from '@loaders.gl/tile-converter/v5/core';
 export type { TilesetConversionSourceOptions } from '@loaders.gl/tile-converter/v5/core';
-export type { ConvertTilesetOptions, TileConversionCodec, TileConversionDiagnostic, TileConversionProgress, TileConversionReport, TileConversionSink, TileConversionSource, TileValidationReport, ValidateTilesetOptions } from '@loaders.gl/tile-converter/v5/core';
+export type { ConvertTilesetOptions, TileConversionCodec, TileConversionDiagnostic, TileConversionProgress, TileConversionReport, TileConversionTimings, TileConversionSink, TileConversionSource, TileValidationReport, ValidateTilesetOptions } from '@loaders.gl/tile-converter/v5/core';
 export { createBoundedMemoryTileConversionSink } from '@loaders.gl/tile-converter/v5/core';
 export { createBrowserTileConversionSource } from '@loaders.gl/tile-converter/v5/core';
 export type { BoundedMemoryTileConversionSink, BoundedMemoryTileConversionSinkOptions, BrowserTileConversionFile, BrowserTileConversionResource } from '@loaders.gl/tile-converter/v5/core';
@@ -42,3 +42,17 @@ export { createI3SConversionSpatialContext } from '@loaders.gl/tile-converter/v5
 export type { I3SConversionSpatialContext } from '@loaders.gl/tile-converter/v5/core';
 export { createI3SMeshTilesetConversionSource } from '@loaders.gl/tile-converter/v5/adapters';
 export type { I3SMeshTilesetSourceOptions, I3SMeshSourceFeatureOptions } from '@loaders.gl/tile-converter/v5/adapters';
+export { convertPointCloudToTileset } from '@loaders.gl/tile-converter/v5/adapters';
+export type { ConvertPointCloudToTilesetOptions, ConvertedPointCloudTileset } from '@loaders.gl/tile-converter/v5/adapters';
+export { encodePotreeArchive, openPointCloudFile, extractMeshVertices } from '@loaders.gl/tile-converter/v5/adapters';
+export type { EncodePotreeArchiveOptions, OpenPointCloudFileOptions, OpenedPointCloudFile, ExtractMeshVerticesOptions } from '@loaders.gl/tile-converter/v5/adapters';
+export { createMeshSourceFeatureOptions } from '@loaders.gl/tile-converter/v5/adapters';
+export type { MeshSourceSchemaOptions } from '@loaders.gl/tile-converter/v5/adapters';
+export { convertPointCloudToPotree } from '@loaders.gl/tile-converter/v5/adapters';
+export type { ConvertPointCloudToPotreeOptions, ConvertedPointCloudPotree } from '@loaders.gl/tile-converter/v5/adapters';
+export { selectBrowserTilesetContent } from '@loaders.gl/tile-converter/v5/core';
+export type { BrowserTilesetDocumentPlacement, BrowserTilesetContentSelection } from '@loaders.gl/tile-converter/v5/core';
+export { createSelectedMeshConversionSource, measureMeshBytes, SELECTED_MESH_LIMITS } from '@loaders.gl/tile-converter/v5/adapters';
+export type { SelectedMeshSourceOptions, SelectedMeshConversionSource } from '@loaders.gl/tile-converter/v5/adapters';
+export { createMeshHierarchyTilesetSink } from '@loaders.gl/tile-converter/v5/adapters';
+export type { MeshHierarchyTilesetSinkOptions } from '@loaders.gl/tile-converter/v5/adapters';

package/dist/v5/browser.js

@@ -41,9 +41,27 @@ import { createPointCloudTilesetSink } from "@loaders.gl/tile-converter/v5/adapt
 import { transformPointCloudSourceTile } from "@loaders.gl/tile-converter/v5/adapters";
 import { createI3SConversionSpatialContext } from "@loaders.gl/tile-converter/v5/core";
 import { createI3SMeshTilesetConversionSource } from "@loaders.gl/tile-converter/v5/adapters";
+import { convertPointCloudToTileset } from "@loaders.gl/tile-converter/v5/adapters";
+import {
+  encodePotreeArchive,
+  openPointCloudFile,
+  extractMeshVertices
+} from "@loaders.gl/tile-converter/v5/adapters";
+import { createMeshSourceFeatureOptions } from "@loaders.gl/tile-converter/v5/adapters";
+import { convertPointCloudToPotree } from "@loaders.gl/tile-converter/v5/adapters";
+import { selectBrowserTilesetContent } from "@loaders.gl/tile-converter/v5/core";
+import {
+  createSelectedMeshConversionSource,
+  measureMeshBytes,
+  SELECTED_MESH_LIMITS
+} from "@loaders.gl/tile-converter/v5/adapters";
+import { createMeshHierarchyTilesetSink } from "@loaders.gl/tile-converter/v5/adapters";
 export {
+  SELECTED_MESH_LIMITS,
   TileConversionError,
   convertPointCloudSource,
+  convertPointCloudToPotree,
+  convertPointCloudToTileset,
   convertTileset,
   createBoundedMemoryTileConversionSink,
   createBrowserTileConversionSource,
@@ -53,8 +71,11 @@ export {
   createI3SMeshSink,
   createI3SMeshTilesetConversionSource,
   createMeshConversionCodec,
+  createMeshHierarchyTilesetSink,
+  createMeshSourceFeatureOptions,
   createMeshTilesetConversionSource,
   createPointCloudTilesetSink,
+  createSelectedMeshConversionSource,
   createSingleMeshI3SSink,
   createSingleMeshTilesetArchive,
   createSingleMeshTilesetSink,
@@ -67,8 +88,13 @@ export {
   encodePointCloudSourceTile,
   encodePointCloudTile,
   encodePointCloudTileWithMetadata,
+  encodePotreeArchive,
   encodeTileConversionArchiveInBatches,
+  extractMeshVertices,
   inspectTileset,
+  measureMeshBytes,
+  openPointCloudFile,
+  selectBrowserTilesetContent,
   transformPointCloudSourceTile,
   traversePointCloudSource,
   validateTileset

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

@@ -31,8 +31,31 @@ export interface TileConversionProgress {
     /** Number of output bytes written so far. */
     readonly outputBytes: number;
 }
+/** Elapsed milliseconds for awaited adapter work; stages exclude downstream backpressure. */
+export interface TileConversionTimings {
+    /** Elapsed inspect adapter time in milliseconds. */
+    readonly inspectMilliseconds: number;
+    /** Elapsed read adapter time in milliseconds. */
+    readonly readMilliseconds: number;
+    /** Elapsed convert adapter time in milliseconds. */
+    readonly convertMilliseconds: number;
+    /** Elapsed validate adapter time in milliseconds. */
+    readonly validateMilliseconds: number;
+    /** Elapsed write adapter time in milliseconds. */
+    readonly writeMilliseconds: number;
+    /** Elapsed finalize adapter time in milliseconds. */
+    readonly finalizeMilliseconds: number;
+    /** Elapsed end-to-end conversion time in milliseconds. */
+    readonly totalMilliseconds: number;
+    /** Node transport preparation, including inspection and selection, when available. */
+    readonly setupMilliseconds?: number;
+    /** Node archive serialization and destination publication, when available. */
+    readonly outputMilliseconds?: number;
+}
 /** Summary returned after a tileset conversion completes. */
 export interface TileConversionReport {
+    /** Optional stage timings, attached after successful destination finalization. */
+    readonly timings?: TileConversionTimings;
     /** Completed conversion state. Failed conversions reject with their cause. */
     readonly state: 'completed';
     /** Number of input resources consumed. */
@@ -73,6 +96,8 @@ export interface TileConversionCodec<TInspection, TInput, TOutput> {
 }
 /** Options for the portable `convertTileset` operation. */
 export interface ConvertTilesetOptions<TInspection, TInput, TOutput> {
+    /** Measure awaited adapter work and total elapsed time; disabled by default. */
+    readonly profile?: boolean;
     /** Injected input resolver and resource reader. */
     readonly source: TileConversionSource<TInspection, TInput>;
     /** Injected output codec. */
@@ -87,6 +112,14 @@ export interface ConvertTilesetOptions<TInspection, TInput, TOutput> {
     readonly maxInputResourceBytes?: number;
     /** Reject any output resource larger than this configured byte limit. */
     readonly maxOutputResourceBytes?: number;
+    /** Maximum measured input bytes across this run; does not bound source allocations. */
+    readonly maxInputBytes?: number;
+    /** Maximum measured output bytes across this run, including checkpointed resources. */
+    readonly maxOutputBytes?: number;
+    /** Maximum input resources consumed by this run, including zero-byte resources. */
+    readonly maxInputResources?: number;
+    /** Maximum outputs processed by this run, including zero-byte and checkpointed resources. */
+    readonly maxOutputResources?: number;
     /** Cancel inspection, conversion, validation, or writes. */
     readonly signal?: AbortSignal;
     /** Receive progress updates after each resource transition. */
@@ -116,6 +149,7 @@ export declare function inspectTileset<TInspection, TInput>(source: TileConversi
  * This does not limit source decoding allocations or content retained by a source.
  * Writes are awaited one resource at a time, keeping queued output bytes bounded by the
  * largest emitted resource and the configured `maxOutputResourceBytes` limit.
+ * Cumulative byte/count limits bound measured work in this run, not total allocation memory.
  */
 export declare function convertTileset<TInspection, TInput, TOutput>(options: ConvertTilesetOptions<TInspection, TInput, TOutput>): Promise<TileConversionReport>;
 /** Validates a tileset through an injected profile-specific validator. */

package/dist/v5/converter-cli.d.ts

@@ -0,0 +1 @@
+export {};