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

package/dist/ply/unbundled.d.ts

@@ -0,0 +1,3 @@
+export type { PLYLoaderOptions } from "./ply-loader-types.js";
+export { PLYWorkerLoader, PLYLoader } from "./ply-loader-types.js";
+//# sourceMappingURL=unbundled.d.ts.map

package/dist/ply/unbundled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unbundled.d.ts","sourceRoot":"","sources":["../../src/ply/unbundled.ts"],"names":[],"mappings":"AAIA,YAAY,EAAC,gBAAgB,EAAC,8BAA2B;AACzD,OAAO,EAAC,eAAe,EAAE,SAAS,EAAC,8BAA2B"}

package/dist/ply/unbundled.js

@@ -0,0 +1,5 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export { PLYWorkerLoader, PLYLoader } from "./ply-loader-types.js";
+//# sourceMappingURL=unbundled.js.map

package/dist/ply/unbundled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unbundled.js","sourceRoot":"","sources":["../../src/ply/unbundled.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,eAAe,EAAE,SAAS,EAAC,8BAA2B"}

package/dist/ply/workers/ply-worker.cjs

@@ -0,0 +1,34 @@
+"use strict";
+
+// src/ply/workers/ply-worker.ts
+var import_loader_utils = require("@loaders.gl/core/loader-utils");
+var import_schema_utils = require("@loaders.gl/core/schema-utils");
+var import_ply_loader = require("../ply-loader.cjs");
+(0, import_loader_utils.createLoaderWorker)({
+  ...import_ply_loader.PLYLoaderWithParser,
+  /** Always returns columnar data; legacy mesh conversion runs on the caller. */
+  parse(input, options) {
+    return import_ply_loader.PLYLoaderWithParser.parse(input, {
+      ...options,
+      ply: { ...options?.ply, shape: "arrow-table" }
+    });
+  },
+  /** Preserves full-mesh parsing while streaming point-cloud vertices as Arrow batches. */
+  async *parseInBatches(input, options) {
+    const parseMesh = options?.ply?.shape === "mesh" && !options?.ply?.pointCloud;
+    const parserOptions = parseMesh ? options : { ...options, ply: { ...options?.ply, shape: "arrow-table" } };
+    for await (const batch of import_ply_loader.PLYLoaderWithParser.parseInBatches(input, parserOptions)) {
+      if ("shape" in batch && batch.shape === "arrow-table") {
+        yield batch;
+      } else {
+        const mesh = batch;
+        yield (0, import_loader_utils.makeTableScanBatch)({
+          ...(0, import_schema_utils.convertMeshToTable)(mesh, "arrow-table"),
+          loader: mesh.loader,
+          loaderData: mesh.loaderData
+        });
+      }
+    }
+  }
+});
+//# sourceMappingURL=ply-worker.cjs.map

