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

package/dist/v5/browser.cjs

@@ -26,21 +26,28 @@ __export(browser_exports, {
   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,
   createMeshTilesetConversionSource: () => import_adapters9.createMeshTilesetConversionSource,
+  createPointCloudTilesetSink: () => import_adapters12.createPointCloudTilesetSink,
   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,
   encodeTileConversionArchiveInBatches: () => import_adapters7.encodeTileConversionArchiveInBatches,
   inspectTileset: () => import_core.inspectTileset,
+  transformPointCloudSourceTile: () => import_adapters13.transformPointCloudSourceTile,
   traversePointCloudSource: () => import_core6.traversePointCloudSource,
   validateTileset: () => import_core.validateTileset
 });
@@ -62,3 +69,8 @@ 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");

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,13 @@ 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';

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,6 +33,14 @@ 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";
 export {
   TileConversionError,
   convertPointCloudSource,
@@ -37,21 +48,28 @@ export {
   createBoundedMemoryTileConversionSink,
   createBrowserTileConversionSource,
   createBrowserTilesetConversionSource,
+  createI3SConversionSpatialContext,
   createI3SMeshConversionCodec,
+  createI3SMeshSink,
+  createI3SMeshTilesetConversionSource,
   createMeshConversionCodec,
   createMeshTilesetConversionSource,
+  createPointCloudTilesetSink,
   createSingleMeshI3SSink,
   createSingleMeshTilesetArchive,
   createSingleMeshTilesetSink,
   createTileConversionArchive,
+  createTileConversionResourceFetcher,
   createTiles3DConversionSpatialContext,
   createTilesetConversionSource,
   encodeMeshTile,
   encodePointCloudSource,
   encodePointCloudSourceTile,
   encodePointCloudTile,
+  encodePointCloudTileWithMetadata,
   encodeTileConversionArchiveInBatches,
   inspectTileset,
+  transformPointCloudSourceTile,
   traversePointCloudSource,
   validateTileset
 };

package/dist/v5/core.cjs

@@ -310,6 +310,12 @@ function createTiles3DConversionSpatialContext(discovered, options = {}) {
   if (spatialReference.status === "unresolved") {
     throw createSpatialConversionError(spatialReference);
   }
+  if (spatialReference.status !== "native" && spatialReference.coordinateEpoch !== void 0) {
+    throw new TileConversionError(
+      "SPATIAL_EPOCH_UNSUPPORTED",
+      "Epoch-tagged coordinates require an epoch-aware datum operation before conversion"
+    );
+  }
   const transformer = spatialReference.status === "native" ? void 0 : createSpatialTransformer(
     spatialReference,
     () => new import_tiles.Tiles3DSpatialTransformer(spatialReference, options)
@@ -327,14 +333,62 @@ function createI3SConversionSpatialContext(discovered, options = {}) {
   if (spatialReference.status === "unresolved") {
     throw createSpatialConversionError(spatialReference);
   }
+  if (spatialReference.status !== "native" && spatialReference.coordinateEpoch !== void 0) {
+    throw new TileConversionError(
+      "SPATIAL_EPOCH_UNSUPPORTED",
+      "Epoch-tagged coordinates require an epoch-aware datum operation before conversion"
+    );
+  }
   const transformer = spatialReference.status === "native" ? void 0 : createSpatialTransformer(
     spatialReference,
     () => new import_tiles.I3SSpatialTransformer(spatialReference, options)
   );
   const outputSpatialReference = transformer ? transformer.spatialReference : spatialReference;
+  let nativeNormalTransformer;
+  const transformNativeNormals = (normals, positions, normalReferenceFrame) => {
+    if (!spatialReference.sourceCrs || ["local", "cartesian"].includes(spatialReference.coordinateFrame)) {
+      const targetNormals = Float32Array.from(normals);
+      for (let index = 0; index < normals.length; index += 3) {
+        const length = Math.hypot(normals[index], normals[index + 1], normals[index + 2]);
+        if (length) {
+          for (let axis = 0; axis < 3; axis++) {
+            targetNormals[index + axis] = normals[index + axis] / length;
+          }
+        }
+      }
+      return targetNormals;
+    }
+    nativeNormalTransformer ||= createSpatialTransformer(
+      spatialReference,
+      () => new import_tiles.I3SSpatialTransformer(
+        {
+          ...spatialReference,
+          status: "transformable",
+          targetCrs: spatialReference.sourceCrs
+        },
+        options
+      )
+    );
+    return nativeNormalTransformer.transformNormals(normals, positions, normalReferenceFrame);
+  };
   return {
     spatialReference: outputSpatialReference,
     transformPositions: (positions, sourceOrigin) => transformer ? transformer.transformPositions(positions, sourceOrigin) : createNativeI3SPositions(positions, sourceOrigin, spatialReference),
+    transformGeometryAsync: async (positions, normals, normalReferenceFrame) => {
+      if (transformer)
+        return transformer.transformGeometryAsync(positions, normals, normalReferenceFrame);
+      const targetPositions = Float64Array.from(positions);
+      if (targetPositions.length % 3 || targetPositions.some((value) => !Number.isFinite(value)) || normals && (normals.length !== positions.length || Array.from(normals).some((value) => !Number.isFinite(value))) || normalReferenceFrame !== void 0 && !["earth-centered", "vertex-reference-frame"].includes(normalReferenceFrame)) {
+        throw new TileConversionError(
+          "SPATIAL_INPUT_INVALID",
+          "Conversion geometry requires finite matching xyz arrays and a supported I3S vector frame"
+        );
+      }
+      return {
+        positions: targetPositions,
+        normals: normals ? transformNativeNormals(normals, positions, normalReferenceFrame) : void 0
+      };
+    },
     transformPositionsAsync: (positions, sourceOrigin) => transformer ? transformer.transformPositionsAsync(positions, sourceOrigin) : Promise.resolve(createNativeI3SPositions(positions, sourceOrigin, spatialReference)),
     transformNormals: (normals, positions, normalReferenceFrame) => transformer ? transformer.transformNormals(normals, positions, normalReferenceFrame) : Float32Array.from(normals),
     transformBoundingVolume: (bounds) => transformer ? transformer.transformBoundingVolume(bounds) : cloneI3SBounds(bounds),

package/dist/v5/core.js

@@ -278,6 +278,12 @@ function createTiles3DConversionSpatialContext(discovered, options = {}) {
   if (spatialReference.status === "unresolved") {
     throw createSpatialConversionError(spatialReference);
   }
+  if (spatialReference.status !== "native" && spatialReference.coordinateEpoch !== void 0) {
+    throw new TileConversionError(
+      "SPATIAL_EPOCH_UNSUPPORTED",
+      "Epoch-tagged coordinates require an epoch-aware datum operation before conversion"
+    );
+  }
   const transformer = spatialReference.status === "native" ? void 0 : createSpatialTransformer(
     spatialReference,
     () => new Tiles3DSpatialTransformer(spatialReference, options)
@@ -295,14 +301,62 @@ function createI3SConversionSpatialContext(discovered, options = {}) {
   if (spatialReference.status === "unresolved") {
     throw createSpatialConversionError(spatialReference);
   }
+  if (spatialReference.status !== "native" && spatialReference.coordinateEpoch !== void 0) {
+    throw new TileConversionError(
+      "SPATIAL_EPOCH_UNSUPPORTED",
+      "Epoch-tagged coordinates require an epoch-aware datum operation before conversion"
+    );
+  }
   const transformer = spatialReference.status === "native" ? void 0 : createSpatialTransformer(
     spatialReference,
     () => new I3SSpatialTransformer(spatialReference, options)
   );
   const outputSpatialReference = transformer ? transformer.spatialReference : spatialReference;
+  let nativeNormalTransformer;
+  const transformNativeNormals = (normals, positions, normalReferenceFrame) => {
+    if (!spatialReference.sourceCrs || ["local", "cartesian"].includes(spatialReference.coordinateFrame)) {
+      const targetNormals = Float32Array.from(normals);
+      for (let index = 0; index < normals.length; index += 3) {
+        const length = Math.hypot(normals[index], normals[index + 1], normals[index + 2]);
+        if (length) {
+          for (let axis = 0; axis < 3; axis++) {
+            targetNormals[index + axis] = normals[index + axis] / length;
+          }
+        }
+      }
+      return targetNormals;
+    }
+    nativeNormalTransformer ||= createSpatialTransformer(
+      spatialReference,
+      () => new I3SSpatialTransformer(
+        {
+          ...spatialReference,
+          status: "transformable",
+          targetCrs: spatialReference.sourceCrs
+        },
+        options
+      )
+    );
+    return nativeNormalTransformer.transformNormals(normals, positions, normalReferenceFrame);
+  };
   return {
     spatialReference: outputSpatialReference,
     transformPositions: (positions, sourceOrigin) => transformer ? transformer.transformPositions(positions, sourceOrigin) : createNativeI3SPositions(positions, sourceOrigin, spatialReference),
+    transformGeometryAsync: async (positions, normals, normalReferenceFrame) => {
+      if (transformer)
+        return transformer.transformGeometryAsync(positions, normals, normalReferenceFrame);
+      const targetPositions = Float64Array.from(positions);
+      if (targetPositions.length % 3 || targetPositions.some((value) => !Number.isFinite(value)) || normals && (normals.length !== positions.length || Array.from(normals).some((value) => !Number.isFinite(value))) || normalReferenceFrame !== void 0 && !["earth-centered", "vertex-reference-frame"].includes(normalReferenceFrame)) {
+        throw new TileConversionError(
+          "SPATIAL_INPUT_INVALID",
+          "Conversion geometry requires finite matching xyz arrays and a supported I3S vector frame"
+        );
+      }
+      return {
+        positions: targetPositions,
+        normals: normals ? transformNativeNormals(normals, positions, normalReferenceFrame) : void 0
+      };
+    },
     transformPositionsAsync: (positions, sourceOrigin) => transformer ? transformer.transformPositionsAsync(positions, sourceOrigin) : Promise.resolve(createNativeI3SPositions(positions, sourceOrigin, spatialReference)),
     transformNormals: (normals, positions, normalReferenceFrame) => transformer ? transformer.transformNormals(normals, positions, normalReferenceFrame) : Float32Array.from(normals),
     transformBoundingVolume: (bounds) => transformer ? transformer.transformBoundingVolume(bounds) : cloneI3SBounds(bounds),

package/dist/v5/i3s-mesh-conversion.d.ts

@@ -1,6 +1,6 @@
-import type { EncodedI3SMeshLayer, I3SMeshWriterOptions } from '@loaders.gl/i3s';
+import type { EncodedI3SMeshLayer, I3SMeshWriterOptions, I3SDracoLibraryOptions } from '@loaders.gl/i3s';
 import type { TileConversionCodec, TileConversionSink } from '@loaders.gl/tile-converter/v5/core';
-import type { Tiles3DConversionSpatialContext } from '@loaders.gl/tile-converter/v5/core';
+import type { Tiles3DConversionSpatialContext, I3SConversionSpatialContext } from '@loaders.gl/tile-converter/v5/core';
 import type { MeshSourceResource } from './mesh-source.js';
 import type { BrowserTileConversionFile } from '@loaders.gl/tile-converter/v5/core';
 /** One authored mesh layer, ready for the single-layer sink. */
@@ -11,13 +11,19 @@ export interface I3SMeshConversionResource extends EncodedI3SMeshLayer {
 /** Spatial preparation and required authoring limits for the I3S codec. */
 export interface I3SMeshConversionCodecOptions extends Pick<I3SMeshWriterOptions, 'name' | 'maxPositionError' | 'maxResourceBytes'> {
     /** Shared source-to-ECEF context, applied exactly once before I3S geographic encoding. */
-    readonly spatialContext: Tiles3DConversionSpatialContext;
+    readonly spatialContext: Tiles3DConversionSpatialContext | I3SConversionSpatialContext;
+    /** I3S vector frame when using an I3S context; defaults to earth-centered. */
+    readonly normalReferenceFrame?: 'earth-centered' | 'vertex-reference-frame';
+    /** Lossless Edge Breaker geometry by default; false retains raw I3S geometry. */
+    readonly draco?: boolean;
+    /** Full Draco encoder/decoder runtime URLs or injected modules. */
+    readonly dracoLibraryOptions?: I3SDracoLibraryOptions;
 }
 /** Creates a portable source-mesh to I3S layer codec with explicit precision and feature diagnostics. */
 export declare function createI3SMeshConversionCodec<TInspection = unknown>(options: I3SMeshConversionCodecOptions): TileConversionCodec<TInspection, MeshSourceResource, I3SMeshConversionResource>;
 /** Atomic bounded output for one authored I3S layer. */
 export interface SingleMeshI3SSink extends TileConversionSink<I3SMeshConversionResource> {
-    /** Compressed archive-relative files visible only after successful finalization. */
+    /** Archive-relative geometry, metadata and images visible only after successful finalization. */
     getFiles(): readonly BrowserTileConversionFile[];
 }
 /** Creates an atomic bounded single-mesh I3S sink; pass finalized files to createTileConversionArchive. */

package/dist/v5/i3s-mesh-sink.d.ts

@@ -0,0 +1,25 @@
+import type { BrowserTileConversionFile, TileConversionSink } from '@loaders.gl/tile-converter/v5/core';
+import type { I3SMeshConversionResource } from './i3s-mesh-conversion.js';
+/** Bounded flat collection of mesh nodes sharing one I3S feature/geometry schema. */
+export interface I3SMeshSinkOptions {
+    /** Maximum compressed bytes retained, including final layer/index metadata. */
+    readonly maxTotalBytes: number;
+    /** Maximum primitive placements, from one through 64. */
+    readonly maxMeshes: number;
+    /** Maximum decompressed or generated metadata/attribute resource bytes. */
+    readonly maxResourceBytes: number;
+}
+/** Atomic multi-mesh I3S output, ready for portable SLPK packaging. */
+export interface I3SMeshSink extends TileConversionSink<I3SMeshConversionResource> {
+    /** Finalized files only; failed or unfinished conversion exposes no output. */
+    getFiles(): readonly BrowserTileConversionFile[];
+}
+/**
+ * Combines independently authored mesh resources into one flat I3S layer.
+ * Leaves retain geographic placements, compressed geometry and attributes. A shared schema is
+ * required; generated object IDs must be disjoint (the conversion codec allocates them).
+ * Finalization rebuilds legacy indices, paged indices and enclosing ECEF bounds, including a
+ * second page for the 64th leaf. No source LOD hierarchy is implied. Byte gates bound retained
+ * resources and metadata, not peak decoder/compressor memory.
+ */
+export declare function createI3SMeshSink(options: I3SMeshSinkOptions): I3SMeshSink;

package/dist/v5/i3s-mesh-source-features.d.ts

@@ -0,0 +1,13 @@
+import type { I3STileContent, I3SMeshFeatures } from '@loaders.gl/i3s';
+import type { TilesetContentTraversalItem, TilesetSourceMetadata } from '@loaders.gl/tiles';
+import type { MeshSourceFeatureOptions } from './mesh-source-features.js';
+import type { MeshTilesetSourceOptions } from './mesh-source.js';
+/** Explicit mapping of scalar I3S attribute resources and their geometry identifiers. */
+export interface I3SMeshSourceFeatureOptions extends MeshSourceFeatureOptions {
+    /** Attribute column whose exact integer values identify the decoded geometry. */
+    readonly objectIdProperty: string;
+    /** Aggregate encoded attribute byte limit for each node, checked before parsing. */
+    readonly maxAttributeBytes: number;
+}
+/** Reads exact scalar/string columns and constructs complete triangle-to-Arrow-row ownership. */
+export declare function extractI3SMeshFeatures(content: I3STileContent, item: TilesetContentTraversalItem, metadata: TilesetSourceMetadata, options: I3SMeshSourceFeatureOptions, readExternalResource: MeshTilesetSourceOptions['readExternalResource'], contentUri: string | undefined, signal?: AbortSignal): Promise<I3SMeshFeatures>;

package/dist/v5/i3s-mesh-source-material.d.ts

@@ -0,0 +1,5 @@
+import type { I3STileContent, I3STileHeader } from '@loaders.gl/i3s';
+import type { MeshTilesetSourceOptions } from './mesh-source.js';
+import type { MeshTileMaterial } from './mesh.js';
+/** Maps normalized I3S factors and one encoded base-color PNG/JPEG with explicit wrapping. */
+export declare function mapI3SMeshSourceMaterial(content: I3STileContent, header: Partial<I3STileHeader>, readExternalResource: MeshTilesetSourceOptions['readExternalResource'], contentUri: string | undefined, signal?: AbortSignal): Promise<MeshTileMaterial | undefined>;

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

@@ -0,0 +1,30 @@
+import type { I3STileContent, I3SMeshFeatures } from '@loaders.gl/i3s';
+import type { Tileset3D, TilesetSourceMetadata, TilesetContentTraversalItem } from '@loaders.gl/tiles';
+import type { TileConversionSource, TilesetConversionSourceOptions } from '@loaders.gl/tile-converter/v5/core';
+import type { MeshSourceResource } from './mesh-source.js';
+import type { MeshTilesetSourceOptions } from './mesh-source.js';
+import type { I3SMeshSourceFeatureOptions } from './i3s-mesh-source-features.js';
+export type { I3SMeshSourceFeatureOptions } from './i3s-mesh-source-features.js';
+/** Selected I3S triangle, encoded base-color appearance and explicit-schema feature profile. */
+export interface I3SMeshTilesetSourceOptions extends TilesetConversionSourceOptions {
+    /** Read scalar/string attribute resources with an explicit schema and geometry OID mapping. */
+    readonly features?: I3SMeshSourceFeatureOptions;
+    /** Application-owned bounded reader, including archive resolution, authentication and decompression. */
+    readonly readExternalResource?: MeshTilesetSourceOptions['readExternalResource'];
+    /** Custom alternative to features, for source semantics outside the scalar resource profile. */
+    readonly getFeatures?: (content: I3STileContent, item: TilesetContentTraversalItem, metadata: TilesetSourceMetadata, signal?: AbortSignal) => I3SMeshFeatures | Promise<I3SMeshFeatures>;
+}
+/**
+ * Reads original absolute I3S positions through camera-independent traversal.
+ * Use a dedicated runtime with i3s.geometryMode='source'. The shared I3S spatial codec owns
+ * units, elevation and reprojection; this source never consumes renderer placement matrices.
+ * Pair the GLB codec with autoOrigin=true, or select an explicit target origin on the resources.
+ * Positions/normals/TEXCOORD_0, basic PBR factors and one encoded PNG/JPEG base-color texture
+ * are supported. Vertex colors, UV regions, additional attributes and segmentation fail explicitly.
+ * Features require an explicit schema/resource reader or a custom Arrow mapper.
+ * Unsafe decoded numeric geometry identifiers are rejected; exact property IDs use bigint.
+ * @param tileset - Dedicated I3S runtime using source-coordinate content decoding.
+ * @param options - Feature mapping and lifetime policy for content loaded during traversal.
+ * @returns A portable source of one absolute mesh per I3S node content.
+ */
+export declare function createI3SMeshTilesetConversionSource(tileset: Tileset3D, options?: I3SMeshTilesetSourceOptions): TileConversionSource<TilesetSourceMetadata, MeshSourceResource>;

package/dist/v5/index.cjs

@@ -26,21 +26,27 @@ __export(index_exports, {
   convertTileset: () => import_core.convertTileset,
   createI3SConversionSpatialContext: () => import_core3.createI3SConversionSpatialContext,
   createI3SMeshConversionCodec: () => import_adapters11.createI3SMeshConversionCodec,
+  createI3SMeshSink: () => import_adapters12.createI3SMeshSink,
+  createI3SMeshTilesetConversionSource: () => import_adapters15.createI3SMeshTilesetConversionSource,
   createManifestBackedTileConversionSink: () => import_core5.createManifestBackedTileConversionSink,
   createMeshConversionCodec: () => import_adapters6.createMeshConversionCodec,
   createMeshTilesetConversionSource: () => import_adapters10.createMeshTilesetConversionSource,
+  createPointCloudTilesetSink: () => import_adapters13.createPointCloudTilesetSink,
   createSingleMeshI3SSink: () => import_adapters11.createSingleMeshI3SSink,
   createSingleMeshTilesetArchive: () => import_adapters9.createSingleMeshTilesetArchive,
   createSingleMeshTilesetSink: () => import_adapters7.createSingleMeshTilesetSink,
   createTileConversionArchive: () => import_adapters8.createTileConversionArchive,
+  createTileConversionResourceFetcher: () => import_adapters12.createTileConversionResourceFetcher,
   createTiles3DConversionSpatialContext: () => import_core3.createTiles3DConversionSpatialContext,
   createTilesetConversionSource: () => import_core2.createTilesetConversionSource,
   encodeMeshTile: () => import_adapters5.encodeMeshTile,
   encodePointCloudSource: () => import_adapters3.encodePointCloudSource,
   encodePointCloudSourceTile: () => import_adapters3.encodePointCloudSourceTile,
   encodePointCloudTile: () => import_adapters2.encodePointCloudTile,
+  encodePointCloudTileWithMetadata: () => import_adapters2.encodePointCloudTileWithMetadata,
   encodeTileConversionArchiveInBatches: () => import_adapters8.encodeTileConversionArchiveInBatches,
   inspectTileset: () => import_core.inspectTileset,
+  transformPointCloudSourceTile: () => import_adapters14.transformPointCloudSourceTile,
   traversePointCloudSource: () => import_core4.traversePointCloudSource,
   validateTileset: () => import_core.validateTileset
 });
@@ -61,3 +67,7 @@ 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_adapters14 = require("@loaders.gl/tile-converter/v5/adapters");
+var import_adapters15 = require("@loaders.gl/tile-converter/v5/adapters");

package/dist/v5/index.d.ts

@@ -6,8 +6,8 @@ export { createI3SConversionSpatialContext, createTiles3DConversionSpatialContex
 export type { I3SConversionSpatialContext, Tiles3DConversionSpatialContext } from '@loaders.gl/tile-converter/v5/core';
 export { convertFeatureAttributesToArrowBatches } from '@loaders.gl/tile-converter/v5/adapters';
 export type { FeatureArrowBatchOptions, TileFeatureAttributes } from '@loaders.gl/tile-converter/v5/adapters';
-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';
@@ -30,3 +30,11 @@ 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 { createI3SMeshTilesetConversionSource } from '@loaders.gl/tile-converter/v5/adapters';
+export type { I3SMeshTilesetSourceOptions, I3SMeshSourceFeatureOptions } from '@loaders.gl/tile-converter/v5/adapters';

package/dist/v5/index.js

@@ -11,7 +11,10 @@ import {
   createTiles3DConversionSpatialContext
 } from "@loaders.gl/tile-converter/v5/core";
 import { convertFeatureAttributesToArrowBatches } from "@loaders.gl/tile-converter/v5/adapters";
-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,
@@ -32,6 +35,13 @@ 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 { createI3SMeshTilesetConversionSource } from "@loaders.gl/tile-converter/v5/adapters";
 export {
   TileConversionError,
   convertFeatureAttributesToArrowBatches,
@@ -39,21 +49,27 @@ export {
   convertTileset,
   createI3SConversionSpatialContext,
   createI3SMeshConversionCodec,
+  createI3SMeshSink,
+  createI3SMeshTilesetConversionSource,
   createManifestBackedTileConversionSink,
   createMeshConversionCodec,
   createMeshTilesetConversionSource,
+  createPointCloudTilesetSink,
   createSingleMeshI3SSink,
   createSingleMeshTilesetArchive,
   createSingleMeshTilesetSink,
   createTileConversionArchive,
+  createTileConversionResourceFetcher,
   createTiles3DConversionSpatialContext,
   createTilesetConversionSource,
   encodeMeshTile,
   encodePointCloudSource,
   encodePointCloudSourceTile,
   encodePointCloudTile,
+  encodePointCloudTileWithMetadata,
   encodeTileConversionArchiveInBatches,
   inspectTileset,
+  transformPointCloudSourceTile,
   traversePointCloudSource,
   validateTileset
 };

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

@@ -2,7 +2,8 @@ import type { TilesetSpatialReference } from '@loaders.gl/tiles';
 import type { MeshGeometry } from '@loaders.gl/schema';
 import type { LoadLibraryOptions } from '@loaders.gl/worker-utils';
 import type { TileConversionCodec } from '@loaders.gl/tile-converter/v5/core';
-import type { Tiles3DConversionSpatialContext } from '@loaders.gl/tile-converter/v5/core';
+import type { Tiles3DConversionSpatialContext, I3SConversionSpatialContext } from '@loaders.gl/tile-converter/v5/core';
+import type { MeshTileFeatures } from './mesh-features.js';
 import type { MeshTileMaterial } from './mesh.js';
 /** Explicitly selected geometry, with positions already in the spatial context's source frame. */
 export interface MeshConversionInput {
@@ -10,8 +11,12 @@ export interface MeshConversionInput {
     readonly id: string;
     /** Triangle geometry with absolute packed Float32 or Float64 source positions. */
     readonly mesh: MeshGeometry;
+    /** Original I3S vector basis; overrides the codec default when supplied by a source. */
+    readonly normalReferenceFrame?: 'earth-centered' | 'vertex-reference-frame';
     /** Optional single material with an embedded base-color image, mapped explicitly by the source adapter. */
     readonly material?: MeshTileMaterial;
+    /** Explicit feature table and triangle associations, written as structural metadata. */
+    readonly features?: MeshTileFeatures;
     /** Finite xyz origin in the target frame, subtracted before float32 encoding. */
     readonly origin: readonly [number, number, number];
 }
@@ -35,7 +40,11 @@ export interface EncodedMeshConversionResource {
 /** Spatial policy used by the concrete mesh conversion codec. */
 export interface MeshConversionCodecOptions {
     /** Shared context that accepts absolute source positions and returns absolute target positions. */
-    readonly spatialContext: Tiles3DConversionSpatialContext;
+    readonly spatialContext: Tiles3DConversionSpatialContext | I3SConversionSpatialContext;
+    /** I3S vector frame when using an I3S context; defaults to earth-centered. */
+    readonly normalReferenceFrame?: 'earth-centered' | 'vertex-reference-frame';
+    /** Rebase around the transformed bounds center instead of the resource's explicit origin. */
+    readonly autoOrigin?: boolean;
     /** Maximum Euclidean reconstruction error per vertex, in target coordinate units. */
     readonly maxPositionError: number;
     /** Lossless Draco Edge Breaker is enabled by default; false emits uncompressed GLB geometry. */

package/dist/v5/mesh-features.d.ts

@@ -0,0 +1,9 @@
+import type { MeshGeometry } from '@loaders.gl/schema';
+import type { GLTFScenegraph } from '@loaders.gl/gltf';
+import type { I3SMeshFeatures } from '@loaders.gl/i3s';
+/** Explicit-schema Arrow features; stable identifiers are distinct from geometry row indices. */
+export type MeshTileFeatures = Pick<I3SMeshFeatures, 'batches' | 'triangleFeatureIndices' | 'featureIdField'>;
+/** Expands shared vertices so each complete triangle retains its own feature row through Draco. */
+export declare function prepareMeshFeatureGeometry(mesh: MeshGeometry, features?: MeshTileFeatures): MeshGeometry;
+/** Writes one inline structural metadata table without number coercion or nullable sentinel collisions. */
+export declare function encodeMeshFeatures(scenegraph: GLTFScenegraph, meshIndex: number, features?: MeshTileFeatures): void;

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

@@ -2,3 +2,5 @@ import type { GLTFMaterialPostprocessed } from '@loaders.gl/gltf';
 import type { MeshTileTexture } from './mesh.js';
 /** Maps a buffer-view or base64 PNG/JPEG image, sampling and UV transform without decoding pixels. */
 export declare function mapMeshSourceTexture(textureInfo: NonNullable<GLTFMaterialPostprocessed['pbrMetallicRoughness']>['baseColorTexture']): MeshTileTexture;
+/** Resolves one external encoded image through an explicitly supplied application reader. */
+export declare function resolveMeshSourceTexture(textureInfo: NonNullable<GLTFMaterialPostprocessed['pbrMetallicRoughness']>['baseColorTexture'], readExternalResource: ((uri: string, contentUri: string | undefined, signal?: AbortSignal) => Promise<Uint8Array>) | undefined, contentUri: string | undefined, signal?: AbortSignal): Promise<MeshTileTexture>;

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

@@ -1,7 +1,9 @@
+import type { GLTFMaterialPostprocessed } from '@loaders.gl/gltf';
 import type { Tileset3D, TilesetSourceMetadata } from '@loaders.gl/tiles';
 import type { TileConversionSource } from '@loaders.gl/tile-converter/v5/core';
 import type { TilesetConversionSourceOptions } from '@loaders.gl/tile-converter/v5/core';
 import type { MeshConversionInput } from './mesh-conversion.js';
+import type { MeshTileMaterial } from './mesh.js';
 import type { MeshSourceFeatureOptions } from './mesh-source-features.js';
 import type { I3SMeshFeatures } from '@loaders.gl/i3s';
 export type { MeshSourceFeatureOptions } from './mesh-source-features.js';
@@ -14,21 +16,26 @@ export interface MeshSourceResource extends MeshConversionInput {
 export interface MeshTilesetSourceOptions extends TilesetConversionSourceOptions {
     /** Required when the source has batch/structural metadata; no schema is inferred. */
     readonly features?: MeshSourceFeatureOptions;
+    /** Explicit bounded reader for external encoded images, relative to the content URI. */
+    readonly readExternalResource?: (uri: string, contentUri: string | undefined, signal?: AbortSignal) => Promise<Uint8Array>;
 }
 /**
  * Extracts static GLB/B3DM primitives from a native ECEF 3D Tiles runtime, including
  * optional buffer-view or base64 data-URI PNG/JPEG images, TEXCOORD_0, glTF sampling and
  * KHR_texture_transform controls on TEXCOORD_0. Decode content with
  * `gltf.excludeExtensions: {KHR_texture_transform: false}` to retain authored UVs/transforms.
+ * Triangle strips are expanded with alternating winding; the glTF loader already expands fans.
  * Shared traversal retains placement identity and unloads content according to the supplied policy.
  * The adapter applies node transforms, glTF up-axis correction, RTC translation, and tile placement
  * once, retaining Float64 absolute positions and inverse-transpose unit normals. Animation, skins,
  * morphs, instancing, broader texture semantics, unknown extensions, non-affine/mirrored
  * placements, and
  * metadata outside the declared feature profile fail explicitly. Multiple resources can be read;
- * the single-mesh I3S sink rejects a second resource and aborts the entire output.
+ * collection sinks accept bounded multiple placements; the compatibility single-mesh sink rejects a second resource.
  * @param tileset - Dedicated native EPSG:4978 runtime with decoded glTF content enabled.
  * @param options - Explicit feature schema/mapping and optional decoded-content cleanup.
  * @returns Portable conversion source; COLOR_0 is preserved for GLB, while I3S rejects vertex colors.
  */
 export declare function createMeshTilesetConversionSource(tileset: Tileset3D, options?: MeshTilesetSourceOptions): TileConversionSource<TilesetSourceMetadata, MeshSourceResource>;
+/** Maps supported PBR controls and an embedded base-color image, rejecting unmapped semantics. */
+export declare function mapMeshSourceMaterial(material: GLTFMaterialPostprocessed | undefined, readExternalResource: MeshTilesetSourceOptions['readExternalResource'], contentUri: string | undefined, signal?: AbortSignal): Promise<MeshTileMaterial | undefined>;

package/dist/v5/mesh.d.ts

@@ -1,5 +1,6 @@
 import { GLTFScenegraph } from '@loaders.gl/gltf';
-import type { MeshGeometry } from '@loaders.gl/schema';
+import type { MeshAttribute, MeshGeometry } from '@loaders.gl/schema';
+import { type MeshTileFeatures } from './mesh-features.js';
 /** Explicit glTF wrapping and filtering for the selected base-color image. */
 export interface MeshTileSampler {
     /** Horizontal wrapping: CLAMP_TO_EDGE, MIRRORED_REPEAT, or REPEAT; omitted values use REPEAT. */
@@ -50,6 +51,8 @@ export interface MeshTileMaterial {
 }
 /** Optional appearance for the single-mesh GLB profile. */
 export interface MeshTileOptions {
+    /** One explicit Arrow feature table with a row index per triangle. */
+    readonly features?: MeshTileFeatures;
     /** Explicitly selected material; other texture maps and material extensions are unsupported. */
     readonly material?: MeshTileMaterial;
 }
@@ -79,3 +82,5 @@ export declare function createMeshTileScenegraph(options: MeshTileOptions, geome
 export declare function finalizeMeshTileScenegraph(scenegraph: GLTFScenegraph, meshIndex: number): ArrayBuffer;
 /** Validates the shared mesh profile; spatial preparation may retain Float64 positions internally. */
 export declare function validateMeshGeometry(mesh: MeshGeometry, allowFloat64Positions?: boolean): MeshGeometry;
+/** Validates packed indices for triangle lists or strips, including glTF primitive-restart rules. */
+export declare function validateMeshIndices(attribute: MeshAttribute | undefined, vertexCount: number, primitiveMode?: 4 | 5): Uint8Array | Uint16Array | Uint32Array | undefined;