@selvajs/visualization 1.0.0-beta.1 → 1.0.0-beta.3

package/dist/parse.d.cts

@@ -1,12 +1,13 @@
-import * as THREE from 'three';
-import { M as MaterialAppearanceOptions } from './types-DCuos3gI.cjs';
-
+import { i as MaterialAppearanceOptions } from "./types-Di80Y609.cjs";
+import * as THREE from "three";
+//#region src/parse/mesh-policy.d.ts
 /** Structurally, not nominally, typed as `@selvajs/solve/client`'s `MeshPolicy<THREE.Object3D>` — avoids a dependency on solve. */
 declare const meshPolicy: {
-    clone(meshes: THREE.Object3D[]): THREE.Object3D[];
-    release(meshes: THREE.Object3D[]): void;
+  clone(meshes: THREE.Object3D[]): THREE.Object3D[];
+  release(meshes: THREE.Object3D[]): void;
 };
-
+//#endregion
+//#region src/parse/webdisplay/response-envelope.d.ts
 /**
  * Declared structurally rather than imported from `@selvajs/compute` — this package converts
  * meshes, it doesn't need a Rhino.Compute client dependency to describe the shape a caller hands
@@ -14,73 +15,75 @@ declare const meshPolicy: {
  * this, so {@link getThreeMeshesFromComputeResponse} keeps accepting one unchanged.
  */
 interface DisplayDataItem {
-    /** Namespaced wire type token, e.g. `Selva.GH.Features.Display.Services.DisplayBatch`. */
-    type: string;
-    data: string;
+  /** Namespaced wire type token, e.g. `Selva.GH.Features.Display.Services.DisplayBatch`. */
+  type: string;
+  data: string;
 }
 interface DisplayResponseValue {
-    InnerTree: {
-        [branchPath: string]: DisplayDataItem[];
-    };
+  InnerTree: {
+    [branchPath: string]: DisplayDataItem[];
+  };
 }
 interface DisplayComputeResponse {
-    values: DisplayResponseValue[];
-    /** Rhino `UnitSystem` name driving unit scaling (see `SCALE_FACTORS`); unrecognized/absent scales 1. */
-    modelunits: string;
+  values: DisplayResponseValue[];
+  /** Rhino `UnitSystem` name driving unit scaling (see `SCALE_FACTORS`); unrecognized/absent scales 1. */
+  modelunits: string;
 }
-
+//#endregion
+//#region src/parse/display-items/types.d.ts
 interface DisplayIdentity {
-    /** Stable pick key: `${sourceComponentId}:${originalIndex}`. Distinct from `name` so renaming doesn't change identity. */
-    id: string;
-    name: string;
-    layer: string;
-    /** Arbitrary key-value pairs from the GH Metadata input. */
-    metadata?: Record<string, string>;
+  /** Stable pick key: `${sourceComponentId}:${originalIndex}`. Distinct from `name` so renaming doesn't change identity. */
+  id: string;
+  name: string;
+  layer: string;
+  /** Arbitrary key-value pairs from the GH Metadata input. */
+  metadata?: Record<string, string>;
 }
 interface DisplayItemBase extends DisplayIdentity {
-    /** Hex/rgb/named color string, parsed by `parseColor`. Falls back to a viewer default. */
-    color?: string;
-    /** 0-1; omitted means fully opaque. */
-    opacity?: number;
+  /** Hex/rgb/named color string, parsed by `parseColor`. Falls back to a viewer default. */
+  color?: string;
+  /** 0-1; omitted means fully opaque. */
+  opacity?: number;
 }
 /** Rhino's Z-up frame and `{X,Y,Z}` casing. */
 interface DisplayPosition {
-    X: number;
-    Y: number;
-    Z: number;
+  X: number;
+  Y: number;
+  Z: number;
 }
 /** Rendered as a fat `Line2` straight from `points` — nothing decodes geometry in the browser. */
 interface DisplayCurve extends DisplayItemBase {
-    kind: 'curve';
-    /**
-     * Backend-tessellated polyline, flat `[x,y,z, …]` in Rhino's Z-up frame.
-     *
-     * Typed as required even though the plugin still sends a legacy `json` field alongside it: a
-     * payload without `points` came from a Display component too old to render, and parsing throws
-     * rather than treating it as a shape this package supports.
-     */
-    points: number[];
-    /** Screen-space CSS px, constant regardless of zoom. Omitted uses the viewer default. */
-    width?: number;
+  kind: 'curve';
+  /**
+   * Backend-tessellated polyline, flat `[x,y,z, …]` in Rhino's Z-up frame.
+   *
+   * Typed as required even though the plugin still sends a legacy `json` field alongside it: a
+   * payload without `points` came from a Display component too old to render, and parsing throws
+   * rather than treating it as a shape this package supports.
+   */
+  points: number[];
+  /** Screen-space CSS px, constant regardless of zoom. Omitted uses the viewer default. */
+  width?: number;
 }
 interface DisplayPoint extends DisplayItemBase {
-    kind: 'point';
-    position: DisplayPosition;
+  kind: 'point';
+  position: DisplayPosition;
 }
 type DisplayItem = DisplayCurve | DisplayPoint;
