three-cad-viewer 4.3.8 → 4.3.9

package/dist/core/studio-manager.d.ts

@@ -48,6 +48,13 @@ declare class StudioManager {
     private _savedClippingState;
     private _shadowLights;
     private _ctx;
+    /**
+     * Renderer pixel ratio saved on Studio entry, restored on leave.
+     * Studio mode bumps the pixel ratio to apply supersampling, which
+     * compensates for low DPR (e.g., VSCode webviews report DPR=1 even
+     * on Retina displays) and improves AA on shallow-angle edges.
+     */
+    private _savedPixelRatio;
     constructor(ctx: StudioManagerContext);
     get isActive(): boolean;
     get hasComposer(): boolean;

package/dist/core/types.d.ts

@@ -271,6 +271,14 @@ export interface ViewerOptions extends StudioModeOptions {
     zoomSpeed?: number;
     /** Show timings in browser console (default: false) */
     timeit?: boolean;
+    /**
+     * Tab to land on after render (default: "tree", i.e. CAD mode).
+     * When set to a non-tree tab, the initial CAD paint is skipped so the
+     * user doesn't see a brief CAD-mode flicker before the target tab takes
+     * over. Especially noticeable for "studio" (async env-map load) and
+     * "zebra" (material swap).
+     */
+    tab?: ActiveTab;
 }
 /** Zebra tool options */
 export interface ZebraOptions {
@@ -508,6 +516,9 @@ export interface MaterialXMaterial {
     textures: Record<string, string>;
     /** Optional texture tiling [u, v], default [1, 1]. Applied to all textures. */
     textureRepeat?: [number, number];
+    /** Optional texture rotation in **radians**, counterclockwise. Pivot is
+     *  the texture center (0.5, 0.5). Applied to all textures. */
+    textureRotation?: number;
 }
 /**
  * Type guard to check if a material entry is a threejs-materials format dict.

package/dist/core/viewer.d.ts

@@ -183,6 +183,7 @@ declare class Viewer {
     private _pendingDisposal;
     shapes: Shapes | null;
     gridSize: number;
+    private _previousGridSize;
     hasAnimationLoop: boolean;
     mixer: THREE.AnimationMixer | null;
     continueAnimation: boolean;

package/dist/index.d.ts

@@ -15,10 +15,10 @@ import { Timer } from "./utils/timer.js";
 import { logger } from "./utils/logger.js";
 import { gpuTracker } from "./utils/gpu-tracker.js";
 import { version } from "./_version.js";
-export { Viewer, Display, EnvironmentManager, Timer, logger, gpuTracker, version };
-export { MATERIAL_PRESETS, MATERIAL_PRESET_NAMES } from "./rendering/material-presets.js";
+export { Viewer, Display, EnvironmentManager, Timer, logger, gpuTracker, version, };
+export { MATERIAL_PRESETS, MATERIAL_PRESET_NAMES, } from "./rendering/material-presets.js";
 export type { LogLevel } from "./utils/logger.js";
-export type { ResourceType, TrackedResource, ResourceSummary } from "./utils/gpu-tracker.js";
+export type { ResourceType, TrackedResource, ResourceSummary, } from "./utils/gpu-tracker.js";
 export type { Vector3Tuple, QuaternionTuple } from "three";
 export type { ThemeInput, Theme, ControlType, UpDirection, AnimationMode, ActiveTab, ZebraColorScheme, ZebraMappingMode, ShapeType, ShapeSubtype, Axis, ClipIndex, ColorValue, RGBColor, RGBAColor, AxisColors, AxisColorsFlatArray, } from "./core/types.js";
 export { CLIP_INDICES, isClipIndex, CollapseState } from "./core/types.js";
@@ -27,12 +27,12 @@ export type { BoundingBox, BoundingSphere, BoundingBoxFlat, } from "./core/types
 export type { PickInfo } from "./core/types.js";
 export type { ChangeInfos, ChangeNotification, NotificationCallback, } from "./core/types.js";
 export type { DisplayOptions, RenderOptions, ViewerOptions, ZebraOptions, CombinedOptions, } from "./core/types.js";
-export type { ViewerStateShape, StateKey, } from "./core/types.js";
+export type { ViewerStateShape, StateKey } from "./core/types.js";
 export type { Texture, Shape, ShapeBinary, ShapeNested, Location, VisibilityValue, VisibilityState, Shapes, } from "./core/types.js";
 export { isShapeBinaryFormat, hasTrianglesPerFace, hasSegmentsPerEdge, } from "./core/types.js";
 export type { DomEventCallback } from "./core/types.js";
 export type { ColoredMaterial } from "./core/types.js";
 export type { MaterialAppearance, MaterialXMaterial, StudioOptions, StudioBackground, StudioModeOptions, StudioEnvironment, StudioToneMapping, StudioTextureMapping, } from "./core/types.js";
 export { isMaterialXMaterial } from "./core/types.js";
-export { isInstancedFormat, decodeInstancedFormat } from "./utils/decode-instances.js";
+export { isInstancedFormat, decodeInstancedFormat, } from "./utils/decode-instances.js";
 export type { SubscribeOptions } from "./core/types.js";

package/dist/rendering/environment.d.ts

@@ -31,14 +31,6 @@ interface EnvironmentManagerOptions {
 declare class EnvironmentManager {
     /** Cached PMREM render targets keyed by environment name or URL */
     private _cache;
-    /**
-     * Cached raw equirectangular HDR textures keyed by the same name/URL.
-     * Preserved (not disposed after PMREM generation) so `scene.background`
-     * can sample the original HDR at full source resolution instead of the
-     * 256² PMREM cubemap. Only populated by `_loadHdr` — procedural
-     * environments have no source HDR.
-     */
-    private _hdrCache;
     /** Cached light detection results keyed by environment name or URL */
     private _lightDetectionCache;
     /** In-flight load promises keyed by environment name or URL */
@@ -55,13 +47,6 @@ declare class EnvironmentManager {
     private _hdrLoader;
     /** The last loaded PMREM texture (stateful — used by apply() for IBL) */
     private _currentTexture;
-    /**
-     * Raw HDR texture corresponding to `_currentTexture`, used for
-     * `scene.background` to keep the backdrop at source resolution. Null when
-     * the current environment is procedural ("studio" RoomEnvironment) — in
-     * that case the background falls back to `_currentTexture` (the PMREM).
-     */
-    private _currentBackgroundTexture;
     /** Whether this manager has been disposed */
     private _disposed;
     /**
@@ -236,10 +221,9 @@ declare class EnvironmentManager {
      * Load an HDR file and generate a PMREM texture from it.
      *
      * Uses HDRLoader to fetch the .hdr file, then PMREMGenerator.fromEquirectangular()
-     * to create the PMREM cubemap for IBL. The source equirectangular HDR is
-     * preserved and cached separately (in `_hdrCache`) so that "environment"
-     * background mode can sample the full-resolution equirectangular texture
-     * instead of the 256² PMREM cubemap.
+     * to create the PMREM cubemap. The source equirectangular HDR is disposed
+     * after PMREM generation. The PMREM texture itself serves as both the IBL
+     * environment and the background (in "environment" mode).
      *
      * @param url - URL of the .hdr file
      * @param cacheKey - Cache key for the resulting PMREM render target

package/dist/rendering/material-factory.d.ts

@@ -117,12 +117,12 @@ declare class MaterialFactory {
      * Create a standard material for back faces with PBR properties.
      * Used for polygon rendering where back faces need full shading.
      */
-    createBackFaceStandardMaterial({ color, alpha, polygonOffsetUnits, visible }: BackFaceMaterialOptions, label?: string): THREE.MeshStandardMaterial;
+    createBackFaceStandardMaterial({ color, alpha, polygonOffsetUnits, visible, }: BackFaceMaterialOptions, label?: string): THREE.MeshStandardMaterial;
     /**
      * Create a basic material for back faces (no lighting/PBR).
      * Used for shape rendering where back faces are simple fills.
      */
-    createBackFaceBasicMaterial({ color, alpha, polygonOffsetUnits, visible }: BackFaceMaterialOptions, label?: string): THREE.MeshBasicMaterial;
+    createBackFaceBasicMaterial({ color, alpha, polygonOffsetUnits, visible, }: BackFaceMaterialOptions, label?: string): THREE.MeshBasicMaterial;
     /**
      * Create a basic front face material (no PBR, for simple shapes).
      */
@@ -130,7 +130,7 @@ declare class MaterialFactory {
     /**
      * Create a fat line material (LineMaterial from Three.js examples).
      */
-    createEdgeMaterial({ lineWidth, color, vertexColors, visible, resolution }: EdgeMaterialOptions, label?: string): LineMaterial;
+    createEdgeMaterial({ lineWidth, color, vertexColors, visible, resolution, }: EdgeMaterialOptions, label?: string): LineMaterial;
     /**
      * Create a basic line material for simple edges (e.g., polygon outlines).
      */
@@ -156,7 +156,7 @@ declare class MaterialFactory {
      * @param label - Optional label for GPU tracking
      * @returns Configured MeshPhysicalMaterial (or MeshBasicMaterial if unlit)
      */
-    createStudioMaterial({ materialDef, fallbackColor, fallbackAlpha, textureCache }: StudioMaterialOptions, label?: string): Promise<THREE.MeshPhysicalMaterial | THREE.MeshBasicMaterial>;
+    createStudioMaterial({ materialDef, fallbackColor, fallbackAlpha, textureCache, }: StudioMaterialOptions, label?: string): Promise<THREE.MeshPhysicalMaterial | THREE.MeshBasicMaterial>;
     /**
      * Create a Studio mode material from a threejs-materials format entry.
      *
@@ -167,11 +167,13 @@ declare class MaterialFactory {
      * @param values - Scalar PBR values from threejs-materials
      * @param textures - Texture map references from threejs-materials
      * @param textureRepeat - Optional [u, v] texture tiling applied to all loaded textures
+     * @param textureRotation - Optional texture rotation in radians (counterclockwise),
+     *                          pivoting around the texture center (0.5, 0.5)
      * @param textureCache - TextureCache for resolving data URI textures
      * @param label - Optional label for GPU tracking
      * @returns Configured MeshPhysicalMaterial
      */
-    createStudioMaterialFromMaterialX(values: Record<string, unknown>, textures: Record<string, string>, textureRepeat: [number, number] | undefined, textureCache: TextureCacheInterface | null, label?: string): Promise<THREE.MeshPhysicalMaterial>;
+    createStudioMaterialFromMaterialX(values: Record<string, unknown>, textures: Record<string, string>, textureRepeat: [number, number] | undefined, textureRotation: number | undefined, textureCache: TextureCacheInterface | null, label?: string): Promise<THREE.MeshPhysicalMaterial>;
     /**
      * Apply alpha mode settings to a material.
      *
@@ -201,4 +203,4 @@ declare class MaterialFactory {
     update(options: UpdateOptions): void;
 }
 export { MaterialFactory };
-export type { MaterialFactoryOptions, UpdateOptions, StudioMaterialOptions, TextureCacheInterface };
+export type { MaterialFactoryOptions, UpdateOptions, StudioMaterialOptions, TextureCacheInterface, };

package/dist/rendering/raycast.d.ts

@@ -11,7 +11,7 @@ export declare const TopoFilter: {
     face: "face";
     solid: "solid";
 };
-export type TopoFilterType = typeof TopoFilter[keyof typeof TopoFilter];
+export type TopoFilterType = (typeof TopoFilter)[keyof typeof TopoFilter];
 interface RaycastFilters {
     topoFilter: TopoFilterType[];
 }

package/dist/rendering/studio-composer.d.ts

@@ -61,7 +61,7 @@ declare class StudioComposer {
      * @param width    - Canvas width in pixels
      * @param height   - Canvas height in pixels
      */
-    constructor(renderer: THREE.WebGLRenderer, scene: THREE.Scene, camera: THREE.Camera, width: number, height: number);
+    constructor(renderer: THREE.WebGLRenderer, scene: THREE.Scene, camera: THREE.Camera, width: number, height: number, onSmaaReady?: () => void);
     /**
      * Enable or disable solid-background protection.
      *

package/dist/rendering/tree-model.d.ts

@@ -7,7 +7,7 @@ declare const States: {
     readonly mixed: 2;
     readonly disabled: 3;
 };
-type StateValue = typeof States[keyof typeof States];
+type StateValue = (typeof States)[keyof typeof States];
 /** Icon index: 0 for shapes, 1 for edges */
 type IconIndex = 0 | 1;
 /**