@selvajs/compute 3.1.0-beta.4 → 3.1.0-beta.5

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 export { Logger, camelcaseKeys, enableDebugLogging, fetchRhinoCompute, getLogger, setLogger, toCamelCase } from './core.cjs';
-export { C as ComputeServerStats, E as ErrorCode, a as ErrorCodes, F as FileBaseInfo, b as FileData, P as ProcessedFile, R as RhinoComputeError, d as downloadFileData, e as extractFilesFromComputeResponse } from './handle-files-9pkEgDIp.cjs';
-export { C as ComputeConfig, R as RetryPolicy, a as RhinoModelUnit, S as ServerTiming } from './types-V7G83j5m.cjs';
-export { CacheOptions, DataTreeValue, GetValuesOptions, GetValuesResult, GrasshopperClient, GrasshopperResponseProcessor, ParsedContext, SchedulerMode, SolveContext, SolveOptions, SolveResult, SolveScheduler, SolveSchedulerOptions, TreeBuilder, fetchDefinitionIO, fetchParsedDefinitionIO, processInput, processInputs, solveGrasshopperDefinition } from './grasshopper.cjs';
-export { B as BooleanInputType, D as DataItem, a as DataTree, b as DataTreeDefault, c as DataTreePath, d as DefaultValue, F as FileInputType, G as GeometryInputType, e as GrasshopperComputeConfig, f as GrasshopperComputeResponse, g as GrasshopperParsedIO, h as GrasshopperParsedIORaw, i as GrasshopperRequestSchema, I as InnerTreeData, j as InputParam, k as InputParamSchema, N as NumericInputType, O as OutputParamSchema, l as OutputType, T as TextInputType, V as ValueListInputType } from './types-DxPi5SEx.cjs';
+export { C as ComputeServerStats, E as ErrorCode, a as ErrorCodes, F as FileBaseInfo, b as FileData, P as ProcessedFile, R as RhinoComputeError, d as downloadFileData, e as extractFilesFromComputeResponse } from './handle-files-DMnx92gr.cjs';
+export { C as ComputeConfig, R as RetryPolicy, a as RhinoModelUnit, S as ServerTiming } from './types-C9YpTbr3.cjs';
+export { CacheOptions, DataTreeValue, DefinitionRef, GetValuesOptions, GetValuesResult, GrasshopperClient, GrasshopperResponseProcessor, ParsedContext, SchedulerMode, SolveContext, SolveDefinition, SolveOptions, SolveResult, SolveScheduler, SolveSchedulerOptions, TreeBuilder, fetchDefinitionIO, fetchParsedDefinitionIO, hashDefinition, hashSolveInput, isDefinitionRef, processInput, processInputs, solveGrasshopperDefinition, stableStringify } from './grasshopper.cjs';
+export { B as BooleanInputType, D as DataItem, a as DataTree, b as DataTreeDefault, c as DataTreePath, d as DefaultValue, F as FileInputType, G as GeometryInputType, e as GrasshopperComputeConfig, f as GrasshopperComputeResponse, g as GrasshopperParsedIO, h as GrasshopperParsedIORaw, i as GrasshopperRequestSchema, I as InnerTreeData, j as InputParam, k as InputParamSchema, N as NumericInputType, O as OutputParamSchema, l as OutputType, T as TextInputType, V as ValueListInputType } from './types-Ci8Z0-hF.cjs';
 import 'three';
 import 'rhino3dm';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { Logger, camelcaseKeys, enableDebugLogging, fetchRhinoCompute, getLogger, setLogger, toCamelCase } from './core.js';
-export { C as ComputeServerStats, E as ErrorCode, a as ErrorCodes, F as FileBaseInfo, b as FileData, P as ProcessedFile, R as RhinoComputeError, d as downloadFileData, e as extractFilesFromComputeResponse } from './handle-files-9pkEgDIp.js';
-export { C as ComputeConfig, R as RetryPolicy, a as RhinoModelUnit, S as ServerTiming } from './types-V7G83j5m.js';
-export { CacheOptions, DataTreeValue, GetValuesOptions, GetValuesResult, GrasshopperClient, GrasshopperResponseProcessor, ParsedContext, SchedulerMode, SolveContext, SolveOptions, SolveResult, SolveScheduler, SolveSchedulerOptions, TreeBuilder, fetchDefinitionIO, fetchParsedDefinitionIO, processInput, processInputs, solveGrasshopperDefinition } from './grasshopper.js';
-export { B as BooleanInputType, D as DataItem, a as DataTree, b as DataTreeDefault, c as DataTreePath, d as DefaultValue, F as FileInputType, G as GeometryInputType, e as GrasshopperComputeConfig, f as GrasshopperComputeResponse, g as GrasshopperParsedIO, h as GrasshopperParsedIORaw, i as GrasshopperRequestSchema, I as InnerTreeData, j as InputParam, k as InputParamSchema, N as NumericInputType, O as OutputParamSchema, l as OutputType, T as TextInputType, V as ValueListInputType } from './types-BBSF_ISX.js';
+export { C as ComputeServerStats, E as ErrorCode, a as ErrorCodes, F as FileBaseInfo, b as FileData, P as ProcessedFile, R as RhinoComputeError, d as downloadFileData, e as extractFilesFromComputeResponse } from './handle-files-DMnx92gr.js';
+export { C as ComputeConfig, R as RetryPolicy, a as RhinoModelUnit, S as ServerTiming } from './types-C9YpTbr3.js';
+export { CacheOptions, DataTreeValue, DefinitionRef, GetValuesOptions, GetValuesResult, GrasshopperClient, GrasshopperResponseProcessor, ParsedContext, SchedulerMode, SolveContext, SolveDefinition, SolveOptions, SolveResult, SolveScheduler, SolveSchedulerOptions, TreeBuilder, fetchDefinitionIO, fetchParsedDefinitionIO, hashDefinition, hashSolveInput, isDefinitionRef, processInput, processInputs, solveGrasshopperDefinition, stableStringify } from './grasshopper.js';
+export { B as BooleanInputType, D as DataItem, a as DataTree, b as DataTreeDefault, c as DataTreePath, d as DefaultValue, F as FileInputType, G as GeometryInputType, e as GrasshopperComputeConfig, f as GrasshopperComputeResponse, g as GrasshopperParsedIO, h as GrasshopperParsedIORaw, i as GrasshopperRequestSchema, I as InnerTreeData, j as InputParam, k as InputParamSchema, N as NumericInputType, O as OutputParamSchema, l as OutputType, T as TextInputType, V as ValueListInputType } from './types-DuOh5XqS.js';
 import 'three';
 import 'rhino3dm';

