@selvajs/compute 1.5.3 → 2.0.0-beta.1

package/dist/{types-Dfeei0dD.d.cts → types-CJ092lxB.d.cts}

@@ -1,54 +1,4 @@
-/**
- * Rhino model unit types supported by Rhino.Compute
- */
-type RhinoModelUnit = 'None' | 'Microns' | 'Millimeters' | 'Centimeters' | 'Meters' | 'Kilometers' | 'Microinches' | 'Mils' | 'Inches' | 'Feet' | 'Miles' | 'CustomUnits' | 'Angstroms' | 'Nanometers' | 'Decimeters' | 'Dekameters' | 'Hectometers' | 'Megameters' | 'Gigameters' | 'Yards' | 'PrinterPoints' | 'PrinterPicas' | 'NauticalMiles' | 'AstronomicalUnits' | 'LightYears' | 'Parsecs' | 'Unset';
-/**
- * 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.
- */
-interface RetryPolicy {
-    /** Maximum number of retry attempts after the initial request (default: 0). */
-    attempts?: number;
-    /** Base delay in milliseconds for exponential backoff (default: 500). */
-    baseDelayMs?: number;
-    /** Upper bound for backoff delay (default: 30_000). */
-    maxDelayMs?: number;
-    /** Whether to retry on 429 responses (default: true — honors Retry-After). */
-    retryOn429?: boolean;
-}
-interface ComputeConfig {
-    /** The base URL of the Rhino Compute server (e.g., http://localhost:6500) */
-    serverUrl: string;
-    /** Optional API key for authenticating with the server (RhinoComputeKey) */
-    apiKey?: string;
-    /** Optional Bearer token for authentication (e.g., when behind a proxy or API gateway) */
-    authToken?: string;
-    /** Enable debug logging to the console */
-    debug?: boolean;
-    /** Suppress browser security warnings in the console */
-    suppressBrowserWarning?: boolean;
-    /** @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.
-     *
-     * Uses `AbortSignal.timeout` so the timer is not throttled when the tab is hidden.
-     */
-    timeoutMs?: number;
-    /**
-     * Retry policy for transient errors. Default: no retries.
-     */
-    retry?: RetryPolicy;
-    /**
-     * Optional caller-supplied AbortSignal. Composes with the internal timeout —
-     * whichever fires first wins. Lets callers cancel in-flight requests
-     * (e.g. on component unmount or when superseding a stale solve).
-     */
-    signal?: AbortSignal;
-}
+import { C as ComputeConfig, a as RhinoModelUnit } from './types-D1SkNje_.cjs';
 
 /**
  * Grasshopper types
@@ -230,26 +180,6 @@ interface GrasshopperComputeConfig extends ComputeConfig {
     /** Whether to use cached solution */
     cachesolve?: boolean | null;
 }
