@selvajs/compute 3.0.1 → 3.1.0-beta.10

package/dist/{types-D-HQ-gWI.d.cts → types-Dtok-mVq.d.ts}

@@ -1,57 +1,44 @@
-import { C as ComputeConfig, a as RhinoModelUnit } from './types-ChF690kY.cjs';
+import { C as ComputeConfig, a as RhinoModelUnit } from './types-BGhtYxZ-.js';
 import { RhinoModule } from 'rhino3dm';
 
-/**
- * Grasshopper types
- */
-
-/**
- * Grasshopper-style data tree branch path
- * @example "{0}", "{0;0}", "{0;1;2}"
- */
 type DataTreePath = `{${string}}`;
-/**
- * Represents a data item in a data tree
- */
 interface DataItem {
-    /** The type of the data, inferred from the Grasshopper GOO class */
     type: string;
-    /** The actual returned data as a string that may need to be parsed */
     data: string;
-    /** The grasshopper refrence id of the output */
     id: string;
 }
-/**
- * Grasshopper-style data tree for input defaults
- * @example
- * ```typescript
- * const numericTree: DataTreeDefault<number> = {
- *   "{0}": [1, 2, 3],
- *   "{0;0}": [4, 5],
- *   "{1}": [6]
- * };
- * ```
- */
 type DataTreeDefault<T = any> = {
     [K in DataTreePath]?: T[];
 };
-/**
- * Data structure for InnerTreeData matching Rhino Compute responses
- */
 type InnerTreeData = {
     [path in DataTreePath]: DataItem[];
 };
 /**
- * Tree with parameter metadata (used in compute responses)
+ * Tree with parameter metadata (used in compute requests and responses).
+ *
+ * Field casing varies by server branch: stock mcneel compute (8.x/9.x)
+ * serializes `Resthopper.IO.DataTree` in PascalCase (`ParamName`/`InnerTree`
+ * — the C# class carries no `[JsonProperty]` attributes), while
+ * camelCase-serializing forks return `paramName`/`innerTree` instead. This
+ * client always *sends* PascalCase (see `DataTree.toCompute()` in
+ * `data-tree.ts`), so the PascalCase fields remain the canonical/required
+ * shape; the optional camelCase fields exist so responses from camelCase
+ * forks are representable without casts. Code that must read trees across
+ * both server families should use `readField`/`hasField`
+ * (`@/core/utils/read-field`, case-insensitive) rather than direct property
+ * access — `warnOnEmptyInnerTrees` in `solve.ts` is the reference example.
  */
 interface DataTree {
+    /** PascalCase — stock mcneel servers, and the request shape this client sends. */
     InnerTree: InnerTreeData;
+    /** PascalCase — stock mcneel servers, and the request shape this client sends. */
     ParamName: string;
+    /** camelCase — sent instead of `InnerTree` by camelCase server forks. */
+    innerTree?: InnerTreeData;
+    /** camelCase — sent instead of `ParamName` by camelCase server forks. */
+    paramName?: string;
 }
-/**
- * Output types supported from Grasshopper/Rhino Compute
- */
-type OutputType = 'System.String' | 'System.Double' | 'System.Int32' | 'System.Boolean' | 'Rhino.Geometry.Point3d' | 'Rhino.Geometry.Line' | 'Rhino.Geometry.Circle' | 'Rhino.Geometry.Arc' | 'Rhino.Geometry.NurbsCurve' | 'Rhino.Geometry.Brep' | 'Rhino.Geometry.Mesh' | 'Rhino.Geometry.Vector3d' | 'Rhino.Geometry.Plane' | 'Rhino.Geometry.Box' | string;
+type OutputType = 'System.String' | 'System.Double' | 'System.Int32' | 'System.Boolean' | 'Rhino.Geometry.Point3d' | 'Rhino.Geometry.Line' | 'Rhino.Geometry.Circle' | 'Rhino.Geometry.Arc' | 'Rhino.Geometry.NurbsCurve' | 'Rhino.Geometry.Brep' | 'Rhino.Geometry.Mesh' | 'Rhino.Geometry.Vector3d' | 'Rhino.Geometry.Plane' | 'Rhino.Geometry.Box' | (string & {});
 /**
  * Union type for all possible default value types
  */
