@nebula-spatial/cad-loader 0.2.2 → 0.2.4

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/index.d.ts

@@ -20,6 +20,8 @@ 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, CadSessionPhase, CadViewportDemand, CadViewportRect, CadVisibilityFilter, CadWorldBounds, CadWorldPoint, } from './session/cad-document-session';
+export type { CadDisplayContext, CadDocumentHeader, 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';