@nebula-spatial/viewer 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this package are documented in this file.
 
+## 0.2.2
+
+- Refreshed selected INSERT details and overlays when incremental CAD content expands their bounding boxes.
+
+## 0.2.1
+
+- Resolved the geometry preparation Worker from the published package instead of the site root.
+- Added `CadOpenOptions.workerUrl` and `workerFactory` for custom Worker hosting.
+- Use the built-in room environment by default and support external HDR URLs through `ViewerOptions.environment`.
+
 ## 0.2.0
 
 - Added `viewer.cad` for opening, closing, and observing CAD documents.

package/README.md

@@ -28,6 +28,27 @@ await viewer.cad.open('/api/files/demo/result', {
 viewer.dispose();
 ```
 
+Viewer 默认使用 Three.js 内置 `RoomEnvironment` 提供基于图像的环境光，不会替换场景背景。
+外部系统也可以传入自己的等距柱状 HDR URL：
+
+```ts
+const viewer = createViewer({
+  viewport,
+  canvas,
+  environment: {
+    type: 'hdr',
+    url: 'https://static.example.com/environments/studio.hdr',
+  },
+});
+```
+
+HDR 资源由浏览器直接请求，因此资源服务器需要允许当前应用域名进行 CORS 访问。Viewer
+销毁时会释放已经加载的环境纹理；加载失败时保留原场景背景并在控制台输出警告。
+
+几何准备 Worker 默认从 Viewer npm 包内的相对资源路径加载，支持应用部署在子路径。
+需要自行托管 Worker 或满足特定 CSP 时，可通过 `CadOpenOptions.workerUrl` 或
+`workerFactory` 覆盖 Worker 创建方式。
+
 `CadLoadSource` 支持 URL、`ArrayBuffer`、`File` 及对应的 `{ kind: ... }` 形式。`open()`
 会替换当前 CAD 文档；调用 `viewer.cad.close()` 可仅关闭文档并保留 Viewer。
 

package/dist/cad/types.d.ts

@@ -57,6 +57,10 @@ export interface CadOpenOptions {
     documentKey?: string;
     filename?: string;
     loadAnnotations?: boolean;
+    /** Override the package-relative geometry preparation Worker URL. */
+    workerUrl?: string | URL;
+    /** Create the geometry preparation Worker. Takes precedence over `workerUrl`. */
+    workerFactory?: () => Worker;
     fontResolver?: CadFontResolver;
     resolveTextFont?: ResolveTextFont;
     /**

package/dist/index.d.ts

@@ -1,2 +1,2 @@
 export { createViewer } from './viewer';
-export type { CadBlockModel, CadDocumentHandle, CadFontResolver, CadResolvedTextFont, CadHudModel, CadInspectorModel, CadLayerModel, CadLoadSource, CadOpenOptions, CadTextDetails, CadTextSelection, CadTextSelectionId, CadViewerCapability, ResolveTextFont, CadViewerEventMap, CameraStateStore, Viewer, ViewerEventMap, ViewerFitViewOptions, ViewerHighlightOptions, ViewerOptions, ViewerPickOptions, ViewerPickResult, ViewerPointerEvent, ViewerUiOptions, ViewerUiParts, ViewerUiPreset, ViewerUiTheme, ViewerViewMode, } from './types';
+export type { CadBlockModel, CadDocumentHandle, CadFontResolver, CadResolvedTextFont, CadHudModel, CadInspectorModel, CadLayerModel, CadLoadSource, CadOpenOptions, CadTextDetails, CadTextSelection, CadTextSelectionId, CadViewerCapability, ResolveTextFont, CadViewerEventMap, CameraStateStore, Viewer, ViewerEventMap, ViewerEnvironment, ViewerFitViewOptions, ViewerHighlightOptions, ViewerOptions, ViewerPickOptions, ViewerPickResult, ViewerPointerEvent, ViewerUiOptions, ViewerUiParts, ViewerUiPreset, ViewerUiTheme, ViewerViewMode, } from './types';