package/dist/ply/workers/ply-worker.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/ply/workers/ply-worker.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport {createLoaderWorker, makeTableScanBatch} from '@loaders.gl/core/loader-utils';\nimport type {MeshArrowTable} from '@loaders.gl/core/schema';\nimport {convertMeshToTable} from '@loaders.gl/core/schema-utils';\nimport type {PLYMesh} from '../lib/ply-types';\nimport type {PLYLoaderOptions} from '../ply-loader-types';\nimport {PLYLoaderWithParser} from '../ply-loader';\n\ncreateLoaderWorker({\n  ...PLYLoaderWithParser,\n  /** Always returns columnar data; legacy mesh conversion runs on the caller. */\n  parse(input, options) {\n    return PLYLoaderWithParser.parse(input, {\n      ...options,\n      ply: {...options?.ply, shape: 'arrow-table'}\n    });\n  },\n  /** Preserves full-mesh parsing while streaming point-cloud vertices as Arrow batches. */\n  async *parseInBatches(input, options?: PLYLoaderOptions) {\n    const parseMesh = options?.ply?.shape === 'mesh' && !options?.ply?.pointCloud;\n    const parserOptions = parseMesh\n      ? options\n      : {...options, ply: {...options?.ply, shape: 'arrow-table' as const}};\n    for await (const batch of PLYLoaderWithParser.parseInBatches(input, parserOptions)) {\n      if ('shape' in batch && batch.shape === 'arrow-table') {\n        yield batch;\n      } else {\n        const mesh = batch as PLYMesh;\n        yield makeTableScanBatch({\n          ...convertMeshToTable(mesh, 'arrow-table'),\n          loader: mesh.loader,\n          loaderData: mesh.loaderData\n        } as MeshArrowTable);\n      }\n    }\n  }\n});\n"],
+  "mappings": ";;;AAIA,0BAAqD;AAErD,0BAAiC;AAGjC,wBAAkC;AAAA,IAElC,wCAAmB;AAAA,EACjB,GAAG;AAAA;AAAA,EAEH,MAAM,OAAO,SAAS;AACpB,WAAO,sCAAoB,MAAM,OAAO;AAAA,MACtC,GAAG;AAAA,MACH,KAAK,EAAC,GAAG,SAAS,KAAK,OAAO,cAAa;AAAA,IAC7C,CAAC;AAAA,EACH;AAAA;AAAA,EAEA,OAAO,eAAe,OAAO,SAA4B;AACvD,UAAM,YAAY,SAAS,KAAK,UAAU,UAAU,CAAC,SAAS,KAAK;AACnE,UAAM,gBAAgB,YAClB,UACA,EAAC,GAAG,SAAS,KAAK,EAAC,GAAG,SAAS,KAAK,OAAO,cAAsB,EAAC;AACtE,qBAAiB,SAAS,sCAAoB,eAAe,OAAO,aAAa,GAAG;AAClF,UAAI,WAAW,SAAS,MAAM,UAAU,eAAe;AACrD,cAAM;AAAA,MACR,OAAO;AACL,cAAM,OAAO;AACb,kBAAM,wCAAmB;AAAA,UACvB,OAAG,wCAAmB,MAAM,aAAa;AAAA,UACzC,QAAQ,KAAK;AAAA,UACb,YAAY,KAAK;AAAA,QACnB,CAAmB;AAAA,MACrB;AAAA,IACF;AAAA,EACF;AACF,CAAC;",
+  "names": []
+}

package/dist/ply/workers/ply-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ply-worker.d.ts.map

package/dist/ply/workers/ply-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ply-worker.d.ts","sourceRoot":"","sources":["../../../src/ply/workers/ply-worker.ts"],"names":[],"mappings":""}

package/dist/ply/workers/ply-worker.js

@@ -0,0 +1,37 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { createLoaderWorker, makeTableScanBatch } from '@loaders.gl/core/loader-utils';
+import { convertMeshToTable } from '@loaders.gl/core/schema-utils';
+import { PLYLoaderWithParser } from "../ply-loader.js";
+createLoaderWorker({
+    ...PLYLoaderWithParser,
+    /** Always returns columnar data; legacy mesh conversion runs on the caller. */
+    parse(input, options) {
+        return PLYLoaderWithParser.parse(input, {
+            ...options,
+            ply: { ...options?.ply, shape: 'arrow-table' }
+        });
+    },
+    /** Preserves full-mesh parsing while streaming point-cloud vertices as Arrow batches. */
+    async *parseInBatches(input, options) {
+        const parseMesh = options?.ply?.shape === 'mesh' && !options?.ply?.pointCloud;
+        const parserOptions = parseMesh
+            ? options
+            : { ...options, ply: { ...options?.ply, shape: 'arrow-table' } };
+        for await (const batch of PLYLoaderWithParser.parseInBatches(input, parserOptions)) {
+            if ('shape' in batch && batch.shape === 'arrow-table') {
+                yield batch;
+            }
+            else {
+                const mesh = batch;
+                yield makeTableScanBatch({
+                    ...convertMeshToTable(mesh, 'arrow-table'),
+                    loader: mesh.loader,
+                    loaderData: mesh.loaderData
+                });
+            }
+        }
+    }
+});
+//# sourceMappingURL=ply-worker.js.map

