@nebula-spatial/cad-loader 0.2.3 → 0.3.0

package/dist/loader/internal/external-variant-sidecar-fetch.d.ts

@@ -5,7 +5,6 @@ export type FetchExternalVariantSidecarsOptions = {
     readonly requiredVariantIds: readonly number[];
     readonly fetchImpl?: typeof fetch;
     readonly signal?: AbortSignal;
-    readonly concurrency?: number;
     readonly onBuffer?: (variantId: number, buffer: ArrayBuffer) => void | Promise<void>;
 };
 export declare function fetchExternalVariantSidecars(options: FetchExternalVariantSidecarsOptions): Promise<{

package/dist/loader/internal/geo-loader-pipeline.d.ts

@@ -45,6 +45,7 @@ export interface GeoLoaderPipelineAdapterInput {
     externalVariantGeometryFetchIds?: ReadonlySet<number>;
     deferExternalVariantGeometry?: boolean;
     externalVariantDeltaOnly?: boolean;
+    cacheDocument?: boolean;
 }
 export interface GeoLoaderPipelineSession {
     completion: Promise<void>;
@@ -81,6 +82,7 @@ export interface RunGeoLoaderPipelineOptions {
     externalVariantGeometryFetchIds?: ReadonlySet<number>;
     deferExternalVariantGeometry?: boolean;
     externalVariantDeltaOnly?: boolean;
+    cacheDocument?: boolean;
     appendExternalVariantDelta?: boolean;
     onYield?: YieldCallback;
     scheduler?: Partial<FrameBudgetSchedulerOptions>;

package/dist/loader/internal/geo-node-builder.d.ts

@@ -26,6 +26,7 @@ export interface BuildGeoNodeOptions {
     externalVariantGeometryFetchIds?: ReadonlySet<number> | readonly number[];
     deferExternalVariantGeometry?: boolean;
     externalVariantDeltaOnly?: boolean;
+    cacheDocument?: boolean;
     onFirstRenderableAppend?: () => void;
 }
 export declare function buildGeoNodeFromBuffer(node: GeoNode, buf: ArrayBuffer, onYield?: YieldCallback, options?: BuildGeoNodeOptions): Promise<void>;

package/dist/loader/internal/geo-node.d.ts

@@ -115,6 +115,10 @@ export declare class GeoNode extends Group {
     onChange(listener: GeoNodeChangeListener): () => void;
     _notifyStructureChange(): void;
     setLayerVisible(layerIndex: number, visible: boolean): void;
+    setLayerVisibleBatch(changes: ReadonlyArray<{
+        layerIndex: number;
+        visible: boolean;
+    }>): number;
     setAnnotationOverlayVisible(visible: boolean): void;
     setDisplayTheme(themeName: ViewerThemeName, options?: {
         enhanceContrast?: boolean;

package/dist/loader/internal/geo-prepare-worker-types.d.ts

@@ -26,6 +26,7 @@ export interface GeoPrepareParseRequest {
     requiredExternalVariantIds?: number[];
     externalVariantGeometryFetchIds?: number[];
     externalVariantDeltaOnly?: boolean;
+    cacheDocument?: boolean;
 }
 export interface GeoPrepareGrantMessage {
     type: 'grant';

package/dist/render-resource/cad-render-node.d.ts

@@ -41,6 +41,10 @@ export interface CadInsertVisibilityChange {
     readonly insertId: string;
     readonly visible: boolean;
 }
+export interface CadLayerVisibilityChange {
+    readonly layerIndex: number;
+    readonly visible: boolean;
+}
 /**
  * Read-only CAD render resource. Editing methods belong to legacy GeoNode and
  * must not appear on this type.
@@ -54,6 +58,11 @@ export interface CadRenderNode {
     appendContent(chunk: CadRenderContentChunk): boolean;
     setDisplayContext(context: CadDisplayContext): void;
     setLayerVisible(layerIndex: number, visible: boolean): void;
+    /**
+     * Applies layer visibility changes as one render-resource transaction. This
+     * avoids rebuilding the viewport INSERT presenter once per changed layer.
+     */
+    setLayerVisibleBatch(changes: ReadonlyArray<CadLayerVisibilityChange>): void;
     setLayerColorOverride(layerIndex: number, color: number | null): void;
     setInsertVisible(insertId: string, visible: boolean): void;
     /**

package/dist/session/cad-document-session.d.ts

@@ -1,5 +1,5 @@
 import type { CadInsertDetails, CadInsertSelectionId } from '../selection/cad-insert-selection';
-import type { CadTextSelection } from '../selection/cad-text-selection';
+import type { CadTextDetails, CadTextSelection, CadTextSelectionId } from '../selection/cad-text-selection';
 import type { ResolveTextFont } from '../shared/text-font';
 import type { CadTextWarmupOptions } from './cad-text-warmup';
 import type { ViewportRect } from '../core';
@@ -31,6 +31,11 @@ export interface CadLayerMeta {
     readonly color: readonly [number, number, number];
     readonly visible: boolean;
 }
+/** Source units carried by a generated CAD pack when available. */
+export interface CadDocumentUnits {
+    readonly source: string;
+    readonly scaleToMeters?: number;
+}
 export interface CadVisibilityFilter {
     readonly layerVisible?: ReadonlyMap<number, boolean> | ((layerIndex: number) => boolean);
     readonly insertVisible?: ReadonlySet<string> | ((insertId: string) => boolean);
@@ -61,6 +66,7 @@ export interface CadDocumentHeader {
     readonly sourceFingerprint: string;
     readonly format: string;
     readonly filename: string | null;
+    readonly units?: CadDocumentUnits;
 }
 export interface CadInsertSelection {
     readonly documentKey: string | null;
@@ -154,6 +160,7 @@ export interface CadDocumentSession {
     getLayers(): readonly CadLayerMeta[];
     listInsertUsages(): readonly CadInsertUsageSummary[];
     getBlockDetails(id: string): CadInsertDetails | null;
+    getTextDetails?(id: CadTextSelectionId): CadTextDetails | null;
     pickInsertAtPoint(point: CadWorldPoint, viewport: ViewportRect): CadInsertSelection | null;
     /** Optional for compatibility with pre-text-picking session adapters. */
     pickTextAtPoint?(point: CadWorldPoint): CadTextSelection | null;

package/dist/shared/text-builder.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Options accepted by Troika's global text builder configuration.
+ *
+ * This is intentionally a thin public surface over Troika. The configuration
+ * remains global to the module instance and must be supplied before the first
+ * font request. No defaults are applied here so an omitted configuration keeps
+ * Troika's original built-in behavior unchanged.
+ */
+export interface CadTextBuilderOptions {
+    readonly defaultFontURL?: string;
+    readonly unicodeFontsURL?: string;
+    readonly sdfGlyphSize?: number;
+    readonly sdfMargin?: number;
+    readonly sdfExponent?: number;
+    readonly textureWidth?: number;
+    readonly useWorker?: boolean;
+}
+/**
+ * Configures the Troika text builder used by cad-loader.
+ *
+ * This function deliberately does not add its own lifecycle, retry, fallback,
+ * or per-viewer state. Troika remains responsible for its existing
+ * module-level, one-time configuration semantics.
+ */
+export declare function configureCadTextBuilder(options: CadTextBuilderOptions): void;