@selvajs/visualization 1.6.0-beta.1 → 1.6.0-beta.11

package/dist/parse.d.cts

@@ -1,13 +1,10 @@
-import { a as MaterialAppearanceOptions } from "./types-DjPelPRM.cjs";
+import { o as MaterialAppearanceOptions } from "./types-DW_qU4-Y.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. */
 export declare const meshPolicy: {
   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
@@ -29,8 +26,6 @@ interface GrasshopperComputeResponse {
   /** 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 {
   /** The item's identity — the writer-minted opaque id, same contract as mesh ids. Distinct from `name` so renaming doesn't change identity. */
   id: string;
@@ -70,8 +65,6 @@ interface DisplayPoint extends DisplayItemBase {
   position: DisplayPosition;
 }
 type DisplayItem = DisplayCurve | DisplayPoint;
-//#endregion
-//#region src/parse/webdisplay/types.d.ts
 interface SerializableMaterial {
   color: string;
   metalness: number;
@@ -90,6 +83,12 @@ interface SerializableMaterial {
   normalMap?: string;
   /** Wins over the look's `envMapIntensity` (except in looks that override materials). */
   envMapIntensity?: number;
+  /** Hex colour the surface emits. Omitted: no emission. */
+  emissive?: string;
+  /** Omitted: 1. Above 1 it blooms in looks with bloom. */
+  emissiveIntensity?: number;
+  /** Light the surface casts in the night look, in candela-scaled units. Omitted: scaled to the model. */
+  emissiveLight?: number;
   /** Omitted: no coat. */
   clearcoat?: number;
   clearcoatRoughness?: number;
@@ -106,7 +105,7 @@ interface SerializableMaterial {
    */
   mapSize?: number;
   /** Procedural scratch fibres along the grain, from UVs in mm. */
-  finish?: 'brushed' | 'rolled';
+  finish?: 'brushed' | 'rolled' | 'wood' | 'concrete' | 'plaster' | 'brick' | 'corten';
   /** Scales the finish's streaks; 0 draws none. Omitted: 1. */
   finishStrength?: number;
   /** Light passing through (glass); unlike `opacity` it keeps reflections. */
@@ -135,6 +134,8 @@ interface MeshMetadata {
   indexStart: number;
   /** Arbitrary key-value pairs from the GH Metadata input. */
   metadata?: Record<string, string>;
+  /** The writer's closed-solid verdict (see `isClosedSolid`); absent means compute it here. */
+  closed?: boolean;
 }
 interface MaterialGroup {
   materialId: number;
@@ -186,8 +187,6 @@ interface MeshExtractionOptions {
   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
@@ -204,8 +203,6 @@ export declare const SCALE_FACTORS: Record<string, number>;
  * @throws Rethrows unexpected errors after attempting to dispose any created meshes.
  */
 export declare function getThreeObjectsFromComputeResponse(data: GrasshopperComputeResponse, options?: MeshExtractionOptions): Promise<THREE.Object3D[]>;
-//#endregion
-//#region src/parse/webdisplay/batch-parser.d.ts
 interface ParseTelemetry {
   parseTime?: number;
   perfStart?: number;
@@ -231,16 +228,17 @@ telemetry?: ParseTelemetry): Promise<THREE.Mesh[]>;
  * @throws {VisualizationError} On a corrupt/truncated/unsupported mesh blob or malformed group metadata.
  */
 export declare function parseMeshBatchBlob(blob: ArrayBuffer | Uint8Array, options?: MeshBatchParsingOptions): Promise<THREE.Mesh[]>;
-//#endregion
-//#region src/parse/webdisplay/apply-texture.d.ts
+/**
+ * Empties the cache and frees its geometries. The cache lives as long as the page, so a host calls
+ * this when its viewer goes away; a mesh still drawing one of them uploads it again.
+ */
+export declare function clearGeometryCache(): void;
 /**
  * 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.
  */
 export 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.
  *
@@ -249,6 +247,5 @@ export declare function setTextureAnisotropy(value: number): void;
  * unrenderable item is logged and skipped.
  */
 export declare function parseDisplayItems(items: DisplayItem[] | undefined): THREE.Object3D[];
-//#endregion
 export type { DisplayBatch, DisplayCurve, DisplayIdentity, DisplayItem, DisplayItemBase, DisplayPoint, DisplayPosition, MaterialGroup, MeshBatchParsingOptions, MeshExtractionOptions, MeshMetadata, SerializableMaterial };
 //# sourceMappingURL=parse.d.cts.map

package/dist/parse.d.ts

@@ -1,13 +1,10 @@
-import { a as MaterialAppearanceOptions } from "./types-DjPelPRM.js";
+import { o as MaterialAppearanceOptions } from "./types-DW_qU4-Y.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. */
 export declare const meshPolicy: {
   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
@@ -29,8 +26,6 @@ interface GrasshopperComputeResponse {
   /** 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 {
   /** The item's identity — the writer-minted opaque id, same contract as mesh ids. Distinct from `name` so renaming doesn't change identity. */
   id: string;
@@ -70,8 +65,6 @@ interface DisplayPoint extends DisplayItemBase {
   position: DisplayPosition;
 }
 type DisplayItem = DisplayCurve | DisplayPoint;
-//#endregion
-//#region src/parse/webdisplay/types.d.ts
 interface SerializableMaterial {
   color: string;
   metalness: number;
@@ -90,6 +83,12 @@ interface SerializableMaterial {
   normalMap?: string;
   /** Wins over the look's `envMapIntensity` (except in looks that override materials). */
   envMapIntensity?: number;
+  /** Hex colour the surface emits. Omitted: no emission. */
+  emissive?: string;
+  /** Omitted: 1. Above 1 it blooms in looks with bloom. */
+  emissiveIntensity?: number;
+  /** Light the surface casts in the night look, in candela-scaled units. Omitted: scaled to the model. */
+  emissiveLight?: number;
   /** Omitted: no coat. */
   clearcoat?: number;
   clearcoatRoughness?: number;
@@ -106,7 +105,7 @@ interface SerializableMaterial {
    */
   mapSize?: number;
   /** Procedural scratch fibres along the grain, from UVs in mm. */
-  finish?: 'brushed' | 'rolled';
+  finish?: 'brushed' | 'rolled' | 'wood' | 'concrete' | 'plaster' | 'brick' | 'corten';
   /** Scales the finish's streaks; 0 draws none. Omitted: 1. */
   finishStrength?: number;
   /** Light passing through (glass); unlike `opacity` it keeps reflections. */
@@ -135,6 +134,8 @@ interface MeshMetadata {
   indexStart: number;
   /** Arbitrary key-value pairs from the GH Metadata input. */
   metadata?: Record<string, string>;
+  /** The writer's closed-solid verdict (see `isClosedSolid`); absent means compute it here. */
+  closed?: boolean;
 }
 interface MaterialGroup {
   materialId: number;
@@ -186,8 +187,6 @@ interface MeshExtractionOptions {
   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
@@ -204,8 +203,6 @@ export declare const SCALE_FACTORS: Record<string, number>;
  * @throws Rethrows unexpected errors after attempting to dispose any created meshes.
  */
 export declare function getThreeObjectsFromComputeResponse(data: GrasshopperComputeResponse, options?: MeshExtractionOptions): Promise<THREE.Object3D[]>;
-//#endregion
-//#region src/parse/webdisplay/batch-parser.d.ts
 interface ParseTelemetry {
   parseTime?: number;
   perfStart?: number;
@@ -231,16 +228,17 @@ telemetry?: ParseTelemetry): Promise<THREE.Mesh[]>;
  * @throws {VisualizationError} On a corrupt/truncated/unsupported mesh blob or malformed group metadata.
  */
 export declare function parseMeshBatchBlob(blob: ArrayBuffer | Uint8Array, options?: MeshBatchParsingOptions): Promise<THREE.Mesh[]>;
-//#endregion
-//#region src/parse/webdisplay/apply-texture.d.ts
+/**
+ * Empties the cache and frees its geometries. The cache lives as long as the page, so a host calls
+ * this when its viewer goes away; a mesh still drawing one of them uploads it again.
+ */
+export declare function clearGeometryCache(): void;
 /**
  * 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.
  */
 export 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.
  *
@@ -249,6 +247,5 @@ export declare function setTextureAnisotropy(value: number): void;
  * unrenderable item is logged and skipped.
  */
 export declare function parseDisplayItems(items: DisplayItem[] | undefined): THREE.Object3D[];
-//#endregion
 export type { DisplayBatch, DisplayCurve, DisplayIdentity, DisplayItem, DisplayItemBase, DisplayPoint, DisplayPosition, MaterialGroup, MeshBatchParsingOptions, MeshExtractionOptions, MeshMetadata, SerializableMaterial };
 //# sourceMappingURL=parse.d.ts.map