@loaders.gl/pointclouds 0.0.0-stage → 5.0.0-beta.1

package/package.json

@@ -1,6 +1,236 @@
 {
   "name": "@loaders.gl/pointclouds",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "5.0.0-beta.1",
+  "description": "LAS, LAZ, PCD and PLY point-cloud and mesh loaders",
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/visgl/loaders.gl"
+  },
+  "keywords": [
+    "webgl",
+    "loader",
+    "3d",
+    "mesh",
+    "point cloud",
+    "LAS",
+    "LAZ"
+  ],
+  "types": "dist/index.d.ts",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./las": {
+      "types": "./dist/las/index.d.ts",
+      "import": "./dist/las/index.js",
+      "require": "./dist/las/index.cjs"
+    },
+    "./las/bundled": {
+      "types": "./dist/las/bundled.d.ts",
+      "import": "./dist/las/bundled.js",
+      "require": "./dist/las/bundled.cjs"
+    },
+    "./las/index": {
+      "types": "./dist/las/index.d.ts",
+      "import": "./dist/las/index.js",
+      "require": "./dist/las/index.cjs"
+    },
+    "./las/las-copc-loader-types": {
+      "types": "./dist/las/las-copc-loader-types.d.ts",
+      "import": "./dist/las/las-copc-loader-types.js",
+      "require": "./dist/las/las-copc-loader-types.cjs"
+    },
+    "./las/las-copc-loader": {
+      "types": "./dist/las/las-copc-loader.d.ts",
+      "import": "./dist/las/las-copc-loader.js",
+      "require": "./dist/las/las-copc-loader.cjs"
+    },
+    "./las/las-format": {
+      "types": "./dist/las/las-format.d.ts",
+      "import": "./dist/las/las-format.js",
+      "require": "./dist/las/las-format.cjs"
+    },
+    "./las/las-loader-shared": {
+      "types": "./dist/las/las-loader-shared.d.ts",
+      "import": "./dist/las/las-loader-shared.js",
+      "require": "./dist/las/las-loader-shared.cjs"
+    },
+    "./las/las-loader-types": {
+      "types": "./dist/las/las-loader-types.d.ts",
+      "import": "./dist/las/las-loader-types.js",
+      "require": "./dist/las/las-loader-types.cjs"
+    },
+    "./las/las-loader": {
+      "types": "./dist/las/las-loader.d.ts",
+      "import": "./dist/las/las-loader.js",
+      "require": "./dist/las/las-loader.cjs"
+    },
+    "./las/las-writer": {
+      "types": "./dist/las/las-writer.d.ts",
+      "import": "./dist/las/las-writer.js",
+      "require": "./dist/las/las-writer.cjs"
+    },
+    "./las/laz-rs-loader-types": {
+      "types": "./dist/las/laz-rs-loader-types.d.ts",
+      "import": "./dist/las/laz-rs-loader-types.js",
+      "require": "./dist/las/laz-rs-loader-types.cjs"
+    },
+    "./las/laz-rs-loader": {
+      "types": "./dist/las/laz-rs-loader.d.ts",
+      "import": "./dist/las/laz-rs-loader.js",
+      "require": "./dist/las/laz-rs-loader.cjs"
+    },
+    "./las/lazperf-loader-types": {
+      "types": "./dist/las/lazperf-loader-types.d.ts",
+      "import": "./dist/las/lazperf-loader-types.js",
+      "require": "./dist/las/lazperf-loader-types.cjs"
+    },
+    "./las/lazperf-loader": {
+      "types": "./dist/las/lazperf-loader.d.ts",
+      "import": "./dist/las/lazperf-loader.js",
+      "require": "./dist/las/lazperf-loader.cjs"
+    },
+    "./las/unbundled": {
+      "types": "./dist/las/unbundled.d.ts",
+      "import": "./dist/las/unbundled.js",
+      "require": "./dist/las/unbundled.cjs"
+    },
+    "./pcd": {
+      "types": "./dist/pcd/index.d.ts",
+      "import": "./dist/pcd/index.js",
+      "require": "./dist/pcd/index.cjs"
+    },
+    "./pcd/bundled": {
+      "types": "./dist/pcd/bundled.d.ts",
+      "import": "./dist/pcd/bundled.js",
+      "require": "./dist/pcd/bundled.cjs"
+    },
+    "./pcd/index": {
+      "types": "./dist/pcd/index.d.ts",
+      "import": "./dist/pcd/index.js",
+      "require": "./dist/pcd/index.cjs"
+    },
+    "./pcd/pcd-format": {
+      "types": "./dist/pcd/pcd-format.d.ts",
+      "import": "./dist/pcd/pcd-format.js",
+      "require": "./dist/pcd/pcd-format.cjs"
+    },
+    "./pcd/pcd-loader-types": {
+      "types": "./dist/pcd/pcd-loader-types.d.ts",
+      "import": "./dist/pcd/pcd-loader-types.js",
+      "require": "./dist/pcd/pcd-loader-types.cjs"
+    },
+    "./pcd/pcd-loader": {
+      "types": "./dist/pcd/pcd-loader.d.ts",
+      "import": "./dist/pcd/pcd-loader.js",
+      "require": "./dist/pcd/pcd-loader.cjs"
+    },
+    "./pcd/pcd-writer": {
+      "types": "./dist/pcd/pcd-writer.d.ts",
+      "import": "./dist/pcd/pcd-writer.js",
+      "require": "./dist/pcd/pcd-writer.cjs"
+    },
+    "./pcd/unbundled": {
+      "types": "./dist/pcd/unbundled.d.ts",
+      "import": "./dist/pcd/unbundled.js",
+      "require": "./dist/pcd/unbundled.cjs"
+    },
+    "./ply": {
+      "types": "./dist/ply/index.d.ts",
+      "import": "./dist/ply/index.js",
+      "require": "./dist/ply/index.cjs"
+    },
+    "./ply/bundled": {
+      "types": "./dist/ply/bundled.d.ts",
+      "import": "./dist/ply/bundled.js",
+      "require": "./dist/ply/bundled.cjs"
+    },
+    "./ply/index": {
+      "types": "./dist/ply/index.d.ts",
+      "import": "./dist/ply/index.js",
+      "require": "./dist/ply/index.cjs"
+    },
+    "./ply/ply-format": {
+      "types": "./dist/ply/ply-format.d.ts",
+      "import": "./dist/ply/ply-format.js",
+      "require": "./dist/ply/ply-format.cjs"
+    },
+    "./ply/ply-loader-types": {
+      "types": "./dist/ply/ply-loader-types.d.ts",
+      "import": "./dist/ply/ply-loader-types.js",
+      "require": "./dist/ply/ply-loader-types.cjs"
+    },
+    "./ply/ply-loader": {
+      "types": "./dist/ply/ply-loader.d.ts",
+      "import": "./dist/ply/ply-loader.js",
+      "require": "./dist/ply/ply-loader.cjs"
+    },
+    "./ply/ply-writer": {
+      "types": "./dist/ply/ply-writer.d.ts",
+      "import": "./dist/ply/ply-writer.js",
+      "require": "./dist/ply/ply-writer.cjs"
+    },
+    "./ply/unbundled": {
+      "types": "./dist/ply/unbundled.d.ts",
+      "import": "./dist/ply/unbundled.js",
+      "require": "./dist/ply/unbundled.cjs"
+    },
+    "./las-worker.js": {
+      "import": "./dist/las-worker.js"
+    },
+    "./pcd-worker.js": {
+      "import": "./dist/pcd-worker.js"
+    },
+    "./ply-worker.js": {
+      "import": "./dist/ply-worker.js"
+    }
+  },
+  "sideEffects": false,
+  "browser": {
+    "crypto": false,
+    "fs": false,
+    "path": false,
+    "ws": false
+  },
+  "files": [
+    "src",
+    "dist",
+    "README.md",
+    "LAS-README.md",
+    "PCD-README.md",
+    "PLY-README.md",
+    "LICENSE",
+    "THIRD-PARTY-NOTICES.md",
+    "third-party-licenses"
+  ],
+  "scripts": {
+    "copy-wasm-files-las": "cp src/las/libs/laz-rs-wasm/*.wasm* dist/las/libs/laz-rs-wasm/",
+    "build-worker-las": "esbuild src/las/workers/las-worker.ts --bundle --outfile=dist/las-worker.js --define:__VERSION__=\\\"$npm_package_version\\\"",
+    "build-worker-pcd": "node ../../scripts/build-codec-worker.mjs src/pcd/workers/pcd-worker.ts --bundle --outfile=dist/pcd-worker.js --define:__VERSION__=\\\"$npm_package_version\\\"",
+    "build-worker-ply": "node ../../scripts/build-codec-worker.mjs src/ply/workers/ply-worker.ts --bundle --outfile=dist/ply-worker.js --define:__VERSION__=\\\"$npm_package_version\\\"",
+    "build-format-subpaths": "node ../../scripts/build-format-subpaths.mjs",
+    "pre-build": "npm run copy-wasm-files-las && npm run build-worker-las && npm run build-worker-pcd && npm run build-worker-ply && npm run build-format-subpaths && npm run build-bundle && npm run build-bundle-dev",
+    "build-bundle": "node ../../scripts/build-codec-bundle.mjs ./bundle.ts --output=dist/dist.min.js",
+    "build-bundle-dev": "node ../../scripts/build-codec-bundle.mjs ./bundle.ts --env=dev --output=dist/dist.dev.js"
+  },
+  "dependencies": {
+    "@math.gl/geospatial": "5.0.0-beta.1",
+    "apache-arrow": ">= 17.0.0"
+  },
+  "peerDependencies": {
+    "@loaders.gl/core": "~5.0.0-alpha.0"
+  },
+  "optionalDependencies": {
+    "copc": "0.0.8",
+    "laz-perf": "^0.0.7"
+  }
+}