-/**
- * Raw I/O response schema from API (PascalCase)
- *
- * This is the direct response format from the Rhino Compute server API.
- * All property names are in PascalCase, which is typical for .NET APIs.
- * This raw response is converted to camelCase by the camelcaseKeys() function
- * in the fetchDefinitionIO() method.
- */
-interface IoResponseSchema {
-    description: string;
-    filename: string;
-    cachekey: string;
-    inputnames: string[];
-    outputnames: string[];
-    icon: string | null;
-    inputs: InputParamSchema[];
-    outputs: OutputParamSchema[];
-    warnings: any[];
-    errors: any[];
-}
 /**
  * Arguments sent to Grasshopper compute endpoint
  * Includes config options + definition source + input values
@@ -324,11 +254,20 @@ interface InputParamSchema {
     groupName?: string | null;
 }
 /**
- * Parsed input/output structure with raw schemas
+ * Parsed input/output structure with raw schemas.
+ *
+ * `loadWarnings` / `loadErrors` carry the server's definition-load diagnostics
+ * (missing plugin, broken component, etc.) from the `/io` response. They are
+ * distinct from per-input parse failures (`InputParseError`): these come from
+ * the server loading the definition, those from the client typing an input.
  */
 interface GrasshopperParsedIORaw {
     inputs: InputParamSchema[];
     outputs: OutputParamSchema[];
+    /** Server-side definition-load warnings, if any. */
+    loadWarnings?: string[];
+    /** Server-side definition-load errors, if any (e.g. missing plugin). */
+    loadErrors?: string[];
 }
 /**
  * Per-input parse failure. The corresponding entry in `inputs` was filled
@@ -357,6 +296,110 @@ interface GrasshopperParsedIO {
     inputs: InputParam[];
     outputs: OutputParamSchema[];
     parseErrors?: InputParseError[];
+    /**
+     * Server-side definition-load warnings from the `/io` response (e.g. an
+     * obsolete component). Surface these so the user understands a degraded IO
+     * list. Distinct from `parseErrors` (client-side input typing failures).
+     */
+    loadWarnings?: string[];
+    /**
+     * Server-side definition-load errors from the `/io` response (e.g. a missing
+     * plugin that left inputs unresolved). When present, the inputs/outputs may
+     * be incomplete — the user needs to fix their server/definition.
+     */
+    loadErrors?: string[];
+}
+
+/**
+ * Material properties for Three.js rendering.
+ */
+interface SerializableMaterial {
+    color: string;
+    metalness: number;
+    roughness: number;
+    opacity: number;
+    transparent: boolean;
+}
+/**
+ * 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`
+ */
+interface MeshMetadata {
+    name: string;
+    /** Layer path for grouping in the scene manager (e.g. 'Structure/Walls') */
+    layer: string;
+    /** Original index in the GH input tree before material grouping. Combined with
+     *  MeshBatch.sourceComponentId to uniquely identify the GH source geometry. */
+    originalIndex: number;
+    /** Number of vertices in this mesh (each vertex is 3 components: x, y, z). */
+    vertexCount: number;
+    /** Number of indices in this mesh (3 per triangle). */
+    indexCount: number;
+    /** Index of this mesh's first vertex in the combined vertex array, in vertex-count units.
+     *  The corresponding component offset into the int16/float32 typed array is `vertexStart * 3`. */
+    vertexStart: number;
+    /** Index of this mesh's first index in the combined index array, in index-count units. */
+    indexStart: number;
+    /** Arbitrary key-value pairs from the GH Metadata input */
+    metadata?: Record<string, string>;
+}
+/**
+ * A group of meshes sharing the same material.
+ */
+interface MaterialGroup {
+    /** Reference to the material ID in the materials array */
+    materialId: number;
+    /** Individual meshes in this group */
+    meshes: MeshMetadata[];
+}
+/**
+ * Batched mesh data optimized for Three.js rendering.
+ *
+ * `compressedData` contains the binary "SLVA" blob (header + metadata JSON + quantized int16 or
+ * float32 vertices + uint32 indices), base64-encoded for transit inside the values JSON envelope.
+ * The blob is opaque to the outer JSON: a future binary WebSocket frame can drop the base64 step
+ * without changing this shape.
+ */
+interface MeshBatch {
+    /** Array of unique materials */
+    materials: SerializableMaterial[];
+    /** Groups of meshes organized by material */
+    groups: MaterialGroup[];
+    /** Base64-encoded binary blob (SLVA wire format). */
+    compressedData: string;
+    /** InstanceGuid of the WebDisplay GH component that produced this batch.
+     *  Combined with MeshMetadata.originalIndex to backtrack any mesh to its GH source. */
+    sourceComponentId?: string;
+}
+/**
+ * Options for parsing mesh batch data.
+ */
+interface MeshBatchParsingOptions {
+    /** Merge meshes with same material into single geometry (better performance). Defaults to true. */
+    mergeByMaterial?: boolean;
+    /** Apply coordinate system transformations (Rhino Z-up to Three.js Y-up). Defaults to true. */
+    applyTransforms?: boolean;
+    /** Enable performance monitoring in console. Defaults to false. */
+    debug?: boolean;
+}
+/**
+ * Options for extracting and processing meshes from compute responses.
+ */
+interface MeshExtractionOptions {
+    /** Configuration for parsing mesh batches. */
+    parsing?: MeshBatchParsingOptions;
+    /** Apply scaling based on model units. Defaults to true. */
+    allowScaling?: boolean;
+    /** Apply automatic ground offset positioning (Z=0). Defaults to true. */
+    allowAutoPosition?: boolean;
+    /** Enable verbose logging. Defaults to false. */
+    debug?: boolean;
 }
 
