@nebula-spatial/cad-loader 0.2.3 → 0.3.0

package/dist/core/parser/bin-parser.d.ts

@@ -1,6 +1,20 @@
 import type { BlockInstanceBBox, ExternalAnnotationsManifest, ExternalBlockVariantManifestEntry, GeoMeta, GeoGroup } from '../types';
 import type { GeoChunk, GeoGeometryChunk, GroupLayerEncoding, ParsedHeader, InsertRuntimeGeometry } from './types';
 import { type DecodedAnnotationSidecar } from './dxbs-sidecar';
+/**
+ * Opaque cache produced by the V3 streaming parser for reuse by a document
+ * session's prepare worker.  The public shape intentionally exposes only the
+ * cache kind and owning buffer; parser internals remain private.
+ */
+export interface BinDocumentCache {
+    readonly kind: 'dxb3-v3';
+    readonly buffer: ArrayBuffer;
+}
+export interface BinStreamingResult {
+    readonly header: ParsedHeader;
+    readonly chunks: Generator<GeoChunk, void, void>;
+    readonly documentCache?: BinDocumentCache;
+}
 export type ParseBinOptions = {
     hiddenInstanceIds?: ReadonlySet<number>;
     keepTextsForHiddenInstances?: boolean;
@@ -11,6 +25,7 @@ export type ParseBinOptions = {
     requiredExternalVariantIds?: ReadonlySet<number>;
     externalVariantDeltaOnly?: boolean;
     deferExternalVariantGeometry?: boolean;
+    cacheDocument?: boolean;
 };
 export interface ExternalVariantDependencyPlan {
     readonly manifest: readonly ExternalBlockVariantManifestEntry[];
@@ -50,10 +65,8 @@ export declare function readExternalBlockAnnotations(buf: ArrayBuffer, options?:
     externalVariantBuffers?: ReadonlyMap<number, ArrayBuffer>;
     hiddenInstanceIds?: ReadonlySet<number>;
 }): DecodedAnnotationSidecar | null;
-export declare function parseBinStreaming(buf: ArrayBuffer, options?: ParseBinOptions): {
-    header: ParsedHeader;
-    chunks: Generator<GeoChunk, void, void>;
-};
+export declare function parseBinStreaming(buf: ArrayBuffer, options?: ParseBinOptions): BinStreamingResult;
+export declare function parseBinStreamingWithCache(buf: ArrayBuffer, cache: BinDocumentCache, options?: ParseBinOptions): BinStreamingResult;
 export declare function parseBinBounds(buf: ArrayBuffer): ParsedHeader['bounds'];
 export declare function parseBinToChunks(buf: ArrayBuffer, options?: ParseBinOptions): Generator<GeoChunk, ParsedHeader, void>;
 export declare function parseBinPayload(buf: ArrayBuffer, options?: ParseBinOptions): {

package/dist/core/parser/types.d.ts

@@ -1,4 +1,4 @@
-import type { GeoMetaSnapshot, LayerBlockUsage, LayerSnapshot, TextEntity } from '../types';
+import type { GeoMetaSnapshot, GeoMetaUnits, LayerBlockUsage, LayerSnapshot, TextEntity } from '../types';
 type ParsedHeaderCounts = Pick<GeoMetaSnapshot, 'entityCount' | 'lineCount' | 'fillCount' | 'dotCount' | 'textCount'>;
 export interface InsertRuntimeGeometry {
     readonly count: number;
@@ -43,6 +43,7 @@ export interface ParsedHeader {
     readonly layerBlockUsages?: ReadonlyMap<number, readonly LayerBlockUsage[]>;
     readonly insertRuntime?: InsertRuntime;
     readonly promotedInsertInstanceIds?: readonly number[];
+    readonly units?: GeoMetaUnits;
 }
 export interface GeoGeometrySegment {
     readonly startVertex: number;

package/dist/core/types.d.ts

@@ -116,6 +116,7 @@ export interface GeoMeta {
     instance_count?: number;
     layers: LayerMeta[];
     texts: readonly TextEntity[];
+    units?: GeoMetaUnits;
 }
 export type PackEncoding = 'flat' | 'instanced' | 'nested_instanced' | 'nested_instanced_external' | 'nested_instanced_external_annotations';
 export interface GeoMetaSnapshot {
@@ -145,3 +146,8 @@ export interface ViewportRect {
     maxX: number;
     maxY: number;
 }
+export interface GeoMetaUnits {
+    readonly source?: string;
+    readonly scale_to_meters?: number;
+    readonly scaleToMeters?: number;
+}

package/dist/index.d.ts

@@ -14,12 +14,14 @@ export type { ColorPipelineStatsSnapshot, GeoNodeChange, GeoNodeChangeKind, GeoN
 export type { LineMemoryStatsSnapshot, LineCanonicalMemoryStats, } from './loader/internal/line-canonical';
 export { readBlockAnnotationSidecar, readSceneAnnotationSidecar, } from './core';
 export type { DecodedAnnotationSidecar, DxbsContainer, DxbsSectionEntry, ParsedHeader, } from './core';
-export type { BlockInstanceBBox, BlockVariantMeta, ExternalAnnotationsManifest, ExternalAnnotationStats, ExternalBlockVariantManifestEntry, ExternalGeometryStats, ExternalSceneAnnotationManifestEntry, GeoGroup, GeoMeta, GeoMetaFeatures, GeoMetaSnapshot, GeoLoadSource, InsertUsage, LayerBlockUsage, LayerMeta, LayerSnapshot, LayerVertexChunk, LayerVertexStat, LineRenderMode, PackEncoding, ParsedGeoPayload, RenderDebugBreakdownEntry, SceneStats, SplitBlockLayerDetail, TextEntity, ViewportRect, } from './shared/types';
+export type { BlockInstanceBBox, BlockVariantMeta, ExternalAnnotationsManifest, ExternalAnnotationStats, ExternalBlockVariantManifestEntry, ExternalGeometryStats, ExternalSceneAnnotationManifestEntry, GeoGroup, GeoMeta, GeoMetaUnits, GeoMetaFeatures, GeoMetaSnapshot, GeoLoadSource, InsertUsage, LayerBlockUsage, LayerMeta, LayerSnapshot, LayerVertexChunk, LayerVertexStat, LineRenderMode, PackEncoding, ParsedGeoPayload, RenderDebugBreakdownEntry, SceneStats, SplitBlockLayerDetail, TextEntity, ViewportRect, } from './shared/types';
 export { expandViewportRect, mergeViewportRects, viewportRectContains, viewportRectIntersects, } from './shared/utils/viewport-rect';
 export { transformBBoxByInstance } from './shared/utils/insert-bbox';
 export type { InsertInstanceTransform } from './shared/utils/insert-bbox';
 export { GeoLoaderError } from './shared/errors';
 export type { ResolveTextFont, ResolvedTextFont } from './shared/text-font';
+export { configureCadTextBuilder } from './shared/text-builder';
+export type { CadTextBuilderOptions } from './shared/text-builder';
 export type { BlockGeometryKind, VariantGeometry, } from './scene/instancing/block-geometry-registry';
 export type { InsertInstanceRecord } from './scene/instancing/insert-instance-table';
 export { cadInsertSelectionEquals, pickCadInsertAtPoint, resolveCadInsertDetails, } from './selection/cad-insert-selection';
@@ -29,6 +31,6 @@ export type { CadTextDetails, CadTextPickOptions, CadTextSelection, CadTextSelec
 export { CAD_SESSION_PHASES } from './session/cad-document-session';
 export { createCadDocumentSession, getCadDocumentRenderResource } from './session/create-cad-document-session';
 export { formatCadInsertId, parseCadInsertId } from './session/cad-insert-id';
-export type { CadDisplayContext, CadDocumentHeader, CadDocumentSession, CadDocumentSessionOptions, CadFontResolver, CadInsertUsageSummary, CadLayerMeta, CadSessionEventMap, CadSessionLoadTiming, CadSessionPhase, CadViewportDemand, CadViewportRect, CadVisibilityFilter, CadWorldBounds, CadWorldPoint, } from './session/cad-document-session';
+export type { CadDisplayContext, CadDocumentHeader, CadDocumentUnits, CadDocumentSession, CadDocumentSessionOptions, CadFontResolver, CadInsertUsageSummary, CadLayerMeta, CadSessionEventMap, CadSessionLoadTiming, CadSessionPhase, CadViewportDemand, CadViewportRect, CadVisibilityFilter, CadWorldBounds, CadWorldPoint, } from './session/cad-document-session';
 export { CAD_RENDER_NODE_EDIT_METHODS, isCadRenderNodeEditMethod } from './render-resource/cad-render-node';
 export type { CadInsertPreviewResource, CadRenderContentChunk, CadRenderNode, } from './render-resource/cad-render-node';