@selvajs/compute 1.5.3 → 2.0.0-beta.1

package/dist/grasshopper.d.cts

@@ -1,8 +1,10 @@
-import { R as RhinoComputeError, C as ComputeServerStats } from './errors-CEy4nM1J.cjs';
-import { R as RetryPolicy, f as GrasshopperComputeResponse, a as DataTree, e as GrasshopperComputeConfig, g as GrasshopperParsedIO, h as GrasshopperParsedIORaw, C as ComputeConfig, k as InputParamSchema, j as InputParam, b as DataTreeDefault, c as DataTreePath } from './types-Dfeei0dD.cjs';
-export { B as BooleanInputType, D as DataItem, d as DefaultValue, F as FileInputType, G as GeometryInputType, i as GrasshopperRequestSchema, I as InnerTreeData, N as NumericInputType, O as OutputParamSchema, l as OutputType, m as RhinoModelUnit, T as TextInputType, V as ValueListInputType } from './types-Dfeei0dD.cjs';
+import { R as RhinoComputeError, C as ComputeServerStats, F as FileBaseInfo } from './handle-files-DsrxHKHP.cjs';
+export { b as FileData, P as ProcessedFile, d as downloadFileData, e as extractFilesFromComputeResponse } from './handle-files-DsrxHKHP.cjs';
+import { R as RetryPolicy, C as ComputeConfig } from './types-D1SkNje_.cjs';
+export { a as RhinoModelUnit } from './types-D1SkNje_.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-CJ092lxB.cjs';
+export { B as BooleanInputType, D as DataItem, d as DefaultValue, F as FileInputType, G as GeometryInputType, i as GrasshopperRequestSchema, I as InnerTreeData, N as NumericInputType, O as OutputParamSchema, l as OutputType, T as TextInputType, V as ValueListInputType } from './types-CJ092lxB.cjs';
 import * as THREE from 'three';
-import { M as MeshExtractionOptions } from './types-COCuQEMk.cjs';
 
 /**
  * Scheduling mode — controls how concurrent `solve()` calls interact.
@@ -28,6 +30,18 @@ interface SolveSchedulerOptions {
     retry?: RetryPolicy;
     /** Enable response caching keyed by hash of (definition, dataTree). */
     cache?: boolean | CacheOptions;
+    /**
+     * Reuse the server's definition cache key so a large (base64/binary)
+     * definition is uploaded once and subsequent solves reference it by
+     * `pointer` instead of re-sending the full payload. Hugely cheaper for
+     * multi-MB definitions on a live UI (slider scrubs, etc.).
+     *
+     * Requires a `cacheKeyExecutor` to be supplied (the client wires one). Has no
+     * effect for URL-pointer definitions (already a reference). On a server-side
+     * cache miss the executor transparently falls back to a full upload, so this
+     * is safe to leave on. Default: `true` when a `cacheKeyExecutor` is present.
+     */
+    reuseServerDefinitionCache?: boolean;
     /** Lifecycle hooks — fired in order. Errors thrown by hooks are logged, not rethrown. */
     onStart?: (ctx: SolveContext) => void;
     onSettle?: (ctx: SolveContext, result: SolveResult) => void;