package/dist/ply/workers/ply-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ply-worker.js","sourceRoot":"","sources":["../../../src/ply/workers/ply-worker.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EAAC,kBAAkB,EAAE,kBAAkB,EAAC,MAAM,+BAA+B,CAAC;AAErF,OAAO,EAAC,kBAAkB,EAAC,MAAM,+BAA+B,CAAC;AAGjE,OAAO,EAAC,mBAAmB,EAAC,yBAAsB;AAElD,kBAAkB,CAAC;IACjB,GAAG,mBAAmB;IACtB,+EAA+E;IAC/E,KAAK,CAAC,KAAK,EAAE,OAAO;QAClB,OAAO,mBAAmB,CAAC,KAAK,CAAC,KAAK,EAAE;YACtC,GAAG,OAAO;YACV,GAAG,EAAE,EAAC,GAAG,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,aAAa,EAAC;SAC7C,CAAC,CAAC;IACL,CAAC;IACD,yFAAyF;IACzF,KAAK,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,OAA0B;QACrD,MAAM,SAAS,GAAG,OAAO,EAAE,GAAG,EAAE,KAAK,KAAK,MAAM,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,UAAU,CAAC;QAC9E,MAAM,aAAa,GAAG,SAAS;YAC7B,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,EAAC,GAAG,OAAO,EAAE,GAAG,EAAE,EAAC,GAAG,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,aAAsB,EAAC,EAAC,CAAC;QACxE,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,mBAAmB,CAAC,cAAc,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,CAAC;YACnF,IAAI,OAAO,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;gBACtD,MAAM,KAAK,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,KAAgB,CAAC;gBAC9B,MAAM,kBAAkB,CAAC;oBACvB,GAAG,kBAAkB,CAAC,IAAI,EAAE,aAAa,CAAC;oBAC1C,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,UAAU,EAAE,IAAI,CAAC,UAAU;iBACV,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/ply-loader-types.cjs

@@ -0,0 +1,67 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/ply-loader-types.ts
+var ply_loader_types_exports = {};
+__export(ply_loader_types_exports, {
+  PLYLoader: () => PLYLoader,
+  PLYWorkerLoader: () => PLYWorkerLoader
+});
+module.exports = __toCommonJS(ply_loader_types_exports);
+
+// src/ply/ply-loader-types.ts
+var import_ply_format = require("./ply-format.cjs");
+var import_arrow_transport = require("@loaders.gl/core/schema-utils/arrow-transport");
+var VERSION = true ? "5.0.0-beta.2" : "latest";
+async function preload() {
+  const { PLYLoaderWithParser } = await import("@loaders.gl/pointclouds/ply-loader");
+  return PLYLoaderWithParser;
+}
+var PLYLoader = {
+  dataType: null,
+  batchType: null,
+  ...import_ply_format.PLYFormat,
+  // shapes: ['mesh', 'gltf', 'columnar-table'],
+  version: VERSION,
+  worker: true,
+  /** Enables the stateful input/output batch protocol on the built-in worker. */
+  workerInBatches: true,
+  serializeWorkerResult: import_arrow_transport.serializeArrowWorkerTable,
+  options: {
+    ply: { shape: "arrow-table", colorFormat: "uint8norm" }
+  },
+  preload
+};
+var PLYWorkerLoader = PLYLoader;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PLYLoader,
+  PLYWorkerLoader
+});
+//# sourceMappingURL=ply-loader-types.cjs.map

