@loaders.gl/pointclouds 5.0.0-beta.1 → 5.0.0-beta.2

package/dist/ply-worker.js

@@ -15,29 +15,41 @@
       __defProp(target, name, { get: all[name], enumerable: true });
   };
 
-  // ../core/src/worker-utils/lib/node/worker_threads-browser.ts
+  // ../../node_modules/@math.gl/core/dist/worker-utils/lib/node/worker_threads-browser.js
   var parentPort;
   var init_worker_threads_browser = __esm({
-    "../core/src/worker-utils/lib/node/worker_threads-browser.ts"() {
-      "use strict";
+    "../../node_modules/@math.gl/core/dist/worker-utils/lib/node/worker_threads-browser.js"() {
       parentPort = null;
     }
   });
 
-  // ../core/src/worker-utils/lib/worker-utils/get-transfer-list.ts
+  // ../../node_modules/@math.gl/core/dist/worker-utils/lib/worker-utils/get-transfer-list.js
   function getTransferList(object, recursive = true, transfers) {
     const transfersSet = transfers || /* @__PURE__ */ new Set();
-    if (!object) {
-    } else if (isTransferable(object)) {
-      transfersSet.add(object);
-    } else if (isTransferable(object.buffer)) {
-      transfersSet.add(object.buffer);
-    } else if (ArrayBuffer.isView(object)) {
-    } else if (recursive && typeof object === "object") {
-      for (const key in object) {
-        getTransferList(object[key], recursive, transfersSet);
+    const seen = /* @__PURE__ */ new Set();
+    function visit(value) {
+      if (!value || typeof value !== "object" || seen.has(value))
+        return;
+      seen.add(value);
+      if (isTransferable(value))
+        transfersSet.add(value);
+      else if (ArrayBuffer.isView(value)) {
+        if (isTransferable(value.buffer))
+          transfersSet.add(value.buffer);
+      } else if (recursive && value instanceof Map) {
+        for (const [key, item] of value) {
+          visit(key);
+          visit(item);
+        }
+      } else if (recursive && value instanceof Set) {
+        for (const item of value)
+          visit(item);
+      } else if (recursive) {
+        for (const key of Object.keys(value))
+          visit(value[key]);
       }
     }
+    visit(object);
     return transfers === void 0 ? Array.from(transfersSet) : [];
   }
   function isTransferable(object) {
@@ -59,12 +71,11 @@
     return false;
   }
   var init_get_transfer_list = __esm({
-    "../core/src/worker-utils/lib/worker-utils/get-transfer-list.ts"() {
-      "use strict";
+    "../../node_modules/@math.gl/core/dist/worker-utils/lib/worker-utils/get-transfer-list.js"() {
     }
   });
 
-  // ../core/src/worker-utils/lib/worker-farm/worker-body.ts
+  // ../../node_modules/@math.gl/core/dist/worker-utils/lib/worker-farm/worker-body.js
   async function getParentPort() {
     return parentPort;
   }
@@ -77,15 +88,15 @@
   }
   var onMessageWrapperMap, WorkerBody;
   var init_worker_body = __esm({
-    "../core/src/worker-utils/lib/worker-farm/worker-body.ts"() {
-      "use strict";
+    "../../node_modules/@math.gl/core/dist/worker-utils/lib/worker-farm/worker-body.js"() {
       init_get_transfer_list();
       init_worker_threads_browser();
       onMessageWrapperMap = /* @__PURE__ */ new Map();
       WorkerBody = class {
         /** Check that we are actually in a worker thread */
         static async inWorkerThread() {
-          return typeof self !== "undefined" || Boolean(await getParentPort());
+          const workerGlobalScope = globalThis.WorkerGlobalScope;
+          return typeof workerGlobalScope === "function" && globalThis instanceof workerGlobalScope || Boolean(await getParentPort());
         }
         /*
          * (type: WorkerMessageType, payload: WorkerMessagePayload) => any
@@ -158,15 +169,11 @@
     }
   });
 
-  // ../core/src/worker-utils/lib/async-queue/async-queue.ts
+  // ../../node_modules/@math.gl/core/dist/worker-utils/lib/async-queue/async-queue.js
   var AsyncQueue;
   var init_async_queue = __esm({
-    "../core/src/worker-utils/lib/async-queue/async-queue.ts"() {
-      "use strict";
+    "../../node_modules/@math.gl/core/dist/worker-utils/lib/async-queue/async-queue.js"() {
       AsyncQueue = class {
-        _values;
-        _settlers;
-        _closed;
         constructor() {
           this._values = [];
           this._settlers = [];
@@ -234,7 +241,51 @@
     }
   });
 
-  // ../core/src/worker-utils/lib/worker-api/create-worker.ts
+  // ../../node_modules/@math.gl/core/dist/worker-utils/lib/worker-api/shared-state.js
+  var SharedWorkerState;
+  var init_shared_state = __esm({
+    "../../node_modules/@math.gl/core/dist/worker-utils/lib/worker-api/shared-state.js"() {
+      SharedWorkerState = class {
+        constructor(buffer) {
+          if (typeof SharedArrayBuffer === "undefined" || !(buffer instanceof SharedArrayBuffer) || buffer.byteLength !== 16)
+            throw new Error("Expected a 16-byte shared worker control buffer");
+          this.buffer = buffer;
+          this.values = new Int32Array(buffer);
+        }
+        get snapshot() {
+          return {
+            cancelled: Atomics.load(this.values, 0) !== 0,
+            completed: Atomics.load(this.values, 1),
+            total: Atomics.load(this.values, 2),
+            revision: Atomics.load(this.values, 3)
+          };
+        }
+        cancel() {
+          Atomics.store(this.values, 0, 1);
+          Atomics.add(this.values, 3, 1);
+          Atomics.notify(this.values, 0);
+        }
+        throwIfCancelled() {
+          if (Atomics.load(this.values, 0) !== 0) {
+            const error = new Error("Shared worker task was cancelled");
+            error.name = "AbortError";
+            throw error;
+          }
+        }
+        /** Integer counters for application-defined work; messages still carry phase names and units. */
+        setProgress(completed, total = -1) {
+          if (!Number.isInteger(completed) || completed < 0 || completed > 2147483647 || !Number.isInteger(total) || total < -1 || total > 2147483647) {
+            throw new RangeError("Shared progress requires nonnegative int32 counts (or total -1)");
+          }
+          Atomics.store(this.values, 1, completed);
+          Atomics.store(this.values, 2, total);
+          Atomics.add(this.values, 3, 1);
+        }
+      };
+    }
+  });
+
+  // ../../node_modules/@math.gl/core/dist/worker-utils/lib/worker-api/create-worker.js
   async function createWorker(process, processInBatches) {
     if (!await WorkerBody.inWorkerThread()) {
       return;
@@ -243,27 +294,56 @@
       process: processOnMainThread
     };
     WorkerBody.onmessage = async (type, payload) => {
+      if (type === "cancel") {
+        activeController?.abort();
+        activeInputBatches?.close();
+        activeOutputAcknowledgements?.close();
+        return;
+      }
+      const controller = type === "process" || type === "process-in-batches" ? new AbortController() : void 0;
+      if (controller)
+        activeController = controller;
+      const startedAt = performance.now();
       const reporter = type === "process" || type === "process-in-batches" ? createProgressReporter() : void 0;
-      const jobContext = { ...context, reportProgress: reporter?.report };
+      let sharedState;
+      const throwIfAborted = () => {
+        controller?.signal.throwIfAborted();
+        sharedState?.throwIfCancelled();
+      };
+      const jobContext = {
+        ...context,
+        signal: controller?.signal,
+        sharedState,
+        throwIfAborted,
+        reportProgress: (progress) => {
+          if (!controller?.signal.aborted && !sharedState?.snapshot.cancelled)
+            reporter?.report(progress);
+        }
+      };
       try {
+        if (controller && payload.options?.["sharedState"]) {
+          sharedState = new SharedWorkerState(payload.options["sharedState"]);
+          jobContext.sharedState = sharedState;
+        }
         switch (type) {
           case "preload":
             WorkerBody.postMessage("done", {});
             break;
           case "process":
+            throwIfAborted();
             if (!process) {
               throw new Error("Worker does not support atomic processing");
             }
-            const result = await process(
-              payload.input,
-              payload.options || {},
-              jobContext,
-              payload.context || {}
-            );
+            const result = await process(payload.input, payload.options || {}, jobContext, payload.context || {});
+            throwIfAborted();
             reporter?.finish();
-            WorkerBody.postMessage("done", { result });
+            await WorkerBody.postMessage("done", {
+              result,
+              executionMs: performance.now() - startedAt
+            });
             break;
           case "process-in-batches":
+            throwIfAborted();
             if (!processInBatches) {
               throw new Error("Worker does not support batched processing");
             }
@@ -272,18 +352,15 @@
             activeInputBatches = inputBatches;
             activeOutputAcknowledgements = outputAcknowledgements;
             try {
-              const resultIterator = processInBatches(
-                createDemandDrivenIterator(inputBatches),
-                payload.options || {},
-                jobContext,
-                payload.context || {}
-              );
+              const resultIterator = processInBatches(createDemandDrivenIterator(inputBatches), payload.options || {}, jobContext, payload.context || {});
               for await (const batch of resultIterator) {
+                throwIfAborted();
                 await WorkerBody.postMessage("output-batch", { result: batch });
                 await outputAcknowledgements.next();
               }
+              throwIfAborted();
               reporter?.finish();
-              await WorkerBody.postMessage("done", {});
+              await WorkerBody.postMessage("done", { executionMs: performance.now() - startedAt });
             } finally {
               activeInputBatches = null;
               activeOutputAcknowledgements = null;
@@ -310,11 +387,18 @@
           default:
         }
       } catch (error) {
-        reporter?.finish();
+        reporter?.finish(controller?.signal.aborted || sharedState?.snapshot.cancelled);
         const message = error instanceof Error ? error.message : "";
-        WorkerBody.postMessage("error", { error: message });
+        await WorkerBody.postMessage("error", {
+          error: message,
+          errorName: error instanceof Error ? error.name : "Error"
+        });
+      } finally {
+        if (controller && activeController === controller)
+          activeController = null;
       }
     };
+    await WorkerBody.postMessage("ready", {});
   }
   async function* createDemandDrivenIterator(inputBatches) {
     while (true) {
@@ -327,27 +411,45 @@
     }
   }
   function processOnMainThread(arrayBuffer, options = {}, jobContext = {}) {
+    const signal = activeController?.signal;
+    signal?.throwIfAborted();
     return new Promise((resolve, reject) => {
       const id = requestId++;
-      const onMessage = (type, payload2) => {
-        if (payload2.id !== id) {
+      const cleanup = () => {
+        signal?.removeEventListener("abort", abort);
+        void WorkerBody.removeEventListener(onMessage);
+      };
+      const abort = () => {
+        cleanup();
+        reject(signal?.reason);
+      };
+      const onMessage = (type, payload) => {
+        if (payload.id !== id)
           return;
-        }
-        switch (type) {
-          case "done":
-            WorkerBody.removeEventListener(onMessage);
-            resolve(payload2.result);
-            break;
-          case "error":
-            WorkerBody.removeEventListener(onMessage);
-            reject(payload2.error);
-            break;
-          default:
+        if (type === "done") {
+          cleanup();
+          resolve(payload.result);
+        } else if (type === "error") {
+          cleanup();
+          reject(payload.error);
         }
       };
-      WorkerBody.addEventListener(onMessage);
-      const payload = { id, input: arrayBuffer, options, context: jobContext };
-      WorkerBody.postMessage("process", payload);
+      void WorkerBody.addEventListener(onMessage).then(async () => {
+        if (signal?.aborted) {
+          abort();
+          return;
+        }
+        signal?.addEventListener("abort", abort, { once: true });
+        await WorkerBody.postMessage("process", {
+          id,
+          input: arrayBuffer,
+          options,
+          context: jobContext
+        });
+      }).catch((error) => {
+        cleanup();
+        reject(error);
+      });
     });
   }
   function createProgressReporter() {
@@ -364,8 +466,10 @@
     return {
       /** Records progress while retaining phase transitions. */
       report(progress) {
-        if (finished) return;
-        if (pending && pending.phase !== progress.phase) flush();
+        if (finished)
+          return;
+        if (pending && pending.phase !== progress.phase)
+          flush();
         pending = { ...progress };
         if (!scheduled) {
           scheduled = true;
@@ -373,29 +477,58 @@
         }
       },
       /** Flushes final progress and suppresses reports from stale callbacks. */
-      finish() {
+      finish(discard = false) {
+        if (discard)
+          pending = void 0;
         flush();
         finished = true;
       }
     };
   }
-  var requestId, activeInputBatches, activeOutputAcknowledgements;
+  var requestId, activeController, activeInputBatches, activeOutputAcknowledgements;
   var init_create_worker = __esm({
-    "../core/src/worker-utils/lib/worker-api/create-worker.ts"() {
-      "use strict";
+    "../../node_modules/@math.gl/core/dist/worker-utils/lib/worker-api/create-worker.js"() {
+      init_shared_state();
       init_async_queue();
       init_worker_body();
       requestId = 0;
+      activeController = null;
       activeInputBatches = null;
       activeOutputAcknowledgements = null;
     }
   });
 
-  // ../core/src/worker-utils/index.ts
+  // ../../node_modules/@math.gl/core/dist/worker-utils/index.js
+  var import_meta, path, moduleUrl;
   var init_worker_utils = __esm({
+    "../../node_modules/@math.gl/core/dist/worker-utils/index.js"() {
+      init_create_worker();
+      import_meta = {};
+      path = typeof __filename === "string" ? __filename.replace(/\\/g, "/") : "";
+      moduleUrl = path ? `file://${path.startsWith("/") ? "" : "/"}${encodeURI(path).replace(/#/g, "%23").replace(/\?/g, "%3F")}` : import_meta.url;
+    }
+  });
+
+  // ../../node_modules/@math.gl/core/dist/tasks/index.js
+  var init_tasks = __esm({
+    "../../node_modules/@math.gl/core/dist/tasks/index.js"() {
+      init_worker_utils();
+    }
+  });
+
+  // ../core/src/worker-utils/lib/worker-api/create-worker.ts
+  var init_create_worker2 = __esm({
+    "../core/src/worker-utils/lib/worker-api/create-worker.ts"() {
+      "use strict";
+      init_tasks();
+    }
+  });
+
+  // ../core/src/worker-utils/index.ts
+  var init_worker_utils2 = __esm({
     "../core/src/worker-utils/index.ts"() {
       "use strict";
-      init_create_worker();
+      init_create_worker2();
     }
   });
 
@@ -539,7 +672,7 @@
   var init_create_loader_worker = __esm({
     "../core/src/loader-utils/lib/worker-loader-utils/create-loader-worker.ts"() {
       "use strict";
-      init_worker_utils();
+      init_worker_utils2();
     }
   });
 
@@ -13529,8 +13662,8 @@ return true;`);
   });
 
   // ../../node_modules/apache-arrow/ipc/reader.mjs
-  function shouldAutoDestroy(self2, options) {
-    return options && typeof options["autoDestroy"] === "boolean" ? options["autoDestroy"] : self2["autoDestroy"];
+  function shouldAutoDestroy(self, options) {
+    return options && typeof options["autoDestroy"] === "boolean" ? options["autoDestroy"] : self["autoDestroy"];
   }
   function* readAllSync(source) {
     const reader = RecordBatchReader.from(source);
@@ -19006,7 +19139,7 @@ return true;`);
       "use strict";
       init_ply_format();
       init_arrow_transport();
-      VERSION = true ? "5.0.0-beta.1" : "latest";
+      VERSION = true ? "5.0.0-beta.2" : "latest";
       PLYLoader = {
         dataType: null,
         batchType: null,

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.2" : "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 ("shape" in data && data.shape === "arrow-table") {
+    return data;
+  }
+  return (0, import_schema_utils.convertMeshToTable)(data, "arrow-table");
+}
+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 {WriterOptions, WriterWithEncoder} from '@loaders.gl/core/loader-utils';\nimport type {Mesh, MeshArrowTable, MeshAttribute} from '@loaders.gl/core/schema';\nimport {convertMeshToTable, 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,\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, never, PLYWriterOptions>;\n\n/** Encode mesh category data as PLY bytes. */\nfunction encodePLYSync(data: Mesh | MeshArrowTable, options?: PLYWriterOptions): 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, 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): MeshArrowTable {\n  if ('shape' in data && data.shape === 'arrow-table') {\n    return data;\n  }\n  return convertMeshToTable(data as Mesh, 'arrow-table');\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"}