@@ -58,6 +72,22 @@ type SolveResult = {
  * without a real Compute server, and decouples it from the client class.
  */
 type SolveExecutor = (definition: string | Uint8Array, dataTree: DataTree[], config: GrasshopperComputeConfig) => Promise<GrasshopperComputeResponse>;
+/**
+ * Cache-key-aware executor. When `cacheKey` is provided, the executor solves by
+ * reference (`pointer: cacheKey`) and falls back to a full upload on a server
+ * cache miss. Always reports the (possibly refreshed) `cacheKey` so the
+ * scheduler can update its definition→key map, plus whether the fast path
+ * `missed` (for telemetry). When `cacheKey` is null it's a first solve — upload
+ * fully and capture the key the server assigns.
+ *
+ * Supplied by the client (which owns the solve primitives); the scheduler stays
+ * decoupled from the transport.
+ */
+type CacheKeyExecutor = (definition: string | Uint8Array, dataTree: DataTree[], cacheKey: string | null, config: GrasshopperComputeConfig) => Promise<{
+    response: GrasshopperComputeResponse;
+    cacheKey: string | null;
+    missed: boolean;
+}>;
 /**
  * Robust scheduler for Grasshopper solves.
  *
@@ -100,6 +130,11 @@ declare class SolveScheduler {
     private readonly cacheMax;
     private readonly cacheTtl;
     private readonly cache;
+    /** Optional cache-key-aware executor and whether server-def-cache reuse is on. */
+    private readonly cacheKeyExecutor?;
+    private readonly reuseServerDefinitionCache;
+    /** definition identity → server cache key (`pointer`) learned from past solves. */
+    private readonly serverCacheKeys;
     private readonly onStart?;
     private readonly onSettle?;
     private readonly onSuperseded?;
@@ -111,7 +146,7 @@ declare class SolveScheduler {
     private _lastError;
     private _lastDurationMs;
     private disposed;
-    constructor(executor: SolveExecutor, baseConfig: GrasshopperComputeConfig, options?: SolveSchedulerOptions);
+    constructor(executor: SolveExecutor, baseConfig: GrasshopperComputeConfig, options?: SolveSchedulerOptions, cacheKeyExecutor?: CacheKeyExecutor);
     get isSolving(): boolean;
     get hasPending(): boolean;
     get inFlightCount(): number;
@@ -137,9 +172,36 @@ declare class SolveScheduler {
     }): Promise<GrasshopperComputeResponse>;
     private enqueue;
     private execute;
+    /**
+     * Run the solve, using the server-definition-cache fast path when it's
+     * enabled and the definition is reusable. Learns/updates the definition's
+     * server cache key from the result so later solves can reference it.
+     */
+    private runExecutor;
     private drainNext;
     private supersede;
     private makeAbortError;
+    /**
+     * Settle a pending/in-flight item exactly once with an error.
+     *
+     * A solve promise can be settled from four concurrent sources — the executor
+     * resolving, the executor rejecting, `supersede`, and `cancelAll` — and a JS
+     * promise silently ignores a second settle. This guard is the single place the
+     * settle-once invariant lives: it makes the *first* settle win and reports
+     * whether this call was that winner, so callers fire their own hook only when
+     * they actually settled. Any new settle path must go through here (or
+     * {@link settleSuccess}) so the guard can't be forgotten.
+     *
+     * @returns `true` if this call settled the item; `false` if it was already settled.
+     */
+    private settleError;
+    /**
+     * Settle a pending/in-flight item exactly once with a successful response.
+     * The success counterpart to {@link settleError}; see it for the invariant.
+     *
+     * @returns `true` if this call settled the item; `false` if it was already settled.
+     */
+    private settleSuccess;
     private isAbortLikeError;
     private normalizeExecutionError;
     /** Cancel everything — in-flight and pending. */
@@ -250,64 +312,6 @@ declare class GrasshopperClient {
     private normalizeComputeConfig;
 }
 
-/**
- * Represents raw file data from Grasshopper/Rhino Compute response.
- *
- * This type encapsulates file output from compute operations, with metadata
- * for processing (decoding, naming, organization). Files are typically combined
- * with additional files and packaged into a ZIP archive for download.
- *
- * @see {@link ProcessedFile} for the normalized format after processing
- * @see {@link extractFilesFromComputeResponse} for extraction from compute responses
- */
-type FileData = {
-    /** Base filename without extension (e.g., "model") */
-    fileName: string;
-    /** File content as a base64-encoded or plain string, depending on {@link IsBase64Encoded} */
-    data: string;
-    /** File extension including the dot (e.g., ".3dm", ".json"). Appended to {@link FileName} to create the full filename */
-    fileType: string;
-    /** Whether {@link Data} is base64-encoded. If true, must be decoded to binary before use. If false, can be used as a plain text string */
-    isBase64Encoded: boolean;
-    /** Directory path for organizing the file in archive structures (e.g., ZIP). Typically empty string for root-level files, or a path like "subfolder/nested" */
-    subFolder: string;
-};
-/**
- * Represents a normalized, processed file ready for consumption or archival.
- *
- * This is the unified intermediate format produced by processing both {@link FileData}
- * and {@link FileBaseInfo}. Files in this format are ready to be packaged into archives
- * (e.g., ZIP files) or returned to callers for programmatic use.
- *
- * @see {@link FileData} for raw compute response files
- * @see {@link FileBaseInfo} for external file references
- */
-type ProcessedFile = {
-    /** Full filename including extension (e.g., "model.3dm") */
-    fileName: string;
-    /** File content as either binary data or text. Binary format (Uint8Array) is used for decoded base64 or fetched binary files; text format is used for plain text content */
-    content: Uint8Array | string;
-    /** File path for archive organization (e.g., "subfolder/model.3dm"). Used when creating ZIP archives or other hierarchical structures */
-    path: string;
-};
-/**
- * Represents a reference to an external file to be included in file operations.
- *
- * This type is used to specify additional files (beyond compute response files)
- * that should be fetched and included when processing files. The file is fetched
- * from the provided URL and processed as a {@link ProcessedFile}.
- *
- *
- * @see {@link FileData} for files from compute responses
- * @see {@link processFiles} for how FileBaseInfo is processed (fetched and converted)
- */
-type FileBaseInfo = {
-    /** Destination filename for the file in the archive or result set (e.g., "additional-data.json") */
-    fileName: string;
-    /** URL to fetch the file from. Must be accessible from the runtime environment */
-    filePath: string;
-};
-
 interface ParsedContext {
     [key: string]: any;
 }
@@ -423,7 +427,7 @@ declare class GrasshopperResponseProcessor {
      * });
      * ```
      */
-    extractMeshesFromResponse(options?: MeshExtractionOptions): Promise<THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>[]>;
+    extractMeshesFromResponse(options?: MeshExtractionOptions): Promise<THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>[]>;
     /**
      * Extract internal file data structures from the response.
      * This includes Grasshopper-generated textures, JSON exports,
@@ -459,7 +463,14 @@ declare class GrasshopperResponseProcessor {
 
 /**
  * Hash definition and data tree into a stable cache key.
- * For Uint8Array, uses length + samples to keep hashing fast.
+ *
+ * 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;
 
@@ -872,10 +883,6 @@ declare class TreeBuilder {
      * Check if a value is valid for inclusion in a DataTree.
      */
     private static hasValidValue;
-    /**
-     * Check if value is a TreeBuilder structure.
-     */
-    private static isDataTreeStructure;
     /**
      * Check if input is numeric type.
      */
@@ -890,35 +897,4 @@ declare class TreeBuilder {
     private static clampValue;
 }
 
-/**
- * Extracts and processes files from compute response data without downloading them.
- * Returns an array of ProcessedFile objects that can be used programmatically.
- *
- * @param downloadableFiles - An array of FileData items from the compute response.
- * @param additionalFiles - Optional additional files to include (fetched from URLs).
- * @returns A Promise resolving to an array of ProcessedFile objects.
- * @throws Will throw an error if file processing fails.
- *
- * @example
- * const files = await extractFilesFromComputeResponse(fileData);
- * files.forEach(file => {
- *   console.log(`File: ${file.fileName}, Size: ${file.content.length}`);
- * });
- */
-declare const extractFilesFromComputeResponse: (downloadableFiles: FileData[], additionalFiles?: FileBaseInfo[] | FileBaseInfo | null) => Promise<ProcessedFile[]>;
-/**
- * Downloads files from a compute response as a ZIP archive.
- * Packages multiple files into a single ZIP file and triggers a browser download.
- *
- * @param downloadableFiles - An array of FileData items from the compute response.
- * @param additionalFiles - Optional additional files to include in the ZIP (fetched from URLs).
- * @param fileFoldername - The name of the ZIP file (without extension).
- * @throws Will throw an error if the file handling or download fails.
- *
- * @example
- * await downloadDataFromComputeResponse(fileData, null, 'my-export');
- * // Downloads 'my-export.zip'
- */
-declare const downloadFileData: (downloadableFiles: FileData[], fileFoldername: string, additionalFiles?: FileBaseInfo[] | FileBaseInfo | null) => Promise<void>;
-
-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 };
+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 };

package/dist/grasshopper.d.ts

@@ -1,8 +1,10 @@
-import { R as RhinoComputeError, C as ComputeServerStats } from './errors-CEy4nM1J.js';
-import { R as RetryPolicy, f as GrasshopperComputeResponse, a as DataTree, e as GrasshopperComputeConfig, g as GrasshopperParsedIO, h as GrasshopperParsedIORaw, C as ComputeConfig, k as InputParamSchema, j as InputParam, b as DataTreeDefault, c as DataTreePath } from './types-Dfeei0dD.js';
-export { B as BooleanInputType, D as DataItem, d as DefaultValue, F as FileInputType, G as GeometryInputType, i as GrasshopperRequestSchema, I as InnerTreeData, N as NumericInputType, O as OutputParamSchema, l as OutputType, m as RhinoModelUnit, T as TextInputType, V as ValueListInputType } from './types-Dfeei0dD.js';
+import { R as RhinoComputeError, C as ComputeServerStats, F as FileBaseInfo } from './handle-files-DsrxHKHP.js';
+export { b as FileData, P as ProcessedFile, d as downloadFileData, e as extractFilesFromComputeResponse } from './handle-files-DsrxHKHP.js';
+import { R as RetryPolicy, C as ComputeConfig } from './types-D1SkNje_.js';
+export { a as RhinoModelUnit } from './types-D1SkNje_.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-XCUrJGby.js';
+export { B as BooleanInputType, D as DataItem, d as DefaultValue, F as FileInputType, G as GeometryInputType, i as GrasshopperRequestSchema, I as InnerTreeData, N as NumericInputType, O as OutputParamSchema, l as OutputType, T as TextInputType, V as ValueListInputType } from './types-XCUrJGby.js';
 import * as THREE from 'three';
-import { M as MeshExtractionOptions } from './types-COCuQEMk.js';
 
 /**
  * Scheduling mode — controls how concurrent `solve()` calls interact.
@@ -28,6 +30,18 @@ interface SolveSchedulerOptions {
     retry?: RetryPolicy;
     /** Enable response caching keyed by hash of (definition, dataTree). */
     cache?: boolean | CacheOptions;
+    /**
+     * Reuse the server's definition cache key so a large (base64/binary)
+     * definition is uploaded once and subsequent solves reference it by
+     * `pointer` instead of re-sending the full payload. Hugely cheaper for
+     * multi-MB definitions on a live UI (slider scrubs, etc.).
+     *
+     * Requires a `cacheKeyExecutor` to be supplied (the client wires one). Has no
+     * effect for URL-pointer definitions (already a reference). On a server-side
+     * cache miss the executor transparently falls back to a full upload, so this
+     * is safe to leave on. Default: `true` when a `cacheKeyExecutor` is present.
+     */
+    reuseServerDefinitionCache?: boolean;
     /** Lifecycle hooks — fired in order. Errors thrown by hooks are logged, not rethrown. */
     onStart?: (ctx: SolveContext) => void;
     onSettle?: (ctx: SolveContext, result: SolveResult) => void;
@@ -58,6 +72,22 @@ type SolveResult = {
  * without a real Compute server, and decouples it from the client class.
  */
 type SolveExecutor = (definition: string | Uint8Array, dataTree: DataTree[], config: GrasshopperComputeConfig) => Promise<GrasshopperComputeResponse>;
+/**
+ * Cache-key-aware executor. When `cacheKey` is provided, the executor solves by
+ * reference (`pointer: cacheKey`) and falls back to a full upload on a server
+ * cache miss. Always reports the (possibly refreshed) `cacheKey` so the
+ * scheduler can update its definition→key map, plus whether the fast path
+ * `missed` (for telemetry). When `cacheKey` is null it's a first solve — upload
+ * fully and capture the key the server assigns.
+ *
+ * Supplied by the client (which owns the solve primitives); the scheduler stays
+ * decoupled from the transport.
+ */
+type CacheKeyExecutor = (definition: string | Uint8Array, dataTree: DataTree[], cacheKey: string | null, config: GrasshopperComputeConfig) => Promise<{
+    response: GrasshopperComputeResponse;
+    cacheKey: string | null;
+    missed: boolean;
+}>;
 /**
  * Robust scheduler for Grasshopper solves.
  *
@@ -100,6 +130,11 @@ declare class SolveScheduler {
     private readonly cacheMax;
     private readonly cacheTtl;
     private readonly cache;
+    /** Optional cache-key-aware executor and whether server-def-cache reuse is on. */
+    private readonly cacheKeyExecutor?;
+    private readonly reuseServerDefinitionCache;
+    /** definition identity → server cache key (`pointer`) learned from past solves. */
+    private readonly serverCacheKeys;
     private readonly onStart?;
     private readonly onSettle?;
     private readonly onSuperseded?;
@@ -111,7 +146,7 @@ declare class SolveScheduler {
     private _lastError;
     private _lastDurationMs;
     private disposed;
-    constructor(executor: SolveExecutor, baseConfig: GrasshopperComputeConfig, options?: SolveSchedulerOptions);
+    constructor(executor: SolveExecutor, baseConfig: GrasshopperComputeConfig, options?: SolveSchedulerOptions, cacheKeyExecutor?: CacheKeyExecutor);
     get isSolving(): boolean;
     get hasPending(): boolean;
     get inFlightCount(): number;
@@ -137,9 +172,36 @@ declare class SolveScheduler {
     }): Promise<GrasshopperComputeResponse>;
     private enqueue;
     private execute;
+    /**
+     * Run the solve, using the server-definition-cache fast path when it's
+     * enabled and the definition is reusable. Learns/updates the definition's
+     * server cache key from the result so later solves can reference it.
+     */
+    private runExecutor;
     private drainNext;
     private supersede;
     private makeAbortError;
+    /**
+     * Settle a pending/in-flight item exactly once with an error.
+     *
+     * A solve promise can be settled from four concurrent sources — the executor
+     * resolving, the executor rejecting, `supersede`, and `cancelAll` — and a JS
+     * promise silently ignores a second settle. This guard is the single place the
+     * settle-once invariant lives: it makes the *first* settle win and reports
+     * whether this call was that winner, so callers fire their own hook only when
+     * they actually settled. Any new settle path must go through here (or
+     * {@link settleSuccess}) so the guard can't be forgotten.
+     *
+     * @returns `true` if this call settled the item; `false` if it was already settled.
+     */
+    private settleError;
+    /**
+     * Settle a pending/in-flight item exactly once with a successful response.
+     * The success counterpart to {@link settleError}; see it for the invariant.
+     *
+     * @returns `true` if this call settled the item; `false` if it was already settled.
+     */
+    private settleSuccess;
     private isAbortLikeError;
     private normalizeExecutionError;
     /** Cancel everything — in-flight and pending. */
@@ -250,64 +312,6 @@ declare class GrasshopperClient {
     private normalizeComputeConfig;
 }
 
-/**
- * Represents raw file data from Grasshopper/Rhino Compute response.
- *
- * This type encapsulates file output from compute operations, with metadata
- * for processing (decoding, naming, organization). Files are typically combined
- * with additional files and packaged into a ZIP archive for download.
- *
- * @see {@link ProcessedFile} for the normalized format after processing
- * @see {@link extractFilesFromComputeResponse} for extraction from compute responses
- */
-type FileData = {
-    /** Base filename without extension (e.g., "model") */
-    fileName: string;
-    /** File content as a base64-encoded or plain string, depending on {@link IsBase64Encoded} */
-    data: string;
-    /** File extension including the dot (e.g., ".3dm", ".json"). Appended to {@link FileName} to create the full filename */
-    fileType: string;
-    /** Whether {@link Data} is base64-encoded. If true, must be decoded to binary before use. If false, can be used as a plain text string */
-    isBase64Encoded: boolean;
-    /** Directory path for organizing the file in archive structures (e.g., ZIP). Typically empty string for root-level files, or a path like "subfolder/nested" */
-    subFolder: string;
-};
-/**
- * Represents a normalized, processed file ready for consumption or archival.
- *
- * This is the unified intermediate format produced by processing both {@link FileData}
- * and {@link FileBaseInfo}. Files in this format are ready to be packaged into archives
- * (e.g., ZIP files) or returned to callers for programmatic use.
- *
- * @see {@link FileData} for raw compute response files
- * @see {@link FileBaseInfo} for external file references
- */
-type ProcessedFile = {
-    /** Full filename including extension (e.g., "model.3dm") */
-    fileName: string;
-    /** File content as either binary data or text. Binary format (Uint8Array) is used for decoded base64 or fetched binary files; text format is used for plain text content */
-    content: Uint8Array | string;
-    /** File path for archive organization (e.g., "subfolder/model.3dm"). Used when creating ZIP archives or other hierarchical structures */
-    path: string;
-};
-/**
- * Represents a reference to an external file to be included in file operations.
- *
- * This type is used to specify additional files (beyond compute response files)
- * that should be fetched and included when processing files. The file is fetched
- * from the provided URL and processed as a {@link ProcessedFile}.
- *
- *
- * @see {@link FileData} for files from compute responses
- * @see {@link processFiles} for how FileBaseInfo is processed (fetched and converted)
- */
-type FileBaseInfo = {
-    /** Destination filename for the file in the archive or result set (e.g., "additional-data.json") */
-    fileName: string;
-    /** URL to fetch the file from. Must be accessible from the runtime environment */
-    filePath: string;
-};
-
 interface ParsedContext {
     [key: string]: any;
 }
@@ -423,7 +427,7 @@ declare class GrasshopperResponseProcessor {
      * });
      * ```
      */