-
+//#endregion
+//#region src/parse/webdisplay/types.d.ts
 interface SerializableMaterial {
-    color: string;
-    metalness: number;
-    roughness: number;
-    opacity: number;
-    transparent: boolean;
-    /**
-     * Optional color-map texture reference: http(s) URL, data URI, or plugin asset URL
-     * (`http://localhost:{port}/assets/{hash}`). Omitted entirely (not just empty) when untextured.
-     * When set, the mesh blob also carries per-vertex UVs (FLAG_HAS_UVS) for meshes using it.
-     */
-    map?: string;
+  color: string;
+  metalness: number;
+  roughness: number;
+  opacity: number;
+  transparent: boolean;
+  /**
+   * Optional color-map texture reference: http(s) URL, data URI, or plugin asset URL
+   * (`http://localhost:{port}/assets/{hash}`). Omitted entirely (not just empty) when untextured.
+   * When set, the mesh blob also carries per-vertex UVs (FLAG_HAS_UVS) for meshes using it.
+   */
+  map?: string;
 }
 /**
  * `vertexStart`/`vertexCount` and `indexStart`/`indexCount` are in **element units** of the
@@ -90,23 +93,23 @@ interface SerializableMaterial {
  * vertex components are 2 bytes (int16 quantized) or 4 bytes (`FLAG_FLOAT32`).
  */
 interface MeshMetadata {
-    name: string;
-    /** Layer path for grouping in the scene manager, e.g. 'Structure/Walls'. */
-    layer: string;
-    /** Index in the GH input tree before material grouping; combined with sourceComponentId
-     *  uniquely identifies the GH source geometry. */
-    originalIndex: number;
-    vertexCount: number;
-    /** 3 per triangle. */
-    indexCount: number;
-    vertexStart: number;
-    indexStart: number;
-    /** Arbitrary key-value pairs from the GH Metadata input. */
-    metadata?: Record<string, string>;
+  name: string;
+  /** Layer path for grouping in the scene manager, e.g. 'Structure/Walls'. */
+  layer: string;
+  /** Index in the GH input tree before material grouping; combined with sourceComponentId
+   *  uniquely identifies the GH source geometry. */
+  originalIndex: number;
+  vertexCount: number;
+  /** 3 per triangle. */
+  indexCount: number;
+  vertexStart: number;
+  indexStart: number;
+  /** Arbitrary key-value pairs from the GH Metadata input. */
+  metadata?: Record<string, string>;
 }
 interface MaterialGroup {
-    materialId: number;
-    meshes: MeshMetadata[];
+  materialId: number;
+  meshes: MeshMetadata[];
 }
 /**
  * One Display component's payload, ready for Three.js rendering.
@@ -120,45 +123,45 @@ interface MaterialGroup {
  * blob (`items`), not inside it.
  */
 interface DisplayBatch {
-    materials: SerializableMaterial[];
-    groups: MaterialGroup[];
-    compressedData: string;
-    /** InstanceGuid of the WebDisplay GH component that produced this batch; combined with
-     *  MeshMetadata.originalIndex to backtrack any mesh to its GH source. */
-    sourceComponentId?: string;
-    /** Non-mesh display items — see {@link DisplayItem}. Parsed by the separate `display-items`
-     *  path, not the SLVA mesh parser. Omitted when there are none. */
-    items?: DisplayItem[];
+  materials: SerializableMaterial[];
+  groups: MaterialGroup[];
+  compressedData: string;
+  /** InstanceGuid of the WebDisplay GH component that produced this batch; combined with
+   *  MeshMetadata.originalIndex to backtrack any mesh to its GH source. */
+  sourceComponentId?: string;
+  /** Non-mesh display items — see {@link DisplayItem}. Parsed by the separate `display-items`
+   *  path, not the SLVA mesh parser. Omitted when there are none. */
+  items?: DisplayItem[];
 }
 interface MeshBatchParsingOptions {
-    /** Merge meshes sharing a material into a single geometry. Defaults to true. */
-    mergeByMaterial?: boolean;
-    debug?: boolean;
-    /**
-     * Appearance dials applied to every material built from this batch — 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;
+  /** Merge meshes sharing a material into a single geometry. Defaults to true. */
+  mergeByMaterial?: boolean;
+  debug?: boolean;
+  /**
+   * Appearance dials applied to every material built from this batch — 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;
 }
-
 interface MeshExtractionOptions {
-    parsing?: MeshBatchParsingOptions;
-    /** Scale geometry to model units. Defaults to true. */
-    allowScaling?: boolean;
-    /**
-     * Drop geometry so its lowest point sits on the ground plane. **Defaults to `false`** — content
-     * renders at its true Rhino coordinates, matching the Grasshopper definition. Setting `true`
-     * shifts objects, so anything read back out of the scene (bounds, measured/picked positions) no
-     * longer corresponds to Rhino coordinates.
-     */
-    allowAutoPosition?: boolean;
-    /** Up axis for `allowAutoPosition` grounding. Defaults to `'z'` (Rhino's frame) — only set this
-     *  if the viewer is configured with a non-default `sceneUp`. */
-    groundAxis?: 'x' | 'y' | 'z';
-    debug?: boolean;
+  parsing?: MeshBatchParsingOptions;
+  /** Scale geometry to model units. Defaults to true. */
+  allowScaling?: boolean;
+  /**
+   * Drop geometry so its lowest point sits on the ground plane. **Defaults to `false`** — content
+   * renders at its true Rhino coordinates, matching the Grasshopper definition. Setting `true`
+   * shifts objects, so anything read back out of the scene (bounds, measured/picked positions) no
+   * longer corresponds to Rhino coordinates.
+   */
+  allowAutoPosition?: boolean;
+  /** Up axis for `allowAutoPosition` grounding. Defaults to `'z'` (Rhino's frame) — only set this
+   *  if the viewer is configured with a non-default `sceneUp`. */
+  groundAxis?: 'x' | 'y' | 'z';
+  debug?: boolean;
 }
