@nebula-spatial/cad-loader 0.1.0

package/README.md

@@ -0,0 +1,46 @@
+# @nebula-spatial/cad-loader
+
+浏览器侧 DXB3/DXBS CAD pack Loader。它接收 URL、File、ArrayBuffer 或兼容的
+结构化 source，保留 Worker、主线程 fallback、增量构建、flow control、abort
+和 dispose 生命周期，并直接返回可挂载到 Three.js 场景的 `GeoNode`。
+
+```ts
+import { loadGeo } from '@nebula-spatial/cad-loader';
+
+const node = loadGeo('/api/files/demo/result');
+scene.add(node);
+await node.ready;
+```
+
+CAD 产品可以在 Viewer 提供世界坐标后，通过 Loader 的只读语义查询解析
+Block/INSERT。该能力不包含选择状态或属性面板 UI：
+
+```ts
+import {
+  pickCadInsertAtPoint,
+  resolveCadInsertDetails,
+} from '@nebula-spatial/cad-loader';
+
+const selection = pickCadInsertAtPoint(node, worldPoint);
+const details = selection ? resolveCadInsertDetails(node, selection) : null;
+```
+
+对于 URL source，V3.3 pack 的 external geometry 与 scene/block annotation 默认会在
+`node.ready` 前完成请求、校验、解码和挂接；不需要标注时可传入
+`{ loadAnnotations: false }`。Product App 若要按视口渐进加载，应先使用
+`ArrayBuffer` 和显式 sidecar 计划，再自行编排 annotation 的加载时机。
+
+上传、任务轮询、文件目录和原始 DXF/DWG 解析不属于此包。
+
+DXB3/DXBS 协议解析和纯数据契约通过稳定的 `/core` 子路径提供。该入口不依赖
+Three.js、DOM、Canvas 或 WebGL，可以在 Worker、Node.js 和 CLI 中独立使用：
+
+```ts
+import { parseBinBounds } from '@nebula-spatial/cad-loader/core';
+
+const bounds = parseBinBounds(buffer);
+```
+
+默认 Worker 使用包内的 ESM 资源路径。使用非 Vite bundler 或自行托管 Worker
+资源时，可以通过 `LoadGeoOptions.workerUrl` 指定 URL，或通过 `workerFactory`
+接管 Worker 创建。

package/dist/core/cad-types.d.ts

@@ -0,0 +1,26 @@
+import type { ExternalBlockVariantManifestEntry, GeoMeta, LayerSnapshot, TextEntity } from './types';
+import type { GeoChunk, GeoGeometryChunk, InsertRuntimeInstance, InsertRuntimeVariant, ParsedHeader } from './parser/types';
+/** Stable renderer-neutral public vocabulary for decoded CAD packs. */
+export type CadPackHeader = ParsedHeader;
+export type CadPackDocumentHeader = ParsedHeader;
+export type CadPackMeta = GeoMeta;
+export type CadLayer = LayerSnapshot;
+export type CadDisplayChunk = GeoGeometryChunk;
+export type CadTextChunk = TextEntity;
+export type CadBlockDefinition = InsertRuntimeVariant;
+export type CadInsertInstance = InsertRuntimeInstance;
+export type CadExternalVariantManifestEntry = ExternalBlockVariantManifestEntry;
+export type CadExternalVariantManifest = readonly ExternalBlockVariantManifestEntry[];
+export interface CadExternalVariantDelta {
+    readonly header: ParsedHeader;
+    readonly chunks: readonly GeoChunk[];
+}
+/**
+ * A decoded pack document. Parsers may keep typed-array payloads backed by the
+ * original buffer; `rawBytes` records the source size for diagnostics.
+ */
+export interface CadPackDocument {
+    readonly header: ParsedHeader;
+    readonly chunks: readonly GeoChunk[];
+    readonly rawBytes: number;
+}

package/dist/core/errors.d.ts

@@ -0,0 +1,5 @@
+export type GeoLoaderErrorCode = 'E_SOURCE' | 'E_HEADER' | 'E_HEADER_JSON' | 'E_GROUP_RANGE' | 'E_UNSUPPORTED_PACK_VERSION' | 'E_EXPANSION_BUDGET' | 'E_SEGMENT_SUM' | 'E_TEXT_ROUNDTRIP' | 'E_DISPOSED' | 'E_PACK_HTTP' | 'E_PACK_NETWORK';
+export declare class GeoLoaderError extends Error {
+    readonly code: GeoLoaderErrorCode;
+    constructor(code: GeoLoaderErrorCode, message: string);
+}

package/dist/core/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Public, renderer-neutral entry point for the DXB3/DXBS pack protocol.
+ *
+ * Keep this file deliberately boring: consumers (including cad-loader) should
+ * only need the package root and must not reach into parser implementation
+ * paths.  The `Cad*` names below are stable vocabulary aliases over the
+ * protocol records that predate this package extraction.
+ */
+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 { 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';
+export type { ExpandedGeometryMetadata, GeometrySegmentSource, } from './parser/geometry-segments';
+export { assertStrictTextRoundtrip, isStrictTextRoundtripEnabled, shouldAssertStrictTextRoundtrip, } from './parser/text-roundtrip';
+export type * from './types';
+export type * from './parser/types';
+export type * from './cad-types';
+export type { InsertInstanceTransform } from './utils/insert-bbox';
+export { transformBBoxByInstance } from './utils/insert-bbox';
+export { cloneViewportRect, computeViewportRectFromPositions, expandViewportRect, intersectViewportRects, mergeViewportRects, normalizeViewportRect, transformViewportRect, viewportRectCenterDistance, viewportRectDiagonal, viewportRectContains, viewportRectEquals, viewportRectIntersects, } from './utils/viewport-rect';