@playcanvas/splat-transform 2.0.0 → 2.0.1

package/dist/lib/index.d.cts

@@ -18,3 +18,4 @@ export type { WriteVoxelOptions, VoxelMetadata } from './writers';
 export { carve, fillExterior, fillFloor, filterCluster, filterFloaters, findClusterVoxelFlood, voxelizeToBuffer } from './voxel';
 export type { NavSeed, NavSimplifyResult } from './voxel';
 export type { Options, Param, DeviceCreator } from './types';
+export { version, revision } from './version';

package/dist/lib/index.d.ts

@@ -18,3 +18,4 @@ export type { WriteVoxelOptions, VoxelMetadata } from './writers';
 export { carve, fillExterior, fillFloor, filterCluster, filterFloaters, findClusterVoxelFlood, voxelizeToBuffer } from './voxel';
 export type { NavSeed, NavSimplifyResult } from './voxel';
 export type { Options, Param, DeviceCreator } from './types';
+export { version, revision } from './version';

package/dist/lib/utils/logger.d.ts

@@ -69,10 +69,19 @@ type LogEvent = {
     text: string;
 };
 /**
- * Renderer interface. Receives semantic events (already filtered by the
- * active verbosity inside {@link LoggerCore}) and decides how to display
- * them. Renderers are pure presentation - they never need to consult or
- * track verbosity themselves.
+ * Renderer interface. Receives the full stream of semantic lifecycle
+ * events ({@link LogEvent}) and decides how to display them. The core
+ * does not filter scope/bar events by verbosity, so renderers see a
+ * faithful record of every scope open/close and bar progress update -
+ * embedders consuming the event stream can rely on this for progress
+ * UIs that must close themselves on completion. Visibility decisions
+ * (e.g. hiding successful `scopeEnd` footers at non-`verbose`
+ * verbosity) are the renderer's responsibility; {@link logger.getVerbosity}
+ * is available to consult.
+ *
+ * `message` events for `info`, `warn` and `debug` are gated by verbosity
+ * at the façade (see {@link LoggerCore.isLevelVisible}) before reaching
+ * the renderer; `error` is always delivered.
  */
 interface Renderer {
     /**
@@ -144,6 +153,7 @@ interface Group {
     /** Dispose hook so `using` syntax closes the group on scope exit. */
     [Symbol.dispose](): void;
 }
+declare const verbosityRank: Record<Verbosity, number>;
 /**
  * Public logger surface.
  *
@@ -224,7 +234,10 @@ declare const logger: {
     output(text: string): void;
     /**
      * Replace the active renderer. Embedders install their own renderer here
-     * to consume `LogEvent`s; the default renderer is a no-op.
+     * to consume `LogEvent`s; the default renderer is a no-op. Renderers
+     * receive every scope/bar lifecycle event regardless of verbosity, so
+     * progress UIs can rely on `scopeStart`/`scopeEnd` and `barStart`/`barEnd`
+     * to manage their state.
      * @param r - The renderer to install.
      */
     setRenderer(r: Renderer): void;
@@ -253,5 +266,5 @@ declare const logger: {
  * this to inject a configured logger.
  */
 type Logger = typeof logger;
-export { logger };
+export { logger, verbosityRank };
 export type { Bar, Group, LogEvent, Logger, MessageKind, Renderer, Verbosity };

package/dist/lib/utils/text-renderer.d.ts

@@ -1,4 +1,4 @@
-import type { LogEvent, Renderer } from './logger';
+import { type LogEvent, type Renderer } from './logger';
 /**
  * Output streams and optional memory-usage probe for {@link TextRenderer}.
  */
@@ -29,20 +29,27 @@ interface TextRendererOptions {
 }
 /**
  * Default human-readable text renderer. Emits one event per line - no
- * carriage-return rewriting, no TTY detection, no buffering. Scope starts
- * always emit a header line; successful `scopeEnd` footers are filtered
- * out at `normal` verbosity by `LoggerCore` (kept at `verbose`, and always
- * shown when `failed`), so default-mode runs see headers without timing
- * footers and `--verbose` adds the matching `done in ...` lines. Bars
- * render as `[#### ...... ] duration`, with `#` appended incrementally on
- * each `barTick` and the remainder padded with `.` on `barEnd`. `output`
+ * carriage-return rewriting, no TTY detection, no buffering. Bars render
+ * as `[#### ...... ] duration`, with `#` appended incrementally on each
+ * `barTick` and the remainder padded with `.` on `barEnd`. `output`
  * events are treated as line-oriented: their text is written to the
  * pipeable sink with a trailing `\n` appended (callers should not include
  * one themselves).
  *
- * Verbosity filtering is handled centrally by `LoggerCore` - this renderer
- * receives only events that have already passed the visibility gate, so it
- * is pure presentation.
+ * Verbosity is consulted directly from the shared {@link logger} on each
+ * event, so this renderer alone decides what to display - the core
+ * delivers every scope/bar lifecycle event so embedders consuming the
+ * event stream see a faithful record. The display rules are:
+ *
+ * - `quiet` - suppresses every scope/bar lifecycle line (start, tick,
+ *   end - including failed ends). Errors, warnings and `output` still
+ *   show.
+ * - `normal` (default) - shows scope/bar headers and bar progress;
+ *   shows failed `scopeEnd` / `barEnd` footers (the "failed in ..."
+ *   cascade from `logger.error` / `unwindAll(true)`); hides successful
+ *   `scopeEnd` footers.
+ * - `verbose` - shows everything, including successful `scopeEnd`
+ *   footers ("done in ...").
  *
  * Sinks are injected (no `process` reference here) so the renderer works in
  * both Node CLI and browser/bundle contexts: the CLI passes
@@ -61,6 +68,7 @@ declare class TextRenderer implements Renderer {
      */
     private barFilled;
     constructor(options: TextRendererOptions);
+    private rank;
     handle(event: LogEvent): void;
     /**
      * Terminate any in-progress bar line so subsequent output starts on a

package/dist/lib/version.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The splat-transform version (semver MAJOR.MINOR.PATCH).
+ */
+export declare const version: string;
+/**
+ * The splat-transform revision (short Git hash of HEAD at build time).
+ */
+export declare const revision: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcanvas/splat-transform",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "author": "PlayCanvas<support@playcanvas.com>",
   "homepage": "https://playcanvas.com",
   "description": "Library and CLI tool for 3D Gaussian splat format conversion and transformation",
@@ -52,6 +52,7 @@
     "@playcanvas/supersplat-viewer": "1.20.2",
     "@rollup/plugin-json": "6.1.0",
     "@rollup/plugin-node-resolve": "16.0.3",
+    "@rollup/plugin-replace": "6.0.3",
     "@rollup/plugin-typescript": "12.3.0",
     "@types/node": "24.12.2",
     "@typescript-eslint/eslint-plugin": "8.59.0",