package/src/index.ts

@@ -0,0 +1,19 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+export {LASLoader, LASWorkerLoader} from './las/las-loader-types';
+export type {LASLoaderOptions} from './las/las-loader-types';
+export {LASWriter} from './las/las-writer';
+export type {LASWriterOptions} from './las/las-writer';
+export {LASFormat} from './las/las-format';
+export {PCDLoader, PCDWorkerLoader} from './pcd/pcd-loader-types';
+export type {PCDLoaderOptions} from './pcd/pcd-loader-types';
+export {PCDWriter} from './pcd/pcd-writer';
+export type {PCDWriterOptions} from './pcd/pcd-writer';
+export {PCDFormat} from './pcd/pcd-format';
+export {PLYLoader, PLYWorkerLoader} from './ply/ply-loader-types';
+export type {PLYLoaderOptions} from './ply/ply-loader-types';
+export {PLYWriter} from './ply/ply-writer';
+export type {PLYWriterOptions} from './ply/ply-writer';
+export {PLYFormat} from './ply/ply-format';

package/src/las/bundled.ts

@@ -0,0 +1,39 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+export type {LASLoaderOptions} from './las-loader-types';
+export {LASWorkerLoader} from './las-loader-types';
+export {LASLoaderWithParser as LASLoader} from './las-loader';
+export {LASCOPCLoaderWithParser as LASCOPCLoader} from './las-copc-loader';
+export {LAZPerfLoaderWithParser as LAZPerfLoader} from './lazperf-loader';
+export {LAZRsLoaderWithParser as LAZRsLoader} from './laz-rs-loader';
+export {decodeLAZFileInBatches} from './lib/typescript/parse-las';
+export {
+  decodeLASWaveformSamples,
+  getLASWaveformStorage,
+  parseLASWaveformPacketReference,
+  readLASWaveformPacket,
+  readLASWaveformPackets,
+  scaleLASWaveformSamples
+} from './lib/las-waveform';
+export type {
+  LASWaveformPacket,
+  LASWaveformPacketReference,
+  LASWaveformReadOptions,
+  LASWaveformStorage
+} from './lib/las-waveform';
+export {
+  NeedsMoreData,
+  createLAZChunkDecoder,
+  createLAZChunkEncoder,
+  decodeLAZChunk,
+  decodeLAZChunkInBatches,
+  encodeLAZChunk
+} from '@loaders.gl/core/loader-utils';
+export type {
+  FeedableLAZChunkDecoder,
+  FeedableLAZChunkEncoder,
+  LAZChunkDecoderOptions,
+  LAZChunkMetadata
+} from '@loaders.gl/core/loader-utils';

