@selvajs/compute 1.5.1 → 1.5.2-beta.1

package/dist/grasshopper.d.cts

@@ -1,120 +1,6 @@
-import { R as RhinoComputeError, C as ComputeServerStats } from './base-dtik4Dlu.cjs';
-import { b as DataTreeDefault, O as OutputParamSchema, f as InputParamSchema, R as RetryPolicy, d as GrasshopperComputeResponse, a as DataTree, G as GrasshopperComputeConfig, C as ComputeConfig, c as DataTreePath } from './schemas-Ct7lU-IH.cjs';
-export { D as DataItem, e as GrasshopperRequestSchema, I as InnerTreeData, g as RhinoModelUnit } from './schemas-Ct7lU-IH.cjs';
+import { R as RetryPolicy, h as GrasshopperComputeResponse, o as RhinoComputeError, b as DataTree, g as GrasshopperComputeConfig, a as ComputeServerStats, i as GrasshopperParsedIO, j as GrasshopperParsedIORaw, C as ComputeConfig, m as InputParamSchema, l as InputParam, c as DataTreeDefault, d as DataTreePath } from './errors-CiA83qw2.cjs';
+export { B as BooleanInputType, D as DataItem, e as DefaultValue, F as FileInputType, G as GeometryInputType, k as GrasshopperRequestSchema, I as InnerTreeData, N as NumericInputType, O as OutputParamSchema, n as OutputType, p as RhinoModelUnit, T as TextInputType, V as ValueListInputType } from './errors-CiA83qw2.cjs';
 import * as THREE from 'three';
-import { M as MeshExtractionOptions } from './types-B24K2LG4.cjs';
-
-/**
- * Input and output parameter types
- */
-
-/**
- * Output types supported from Grasshopper/Rhino Compute
- */
-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
- */
-type DefaultValue<T> = T | T[] | DataTreeDefault<T> | undefined | null;
-/**
- * Base properties common to all processed input types.
- * Note: `groupName` and `id` require the custom Rhino Compute branch.
- */
-interface BaseInputType {
-    description: string;
-    name: string;
-    nickname: string | null;
-    treeAccess: boolean;
-    /**
-     * Name of the group this parameter belongs to.
-     * @requires Custom branch of compute.rhino3d
-     */
-    groupName?: string;
-    /**
-     * Unique identifier for the parameter.
-     * @requires Custom branch of compute.rhino3d
-     */
-    id?: string;
-}
-/**
- * Numeric input type (Number or Integer)
- */
-interface NumericInputType extends BaseInputType {
-    paramType: 'Number' | 'Integer';
-    minimum?: number | null;
-    maximum?: number | null;
-    atLeast?: number | null;
-    atMost?: number | null;
-    stepSize?: number | null;
-    default: DefaultValue<number>;
-}
-/**
- * Text input type
- */
-interface TextInputType extends BaseInputType {
-    paramType: 'Text';
-    default: DefaultValue<string>;
-}
-/**
- * Boolean input type
- */
-interface BooleanInputType extends BaseInputType {
-    paramType: 'Boolean';
-    default: DefaultValue<boolean>;
-}
-/**
- * Geometry input type (generic geometry)
- */
-interface GeometryInputType extends BaseInputType {
-    paramType: 'Geometry';
-    default: DefaultValue<object | string>;
-}
-/**
- * ValueList input type (dropdown/select)
- */
-interface ValueListInputType extends BaseInputType {
-    paramType: 'ValueList';
-    values: Record<string, string>;
-    default?: string;
-}
-/**
- * File input type
- */
-interface FileInputType extends BaseInputType {
-    paramType: 'File';
-    acceptedFormats?: string[];
-    default: DefaultValue<object | string>;
-}
-/**
- * Color input type (stored as hex string)
- */
-interface ColorInputType extends BaseInputType {
-    paramType: 'Color';
-    default: DefaultValue<string>;
-}
-/**
- * Discriminated union of all input parameter types
- */
-type InputParam = NumericInputType | BooleanInputType | TextInputType | ValueListInputType | GeometryInputType | FileInputType | ColorInputType;
-
-/**
- * Parsed data structures for processed Grasshopper input/output
- */
-
-/**
- * Parsed input/output structure with raw schemas
- */
-interface GrasshopperParsedIORaw {
-    inputs: InputParamSchema[];
-    outputs: OutputParamSchema[];
-}
-/**
- * Parsed input/output structure with processed types
- */
-interface GrasshopperParsedIO {
-    inputs: InputParam[];
-    outputs: OutputParamSchema[];
-}
 
 /**
  * Scheduling mode — controls how concurrent `solve()` calls interact.
@@ -148,9 +34,9 @@ interface SolveSchedulerOptions {
 interface SolveContext {
     /** Stable hash of (definition, dataTree). */
     key: string;
-    /** Wall-clock timestamp when scheduler.solve() was called. */
+    /** Timestamp when scheduler.solve() was called. */
     enqueuedAt: number;
