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

package/dist/ply-writer.cjs

@@ -0,0 +1,177 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/ply-writer.ts
+var ply_writer_exports = {};
+__export(ply_writer_exports, {
+  PLYWriter: () => PLYWriter
+});
+module.exports = __toCommonJS(ply_writer_exports);
+
+// src/ply/ply-writer.ts
+var import_schema_utils = require("@loaders.gl/core/schema-utils");
+var import_ply_format = require("./ply-format.cjs");
+var VERSION = true ? "5.0.0-beta.10" : "latest";
+var PLYWriter = {
+  ...import_ply_format.PLYFormat,
+  dataType: null,
+  batchType: null,
+  version: VERSION,
+  options: {
+    ply: {}
+  },
+  text: true,
+  encode: async (data, options) => encodePLYSync(data, options),
+  encodeSync: encodePLYSync,
+  encodeTextSync: encodePLY
+};
+function encodePLYSync(data, options) {
+  const text = encodePLY(data, options);
+  return new TextEncoder().encode(text).buffer;
+}
+function encodePLY(data, options) {
+  const mesh = (0, import_schema_utils.convertTableToMesh)(normalizeMeshArrowTable(data));
+  const positionAttribute = getRequiredAttribute(mesh, "POSITION");
+  const normalAttribute = mesh.attributes.NORMAL;
+  const textureCoordinateAttribute = mesh.attributes.TEXCOORD_0;
+  const colorAttribute = mesh.attributes.COLOR_0;
+  const customScalarAttributes = getCustomScalarAttributes(mesh);
+  const vertexCount = positionAttribute.value.length / positionAttribute.size;
+  const triangleIndices = getTriangleIndices(mesh, vertexCount);
+  const header = getPLYHeader(
+    vertexCount,
+    triangleIndices.length / 3,
+    Boolean(normalAttribute),
+    Boolean(textureCoordinateAttribute),
+    Boolean(colorAttribute),
+    customScalarAttributes
+  );
+  const rows = [];
+  for (let vertexIndex = 0; vertexIndex < vertexCount; vertexIndex++) {
+    const row = [
+      getComponent(positionAttribute, vertexIndex, 0),
+      getComponent(positionAttribute, vertexIndex, 1),
+      getComponent(positionAttribute, vertexIndex, 2)
+    ];
+    if (normalAttribute) {
+      row.push(
+        getComponent(normalAttribute, vertexIndex, 0),
+        getComponent(normalAttribute, vertexIndex, 1),
+        getComponent(normalAttribute, vertexIndex, 2)
+      );
+    }
+    if (textureCoordinateAttribute) {
+      row.push(
+        getComponent(textureCoordinateAttribute, vertexIndex, 0),
+        getComponent(textureCoordinateAttribute, vertexIndex, 1)
+      );
+    }
+    if (colorAttribute) {
+      row.push(
+        getColorByte(colorAttribute, vertexIndex, 0),
+        getColorByte(colorAttribute, vertexIndex, 1),
+        getColorByte(colorAttribute, vertexIndex, 2)
+      );
+    }
+    for (const [, attribute] of customScalarAttributes) {
+      row.push(getComponent(attribute, vertexIndex, 0));
+    }
+    rows.push(row.join(" "));
+  }
+  for (let triangleIndex = 0; triangleIndex < triangleIndices.length; triangleIndex += 3) {
+    rows.push(
+      `3 ${triangleIndices[triangleIndex]} ${triangleIndices[triangleIndex + 1]} ${triangleIndices[triangleIndex + 2]}`
+    );
+  }
+  return `${header.concat(rows).join("\n")}
+`;
+}
+function normalizeMeshArrowTable(data) {
+  if (!("attributes" in data)) {
+    return data;
+  }
+  return (0, import_schema_utils.convertMeshToArrowTableWrapper)(data);
+}
+function getRequiredAttribute(mesh, attributeName) {
+  const attribute = mesh.attributes[attributeName];
+  if (!attribute) {
+    throw new Error(`PLYWriter: ${attributeName} attribute is required`);
+  }
+  return attribute;
+}
+function getPLYHeader(vertexCount, faceCount, hasNormals, hasTextureCoordinates, hasColors, customScalarAttributes) {
+  const header = [
+    "ply",
+    "format ascii 1.0",
+    "comment generated by loaders.gl",
+    `element vertex ${vertexCount}`,
+    "property float x",
+    "property float y",
+    "property float z"
+  ];
+  if (hasNormals) {
+    header.push("property float nx", "property float ny", "property float nz");
+  }
+  if (hasTextureCoordinates) {
+    header.push("property float s", "property float t");
+  }
+  if (hasColors) {
+    header.push("property uchar red", "property uchar green", "property uchar blue");
+  }
+  for (const [attributeName] of customScalarAttributes) {
+    header.push(`property float ${attributeName}`);
+  }
+  if (faceCount > 0) {
+    header.push(`element face ${faceCount}`, "property list uchar int vertex_indices");
+  }
+  header.push("end_header");
+  return header;
+}
+function getCustomScalarAttributes(mesh) {
+  const reservedAttributeNames = /* @__PURE__ */ new Set(["POSITION", "NORMAL", "TEXCOORD_0", "COLOR_0"]);
+  return Object.entries(mesh.attributes).filter(
+    ([attributeName, attribute]) => !reservedAttributeNames.has(attributeName) && attribute.size === 1
+  );
+}
+function getComponent(attribute, vertexIndex, componentIndex) {
+  return attribute.value[vertexIndex * attribute.size + componentIndex] || 0;
+}
+function getColorByte(attribute, vertexIndex, componentIndex) {
+  const value = getComponent(attribute, vertexIndex, componentIndex);
+  const byteValue = attribute.normalized || value <= 1 ? value * 255 : value;
+  return Math.max(0, Math.min(255, Math.round(byteValue)));
+}
+function getTriangleIndices(mesh, vertexCount) {
+  if (mesh.indices?.value?.length) {
+    return Array.from(mesh.indices.value);
+  }
+  if (mesh.mode !== 4 && mesh.topology !== "triangle-list") {
+    return [];
+  }
+  const triangleIndices = [];
+  for (let vertexIndex = 0; vertexIndex + 2 < vertexCount; vertexIndex += 3) {
+    triangleIndices.push(vertexIndex, vertexIndex + 1, vertexIndex + 2);
+  }
+  return triangleIndices;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PLYWriter
+});
+//# sourceMappingURL=ply-writer.cjs.map