package/dist/ply-loader-types.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/ply-loader-types.ts", "../src/ply/ply-loader-types.ts"],
+  "sourcesContent": ["export * from './ply/ply-loader-types.js';\n", "// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\n// PLY Loader\nimport type {Loader, LoaderOptions} from '@loaders.gl/core/loader-utils';\nimport type {MeshArrowTable, ArrowTableBatch} from '@loaders.gl/core/schema';\nimport type {PLYMesh} from './lib/ply-types';\nimport type {ParsePLYOptions} from './lib/parse-ply';\nimport {PLYFormat} from './ply-format';\nimport {serializeArrowWorkerTable} from '@loaders.gl/core/schema-utils/arrow-transport';\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\nexport type PLYLoaderOptions = LoaderOptions & {\n  ply?: ParsePLYOptions & {\n    /** Output shape. Defaults to a Mesh Arrow table. */\n    shape?: 'mesh' | 'arrow-table';\n    /** Color storage format. Defaults to uint8norm for backwards compatibility. */\n    colorFormat?: 'uint8norm' | 'float16' | 'float32';\n    /** Treat PLY data as a point cloud by reading only the leading vertex element. */\n    pointCloud?: boolean;\n    /** Override the URL to the worker bundle (by default loads from unpkg.com) */\n    workerUrl?: string;\n  };\n};\n\n/**\n * Preloads the parser-bearing PLY loader implementation.\n */\nasync function preload() {\n  const {PLYLoaderWithParser} = await import('@loaders.gl/pointclouds/ply-loader');\n  return PLYLoaderWithParser;\n}\n\n/**\n * Metadata-only worker loader for PLY - Polygon File Format (aka Stanford Triangle Format)'\n * links: ['http://paulbourke.net/dataformats/ply/',\n * 'https://en.wikipedia.org/wiki/PLY_(file_format)']\n */\nexport const PLYLoader = {\n  dataType: null as unknown as PLYMesh | MeshArrowTable,\n  batchType: null as unknown as PLYMesh | ArrowTableBatch,\n\n  ...PLYFormat,\n  // shapes: ['mesh', 'gltf', 'columnar-table'],\n  version: VERSION,\n  worker: true,\n  /** Enables the stateful input/output batch protocol on the built-in worker. */\n  workerInBatches: true,\n  serializeWorkerResult: serializeArrowWorkerTable,\n  options: {\n    ply: {shape: 'arrow-table', colorFormat: 'uint8norm'}\n  },\n  preload\n} as const satisfies Loader<PLYMesh | MeshArrowTable, PLYMesh | ArrowTableBatch, LoaderOptions>;\n\n/** @deprecated Use PLYLoader. */\nexport const PLYWorkerLoader = PLYLoader;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACSA,wBAAwB;AACxB,6BAAwC;AAIxC,IAAM,UAAU,OAAqC,iBAAc;AAkBnE,eAAe,UAAU;AACvB,QAAM,EAAC,oBAAmB,IAAI,MAAM,OAAO,oCAAoC;AAC/E,SAAO;AACT;AAOO,IAAM,YAAY;AAAA,EACvB,UAAU;AAAA,EACV,WAAW;AAAA,EAEX,GAAG;AAAA;AAAA,EAEH,SAAS;AAAA,EACT,QAAQ;AAAA;AAAA,EAER,iBAAiB;AAAA,EACjB,uBAAuB;AAAA,EACvB,SAAS;AAAA,IACP,KAAK,EAAC,OAAO,eAAe,aAAa,YAAW;AAAA,EACtD;AAAA,EACA;AACF;AAGO,IAAM,kBAAkB;",
+  "names": []
+}

package/dist/ply-loader-types.d.ts

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

package/dist/ply-loader-types.d.ts.map

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

package/dist/ply-loader-types.js

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

package/dist/ply-loader-types.js.map

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

package/dist/ply-loader.cjs