package/dist/index.js

@@ -1,2 +1,2 @@
-import{a as d,b as g,c as h,d as i,e as j,f as k,g as l,h as n,i as q}from"./chunk-MDFVHHH6.js";import{c as o,d as r,e,f,g as m,l as p,n as t,o as x,p as a,q as b,r as c}from"./chunk-EMXDP7KY.js";export{t as ComputeServerStats,o as ErrorCodes,h as GrasshopperClient,i as GrasshopperResponseProcessor,r as RhinoComputeError,g as SolveScheduler,q as TreeBuilder,a as camelcaseKeys,c as downloadFileData,m as enableDebugLogging,b as extractFilesFromComputeResponse,l as fetchDefinitionIO,n as fetchParsedDefinitionIO,p as fetchRhinoCompute,e as getLogger,j as processInput,k as processInputs,f as setLogger,d as solveGrasshopperDefinition,x as toCamelCase};
+import{a as d,b as g,c as h,d as i,e as j,f as k,g as l,h as n,i as q,j as s,k as u,l as v,m as w}from"./chunk-PJATLYMU.js";import{c as o,d as r,e,f,g as m,l as p,n as t,o as x,p as a,s as b,t as c}from"./chunk-54O6BO24.js";export{t as ComputeServerStats,o as ErrorCodes,l as GrasshopperClient,n as GrasshopperResponseProcessor,r as RhinoComputeError,k as SolveScheduler,w as TreeBuilder,a as camelcaseKeys,c as downloadFileData,m as enableDebugLogging,b as extractFilesFromComputeResponse,u as fetchDefinitionIO,v as fetchParsedDefinitionIO,p as fetchRhinoCompute,e as getLogger,j as hashDefinition,i as hashSolveInput,d as isDefinitionRef,q as processInput,s as processInputs,f as setLogger,g as solveGrasshopperDefinition,h as stableStringify,x as toCamelCase};
 //# sourceMappingURL=index.js.map

package/dist/{types-V7G83j5m.d.cts → types-C9YpTbr3.d.cts}

@@ -6,7 +6,16 @@ type RhinoModelUnit = 'None' | 'Microns' | 'Millimeters' | 'Centimeters' | 'Mete
  * Retry policy for transient errors (network, 502, 503, 504, optionally 429).
  *
  * Retries use exponential backoff with jitter, capped at `maxDelayMs`.
