@selvajs/compute 2.5.0 → 3.0.0-beta.0

package/dist/grasshopper.d.cts

@@ -1,5 +1,5 @@
-import { R as RhinoComputeError, C as ComputeServerStats, F as FileBaseInfo } from './handle-files-UcwvknQ3.cjs';
-export { b as FileData, P as ProcessedFile, d as downloadFileData, e as extractFilesFromComputeResponse } from './handle-files-UcwvknQ3.cjs';
+import { R as RhinoComputeError, C as ComputeServerStats, F as FileBaseInfo } from './handle-files-Bu2qmaPj.cjs';
+export { b as FileData, P as ProcessedFile, d as downloadFileData, e as extractFilesFromComputeResponse } from './handle-files-Bu2qmaPj.cjs';
 import { R as RetryPolicy, C as ComputeConfig } from './types-ChF690kY.cjs';
 export { a as RhinoModelUnit } from './types-ChF690kY.cjs';
 import { f as GrasshopperComputeResponse, a as DataTree, e as GrasshopperComputeConfig, g as GrasshopperParsedIO, h as GrasshopperParsedIORaw, M as MeshExtractionOptions, k as InputParamSchema, j as InputParam, b as DataTreeDefault, c as DataTreePath } from './types-D-HQ-gWI.cjs';