-export type { BooleanInputType as B, ComputeConfig as C, DataItem as D, FileInputType as F, GeometryInputType as G, InnerTreeData as I, NumericInputType as N, OutputParamSchema as O, RetryPolicy as R, 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, RhinoModelUnit as m, IoResponseSchema as n };
+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, MeshBatch as n };

package/dist/types-D1SkNje_.d.cts

@@ -0,0 +1,87 @@
+/**
+ * Rhino model unit types supported by Rhino.Compute
+ */
+type RhinoModelUnit = 'None' | 'Microns' | 'Millimeters' | 'Centimeters' | 'Meters' | 'Kilometers' | 'Microinches' | 'Mils' | 'Inches' | 'Feet' | 'Miles' | 'CustomUnits' | 'Angstroms' | 'Nanometers' | 'Decimeters' | 'Dekameters' | 'Hectometers' | 'Megameters' | 'Gigameters' | 'Yards' | 'PrinterPoints' | 'PrinterPicas' | 'NauticalMiles' | 'AstronomicalUnits' | 'LightYears' | 'Parsecs' | 'Unset';
+/**
+ * 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.
+ */
+interface RetryPolicy {
+    /** Maximum number of retry attempts after the initial request (default: 0). */
+    attempts?: number;
+    /** Base delay in milliseconds for exponential backoff (default: 500). */
+    baseDelayMs?: number;
+    /** Upper bound for backoff delay (default: 30_000). */
+    maxDelayMs?: number;
+    /** Whether to retry on 429 responses (default: true — honors Retry-After). */
+    retryOn429?: boolean;
+}
+interface ComputeConfig {
+    /**
+     * The base URL of the Rhino Compute server (e.g., http://localhost:6500).
+     *
+     * This should point at the `rhino.compute` front (the reverse proxy), not a
+     * bare `compute.geometry` child process. `ComputeServerStats` relies on the
+     * proxy-only endpoints `/healthcheck` and `/activechildren`; targeting a
+     * bare `compute.geometry` would make `isServerOnline()` 404 even though
+     * `/grasshopper` would still solve.
+     */
+    serverUrl: string;
+    /** Optional API key for authenticating with the server (RhinoComputeKey) */
+    apiKey?: string;
+    /** Optional Bearer token for authentication (e.g., when behind a proxy or API gateway) */
+    authToken?: string;
+    /** Enable debug logging to the console */
+    debug?: boolean;
+    /** Suppress browser security warnings in the console */
+    suppressBrowserWarning?: boolean;
+    /** @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.
+     *
+     * Uses `AbortSignal.timeout` so the timer is not throttled when the tab is hidden.
+     */
+    timeoutMs?: number;
+    /**
+     * Retry policy for transient errors. Default: no retries.
+     */
+    retry?: RetryPolicy;
+    /**
+     * Optional caller-supplied AbortSignal. Composes with the internal timeout —
+     * whichever fires first wins. Lets callers cancel in-flight requests
+     * (e.g. on component unmount or when superseding a stale solve).
+     */
+    signal?: AbortSignal;
+    /**
+     * Optional callback invoked with the server's per-request `Server-Timing`
+     * 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
+     * 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.
+     */
+    onServerTiming?: (timing: ServerTiming) => void;
+}
+/**
+ * Parsed `Server-Timing` metrics from a Compute response. Durations are in
+ * milliseconds. Any metric the server omits is `undefined`. `raw` is the
+ * original header value, preserved so callers can read non-standard metrics.
+ */
+interface ServerTiming {
+    /** Time the server spent decoding the request (deserialize + load definition). */
+    decode?: number;
+    /** Time spent actually solving the Grasshopper definition. */
+    solve?: number;
+    /** Time spent encoding the response (serialize geometry). */
+    encode?: number;
+    /** The raw `Server-Timing` header value, e.g. `decode;dur=3, solve;dur=120, encode;dur=8`. */
+    raw: string;
+}
+
+export type { ComputeConfig as C, RetryPolicy as R, ServerTiming as S, RhinoModelUnit as a };