-    extractMeshesFromResponse(options?: MeshExtractionOptions): Promise<THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material | THREE.Material[], THREE.Object3DEventMap>[]>;
+    extractMeshesFromResponse(options?: MeshExtractionOptions): Promise<THREE.Mesh<THREE.BufferGeometry<THREE.NormalBufferAttributes, THREE.BufferGeometryEventMap>, THREE.Material<THREE.MaterialEventMap> | THREE.Material<THREE.MaterialEventMap>[], THREE.Object3DEventMap>[]>;
     /**
      * Extract internal file data structures from the response.
      * This includes Grasshopper-generated textures, JSON exports,
@@ -459,7 +463,14 @@ declare class GrasshopperResponseProcessor {
 
 /**
  * Hash definition and data tree into a stable cache key.
- * For Uint8Array, uses length + samples to keep hashing fast.
+ *
+ * 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;
 
@@ -872,10 +883,6 @@ declare class TreeBuilder {
      * Check if a value is valid for inclusion in a DataTree.
      */
     private static hasValidValue;
-    /**
-     * Check if value is a TreeBuilder structure.
-     */
-    private static isDataTreeStructure;
     /**
      * Check if input is numeric type.
      */
@@ -890,35 +897,4 @@ declare class TreeBuilder {
     private static clampValue;
 }
 