@@ -0,0 +1,136 @@
+"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-loader.ts
+var ply_loader_exports = {};
+__export(ply_loader_exports, {
+  PLYLoaderWithParser: () => PLYLoaderWithParser
+});
+module.exports = __toCommonJS(ply_loader_exports);
+
+// src/ply/ply-loader.ts
+var import_loader_utils = require("@loaders.gl/core/loader-utils");
+var import_schema = require("@loaders.gl/core/schema");
+var import_arrow_transport = require("@loaders.gl/core/schema-utils/arrow-transport");
+var import_schema_utils = require("@loaders.gl/core/schema-utils");
+var import_parse_ply = require("./lib/parse-ply.cjs");
+var import_parse_ply_arrow = require("./lib/parse-ply-arrow.cjs");
+var import_parse_ply_in_batches = require("./lib/parse-ply-in-batches.cjs");
+var import_ply_loader_types = require("./ply-loader-types.cjs");
+var { preload: _PLYLoaderPreload, ...PLYLoaderMetadataWithoutPreload } = import_ply_loader_types.PLYLoader;
+function convertPLYMesh(mesh, options) {
+  const table = (0, import_schema_utils.convertMeshToTable)(mesh, "arrow-table");
+  return convertPLYTable(table, options, mesh.loaderData);
+}
+function parsePLYData(data, options) {
+  if (options?.ply?._useLegacyParser) {
+    return convertPLYMesh((0, import_parse_ply.parsePLY)(data, options?.ply), options);
+  }
+  const arrowTable = (0, import_parse_ply.parsePLYToArrowTable)(data, options?.ply);
+  if (arrowTable) {
+    return convertPLYTable(arrowTable, options, (0, import_parse_ply.parsePLYHeader)(data, options?.ply));
+  }
+  const elementTables = (0, import_parse_ply_arrow.parsePLYToElementTables)(data, options?.ply);
+  return convertPLYTable(
+    (0, import_parse_ply_arrow.convertPLYElementTablesToMeshArrowTable)(elementTables),
+    options,
+    elementTables.header
+  );
+}
+var PLYLoaderWithParser = {
+  ...PLYLoaderMetadataWithoutPreload,
+  parse: async (arrayBuffer, options) => parsePLYData(arrayBuffer, options),
+  parseTextSync: (arrayBuffer, options) => parsePLYData(arrayBuffer, options),
+  parseSync: (arrayBuffer, options) => parsePLYData(arrayBuffer, options),
+  parseInBatches: async function* (arrayBuffer, options) {
+    const plyOptions = {
+      ...options?.ply,
+      batchSize: options?.batchSize ?? options?.core?.batchSize
+    };
+    for await (const meshOrTable of (0, import_parse_ply_in_batches.parsePLYInBatches)(arrayBuffer, plyOptions)) {
+      const convertedData = isMeshArrowTable(meshOrTable) ? convertPLYTable(meshOrTable, options) : convertPLYMesh(meshOrTable, options);
+      yield isMeshArrowTable(convertedData) ? (0, import_loader_utils.makeTableScanBatch)(convertedData) : convertedData;
+    }
+  },
+  serializeWorkerResult: import_arrow_transport.serializeArrowWorkerTable,
+  deserializeWorkerResult: deserializePLYWorkerResult,
+  serializeWorkerBatch: import_arrow_transport.serializeArrowWorkerTable,
+  deserializeWorkerBatch: deserializePLYWorkerBatch
+};
+function convertPLYTable(table, options, header) {
+  const loaderData = header || table.loaderData || { comments: [], elements: [] };
+  const result = options?.ply?.shape === "arrow-table" ? { ...table, loader: "ply", loaderData } : {
+    ...(0, import_schema_utils.convertTableToMesh)(table),
+    loader: "ply",
+    loaderData
+  };
+  const colorFormat = options?.ply?.colorFormat || "uint8norm";
+  if (colorFormat === "uint8norm") {
+    return result;
+  }
+  const resultData = result;
+  const formattedMesh = formatPLYMeshColors(
+    isMeshArrowTable(resultData) ? (0, import_schema_utils.convertTableToMesh)(resultData) : resultData,
+    colorFormat
+  );
+  return options?.ply?.shape === "arrow-table" ? {
+    ...(0, import_schema_utils.convertMeshToTable)(formattedMesh, "arrow-table"),
+    loader: "ply",
+    loaderData
+  } : formattedMesh;
+}
+function formatPLYMeshColors(mesh, colorFormat) {
+  const colorAttribute = mesh.attributes.COLOR_0;
+  if (!colorAttribute) {
+    return mesh;
+  }
+  const sourceScale = colorAttribute.value instanceof Uint16Array ? 65535 : 255;
+  const value = colorFormat === "float16" ? (0, import_schema.convertColorArrayToFloat16)(colorAttribute.value, sourceScale) : (0, import_schema.convertColorArrayToFloat32)(colorAttribute.value, sourceScale);
+  const attributes = { ...mesh.attributes };
+  for (const [attributeName, attribute] of Object.entries(attributes)) {
+    if (attribute.value === colorAttribute.value) {
+      attributes[attributeName] = {
+        ...attribute,
+        value,
+        normalized: false,
+        ...colorFormat === "float16" ? { componentType: "float16" } : {}
+      };
+    }
+  }
+  return {
+    ...mesh,
+    attributes,
+    schema: (0, import_schema_utils.deduceMeshSchema)(attributes, mesh.schema.metadata)
+  };
+}
+function isMeshArrowTable(data) {
+  return "shape" in data && data.shape === "arrow-table";
+}
+function deserializePLYWorkerResult(result, options) {
+  const table = (0, import_arrow_transport.deserializeArrowWorkerTable)(result);
+  return options?.ply?.shape === "mesh" ? { ...(0, import_schema_utils.convertTableToMesh)(table), loader: "ply", loaderData: table.loaderData } : table;
+}
+function deserializePLYWorkerBatch(result, options) {
+  return deserializePLYWorkerResult(result, options);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PLYLoaderWithParser
+});
+//# sourceMappingURL=ply-loader.cjs.map