package/dist/types-D1SkNje_.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Rhino model unit types supported by Rhino.Compute
+ */
+type RhinoModelUnit = 'None' | 'Microns' | 'Millimeters' | 'Centimeters' | 'Meters' | 'Kilometers' | 'Microinches' | 'Mils' | 'Inches' | 'Feet' | 'Miles' | 'CustomUnits' | 'Angstroms' | 'Nanometers' | 'Decimeters' | 'Dekameters' | 'Hectometers' | 'Megameters' | 'Gigameters' | 'Yards' | 'PrinterPoints' | 'PrinterPicas' | 'NauticalMiles' | 'AstronomicalUnits' | 'LightYears' | 'Parsecs' | 'Unset';
+/**
+ * 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.
+ */
+interface RetryPolicy {
+    /** Maximum number of retry attempts after the initial request (default: 0). */
+    attempts?: number;
+    /** Base delay in milliseconds for exponential backoff (default: 500). */
+    baseDelayMs?: number;
+    /** Upper bound for backoff delay (default: 30_000). */
+    maxDelayMs?: number;
+    /** Whether to retry on 429 responses (default: true — honors Retry-After). */
+    retryOn429?: boolean;
+}
+interface ComputeConfig {
+    /**
+     * The base URL of the Rhino Compute server (e.g., http://localhost:6500).
+     *
+     * This should point at the `rhino.compute` front (the reverse proxy), not a
+     * bare `compute.geometry` child process. `ComputeServerStats` relies on the
+     * proxy-only endpoints `/healthcheck` and `/activechildren`; targeting a
+     * bare `compute.geometry` would make `isServerOnline()` 404 even though
+     * `/grasshopper` would still solve.
+     */
+    serverUrl: string;
+    /** Optional API key for authenticating with the server (RhinoComputeKey) */
+    apiKey?: string;
+    /** Optional Bearer token for authentication (e.g., when behind a proxy or API gateway) */
+    authToken?: string;
+    /** Enable debug logging to the console */
+    debug?: boolean;
+    /** Suppress browser security warnings in the console */
+    suppressBrowserWarning?: boolean;
+    /** @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.
+     *
+     * Uses `AbortSignal.timeout` so the timer is not throttled when the tab is hidden.
+     */
+    timeoutMs?: number;
+    /**
+     * Retry policy for transient errors. Default: no retries.
+     */
+    retry?: RetryPolicy;
+    /**
+     * Optional caller-supplied AbortSignal. Composes with the internal timeout —
+     * whichever fires first wins. Lets callers cancel in-flight requests
+     * (e.g. on component unmount or when superseding a stale solve).
+     */
+    signal?: AbortSignal;
+    /**
+     * Optional callback invoked with the server's per-request `Server-Timing`
+     * 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
+     * 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.
+     */
+    onServerTiming?: (timing: ServerTiming) => void;
+}
+/**
+ * Parsed `Server-Timing` metrics from a Compute response. Durations are in
+ * milliseconds. Any metric the server omits is `undefined`. `raw` is the
+ * original header value, preserved so callers can read non-standard metrics.
+ */
+interface ServerTiming {
+    /** Time the server spent decoding the request (deserialize + load definition). */
+    decode?: number;
+    /** Time spent actually solving the Grasshopper definition. */
+    solve?: number;
+    /** Time spent encoding the response (serialize geometry). */
+    encode?: number;
+    /** The raw `Server-Timing` header value, e.g. `decode;dur=3, solve;dur=120, encode;dur=8`. */
+    raw: string;
+}
+
+export type { ComputeConfig as C, RetryPolicy as R, ServerTiming as S, RhinoModelUnit as a };

package/dist/{types-Dfeei0dD.d.ts → types-XCUrJGby.d.ts}

