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

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

@@ -0,0 +1,36 @@
+import type { HttpFileIdentity, ReadableFile } from '@loaders.gl/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,27 +20,45 @@ 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,
   createBrowserTilesetConversionSource: () => import_core5.createBrowserTilesetConversionSource,
+  createI3SConversionSpatialContext: () => import_core8.createI3SConversionSpatialContext,
   createI3SMeshConversionCodec: () => import_adapters10.createI3SMeshConversionCodec,
+  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,
   createTileConversionArchive: () => import_adapters7.createTileConversionArchive,
+  createTileConversionResourceFetcher: () => import_adapters11.createTileConversionResourceFetcher,
   createTiles3DConversionSpatialContext: () => import_core7.createTiles3DConversionSpatialContext,
   createTilesetConversionSource: () => import_core2.createTilesetConversionSource,
   encodeMeshTile: () => import_adapters4.encodeMeshTile,
   encodePointCloudSource: () => import_adapters2.encodePointCloudSource,
   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
 });
@@ -62,3 +80,15 @@ var import_adapters7 = require("@loaders.gl/tile-converter/v5/adapters");
 var import_adapters8 = require("@loaders.gl/tile-converter/v5/adapters");
 var import_adapters9 = require("@loaders.gl/tile-converter/v5/adapters");
 var import_adapters10 = require("@loaders.gl/tile-converter/v5/adapters");
+var import_adapters11 = require("@loaders.gl/tile-converter/v5/adapters");
+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

@@ -7,8 +7,8 @@ export { createBrowserTileConversionSource } from '@loaders.gl/tile-converter/v5
 export type { BoundedMemoryTileConversionSink, BoundedMemoryTileConversionSinkOptions, BrowserTileConversionFile, BrowserTileConversionResource } from '@loaders.gl/tile-converter/v5/core';
 export type { BrowserTileConversionInspection, BrowserTileConversionInputResource, BrowserTileConversionSourceOptions } from '@loaders.gl/tile-converter/v5/core';
 export { createBrowserTilesetConversionSource } from '@loaders.gl/tile-converter/v5/core';
-export { encodePointCloudTile } from '@loaders.gl/tile-converter/v5/adapters';
-export type { EncodePointCloudTileOptions } from '@loaders.gl/tile-converter/v5/adapters';
+export { encodePointCloudTile, encodePointCloudTileWithMetadata } from '@loaders.gl/tile-converter/v5/adapters';
+export type { EncodePointCloudTileOptions, EncodedPointCloudTile } from '@loaders.gl/tile-converter/v5/adapters';
 export { traversePointCloudSource } from '@loaders.gl/tile-converter/v5/core';
 export type { PointCloudSourceTile, TraversePointCloudSourceOptions } from '@loaders.gl/tile-converter/v5/core';
 export { encodePointCloudSource, encodePointCloudSourceTile } from '@loaders.gl/tile-converter/v5/adapters';
@@ -32,3 +32,27 @@ export { createMeshTilesetConversionSource } from '@loaders.gl/tile-converter/v5
 export type { MeshSourceResource, MeshTilesetSourceOptions, MeshSourceFeatureOptions } from '@loaders.gl/tile-converter/v5/adapters';
 export { createI3SMeshConversionCodec, createSingleMeshI3SSink } from '@loaders.gl/tile-converter/v5/adapters';
 export type { I3SMeshConversionResource, I3SMeshConversionCodecOptions, SingleMeshI3SSink } from '@loaders.gl/tile-converter/v5/adapters';
+export { createI3SMeshSink, createTileConversionResourceFetcher } from '@loaders.gl/tile-converter/v5/adapters';
+export type { I3SMeshSink, I3SMeshSinkOptions, TileConversionResourceFetcherOptions, MeshTileFeatures } from '@loaders.gl/tile-converter/v5/adapters';
+export { createPointCloudTilesetSink } from '@loaders.gl/tile-converter/v5/adapters';
+export type { PointCloudTilesetSink, PointCloudTilesetSinkOptions } from '@loaders.gl/tile-converter/v5/adapters';
+export { transformPointCloudSourceTile } from '@loaders.gl/tile-converter/v5/adapters';
+export type { PointCloudSpatialOptions } from '@loaders.gl/tile-converter/v5/adapters';
+export { createI3SConversionSpatialContext } from '@loaders.gl/tile-converter/v5/core';
+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

@@ -9,7 +9,10 @@ import { createTilesetConversionSource } from "@loaders.gl/tile-converter/v5/cor
 import { createBoundedMemoryTileConversionSink } from "@loaders.gl/tile-converter/v5/core";
 import { createBrowserTileConversionSource } from "@loaders.gl/tile-converter/v5/core";
 import { createBrowserTilesetConversionSource } from "@loaders.gl/tile-converter/v5/core";
-import { encodePointCloudTile } from "@loaders.gl/tile-converter/v5/adapters";
+import {
+  encodePointCloudTile,
+  encodePointCloudTileWithMetadata
+} from "@loaders.gl/tile-converter/v5/adapters";
 import { traversePointCloudSource } from "@loaders.gl/tile-converter/v5/core";
 import {
   encodePointCloudSource,
@@ -30,28 +33,69 @@ import {
   createI3SMeshConversionCodec,
   createSingleMeshI3SSink
 } from "@loaders.gl/tile-converter/v5/adapters";
+import {
+  createI3SMeshSink,
+  createTileConversionResourceFetcher
+} from "@loaders.gl/tile-converter/v5/adapters";
+import { createPointCloudTilesetSink } from "@loaders.gl/tile-converter/v5/adapters";
+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,
   createBrowserTilesetConversionSource,
+  createI3SConversionSpatialContext,
   createI3SMeshConversionCodec,
+  createI3SMeshSink,
+  createI3SMeshTilesetConversionSource,
   createMeshConversionCodec,
+  createMeshHierarchyTilesetSink,
+  createMeshSourceFeatureOptions,
   createMeshTilesetConversionSource,
+  createPointCloudTilesetSink,
+  createSelectedMeshConversionSource,
   createSingleMeshI3SSink,
   createSingleMeshTilesetArchive,
   createSingleMeshTilesetSink,
   createTileConversionArchive,
+  createTileConversionResourceFetcher,
   createTiles3DConversionSpatialContext,
   createTilesetConversionSource,
   encodeMeshTile,
   encodePointCloudSource,
   encodePointCloudSourceTile,
   encodePointCloudTile,
+  encodePointCloudTileWithMetadata,
+  encodePotreeArchive,
   encodeTileConversionArchiveInBatches,
+  extractMeshVertices,
   inspectTileset,
+  measureMeshBytes,
+  openPointCloudFile,
+  selectBrowserTilesetContent,
+  transformPointCloudSourceTile,
   traversePointCloudSource,
   validateTileset
 };

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

@@ -87,6 +87,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 +124,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 {};