-/**
- * Extracts and processes files from compute response data without downloading them.
- * Returns an array of ProcessedFile objects that can be used programmatically.
- *
- * @param downloadableFiles - An array of FileData items from the compute response.
- * @param additionalFiles - Optional additional files to include (fetched from URLs).
- * @returns A Promise resolving to an array of ProcessedFile objects.
- * @throws Will throw an error if file processing fails.
- *
- * @example
- * const files = await extractFilesFromComputeResponse(fileData);
- * files.forEach(file => {
- *   console.log(`File: ${file.fileName}, Size: ${file.content.length}`);
- * });
- */
-declare const extractFilesFromComputeResponse: (downloadableFiles: FileData[], additionalFiles?: FileBaseInfo[] | FileBaseInfo | null) => Promise<ProcessedFile[]>;
-/**
- * Downloads files from a compute response as a ZIP archive.
- * Packages multiple files into a single ZIP file and triggers a browser download.
- *
- * @param downloadableFiles - An array of FileData items from the compute response.
- * @param additionalFiles - Optional additional files to include in the ZIP (fetched from URLs).
- * @param fileFoldername - The name of the ZIP file (without extension).
- * @throws Will throw an error if the file handling or download fails.
- *
- * @example
- * await downloadDataFromComputeResponse(fileData, null, 'my-export');
- * // Downloads 'my-export.zip'
- */
-declare const downloadFileData: (downloadableFiles: FileData[], fileFoldername: string, additionalFiles?: FileBaseInfo[] | FileBaseInfo | null) => Promise<void>;
-
-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 };
+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 };

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-JZYEMZZ5.js";import"./chunk-OW6HV6QP.js";import{d as a}from"./chunk-XBIEAJBK.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 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-DELOBV2Q.js";import{d as a,q as b,r as c}from"./chunk-GTTKNF4G.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};
 //# sourceMappingURL=grasshopper.js.map