@@ -1,54 +1,4 @@
-/**
- * Rhino model unit types supported by Rhino.Compute
- */
-type RhinoModelUnit = 'None' | 'Microns' | 'Millimeters' | 'Centimeters' | 'Meters' | 'Kilometers' | 'Microinches' | 'Mils' | 'Inches' | 'Feet' | 'Miles' | 'CustomUnits' | 'Angstroms' | 'Nanometers' | 'Decimeters' | 'Dekameters' | 'Hectometers' | 'Megameters' | 'Gigameters' | 'Yards' | 'PrinterPoints' | 'PrinterPicas' | 'NauticalMiles' | 'AstronomicalUnits' | 'LightYears' | 'Parsecs' | 'Unset';
-/**
- * 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.
- */
-interface RetryPolicy {
-    /** Maximum number of retry attempts after the initial request (default: 0). */
-    attempts?: number;
-    /** Base delay in milliseconds for exponential backoff (default: 500). */
-    baseDelayMs?: number;
-    /** Upper bound for backoff delay (default: 30_000). */
-    maxDelayMs?: number;
-    /** Whether to retry on 429 responses (default: true — honors Retry-After). */
-    retryOn429?: boolean;
-}
-interface ComputeConfig {
-    /** The base URL of the Rhino Compute server (e.g., http://localhost:6500) */
-    serverUrl: string;
-    /** Optional API key for authenticating with the server (RhinoComputeKey) */
-    apiKey?: string;
-    /** Optional Bearer token for authentication (e.g., when behind a proxy or API gateway) */
-    authToken?: string;
-    /** Enable debug logging to the console */
-    debug?: boolean;
-    /** Suppress browser security warnings in the console */
-    suppressBrowserWarning?: boolean;
-    /** @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.
-     *
-     * Uses `AbortSignal.timeout` so the timer is not throttled when the tab is hidden.
-     */
-    timeoutMs?: number;
-    /**
-     * Retry policy for transient errors. Default: no retries.
-     */
-    retry?: RetryPolicy;
-    /**
-     * Optional caller-supplied AbortSignal. Composes with the internal timeout —
-     * whichever fires first wins. Lets callers cancel in-flight requests
-     * (e.g. on component unmount or when superseding a stale solve).
-     */
-    signal?: AbortSignal;
-}
+import { C as ComputeConfig, a as RhinoModelUnit } from './types-D1SkNje_.js';
 
 /**
  * Grasshopper types
@@ -230,26 +180,6 @@ interface GrasshopperComputeConfig extends ComputeConfig {
     /** Whether to use cached solution */
     cachesolve?: boolean | null;
 }