-    /** Wall-clock timestamp when execution actually started (after queueing). */
+    /** Timestamp when execution actually started (after queueing). */
     startedAt: number | null;
 }
 type SolveResult = {
@@ -237,10 +123,12 @@ declare class SolveScheduler {
      * Schedule a solve. Returns a promise that:
      * - Resolves with the compute response on success.
      * - Rejects with `RhinoComputeError` on failure.
-     * - Rejects with `code: ErrorCodes.UNKNOWN_ERROR` and `message: 'Superseded'`
-     *   when the call was canceled because newer values arrived (latest-wins mode).
+     * - Rejects with `code: ErrorCodes.SUPERSEDED` when the call was canceled because
+     *   newer values arrived (latest-wins mode).
+     * - Rejects with `code: ErrorCodes.ABORTED` when the call was canceled via
+     *   caller-supplied signal or `cancelAll()`.
      *
-     * Caller-supplied `signal` cancels just this call (rejects with abort error).
+     * Caller-supplied `signal` cancels just this call (rejects with `ABORTED`).
      */
     solve(definition: string | Uint8Array, dataTree: DataTree[], options?: {
         signal?: AbortSignal;
@@ -250,8 +138,11 @@ declare class SolveScheduler {
     private drainNext;
     private supersede;
     private makeAbortError;
+    private isAbortLikeError;
+    private normalizeExecutionError;
     /** Cancel everything — in-flight and pending. */
     cancelAll(): void;
+    private rejectAsAborted;
     private readCache;
     private writeCache;
     clearCache(): void;
@@ -259,13 +150,6 @@ declare class SolveScheduler {
     private runHook;
 }
 
-/**
- * Hash a (definition, dataTree) pair into a short stable key.
- * For Uint8Array definitions we use length + endpoint bytes rather than the
- * full content to keep hashing cheap.
- */
-declare function hashSolveInput(definition: string | Uint8Array, dataTree: unknown): string;
-
 /**
  * Per-call options that override the client's default ComputeConfig values.
  *
@@ -422,6 +306,31 @@ type FileBaseInfo = {
     filePath: 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;
+}
+
 interface ParsedContext {
     [key: string]: any;
 }
@@ -475,29 +384,31 @@ declare class GrasshopperResponseProcessor {
      */
     getValues<T = ParsedContext>(byId?: boolean, options?: GetValuesOptions): GetValuesResult<T>;
     /**
-     * Retrieve a specific value using the parameter name.
+     * Retrieve a specific value by parameter name or ID.
      *
-     * @param paramName - Human-readable parameter name from the Grasshopper definition.
+     * @param selector - `{ byName }` for the human-readable name, `{ byId }` for the parameter GUID.
      * @param options - Parsing configuration (e.g. disable parsing or enable Rhino).
      * @returns Single parsed value, array of values, or undefined if the parameter is absent.
      *
      * @example
      * ```ts
-     * const schema = processor.getValueByParamName('Schema');
+     * const schema = processor.getValue({ byName: 'Schema' });
+     * const output = processor.getValue({ byId: 'a4be1c1e-23f9-4c27-b942-7f3bb2c45c6f' });
      * ```
+     *
+     * **Note:** `byId` only works with the custom VektorNode rhino.compute branch.
+     */
+    getValue(selector: {
+        byName: string;
+    } | {
+        byId: string;
+    }, options?: GetValuesOptions): any;
+    /**
+     * @deprecated Use `getValue({ byName })` instead.
      */
     getValueByParamName(paramName: string, options?: GetValuesOptions): any;
     /**
-     * Retrieve a specific value using the parameter ID.
-     *
-     * @param paramId - Parameter GUID from the Grasshopper definition.
-     * @param options - Parsing configuration (e.g. disable parsing or enable Rhino).
-     * @returns Parsed value, array of values, or undefined if not present.
-     *
-     * @example
-     * ```ts
-     * const output = processor.getValueByParamId('a4be1c1e-23f9-4c27-b942-7f3bb2c45c6f');
-     * ```
+     * @deprecated Use `getValue({ byId })` instead.
      */
     getValueByParamId(paramId: string, options?: GetValuesOptions): any;
     /**
@@ -569,6 +480,12 @@ declare class GrasshopperResponseProcessor {
     getAndDownloadFiles(folderName: string, additionalFiles?: FileBaseInfo[] | FileBaseInfo | null): void;
 }
 
+/**
+ * Hash definition and data tree into a stable cache key.
+ * For Uint8Array, uses length + samples to keep hashing fast.
+ */
+declare function hashSolveInput(definition: string | Uint8Array, dataTree: unknown): string;
+
 /**
  * Runs a Rhino Compute job using the provided tree prototypes and Grasshopper definition.
  *
@@ -886,6 +803,11 @@ declare class TreeBuilder {
      */
     static replaceTreeValue(trees: TreeBuilder[], paramName: string, newValue: DataTreeValue): TreeBuilder[];
     static replaceTreeValue(trees: DataTree[], paramName: string, newValue: DataTreeValue): DataTree[];
+    /**
+     * Build a TreeBuilder from a single value, dispatching on shape:
+     * DataTreeDefault structure, array, or scalar.
+     */
+    private static buildFromValue;
     /**
      * Extract a value from a TreeBuilder or InnerTree array by parameter name.
      *
@@ -930,6 +852,17 @@ declare class TreeBuilder {
      */
     static getTreeValue(trees: TreeBuilder[], paramName: string): DataTreeValue | null;
     static getTreeValue(trees: DataTree[], paramName: string): DataTreeValue | null;
+    /**
+     * Read all values for `paramName` across every branch of the matching builder.
+     * Returns null when the builder isn't found.
+     */
+    private static readFromBuilders;
+    /**
+     * Read values from the first branch of the matching compiled InnerTree
+     * (multi-branch responses are not flattened — current semantics, pinned by
+     * the "reads from the first branch path only" test).
+     */
+    private static readFromDataTrees;
     /**
      * Parse a TreeBuilder path string like "{0;1;2}" into [0, 1, 2].
      *
@@ -1011,4 +944,4 @@ declare const extractFilesFromComputeResponse: (downloadableFiles: FileData[], a
  */
 declare const downloadFileData: (downloadableFiles: FileData[], fileFoldername: string, additionalFiles?: FileBaseInfo[] | FileBaseInfo | null) => Promise<void>;
 
-export { type BooleanInputType, type CacheOptions, ComputeConfig, DataTree, DataTreeDefault, DataTreePath, type DataTreeValue, type DefaultValue, type FileBaseInfo, type FileData, type FileInputType, type GeometryInputType, type GetValuesOptions, type GetValuesResult, GrasshopperClient, GrasshopperComputeConfig, GrasshopperComputeResponse, type GrasshopperParsedIO, type GrasshopperParsedIORaw, GrasshopperResponseProcessor, type InputParam, InputParamSchema, type NumericInputType, OutputParamSchema, type OutputType, type ParsedContext, type ProcessedFile, RetryPolicy, RhinoComputeError, type SchedulerMode, type SolveContext, type SolveExecutor, type SolveOptions, type SolveResult, SolveScheduler, type SolveSchedulerOptions, type TextInputType, TreeBuilder, type ValueListInputType, downloadFileData, extractFilesFromComputeResponse, fetchDefinitionIO, fetchParsedDefinitionIO, hashSolveInput, processInput, processInputs, solveGrasshopperDefinition };
+export { type CacheOptions, ComputeConfig, DataTree, DataTreeDefault, DataTreePath, type DataTreeValue, type FileBaseInfo, type FileData, type GetValuesOptions, type GetValuesResult, GrasshopperClient, GrasshopperComputeConfig, GrasshopperComputeResponse, GrasshopperParsedIO, GrasshopperParsedIORaw, GrasshopperResponseProcessor, InputParam, InputParamSchema, type ParsedContext, type ProcessedFile, RetryPolicy, RhinoComputeError, type SchedulerMode, type SolveContext, type SolveExecutor, type SolveOptions, type SolveResult, SolveScheduler, type SolveSchedulerOptions, TreeBuilder, downloadFileData, extractFilesFromComputeResponse, fetchDefinitionIO, fetchParsedDefinitionIO, hashSolveInput, processInput, processInputs, solveGrasshopperDefinition };

package/dist/grasshopper.d.ts

@@ -1,120 +1,6 @@
-import { R as RhinoComputeError, C as ComputeServerStats } from './base-dtik4Dlu.js';
-import { b as DataTreeDefault, O as OutputParamSchema, f as InputParamSchema, R as RetryPolicy, d as GrasshopperComputeResponse, a as DataTree, G as GrasshopperComputeConfig, C as ComputeConfig, c as DataTreePath } from './schemas-Ct7lU-IH.js';
-export { D as DataItem, e as GrasshopperRequestSchema, I as InnerTreeData, g as RhinoModelUnit } from './schemas-Ct7lU-IH.js';
+import { R as RetryPolicy, h as GrasshopperComputeResponse, o as RhinoComputeError, b as DataTree, g as GrasshopperComputeConfig, a as ComputeServerStats, i as GrasshopperParsedIO, j as GrasshopperParsedIORaw, C as ComputeConfig, m as InputParamSchema, l as InputParam, c as DataTreeDefault, d as DataTreePath } from './errors-CiA83qw2.js';
+export { B as BooleanInputType, D as DataItem, e as DefaultValue, F as FileInputType, G as GeometryInputType, k as GrasshopperRequestSchema, I as InnerTreeData, N as NumericInputType, O as OutputParamSchema, n as OutputType, p as RhinoModelUnit, T as TextInputType, V as ValueListInputType } from './errors-CiA83qw2.js';
 import * as THREE from 'three';
-import { M as MeshExtractionOptions } from './types-B24K2LG4.js';
-
-/**
- * Input and output parameter types
- */
-
-/**
- * Output types supported from Grasshopper/Rhino Compute
- */
-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
- */
-type DefaultValue<T> = T | T[] | DataTreeDefault<T> | undefined | null;
-/**
- * Base properties common to all processed input types.
- * Note: `groupName` and `id` require the custom Rhino Compute branch.
- */
-interface BaseInputType {
-    description: string;
-    name: string;
-    nickname: string | null;
-    treeAccess: boolean;
-    /**
-     * Name of the group this parameter belongs to.
-     * @requires Custom branch of compute.rhino3d
-     */
-    groupName?: string;
-    /**
-     * Unique identifier for the parameter.
-     * @requires Custom branch of compute.rhino3d
-     */
-    id?: string;
-}
-/**
- * Numeric input type (Number or Integer)
- */
-interface NumericInputType extends BaseInputType {
-    paramType: 'Number' | 'Integer';
-    minimum?: number | null;
-    maximum?: number | null;
-    atLeast?: number | null;
-    atMost?: number | null;
-    stepSize?: number | null;
-    default: DefaultValue<number>;
-}
-/**
- * Text input type
- */
-interface TextInputType extends BaseInputType {
-    paramType: 'Text';
-    default: DefaultValue<string>;
-}
-/**
- * Boolean input type
- */
-interface BooleanInputType extends BaseInputType {
-    paramType: 'Boolean';
-    default: DefaultValue<boolean>;
-}
-/**
- * Geometry input type (generic geometry)
- */
-interface GeometryInputType extends BaseInputType {
-    paramType: 'Geometry';
-    default: DefaultValue<object | string>;
-}
-/**
- * ValueList input type (dropdown/select)
- */
-interface ValueListInputType extends BaseInputType {
-    paramType: 'ValueList';
-    values: Record<string, string>;
-    default?: string;
-}
-/**
- * File input type
- */
-interface FileInputType extends BaseInputType {
-    paramType: 'File';
-    acceptedFormats?: string[];
-    default: DefaultValue<object | string>;
-}
-/**
- * Color input type (stored as hex string)
- */
-interface ColorInputType extends BaseInputType {
-    paramType: 'Color';
-    default: DefaultValue<string>;
-}
-/**
- * Discriminated union of all input parameter types
- */
-type InputParam = NumericInputType | BooleanInputType | TextInputType | ValueListInputType | GeometryInputType | FileInputType | ColorInputType;
-
-/**
- * Parsed data structures for processed Grasshopper input/output
- */
-
-/**
- * Parsed input/output structure with raw schemas
- */
-interface GrasshopperParsedIORaw {
-    inputs: InputParamSchema[];
-    outputs: OutputParamSchema[];
-}
-/**
- * Parsed input/output structure with processed types
- */
-interface GrasshopperParsedIO {
-    inputs: InputParam[];
-    outputs: OutputParamSchema[];
-}
 
 /**
  * Scheduling mode — controls how concurrent `solve()` calls interact.
@@ -148,9 +34,9 @@ interface SolveSchedulerOptions {
 interface SolveContext {
     /** Stable hash of (definition, dataTree). */
     key: string;
-    /** Wall-clock timestamp when scheduler.solve() was called. */
+    /** Timestamp when scheduler.solve() was called. */
     enqueuedAt: number;
-    /** Wall-clock timestamp when execution actually started (after queueing). */
+    /** Timestamp when execution actually started (after queueing). */
     startedAt: number | null;
 }
 type SolveResult = {
@@ -237,10 +123,12 @@ declare class SolveScheduler {
      * Schedule a solve. Returns a promise that:
      * - Resolves with the compute response on success.
      * - Rejects with `RhinoComputeError` on failure.
-     * - Rejects with `code: ErrorCodes.UNKNOWN_ERROR` and `message: 'Superseded'`
-     *   when the call was canceled because newer values arrived (latest-wins mode).
+     * - Rejects with `code: ErrorCodes.SUPERSEDED` when the call was canceled because
+     *   newer values arrived (latest-wins mode).
+     * - Rejects with `code: ErrorCodes.ABORTED` when the call was canceled via
+     *   caller-supplied signal or `cancelAll()`.
      *
-     * Caller-supplied `signal` cancels just this call (rejects with abort error).
+     * Caller-supplied `signal` cancels just this call (rejects with `ABORTED`).
      */
     solve(definition: string | Uint8Array, dataTree: DataTree[], options?: {
         signal?: AbortSignal;
@@ -250,8 +138,11 @@ declare class SolveScheduler {
     private drainNext;
     private supersede;
     private makeAbortError;
+    private isAbortLikeError;
+    private normalizeExecutionError;
     /** Cancel everything — in-flight and pending. */
     cancelAll(): void;
+    private rejectAsAborted;
     private readCache;
     private writeCache;
     clearCache(): void;
@@ -259,13 +150,6 @@ declare class SolveScheduler {
     private runHook;
 }
 
-/**
- * Hash a (definition, dataTree) pair into a short stable key.
- * For Uint8Array definitions we use length + endpoint bytes rather than the
- * full content to keep hashing cheap.
- */
-declare function hashSolveInput(definition: string | Uint8Array, dataTree: unknown): string;
-
 /**
  * Per-call options that override the client's default ComputeConfig values.
  *
@@ -422,6 +306,31 @@ type FileBaseInfo = {
     filePath: 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;
+}
+
 interface ParsedContext {
     [key: string]: any;
 }
@@ -475,29 +384,31 @@ declare class GrasshopperResponseProcessor {
      */
     getValues<T = ParsedContext>(byId?: boolean, options?: GetValuesOptions): GetValuesResult<T>;
     /**
-     * Retrieve a specific value using the parameter name.
+     * Retrieve a specific value by parameter name or ID.
      *
-     * @param paramName - Human-readable parameter name from the Grasshopper definition.
+     * @param selector - `{ byName }` for the human-readable name, `{ byId }` for the parameter GUID.
      * @param options - Parsing configuration (e.g. disable parsing or enable Rhino).
      * @returns Single parsed value, array of values, or undefined if the parameter is absent.
      *
      * @example
      * ```ts
-     * const schema = processor.getValueByParamName('Schema');
+     * const schema = processor.getValue({ byName: 'Schema' });
+     * const output = processor.getValue({ byId: 'a4be1c1e-23f9-4c27-b942-7f3bb2c45c6f' });
      * ```
+     *
+     * **Note:** `byId` only works with the custom VektorNode rhino.compute branch.
+     */
+    getValue(selector: {
+        byName: string;
+    } | {
+        byId: string;
+    }, options?: GetValuesOptions): any;
+    /**
+     * @deprecated Use `getValue({ byName })` instead.
      */
     getValueByParamName(paramName: string, options?: GetValuesOptions): any;
     /**
-     * Retrieve a specific value using the parameter ID.
-     *
-     * @param paramId - Parameter GUID from the Grasshopper definition.
-     * @param options - Parsing configuration (e.g. disable parsing or enable Rhino).
-     * @returns Parsed value, array of values, or undefined if not present.
-     *
-     * @example
-     * ```ts
-     * const output = processor.getValueByParamId('a4be1c1e-23f9-4c27-b942-7f3bb2c45c6f');
-     * ```
+     * @deprecated Use `getValue({ byId })` instead.
      */
     getValueByParamId(paramId: string, options?: GetValuesOptions): any;
     /**
@@ -569,6 +480,12 @@ declare class GrasshopperResponseProcessor {
     getAndDownloadFiles(folderName: string, additionalFiles?: FileBaseInfo[] | FileBaseInfo | null): void;
 }
 
+/**
+ * Hash definition and data tree into a stable cache key.
+ * For Uint8Array, uses length + samples to keep hashing fast.
+ */
+declare function hashSolveInput(definition: string | Uint8Array, dataTree: unknown): string;
+
 /**
  * Runs a Rhino Compute job using the provided tree prototypes and Grasshopper definition.
  *
@@ -886,6 +803,11 @@ declare class TreeBuilder {
      */
     static replaceTreeValue(trees: TreeBuilder[], paramName: string, newValue: DataTreeValue): TreeBuilder[];
     static replaceTreeValue(trees: DataTree[], paramName: string, newValue: DataTreeValue): DataTree[];
+    /**
+     * Build a TreeBuilder from a single value, dispatching on shape:
+     * DataTreeDefault structure, array, or scalar.
+     */
+    private static buildFromValue;
     /**
      * Extract a value from a TreeBuilder or InnerTree array by parameter name.
      *
@@ -930,6 +852,17 @@ declare class TreeBuilder {
      */
     static getTreeValue(trees: TreeBuilder[], paramName: string): DataTreeValue | null;
     static getTreeValue(trees: DataTree[], paramName: string): DataTreeValue | null;
+    /**
+     * Read all values for `paramName` across every branch of the matching builder.
+     * Returns null when the builder isn't found.
+     */
+    private static readFromBuilders;
+    /**
+     * Read values from the first branch of the matching compiled InnerTree
+     * (multi-branch responses are not flattened — current semantics, pinned by
+     * the "reads from the first branch path only" test).
+     */
+    private static readFromDataTrees;
     /**
      * Parse a TreeBuilder path string like "{0;1;2}" into [0, 1, 2].
      *
@@ -1011,4 +944,4 @@ declare const extractFilesFromComputeResponse: (downloadableFiles: FileData[], a
  */
 declare const downloadFileData: (downloadableFiles: FileData[], fileFoldername: string, additionalFiles?: FileBaseInfo[] | FileBaseInfo | null) => Promise<void>;
 
-export { type BooleanInputType, type CacheOptions, ComputeConfig, DataTree, DataTreeDefault, DataTreePath, type DataTreeValue, type DefaultValue, type FileBaseInfo, type FileData, type FileInputType, type GeometryInputType, type GetValuesOptions, type GetValuesResult, GrasshopperClient, GrasshopperComputeConfig, GrasshopperComputeResponse, type GrasshopperParsedIO, type GrasshopperParsedIORaw, GrasshopperResponseProcessor, type InputParam, InputParamSchema, type NumericInputType, OutputParamSchema, type OutputType, type ParsedContext, type ProcessedFile, RetryPolicy, RhinoComputeError, type SchedulerMode, type SolveContext, type SolveExecutor, type SolveOptions, type SolveResult, SolveScheduler, type SolveSchedulerOptions, type TextInputType, TreeBuilder, type ValueListInputType, downloadFileData, extractFilesFromComputeResponse, fetchDefinitionIO, fetchParsedDefinitionIO, hashSolveInput, processInput, processInputs, solveGrasshopperDefinition };
+export { type CacheOptions, ComputeConfig, DataTree, DataTreeDefault, DataTreePath, type DataTreeValue, type FileBaseInfo, type FileData, type GetValuesOptions, type GetValuesResult, GrasshopperClient, GrasshopperComputeConfig, GrasshopperComputeResponse, GrasshopperParsedIO, GrasshopperParsedIORaw, GrasshopperResponseProcessor, InputParam, InputParamSchema, type ParsedContext, type ProcessedFile, RetryPolicy, RhinoComputeError, type SchedulerMode, type SolveContext, type SolveExecutor, type SolveOptions, type SolveResult, SolveScheduler, type SolveSchedulerOptions, TreeBuilder, downloadFileData, extractFilesFromComputeResponse, fetchDefinitionIO, fetchParsedDefinitionIO, hashSolveInput, processInput, processInputs, solveGrasshopperDefinition };

package/dist/grasshopper.js

@@ -1,2 +1,2 @@
-import{a as b,b as c,c as d,d as e,e as f,f as g,g as h,h as i,i as j,j as k,k as l,l as m}from"./chunk-WXQGTKU6.js";import"./chunk-PZ4HZLFJ.js";import{d as a}from"./chunk-VK2TSW7S.js";export{d as GrasshopperClient,g as GrasshopperResponseProcessor,a as RhinoComputeError,c as SolveScheduler,m as TreeBuilder,f as downloadFileData,e as extractFilesFromComputeResponse,k as fetchDefinitionIO,l as fetchParsedDefinitionIO,b as hashSolveInput,i as processInput,j as processInputs,h as solveGrasshopperDefinition};
+import{a as b,b as c,c as d,d as e,e as f,f as g,g as h,h as i,i as j,j as k,k as l,l as m}from"./chunk-XIBQV4XW.js";import"./chunk-XLHA5YPH.js";import{d as a}from"./chunk-RHULSS7S.js";export{d as GrasshopperClient,g as GrasshopperResponseProcessor,a as RhinoComputeError,c as SolveScheduler,m as TreeBuilder,f as downloadFileData,e as extractFilesFromComputeResponse,k as fetchDefinitionIO,l as fetchParsedDefinitionIO,b as hashSolveInput,i as processInput,j as processInputs,h as solveGrasshopperDefinition};
 //# sourceMappingURL=grasshopper.js.map

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkFRSLCR7Gcjs = require('./chunk-FRSLCR7G.cjs');require('./chunk-LNIUUPA5.cjs');var _chunkIJZNCO5Xcjs = require('./chunk-IJZNCO5X.cjs');exports.ComputeServerStats = _chunkIJZNCO5Xcjs.i; exports.ErrorCodes = _chunkIJZNCO5Xcjs.c; exports.GrasshopperClient = _chunkFRSLCR7Gcjs.c; exports.GrasshopperResponseProcessor = _chunkFRSLCR7Gcjs.f; exports.RhinoComputeError = _chunkIJZNCO5Xcjs.d; exports.SolveScheduler = _chunkFRSLCR7Gcjs.b; exports.TreeBuilder = _chunkFRSLCR7Gcjs.l; exports.camelcaseKeys = _chunkIJZNCO5Xcjs.k; exports.downloadFileData = _chunkFRSLCR7Gcjs.e; exports.enableDebugLogging = _chunkIJZNCO5Xcjs.g; exports.extractFilesFromComputeResponse = _chunkFRSLCR7Gcjs.d; exports.fetchDefinitionIO = _chunkFRSLCR7Gcjs.j; exports.fetchParsedDefinitionIO = _chunkFRSLCR7Gcjs.k; exports.fetchRhinoCompute = _chunkIJZNCO5Xcjs.h; exports.getLogger = _chunkIJZNCO5Xcjs.e; exports.hashSolveInput = _chunkFRSLCR7Gcjs.a; exports.processInput = _chunkFRSLCR7Gcjs.h; exports.processInputs = _chunkFRSLCR7Gcjs.i; exports.setLogger = _chunkIJZNCO5Xcjs.f; exports.solveGrasshopperDefinition = _chunkFRSLCR7Gcjs.g; exports.toCamelCase = _chunkIJZNCO5Xcjs.j;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk2D74PNQUcjs = require('./chunk-2D74PNQU.cjs');require('./chunk-MZGKJZVP.cjs');var _chunkVWOEUM7Ccjs = require('./chunk-VWOEUM7C.cjs');exports.ComputeServerStats = _chunkVWOEUM7Ccjs.i; exports.ErrorCodes = _chunkVWOEUM7Ccjs.c; exports.GrasshopperClient = _chunk2D74PNQUcjs.c; exports.GrasshopperResponseProcessor = _chunk2D74PNQUcjs.f; exports.RhinoComputeError = _chunkVWOEUM7Ccjs.d; exports.SolveScheduler = _chunk2D74PNQUcjs.b; exports.TreeBuilder = _chunk2D74PNQUcjs.l; exports.camelcaseKeys = _chunkVWOEUM7Ccjs.k; exports.downloadFileData = _chunk2D74PNQUcjs.e; exports.enableDebugLogging = _chunkVWOEUM7Ccjs.g; exports.extractFilesFromComputeResponse = _chunk2D74PNQUcjs.d; exports.fetchDefinitionIO = _chunk2D74PNQUcjs.j; exports.fetchParsedDefinitionIO = _chunk2D74PNQUcjs.k; exports.fetchRhinoCompute = _chunkVWOEUM7Ccjs.h; exports.getLogger = _chunkVWOEUM7Ccjs.e; exports.hashSolveInput = _chunk2D74PNQUcjs.a; exports.processInput = _chunk2D74PNQUcjs.h; exports.processInputs = _chunk2D74PNQUcjs.i; exports.setLogger = _chunkVWOEUM7Ccjs.f; exports.solveGrasshopperDefinition = _chunk2D74PNQUcjs.g; exports.toCamelCase = _chunkVWOEUM7Ccjs.j;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -1,6 +1,4 @@
-export { ErrorCode, ErrorCodes, Logger, camelcaseKeys, enableDebugLogging, fetchRhinoCompute, getLogger, setLogger, toCamelCase } from './core.cjs';
-export { C as ComputeServerStats, R as RhinoComputeError } from './base-dtik4Dlu.cjs';
-export { C as ComputeConfig, D as DataItem, a as DataTree, b as DataTreeDefault, c as DataTreePath, G as GrasshopperComputeConfig, d as GrasshopperComputeResponse, e as GrasshopperRequestSchema, I as InnerTreeData, f as InputParamSchema, O as OutputParamSchema, R as RetryPolicy, g as RhinoModelUnit } from './schemas-Ct7lU-IH.cjs';
-export { BooleanInputType, CacheOptions, DataTreeValue, DefaultValue, FileBaseInfo, FileData, FileInputType, GeometryInputType, GetValuesOptions, GetValuesResult, GrasshopperClient, GrasshopperParsedIO, GrasshopperParsedIORaw, GrasshopperResponseProcessor, InputParam, NumericInputType, OutputType, ParsedContext, ProcessedFile, SchedulerMode, SolveContext, SolveExecutor, SolveOptions, SolveResult, SolveScheduler, SolveSchedulerOptions, TextInputType, TreeBuilder, ValueListInputType, downloadFileData, extractFilesFromComputeResponse, fetchDefinitionIO, fetchParsedDefinitionIO, hashSolveInput, processInput, processInputs, solveGrasshopperDefinition } from './grasshopper.cjs';
+export { Logger, camelcaseKeys, enableDebugLogging, fetchRhinoCompute, getLogger, setLogger, toCamelCase } from './core.cjs';
+export { B as BooleanInputType, C as ComputeConfig, a as ComputeServerStats, D as DataItem, b as DataTree, c as DataTreeDefault, d as DataTreePath, e as DefaultValue, E as ErrorCode, f as ErrorCodes, F as FileInputType, G as GeometryInputType, g as GrasshopperComputeConfig, h as GrasshopperComputeResponse, i as GrasshopperParsedIO, j as GrasshopperParsedIORaw, k as GrasshopperRequestSchema, I as InnerTreeData, l as InputParam, m as InputParamSchema, N as NumericInputType, O as OutputParamSchema, n as OutputType, R as RetryPolicy, o as RhinoComputeError, p as RhinoModelUnit, T as TextInputType, V as ValueListInputType } from './errors-CiA83qw2.cjs';
+export { CacheOptions, DataTreeValue, FileBaseInfo, FileData, GetValuesOptions, GetValuesResult, GrasshopperClient, GrasshopperResponseProcessor, ParsedContext, ProcessedFile, SchedulerMode, SolveContext, SolveExecutor, SolveOptions, SolveResult, SolveScheduler, SolveSchedulerOptions, TreeBuilder, downloadFileData, extractFilesFromComputeResponse, fetchDefinitionIO, fetchParsedDefinitionIO, hashSolveInput, processInput, processInputs, solveGrasshopperDefinition } from './grasshopper.cjs';
 import 'three';
-import './types-B24K2LG4.cjs';

package/dist/index.d.ts

@@ -1,6 +1,4 @@
-export { ErrorCode, ErrorCodes, Logger, camelcaseKeys, enableDebugLogging, fetchRhinoCompute, getLogger, setLogger, toCamelCase } from './core.js';
-export { C as ComputeServerStats, R as RhinoComputeError } from './base-dtik4Dlu.js';
-export { C as ComputeConfig, D as DataItem, a as DataTree, b as DataTreeDefault, c as DataTreePath, G as GrasshopperComputeConfig, d as GrasshopperComputeResponse, e as GrasshopperRequestSchema, I as InnerTreeData, f as InputParamSchema, O as OutputParamSchema, R as RetryPolicy, g as RhinoModelUnit } from './schemas-Ct7lU-IH.js';
-export { BooleanInputType, CacheOptions, DataTreeValue, DefaultValue, FileBaseInfo, FileData, FileInputType, GeometryInputType, GetValuesOptions, GetValuesResult, GrasshopperClient, GrasshopperParsedIO, GrasshopperParsedIORaw, GrasshopperResponseProcessor, InputParam, NumericInputType, OutputType, ParsedContext, ProcessedFile, SchedulerMode, SolveContext, SolveExecutor, SolveOptions, SolveResult, SolveScheduler, SolveSchedulerOptions, TextInputType, TreeBuilder, ValueListInputType, downloadFileData, extractFilesFromComputeResponse, fetchDefinitionIO, fetchParsedDefinitionIO, hashSolveInput, processInput, processInputs, solveGrasshopperDefinition } from './grasshopper.js';
+export { Logger, camelcaseKeys, enableDebugLogging, fetchRhinoCompute, getLogger, setLogger, toCamelCase } from './core.js';
+export { B as BooleanInputType, C as ComputeConfig, a as ComputeServerStats, D as DataItem, b as DataTree, c as DataTreeDefault, d as DataTreePath, e as DefaultValue, E as ErrorCode, f as ErrorCodes, F as FileInputType, G as GeometryInputType, g as GrasshopperComputeConfig, h as GrasshopperComputeResponse, i as GrasshopperParsedIO, j as GrasshopperParsedIORaw, k as GrasshopperRequestSchema, I as InnerTreeData, l as InputParam, m as InputParamSchema, N as NumericInputType, O as OutputParamSchema, n as OutputType, R as RetryPolicy, o as RhinoComputeError, p as RhinoModelUnit, T as TextInputType, V as ValueListInputType } from './errors-CiA83qw2.js';
+export { CacheOptions, DataTreeValue, FileBaseInfo, FileData, GetValuesOptions, GetValuesResult, GrasshopperClient, GrasshopperResponseProcessor, ParsedContext, ProcessedFile, SchedulerMode, SolveContext, SolveExecutor, SolveOptions, SolveResult, SolveScheduler, SolveSchedulerOptions, TreeBuilder, downloadFileData, extractFilesFromComputeResponse, fetchDefinitionIO, fetchParsedDefinitionIO, hashSolveInput, processInput, processInputs, solveGrasshopperDefinition } from './grasshopper.js';
 import 'three';
-import './types-B24K2LG4.js';

package/dist/index.js

@@ -1,2 +1,2 @@
-import{a as b,b as c,c as d,d as g,e as h,f as i,g as j,h as k,i as l,j as n,k as q,l as s}from"./chunk-WXQGTKU6.js";import"./chunk-PZ4HZLFJ.js";import{c as o,d as r,e,f,g as m,h as p,i as t,j as x,k as a}from"./chunk-VK2TSW7S.js";export{t as ComputeServerStats,o as ErrorCodes,d as GrasshopperClient,i as GrasshopperResponseProcessor,r as RhinoComputeError,c as SolveScheduler,s as TreeBuilder,a as camelcaseKeys,h as downloadFileData,m as enableDebugLogging,g as extractFilesFromComputeResponse,n as fetchDefinitionIO,q as fetchParsedDefinitionIO,p as fetchRhinoCompute,e as getLogger,b as hashSolveInput,k as processInput,l as processInputs,f as setLogger,j as solveGrasshopperDefinition,x as toCamelCase};
+import{a as b,b as c,c as d,d as g,e as h,f as i,g as j,h as k,i as l,j as n,k as q,l as s}from"./chunk-XIBQV4XW.js";import"./chunk-XLHA5YPH.js";import{c as o,d as r,e,f,g as m,h as p,i as t,j as x,k as a}from"./chunk-RHULSS7S.js";export{t as ComputeServerStats,o as ErrorCodes,d as GrasshopperClient,i as GrasshopperResponseProcessor,r as RhinoComputeError,c as SolveScheduler,s as TreeBuilder,a as camelcaseKeys,h as downloadFileData,m as enableDebugLogging,g as extractFilesFromComputeResponse,n as fetchDefinitionIO,q as fetchParsedDefinitionIO,p as fetchRhinoCompute,e as getLogger,b as hashSolveInput,k as processInput,l as processInputs,f as setLogger,j as solveGrasshopperDefinition,x as toCamelCase};
 //# sourceMappingURL=index.js.map