@@ -61,6 +61,15 @@ type SolveResult = {
     response: GrasshopperComputeResponse;
     durationMs: number;
     fromCache: boolean;
+    /**
+     * Definition-cache telemetry for a real compute call (not a Selva-cache
+     * `fromCache` hit). `false` → the server reused its cached definition via
+     * the pointer (no upload); `true` → the pointer was cold/stale so the full
+     * definition was re-uploaded. `undefined` when the server-definition-cache
+     * fast path didn't run (reuse disabled, or a non-reusable definition such
+     * as a remote URL).
+     */
+    definitionReuploaded?: boolean;
 } | {
     status: 'error';
     error: RhinoComputeError;
@@ -347,20 +356,15 @@ interface GetValuesResult<T = ParsedContext> {
 declare class GrasshopperResponseProcessor {
     private readonly response;
     private readonly debug;
-    /**
-     * Store the compute response for reuse.
-     */
     constructor(response: GrasshopperComputeResponse, debug?: boolean);
     /**
      * Extract all values in the response.
      *
      * @typeParam T - Expected structure of the return value. Defaults to a simple key/value map. (later cast as needed)
-     * @param byId - If true, keys are parameter IDs; if false, keys are parameter names.
+     * @param byId - Key by parameter ID instead of name. Requires the VektorNode rhino.compute branch.
      * @param options - Controls parsing behavior such as Rhino geometry decoding.
      * @returns Parsed Grasshopper output values.
      *
-     * **Note:** Using `byId` only works with the custom VektorNode rhino.compute branch.
-     *
      * @example
      * ```ts
      * const processor = new GrasshopperResponseProcessor(response);
@@ -380,13 +384,13 @@ declare class GrasshopperResponseProcessor {
      * @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.
      *
+     * `byId` requires the VektorNode rhino.compute branch.
+     *
      * @example
      * ```ts
      * 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;
@@ -394,57 +398,26 @@ declare class GrasshopperResponseProcessor {
         byId: string;
     }, options?: GetValuesOptions): any;
     /**
-     * @deprecated Use `getValue({ byName })` instead.
-     */
-    getValueByParamName(paramName: string, options?: GetValuesOptions): any;
-    /**
-     * @deprecated Use `getValue({ byId })` instead.
-     */
-    getValueByParamId(paramId: string, options?: GetValuesOptions): any;
-    /**
-     * Convert all geometry results into Three.js mesh objects.
-     *
-     * This uses internal helpers to decode Rhino geometry into Three.js
-     * primitives such as meshes and lines, making them ready for rendering.
+     * Decode all geometry results into Three.js meshes/lines ready for rendering.
+     * The processor's `debug` flag is merged with `options` (explicit options win).
      *
-     * All processing options (scaling, positioning, compression, etc.) can be customized.
-     * The processor's debug flag is merged with options - explicit options take precedence.
+     * Requires the **Selva Display** Grasshopper component and the VektorNode
+     * rhino.compute branch. Three.js is loaded dynamically, so install it as a
+     * peer dependency before calling this.
      *
-     * **Note:** This only works when using the **Selva Display** component in Grasshopper, and requires the custom branch of rhino.compute from VektorNode. This method dynamically imports three.js visualization modules. Ensure three.js is installed as a peer dependency if you use this feature.
-     *
-     * @param options - Configuration for mesh extraction and parsing. Overrides processor's debug flag if provided.
-     * @returns Promise resolving to an array of Three.js mesh objects.
-     * @throws {RhinoComputeError} If three.js visualization module cannot be loaded.
+     * @throws {RhinoComputeError} If the three.js visualization module can't load.
      *
      * @example
      * ```ts
      * const meshes = await processor.extractMeshesFromResponse();
      * scene.add(...meshes);
      * ```
-     *
-     * @example
-     * ```ts
-     * const meshes = await processor.extractMeshesFromResponse({
-     *   debug: true,
-     *   allowScaling: true,
-     *   allowAutoPosition: false,
-     *   parsing: {
-     *     mergeByMaterial: false,
-     *     applyTransforms: true,
-     *     debug: true,
-     *   },
-     * });
-     * ```
      */
     extractMeshesFromResponse(options?: MeshExtractionOptions): Promise<THREE.Object3D<THREE.Object3DEventMap>[]>;
     /**
-     * Extract internal file data structures from the response.
-     * This includes Grasshopper-generated textures, JSON exports,
-     * CAD formats, or any file structure packaged in the response.
-     *
-     * **Note:** This only works when using the **Block to File** and **Geometry To File** components from the Selva plugin in Grasshopper, and requires the custom branch of rhino.compute from VektorNode.
-     *
-     * @returns Raw file data entries.
+     * Raw file entries packaged in the response (textures, JSON, CAD exports, …).
+     * Produced by the Selva **Block to File** / **Geometry To File** components on
+     * the VektorNode rhino.compute branch.
      */
     private getFileData;
     /**
@@ -470,19 +443,6 @@ declare class GrasshopperResponseProcessor {
     getAndDownloadFiles(folderName: string, additionalFiles?: FileBaseInfo[] | FileBaseInfo | null): Promise<void>;
 }
 
-/**
- * Hash definition and data tree into a stable cache key.
- *
- * The definition is the *identity* of what we solve, so a binary definition is
- * hashed over its full content (`fnv1aBytes`) — a length-only or sampled key
- * would let two different `.gh` files collide and serve one's cached solve for
- * the other. `.gh` files are small enough that a single linear pass is
- * negligible. (Note this differs from `stableStringify`'s sampled handling of a
- * `Uint8Array` found *inside* the dataTree, where sampling is a deliberate
- * per-solve perf tradeoff.)
- */
-declare function hashSolveInput(definition: string | Uint8Array, dataTree: unknown): string;
-
 /**
  * Runs a Rhino Compute job using the provided tree prototypes and Grasshopper definition.
  *
@@ -551,88 +511,15 @@ declare function fetchDefinitionIO(definition: string | Uint8Array, config: Comp
 declare function fetchParsedDefinitionIO(definition: string | Uint8Array, config: ComputeConfig): Promise<GrasshopperParsedIO>;
 
 /**
- * Processes a raw input parameter schema and converts it into a typed InputParam object.
- *
- * @internal This is an internal processor. Use `fetchParsedDefinitionIO()` to get processed inputs instead.
- *
- * This function handles the transformation of raw input parameter data from Grasshopper into
- * a structured, type-safe format. It performs validation, type-specific processing, and error
- * handling for various parameter types including numeric, boolean, text, geometry, point, and line inputs.
- *
- * @param rawInput - The raw input parameter schema to process
- * @returns A fully processed and typed InputParam object with appropriate type-specific properties
- *
- * @throws {RhinoComputeError} When an unknown paramType is encountered
- * @throws {Error} Re-throws any non-RhinoComputeError exceptions
- *
- * @remarks
- * The function performs the following operations:
- * - Extracts base properties common to all input types
- * - Preprocesses the raw input data
- * - Applies type-specific validation and transformation
- * - Handles errors gracefully by creating safe default values for validation errors
- *
- * Supported parameter types:
- * - `Number` and `Integer`: Numeric inputs with optional min/max constraints
- * - `Boolean`: Boolean flag inputs
- * - `Text`: String inputs
- * - `Geometry`: Generic geometry objects
- * - `Point`: 3D point objects
- * - `Line`: Line objects
- *
- * @example
- * ```typescript
- * const rawInput = {
- *   name: 'Length',
- *   paramType: 'Number',
- *   minimum: 0,
- *   maximum: 100,
- *   default: 50
- * };
- * const processedInput = processInput(rawInput);
- * ```
+ * Parse one raw Grasshopper input schema into a typed {@link InputParam}.
+ * Validation failures are swallowed and replaced with a safe default; use
+ * {@link processInputWithError} to receive them.
  */
 declare function processInput(rawInput: InputParamSchema): InputParam;
 /**
- * Processes raw Grasshopper input schemas into strongly-typed TypeScript interfaces.
- *
- * @internal This is an internal batch processor. Use `fetchParsedDefinitionIO()` to get processed inputs instead.
- *
- * Transforms each raw input parameter by:
- * - Normalizing default values (flattening data trees, parsing primitives)
- * - Applying type-specific parsing (Number, Text, Boolean, Geometry, etc.)
- * - Validating constraints (min/max, required fields)
- * - Converting to discriminated union types for type safety
- *
- * @param rawInputs - Array of raw input schemas from Rhino Compute API
- * @returns Array of processed, strongly-typed input parameters
- *
- * @remarks
- * - Empty data trees are converted to `undefined`
- * - Single values are extracted from arrays when appropriate
- * - Tree structures are preserved for list/tree access parameters
- * - Invalid inputs fall back to safe defaults with console warnings
- *
- * @example
- * ```typescript
- * const rawInputs = [
- *   { paramType: 'Number', name: 'radius', minimum: 0, default: 10 },
- *   { paramType: 'Text', name: 'label', default: 'Hello' }
- * ];
- *
- * const processed = processInputs(rawInputs);
- * // Result: [
- * //   { paramType: 'Number', name: 'radius', minimum: 0, default: 10, ... },
- * //   { paramType: 'Text', name: 'label', default: 'Hello', ... }
- * // ]
- *
- * // Now type-safe:
- * if (processed[0].paramType === 'Number') {
- *   console.log(processed[0].minimum); // TypeScript knows this exists
- * }
- * ```
- *
- * @see {@link processInput} for individual input processing logic
+ * Parse an array of raw input schemas into typed {@link InputParam}s, each via
+ * {@link processInput}. Use {@link processInputsWithErrors} to also collect the
+ * inputs that failed validation.
  */
 declare function processInputs(rawInputs: InputParamSchema[]): InputParam[];
 
@@ -906,4 +793,4 @@ declare class TreeBuilder {
     private static clampValue;
 }
 
-export { type CacheOptions, ComputeConfig, DataTree, DataTreeDefault, DataTreePath, type DataTreeValue, FileBaseInfo, type GetValuesOptions, type GetValuesResult, GrasshopperClient, GrasshopperComputeConfig, GrasshopperComputeResponse, GrasshopperParsedIO, GrasshopperParsedIORaw, GrasshopperResponseProcessor, InputParam, InputParamSchema, type ParsedContext, RetryPolicy, RhinoComputeError, type SchedulerMode, type SolveContext, type SolveExecutor, type SolveOptions, type SolveResult, SolveScheduler, type SolveSchedulerOptions, TreeBuilder, fetchDefinitionIO, fetchParsedDefinitionIO, hashSolveInput, processInput, processInputs, solveGrasshopperDefinition };
+export { type CacheOptions, ComputeConfig, DataTree, DataTreeDefault, DataTreePath, type DataTreeValue, FileBaseInfo, type GetValuesOptions, type GetValuesResult, GrasshopperClient, GrasshopperComputeConfig, GrasshopperComputeResponse, GrasshopperParsedIO, GrasshopperParsedIORaw, GrasshopperResponseProcessor, InputParam, InputParamSchema, type ParsedContext, RetryPolicy, RhinoComputeError, type SchedulerMode, type SolveContext, type SolveOptions, type SolveResult, SolveScheduler, type SolveSchedulerOptions, TreeBuilder, fetchDefinitionIO, fetchParsedDefinitionIO, processInput, processInputs, solveGrasshopperDefinition };

package/dist/grasshopper.d.ts

@@ -1,5 +1,5 @@
-import { R as RhinoComputeError, C as ComputeServerStats, F as FileBaseInfo } from './handle-files-UcwvknQ3.js';
-export { b as FileData, P as ProcessedFile, d as downloadFileData, e as extractFilesFromComputeResponse } from './handle-files-UcwvknQ3.js';
+import { R as RhinoComputeError, C as ComputeServerStats, F as FileBaseInfo } from './handle-files-Bu2qmaPj.js';
+export { b as FileData, P as ProcessedFile, d as downloadFileData, e as extractFilesFromComputeResponse } from './handle-files-Bu2qmaPj.js';
 import { R as RetryPolicy, C as ComputeConfig } from './types-ChF690kY.js';
 export { a as RhinoModelUnit } from './types-ChF690kY.js';
 import { f as GrasshopperComputeResponse, a as DataTree, e as GrasshopperComputeConfig, g as GrasshopperParsedIO, h as GrasshopperParsedIORaw, M as MeshExtractionOptions, k as InputParamSchema, j as InputParam, b as DataTreeDefault, c as DataTreePath } from './types-DxT3hSkx.js';
@@ -61,6 +61,15 @@ type SolveResult = {
     response: GrasshopperComputeResponse;
     durationMs: number;
     fromCache: boolean;
+    /**
+     * Definition-cache telemetry for a real compute call (not a Selva-cache
+     * `fromCache` hit). `false` → the server reused its cached definition via
+     * the pointer (no upload); `true` → the pointer was cold/stale so the full
+     * definition was re-uploaded. `undefined` when the server-definition-cache
+     * fast path didn't run (reuse disabled, or a non-reusable definition such
+     * as a remote URL).
+     */
+    definitionReuploaded?: boolean;
 } | {
     status: 'error';
     error: RhinoComputeError;
@@ -347,20 +356,15 @@ interface GetValuesResult<T = ParsedContext> {
 declare class GrasshopperResponseProcessor {
     private readonly response;
     private readonly debug;
-    /**
-     * Store the compute response for reuse.
-     */
     constructor(response: GrasshopperComputeResponse, debug?: boolean);
     /**
      * Extract all values in the response.
      *
      * @typeParam T - Expected structure of the return value. Defaults to a simple key/value map. (later cast as needed)
-     * @param byId - If true, keys are parameter IDs; if false, keys are parameter names.
+     * @param byId - Key by parameter ID instead of name. Requires the VektorNode rhino.compute branch.
      * @param options - Controls parsing behavior such as Rhino geometry decoding.
      * @returns Parsed Grasshopper output values.
      *
-     * **Note:** Using `byId` only works with the custom VektorNode rhino.compute branch.
-     *
      * @example
      * ```ts
      * const processor = new GrasshopperResponseProcessor(response);
@@ -380,13 +384,13 @@ declare class GrasshopperResponseProcessor {
      * @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.
      *
+     * `byId` requires the VektorNode rhino.compute branch.
+     *
      * @example
      * ```ts
      * 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;
@@ -394,57 +398,26 @@ declare class GrasshopperResponseProcessor {
         byId: string;
     }, options?: GetValuesOptions): any;
     /**
-     * @deprecated Use `getValue({ byName })` instead.
-     */
-    getValueByParamName(paramName: string, options?: GetValuesOptions): any;
-    /**
-     * @deprecated Use `getValue({ byId })` instead.
-     */
-    getValueByParamId(paramId: string, options?: GetValuesOptions): any;
-    /**
-     * Convert all geometry results into Three.js mesh objects.
-     *
-     * This uses internal helpers to decode Rhino geometry into Three.js
-     * primitives such as meshes and lines, making them ready for rendering.
+     * Decode all geometry results into Three.js meshes/lines ready for rendering.
+     * The processor's `debug` flag is merged with `options` (explicit options win).
      *
-     * All processing options (scaling, positioning, compression, etc.) can be customized.
-     * The processor's debug flag is merged with options - explicit options take precedence.
+     * Requires the **Selva Display** Grasshopper component and the VektorNode
+     * rhino.compute branch. Three.js is loaded dynamically, so install it as a
+     * peer dependency before calling this.
      *
-     * **Note:** This only works when using the **Selva Display** component in Grasshopper, and requires the custom branch of rhino.compute from VektorNode. This method dynamically imports three.js visualization modules. Ensure three.js is installed as a peer dependency if you use this feature.
-     *
-     * @param options - Configuration for mesh extraction and parsing. Overrides processor's debug flag if provided.
-     * @returns Promise resolving to an array of Three.js mesh objects.
-     * @throws {RhinoComputeError} If three.js visualization module cannot be loaded.
+     * @throws {RhinoComputeError} If the three.js visualization module can't load.
      *
      * @example
      * ```ts
      * const meshes = await processor.extractMeshesFromResponse();
      * scene.add(...meshes);
      * ```
-     *
-     * @example
-     * ```ts
-     * const meshes = await processor.extractMeshesFromResponse({
-     *   debug: true,
-     *   allowScaling: true,
-     *   allowAutoPosition: false,
-     *   parsing: {
-     *     mergeByMaterial: false,
-     *     applyTransforms: true,
-     *     debug: true,
-     *   },
-     * });
-     * ```
      */
     extractMeshesFromResponse(options?: MeshExtractionOptions): Promise<THREE.Object3D<THREE.Object3DEventMap>[]>;
     /**
-     * Extract internal file data structures from the response.
-     * This includes Grasshopper-generated textures, JSON exports,
-     * CAD formats, or any file structure packaged in the response.
-     *
-     * **Note:** This only works when using the **Block to File** and **Geometry To File** components from the Selva plugin in Grasshopper, and requires the custom branch of rhino.compute from VektorNode.
-     *
-     * @returns Raw file data entries.
+     * Raw file entries packaged in the response (textures, JSON, CAD exports, …).
+     * Produced by the Selva **Block to File** / **Geometry To File** components on
+     * the VektorNode rhino.compute branch.
      */
     private getFileData;
     /**
@@ -470,19 +443,6 @@ declare class GrasshopperResponseProcessor {
     getAndDownloadFiles(folderName: string, additionalFiles?: FileBaseInfo[] | FileBaseInfo | null): Promise<void>;
 }
 
-/**
- * Hash definition and data tree into a stable cache key.
- *
- * The definition is the *identity* of what we solve, so a binary definition is
- * hashed over its full content (`fnv1aBytes`) — a length-only or sampled key
- * would let two different `.gh` files collide and serve one's cached solve for
- * the other. `.gh` files are small enough that a single linear pass is
- * negligible. (Note this differs from `stableStringify`'s sampled handling of a
- * `Uint8Array` found *inside* the dataTree, where sampling is a deliberate
- * per-solve perf tradeoff.)
- */
-declare function hashSolveInput(definition: string | Uint8Array, dataTree: unknown): string;
-
 /**
  * Runs a Rhino Compute job using the provided tree prototypes and Grasshopper definition.
  *
@@ -551,88 +511,15 @@ declare function fetchDefinitionIO(definition: string | Uint8Array, config: Comp
 declare function fetchParsedDefinitionIO(definition: string | Uint8Array, config: ComputeConfig): Promise<GrasshopperParsedIO>;
 
 /**
- * Processes a raw input parameter schema and converts it into a typed InputParam object.
- *
- * @internal This is an internal processor. Use `fetchParsedDefinitionIO()` to get processed inputs instead.
- *
- * This function handles the transformation of raw input parameter data from Grasshopper into
- * a structured, type-safe format. It performs validation, type-specific processing, and error
- * handling for various parameter types including numeric, boolean, text, geometry, point, and line inputs.
- *
- * @param rawInput - The raw input parameter schema to process
- * @returns A fully processed and typed InputParam object with appropriate type-specific properties
- *
- * @throws {RhinoComputeError} When an unknown paramType is encountered
- * @throws {Error} Re-throws any non-RhinoComputeError exceptions
- *
- * @remarks
- * The function performs the following operations:
- * - Extracts base properties common to all input types
- * - Preprocesses the raw input data
- * - Applies type-specific validation and transformation
- * - Handles errors gracefully by creating safe default values for validation errors
- *
- * Supported parameter types:
- * - `Number` and `Integer`: Numeric inputs with optional min/max constraints
- * - `Boolean`: Boolean flag inputs
- * - `Text`: String inputs
- * - `Geometry`: Generic geometry objects
- * - `Point`: 3D point objects
- * - `Line`: Line objects
- *
- * @example
- * ```typescript
- * const rawInput = {
- *   name: 'Length',
- *   paramType: 'Number',
- *   minimum: 0,
- *   maximum: 100,
- *   default: 50
- * };
- * const processedInput = processInput(rawInput);
- * ```
+ * Parse one raw Grasshopper input schema into a typed {@link InputParam}.
+ * Validation failures are swallowed and replaced with a safe default; use
+ * {@link processInputWithError} to receive them.
  */
 declare function processInput(rawInput: InputParamSchema): InputParam;
 /**
- * Processes raw Grasshopper input schemas into strongly-typed TypeScript interfaces.
- *
- * @internal This is an internal batch processor. Use `fetchParsedDefinitionIO()` to get processed inputs instead.
- *
- * Transforms each raw input parameter by:
- * - Normalizing default values (flattening data trees, parsing primitives)
- * - Applying type-specific parsing (Number, Text, Boolean, Geometry, etc.)
- * - Validating constraints (min/max, required fields)
- * - Converting to discriminated union types for type safety
- *
- * @param rawInputs - Array of raw input schemas from Rhino Compute API
- * @returns Array of processed, strongly-typed input parameters
- *
- * @remarks
- * - Empty data trees are converted to `undefined`
- * - Single values are extracted from arrays when appropriate
- * - Tree structures are preserved for list/tree access parameters
- * - Invalid inputs fall back to safe defaults with console warnings
- *
- * @example
- * ```typescript
- * const rawInputs = [
- *   { paramType: 'Number', name: 'radius', minimum: 0, default: 10 },
- *   { paramType: 'Text', name: 'label', default: 'Hello' }
- * ];
- *
- * const processed = processInputs(rawInputs);
- * // Result: [
- * //   { paramType: 'Number', name: 'radius', minimum: 0, default: 10, ... },
- * //   { paramType: 'Text', name: 'label', default: 'Hello', ... }
- * // ]
- *
- * // Now type-safe:
- * if (processed[0].paramType === 'Number') {
- *   console.log(processed[0].minimum); // TypeScript knows this exists
- * }
- * ```
- *
- * @see {@link processInput} for individual input processing logic
+ * Parse an array of raw input schemas into typed {@link InputParam}s, each via
+ * {@link processInput}. Use {@link processInputsWithErrors} to also collect the
+ * inputs that failed validation.
  */
 declare function processInputs(rawInputs: InputParamSchema[]): InputParam[];
 
@@ -906,4 +793,4 @@ declare class TreeBuilder {
     private static clampValue;
 }
 
-export { type CacheOptions, ComputeConfig, DataTree, DataTreeDefault, DataTreePath, type DataTreeValue, FileBaseInfo, type GetValuesOptions, type GetValuesResult, GrasshopperClient, GrasshopperComputeConfig, GrasshopperComputeResponse, GrasshopperParsedIO, GrasshopperParsedIORaw, GrasshopperResponseProcessor, InputParam, InputParamSchema, type ParsedContext, RetryPolicy, RhinoComputeError, type SchedulerMode, type SolveContext, type SolveExecutor, type SolveOptions, type SolveResult, SolveScheduler, type SolveSchedulerOptions, TreeBuilder, fetchDefinitionIO, fetchParsedDefinitionIO, hashSolveInput, processInput, processInputs, solveGrasshopperDefinition };
+export { type CacheOptions, ComputeConfig, DataTree, DataTreeDefault, DataTreePath, type DataTreeValue, FileBaseInfo, type GetValuesOptions, type GetValuesResult, GrasshopperClient, GrasshopperComputeConfig, GrasshopperComputeResponse, GrasshopperParsedIO, GrasshopperParsedIORaw, GrasshopperResponseProcessor, InputParam, InputParamSchema, type ParsedContext, RetryPolicy, RhinoComputeError, type SchedulerMode, type SolveContext, type SolveOptions, type SolveResult, SolveScheduler, type SolveSchedulerOptions, TreeBuilder, fetchDefinitionIO, fetchParsedDefinitionIO, processInput, processInputs, solveGrasshopperDefinition };

package/dist/grasshopper.js

@@ -1,2 +1,2 @@
-import{a as d,b as e,c as f,d as g,e as h,f as i,g as j,h as k,i as l,j as m}from"./chunk-UFFSB36M.js";import{d as a,q as b,r as c}from"./chunk-GY2WLD42.js";export{g as GrasshopperClient,h as GrasshopperResponseProcessor,a as RhinoComputeError,f as SolveScheduler,m as TreeBuilder,c as downloadFileData,b as extractFilesFromComputeResponse,k as fetchDefinitionIO,l as fetchParsedDefinitionIO,e as hashSolveInput,i as processInput,j as processInputs,d as solveGrasshopperDefinition};
+import{a as d,b as e,c as f,d as g,e as h,f as i,g as j,h as k,i as l}from"./chunk-WHB32TTR.js";import{d as a,o as b,p as c}from"./chunk-2KAHGLXE.js";export{f as GrasshopperClient,g as GrasshopperResponseProcessor,a as RhinoComputeError,e as SolveScheduler,l as TreeBuilder,c as downloadFileData,b as extractFilesFromComputeResponse,j as fetchDefinitionIO,k as fetchParsedDefinitionIO,h as processInput,i as processInputs,d as solveGrasshopperDefinition};
 //# sourceMappingURL=grasshopper.js.map

package/dist/{handle-files-UcwvknQ3.d.ts → handle-files-Bu2qmaPj.d.cts}

@@ -29,11 +29,20 @@ declare class ComputeServerStats {
      * @param serverUrl - Base URL of the Rhino Compute server with http:// or https:// scheme (e.g., 'http://localhost:6500')
      * @param apiKey - Optional API key for authentication
      */
+    /** Timeout (ms) for the fast read/monitoring endpoints. */
+    private static readonly DEFAULT_TIMEOUT_MS;
+    /** Timeout (ms) for child-lifecycle POSTs — a cold Windows child can take ~30s to spawn. */
+    private static readonly LIFECYCLE_TIMEOUT_MS;
     constructor(serverUrl: string, apiKey?: string);
     /**
      * Build request headers with optional API key.
      */
     private buildHeaders;
+    /**
+     * `fetch` wrapper that aborts after `timeoutMs` so a hung connection can't stall
+     * a probe (or the `monitor()` loop) forever. Pass `0` to disable the timeout.
+     */
+    private fetchWithTimeout;
     /**
      * Check if the server is online.
      *
@@ -256,7 +265,8 @@ declare class ComputeServerStats {
     /**
      * POST a control endpoint that replies with a JSON object and return it,
      * degrading to `null` on any non-2xx, non-JSON, or network failure. Shared by
-     * the child-lifecycle methods so their failure semantics stay identical.
+     * the child-lifecycle methods so their failure semantics stay identical. Uses
+     * the longer lifecycle timeout since a spawn/recycle can take ~30s.
      */
     private postJson;
     /**

package/dist/{handle-files-UcwvknQ3.d.cts → handle-files-Bu2qmaPj.d.ts}

@@ -29,11 +29,20 @@ declare class ComputeServerStats {
      * @param serverUrl - Base URL of the Rhino Compute server with http:// or https:// scheme (e.g., 'http://localhost:6500')
      * @param apiKey - Optional API key for authentication
      */
+    /** Timeout (ms) for the fast read/monitoring endpoints. */
+    private static readonly DEFAULT_TIMEOUT_MS;
+    /** Timeout (ms) for child-lifecycle POSTs — a cold Windows child can take ~30s to spawn. */
+    private static readonly LIFECYCLE_TIMEOUT_MS;
     constructor(serverUrl: string, apiKey?: string);
     /**
      * Build request headers with optional API key.
      */
     private buildHeaders;
+    /**
+     * `fetch` wrapper that aborts after `timeoutMs` so a hung connection can't stall
+     * a probe (or the `monitor()` loop) forever. Pass `0` to disable the timeout.
+     */
+    private fetchWithTimeout;
     /**
      * Check if the server is online.
      *
@@ -256,7 +265,8 @@ declare class ComputeServerStats {
     /**
      * POST a control endpoint that replies with a JSON object and return it,
      * degrading to `null` on any non-2xx, non-JSON, or network failure. Shared by
-     * the child-lifecycle methods so their failure semantics stay identical.
+     * the child-lifecycle methods so their failure semantics stay identical. Uses
+     * the longer lifecycle timeout since a spawn/recycle can take ~30s.
      */
     private postJson;
     /**

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk2EO6UUZFcjs = require('./chunk-2EO6UUZF.cjs');var _chunkXA4OMT6Zcjs = require('./chunk-XA4OMT6Z.cjs');exports.ComputeServerStats = _chunkXA4OMT6Zcjs.j; exports.ErrorCodes = _chunkXA4OMT6Zcjs.c; exports.GrasshopperClient = _chunk2EO6UUZFcjs.d; exports.GrasshopperResponseProcessor = _chunk2EO6UUZFcjs.e; exports.RhinoComputeError = _chunkXA4OMT6Zcjs.d; exports.SolveScheduler = _chunk2EO6UUZFcjs.c; exports.TreeBuilder = _chunk2EO6UUZFcjs.j; exports.camelcaseKeys = _chunkXA4OMT6Zcjs.l; exports.downloadFileData = _chunkXA4OMT6Zcjs.r; exports.enableDebugLogging = _chunkXA4OMT6Zcjs.g; exports.extractFilesFromComputeResponse = _chunkXA4OMT6Zcjs.q; exports.fetchDefinitionIO = _chunk2EO6UUZFcjs.h; exports.fetchParsedDefinitionIO = _chunk2EO6UUZFcjs.i; exports.fetchRhinoCompute = _chunkXA4OMT6Zcjs.h; exports.getLogger = _chunkXA4OMT6Zcjs.e; exports.hashSolveInput = _chunk2EO6UUZFcjs.b; exports.processInput = _chunk2EO6UUZFcjs.f; exports.processInputs = _chunk2EO6UUZFcjs.g; exports.setLogger = _chunkXA4OMT6Zcjs.f; exports.solveGrasshopperDefinition = _chunk2EO6UUZFcjs.a; exports.toCamelCase = _chunkXA4OMT6Zcjs.k;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkBF7OQEQGcjs = require('./chunk-BF7OQEQG.cjs');var _chunk2QHLW6ZLcjs = require('./chunk-2QHLW6ZL.cjs');exports.ComputeServerStats = _chunk2QHLW6ZLcjs.j; exports.ErrorCodes = _chunk2QHLW6ZLcjs.c; exports.GrasshopperClient = _chunkBF7OQEQGcjs.c; exports.GrasshopperResponseProcessor = _chunkBF7OQEQGcjs.d; exports.RhinoComputeError = _chunk2QHLW6ZLcjs.d; exports.SolveScheduler = _chunkBF7OQEQGcjs.b; exports.TreeBuilder = _chunkBF7OQEQGcjs.i; exports.downloadFileData = _chunk2QHLW6ZLcjs.p; exports.enableDebugLogging = _chunk2QHLW6ZLcjs.g; exports.extractFilesFromComputeResponse = _chunk2QHLW6ZLcjs.o; exports.fetchDefinitionIO = _chunkBF7OQEQGcjs.g; exports.fetchParsedDefinitionIO = _chunkBF7OQEQGcjs.h; exports.fetchRhinoCompute = _chunk2QHLW6ZLcjs.h; exports.getLogger = _chunk2QHLW6ZLcjs.e; exports.processInput = _chunkBF7OQEQGcjs.e; exports.processInputs = _chunkBF7OQEQGcjs.f; exports.setLogger = _chunk2QHLW6ZLcjs.f; exports.solveGrasshopperDefinition = _chunkBF7OQEQGcjs.a;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/selva-compute/selva-compute/dist/index.cjs"],"names":[],"mappings":"AAAA,iIAAuG,wDAAqG,u/BAA8d","file":"/home/runner/work/selva-compute/selva-compute/dist/index.cjs"}
+{"version":3,"sources":["/home/runner/work/selva-compute/selva-compute/dist/index.cjs"],"names":[],"mappings":"AAAA,iIAAgG,wDAAuF,i3BAAsa","file":"/home/runner/work/selva-compute/selva-compute/dist/index.cjs"}

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-UcwvknQ3.cjs';
+export { Logger, enableDebugLogging, fetchRhinoCompute, getLogger, setLogger } 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-Bu2qmaPj.cjs';
 export { C as ComputeConfig, R as RetryPolicy, a as RhinoModelUnit, S as ServerTiming } from './types-ChF690kY.cjs';
-export { CacheOptions, DataTreeValue, GetValuesOptions, GetValuesResult, GrasshopperClient, GrasshopperResponseProcessor, ParsedContext, SchedulerMode, SolveContext, SolveExecutor, SolveOptions, SolveResult, SolveScheduler, SolveSchedulerOptions, TreeBuilder, fetchDefinitionIO, fetchParsedDefinitionIO, hashSolveInput, processInput, processInputs, solveGrasshopperDefinition } from './grasshopper.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-D-HQ-gWI.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-UcwvknQ3.js';
+export { Logger, enableDebugLogging, fetchRhinoCompute, getLogger, setLogger } 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-Bu2qmaPj.js';
 export { C as ComputeConfig, R as RetryPolicy, a as RhinoModelUnit, S as ServerTiming } from './types-ChF690kY.js';
-export { CacheOptions, DataTreeValue, GetValuesOptions, GetValuesResult, GrasshopperClient, GrasshopperResponseProcessor, ParsedContext, SchedulerMode, SolveContext, SolveExecutor, SolveOptions, SolveResult, SolveScheduler, SolveSchedulerOptions, TreeBuilder, fetchDefinitionIO, fetchParsedDefinitionIO, hashSolveInput, processInput, processInputs, solveGrasshopperDefinition } from './grasshopper.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-DxT3hSkx.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,j as s}from"./chunk-UFFSB36M.js";import{c as o,d as r,e,f,g as m,h as p,j as t,k as x,l as a,q as b,r as c}from"./chunk-GY2WLD42.js";export{t as ComputeServerStats,o as ErrorCodes,i as GrasshopperClient,j as GrasshopperResponseProcessor,r as RhinoComputeError,h as SolveScheduler,s as TreeBuilder,a as camelcaseKeys,c as downloadFileData,m as enableDebugLogging,b as extractFilesFromComputeResponse,n as fetchDefinitionIO,q as fetchParsedDefinitionIO,p as fetchRhinoCompute,e as getLogger,g as hashSolveInput,k as processInput,l as processInputs,f as setLogger,d 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}from"./chunk-WHB32TTR.js";import{c as o,d as r,e,f,g as m,h as p,j as t,o as x,p as a}from"./chunk-2KAHGLXE.js";export{t as ComputeServerStats,o as ErrorCodes,d as GrasshopperClient,g as GrasshopperResponseProcessor,r as RhinoComputeError,c as SolveScheduler,l as TreeBuilder,a as downloadFileData,m as enableDebugLogging,x as extractFilesFromComputeResponse,j as fetchDefinitionIO,k as fetchParsedDefinitionIO,p as fetchRhinoCompute,e as getLogger,h as processInput,i as processInputs,f as setLogger,b as solveGrasshopperDefinition};
 //# sourceMappingURL=index.js.map

package/dist/visualization-N3OJSZOY.js

@@ -0,0 +1,2 @@
+import{A as u,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 m,k as l,l as f,m as y,n as d,o as h,p as x,q as C,r as g,s as M,t as c,u as B,v as j,w as E,x as O,y as D,z as b}from"./chunk-HKU2XHQQ.js";import"./chunk-2KAHGLXE.js";export{M as BINARY_MESH_MAGIC,c as BINARY_MESH_VERSION,p as EDGE_USERDATA_KIND,B as FLAG_FLOAT32,C as Materials,b as SCALE_FACTORS,n as addEdges,o as applyOffset,t as computeCombinedBoundingBox,a as createCameraController,s as createGrid,y as createLabelLayer,h as createMeasureTool,f as createRenderPipeline,i as createViewGizmo,u as getThreeMeshesFromComputeResponse,x as initThree,m as isEdgeOverlay,j as parseBinaryMeshBatch,r as parseColor,g as parseDisplayItems,E as parseMeshBatch,D as parseMeshBatchBlob,O as parseMeshBatchObject,l as removeEdges,d as snapToVertex,e as updateScene};
+//# sourceMappingURL=visualization-N3OJSZOY.js.map

package/dist/visualization-UOIWXLDL.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkSA67IFJHcjs = require('./chunk-SA67IFJH.cjs');require('./chunk-2QHLW6ZL.cjs');exports.BINARY_MESH_MAGIC = _chunkSA67IFJHcjs.s; exports.BINARY_MESH_VERSION = _chunkSA67IFJHcjs.t; exports.EDGE_USERDATA_KIND = _chunkSA67IFJHcjs.h; exports.FLAG_FLOAT32 = _chunkSA67IFJHcjs.u; exports.Materials = _chunkSA67IFJHcjs.q; exports.SCALE_FACTORS = _chunkSA67IFJHcjs.z; exports.addEdges = _chunkSA67IFJHcjs.i; exports.applyOffset = _chunkSA67IFJHcjs.c; exports.computeCombinedBoundingBox = _chunkSA67IFJHcjs.d; exports.createCameraController = _chunkSA67IFJHcjs.e; exports.createGrid = _chunkSA67IFJHcjs.f; exports.createLabelLayer = _chunkSA67IFJHcjs.m; exports.createMeasureTool = _chunkSA67IFJHcjs.o; exports.createRenderPipeline = _chunkSA67IFJHcjs.l; exports.createViewGizmo = _chunkSA67IFJHcjs.g; exports.getThreeMeshesFromComputeResponse = _chunkSA67IFJHcjs.A; exports.initThree = _chunkSA67IFJHcjs.p; exports.isEdgeOverlay = _chunkSA67IFJHcjs.j; exports.parseBinaryMeshBatch = _chunkSA67IFJHcjs.v; exports.parseColor = _chunkSA67IFJHcjs.b; exports.parseDisplayItems = _chunkSA67IFJHcjs.r; exports.parseMeshBatch = _chunkSA67IFJHcjs.w; exports.parseMeshBatchBlob = _chunkSA67IFJHcjs.y; exports.parseMeshBatchObject = _chunkSA67IFJHcjs.x; exports.removeEdges = _chunkSA67IFJHcjs.k; exports.snapToVertex = _chunkSA67IFJHcjs.n; exports.updateScene = _chunkSA67IFJHcjs.a;
+//# sourceMappingURL=visualization-UOIWXLDL.cjs.map

package/dist/{visualization-ZFXCE5NW.cjs.map → visualization-UOIWXLDL.cjs.map}

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