@selvajs/compute 3.1.0-beta.3 → 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-DGeAQnkB.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-B-JygDUF.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-CTZ4ZOSM.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-QAOHGIFT.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-B-JygDUF.d.ts → types-Ci8Z0-hF.d.cts}

@@ -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.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,18 +230,34 @@ 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;
-    /** Base64 encoded algorithm (always present in response) */
-    algo: string;
+    /**
+     * The server echoes the request's full base64 definition back as `algo`, but the client strips
+     * it before returning — retaining it would pin a multi-MB copy of the definition per response,
+     * multiplied by every cache that holds responses. Always `undefined` on client-returned
+     * responses (inherited optional field from {@link GrasshopperDefinitionSource}).
+     */
+    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 */
@@ -362,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;
@@ -385,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;
 }
 /**
@@ -416,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;
@@ -495,6 +543,30 @@ interface MeshBatchParsingOptions {
     applyTransforms?: boolean;
     /** Enable performance monitoring in console. Defaults to false. */
     debug?: boolean;
+    /**
+     * Appearance dials applied to every material built from this batch. These drive how "rendered"
+     * vs "matte technical" the meshes look; they are set once at parse time (materials are rebuilt
+     * per solve). Runtime restyling of an already-built scene lives in the viewer's `setRenderStyle`.
+     */
+    material?: MaterialAppearanceOptions;
+}
+/**
+ * How compute meshes read visually. Bundled so a caller can pick a coherent look ('technical' vs
+ * 'rendered') by setting all three together rather than dialing each in isolation.
+ */
+interface MaterialAppearanceOptions {
+    /**
+     * Multiplier on the HDR image-based-lighting reflection strength. ~0.5 reads matte/technical,
+     * ~1.3 reads glossy/presentation. Default 1 (three.js's own default — unchanged look).
+     */
+    envMapIntensity?: number;
+    /**
+     * Cull back faces (`THREE.FrontSide`) instead of rendering both sides (`THREE.DoubleSide`).
+     * FrontSide gives cleaner interior shading, a crisper silhouette, and less overdraw on closed
+     * solids — but open surfaces (which Rhino also emits) then vanish when viewed from behind.
+     * Default false (keep DoubleSide) to stay safe for surface geometry.
+     */
+    cullBackfaces?: boolean;
 }
 /**
  * Options for extracting and processing meshes from compute responses.
@@ -515,4 +587,4 @@ interface MeshExtractionOptions {
     debug?: boolean;
 }
 
-export type { BooleanInputType as B, DataItem as D, FileInputType as F, GeometryInputType as G, InnerTreeData as I, MeshExtractionOptions as M, NumericInputType as N, OutputParamSchema as O, TextInputType as T, ValueListInputType as V, DataTree as a, DataTreeDefault as b, DataTreePath as c, DefaultValue as d, GrasshopperComputeConfig as e, GrasshopperComputeResponse as f, GrasshopperParsedIO as g, GrasshopperParsedIORaw as h, GrasshopperRequestSchema as i, InputParam as j, InputParamSchema as k, OutputType as l, MeshBatchParsingOptions as m, DisplayBatch as n, DisplayItem as o, DisplayCurve as p, DisplayIdentity as q, DisplayItemBase as r, DisplayPoint as s, DisplayPosition as t, MeshBatch as u };
+export type { BooleanInputType as B, DataItem as D, FileInputType as F, GeometryInputType as G, InnerTreeData as I, MaterialAppearanceOptions as M, NumericInputType as N, OutputParamSchema as O, TextInputType as T, ValueListInputType as V, DataTree as a, DataTreeDefault as b, DataTreePath as c, DefaultValue as d, GrasshopperComputeConfig as e, GrasshopperComputeResponse as f, GrasshopperParsedIO as g, GrasshopperParsedIORaw as h, GrasshopperRequestSchema as i, InputParam as j, InputParamSchema as k, OutputType as l, MeshExtractionOptions as m, MeshBatchParsingOptions as n, DisplayBatch as o, DisplayItem as p, DisplayCurve as q, DisplayIdentity as r, DisplayItemBase as s, DisplayPoint as t, DisplayPosition as u, MeshBatch as v };

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

@@ -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.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,18 +230,34 @@ 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;
-    /** Base64 encoded algorithm (always present in response) */
-    algo: string;
+    /**
+     * The server echoes the request's full base64 definition back as `algo`, but the client strips
+     * it before returning — retaining it would pin a multi-MB copy of the definition per response,
+     * multiplied by every cache that holds responses. Always `undefined` on client-returned
+     * responses (inherited optional field from {@link GrasshopperDefinitionSource}).
+     */
+    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 */
@@ -362,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;
@@ -385,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;
 }
 /**
@@ -416,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;
@@ -495,6 +543,30 @@ interface MeshBatchParsingOptions {
     applyTransforms?: boolean;
     /** Enable performance monitoring in console. Defaults to false. */
     debug?: boolean;