-
+//#endregion
+//#region src/parse/webdisplay/webdisplay-parser.d.ts
 /**
  * Metres per model unit, keyed by Rhino `UnitSystem` name (the `modelunits` string on the compute
  * response). Imperial factors are the exact international definitions. Units missing from this
@@ -175,10 +178,11 @@ declare const SCALE_FACTORS: Record<string, number>;
  * @throws Rethrows unexpected errors after attempting to dispose any created meshes.
  */
 declare function getThreeMeshesFromComputeResponse(data: DisplayComputeResponse, options?: MeshExtractionOptions): Promise<THREE.Object3D[]>;
-
+//#endregion
+//#region src/parse/webdisplay/batch-parser.d.ts
 interface ParseTelemetry {
-    parseTime?: number;
-    perfStart?: number;
+  parseTime?: number;
+  perfStart?: number;
 }
 /**
  * Parses a DisplayBatch object and creates Three.js meshes from its mesh blob.
@@ -188,7 +192,7 @@ interface ParseTelemetry {
  *
  * @throws {VisualizationError} On a corrupt/truncated/unsupported mesh blob or malformed group metadata.
  */
-declare function parseMeshBatchObject(batch: DisplayBatch, options?: MeshBatchParsingOptions, 
+declare function parseMeshBatchObject(batch: DisplayBatch, options?: MeshBatchParsingOptions,
 /** @internal Timings threaded from an outer entry point — not a caller option. */
 telemetry?: ParseTelemetry): Promise<THREE.Mesh[]>;
 /**
@@ -201,14 +205,16 @@ telemetry?: ParseTelemetry): Promise<THREE.Mesh[]>;
  * @throws {VisualizationError} On a corrupt/truncated/unsupported mesh blob or malformed group metadata.
  */
 declare function parseMeshBatchBlob(blob: ArrayBuffer | Uint8Array, options?: MeshBatchParsingOptions): Promise<THREE.Mesh[]>;
-
+//#endregion
+//#region src/parse/webdisplay/apply-texture.d.ts
 /**
  * Subscribed to the renderer's own report below, so no host wiring is needed; still exported for a
  * host embedding a foreign renderer that wants to set it directly. Applies to textures loaded from
  * here on — textures already decoded keep the value they were given.
  */
 declare function setTextureAnisotropy(value: number): void;
-
+//#endregion
+//#region src/parse/display-items/display-items-parser.d.ts
 /**
  * Builds THREE objects for the batch's non-mesh items.
  *
@@ -217,5 +223,6 @@ declare function setTextureAnisotropy(value: number): void;
  * unrenderable item is logged and skipped.
  */
 declare function parseDisplayItems(items: DisplayItem[] | undefined): THREE.Object3D[];
-
+//#endregion
 export { type DisplayBatch, type DisplayComputeResponse, type DisplayCurve, type DisplayDataItem, type DisplayIdentity, type DisplayItem, type DisplayItemBase, type DisplayPoint, type DisplayPosition, type DisplayResponseValue, type MaterialGroup, type MeshBatchParsingOptions, type MeshExtractionOptions, type MeshMetadata, SCALE_FACTORS, type SerializableMaterial, getThreeMeshesFromComputeResponse, meshPolicy, parseDisplayItems, parseMeshBatchBlob, parseMeshBatchObject, setTextureAnisotropy };
+//# sourceMappingURL=parse.d.cts.map

package/dist/parse.d.ts

@@ -1,12 +1,13 @@
-import * as THREE from 'three';
-import { M as MaterialAppearanceOptions } from './types-DCuos3gI.js';
-
+import { i as MaterialAppearanceOptions } from "./types-Di80Y609.js";
+import * as THREE from "three";
+//#region src/parse/mesh-policy.d.ts
 /** Structurally, not nominally, typed as `@selvajs/solve/client`'s `MeshPolicy<THREE.Object3D>` — avoids a dependency on solve. */
 declare const meshPolicy: {
-    clone(meshes: THREE.Object3D[]): THREE.Object3D[];
-    release(meshes: THREE.Object3D[]): void;
+  clone(meshes: THREE.Object3D[]): THREE.Object3D[];
+  release(meshes: THREE.Object3D[]): void;
 };
-
+//#endregion
+//#region src/parse/webdisplay/response-envelope.d.ts
 /**
  * Declared structurally rather than imported from `@selvajs/compute` — this package converts
  * meshes, it doesn't need a Rhino.Compute client dependency to describe the shape a caller hands
@@ -14,73 +15,75 @@ declare const meshPolicy: {
  * this, so {@link getThreeMeshesFromComputeResponse} keeps accepting one unchanged.
  */
 interface DisplayDataItem {
-    /** Namespaced wire type token, e.g. `Selva.GH.Features.Display.Services.DisplayBatch`. */
-    type: string;
-    data: string;
+  /** Namespaced wire type token, e.g. `Selva.GH.Features.Display.Services.DisplayBatch`. */
+  type: string;
+  data: string;
 }
 interface DisplayResponseValue {
-    InnerTree: {
-        [branchPath: string]: DisplayDataItem[];
-    };
+  InnerTree: {
+    [branchPath: string]: DisplayDataItem[];
+  };
 }
 interface DisplayComputeResponse {
-    values: DisplayResponseValue[];
-    /** Rhino `UnitSystem` name driving unit scaling (see `SCALE_FACTORS`); unrecognized/absent scales 1. */
-    modelunits: string;
+  values: DisplayResponseValue[];
+  /** Rhino `UnitSystem` name driving unit scaling (see `SCALE_FACTORS`); unrecognized/absent scales 1. */
+  modelunits: string;
 }
-
+//#endregion
+//#region src/parse/display-items/types.d.ts
 interface DisplayIdentity {
-    /** Stable pick key: `${sourceComponentId}:${originalIndex}`. Distinct from `name` so renaming doesn't change identity. */
-    id: string;
-    name: string;
-    layer: string;
-    /** Arbitrary key-value pairs from the GH Metadata input. */
-    metadata?: Record<string, string>;
+  /** Stable pick key: `${sourceComponentId}:${originalIndex}`. Distinct from `name` so renaming doesn't change identity. */
+  id: string;
+  name: string;
+  layer: string;
+  /** Arbitrary key-value pairs from the GH Metadata input. */
+  metadata?: Record<string, string>;
 }
 interface DisplayItemBase extends DisplayIdentity {
-    /** Hex/rgb/named color string, parsed by `parseColor`. Falls back to a viewer default. */
-    color?: string;
-    /** 0-1; omitted means fully opaque. */
-    opacity?: number;
+  /** Hex/rgb/named color string, parsed by `parseColor`. Falls back to a viewer default. */
+  color?: string;
+  /** 0-1; omitted means fully opaque. */
+  opacity?: number;
 }
 /** Rhino's Z-up frame and `{X,Y,Z}` casing. */
 interface DisplayPosition {
-    X: number;
-    Y: number;
-    Z: number;
+  X: number;
+  Y: number;
+  Z: number;
 }
 /** Rendered as a fat `Line2` straight from `points` — nothing decodes geometry in the browser. */
 interface DisplayCurve extends DisplayItemBase {
-    kind: 'curve';
-    /**
-     * Backend-tessellated polyline, flat `[x,y,z, …]` in Rhino's Z-up frame.
-     *
-     * Typed as required even though the plugin still sends a legacy `json` field alongside it: a
-     * payload without `points` came from a Display component too old to render, and parsing throws
-     * rather than treating it as a shape this package supports.
-     */
-    points: number[];
-    /** Screen-space CSS px, constant regardless of zoom. Omitted uses the viewer default. */
-    width?: number;
+  kind: 'curve';
+  /**
+   * Backend-tessellated polyline, flat `[x,y,z, …]` in Rhino's Z-up frame.
+   *
+   * Typed as required even though the plugin still sends a legacy `json` field alongside it: a
+   * payload without `points` came from a Display component too old to render, and parsing throws
+   * rather than treating it as a shape this package supports.
+   */
+  points: number[];
+  /** Screen-space CSS px, constant regardless of zoom. Omitted uses the viewer default. */
+  width?: number;
 }
 interface DisplayPoint extends DisplayItemBase {
-    kind: 'point';
-    position: DisplayPosition;
+  kind: 'point';
+  position: DisplayPosition;
 }
 type DisplayItem = DisplayCurve | DisplayPoint;
-
+//#endregion
+//#region src/parse/webdisplay/types.d.ts
 interface SerializableMaterial {
-    color: string;
-    metalness: number;
-    roughness: number;
-    opacity: number;
-    transparent: boolean;
-    /**
-     * Optional color-map texture reference: http(s) URL, data URI, or plugin asset URL
-     * (`http://localhost:{port}/assets/{hash}`). Omitted entirely (not just empty) when untextured.
-     * When set, the mesh blob also carries per-vertex UVs (FLAG_HAS_UVS) for meshes using it.
-     */
-    map?: string;
+  color: string;
+  metalness: number;
+  roughness: number;
+  opacity: number;
+  transparent: boolean;
+  /**
+   * Optional color-map texture reference: http(s) URL, data URI, or plugin asset URL
+   * (`http://localhost:{port}/assets/{hash}`). Omitted entirely (not just empty) when untextured.
+   * When set, the mesh blob also carries per-vertex UVs (FLAG_HAS_UVS) for meshes using it.
+   */
+  map?: string;
 }
 /**
  * `vertexStart`/`vertexCount` and `indexStart`/`indexCount` are in **element units** of the
@@ -90,23 +93,23 @@ interface SerializableMaterial {
  * vertex components are 2 bytes (int16 quantized) or 4 bytes (`FLAG_FLOAT32`).
  */
 interface MeshMetadata {
-    name: string;
-    /** Layer path for grouping in the scene manager, e.g. 'Structure/Walls'. */
-    layer: string;
-    /** Index in the GH input tree before material grouping; combined with sourceComponentId
-     *  uniquely identifies the GH source geometry. */
-    originalIndex: number;
-    vertexCount: number;
-    /** 3 per triangle. */
-    indexCount: number;
-    vertexStart: number;
-    indexStart: number;
-    /** Arbitrary key-value pairs from the GH Metadata input. */
-    metadata?: Record<string, string>;
+  name: string;
+  /** Layer path for grouping in the scene manager, e.g. 'Structure/Walls'. */
+  layer: string;
+  /** Index in the GH input tree before material grouping; combined with sourceComponentId
+   *  uniquely identifies the GH source geometry. */
+  originalIndex: number;
+  vertexCount: number;
+  /** 3 per triangle. */
+  indexCount: number;
+  vertexStart: number;
+  indexStart: number;
+  /** Arbitrary key-value pairs from the GH Metadata input. */
+  metadata?: Record<string, string>;
 }
 interface MaterialGroup {
-    materialId: number;
-    meshes: MeshMetadata[];
+  materialId: number;
+  meshes: MeshMetadata[];
 }
 /**
  * One Display component's payload, ready for Three.js rendering.
@@ -120,45 +123,45 @@ interface MaterialGroup {
  * blob (`items`), not inside it.
  */
 interface DisplayBatch {
-    materials: SerializableMaterial[];
-    groups: MaterialGroup[];
-    compressedData: string;
-    /** InstanceGuid of the WebDisplay GH component that produced this batch; combined with
-     *  MeshMetadata.originalIndex to backtrack any mesh to its GH source. */
-    sourceComponentId?: string;
-    /** Non-mesh display items — see {@link DisplayItem}. Parsed by the separate `display-items`
-     *  path, not the SLVA mesh parser. Omitted when there are none. */
-    items?: DisplayItem[];
+  materials: SerializableMaterial[];
+  groups: MaterialGroup[];
+  compressedData: string;
+  /** InstanceGuid of the WebDisplay GH component that produced this batch; combined with
+   *  MeshMetadata.originalIndex to backtrack any mesh to its GH source. */
+  sourceComponentId?: string;
+  /** Non-mesh display items — see {@link DisplayItem}. Parsed by the separate `display-items`
+   *  path, not the SLVA mesh parser. Omitted when there are none. */
+  items?: DisplayItem[];
 }
 interface MeshBatchParsingOptions {
-    /** Merge meshes sharing a material into a single geometry. Defaults to true. */
-    mergeByMaterial?: boolean;
-    debug?: boolean;
-    /**
-     * Appearance dials applied to every material built from this batch — 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;
+  /** Merge meshes sharing a material into a single geometry. Defaults to true. */
+  mergeByMaterial?: boolean;
+  debug?: boolean;
+  /**
+   * Appearance dials applied to every material built from this batch — 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;
 }
-
 interface MeshExtractionOptions {
-    parsing?: MeshBatchParsingOptions;
-    /** Scale geometry to model units. Defaults to true. */
-    allowScaling?: boolean;
-    /**
-     * Drop geometry so its lowest point sits on the ground plane. **Defaults to `false`** — content
-     * renders at its true Rhino coordinates, matching the Grasshopper definition. Setting `true`
-     * shifts objects, so anything read back out of the scene (bounds, measured/picked positions) no
-     * longer corresponds to Rhino coordinates.
-     */
-    allowAutoPosition?: boolean;
-    /** Up axis for `allowAutoPosition` grounding. Defaults to `'z'` (Rhino's frame) — only set this
-     *  if the viewer is configured with a non-default `sceneUp`. */
-    groundAxis?: 'x' | 'y' | 'z';
-    debug?: boolean;
+  parsing?: MeshBatchParsingOptions;
+  /** Scale geometry to model units. Defaults to true. */
+  allowScaling?: boolean;
+  /**
+   * Drop geometry so its lowest point sits on the ground plane. **Defaults to `false`** — content
+   * renders at its true Rhino coordinates, matching the Grasshopper definition. Setting `true`
+   * shifts objects, so anything read back out of the scene (bounds, measured/picked positions) no
+   * longer corresponds to Rhino coordinates.
+   */
+  allowAutoPosition?: boolean;
+  /** Up axis for `allowAutoPosition` grounding. Defaults to `'z'` (Rhino's frame) — only set this
+   *  if the viewer is configured with a non-default `sceneUp`. */
+  groundAxis?: 'x' | 'y' | 'z';
+  debug?: boolean;
 }
-
+//#endregion
+//#region src/parse/webdisplay/webdisplay-parser.d.ts
 /**
  * Metres per model unit, keyed by Rhino `UnitSystem` name (the `modelunits` string on the compute
  * response). Imperial factors are the exact international definitions. Units missing from this
@@ -175,10 +178,11 @@ declare const SCALE_FACTORS: Record<string, number>;
  * @throws Rethrows unexpected errors after attempting to dispose any created meshes.
  */
 declare function getThreeMeshesFromComputeResponse(data: DisplayComputeResponse, options?: MeshExtractionOptions): Promise<THREE.Object3D[]>;
-
+//#endregion
+//#region src/parse/webdisplay/batch-parser.d.ts
 interface ParseTelemetry {
-    parseTime?: number;
-    perfStart?: number;
+  parseTime?: number;
+  perfStart?: number;
 }
 /**
  * Parses a DisplayBatch object and creates Three.js meshes from its mesh blob.
@@ -188,7 +192,7 @@ interface ParseTelemetry {
  *
  * @throws {VisualizationError} On a corrupt/truncated/unsupported mesh blob or malformed group metadata.
  */
-declare function parseMeshBatchObject(batch: DisplayBatch, options?: MeshBatchParsingOptions, 
+declare function parseMeshBatchObject(batch: DisplayBatch, options?: MeshBatchParsingOptions,
 /** @internal Timings threaded from an outer entry point — not a caller option. */
 telemetry?: ParseTelemetry): Promise<THREE.Mesh[]>;
 /**
@@ -201,14 +205,16 @@ telemetry?: ParseTelemetry): Promise<THREE.Mesh[]>;
  * @throws {VisualizationError} On a corrupt/truncated/unsupported mesh blob or malformed group metadata.
  */
 declare function parseMeshBatchBlob(blob: ArrayBuffer | Uint8Array, options?: MeshBatchParsingOptions): Promise<THREE.Mesh[]>;
-
+//#endregion
+//#region src/parse/webdisplay/apply-texture.d.ts
 /**
  * Subscribed to the renderer's own report below, so no host wiring is needed; still exported for a
  * host embedding a foreign renderer that wants to set it directly. Applies to textures loaded from
  * here on — textures already decoded keep the value they were given.
  */
 declare function setTextureAnisotropy(value: number): void;
-
+//#endregion
+//#region src/parse/display-items/display-items-parser.d.ts
 /**
  * Builds THREE objects for the batch's non-mesh items.
  *
@@ -217,5 +223,6 @@ declare function setTextureAnisotropy(value: number): void;
  * unrenderable item is logged and skipped.
  */
 declare function parseDisplayItems(items: DisplayItem[] | undefined): THREE.Object3D[];
-
+//#endregion
 export { type DisplayBatch, type DisplayComputeResponse, type DisplayCurve, type DisplayDataItem, type DisplayIdentity, type DisplayItem, type DisplayItemBase, type DisplayPoint, type DisplayPosition, type DisplayResponseValue, type MaterialGroup, type MeshBatchParsingOptions, type MeshExtractionOptions, type MeshMetadata, SCALE_FACTORS, type SerializableMaterial, getThreeMeshesFromComputeResponse, meshPolicy, parseDisplayItems, parseMeshBatchBlob, parseMeshBatchObject, setTextureAnisotropy };
+//# sourceMappingURL=parse.d.ts.map