@loaders.gl/pointclouds 5.0.0-beta.1 → 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": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACOA,0BAAiE;AACjE,wBAAwB;AAIxB,IAAM,UAAU,OAAqC,kBAAc;AAW5D,IAAM,YAAY;AAAA,EACvB,GAAG;AAAA,EACH,UAAU;AAAA,EACV,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAS;AAAA,IACP,KAAK,CAAC;AAAA,EACR;AAAA,EACA,MAAM;AAAA,EACN,QAAQ,OAAO,MAAM,YAAY,cAAc,MAAM,OAAO;AAAA,EAC5D,YAAY;AAAA,EACZ,gBAAgB;AAClB;AAGA,SAAS,cACP,MACA,SACa;AACb,QAAM,OAAO,UAAU,MAAM,OAAO;AACpC,SAAO,IAAI,YAAY,EAAE,OAAO,IAAI,EAAE;AACxC;AAGA,SAAS,UAAU,MAAqC,SAAoC;AAC1F,QAAM,WAAO,wCAAmB,wBAAwB,IAAI,CAAC;AAC7D,QAAM,oBAAoB,qBAAqB,MAAM,UAAU;AAC/D,QAAM,kBAAkB,KAAK,WAAW;AACxC,QAAM,6BAA6B,KAAK,WAAW;AACnD,QAAM,iBAAiB,KAAK,WAAW;AACvC,QAAM,yBAAyB,0BAA0B,IAAI;AAC7D,QAAM,cAAc,kBAAkB,MAAM,SAAS,kBAAkB;AACvE,QAAM,kBAAkB,mBAAmB,MAAM,WAAW;AAC5D,QAAM,SAAS;AAAA,IACb;AAAA,IACA,gBAAgB,SAAS;AAAA,IACzB,QAAQ,eAAe;AAAA,IACvB,QAAQ,0BAA0B;AAAA,IAClC,QAAQ,cAAc;AAAA,IACtB;AAAA,EACF;AACA,QAAM,OAAiB,CAAC;AAExB,WAAS,cAAc,GAAG,cAAc,aAAa,eAAe;AAClE,UAAM,MAAM;AAAA,MACV,aAAa,mBAAmB,aAAa,CAAC;AAAA,MAC9C,aAAa,mBAAmB,aAAa,CAAC;AAAA,MAC9C,aAAa,mBAAmB,aAAa,CAAC;AAAA,IAChD;AAEA,QAAI,iBAAiB;AACnB,UAAI;AAAA,QACF,aAAa,iBAAiB,aAAa,CAAC;AAAA,QAC5C,aAAa,iBAAiB,aAAa,CAAC;AAAA,QAC5C,aAAa,iBAAiB,aAAa,CAAC;AAAA,MAC9C;AAAA,IACF;AAEA,QAAI,4BAA4B;AAC9B,UAAI;AAAA,QACF,aAAa,4BAA4B,aAAa,CAAC;AAAA,QACvD,aAAa,4BAA4B,aAAa,CAAC;AAAA,MACzD;AAAA,IACF;AAEA,QAAI,gBAAgB;AAClB,UAAI;AAAA,QACF,aAAa,gBAAgB,aAAa,CAAC;AAAA,QAC3C,aAAa,gBAAgB,aAAa,CAAC;AAAA,QAC3C,aAAa,gBAAgB,aAAa,CAAC;AAAA,MAC7C;AAAA,IACF;AAEA,eAAW,CAAC,EAAE,SAAS,KAAK,wBAAwB;AAClD,UAAI,KAAK,aAAa,WAAW,aAAa,CAAC,CAAC;AAAA,IAClD;AAEA,SAAK,KAAK,IAAI,KAAK,GAAG,CAAC;AAAA,EACzB;AAEA,WAAS,gBAAgB,GAAG,gBAAgB,gBAAgB,QAAQ,iBAAiB,GAAG;AACtF,SAAK;AAAA,MACH,KAAK,gBAAgB,aAAa,CAAC,IAAI,gBAAgB,gBAAgB,CAAC,CAAC,IACvE,gBAAgB,gBAAgB,CAAC,CACnC;AAAA,IACF;AAAA,EACF;AAEA,SAAO,GAAG,OAAO,OAAO,IAAI,EAAE,KAAK,IAAI,CAAC;AAAA;AAC1C;AAGA,SAAS,wBAAwB,MAA6D;AAC5F,MAAI,EAAE,gBAAgB,OAAO;AAC3B,WAAO;AAAA,EACT;AACA,aAAO,oDAA+B,IAAY;AACpD;AAGA,SAAS,qBAAqB,MAAY,eAAsC;AAC9E,QAAM,YAAY,KAAK,WAAW,aAAa;AAC/C,MAAI,CAAC,WAAW;AACd,UAAM,IAAI,MAAM,cAAc,aAAa,wBAAwB;AAAA,EACrE;AACA,SAAO;AACT;AAGA,SAAS,aACP,aACA,WACA,YACA,uBACA,WACA,wBACU;AACV,QAAM,SAAS;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,IACA,kBAAkB,WAAW;AAAA,IAC7B;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,MAAI,YAAY;AACd,WAAO,KAAK,qBAAqB,qBAAqB,mBAAmB;AAAA,EAC3E;AAEA,MAAI,uBAAuB;AACzB,WAAO,KAAK,oBAAoB,kBAAkB;AAAA,EACpD;AAEA,MAAI,WAAW;AACb,WAAO,KAAK,sBAAsB,wBAAwB,qBAAqB;AAAA,EACjF;AAEA,aAAW,CAAC,aAAa,KAAK,wBAAwB;AACpD,WAAO,KAAK,kBAAkB,aAAa,EAAE;AAAA,EAC/C;AAEA,MAAI,YAAY,GAAG;AACjB,WAAO,KAAK,gBAAgB,SAAS,IAAI,wCAAwC;AAAA,EACnF;AAEA,SAAO,KAAK,YAAY;AACxB,SAAO;AACT;AAGA,SAAS,0BAA0B,MAAuC;AACxE,QAAM,yBAAyB,oBAAI,IAAI,CAAC,YAAY,UAAU,cAAc,SAAS,CAAC;AACtF,SAAO,OAAO,QAAQ,KAAK,UAAU,EAAE;AAAA,IACrC,CAAC,CAAC,eAAe,SAAS,MACxB,CAAC,uBAAuB,IAAI,aAAa,KAAK,UAAU,SAAS;AAAA,EACrE;AACF;AAGA,SAAS,aACP,WACA,aACA,gBACQ;AACR,SAAO,UAAU,MAAM,cAAc,UAAU,OAAO,cAAc,KAAK;AAC3E;AAGA,SAAS,aACP,WACA,aACA,gBACQ;AACR,QAAM,QAAQ,aAAa,WAAW,aAAa,cAAc;AACjE,QAAM,YAAY,UAAU,cAAc,SAAS,IAAI,QAAQ,MAAM;AACrE,SAAO,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,KAAK,MAAM,SAAS,CAAC,CAAC;AACzD;AAGA,SAAS,mBAAmB,MAAY,aAA+B;AACrE,MAAI,KAAK,SAAS,OAAO,QAAQ;AAC/B,WAAO,MAAM,KAAK,KAAK,QAAQ,KAAK;AAAA,EACtC;AAEA,MAAI,KAAK,SAAS,KAAK,KAAK,aAAa,iBAAiB;AACxD,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,kBAA4B,CAAC;AACnC,WAAS,cAAc,GAAG,cAAc,IAAI,aAAa,eAAe,GAAG;AACzE,oBAAgB,KAAK,aAAa,cAAc,GAAG,cAAc,CAAC;AAAA,EACpE;AACA,SAAO;AACT;",
+  "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,7 +1,7 @@
 {
   "name": "@loaders.gl/pointclouds",
-  "version": "5.0.0-beta.1",
-  "description": "LAS, LAZ, PCD and PLY point-cloud and mesh loaders",
+  "version": "5.0.0-beta.10",
+  "description": "LAS, LAZ, PCD, and PLY point cloud and mesh loaders and writers",
   "license": "MIT",
   "type": "module",
   "publishConfig": {
@@ -18,7 +18,10 @@
     "mesh",
     "point cloud",
     "LAS",
-    "LAZ"
+    "LAZ",
+    "loaders.gl",
+    "PCD",
+    "PLY"
   ],
   "types": "dist/index.d.ts",
   "main": "dist/index.cjs",
@@ -44,15 +47,15 @@
       "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-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/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-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",
@@ -64,40 +67,40 @@
       "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-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",
@@ -124,20 +127,20 @@
       "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-loader-types": {
+      "types": "./dist/pcd-loader-types.d.ts",
+      "import": "./dist/pcd-loader-types.js",
+      "require": "./dist/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-loader": {
+      "types": "./dist/pcd-loader.d.ts",
+      "import": "./dist/pcd-loader.js",
+      "require": "./dist/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-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",
@@ -164,20 +167,20 @@
       "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-loader-types": {
+      "types": "./dist/ply-loader-types.d.ts",
+      "import": "./dist/ply-loader-types.js",
+      "require": "./dist/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-loader": {
+      "types": "./dist/ply-loader.d.ts",
+      "import": "./dist/ply-loader.js",
+      "require": "./dist/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-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",
@@ -223,7 +226,7 @@
     "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",
+    "@math.gl/geospatial": "5.0.0-beta.10",
     "apache-arrow": ">= 17.0.0"
   },
   "peerDependencies": {
@@ -232,5 +235,6 @@
   "optionalDependencies": {
     "copc": "0.0.8",
     "laz-perf": "^0.0.7"
-  }
+  },
+  "gitHead": "efdd84034c25e2e5dbb41bc88b75af56cb2176da"
 }

package/src/index.ts

@@ -2,17 +2,17 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
-export {LASLoader, LASWorkerLoader} from './las/las-loader-types';
+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, PCDWorkerLoader} from './pcd/pcd-loader-types';
+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, PLYWorkerLoader} from './ply/ply-loader-types';
+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';

package/src/las/bundled.ts

@@ -3,7 +3,6 @@
 // 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';

package/src/las/index.ts

@@ -63,8 +63,4 @@ export type {
   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

@@ -3,7 +3,7 @@
 // Copyright (c) vis.gl contributors
 
 import type {Loader} from '@loaders.gl/core/loader-utils';
-import type {MeshArrowTable} from '@loaders.gl/core/schema';
+import type {Table, RecordBatch} from 'apache-arrow';
 import {LAS_LOADER_METADATA, type LASLoaderOptions} from './las-loader-shared';
 import type {LASMesh} from './lib/las-types';
 
@@ -12,7 +12,7 @@ export const LASCOPCLoader = {
   ...LAS_LOADER_METADATA,
   name: 'LAS (COPC)',
   preload: async () => {
-    const {LASCOPCLoaderWithParser} = await import('@loaders.gl/pointclouds/las/las-copc-loader');
+    const {LASCOPCLoaderWithParser} = await import('@loaders.gl/pointclouds/las-copc-loader');
     return LASCOPCLoaderWithParser;
   }
-} as const satisfies Loader<LASMesh | MeshArrowTable, LASMesh | MeshArrowTable, LASLoaderOptions>;
+} as const satisfies Loader<LASMesh | Table, LASMesh | RecordBatch, LASLoaderOptions>;

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

@@ -4,8 +4,10 @@
 
 // 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 {convertMeshToTable, convertTableToMesh} from '@loaders.gl/core/schema-utils';
+import {convertMeshToArrowTableWrapper, convertTableToMesh} from '@loaders.gl/core/schema-utils';
 import {
   formatLASMeshColors,
   getLASShape,
@@ -22,20 +24,16 @@ export const LASCOPCLoaderWithParser = {
   ...LAS_LOADER_METADATA,
   name: 'LAS (COPC)',
   parse: async (arrayBuffer: ArrayBuffer, options?: LASLoaderOptions) =>
-    convertLASMesh(await parseCOPCLAS(arrayBuffer, options), options),
+    toPublicLASResult(convertLASMesh(await parseCOPCLAS(arrayBuffer, options), options)),
   parseInBatches: (arrayBufferIterator, options?: LASLoaderOptions) =>
     convertLASMeshBatches(parseCOPCLASInBatches(arrayBufferIterator, options), options)
-} as const satisfies LoaderWithParser<
-  LASMesh | MeshArrowTable,
-  LASMesh | MeshArrowTable,
-  LASLoaderOptions
->;
+} 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 = convertMeshToTable(formattedMesh, 'arrow-table') as MeshArrowTable;
-  if (getLASShape(options) === 'arrow-table') {
-    return table;
+  const table = convertMeshToArrowTableWrapper(formattedMesh) as MeshArrowTable;
+  if (getLASShape(options) === 'arrow') {
+    return {...table, loaderData: mesh.loaderData};
   }
   return {
     ...(convertTableToMesh(table) as LASMesh),
@@ -54,8 +52,10 @@ function convertLASMesh(mesh: LASMesh, options?: LASLoaderOptions): LASMesh | Me
 async function* convertLASMeshBatches(
   meshBatches: AsyncIterable<LASMesh>,
   options?: LASLoaderOptions
-): AsyncIterable<LASMesh | MeshArrowTable> {
+): AsyncIterable<LASMesh | RecordBatch> {
   for await (const mesh of meshBatches) {
-    yield convertLASMesh(mesh, options);
+    const result = convertLASMesh(mesh, options);
+    if ('shape' in result) yield* getLASRecordBatches(result);
+    else yield result;
   }
 }

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

@@ -4,7 +4,7 @@
 
 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 type {Table, RecordBatch} from 'apache-arrow';
 import {LASFormat} from './las-format';
 import type {LASMesh} from './lib/las-types';
 
@@ -39,7 +39,7 @@ export type LASColumnName =
 export type LASLoaderOptions = LoaderOptions & {
   las?: {
     /** Output representation. */
-    shape?: 'mesh' | 'columnar-table' | 'arrow-table';
+    shape?: 'mesh' | 'columnar-table' | 'arrow';
     /** Store positions in 64-bit floating point arrays. */
     fp64?: boolean;
     /** Output color depth or automatic source-depth detection. */
@@ -62,19 +62,21 @@ export type LASLoaderOptions = LoaderOptions & {
 };
 
 /** Default output shape for LAS and LAZ loaders. */
-export const DEFAULT_LAS_SHAPE = 'arrow-table' as const;
+export const DEFAULT_LAS_SHAPE = 'arrow' as const;
 
 /** Resolve the LAS output shape, including the Arrow-primary default. */
-export function getLASShape(options?: LASLoaderOptions): 'mesh' | 'columnar-table' | 'arrow-table' {
+export function getLASShape(options?: LASLoaderOptions): 'mesh' | 'columnar-table' | 'arrow' {
   return options?.las?.shape || DEFAULT_LAS_SHAPE;
 }
 
 /** Parser-independent LAS loader metadata shared by each loader variant. */
 export const LAS_LOADER_METADATA = {
   ...LASFormat,
+  defaultShape: 'arrow',
+  supportsNativeArrow: true,
 
-  dataType: null as unknown as LASMesh | MeshArrowTable,
-  batchType: null as unknown as LASMesh | MeshArrowTable,
+  dataType: null as unknown as LASMesh | Table,
+  batchType: null as unknown as LASMesh | RecordBatch,
 
   version: VERSION,
   worker: false,
@@ -90,7 +92,7 @@ export const LAS_LOADER_METADATA = {
       compatibilityMode: 'auto'
     }
   }
-} as const satisfies Loader<LASMesh | MeshArrowTable, LASMesh | MeshArrowTable, LASLoaderOptions>;
+} as const satisfies Loader<LASMesh | Table, LASMesh | RecordBatch, LASLoaderOptions>;
 
 /** Apply the requested normalized color representation to a decoded LAS mesh. */
 export function formatLASMeshColors(

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

@@ -3,7 +3,7 @@
 // Copyright (c) vis.gl contributors
 
 import type {Loader} from '@loaders.gl/core/loader-utils';
-import type {MeshArrowTable} from '@loaders.gl/core/schema';
+import type {Table, RecordBatch} from 'apache-arrow';
 import type {LASMesh} from './lib/las-types';
 import {LAS_LOADER_METADATA, type LASLoaderOptions} from './las-loader-shared';
 
@@ -11,7 +11,7 @@ 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');
+  const {LASLoaderWithParser} = await import('@loaders.gl/pointclouds/las-loader');
   return LASLoaderWithParser;
 }
 
@@ -21,7 +21,4 @@ export const LASLoader = {
   worker: true,
   workerInBatches: true,
   preload
-} as const satisfies Loader<LASMesh | MeshArrowTable, LASMesh | MeshArrowTable, LASLoaderOptions>;
-
-/** @deprecated Use LASLoader. */
-export const LASWorkerLoader = LASLoader;
+} as const satisfies Loader<LASMesh | Table, LASMesh | RecordBatch, LASLoaderOptions>;