@playcanvas/splat-transform 1.1.0 → 1.2.0

package/dist/cli.mjs

@@ -13472,24 +13472,75 @@ const readSpz = async (source) => {
 
 /**
  * Default logger implementation (browser-safe).
- * Progress is a no-op since process.stdout is not available in browsers.
  */
 const defaultLogger = {
     log: (...args) => console.log(...args),
     warn: (...args) => console.warn(...args),
     error: (...args) => console.error(...args),
     debug: (...args) => console.log(...args),
-    progress: () => { },
-    output: text => console.log(text)
+    output: text => console.log(text),
+    onProgress: (node) => {
+        // step 0 is the begin notification - nothing to print
+        if (node.step === 0)
+            return;
+        const indent = '  '.repeat(node.depth);
+        const name = node.stepName ?? '';
+        console.log(`${indent}[${node.step}/${node.totalSteps}] ${name}`);
+    }
 };
 let impl = defaultLogger;
 let quiet = false;
+/**
+ * Progress tracking with nested step support.
+ * Access via logger.progress.begin(), logger.progress.step()
+ */
+class Progress {
+    currentNode;
+    /**
+     * Start a multi-step progress operation. Creates a new node with current as parent.
+     * Calls onProgress with step: 0 to notify consumers of the new progress block.
+     * @param totalSteps - Total number of steps in the operation.
+     */
+    begin(totalSteps) {
+        this.currentNode = {
+            step: 0,
+            totalSteps,
+            stepName: undefined,
+            parent: this.currentNode,
+            depth: (this.currentNode?.depth ?? -1) + 1
+        };
+        if (!quiet)
+            impl.onProgress(this.currentNode);
+    }
+    /**
+     * Advance to the next step. Auto-increments the step counter.
+     * Auto-ends when all steps are complete.
+     * @param name - Optional name of the step.
+     */
+    step(name) {
+        if (!this.currentNode)
+            return;
+        this.currentNode.step++;
+        this.currentNode.stepName = name;
+        if (!quiet)
+            impl.onProgress(this.currentNode);
+        // Auto-end when all steps complete
+        if (this.currentNode.step === this.currentNode.totalSteps) {
+            this.currentNode = this.currentNode.parent;
+        }
+    }
+}
 /**
  * Global logger instance with injectable implementation.
  * Use setLogger() to provide a custom implementation (e.g., Node.js with process.stdout).
  * Use setQuiet() to suppress log/warn/progress output.
  */
 const logger = {
+    /**
+     * Progress tracking with nested step support.
+     * Call begin(n) to start, then step() n times. Auto-ends when complete.
+     */
+    progress: new Progress(),
     /**
      * Set a custom logger implementation.
      * @param l - The logger implementation to use.
@@ -13535,14 +13586,6 @@ const logger = {
         if (!quiet)
             impl.debug(...args);
     },
-    /**
-     * Output text without newline (for progress indicators). Suppressed in quiet mode.
-     * @param text - The text to output.
-     */
-    progress(text) {
-        if (!quiet)
-            impl.progress(text);
-    },
     /**
      * Output data to stdout (for piping). Always shown, even in quiet mode.
      * @param text - The text to output.
@@ -13808,7 +13851,7 @@ class CompressedChunk {
     }
 }
 
-var version = "1.1.0";
+var version = "1.2.0";
 
 // sort the provided indices into morton order
 const sortMortonOrder = (dataTable, indices) => {
@@ -14665,6 +14708,8 @@ const kmeans = async (points, k, iterations, device) => {
     let converged = false;
     let steps = 0;
     logger.debug(`Running k-means clustering: dims=${points.numColumns} points=${points.numRows} clusters=${k} iterations=${iterations}...`);
+    // Report iterations as anonymous nested steps
+    logger.progress.begin(iterations);
     while (!converged) {
         if (gpuClustering) {
             await gpuClustering.execute(points, centroids, labels);
@@ -14690,12 +14735,12 @@ const kmeans = async (points, k, iterations, device) => {
         if (steps >= iterations) {
             converged = true;
         }
-        logger.progress('#');
+        // Report iteration as anonymous step
+        logger.progress.step();
     }
     if (gpuClustering) {
         gpuClustering.destroy();
     }
-    logger.debug(' done 🎉');
     return { centroids, labels };
 };
 
@@ -14963,12 +15008,25 @@ const writeSog = async (options, fs) => {
         };
     };
     const shBands = { '9': 1, '24': 2, '-1': 3 }[shNames$1.findIndex(v => !dataTable.hasColumn(v))] ?? 0;
+    const totalSteps = shBands > 0 ? 7 : 6;
     // convert and write attributes
+    logger.progress.begin(totalSteps);
+    logger.progress.step('Generating morton order');
+    // indices already generated above
+    logger.progress.step('Writing positions');
     const meansMinMax = await writeMeans();
+    logger.progress.step('Writing quaternions');
     await writeQuaternions();
+    logger.progress.step('Compressing scales');
     const scalesCodebook = await writeScales();
+    logger.progress.step('Compressing colors');
     const colorsCodebook = await writeColors();
-    const shN = shBands > 0 ? await writeSH(shBands) : null;
+    let shN = null;
+    if (shBands > 0) {
+        logger.progress.step('Compressing spherical harmonics');
+        shN = await writeSH(shBands);
+    }
+    logger.progress.step('Finalizing');
     // construct meta.json
     const meta = {
         version: 2,
@@ -16332,7 +16390,7 @@ SUPPORTED INPUTS
     .ply   .compressed.ply   .sog   meta.json   .ksplat   .splat   .spz   .mjs   .lcc
 
 SUPPORTED OUTPUTS
-    .ply   .compressed.ply   .sog   meta.json   .csv   .html   null
+    .ply   .compressed.ply   .sog   meta.json   lod-meta.json   .csv   .html   null
 
 ACTIONS (can be repeated, in any order)
     -t, --translate        <x,y,z>          Translate Gaussians by (x, y, z)
@@ -16394,8 +16452,15 @@ const main = async () => {
         warn: (...args) => console.warn(...args),
         error: (...args) => console.error(...args),
         debug: (...args) => console.error(...args),
-        progress: text => process.stderr.write(text),
-        output: text => console.log(text)
+        output: text => console.log(text),
+        onProgress: (node) => {
+            if (node.stepName) {
+                console.error(`[${node.step}/${node.totalSteps}] ${node.stepName}`);
+            }
+            else if (node.step > 0) {
+                process.stderr.write(node.step === node.totalSteps ? '# done 🎉\n' : '#');
+            }
+        }
     });
     // configure logger
     logger.setQuiet(options.quiet);