@nebula-spatial/cad-loader 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to this package are documented in this file.
 
+## 0.2.4
+
+- Expose `configureCadTextBuilder()` as an explicit pass-through to the package's Troika text builder.
+- Start all sidecar requests required by the initial viewport in parallel.
+- Render the first available external block batch immediately and merge remaining results into one tail batch.
+- Preserve in-flight downloads and incremental rendering during viewport interaction.
+- Reuse the cached main DXB3 parse while preparing staged external block deltas.
+
+## 0.2.3
+
+- Render base geometry before external block sidecars finish loading.
+- Defer external variant geometry and append it progressively after sidecar loading.
+- Reuse a geometry Worker across sequential parses within a CAD document session.
+- Retain the main DXB3 buffer in the Worker to avoid retransferring it for variant delta parses.
+- Added CAD session load timing information for initial render and external content readiness.
+
 ## 0.2.2
 
 - Fixed INSERT bounding boxes being truncated when external variant delta content arrives incrementally.

package/README.md

@@ -39,6 +39,8 @@ session.dispose();
 
 `headerReady` 提供文档边界和图层元数据，`initialContentReady` 表示基础内容已可用。
 通过 `content-appended`、`demand-progress`、`phase-change` 和错误事件可监听后续变化。
+初始视口所需的外部 block sidecar 会并行请求；首批结果到达后即可增量渲染，剩余结果合并为尾批提交。
+会话会复用几何 Worker 和主 DXB3 解析缓存，避免连续 delta 解析重复传输和解析主缓冲区。
 
 默认几何准备 Worker 从包内的相对资源路径加载。使用非 Vite bundler、CSP 限制环境或自行托管
 Worker 资源时，可在会话选项中传入 `workerUrl`；需要完全控制 Worker 创建时，可传入优先级更高的
@@ -53,6 +55,26 @@ const session = createCadDocumentSession(source, {
 
 `CadRenderNode` 是只读渲染资源。选择状态、属性面板、编辑命令和历史记录由产品层维护。
 
+## 全局文字构建配置
+
+需要显式调整 Troika 文字构建参数时，在第一次 CAD 文字请求（包括字体预热）之前调用
+`configureCadTextBuilder()`：
+
+```ts
+import { configureCadTextBuilder } from '@nebula-spatial/cad-loader';
+
+configureCadTextBuilder({
+  defaultFontURL: '/fonts/cad-fallback.ttf',
+  useWorker: true,
+  sdfGlyphSize: 64,
+  textureWidth: 2048,
+});
+```
+
+该配置沿用 Troika 的全局、模块级、一次性语义，不是文档会话或 Viewer 实例级配置。调用方
+负责选择具体字体资源；字符和语言到字体的映射仍通过 `resolveTextFont` 提供。未调用时，
+`cad-loader` 不会设置任何默认值，继续使用 Troika 原有的内置远端资源逻辑。
+
 ## 其他入口
 
 - `loadGeo()`：简单的 `GeoNode` 增量加载。适合不需要文档会话的 Three.js 集成。

package/dist/core/index.d.ts

@@ -9,8 +9,8 @@
 export { GeoLoaderError, GeoLoaderError as CadPackError } from './errors';
 export type { GeoLoaderErrorCode, GeoLoaderErrorCode as CadPackErrorCode, } from './errors';
 export { captureGroupSnapshot, groupLayerEncodingForV3Minor, readGroup, streamGroupChunks, STREAM_VERTEX_WINDOW, } from './parser/bin-group-reader';
-export { parseBinBounds, parseBinPayload, parseBinStreaming, parseBinToChunks, readExternalAnnotationManifest, readExternalBlockAnnotations, readExternalVariantDependencyPlan, readExternalVariantGeometrySidecar, readExternalVariantManifest, } from './parser/bin-parser';
-export type { ExternalVariantDependencyOptions, ExternalVariantDependencyPlan, ParseBinOptions, } from './parser/bin-parser';
+export { parseBinBounds, parseBinPayload, parseBinStreaming, parseBinStreamingWithCache, parseBinToChunks, readExternalAnnotationManifest, readExternalBlockAnnotations, readExternalVariantDependencyPlan, readExternalVariantGeometrySidecar, readExternalVariantManifest, } from './parser/bin-parser';
+export type { BinDocumentCache, BinStreamingResult, ExternalVariantDependencyOptions, ExternalVariantDependencyPlan, ParseBinOptions, } from './parser/bin-parser';
 export { getDxbsSection, isDxbsPayload, readBlockAnnotationSidecar, readDxbsContainer, readSceneAnnotationSidecar, } from './parser/dxbs-sidecar';
 export type { DecodedAnnotationSidecar, DxbsContainer, DxbsSectionEntry, } from './parser/dxbs-sidecar';
 export { emptyGeometryChunk, expandGeometryChunkMetadata, mergeAdjacentSegments, normalizeGeometrySegments, offsetGeometrySegments, remapGeometrySegmentLayers, sliceGeometrySegments, } from './parser/geometry-segments';