- * If the server returns `Retry-After`, that value is honored instead.
+ * If the server returns `Retry-After`, that value is honored instead — even
+ * above `maxDelayMs` (the server's stated window wins), up to an absolute
+ * 60s safety cap.
+ *
+ * Duplicate-POST caveat: every compute request is a POST. A network error can
+ * strike after the body was sent but before the response arrived — in that
+ * window the server may already have executed the request, and a retry runs it
+ * again. Compute solves are deterministic/idempotent so this is normally just
+ * wasted work, but callers wrapping non-idempotent endpoints should keep
+ * `attempts` at 0 (the default).
  */
 interface RetryPolicy {
     /** Maximum number of retry attempts after the initial request (default: 0). */
@@ -53,8 +62,14 @@ interface ComputeConfig {
     /** @deprecated Renamed to `suppressBrowserWarning`. */
     suppressClientSideWarning?: boolean;
     /**
-     * Per-request timeout in milliseconds. Set to `0` to disable (useful for long
-     * solves where any timeout is the wrong answer). Default: no timeout.
+     * Per-**attempt** timeout in milliseconds. Set to `0` to disable (useful for
+     * long solves where any timeout is the wrong answer). Default: no timeout.
+     *
+     * This is NOT a total deadline: the timeout is re-armed for every retry
+     * attempt, so with `retry: { attempts: N }` the worst-case wall clock is
+     * `(N + 1) × timeoutMs` plus backoff sleeps between attempts. Callers that
+     * need a hard overall deadline should pass their own `signal` (e.g. from
+     * `AbortSignal.timeout(totalMs)`), which wins over any pending retry.
      *
      * Uses `AbortSignal.timeout` so the timer is not throttled when the tab is hidden.
      */
@@ -74,12 +89,18 @@ interface ComputeConfig {
      * breakdown when the response carries one (the `/grasshopper` solve endpoint
      * emits `decode;dur=N, solve;dur=N, encode;dur=N` on every response).
      *
-     * Fires on success only, once per request, before the parsed body is
-     * returned. The transport stays response-type-agnostic — this is a side
+     * Fires once per request, before the parsed body is returned — on success
+     * and on the HTTP-500 partial-success path (a solve that completed with
+     * Grasshopper errors still carries real timings, often the slowest ones).
+     * The transport stays response-type-agnostic — this is a side
      * channel for telemetry, it does not change what a call returns. Use it to
      * feed a perf monitor or surface "solve took Nms" without server log access.
+     *
+     * `requestId` is the same id sent as the `X-Request-ID` header and used in
+     * this library's own debug logs — use it to correlate a timing entry with
+     * a specific request when multiple solves are in flight concurrently.
      */
-    onServerTiming?: (timing: ServerTiming) => void;
+    onServerTiming?: (timing: ServerTiming, requestId: string) => void;
 }
 /**
  * Parsed `Server-Timing` metrics from a Compute response. Durations are in

package/dist/{types-V7G83j5m.d.ts → types-C9YpTbr3.d.ts}

@@ -6,7 +6,16 @@ type RhinoModelUnit = 'None' | 'Microns' | 'Millimeters' | 'Centimeters' | 'Mete
  * Retry policy for transient errors (network, 502, 503, 504, optionally 429).
  *
  * Retries use exponential backoff with jitter, capped at `maxDelayMs`.
- * If the server returns `Retry-After`, that value is honored instead.
+ * If the server returns `Retry-After`, that value is honored instead — even
+ * above `maxDelayMs` (the server's stated window wins), up to an absolute
+ * 60s safety cap.
+ *
+ * Duplicate-POST caveat: every compute request is a POST. A network error can
+ * strike after the body was sent but before the response arrived — in that
+ * window the server may already have executed the request, and a retry runs it
+ * again. Compute solves are deterministic/idempotent so this is normally just
+ * wasted work, but callers wrapping non-idempotent endpoints should keep
+ * `attempts` at 0 (the default).
  */
 interface RetryPolicy {
     /** Maximum number of retry attempts after the initial request (default: 0). */
@@ -53,8 +62,14 @@ interface ComputeConfig {
     /** @deprecated Renamed to `suppressBrowserWarning`. */
     suppressClientSideWarning?: boolean;
     /**
-     * Per-request timeout in milliseconds. Set to `0` to disable (useful for long
-     * solves where any timeout is the wrong answer). Default: no timeout.
+     * Per-**attempt** timeout in milliseconds. Set to `0` to disable (useful for
+     * long solves where any timeout is the wrong answer). Default: no timeout.
+     *
+     * This is NOT a total deadline: the timeout is re-armed for every retry
+     * attempt, so with `retry: { attempts: N }` the worst-case wall clock is
+     * `(N + 1) × timeoutMs` plus backoff sleeps between attempts. Callers that
+     * need a hard overall deadline should pass their own `signal` (e.g. from
+     * `AbortSignal.timeout(totalMs)`), which wins over any pending retry.
      *
      * Uses `AbortSignal.timeout` so the timer is not throttled when the tab is hidden.
      */
@@ -74,12 +89,18 @@ interface ComputeConfig {
      * breakdown when the response carries one (the `/grasshopper` solve endpoint
      * emits `decode;dur=N, solve;dur=N, encode;dur=N` on every response).
      *
-     * Fires on success only, once per request, before the parsed body is
-     * returned. The transport stays response-type-agnostic — this is a side
+     * Fires once per request, before the parsed body is returned — on success
+     * and on the HTTP-500 partial-success path (a solve that completed with
+     * Grasshopper errors still carries real timings, often the slowest ones).
+     * The transport stays response-type-agnostic — this is a side
      * channel for telemetry, it does not change what a call returns. Use it to
      * feed a perf monitor or surface "solve took Nms" without server log access.
+     *
+     * `requestId` is the same id sent as the `X-Request-ID` header and used in
+     * this library's own debug logs — use it to correlate a timing entry with
+     * a specific request when multiple solves are in flight concurrently.
      */
-    onServerTiming?: (timing: ServerTiming) => void;
+    onServerTiming?: (timing: ServerTiming, requestId: string) => void;
 }
 /**
  * Parsed `Server-Timing` metrics from a Compute response. Durations are in

package/dist/{types-DxPi5SEx.d.cts → types-Ci8Z0-hF.d.cts}

@@ -1,4 +1,4 @@
-import { C as ComputeConfig, a as RhinoModelUnit } from './types-V7G83j5m.cjs';
+import { C as ComputeConfig, a as RhinoModelUnit } from './types-C9YpTbr3.cjs';
 import { RhinoModule } from 'rhino3dm';
 
 /**
@@ -42,16 +42,39 @@ type InnerTreeData = {
     [path in DataTreePath]: DataItem[];
 };
 /**
- * Tree with parameter metadata (used in compute responses)
+ * Tree with parameter metadata (used in compute requests and responses).
+ *
+ * Field casing varies by server branch: stock mcneel compute (8.x/9.x)
+ * serializes `Resthopper.IO.DataTree` in PascalCase (`ParamName`/`InnerTree`
+ * — the C# class carries no `[JsonProperty]` attributes), while
+ * camelCase-serializing forks return `paramName`/`innerTree` instead. This
+ * client always *sends* PascalCase (see `DataTree.toCompute()` in
+ * `data-tree.ts`), so the PascalCase fields remain the canonical/required
+ * shape; the optional camelCase fields exist so responses from camelCase
+ * forks are representable without casts. Code that must read trees across
+ * both server families should use `readField`/`hasField`
+ * (`@/core/utils/read-field`, case-insensitive) rather than direct property
+ * access — `warnOnEmptyInnerTrees` in `solve.ts` is the reference example.
  */
 interface DataTree {
+    /** PascalCase — stock mcneel servers, and the request shape this client sends. */
     InnerTree: InnerTreeData;
+    /** PascalCase — stock mcneel servers, and the request shape this client sends. */
     ParamName: string;
+    /** camelCase — sent instead of `InnerTree` by camelCase server forks. */
+    innerTree?: InnerTreeData;
+    /** camelCase — sent instead of `ParamName` by camelCase server forks. */
+    paramName?: string;
 }
 /**
- * Output types supported from Grasshopper/Rhino Compute
+ * Output types supported from Grasshopper/Rhino Compute.
+ *
+ * The trailing `(string & {})` keeps the union open — servers can return any
+ * GOO type name — without collapsing the whole union to `string` the way a
+ * bare `| string` does, so the known literals keep driving autocomplete and
+ * `Extract<>`-style narrowing.
  */
-type OutputType = 'System.String' | 'System.Double' | 'System.Int32' | 'System.Boolean' | 'Rhino.Geometry.Point3d' | 'Rhino.Geometry.Line' | 'Rhino.Geometry.Circle' | 'Rhino.Geometry.Arc' | 'Rhino.Geometry.NurbsCurve' | 'Rhino.Geometry.Brep' | 'Rhino.Geometry.Mesh' | 'Rhino.Geometry.Vector3d' | 'Rhino.Geometry.Plane' | 'Rhino.Geometry.Box' | string;
+type OutputType = 'System.String' | 'System.Double' | 'System.Int32' | 'System.Boolean' | 'Rhino.Geometry.Point3d' | 'Rhino.Geometry.Line' | 'Rhino.Geometry.Circle' | 'Rhino.Geometry.Arc' | 'Rhino.Geometry.NurbsCurve' | 'Rhino.Geometry.Brep' | 'Rhino.Geometry.Mesh' | 'Rhino.Geometry.Vector3d' | 'Rhino.Geometry.Plane' | 'Rhino.Geometry.Box' | (string & {});
 /**
  * Union type for all possible default value types
  */
@@ -207,11 +230,24 @@ interface GrasshopperRequestSchema extends GrasshopperBaseSchema, GrasshopperDef
 /**
  * Response from Grasshopper compute server
  * Includes all schema fields + computed results
+ *
+ * `pointer` is deliberately excluded (`Omit`): the solve layer (`runSolve` in
+ * `solve.ts`) splits the server's echoed `pointer` off as the solve's
+ * `cacheKey` and strips it from the returned response, so client-returned
+ * responses never carry it.
+ *
+ * The schema-echo fields (`cachesolve`/`modelunits`/`dataversion`) stay
+ * optional as inherited from {@link GrasshopperBaseSchema}: the server echoes
+ * them back when set, but nothing client-side enforces their presence — don't
+ * rely on them without a fallback.
  */
-interface GrasshopperComputeResponse extends GrasshopperBaseSchema, GrasshopperDefinitionSource {
-    /** Whether cache was used (always present in response) */
-    cachesolve: boolean;
-    /** Model units (always present in response) */
+interface GrasshopperComputeResponse extends GrasshopperBaseSchema, Omit<GrasshopperDefinitionSource, 'pointer'> {
+    /**
+     * Model units the definition was solved in. Every conforming server response
+     * carries this (it drives downstream scaling, e.g. the webdisplay parser),
+     * but note it is not validated client-side — a non-conforming server or
+     * hand-built mock may omit it at runtime.
+     */
     modelunits: RhinoModelUnit;
     /**
      * The server echoes the request's full base64 definition back as `algo`, but the client strips
@@ -222,8 +258,6 @@ interface GrasshopperComputeResponse extends GrasshopperBaseSchema, GrasshopperD
     algo?: string | null;
     /** Filename of the definition (always present in response) */
     filename: string | null;
-    /** Data version */
-    dataversion: 7 | 8;
     /** Recursion level used */
     recursionlevel?: number;
     /** Output values organized by parameter */
@@ -367,7 +401,10 @@ interface DisplayItemBase extends DisplayIdentity {
     /** Opacity 0–1. Omitted means fully opaque. */
     opacity?: number;
 }
-/** A world position in Rhino's Z-up frame, in Rhino's `{X,Y,Z}` casing. Rotated to Three on parse. */
+/**
+ * A world position in Rhino's Z-up frame, in Rhino's `{X,Y,Z}` casing. Used unchanged on parse —
+ * the Three scene IS Rhino's Z-up frame, so no rotation is applied (see `../coordinate-transform.ts`).
+ */
 interface DisplayPosition {
     X: number;
     Y: number;
@@ -390,7 +427,7 @@ interface DisplayCurve extends DisplayItemBase {
 /** A single point, shipped raw (no rhino3dm decode), rendered as one vertex of a `THREE.Points`. */
 interface DisplayPoint extends DisplayItemBase {
     kind: 'point';
-    /** World position in Rhino Z-up; the shared Rhino→Three transform is applied on parse. */
+    /** World position in Rhino Z-up, used directly — the Three scene shares Rhino's Z-up frame. */
     position: DisplayPosition;
 }
 /**
@@ -421,11 +458,17 @@ interface SerializableMaterial {
  * Metadata for a single mesh within a batch.
  *
  * Offsets and counts are expressed in **vertex-count units** (not float components) and
- * **index-count units**. To address the typed-array storage:
- *   - vertex component offset = `vertexStart * 3`
- *   - vertex component count  = `vertexCount * 3`
- *   - index byte offset       = `indexStart * 4`
- *   - index count             = `indexCount`
+ * **index-count units** — i.e. element offsets into the decoded typed arrays, which is how
+ * consumers address them (`indices.subarray(indexStart, indexStart + indexCount)`). To address
+ * the typed-array storage:
+ *   - vertex component offset  = `vertexStart * 3`
+ *   - vertex component count   = `vertexCount * 3`
+ *   - index element offset     = `indexStart`
+ *   - index count              = `indexCount`
+ *
+ * If you need *byte* offsets, multiply by the element size, which depends on the blob's flags:
+ * indices are 2 bytes each for `FLAG_UINT16_INDICES` (wire v2+) blobs and 4 bytes for uint32
+ * blobs; vertex components are 2 bytes (int16 quantized) or 4 bytes (`FLAG_FLOAT32`).
  */
 interface MeshMetadata {
     name: string;

package/dist/{types-BBSF_ISX.d.ts → types-DuOh5XqS.d.ts}

@@ -1,4 +1,4 @@
-import { C as ComputeConfig, a as RhinoModelUnit } from './types-V7G83j5m.js';
+import { C as ComputeConfig, a as RhinoModelUnit } from './types-C9YpTbr3.js';
 import { RhinoModule } from 'rhino3dm';
 
 /**
@@ -42,16 +42,39 @@ type InnerTreeData = {
     [path in DataTreePath]: DataItem[];
 };
 /**
- * Tree with parameter metadata (used in compute responses)
+ * Tree with parameter metadata (used in compute requests and responses).
+ *
+ * Field casing varies by server branch: stock mcneel compute (8.x/9.x)
+ * serializes `Resthopper.IO.DataTree` in PascalCase (`ParamName`/`InnerTree`
+ * — the C# class carries no `[JsonProperty]` attributes), while
+ * camelCase-serializing forks return `paramName`/`innerTree` instead. This
+ * client always *sends* PascalCase (see `DataTree.toCompute()` in
+ * `data-tree.ts`), so the PascalCase fields remain the canonical/required
+ * shape; the optional camelCase fields exist so responses from camelCase
+ * forks are representable without casts. Code that must read trees across
+ * both server families should use `readField`/`hasField`
+ * (`@/core/utils/read-field`, case-insensitive) rather than direct property
+ * access — `warnOnEmptyInnerTrees` in `solve.ts` is the reference example.
  */
 interface DataTree {
+    /** PascalCase — stock mcneel servers, and the request shape this client sends. */
     InnerTree: InnerTreeData;
+    /** PascalCase — stock mcneel servers, and the request shape this client sends. */
     ParamName: string;
+    /** camelCase — sent instead of `InnerTree` by camelCase server forks. */
+    innerTree?: InnerTreeData;
+    /** camelCase — sent instead of `ParamName` by camelCase server forks. */
+    paramName?: string;
 }
 /**
- * Output types supported from Grasshopper/Rhino Compute
+ * Output types supported from Grasshopper/Rhino Compute.
+ *
+ * The trailing `(string & {})` keeps the union open — servers can return any
+ * GOO type name — without collapsing the whole union to `string` the way a
+ * bare `| string` does, so the known literals keep driving autocomplete and
+ * `Extract<>`-style narrowing.
  */
-type OutputType = 'System.String' | 'System.Double' | 'System.Int32' | 'System.Boolean' | 'Rhino.Geometry.Point3d' | 'Rhino.Geometry.Line' | 'Rhino.Geometry.Circle' | 'Rhino.Geometry.Arc' | 'Rhino.Geometry.NurbsCurve' | 'Rhino.Geometry.Brep' | 'Rhino.Geometry.Mesh' | 'Rhino.Geometry.Vector3d' | 'Rhino.Geometry.Plane' | 'Rhino.Geometry.Box' | string;
+type OutputType = 'System.String' | 'System.Double' | 'System.Int32' | 'System.Boolean' | 'Rhino.Geometry.Point3d' | 'Rhino.Geometry.Line' | 'Rhino.Geometry.Circle' | 'Rhino.Geometry.Arc' | 'Rhino.Geometry.NurbsCurve' | 'Rhino.Geometry.Brep' | 'Rhino.Geometry.Mesh' | 'Rhino.Geometry.Vector3d' | 'Rhino.Geometry.Plane' | 'Rhino.Geometry.Box' | (string & {});
 /**
  * Union type for all possible default value types
  */
@@ -207,11 +230,24 @@ interface GrasshopperRequestSchema extends GrasshopperBaseSchema, GrasshopperDef
 /**
  * Response from Grasshopper compute server
  * Includes all schema fields + computed results
+ *
+ * `pointer` is deliberately excluded (`Omit`): the solve layer (`runSolve` in
+ * `solve.ts`) splits the server's echoed `pointer` off as the solve's
+ * `cacheKey` and strips it from the returned response, so client-returned
+ * responses never carry it.
+ *
+ * The schema-echo fields (`cachesolve`/`modelunits`/`dataversion`) stay
+ * optional as inherited from {@link GrasshopperBaseSchema}: the server echoes
+ * them back when set, but nothing client-side enforces their presence — don't
+ * rely on them without a fallback.
  */
-interface GrasshopperComputeResponse extends GrasshopperBaseSchema, GrasshopperDefinitionSource {
-    /** Whether cache was used (always present in response) */
-    cachesolve: boolean;
-    /** Model units (always present in response) */
+interface GrasshopperComputeResponse extends GrasshopperBaseSchema, Omit<GrasshopperDefinitionSource, 'pointer'> {
+    /**
+     * Model units the definition was solved in. Every conforming server response
+     * carries this (it drives downstream scaling, e.g. the webdisplay parser),
+     * but note it is not validated client-side — a non-conforming server or
+     * hand-built mock may omit it at runtime.
+     */
     modelunits: RhinoModelUnit;
     /**
      * The server echoes the request's full base64 definition back as `algo`, but the client strips
@@ -222,8 +258,6 @@ interface GrasshopperComputeResponse extends GrasshopperBaseSchema, GrasshopperD
     algo?: string | null;
     /** Filename of the definition (always present in response) */
     filename: string | null;
-    /** Data version */
-    dataversion: 7 | 8;
     /** Recursion level used */
     recursionlevel?: number;
     /** Output values organized by parameter */
@@ -367,7 +401,10 @@ interface DisplayItemBase extends DisplayIdentity {
     /** Opacity 0–1. Omitted means fully opaque. */
     opacity?: number;
 }
-/** A world position in Rhino's Z-up frame, in Rhino's `{X,Y,Z}` casing. Rotated to Three on parse. */
+/**
+ * A world position in Rhino's Z-up frame, in Rhino's `{X,Y,Z}` casing. Used unchanged on parse —
+ * the Three scene IS Rhino's Z-up frame, so no rotation is applied (see `../coordinate-transform.ts`).
+ */
 interface DisplayPosition {
     X: number;
     Y: number;
@@ -390,7 +427,7 @@ interface DisplayCurve extends DisplayItemBase {
 /** A single point, shipped raw (no rhino3dm decode), rendered as one vertex of a `THREE.Points`. */
 interface DisplayPoint extends DisplayItemBase {
     kind: 'point';
-    /** World position in Rhino Z-up; the shared Rhino→Three transform is applied on parse. */
+    /** World position in Rhino Z-up, used directly — the Three scene shares Rhino's Z-up frame. */
     position: DisplayPosition;
 }
 /**
@@ -421,11 +458,17 @@ interface SerializableMaterial {
  * Metadata for a single mesh within a batch.
  *
  * Offsets and counts are expressed in **vertex-count units** (not float components) and
- * **index-count units**. To address the typed-array storage:
- *   - vertex component offset = `vertexStart * 3`
- *   - vertex component count  = `vertexCount * 3`
- *   - index byte offset       = `indexStart * 4`
- *   - index count             = `indexCount`
+ * **index-count units** — i.e. element offsets into the decoded typed arrays, which is how
+ * consumers address them (`indices.subarray(indexStart, indexStart + indexCount)`). To address
+ * the typed-array storage:
+ *   - vertex component offset  = `vertexStart * 3`
+ *   - vertex component count   = `vertexCount * 3`
+ *   - index element offset     = `indexStart`
+ *   - index count              = `indexCount`
+ *
+ * If you need *byte* offsets, multiply by the element size, which depends on the blob's flags:
+ * indices are 2 bytes each for `FLAG_UINT16_INDICES` (wire v2+) blobs and 4 bytes for uint32
+ * blobs; vertex components are 2 bytes (int16 quantized) or 4 bytes (`FLAG_FLOAT32`).
  */
 interface MeshMetadata {
     name: string;

package/dist/visualization-C3YOGQTW.js

@@ -0,0 +1,2 @@
+import{A as j,B as R,C as I,D,E as B,F as G,G as L,H as P,I as u,J as F,K as b,L as N,M as V,a as e,b as r,c as t,d as o,e as a,f as s,g as p,h as i,i as n,j as l,k as m,l as y,m as f,n as d,o as C,p as x,q as h,r as E,s as M,t as _,u as c,v as A,w as g,x as O,y as S,z as T}from"./chunk-ORGJSKR4.js";import"./chunk-54O6BO24.js";export{g as BINARY_MESH_MAGIC,S as BINARY_MESH_VERSION,O as COMPRESSED_MESH_MAGIC,n as EDGE_USERDATA_KIND,I as FLAG_DELTA_ENCODED,j as FLAG_FLOAT32,D as FLAG_HAS_UVS,B as FLAG_HAS_VERTEX_COLORS,R as FLAG_UINT16_INDICES,T as MIN_SUPPORTED_VERSION,e as Materials,N as SCALE_FACTORS,h as TEXTURE_CACHE_MAX_ENTRIES,L as UV_FORMAT_FLOAT32,G as UV_FORMAT_UINT16,l as addEdges,o as applyOffset,M as clearTextureCache,a as computeCombinedBoundingBox,s as createCameraController,p as createGrid,d as createLabelLayer,x as createMeasureTool,f as createRenderPipeline,i as createViewGizmo,V as getThreeMeshesFromComputeResponse,c as initThree,m as isEdgeOverlay,_ as materialAppearanceForStyle,P as parseBinaryMeshBatch,t as parseColor,A as parseDisplayItems,u as parseMeshBatch,b as parseMeshBatchBlob,F as parseMeshBatchObject,y as removeEdges,E as setTextureAnisotropy,C as snapToVertex,r as updateScene};
+//# sourceMappingURL=visualization-C3YOGQTW.js.map

package/dist/visualization-CERJ6XDX.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkEZRBMUXTcjs = require('./chunk-EZRBMUXT.cjs');require('./chunk-GF6ZIJWX.cjs');exports.BINARY_MESH_MAGIC = _chunkEZRBMUXTcjs.w; exports.BINARY_MESH_VERSION = _chunkEZRBMUXTcjs.y; exports.COMPRESSED_MESH_MAGIC = _chunkEZRBMUXTcjs.x; exports.EDGE_USERDATA_KIND = _chunkEZRBMUXTcjs.i; exports.FLAG_DELTA_ENCODED = _chunkEZRBMUXTcjs.C; exports.FLAG_FLOAT32 = _chunkEZRBMUXTcjs.A; exports.FLAG_HAS_UVS = _chunkEZRBMUXTcjs.D; exports.FLAG_HAS_VERTEX_COLORS = _chunkEZRBMUXTcjs.E; exports.FLAG_UINT16_INDICES = _chunkEZRBMUXTcjs.B; exports.MIN_SUPPORTED_VERSION = _chunkEZRBMUXTcjs.z; exports.Materials = _chunkEZRBMUXTcjs.a; exports.SCALE_FACTORS = _chunkEZRBMUXTcjs.L; exports.TEXTURE_CACHE_MAX_ENTRIES = _chunkEZRBMUXTcjs.q; exports.UV_FORMAT_FLOAT32 = _chunkEZRBMUXTcjs.G; exports.UV_FORMAT_UINT16 = _chunkEZRBMUXTcjs.F; exports.addEdges = _chunkEZRBMUXTcjs.j; exports.applyOffset = _chunkEZRBMUXTcjs.d; exports.clearTextureCache = _chunkEZRBMUXTcjs.s; exports.computeCombinedBoundingBox = _chunkEZRBMUXTcjs.e; exports.createCameraController = _chunkEZRBMUXTcjs.f; exports.createGrid = _chunkEZRBMUXTcjs.g; exports.createLabelLayer = _chunkEZRBMUXTcjs.n; exports.createMeasureTool = _chunkEZRBMUXTcjs.p; exports.createRenderPipeline = _chunkEZRBMUXTcjs.m; exports.createViewGizmo = _chunkEZRBMUXTcjs.h; exports.getThreeMeshesFromComputeResponse = _chunkEZRBMUXTcjs.M; exports.initThree = _chunkEZRBMUXTcjs.u; exports.isEdgeOverlay = _chunkEZRBMUXTcjs.k; exports.materialAppearanceForStyle = _chunkEZRBMUXTcjs.t; exports.parseBinaryMeshBatch = _chunkEZRBMUXTcjs.H; exports.parseColor = _chunkEZRBMUXTcjs.c; exports.parseDisplayItems = _chunkEZRBMUXTcjs.v; exports.parseMeshBatch = _chunkEZRBMUXTcjs.I; exports.parseMeshBatchBlob = _chunkEZRBMUXTcjs.K; exports.parseMeshBatchObject = _chunkEZRBMUXTcjs.J; exports.removeEdges = _chunkEZRBMUXTcjs.l; exports.setTextureAnisotropy = _chunkEZRBMUXTcjs.r; exports.snapToVertex = _chunkEZRBMUXTcjs.o; exports.updateScene = _chunkEZRBMUXTcjs.b;
+//# sourceMappingURL=visualization-CERJ6XDX.cjs.map

package/dist/visualization-CERJ6XDX.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/selva-compute/selva-compute/dist/visualization-CERJ6XDX.cjs"],"names":[],"mappings":"AAAA,iIAA6S,gCAA6B,82DAAi4B","file":"/home/runner/work/selva-compute/selva-compute/dist/visualization-CERJ6XDX.cjs"}

package/dist/visualization.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk4JNRO7TXcjs = require('./chunk-4JNRO7TX.cjs');require('./chunk-D7A3YIYD.cjs');exports.EDGE_USERDATA_KIND = _chunk4JNRO7TXcjs.h; exports.Materials = _chunk4JNRO7TXcjs.t; exports.SCALE_FACTORS = _chunk4JNRO7TXcjs.F; exports.addEdges = _chunk4JNRO7TXcjs.i; exports.applyOffset = _chunk4JNRO7TXcjs.c; exports.computeCombinedBoundingBox = _chunk4JNRO7TXcjs.d; exports.createCameraController = _chunk4JNRO7TXcjs.e; exports.createGrid = _chunk4JNRO7TXcjs.f; exports.createLabelLayer = _chunk4JNRO7TXcjs.m; exports.createMeasureTool = _chunk4JNRO7TXcjs.o; exports.createRenderPipeline = _chunk4JNRO7TXcjs.l; exports.createViewGizmo = _chunk4JNRO7TXcjs.g; exports.getThreeMeshesFromComputeResponse = _chunk4JNRO7TXcjs.G; exports.initThree = _chunk4JNRO7TXcjs.s; exports.isEdgeOverlay = _chunk4JNRO7TXcjs.j; exports.parseColor = _chunk4JNRO7TXcjs.b; exports.parseDisplayItems = _chunk4JNRO7TXcjs.u; exports.parseMeshBatchBlob = _chunk4JNRO7TXcjs.E; exports.parseMeshBatchObject = _chunk4JNRO7TXcjs.D; exports.removeEdges = _chunk4JNRO7TXcjs.k; exports.snapToVertex = _chunk4JNRO7TXcjs.n; exports.updateScene = _chunk4JNRO7TXcjs.a;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkEZRBMUXTcjs = require('./chunk-EZRBMUXT.cjs');require('./chunk-GF6ZIJWX.cjs');exports.EDGE_USERDATA_KIND = _chunkEZRBMUXTcjs.i; exports.Materials = _chunkEZRBMUXTcjs.a; exports.SCALE_FACTORS = _chunkEZRBMUXTcjs.L; exports.addEdges = _chunkEZRBMUXTcjs.j; exports.applyOffset = _chunkEZRBMUXTcjs.d; exports.computeCombinedBoundingBox = _chunkEZRBMUXTcjs.e; exports.createCameraController = _chunkEZRBMUXTcjs.f; exports.createGrid = _chunkEZRBMUXTcjs.g; exports.createLabelLayer = _chunkEZRBMUXTcjs.n; exports.createMeasureTool = _chunkEZRBMUXTcjs.p; exports.createRenderPipeline = _chunkEZRBMUXTcjs.m; exports.createViewGizmo = _chunkEZRBMUXTcjs.h; exports.getThreeMeshesFromComputeResponse = _chunkEZRBMUXTcjs.M; exports.initThree = _chunkEZRBMUXTcjs.u; exports.isEdgeOverlay = _chunkEZRBMUXTcjs.k; exports.parseColor = _chunkEZRBMUXTcjs.c; exports.parseDisplayItems = _chunkEZRBMUXTcjs.v; exports.parseMeshBatchBlob = _chunkEZRBMUXTcjs.K; exports.parseMeshBatchObject = _chunkEZRBMUXTcjs.J; exports.removeEdges = _chunkEZRBMUXTcjs.l; exports.snapToVertex = _chunkEZRBMUXTcjs.o; exports.updateScene = _chunkEZRBMUXTcjs.b;
 //# sourceMappingURL=visualization.cjs.map

package/dist/visualization.d.cts

@@ -1,11 +1,11 @@
 import * as THREE from 'three';
 import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
-import { M as MaterialAppearanceOptions, f as GrasshopperComputeResponse, m as MeshExtractionOptions, n as MeshBatchParsingOptions, o as DisplayBatch, p as DisplayItem } from './types-DxPi5SEx.cjs';
-export { q as DisplayCurve, r as DisplayIdentity, s as DisplayItemBase, t as DisplayPoint, u as DisplayPosition, v as MeshBatch } from './types-DxPi5SEx.cjs';
+import { M as MaterialAppearanceOptions, f as GrasshopperComputeResponse, m as MeshExtractionOptions, n as MeshBatchParsingOptions, o as DisplayBatch, p as DisplayItem } from './types-Ci8Z0-hF.cjs';
+export { q as DisplayCurve, r as DisplayIdentity, s as DisplayItemBase, t as DisplayPoint, u as DisplayPosition, v as MeshBatch } from './types-Ci8Z0-hF.cjs';
 import { CSS2DObject } from 'three/addons/renderers/CSS2DRenderer.js';
 import { LineSegments2 } from 'three/addons/lines/LineSegments2.js';
 import { RhinoModule } from 'rhino3dm';
-import './types-V7G83j5m.cjs';
+import './types-C9YpTbr3.cjs';
 
 type CameraConfig = {
     position?: THREE.Vector3;
@@ -210,12 +210,20 @@ interface CameraController {
      * singularity.
      */
     setViewDirection(direction: THREE.Vector3, animate?: boolean): void;
+    /**
+     * Frame an arbitrary world-space box (e.g. a double-clicked object) from the current view
+     * direction, moving the *active* camera — in 2D mode that means resizing the ortho frustum, not
+     * just translating. No-op on an empty box.
+     */
+    frameBounds(box: THREE.Box3, animate?: boolean): void;
     /** Enable/disable orbit rotation at runtime (pan/zoom unaffected). */
     setRotateEnabled(enabled: boolean): void;
     /** Whether rotation is currently enabled. */
     isRotateEnabled(): boolean;
     /** Keep the orthographic frustum aspect in sync on canvas resize. Called by the resize loop. */
     updateAspect(width: number, height: number): void;
+    /** Cancel any in-flight camera tween. Call on viewer teardown so ticks can't touch disposed controls. */
+    dispose(): void;
 }
 interface CameraControllerDeps {
     scene: THREE.Scene;
@@ -282,14 +290,24 @@ declare function createGrid(options?: GridOptions): Grid;
  *
  * Caller responsibilities (mirror ViewHelper's own contract):
  *  - call {@link ViewGizmo.render} *after* the main scene render each frame (overlay viewport),
- *  - call {@link ViewGizmo.update} each frame (no-op now; kept for API symmetry),
  *  - forward pointer clicks to {@link ViewGizmo.handleClick}.
  */
 interface ViewGizmo {
     render(renderer: THREE.WebGLRenderer): void;
+    /**
+     * @deprecated No-op, kept only for API stability. This wrapper never uses ViewHelper's
+     * click→animate path (see module comment) — view changes snap instantly through the camera
+     * controller — so there is never a gizmo animation to advance. Safe to stop calling.
+     */
     update(delta: number): void;
     /** Hit-test a click. Returns true if it hit the gizmo (and a view change started). */
     handleClick(event: MouseEvent): boolean;
+    /**
+     * @deprecated Always `false`, kept only for API stability. Gizmo clicks snap the view
+     * instantly rather than animating (deliberately — ViewHelper's built-in animation assumes a
+     * Y-up world and rolls the view in this Z-up scene), so there is no animation window to gate
+     * input on.
+     */
     readonly isAnimating: boolean;
     /** Show/hide the gizmo at runtime. Hidden = not rendered and not click-hittable. */
     setVisible(visible: boolean): void;
@@ -392,6 +410,14 @@ interface MeasureDeps {
     canvas: HTMLCanvasElement;
     scene: THREE.Scene;
     getActiveCamera: () => THREE.Camera;
+    /**
+     * The current orbit target (e.g. `controls.target`). Used to scale the line/point pick
+     * threshold with the view: the tolerance is a fraction of the camera→target distance, so it
+     * stays roughly constant on screen wherever the user has framed the model. Optional for
+     * backward compatibility — without it the perspective fallback is the camera's distance to the
+     * world origin, which misjudges the threshold for off-origin content. Thread it in when you can.
+     */
+    getViewTarget?: () => THREE.Vector3;
     labelLayer: LabelLayer;
     options?: MeasureOptions;
 }
@@ -500,6 +526,13 @@ declare const PLASTIC_MATERIAL: THREE.MeshPhysicalMaterial;
 declare const GLASS_MATERIAL: THREE.MeshPhysicalMaterial;
 declare const RUBBER_MATERIAL: THREE.MeshPhysicalMaterial;
 declare const WOOD_MATERIAL: THREE.MeshPhysicalMaterial;
+/**
+ * The module-scope singleton materials above, as a set. Scene-clearing code must NOT dispose a
+ * material in this set: they are shared across meshes and across solves, and `dispose()` on a
+ * still-referenced material forces a shader program rebuild on its next use (and would free any
+ * textures they gain later while other objects still use them).
+ */
+declare const SHARED_MATERIALS: ReadonlySet<THREE.Material>;
 
 declare const threeMaterials_CONCRETE_MATERIAL: typeof CONCRETE_MATERIAL;
 declare const threeMaterials_EMISSIVE_MATERIAL: typeof EMISSIVE_MATERIAL;
@@ -507,9 +540,10 @@ declare const threeMaterials_GLASS_MATERIAL: typeof GLASS_MATERIAL;
 declare const threeMaterials_METAL_MATERIAL: typeof METAL_MATERIAL;
 declare const threeMaterials_PLASTIC_MATERIAL: typeof PLASTIC_MATERIAL;
 declare const threeMaterials_RUBBER_MATERIAL: typeof RUBBER_MATERIAL;
+declare const threeMaterials_SHARED_MATERIALS: typeof SHARED_MATERIALS;
 declare const threeMaterials_WOOD_MATERIAL: typeof WOOD_MATERIAL;
 declare namespace threeMaterials {
-  export { threeMaterials_CONCRETE_MATERIAL as CONCRETE_MATERIAL, threeMaterials_EMISSIVE_MATERIAL as EMISSIVE_MATERIAL, threeMaterials_GLASS_MATERIAL as GLASS_MATERIAL, threeMaterials_METAL_MATERIAL as METAL_MATERIAL, threeMaterials_PLASTIC_MATERIAL as PLASTIC_MATERIAL, threeMaterials_RUBBER_MATERIAL as RUBBER_MATERIAL, threeMaterials_WOOD_MATERIAL as WOOD_MATERIAL };
+  export { threeMaterials_CONCRETE_MATERIAL as CONCRETE_MATERIAL, threeMaterials_EMISSIVE_MATERIAL as EMISSIVE_MATERIAL, threeMaterials_GLASS_MATERIAL as GLASS_MATERIAL, threeMaterials_METAL_MATERIAL as METAL_MATERIAL, threeMaterials_PLASTIC_MATERIAL as PLASTIC_MATERIAL, threeMaterials_RUBBER_MATERIAL as RUBBER_MATERIAL, threeMaterials_SHARED_MATERIALS as SHARED_MATERIALS, threeMaterials_WOOD_MATERIAL as WOOD_MATERIAL };
 }
 
 /**
@@ -588,6 +622,12 @@ interface RenderPipelineOptions {
 }
 declare function createRenderPipeline(renderer: THREE.WebGLRenderer, scene: THREE.Scene, camera: THREE.Camera, width: number, height: number, options: RenderPipelineOptions): RenderPipeline;
 
+/**
+ * Metres per model unit, keyed by Rhino `UnitSystem` name (the `modelunits` string on the compute
+ * response). Imperial factors are the exact international definitions (1 in = 0.0254 m,
+ * 1 ft = 0.3048 m, 1 mi = 1609.344 m). Units not in this table scale 1 and log a one-time warning
+ * — see {@link getScaleFactor}.
+ */
 declare const SCALE_FACTORS: Record<string, number>;
 /**
  * Extracts and processes display meshes from a ComputePointerResponse using the Grasshopper WebDisplay component.
@@ -595,7 +635,9 @@ declare const SCALE_FACTORS: Record<string, number>;
  * This is the primary entry point for extracting mesh geometry from Grasshopper compute responses.
  * It handles all aspects of mesh processing: decompression, coordinate transformation, scaling, and positioning.
  *
- * **Note:** Mesh decompression happens asynchronously in a Web Worker to prevent UI blocking.
+ * **Note:** The entire pipeline (base64 decode, inflate, dequantization, mesh construction) runs
+ * synchronously on the calling thread — large batches will block the UI for their duration. The
+ * function is `async` only so its shape can stay stable if parsing moves off-thread later.
  *
  * @param data - The ComputePointerResponse containing Grasshopper output trees.
  * @param options - Configuration for mesh extraction and parsing behavior. All options are optional with sensible defaults.
@@ -606,7 +648,7 @@ declare const SCALE_FACTORS: Record<string, number>;
  * - Only works with the WebDisplay component of GHHeadless.
  * - Requires changes to Rhino.Compute (see https://github.com/TheVessen/compute.rhino3d).
  * - Provides a performant way to display mesh data in Three.js.
- * - Decompression is performed in a Web Worker for non-blocking UI updates.
+ * - All decoding is synchronous on the main thread; there is no Web Worker offload today.
  * - Supports mesh metadata (names, user data) if provided in the compute response.
  *
  * @internal Internal helper: high-level extraction remains public via visualization module, but this
@@ -651,9 +693,14 @@ interface ParseTelemetry {
  * over the blob. The function stays `async` so callers don't have to change shape if we move
  * parsing into a worker later.
  *
+ * A batch with no `compressedData` (genuinely empty/absent geometry) resolves to `[]`. A corrupt,
+ * truncated, or unsupported blob throws so callers get a signal instead of a silent empty scene —
+ * `getThreeMeshesFromComputeResponse` documents (and now delivers) exactly that rethrow.
+ *
  * @param batch - DisplayBatch object
  * @param options - Rendering options
  * @returns Promise resolving to array of Three.js mesh objects
+ * @throws {RhinoComputeError} On a corrupt/truncated/unsupported mesh blob or malformed group metadata.
  */
 declare function parseMeshBatchObject(batch: DisplayBatch, options?: MeshBatchParsingOptions, 
 /** @internal Timings threaded from an outer entry point; not a caller option. */
@@ -669,13 +716,20 @@ telemetry?: ParseTelemetry): Promise<THREE.Mesh[]>;
  * @param blob - Raw blob bytes from a binary WebSocket frame.
  * @param options - Rendering options.
  * @returns Promise resolving to array of Three.js mesh objects.
+ * @throws {RhinoComputeError} On a corrupt/truncated/unsupported mesh blob or malformed group metadata.
  */
 declare function parseMeshBatchBlob(blob: ArrayBuffer | Uint8Array, options?: MeshBatchParsingOptions): Promise<THREE.Mesh[]>;
 
 interface DisplayItemParseOptions {
     /** rhino3dm instance for decoding curve JSON. Omit to skip curves (points still render). */
     rhino?: RhinoModule;
-    /** Apply the Rhino Z-up → Three Y-up transform. Defaults to true (matches the mesh path). */
+    /**
+     * No-op. Historically toggled the Rhino Z-up → Three Y-up rotation, but the pipeline now keeps
+     * one coordinate frame end to end ({@link rhinoToThree} is the identity), so this flag no longer
+     * changes the result. Do NOT pre-rotate your own geometry to compensate — none is applied.
+     *
+     * @deprecated Retained only so existing call sites compile unchanged; has no effect.
+     */
     applyTransforms?: boolean;
 }
 /**