package/dist/ply-writer.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/ply-writer.ts", "../src/ply/ply-writer.ts"],
+  "sourcesContent": ["export * from './ply/ply-writer.js';\n", "// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {Table} from 'apache-arrow';\nimport type {WriterOptions, WriterWithEncoder} from '@loaders.gl/core/loader-utils';\nimport type {Mesh, MeshArrowTable, MeshAttribute} from '@loaders.gl/core/schema';\nimport {convertMeshToArrowTableWrapper, convertTableToMesh} from '@loaders.gl/core/schema-utils';\nimport {PLYFormat} from './ply-format';\n\n// __VERSION__ is injected by babel-plugin-version-inline\n// @ts-ignore TS2304: Cannot find name '__VERSION__'.\nconst VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';\n\n/** Options for `PLYWriter`. */\nexport type PLYWriterOptions = WriterOptions & {\n  /** Reserved for future PLY writer options. */\n  ply?: Record<string, never>;\n};\n\n/**\n * Writer for the PLY geometry format.\n */\nexport const PLYWriter = {\n  ...PLYFormat,\n  dataType: null as unknown as Mesh | MeshArrowTable | Table,\n  batchType: null as never,\n  version: VERSION,\n  options: {\n    ply: {}\n  },\n  text: true,\n  encode: async (data, options) => encodePLYSync(data, options),\n  encodeSync: encodePLYSync,\n  encodeTextSync: encodePLY\n} as const satisfies WriterWithEncoder<Mesh | MeshArrowTable | Table, never, PLYWriterOptions>;\n\n/** Encode mesh category data as PLY bytes. */\nfunction encodePLYSync(\n  data: Mesh | MeshArrowTable | Table,\n  options?: PLYWriterOptions\n): ArrayBuffer {\n  const text = encodePLY(data, options);\n  return new TextEncoder().encode(text).buffer;\n}\n\n/** Encode mesh category data as ASCII PLY text. */\nfunction encodePLY(data: Mesh | MeshArrowTable | Table, options?: PLYWriterOptions): string {\n  const mesh = convertTableToMesh(normalizeMeshArrowTable(data));\n  const positionAttribute = getRequiredAttribute(mesh, 'POSITION');\n  const normalAttribute = mesh.attributes.NORMAL;\n  const textureCoordinateAttribute = mesh.attributes.TEXCOORD_0;\n  const colorAttribute = mesh.attributes.COLOR_0;\n  const customScalarAttributes = getCustomScalarAttributes(mesh);\n  const vertexCount = positionAttribute.value.length / positionAttribute.size;\n  const triangleIndices = getTriangleIndices(mesh, vertexCount);\n  const header = getPLYHeader(\n    vertexCount,\n    triangleIndices.length / 3,\n    Boolean(normalAttribute),\n    Boolean(textureCoordinateAttribute),\n    Boolean(colorAttribute),\n    customScalarAttributes\n  );\n  const rows: string[] = [];\n\n  for (let vertexIndex = 0; vertexIndex < vertexCount; vertexIndex++) {\n    const row = [\n      getComponent(positionAttribute, vertexIndex, 0),\n      getComponent(positionAttribute, vertexIndex, 1),\n      getComponent(positionAttribute, vertexIndex, 2)\n    ];\n\n    if (normalAttribute) {\n      row.push(\n        getComponent(normalAttribute, vertexIndex, 0),\n        getComponent(normalAttribute, vertexIndex, 1),\n        getComponent(normalAttribute, vertexIndex, 2)\n      );\n    }\n\n    if (textureCoordinateAttribute) {\n      row.push(\n        getComponent(textureCoordinateAttribute, vertexIndex, 0),\n        getComponent(textureCoordinateAttribute, vertexIndex, 1)\n      );\n    }\n\n    if (colorAttribute) {\n      row.push(\n        getColorByte(colorAttribute, vertexIndex, 0),\n        getColorByte(colorAttribute, vertexIndex, 1),\n        getColorByte(colorAttribute, vertexIndex, 2)\n      );\n    }\n\n    for (const [, attribute] of customScalarAttributes) {\n      row.push(getComponent(attribute, vertexIndex, 0));\n    }\n\n    rows.push(row.join(' '));\n  }\n\n  for (let triangleIndex = 0; triangleIndex < triangleIndices.length; triangleIndex += 3) {\n    rows.push(\n      `3 ${triangleIndices[triangleIndex]} ${triangleIndices[triangleIndex + 1]} ${\n        triangleIndices[triangleIndex + 2]\n      }`\n    );\n  }\n\n  return `${header.concat(rows).join('\\n')}\\n`;\n}\n\n/** Return mesh data as a MeshArrowTable, converting plain Mesh data first. */\nfunction normalizeMeshArrowTable(data: Mesh | MeshArrowTable | Table): MeshArrowTable | Table {\n  if (!('attributes' in data)) {\n    return data;\n  }\n  return convertMeshToArrowTableWrapper(data as Mesh);\n}\n\n/** Return a required mesh attribute or throw a format-specific error. */\nfunction getRequiredAttribute(mesh: Mesh, attributeName: string): MeshAttribute {\n  const attribute = mesh.attributes[attributeName];\n  if (!attribute) {\n    throw new Error(`PLYWriter: ${attributeName} attribute is required`);\n  }\n  return attribute;\n}\n\n/** Return the ASCII PLY header lines. */\nfunction getPLYHeader(\n  vertexCount: number,\n  faceCount: number,\n  hasNormals: boolean,\n  hasTextureCoordinates: boolean,\n  hasColors: boolean,\n  customScalarAttributes: [string, MeshAttribute][]\n): string[] {\n  const header = [\n    'ply',\n    'format ascii 1.0',\n    'comment generated by loaders.gl',\n    `element vertex ${vertexCount}`,\n    'property float x',\n    'property float y',\n    'property float z'\n  ];\n\n  if (hasNormals) {\n    header.push('property float nx', 'property float ny', 'property float nz');\n  }\n\n  if (hasTextureCoordinates) {\n    header.push('property float s', 'property float t');\n  }\n\n  if (hasColors) {\n    header.push('property uchar red', 'property uchar green', 'property uchar blue');\n  }\n\n  for (const [attributeName] of customScalarAttributes) {\n    header.push(`property float ${attributeName}`);\n  }\n\n  if (faceCount > 0) {\n    header.push(`element face ${faceCount}`, 'property list uchar int vertex_indices');\n  }\n\n  header.push('end_header');\n  return header;\n}\n\n/** Return additional one-component attributes that can be represented as scalar PLY properties. */\nfunction getCustomScalarAttributes(mesh: Mesh): [string, MeshAttribute][] {\n  const reservedAttributeNames = new Set(['POSITION', 'NORMAL', 'TEXCOORD_0', 'COLOR_0']);\n  return Object.entries(mesh.attributes).filter(\n    ([attributeName, attribute]) =>\n      !reservedAttributeNames.has(attributeName) && attribute.size === 1\n  );\n}\n\n/** Return a single attribute component with 0 as the missing component fallback. */\nfunction getComponent(\n  attribute: MeshAttribute,\n  vertexIndex: number,\n  componentIndex: number\n): number {\n  return attribute.value[vertexIndex * attribute.size + componentIndex] || 0;\n}\n\n/** Return one color component as an unsigned byte. */\nfunction getColorByte(\n  attribute: MeshAttribute,\n  vertexIndex: number,\n  componentIndex: number\n): number {\n  const value = getComponent(attribute, vertexIndex, componentIndex);\n  const byteValue = attribute.normalized || value <= 1 ? value * 255 : value;\n  return Math.max(0, Math.min(255, Math.round(byteValue)));\n}\n\n/** Return triangle indices for indexed or sequential triangle-list meshes. */\nfunction getTriangleIndices(mesh: Mesh, vertexCount: number): number[] {\n  if (mesh.indices?.value?.length) {\n    return Array.from(mesh.indices.value);\n  }\n\n  if (mesh.mode !== 4 && mesh.topology !== 'triangle-list') {\n    return [];\n  }\n\n  const triangleIndices: number[] = [];\n  for (let vertexIndex = 0; vertexIndex + 2 < vertexCount; vertexIndex += 3) {\n    triangleIndices.push(vertexIndex, vertexIndex + 1, vertexIndex + 2);\n  }\n  return triangleIndices;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/ply-writer.d.ts

@@ -0,0 +1,2 @@
+export * from './ply/ply-writer.js';
+//# sourceMappingURL=ply-writer.d.ts.map

package/dist/ply-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ply-writer.d.ts","sourceRoot":"","sources":["../src/ply-writer.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/ply-writer.js

@@ -0,0 +1,2 @@
+export * from './ply/ply-writer.js';
+//# sourceMappingURL=ply-writer.js.map

package/dist/ply-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ply-writer.js","sourceRoot":"","sources":["../src/ply-writer.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,240 @@
 {
   "name": "@loaders.gl/pointclouds",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "5.0.0-beta.10",
+  "description": "LAS, LAZ, PCD, and PLY point cloud and mesh loaders and writers",
+  "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",
+    "loaders.gl",
+    "PCD",
+    "PLY"
+  ],
+  "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-copc-loader-types": {
+      "types": "./dist/las-copc-loader-types.d.ts",
+      "import": "./dist/las-copc-loader-types.js",
+      "require": "./dist/las-copc-loader-types.cjs"
+    },
+    "./las-copc-loader": {
+      "types": "./dist/las-copc-loader.d.ts",
+      "import": "./dist/las-copc-loader.js",
+      "require": "./dist/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-loader-types": {
+      "types": "./dist/las-loader-types.d.ts",
+      "import": "./dist/las-loader-types.js",
+      "require": "./dist/las-loader-types.cjs"
+    },
+    "./las-loader": {
+      "types": "./dist/las-loader.d.ts",
+      "import": "./dist/las-loader.js",
+      "require": "./dist/las-loader.cjs"
+    },
+    "./las-writer": {
+      "types": "./dist/las-writer.d.ts",
+      "import": "./dist/las-writer.js",
+      "require": "./dist/las-writer.cjs"
+    },
+    "./laz-rs-loader-types": {
+      "types": "./dist/laz-rs-loader-types.d.ts",
+      "import": "./dist/laz-rs-loader-types.js",
+      "require": "./dist/laz-rs-loader-types.cjs"
+    },
+    "./laz-rs-loader": {
+      "types": "./dist/laz-rs-loader.d.ts",
+      "import": "./dist/laz-rs-loader.js",
+      "require": "./dist/laz-rs-loader.cjs"
+    },
+    "./lazperf-loader-types": {
+      "types": "./dist/lazperf-loader-types.d.ts",
+      "import": "./dist/lazperf-loader-types.js",
+      "require": "./dist/lazperf-loader-types.cjs"
+    },
+    "./lazperf-loader": {
+      "types": "./dist/lazperf-loader.d.ts",
+      "import": "./dist/lazperf-loader.js",
+      "require": "./dist/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-loader-types": {
+      "types": "./dist/pcd-loader-types.d.ts",
+      "import": "./dist/pcd-loader-types.js",
+      "require": "./dist/pcd-loader-types.cjs"
+    },
+    "./pcd-loader": {
+      "types": "./dist/pcd-loader.d.ts",
+      "import": "./dist/pcd-loader.js",
+      "require": "./dist/pcd-loader.cjs"
+    },
+    "./pcd-writer": {
+      "types": "./dist/pcd-writer.d.ts",
+      "import": "./dist/pcd-writer.js",
+      "require": "./dist/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-loader-types": {
+      "types": "./dist/ply-loader-types.d.ts",
+      "import": "./dist/ply-loader-types.js",
+      "require": "./dist/ply-loader-types.cjs"
+    },
+    "./ply-loader": {
+      "types": "./dist/ply-loader.d.ts",
+      "import": "./dist/ply-loader.js",
+      "require": "./dist/ply-loader.cjs"
+    },
+    "./ply-writer": {
+      "types": "./dist/ply-writer.d.ts",
+      "import": "./dist/ply-writer.js",
+      "require": "./dist/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.10",
+    "apache-arrow": ">= 17.0.0"
+  },
+  "peerDependencies": {
+    "@loaders.gl/core": "~5.0.0-alpha.0"
+  },
+  "optionalDependencies": {
+    "copc": "0.0.8",
+    "laz-perf": "^0.0.7"
+  },
+  "gitHead": "efdd84034c25e2e5dbb41bc88b75af56cb2176da"
+}

package/src/index.ts

@@ -0,0 +1,19 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+export {LASLoader} 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} 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} 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,38 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+export type {LASLoaderOptions} 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,66 @@
+// 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';
+
+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 {Table, RecordBatch} from 'apache-arrow';
+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-copc-loader');
+    return LASCOPCLoaderWithParser;
+  }
+} as const satisfies Loader<LASMesh | Table, LASMesh | RecordBatch, 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 {Table, RecordBatch} from 'apache-arrow';
+import {getLASRecordBatches, toPublicLASResult} from './las-loader';
+import type {MeshArrowTable} from '@loaders.gl/core/schema';
+import {convertMeshToArrowTableWrapper, 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) =>
+    toPublicLASResult(convertLASMesh(await parseCOPCLAS(arrayBuffer, options), options)),
+  parseInBatches: (arrayBufferIterator, options?: LASLoaderOptions) =>
+    convertLASMeshBatches(parseCOPCLASInBatches(arrayBufferIterator, options), options)
+} as const satisfies LoaderWithParser<LASMesh | Table, LASMesh | RecordBatch, LASLoaderOptions>;
+
+function convertLASMesh(mesh: LASMesh, options?: LASLoaderOptions): LASMesh | MeshArrowTable {
+  const formattedMesh = formatLASMeshColors(mesh, options?.las?.colorFormat || 'uint8norm');
+  const table = convertMeshToArrowTableWrapper(formattedMesh) as MeshArrowTable;
+  if (getLASShape(options) === 'arrow') {
+    return {...table, loaderData: mesh.loaderData};
+  }
+  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 | RecordBatch> {
+  for await (const mesh of meshBatches) {
+    const result = convertLASMesh(mesh, options);
+    if ('shape' in result) yield* getLASRecordBatches(result);
+    else yield result;
+  }
+}