@loaders.gl/tile-converter 5.0.0-alpha.7 → 5.0.0-alpha.8

package/dist/v5/browser-sink.d.ts

@@ -0,0 +1,37 @@
+import type { TileConversionSink } from './conversion-api.js';
+/** One named browser output resource. */
+export interface BrowserTileConversionResource {
+    /** Stable relative output path supplied by the target profile. */
+    readonly resourceId: string;
+    /** Parts combined into a Blob after the total output budget is checked. */
+    readonly parts: readonly BlobPart[];
+    /** MIME type recorded on the resulting Blob. */
+    readonly contentType?: string;
+}
+/** A named output resource retained by the bounded browser sink. */
+export interface BrowserTileConversionFile {
+    /** Stable relative output path supplied by the target profile. */
+    readonly resourceId: string;
+    /** Browser-native data for download or application-provided packaging. */
+    readonly blob: Blob;
+}
+/** Memory limit for a browser conversion sink. */
+export interface BoundedMemoryTileConversionSinkOptions {
+    /** Maximum combined Blob size retained by this sink, in bytes. */
+    readonly maxTotalBytes: number;
+}
+/** Browser sink with read access to its bounded output resources. */
+export interface BoundedMemoryTileConversionSink extends TileConversionSink<BrowserTileConversionResource> {
+    /** Returns the retained files in stable resource-ID order. */
+    getFiles(): readonly BrowserTileConversionFile[];
+}
+/**
+ * Creates a browser-only sink that retains output as Blobs under a total byte limit.
+ *
+ * The sink does not download or archive files. Applications can use `getFiles()` after
+ * `convertTileset` completes and package or download the returned Blobs as needed.
+ *
+ * @param options - Maximum in-memory output size.
+ * @returns A sink that stores browser-native Blobs and clears them on abort.
+ */
+export declare function createBoundedMemoryTileConversionSink(options: BoundedMemoryTileConversionSinkOptions): BoundedMemoryTileConversionSink;

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

@@ -0,0 +1,38 @@
+import type { TileConversionSource } from './conversion-api.js';
+/** Metadata available before a browser resource is read. */
+export interface BrowserTileConversionInspection {
+    /** Stable resource path assigned to the input tile. */
+    readonly resourceId: string;
+    /** Optional MIME type supplied by the caller or source Blob. */
+    readonly contentType?: string;
+}
+/** Raw bytes read from one browser tile resource. */
+export interface BrowserTileConversionInputResource {
+    /** Stable resource path assigned to the input tile. */
+    readonly resourceId: string;
+    /** Complete resource bytes for a profile-specific codec. */
+    readonly data: Uint8Array;
+    /** Optional MIME type supplied by the caller, Blob, or URL response. */
+    readonly contentType?: string;
+}
+/** Browser input and size limit for a single-resource conversion. */
+export interface BrowserTileConversionSourceOptions {
+    /** Input URL or already available browser Blob. */
+    readonly input: string | Blob;
+    /** Stable path to associate with the input resource. */
+    readonly resourceId: string;
+    /** Maximum number of input bytes held in memory. */
+    readonly maxInputBytes: number;
+    /** Optional MIME type override. */
+    readonly contentType?: string;
+}
+/**
+ * Creates a browser source for one mesh resource provided as a URL or Blob.
+ *
+ * URL responses are read incrementally and canceled if they exceed `maxInputBytes`.
+ * Tileset JSON traversal and format decoding remain profile-specific source and codec work.
+ *
+ * @param options - Input, stable resource ID, and maximum input size.
+ * @returns A source that yields one complete resource to a v5 codec.
+ */
+export declare function createBrowserTileConversionSource(options: BrowserTileConversionSourceOptions): TileConversionSource<BrowserTileConversionInspection, BrowserTileConversionInputResource>;

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

@@ -0,0 +1,70 @@
+import type { TileConversionSource } from './conversion-api.js';
+type TilesetContent = {
+    uri?: string;
+    url?: string;
+};
+type TilesetTile = {
+    content?: TilesetContent;
+    contents?: TilesetContent[];
+    children?: TilesetTile[];
+    transform?: number[];
+    implicitTiling?: unknown;
+    extensions?: Record<string, unknown>;
+};
+type TilesetDocument = {
+    asset?: {
+        version?: string;
+    };
+    root?: TilesetTile;
+};
+/** Input options for bounded traversal of one explicit 3D Tiles tileset. */
+export interface BrowserTilesetConversionSourceOptions {
+    /** URL of the root tileset JSON document. */
+    readonly input: string;
+    /** Maximum bytes retained across the tileset JSON and all content resources. */
+    readonly maxInputBytes: number;
+    /** Maximum number of content resources to visit. */
+    readonly maxInputResources: number;
+    /** 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. */
+    readonly rootUrl: string;
+    /** Parsed root document used for deterministic content traversal. */
+    readonly tileset: TilesetDocument;
+    /** Ordered content descriptors. */
+    readonly resources: readonly BrowserTilesetResourceDescriptor[];
+    /** Root document bytes charged against the input limit. */
+    readonly tilesetBytes: number;
+}
+/** Placement metadata for one ordered content resource. */
+export interface BrowserTilesetResourceDescriptor {
+    /** Unique, stable path for this content placement. */
+    readonly resourceId: string;
+    /** Original URI declared by the tileset. */
+    readonly uri: string;
+    /** Tile child indexes from the tileset root. */
+    readonly tilePath: readonly number[];
+    /** Combined root-to-tile transform in column-major order. */
+    readonly transform: readonly number[];
+}
+/** One raw content resource from a browser-readable explicit tileset. */
+export interface BrowserTilesetConversionInputResource extends BrowserTilesetResourceDescriptor {
+    /** Complete content bytes for an injected profile-specific codec. */
+    readonly data: Uint8Array;
+    /** Optional content type reported by the response. */
+    readonly contentType?: 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.
+ *
+ * @param options - Tileset URL and aggregate byte and resource limits.
+ * @returns A source yielding ordered raw tile resources with placement transforms.
+ */
+export declare function createBrowserTilesetConversionSource(options: BrowserTilesetConversionSourceOptions): TileConversionSource<BrowserTilesetConversionInspection, BrowserTilesetConversionInputResource>;
+export {};