package/src/las/index.ts

@@ -0,0 +1,70 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+// LASLoader
+
+export {LASFormat} from './las-format';
+
+export type {LASColumnName, LASLoaderOptions} from './las-loader-types';
+
+export type {LASExtraBytesWriter, LASWriterOptions} from './las-writer';
+export {LASWriter} from './las-writer';
+export type {
+  LASExtendedVariableLengthRecord,
+  LASExtraBytesDescriptor,
+  LASGeoTIFFKey,
+  LASGeoTIFFKeyDirectory,
+  LASHeader,
+  LASMetadata,
+  LASMesh,
+  LASVariableLengthRecord,
+  LASWaveformPacketDescriptor
+} from './lib/las-types';
+export {
+  decodeLASWaveformSamples,
+  getLASWaveformStorage,
+  parseLASWaveformPacketReference,
+  readLASWaveformPacket,
+  readLASWaveformPackets,
+  scaleLASWaveformSamples
+} from './lib/las-waveform';
+export type {
+  LASWaveformPacket,
+  LASWaveformPacketReference,
+  LASWaveformReadOptions,
+  LASWaveformStorage
+} from './lib/las-waveform';
+export {
+  createLASTypedExtraBytesAttributes,
+  createLASTypedExtraBytesValue,
+  parseLASExtraBytes,
+  populateLASTypedExtraBytes
+} from './lib/las-extra-bytes';
+export type {
+  LASTypedExtraBytesAttribute,
+  LASTypedExtraBytesValue
+} from './lib/las-extra-bytes';
+
+export {LASLoader} from './las-loader-types';
+export {decodeLAZFileInBatches} from './lib/typescript/parse-las';
+export {
+  NeedsMoreData,
+  createLAZChunkDecoder,
+  createLAZChunkEncoder,
+  decodeLAZChunk,
+  decodeLAZChunkInBatches,
+  encodeLAZChunk
+} from '@loaders.gl/core/loader-utils';
+export type {
+  FeedableLAZChunkDecoder,
+  FeedableLAZChunkEncoder,
+  LAZChunkDecoderOptions,
+  LAZChunkMetadata
+} from '@loaders.gl/core/loader-utils';
+
+// DEPRECATED EXPORTS
+/** @deprecated Use LASLoader. */
+export {LASWorkerLoader} from './las-loader-types';
+
+export type {LASCompatibilityLayout} from './lib/las-compatibility';