@@ -207,18 +194,34 @@ interface GrasshopperRequestSchema extends GrasshopperBaseSchema, GrasshopperDef
 /**
  * Response from Grasshopper compute server
  * Includes all schema fields + computed results
+ *
+ * `pointer` is deliberately excluded (`Omit`): the solve layer (`runSolve` in
+ * `solve.ts`) splits the server's echoed `pointer` off as the solve's
+ * `cacheKey` and strips it from the returned response, so client-returned
+ * responses never carry it.
+ *
+ * The schema-echo fields (`cachesolve`/`modelunits`/`dataversion`) stay
+ * optional as inherited from {@link GrasshopperBaseSchema}: the server echoes
+ * them back when set, but nothing client-side enforces their presence — don't
+ * rely on them without a fallback.
  */
-interface GrasshopperComputeResponse extends GrasshopperBaseSchema, GrasshopperDefinitionSource {
-    /** Whether cache was used (always present in response) */
-    cachesolve: boolean;
-    /** Model units (always present in response) */
+interface GrasshopperComputeResponse extends GrasshopperBaseSchema, Omit<GrasshopperDefinitionSource, 'pointer'> {
+    /**
+     * Model units the definition was solved in. Every conforming server response
+     * carries this (it drives downstream scaling, e.g. the webdisplay parser),
+     * but note it is not validated client-side — a non-conforming server or
+     * hand-built mock may omit it at runtime.
+     */
     modelunits: RhinoModelUnit;
-    /** Base64 encoded algorithm (always present in response) */
-    algo: string;
+    /**
+     * The server echoes the request's full base64 definition back as `algo`, but the client strips
+     * it before returning — retaining it would pin a multi-MB copy of the definition per response,
+     * multiplied by every cache that holds responses. Always `undefined` on client-returned
+     * responses (inherited optional field from {@link GrasshopperDefinitionSource}).
+     */
+    algo?: string | null;
     /** Filename of the definition (always present in response) */
     filename: string | null;
-    /** Data version */
-    dataversion: 7 | 8;
     /** Recursion level used */
     recursionlevel?: number;
     /** Output values organized by parameter */
@@ -327,14 +330,9 @@ interface GrasshopperParsedIO {
 }
 
 /**
- * Non-mesh display items: curves, points, and later labels/icons.
- *
- * These ride as JSON inside a {@link DisplayBatch} alongside the binary mesh blob — they are a
- * separate pipeline from the SLVA mesh path in `../webdisplay`. Curves arrive as Rhino-native JSON
- * (decoded via rhino3dm and tessellated on the web); points arrive as raw `{X,Y,Z}` positions.
- *
- * The union is STRICT and discriminated on `kind`. The parser narrows on it and uses a
- * `never`-exhaustiveness check, so adding a new kind is a compile error until it is handled.
+ * Non-mesh display items: curves and points. Ride as JSON inside {@link DisplayBatch} alongside
+ * the binary mesh blob. The union is STRICT and discriminated on `kind`; the parser uses a
+ * `never`-exhaustiveness check, so adding a new kind is a compile error until handled.
  */
 /**
  * Identity + tagging shared by every display thing — meshes (via an adapter over `MeshMetadata`)
@@ -362,7 +360,10 @@ interface DisplayItemBase extends DisplayIdentity {
     /** Opacity 0–1. Omitted means fully opaque. */
     opacity?: number;
 }
-/** A world position in Rhino's Z-up frame, in Rhino's `{X,Y,Z}` casing. Rotated to Three on parse. */
+/**
+ * A world position in Rhino's Z-up frame, in Rhino's `{X,Y,Z}` casing. Used unchanged on parse —
+ * the Three scene IS Rhino's Z-up frame, so no rotation is applied (see `../coordinate-transform.ts`).
+ */
 interface DisplayPosition {
     X: number;
     Y: number;
@@ -385,7 +386,7 @@ interface DisplayCurve extends DisplayItemBase {
 /** A single point, shipped raw (no rhino3dm decode), rendered as one vertex of a `THREE.Points`. */
 interface DisplayPoint extends DisplayItemBase {
     kind: 'point';
-    /** World position in Rhino Z-up; the shared Rhino→Three transform is applied on parse. */
+    /** World position in Rhino Z-up, used directly — the Three scene shares Rhino's Z-up frame. */
     position: DisplayPosition;
 }
 /**
@@ -404,16 +405,29 @@ interface SerializableMaterial {
     roughness: number;
     opacity: number;
     transparent: boolean;
+    /**
+     * Optional color-map texture reference: an http(s) URL, a data URI, or a plugin asset URL
+     * (`http://localhost:{port}/assets/{hash}`). Absent for untextured materials — the field is
+     * omitted from JSON entirely, so pre-texture payloads are unchanged. When set, the mesh blob
+     * also carries per-vertex UVs (FLAG_HAS_UVS) for meshes using this material.
+     */
+    map?: string;
 }
 /**
  * Metadata for a single mesh within a batch.
  *
  * Offsets and counts are expressed in **vertex-count units** (not float components) and
- * **index-count units**. To address the typed-array storage:
- *   - vertex component offset = `vertexStart * 3`
- *   - vertex component count  = `vertexCount * 3`
- *   - index byte offset       = `indexStart * 4`
- *   - index count             = `indexCount`
+ * **index-count units** — i.e. element offsets into the decoded typed arrays, which is how
+ * consumers address them (`indices.subarray(indexStart, indexStart + indexCount)`). To address
+ * the typed-array storage:
+ *   - vertex component offset  = `vertexStart * 3`
+ *   - vertex component count   = `vertexCount * 3`
+ *   - index element offset     = `indexStart`
+ *   - index count              = `indexCount`
+ *
+ * If you need *byte* offsets, multiply by the element size, which depends on the blob's flags:
+ * indices are 2 bytes each for `FLAG_UINT16_INDICES` (wire v2+) blobs and 4 bytes for uint32
+ * blobs; vertex components are 2 bytes (int16 quantized) or 4 bytes (`FLAG_FLOAT32`).
  */
 interface MeshMetadata {
     name: string;
@@ -456,11 +470,8 @@ interface MaterialGroup {
  * later labels/icons) also travel — those ride as JSON alongside the mesh blob, not inside it.
  */
 interface DisplayBatch {
-    /** Array of unique materials */
     materials: SerializableMaterial[];
-    /** Groups of meshes organized by material */
     groups: MaterialGroup[];
-    /** Base64-encoded binary blob (SLVA wire format). */
     compressedData: string;
     /** InstanceGuid of the WebDisplay GH component that produced this batch.
      *  Combined with MeshMetadata.originalIndex to backtrack any mesh to its GH source. */
@@ -478,16 +489,37 @@ interface DisplayBatch {
  * This alias keeps existing imports compiling; remove it once consumers migrate.
  */
 type MeshBatch = DisplayBatch;
-/**
- * Options for parsing mesh batch data.
- */
 interface MeshBatchParsingOptions {
-    /** Merge meshes with same material into single geometry (better performance). Defaults to true. */
+    /** Merge meshes with same material into single geometry. Defaults to true. */
     mergeByMaterial?: boolean;
-    /** Apply coordinate system transformations (Rhino Z-up to Three.js Y-up). Defaults to true. */
+    /** Apply coordinate system transformations. Defaults to true. */
     applyTransforms?: boolean;
-    /** Enable performance monitoring in console. Defaults to false. */
+    /** Enable performance monitoring. Defaults to false. */
     debug?: boolean;
+    /**
+     * Appearance dials applied to every material built from this batch. These drive how "studio"
+     * vs "matte technical" the meshes look; they are set once at parse time (materials are rebuilt
+     * per solve). Runtime restyling of an already-built scene lives in the viewer's `setLook`.
+     */
+    material?: MaterialAppearanceOptions;
+}
+/**
+ * How compute meshes read visually. Bundled so a caller can pick a coherent look ('technical' vs
+ * 'rendered') by setting all three together rather than dialing each in isolation.
+ */
+interface MaterialAppearanceOptions {
+    /**
+     * Multiplier on the HDR image-based-lighting reflection strength. ~0.5 reads matte/technical,
+     * ~1.3 reads glossy/presentation. Default 1 (three.js's own default — unchanged look).
+     */
+    envMapIntensity?: number;
+    /**
+     * Cull back faces (`THREE.FrontSide`) instead of rendering both sides (`THREE.DoubleSide`).
+     * FrontSide gives cleaner interior shading, a crisper silhouette, and less overdraw on closed
+     * solids — but open surfaces (which Rhino also emits) then vanish when viewed from behind.
+     * Default false (keep DoubleSide) to stay safe for surface geometry.
+     */
+    cullBackfaces?: boolean;
 }
 /**
  * Options for extracting and processing meshes from compute responses.
@@ -508,4 +540,4 @@ interface MeshExtractionOptions {
     debug?: boolean;
 }
 
-export type { BooleanInputType as B, DataItem as D, FileInputType as F, GeometryInputType as G, InnerTreeData as I, MeshExtractionOptions as M, NumericInputType as N, OutputParamSchema as O, TextInputType as T, ValueListInputType as V, DataTree as a, DataTreeDefault as b, DataTreePath as c, DefaultValue as d, GrasshopperComputeConfig as e, GrasshopperComputeResponse as f, GrasshopperParsedIO as g, GrasshopperParsedIORaw as h, GrasshopperRequestSchema as i, InputParam as j, InputParamSchema as k, OutputType as l, MeshBatchParsingOptions as m, DisplayBatch as n, DisplayItem as o, DisplayCurve as p, DisplayIdentity as q, DisplayItemBase as r, DisplayPoint as s, DisplayPosition as t, MeshBatch as u };
+export type { BooleanInputType as B, DataItem as D, FileInputType as F, GeometryInputType as G, InnerTreeData as I, MaterialAppearanceOptions as M, NumericInputType as N, OutputParamSchema as O, TextInputType as T, ValueListInputType as V, DataTree as a, DataTreeDefault as b, DataTreePath as c, DefaultValue as d, GrasshopperComputeConfig as e, GrasshopperComputeResponse as f, GrasshopperParsedIO as g, GrasshopperParsedIORaw as h, GrasshopperRequestSchema as i, InputParam as j, InputParamSchema as k, OutputType as l, MeshExtractionOptions as m, MeshBatchParsingOptions as n, DisplayBatch as o, DisplayItem as p, DisplayCurve as q, DisplayIdentity as r, DisplayItemBase as s, DisplayPoint as t, DisplayPosition as u, MeshBatch as v };

package/dist/visualization-4RSUYQG2.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk7XMD5YXPcjs = require('./chunk-7XMD5YXP.cjs');require('./chunk-CUQQ3ZBV.cjs');exports.BINARY_MESH_MAGIC = _chunk7XMD5YXPcjs.x; exports.BINARY_MESH_VERSION = _chunk7XMD5YXPcjs.z; exports.COMPRESSED_MESH_MAGIC = _chunk7XMD5YXPcjs.y; exports.EDGE_USERDATA_KIND = _chunk7XMD5YXPcjs.i; exports.FLAG_DELTA_ENCODED = _chunk7XMD5YXPcjs.D; exports.FLAG_FLOAT32 = _chunk7XMD5YXPcjs.B; exports.FLAG_HAS_UVS = _chunk7XMD5YXPcjs.E; exports.FLAG_HAS_VERTEX_COLORS = _chunk7XMD5YXPcjs.F; exports.FLAG_UINT16_INDICES = _chunk7XMD5YXPcjs.C; exports.LOOKS = _chunk7XMD5YXPcjs.v; exports.MIN_SUPPORTED_VERSION = _chunk7XMD5YXPcjs.A; exports.Materials = _chunk7XMD5YXPcjs.a; exports.SCALE_FACTORS = _chunk7XMD5YXPcjs.M; exports.TEXTURE_CACHE_MAX_ENTRIES = _chunk7XMD5YXPcjs.q; exports.UV_FORMAT_FLOAT32 = _chunk7XMD5YXPcjs.H; exports.UV_FORMAT_UINT16 = _chunk7XMD5YXPcjs.G; exports.addEdges = _chunk7XMD5YXPcjs.j; exports.applyOffset = _chunk7XMD5YXPcjs.d; exports.clearTextureCache = _chunk7XMD5YXPcjs.s; exports.computeCombinedBoundingBox = _chunk7XMD5YXPcjs.e; exports.createCameraController = _chunk7XMD5YXPcjs.f; exports.createGrid = _chunk7XMD5YXPcjs.g; exports.createLabelLayer = _chunk7XMD5YXPcjs.n; exports.createMeasureTool = _chunk7XMD5YXPcjs.p; exports.createRenderPipeline = _chunk7XMD5YXPcjs.m; exports.createViewGizmo = _chunk7XMD5YXPcjs.h; exports.getThreeMeshesFromComputeResponse = _chunk7XMD5YXPcjs.N; exports.initThree = _chunk7XMD5YXPcjs.u; exports.isEdgeOverlay = _chunk7XMD5YXPcjs.k; exports.materialAppearanceForLook = _chunk7XMD5YXPcjs.t; exports.parseBinaryMeshBatch = _chunk7XMD5YXPcjs.I; exports.parseColor = _chunk7XMD5YXPcjs.c; exports.parseDisplayItems = _chunk7XMD5YXPcjs.w; exports.parseMeshBatch = _chunk7XMD5YXPcjs.J; exports.parseMeshBatchBlob = _chunk7XMD5YXPcjs.L; exports.parseMeshBatchObject = _chunk7XMD5YXPcjs.K; exports.removeEdges = _chunk7XMD5YXPcjs.l; exports.setTextureAnisotropy = _chunk7XMD5YXPcjs.r; exports.snapToVertex = _chunk7XMD5YXPcjs.o; exports.updateScene = _chunk7XMD5YXPcjs.b;
+//# sourceMappingURL=visualization-4RSUYQG2.cjs.map

package/dist/visualization-4RSUYQG2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["d:\\Coding\\selva-compute\\dist\\visualization-4RSUYQG2.cjs"],"names":[],"mappings":"AAAA,iIAAoT,gCAA6B,k5DAA24B","file":"D:\\Coding\\selva-compute\\dist\\visualization-4RSUYQG2.cjs"}

package/dist/visualization-MOYO6MDN.js

@@ -0,0 +1,2 @@
+import{A as L,B as S,C as I,D as R,E as D,F as B,G,H as P,I as u,J as F,K as b,L as N,M as V,N as U,a as e,b as r,c as o,d as t,e as a,f as s,g as p,h as i,i as n,j as m,k as l,l as f,m as y,n as x,o as C,p as d,q as h,r as E,s as M,t as _,u as O,v as c,w as A,x as g,y as T,z as j}from"./chunk-PX2YTSHJ.js";import"./chunk-WPB2LKCD.js";export{g as BINARY_MESH_MAGIC,j as BINARY_MESH_VERSION,T as COMPRESSED_MESH_MAGIC,n as EDGE_USERDATA_KIND,R as FLAG_DELTA_ENCODED,S as FLAG_FLOAT32,D as FLAG_HAS_UVS,B as FLAG_HAS_VERTEX_COLORS,I as FLAG_UINT16_INDICES,c as LOOKS,L as MIN_SUPPORTED_VERSION,e as Materials,V as SCALE_FACTORS,h as TEXTURE_CACHE_MAX_ENTRIES,P as UV_FORMAT_FLOAT32,G as UV_FORMAT_UINT16,m as addEdges,t as applyOffset,M as clearTextureCache,a as computeCombinedBoundingBox,s as createCameraController,p as createGrid,x as createLabelLayer,d as createMeasureTool,y as createRenderPipeline,i as createViewGizmo,U as getThreeMeshesFromComputeResponse,O as initThree,l as isEdgeOverlay,_ as materialAppearanceForLook,u as parseBinaryMeshBatch,o as parseColor,A as parseDisplayItems,F as parseMeshBatch,N as parseMeshBatchBlob,b as parseMeshBatchObject,f as removeEdges,E as setTextureAnisotropy,C as snapToVertex,r as updateScene};
+//# sourceMappingURL=visualization-MOYO6MDN.js.map

package/dist/visualization.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkJF5MZTOUcjs = require('./chunk-JF5MZTOU.cjs');require('./chunk-6LCAIDQV.cjs');exports.EDGE_USERDATA_KIND = _chunkJF5MZTOUcjs.h; exports.Materials = _chunkJF5MZTOUcjs.q; exports.SCALE_FACTORS = _chunkJF5MZTOUcjs.z; exports.addEdges = _chunkJF5MZTOUcjs.i; exports.applyOffset = _chunkJF5MZTOUcjs.c; exports.computeCombinedBoundingBox = _chunkJF5MZTOUcjs.d; exports.createCameraController = _chunkJF5MZTOUcjs.e; exports.createGrid = _chunkJF5MZTOUcjs.f; exports.createLabelLayer = _chunkJF5MZTOUcjs.m; exports.createMeasureTool = _chunkJF5MZTOUcjs.o; exports.createRenderPipeline = _chunkJF5MZTOUcjs.l; exports.createViewGizmo = _chunkJF5MZTOUcjs.g; exports.getThreeMeshesFromComputeResponse = _chunkJF5MZTOUcjs.A; exports.initThree = _chunkJF5MZTOUcjs.p; exports.isEdgeOverlay = _chunkJF5MZTOUcjs.j; exports.parseColor = _chunkJF5MZTOUcjs.b; exports.parseDisplayItems = _chunkJF5MZTOUcjs.r; exports.parseMeshBatchBlob = _chunkJF5MZTOUcjs.y; exports.parseMeshBatchObject = _chunkJF5MZTOUcjs.x; exports.removeEdges = _chunkJF5MZTOUcjs.k; exports.snapToVertex = _chunkJF5MZTOUcjs.n; exports.updateScene = _chunkJF5MZTOUcjs.a;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk7XMD5YXPcjs = require('./chunk-7XMD5YXP.cjs');require('./chunk-CUQQ3ZBV.cjs');exports.EDGE_USERDATA_KIND = _chunk7XMD5YXPcjs.i; exports.LOOKS = _chunk7XMD5YXPcjs.v; exports.Materials = _chunk7XMD5YXPcjs.a; exports.SCALE_FACTORS = _chunk7XMD5YXPcjs.M; exports.addEdges = _chunk7XMD5YXPcjs.j; exports.applyOffset = _chunk7XMD5YXPcjs.d; exports.computeCombinedBoundingBox = _chunk7XMD5YXPcjs.e; exports.createCameraController = _chunk7XMD5YXPcjs.f; exports.createGrid = _chunk7XMD5YXPcjs.g; exports.createLabelLayer = _chunk7XMD5YXPcjs.n; exports.createMeasureTool = _chunk7XMD5YXPcjs.p; exports.createRenderPipeline = _chunk7XMD5YXPcjs.m; exports.createViewGizmo = _chunk7XMD5YXPcjs.h; exports.getThreeMeshesFromComputeResponse = _chunk7XMD5YXPcjs.N; exports.initThree = _chunk7XMD5YXPcjs.u; exports.isEdgeOverlay = _chunk7XMD5YXPcjs.k; exports.parseColor = _chunk7XMD5YXPcjs.c; exports.parseDisplayItems = _chunk7XMD5YXPcjs.w; exports.parseMeshBatchBlob = _chunk7XMD5YXPcjs.L; exports.parseMeshBatchObject = _chunk7XMD5YXPcjs.K; exports.removeEdges = _chunk7XMD5YXPcjs.l; exports.snapToVertex = _chunk7XMD5YXPcjs.o; exports.updateScene = _chunk7XMD5YXPcjs.b;
 //# sourceMappingURL=visualization.cjs.map

package/dist/visualization.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/selva-compute/selva-compute/dist/visualization.cjs"],"names":[],"mappings":"AAAA,iIAA2L,gCAA6B,khCAA+d","file":"/home/runner/work/selva-compute/selva-compute/dist/visualization.cjs"}
+{"version":3,"sources":["d:\\Coding\\selva-compute\\dist\\visualization.cjs"],"names":[],"mappings":"AAAA,iIAAkM,gCAA6B,ujCAA0e","file":"D:\\Coding\\selva-compute\\dist\\visualization.cjs"}