-/**
- * Raw I/O response schema from API (PascalCase)
- *
- * This is the direct response format from the Rhino Compute server API.
- * All property names are in PascalCase, which is typical for .NET APIs.
- * This raw response is converted to camelCase by the camelcaseKeys() function
- * in the fetchDefinitionIO() method.
- */
-interface IoResponseSchema {
-    description: string;
-    filename: string;
-    cachekey: string;
-    inputnames: string[];
-    outputnames: string[];
-    icon: string | null;
-    inputs: InputParamSchema[];
-    outputs: OutputParamSchema[];
-    warnings: any[];
-    errors: any[];
-}
 /**
  * Arguments sent to Grasshopper compute endpoint
  * Includes config options + definition source + input values
@@ -324,11 +254,20 @@ interface InputParamSchema {
     groupName?: string | null;
 }
 /**
- * Parsed input/output structure with raw schemas
+ * Parsed input/output structure with raw schemas.
+ *
+ * `loadWarnings` / `loadErrors` carry the server's definition-load diagnostics
+ * (missing plugin, broken component, etc.) from the `/io` response. They are
+ * distinct from per-input parse failures (`InputParseError`): these come from
+ * the server loading the definition, those from the client typing an input.
  */
 interface GrasshopperParsedIORaw {
     inputs: InputParamSchema[];
     outputs: OutputParamSchema[];
+    /** Server-side definition-load warnings, if any. */
+    loadWarnings?: string[];
+    /** Server-side definition-load errors, if any (e.g. missing plugin). */
+    loadErrors?: string[];
 }
 /**
  * Per-input parse failure. The corresponding entry in `inputs` was filled
@@ -357,6 +296,110 @@ interface GrasshopperParsedIO {
     inputs: InputParam[];
     outputs: OutputParamSchema[];
     parseErrors?: InputParseError[];
+    /**
+     * Server-side definition-load warnings from the `/io` response (e.g. an
+     * obsolete component). Surface these so the user understands a degraded IO
+     * list. Distinct from `parseErrors` (client-side input typing failures).
+     */
+    loadWarnings?: string[];
+    /**
+     * Server-side definition-load errors from the `/io` response (e.g. a missing
+     * plugin that left inputs unresolved). When present, the inputs/outputs may
+     * be incomplete — the user needs to fix their server/definition.
+     */
+    loadErrors?: string[];
+}
+
+/**
+ * Material properties for Three.js rendering.
+ */
+interface SerializableMaterial {
+    color: string;
+    metalness: number;
+    roughness: number;
+    opacity: number;
+    transparent: boolean;
+}
+/**
+ * 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`
+ */
+interface MeshMetadata {
+    name: string;
+    /** Layer path for grouping in the scene manager (e.g. 'Structure/Walls') */
+    layer: string;
+    /** Original index in the GH input tree before material grouping. Combined with
+     *  MeshBatch.sourceComponentId to uniquely identify the GH source geometry. */
+    originalIndex: number;
+    /** Number of vertices in this mesh (each vertex is 3 components: x, y, z). */
+    vertexCount: number;
+    /** Number of indices in this mesh (3 per triangle). */
+    indexCount: number;
+    /** Index of this mesh's first vertex in the combined vertex array, in vertex-count units.
+     *  The corresponding component offset into the int16/float32 typed array is `vertexStart * 3`. */
+    vertexStart: number;
+    /** Index of this mesh's first index in the combined index array, in index-count units. */
+    indexStart: number;
+    /** Arbitrary key-value pairs from the GH Metadata input */
+    metadata?: Record<string, string>;
+}
+/**
+ * A group of meshes sharing the same material.
+ */
+interface MaterialGroup {
+    /** Reference to the material ID in the materials array */
+    materialId: number;
+    /** Individual meshes in this group */
+    meshes: MeshMetadata[];
+}
+/**
+ * Batched mesh data optimized for Three.js rendering.
+ *
+ * `compressedData` contains the binary "SLVA" blob (header + metadata JSON + quantized int16 or
+ * float32 vertices + uint32 indices), base64-encoded for transit inside the values JSON envelope.
+ * The blob is opaque to the outer JSON: a future binary WebSocket frame can drop the base64 step
+ * without changing this shape.
+ */
+interface MeshBatch {
+    /** Array of unique materials */
+    materials: SerializableMaterial[];
+    /** Groups of meshes organized by material */
+    groups: MaterialGroup[];
+    /** Base64-encoded binary blob (SLVA wire format). */
+    compressedData: string;
+    /** InstanceGuid of the WebDisplay GH component that produced this batch.
+     *  Combined with MeshMetadata.originalIndex to backtrack any mesh to its GH source. */
+    sourceComponentId?: string;
+}
+/**
+ * Options for parsing mesh batch data.
+ */
+interface MeshBatchParsingOptions {
+    /** Merge meshes with same material into single geometry (better performance). Defaults to true. */
+    mergeByMaterial?: boolean;
+    /** Apply coordinate system transformations (Rhino Z-up to Three.js Y-up). Defaults to true. */
+    applyTransforms?: boolean;
+    /** Enable performance monitoring in console. Defaults to false. */
+    debug?: boolean;
+}
+/**
+ * Options for extracting and processing meshes from compute responses.
+ */
+interface MeshExtractionOptions {
+    /** Configuration for parsing mesh batches. */
+    parsing?: MeshBatchParsingOptions;
+    /** Apply scaling based on model units. Defaults to true. */
+    allowScaling?: boolean;
+    /** Apply automatic ground offset positioning (Z=0). Defaults to true. */
+    allowAutoPosition?: boolean;
+    /** Enable verbose logging. Defaults to false. */
+    debug?: boolean;
 }
 