package/src/las/las-copc-loader-types.ts

@@ -0,0 +1,18 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {Loader} from '@loaders.gl/core/loader-utils';
+import type {MeshArrowTable} from '@loaders.gl/core/schema';
+import {LAS_LOADER_METADATA, type LASLoaderOptions} from './las-loader-shared';
+import type {LASMesh} from './lib/las-types';
+
+/** Metadata-only LAS/LAZ loader variant using the COPC package decoder. */
+export const LASCOPCLoader = {
+  ...LAS_LOADER_METADATA,
+  name: 'LAS (COPC)',
+  preload: async () => {
+    const {LASCOPCLoaderWithParser} = await import('@loaders.gl/pointclouds/las/las-copc-loader');
+    return LASCOPCLoaderWithParser;
+  }
+} as const satisfies Loader<LASMesh | MeshArrowTable, LASMesh | MeshArrowTable, LASLoaderOptions>;

package/src/las/las-copc-loader.ts

@@ -0,0 +1,61 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+// LASER (LAS) FILE FORMAT
+import type {LoaderWithParser} from '@loaders.gl/core/loader-utils';
+import type {MeshArrowTable} from '@loaders.gl/core/schema';
+import {convertMeshToTable, convertTableToMesh} from '@loaders.gl/core/schema-utils';
+import {
+  formatLASMeshColors,
+  getLASShape,
+  LAS_LOADER_METADATA,
+  type LASLoaderOptions
+} from './las-loader-shared';
+import type {LASMesh} from './lib/las-types';
+import {parseCOPCLAS, parseCOPCLASInBatches} from './lib/copc/parse-las';
+
+/**
+ * LAS/LAZ loader variant using the laz-perf decoder from the COPC package.
+ */
+export const LASCOPCLoaderWithParser = {
+  ...LAS_LOADER_METADATA,
+  name: 'LAS (COPC)',
+  parse: async (arrayBuffer: ArrayBuffer, options?: LASLoaderOptions) =>
+    convertLASMesh(await parseCOPCLAS(arrayBuffer, options), options),
+  parseInBatches: (arrayBufferIterator, options?: LASLoaderOptions) =>
+    convertLASMeshBatches(parseCOPCLASInBatches(arrayBufferIterator, options), options)
+} as const satisfies LoaderWithParser<
+  LASMesh | MeshArrowTable,
+  LASMesh | MeshArrowTable,
+  LASLoaderOptions
+>;
+
+function convertLASMesh(mesh: LASMesh, options?: LASLoaderOptions): LASMesh | MeshArrowTable {
+  const formattedMesh = formatLASMeshColors(mesh, options?.las?.colorFormat || 'uint8norm');
+  const table = convertMeshToTable(formattedMesh, 'arrow-table') as MeshArrowTable;
+  if (getLASShape(options) === 'arrow-table') {
+    return table;
+  }
+  return {
+    ...(convertTableToMesh(table) as LASMesh),
+    loader: mesh.loader,
+    loaderData: mesh.loaderData,
+    progress: (mesh as LASMesh & {progress?: number}).progress
+  } as LASMesh & {progress?: number};
+}
+
+/**
+ * Convert LAS mesh batches to the requested output shape.
+ * @param meshBatches Decoded LAS mesh batches
+ * @param options LAS loader options
+ * @returns Converted LAS batches
+ */
+async function* convertLASMeshBatches(
+  meshBatches: AsyncIterable<LASMesh>,
+  options?: LASLoaderOptions
+): AsyncIterable<LASMesh | MeshArrowTable> {
+  for await (const mesh of meshBatches) {
+    yield convertLASMesh(mesh, options);
+  }
+}