+    /**
+     * Appearance dials applied to every material built from this batch. These drive how "rendered"
+     * vs "matte technical" the meshes look; they are set once at parse time (materials are rebuilt
+     * per solve). Runtime restyling of an already-built scene lives in the viewer's `setRenderStyle`.
+     */
+    material?: MaterialAppearanceOptions;
+}
+/**
+ * How compute meshes read visually. Bundled so a caller can pick a coherent look ('technical' vs
+ * 'rendered') by setting all three together rather than dialing each in isolation.
+ */
+interface MaterialAppearanceOptions {
+    /**
+     * Multiplier on the HDR image-based-lighting reflection strength. ~0.5 reads matte/technical,
+     * ~1.3 reads glossy/presentation. Default 1 (three.js's own default — unchanged look).
+     */
+    envMapIntensity?: number;
+    /**
+     * Cull back faces (`THREE.FrontSide`) instead of rendering both sides (`THREE.DoubleSide`).
+     * FrontSide gives cleaner interior shading, a crisper silhouette, and less overdraw on closed
+     * solids — but open surfaces (which Rhino also emits) then vanish when viewed from behind.
+     * Default false (keep DoubleSide) to stay safe for surface geometry.
+     */
+    cullBackfaces?: boolean;
 }
 /**
  * Options for extracting and processing meshes from compute responses.
@@ -515,4 +587,4 @@ interface MeshExtractionOptions {
     debug?: boolean;
 }
 
-export type { BooleanInputType as B, DataItem as D, FileInputType as F, GeometryInputType as G, InnerTreeData as I, MeshExtractionOptions as M, NumericInputType as N, OutputParamSchema as O, TextInputType as T, ValueListInputType as V, DataTree as a, DataTreeDefault as b, DataTreePath as c, DefaultValue as d, GrasshopperComputeConfig as e, GrasshopperComputeResponse as f, GrasshopperParsedIO as g, GrasshopperParsedIORaw as h, GrasshopperRequestSchema as i, InputParam as j, InputParamSchema as k, OutputType as l, MeshBatchParsingOptions as m, DisplayBatch as n, DisplayItem as o, DisplayCurve as p, DisplayIdentity as q, DisplayItemBase as r, DisplayPoint as s, DisplayPosition as t, MeshBatch as u };
+export type { BooleanInputType as B, DataItem as D, FileInputType as F, GeometryInputType as G, InnerTreeData as I, MaterialAppearanceOptions as M, NumericInputType as N, OutputParamSchema as O, TextInputType as T, ValueListInputType as V, DataTree as a, DataTreeDefault as b, DataTreePath as c, DefaultValue as d, GrasshopperComputeConfig as e, GrasshopperComputeResponse as f, GrasshopperParsedIO as g, GrasshopperParsedIORaw as h, GrasshopperRequestSchema as i, InputParam as j, InputParamSchema as k, OutputType as l, MeshExtractionOptions as m, MeshBatchParsingOptions as n, DisplayBatch as o, DisplayItem as p, DisplayCurve as q, DisplayIdentity as r, DisplayItemBase as s, DisplayPoint as t, DisplayPosition as u, MeshBatch as v };

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 _chunkL3CNT26Scjs = require('./chunk-L3CNT26S.cjs');require('./chunk-EUMIGWRX.cjs');exports.EDGE_USERDATA_KIND = _chunkL3CNT26Scjs.h; exports.Materials = _chunkL3CNT26Scjs.q; exports.SCALE_FACTORS = _chunkL3CNT26Scjs.D; exports.addEdges = _chunkL3CNT26Scjs.i; exports.applyOffset = _chunkL3CNT26Scjs.c; exports.computeCombinedBoundingBox = _chunkL3CNT26Scjs.d; exports.createCameraController = _chunkL3CNT26Scjs.e; exports.createGrid = _chunkL3CNT26Scjs.f; exports.createLabelLayer = _chunkL3CNT26Scjs.m; exports.createMeasureTool = _chunkL3CNT26Scjs.o; exports.createRenderPipeline = _chunkL3CNT26Scjs.l; exports.createViewGizmo = _chunkL3CNT26Scjs.g; exports.getThreeMeshesFromComputeResponse = _chunkL3CNT26Scjs.E; exports.initThree = _chunkL3CNT26Scjs.p; exports.isEdgeOverlay = _chunkL3CNT26Scjs.j; exports.parseColor = _chunkL3CNT26Scjs.b; exports.parseDisplayItems = _chunkL3CNT26Scjs.r; exports.parseMeshBatchBlob = _chunkL3CNT26Scjs.C; exports.parseMeshBatchObject = _chunkL3CNT26Scjs.B; exports.removeEdges = _chunkL3CNT26Scjs.k; exports.snapToVertex = _chunkL3CNT26Scjs.n; exports.updateScene = _chunkL3CNT26Scjs.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