-export type { BooleanInputType as B, ComputeConfig as C, DataItem as D, FileInputType as F, GeometryInputType as G, InnerTreeData as I, NumericInputType as N, OutputParamSchema as O, RetryPolicy as R, 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, RhinoModelUnit as m, IoResponseSchema as n };
+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, MeshBatch as n };

package/dist/visualization-GU7JIB4V.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkJFLD2UCYcjs = require('./chunk-JFLD2UCY.cjs');require('./chunk-MA6YB3YZ.cjs');exports.BINARY_MESH_MAGIC = _chunkJFLD2UCYcjs.g; exports.BINARY_MESH_VERSION = _chunkJFLD2UCYcjs.h; exports.FLAG_FLOAT32 = _chunkJFLD2UCYcjs.i; exports.Materials = _chunkJFLD2UCYcjs.f; exports.SCALE_FACTORS = _chunkJFLD2UCYcjs.n; exports.applyOffset = _chunkJFLD2UCYcjs.d; exports.computeCombinedBoundingBox = _chunkJFLD2UCYcjs.e; exports.getThreeMeshesFromComputeResponse = _chunkJFLD2UCYcjs.o; exports.initThree = _chunkJFLD2UCYcjs.a; exports.parseBinaryMeshBatch = _chunkJFLD2UCYcjs.j; exports.parseColor = _chunkJFLD2UCYcjs.c; exports.parseMeshBatch = _chunkJFLD2UCYcjs.k; exports.parseMeshBatchBlob = _chunkJFLD2UCYcjs.m; exports.parseMeshBatchObject = _chunkJFLD2UCYcjs.l; exports.updateScene = _chunkJFLD2UCYcjs.b;
+//# sourceMappingURL=visualization-GU7JIB4V.cjs.map

package/dist/visualization-GU7JIB4V.cjs.map

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

package/dist/visualization-WIUVT2FZ.js

@@ -0,0 +1,2 @@
+import{a as e,b as r,c as o,d as t,e as a,f as s,g as i,h as p,i as n,j as h,k as M,l as f,m,n as B,o as C}from"./chunk-MKW2KTPT.js";import"./chunk-GTTKNF4G.js";export{i as BINARY_MESH_MAGIC,p as BINARY_MESH_VERSION,n as FLAG_FLOAT32,s as Materials,B as SCALE_FACTORS,t as applyOffset,a as computeCombinedBoundingBox,C as getThreeMeshesFromComputeResponse,e as initThree,h as parseBinaryMeshBatch,o as parseColor,M as parseMeshBatch,m as parseMeshBatchBlob,f as parseMeshBatchObject,r as updateScene};
+//# sourceMappingURL=visualization-WIUVT2FZ.js.map

package/dist/visualization.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkSVEXPGHWcjs = require('./chunk-SVEXPGHW.cjs');require('./chunk-ZRQRYG6F.cjs');require('./chunk-RBNF6MNH.cjs');exports.Materials = _chunkSVEXPGHWcjs.f; exports.SCALE_FACTORS = _chunkSVEXPGHWcjs.n; exports.getThreeMeshesFromComputeResponse = _chunkSVEXPGHWcjs.o; exports.initThree = _chunkSVEXPGHWcjs.a; exports.parseMeshBatchBlob = _chunkSVEXPGHWcjs.m; exports.parseMeshBatchObject = _chunkSVEXPGHWcjs.l; exports.updateScene = _chunkSVEXPGHWcjs.b;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkJFLD2UCYcjs = require('./chunk-JFLD2UCY.cjs');require('./chunk-MA6YB3YZ.cjs');exports.Materials = _chunkJFLD2UCYcjs.f; exports.SCALE_FACTORS = _chunkJFLD2UCYcjs.n; exports.getThreeMeshesFromComputeResponse = _chunkJFLD2UCYcjs.o; exports.initThree = _chunkJFLD2UCYcjs.a; exports.parseMeshBatchBlob = _chunkJFLD2UCYcjs.m; exports.parseMeshBatchObject = _chunkJFLD2UCYcjs.l; exports.updateScene = _chunkJFLD2UCYcjs.b;
 //# sourceMappingURL=visualization.cjs.map

package/dist/visualization.cjs.map

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