package/dist/ply-loader.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/ply-loader.ts", "../src/ply/ply-loader.ts"],
+  "sourcesContent": ["export * from './ply/ply-loader.js';\n", "// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {PLYLoaderOptions} from './ply-loader-types';\n\n// PLY Loader\nimport {makeTableScanBatch, type LoaderWithParser} from '@loaders.gl/core/loader-utils';\nimport {convertColorArrayToFloat16, convertColorArrayToFloat32} from '@loaders.gl/core/schema';\nimport type {MeshArrowTable, ArrowTableBatch} from '@loaders.gl/core/schema';\nimport {\n  deserializeArrowWorkerTable,\n  serializeArrowWorkerTable\n} from '@loaders.gl/core/schema-utils/arrow-transport';\nimport type {PLYHeader, PLYMesh} from './lib/ply-types';\nimport {\n  convertMeshToTable,\n  convertTableToMesh,\n  deduceMeshSchema\n} from '@loaders.gl/core/schema-utils';\nimport {parsePLY, parsePLYHeader, parsePLYToArrowTable} from './lib/parse-ply';\nimport {\n  convertPLYElementTablesToMeshArrowTable,\n  parsePLYToElementTables\n} from './lib/parse-ply-arrow';\nimport {parsePLYInBatches} from './lib/parse-ply-in-batches';\nimport {PLYLoader as PLYLoaderMetadata} from './ply-loader-types';\n\nconst {preload: _PLYLoaderPreload, ...PLYLoaderMetadataWithoutPreload} = PLYLoaderMetadata;\n\nfunction convertPLYMesh(mesh: PLYMesh, options?: PLYLoaderOptions): PLYMesh | MeshArrowTable {\n  const table = convertMeshToTable(mesh, 'arrow-table');\n  return convertPLYTable(table, options, mesh.loaderData);\n}\n\n/** Parse PLY data using a direct Arrow path when requested and supported. */\nfunction parsePLYData(\n  data: ArrayBuffer | string,\n  options?: PLYLoaderOptions\n): PLYMesh | MeshArrowTable {\n  if (options?.ply?._useLegacyParser) {\n    return convertPLYMesh(parsePLY(data, options?.ply), options);\n  }\n\n  const arrowTable = parsePLYToArrowTable(data, options?.ply);\n  if (arrowTable) {\n    return convertPLYTable(arrowTable, options, parsePLYHeader(data, options?.ply));\n  }\n\n  const elementTables = parsePLYToElementTables(data, options?.ply);\n  return convertPLYTable(\n    convertPLYElementTablesToMeshArrowTable(elementTables),\n    options,\n    elementTables.header\n  );\n}\n\n/**\n * Loader for PLY - Polygon File Format\n */\nexport const PLYLoaderWithParser = {\n  ...PLYLoaderMetadataWithoutPreload,\n  parse: async (arrayBuffer, options) => parsePLYData(arrayBuffer, options),\n  parseTextSync: (arrayBuffer, options) => parsePLYData(arrayBuffer, options),\n  parseSync: (arrayBuffer, options) => parsePLYData(arrayBuffer, options),\n  parseInBatches: async function* (\n    arrayBuffer:\n      | AsyncIterable<ArrayBufferLike | ArrayBufferView>\n      | Iterable<ArrayBufferLike | ArrayBufferView>,\n    options\n  ) {\n    const plyOptions = {\n      ...options?.ply,\n      batchSize: options?.batchSize ?? options?.core?.batchSize\n    };\n    for await (const meshOrTable of parsePLYInBatches(arrayBuffer, plyOptions)) {\n      const convertedData = isMeshArrowTable(meshOrTable)\n        ? convertPLYTable(meshOrTable, options)\n        : convertPLYMesh(meshOrTable, options);\n      yield isMeshArrowTable(convertedData) ? makeTableScanBatch(convertedData) : convertedData;\n    }\n  },\n  serializeWorkerResult: serializeArrowWorkerTable,\n  deserializeWorkerResult: deserializePLYWorkerResult,\n  serializeWorkerBatch: serializeArrowWorkerTable,\n  deserializeWorkerBatch: deserializePLYWorkerBatch\n} as const satisfies LoaderWithParser<\n  PLYMesh | MeshArrowTable,\n  PLYMesh | ArrowTableBatch,\n  PLYLoaderOptions\n>;\n\n/** Return requested public PLY shape from the parser's Arrow table. */\nfunction convertPLYTable(\n  table: MeshArrowTable & {\n    /** Original source header retained by the streaming parser. */\n    loaderData?: PLYHeader;\n  },\n  options?: PLYLoaderOptions,\n  header?: PLYHeader\n): PLYMesh | MeshArrowTable {\n  const loaderData = header || table.loaderData || {comments: [], elements: []};\n  const result =\n    options?.ply?.shape === 'arrow-table'\n      ? {...table, loader: 'ply' as const, loaderData}\n      : {\n          ...(convertTableToMesh(table) as PLYMesh),\n          loader: 'ply',\n          loaderData\n        };\n  const colorFormat = options?.ply?.colorFormat || 'uint8norm';\n  if (colorFormat === 'uint8norm') {\n    return result as PLYMesh | MeshArrowTable;\n  }\n\n  const resultData = result as PLYMesh | MeshArrowTable;\n  const formattedMesh = formatPLYMeshColors(\n    (isMeshArrowTable(resultData) ? convertTableToMesh(resultData) : resultData) as PLYMesh,\n    colorFormat\n  );\n  return options?.ply?.shape === 'arrow-table'\n    ? {\n        ...convertMeshToTable(formattedMesh, 'arrow-table'),\n        loader: 'ply' as const,\n        loaderData\n      }\n    : (formattedMesh as PLYMesh);\n}\n\n/** Apply the requested normalized color representation to a decoded PLY mesh. */\nfunction formatPLYMeshColors(\n  mesh: PLYMesh,\n  colorFormat: 'uint8norm' | 'float16' | 'float32'\n): PLYMesh {\n  const colorAttribute = mesh.attributes.COLOR_0;\n  if (!colorAttribute) {\n    return mesh;\n  }\n\n  const sourceScale = colorAttribute.value instanceof Uint16Array ? 65535 : 255;\n  const value =\n    colorFormat === 'float16'\n      ? convertColorArrayToFloat16(colorAttribute.value, sourceScale)\n      : convertColorArrayToFloat32(colorAttribute.value, sourceScale);\n  const attributes = {...mesh.attributes};\n  for (const [attributeName, attribute] of Object.entries(attributes)) {\n    if (attribute.value === colorAttribute.value) {\n      attributes[attributeName] = {\n        ...attribute,\n        value,\n        normalized: false,\n        ...(colorFormat === 'float16' ? {componentType: 'float16' as const} : {})\n      };\n    }\n  }\n  return {\n    ...mesh,\n    attributes,\n    schema: deduceMeshSchema(attributes, mesh.schema.metadata)\n  };\n}\n\n/** Return true if a parsed PLY batch is already a Mesh Arrow table. */\nfunction isMeshArrowTable(data: PLYMesh | MeshArrowTable): data is MeshArrowTable {\n  return 'shape' in data && data.shape === 'arrow-table';\n}\n\n/** Hydrates worker columns and applies the requested PLY shape on the caller. */\nfunction deserializePLYWorkerResult(\n  result: unknown,\n  options?: PLYLoaderOptions\n): PLYMesh | MeshArrowTable {\n  const table = deserializeArrowWorkerTable(result);\n  return options?.ply?.shape === 'mesh'\n    ? {...convertTableToMesh(table), loader: 'ply', loaderData: table.loaderData}\n    : table;\n}\n\n/** Converts mesh batches only after the Arrow column buffers reach the caller. */\nfunction deserializePLYWorkerBatch(\n  result: unknown,\n  options?: PLYLoaderOptions\n): PLYMesh | ArrowTableBatch {\n  return deserializePLYWorkerResult(result, options) as PLYMesh | ArrowTableBatch;\n}\n"],
+  "mappings": "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",
+  "names": ["PLYLoaderMetadata"]
+}

package/dist/ply-loader.d.ts

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

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

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

package/dist/ply-loader.js

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

package/dist/ply-loader.js.map

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