package/src/las/las-format.ts

@@ -0,0 +1,21 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {Format} from '@loaders.gl/core/loader-utils';
+
+/**
+ * LAS (LASer) point cloud format
+ */
+export const LASFormat = {
+  name: 'LAS',
+  id: 'las',
+  module: 'pointclouds',
+  encoding: 'binary',
+  format: 'las',
+  extensions: ['las', 'laz'], // LAZ is the "compressed" flavor of LAS,
+  mimeTypes: ['application/octet-stream'], // TODO - text version?
+  text: false,
+  binary: true,
+  tests: ['LASF']
+} as const satisfies Format;

package/src/las/las-loader-shared.ts

@@ -0,0 +1,124 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {Loader, LoaderOptions} from '@loaders.gl/core/loader-utils';
+import {convertColorArrayToFloat16, convertColorArrayToFloat32} from '@loaders.gl/core/schema';
+import type {MeshArrowTable} from '@loaders.gl/core/schema';
+import {LASFormat} from './las-format';
+import type {LASMesh} from './lib/las-types';
+
+// __VERSION__ is injected by babel-plugin-version-inline
+// @ts-ignore TS2304: Cannot find name '__VERSION__'.
+const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
+
+/** Arrow column names that can be selected from LAS point records. */
+export type LASColumnName =
+  | 'POSITION'
+  | 'intensity'
+  | 'classification'
+  | 'synthetic'
+  | 'keyPoint'
+  | 'withheld'
+  | 'overlap'
+  | 'COLOR_0'
+  | 'GPS_TIME'
+  | 'NIR'
+  | 'scanAngle'
+  | 'userData'
+  | 'pointSourceId'
+  | 'returnNumber'
+  | 'numberOfReturns'
+  | 'scannerChannel'
+  | 'scanDirectionFlag'
+  | 'edgeOfFlightLine'
+  | 'WAVEFORM'
+  | 'EXTRA_BYTES';
+
+/** Options accepted by LAS loader implementations. */
+export type LASLoaderOptions = LoaderOptions & {
+  las?: {
+    /** Output representation. */
+    shape?: 'mesh' | 'columnar-table' | 'arrow-table';
+    /** Store positions in 64-bit floating point arrays. */
+    fp64?: boolean;
+    /** Output color depth or automatic source-depth detection. */
+    colorDepth?: number | string;
+    /** Color storage format. Defaults to uint8norm for backwards compatibility. */
+    colorFormat?: 'uint8norm' | 'float16' | 'float32';
+    /** Arrow columns to decode. POSITION is always included. */
+    columns?: readonly LASColumnName[];
+    /** Decode Extra Bytes descriptors into typed attributes instead of raw bytes. */
+    extraBytes?: 'raw' | 'typed';
+    /** Recover fixed-size LAZ chunks when the LASzip pointer marks an interrupted writer. */
+    recoverMissingChunkTable?: boolean;
+    /** Restore modern fields in LASzip compatibility-mode files, or retain their legacy columns. */
+    compatibilityMode?: 'auto' | 'raw';
+    /** Override the URL to the worker bundle. */
+    workerUrl?: string;
+  };
+  /** Called as point data is decoded on the main thread. */
+  onProgress?: Function;
+};
+
+/** Default output shape for LAS and LAZ loaders. */
+export const DEFAULT_LAS_SHAPE = 'arrow-table' as const;
+
+/** Resolve the LAS output shape, including the Arrow-primary default. */
+export function getLASShape(options?: LASLoaderOptions): 'mesh' | 'columnar-table' | 'arrow-table' {
+  return options?.las?.shape || DEFAULT_LAS_SHAPE;
+}
+
+/** Parser-independent LAS loader metadata shared by each loader variant. */
+export const LAS_LOADER_METADATA = {
+  ...LASFormat,
+
+  dataType: null as unknown as LASMesh | MeshArrowTable,
+  batchType: null as unknown as LASMesh | MeshArrowTable,
+
+  version: VERSION,
+  worker: false,
+  options: {
+    las: {
+      shape: DEFAULT_LAS_SHAPE,
+      fp64: false,
+      colorDepth: 8,
+      colorFormat: 'uint8norm',
+      columns: undefined,
+      extraBytes: 'raw',
+      recoverMissingChunkTable: false,
+      compatibilityMode: 'auto'
+    }
+  }
+} as const satisfies Loader<LASMesh | MeshArrowTable, LASMesh | MeshArrowTable, LASLoaderOptions>;
+
+/** Apply the requested normalized color representation to a decoded LAS mesh. */
+export function formatLASMeshColors(
+  mesh: LASMesh,
+  colorFormat: 'uint8norm' | 'float16' | 'float32'
+): LASMesh {
+  if (colorFormat === 'uint8norm' || !mesh.attributes.COLOR_0) {
+    return mesh;
+  }
+
+  const colorAttribute = mesh.attributes.COLOR_0;
+  const sourceScale = colorAttribute.value instanceof Uint16Array ? 65535 : 255;
+  const value =
+    colorFormat === 'float16'
+      ? convertColorArrayToFloat16(colorAttribute.value, sourceScale)
+      : convertColorArrayToFloat32(colorAttribute.value, sourceScale);
+  const attributes = {...mesh.attributes};
+
+  for (const [attributeName, attribute] of Object.entries(attributes)) {
+    if (attribute.value === colorAttribute.value) {
+      attributes[attributeName] = {
+        ...attribute,
+        value,
+        normalized: false,
+        ...(colorFormat === 'float16' ? {componentType: 'float16' as const} : {})
+      };
+    }
+  }
+
+  return {...mesh, attributes};
+}

package/src/las/las-loader-types.ts

@@ -0,0 +1,27 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {Loader} from '@loaders.gl/core/loader-utils';
+import type {MeshArrowTable} from '@loaders.gl/core/schema';
+import type {LASMesh} from './lib/las-types';
+import {LAS_LOADER_METADATA, type LASLoaderOptions} from './las-loader-shared';
+
+export type {LASColumnName, LASLoaderOptions} from './las-loader-shared';
+
+/** Preloads the parser-bearing primary TypeScript LAS loader implementation. */
+async function preload() {
+  const {LASLoaderWithParser} = await import('@loaders.gl/pointclouds/las/las-loader');
+  return LASLoaderWithParser;
+}
+
+/** Metadata-only loader for the LAS (LASer) point cloud format. */
+export const LASLoader = {
+  ...LAS_LOADER_METADATA,
+  worker: true,
+  workerInBatches: true,
+  preload
+} as const satisfies Loader<LASMesh | MeshArrowTable, LASMesh | MeshArrowTable, LASLoaderOptions>;
+
+/** @deprecated Use LASLoader. */
+export const LASWorkerLoader = LASLoader;