ducjs 2.3.0 → 3.0.0

package/README.md

@@ -13,7 +13,7 @@
 
 # ducjs
 
-The `ducjs` package offers comprehensive TypeScript types and helper functions to work effortlessly with the `duc` CAD file format. Built with Flatbuffers and optimized for performance, this package enables you to parse, validate, and manipulate `duc` files with ease.
+The `ducjs` package offers comprehensive TypeScript types and helper functions to work effortlessly with the `duc` CAD file format. Built with SQLite and optimized for performance, this package enables you to parse, validate, and manipulate `duc` files with ease.
 
 ## Documentation
 
@@ -39,4 +39,4 @@ To ensure smooth releases with semantic-release, please follow [these guidelines
 
 ---
 
-*The duc format and libraries are constantly evolving, aiming to set new standards in the 2D CAD industry. Be a part of this transformation and help shape the future of design technology!*
+*The duc format and libraries are constantly evolving, aiming to set new standards in the 2D CAD industry. Be a part of this transformation and help shape the future of design technology!*

package/dist/enums.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Native enum definitions for DUC types.
+ * Source of truth: duc.sql
+ */
+export declare enum VERTICAL_ALIGN {
+    TOP = 10,
+    MIDDLE = 11,
+    BOTTOM = 12
+}
+export declare enum TEXT_ALIGN {
+    LEFT = 10,
+    CENTER = 11,
+    RIGHT = 12
+}
+export declare enum LINE_SPACING_TYPE {
+    AT_LEAST = 10,
+    EXACTLY = 11,
+    MULTIPLE = 12
+}
+export declare enum STROKE_PLACEMENT {
+    INSIDE = 10,
+    CENTER = 11,
+    OUTSIDE = 12
+}
+export declare enum STROKE_PREFERENCE {
+    SOLID = 10,
+    DASHED = 11,
+    DOTTED = 12,
+    CUSTOM = 13
+}
+export declare enum STROKE_SIDE_PREFERENCE {
+    TOP = 10,
+    BOTTOM = 11,
+    LEFT = 12,
+    RIGHT = 13,
+    CUSTOM = 14,
+    ALL = 15
+}
+export declare enum STROKE_CAP {
+    BUTT = 10,
+    ROUND = 11,
+    SQUARE = 12
+}
+export declare enum STROKE_JOIN {
+    MITER = 10,
+    ROUND = 11,
+    BEVEL = 12
+}
+export declare enum LINE_HEAD {
+    ARROW = 10,
+    BAR = 11,
+    CIRCLE = 12,
+    CIRCLE_OUTLINED = 13,
+    TRIANGLE = 14,
+    TRIANGLE_OUTLINED = 15,
+    DIAMOND = 16,
+    DIAMOND_OUTLINED = 17,
+    CROSS = 18,
+    OPEN_ARROW = 19,
+    REVERSED_ARROW = 20,
+    REVERSED_TRIANGLE = 21,
+    REVERSED_TRIANGLE_OUTLINED = 22,
+    CONE = 23,
+    HALF_CONE = 24
+}
+export declare enum BEZIER_MIRRORING {
+    NONE = 10,
+    ANGLE = 11,
+    ANGLE_LENGTH = 12
+}
+export declare enum BLENDING {
+    MULTIPLY = 11,
+    SCREEN = 12,
+    OVERLAY = 13,
+    DARKEN = 14,
+    LIGHTEN = 15,
+    DIFFERENCE = 16,
+    EXCLUSION = 17
+}
+export declare enum ELEMENT_CONTENT_PREFERENCE {
+    SOLID = 12,
+    FILL = 14,
+    FIT = 15,
+    TILE = 16,
+    STRETCH = 17,
+    HATCH = 18
+}
+export declare enum HATCH_STYLE {
+    NORMAL = 10,
+    OUTER = 11,
+    IGNORE = 12
+}
+export declare enum IMAGE_STATUS {
+    PENDING = 10,
+    SAVED = 11,
+    ERROR = 12
+}
+export declare enum PRUNING_LEVEL {
+    CONSERVATIVE = 10,
+    BALANCED = 20,
+    AGGRESSIVE = 30
+}
+export declare enum BOOLEAN_OPERATION {
+    UNION = 10,
+    SUBTRACT = 11,
+    INTERSECT = 12,
+    EXCLUDE = 13
+}
+export declare enum YOUTUBE_STATES {
+    /** The YouTube player is unstarted. */
+    UNSTARTED = -1,
+    /** The YouTube player has ended. */
+    ENDED = 0,
+    /** The YouTube player is currently playing. */
+    PLAYING = 1,
+    /** The YouTube player is paused. */
+    PAUSED = 2,
+    /** The YouTube player is buffering. */
+    BUFFERING = 3,
+    /** The YouTube player is cued. */
+    CUED = 5
+}
+export declare enum HANDLE_TYPE {
+    HANDLE_IN = 10,
+    HANDLE_OUT = 11
+}
+export declare enum UNIT_SYSTEM {
+    METRIC = 10,
+    IMPERIAL = 11
+}
+export declare enum AXIS {
+    X = 10,
+    Y = 20,
+    Z = 30
+}

package/dist/enums.js

@@ -0,0 +1,155 @@
+/**
+ * Native enum definitions for DUC types.
+ * Source of truth: duc.sql
+ */
+export var VERTICAL_ALIGN;
+(function (VERTICAL_ALIGN) {
+    VERTICAL_ALIGN[VERTICAL_ALIGN["TOP"] = 10] = "TOP";
+    VERTICAL_ALIGN[VERTICAL_ALIGN["MIDDLE"] = 11] = "MIDDLE";
+    VERTICAL_ALIGN[VERTICAL_ALIGN["BOTTOM"] = 12] = "BOTTOM";
+})(VERTICAL_ALIGN || (VERTICAL_ALIGN = {}));
+export var TEXT_ALIGN;
+(function (TEXT_ALIGN) {
+    TEXT_ALIGN[TEXT_ALIGN["LEFT"] = 10] = "LEFT";
+    TEXT_ALIGN[TEXT_ALIGN["CENTER"] = 11] = "CENTER";
+    TEXT_ALIGN[TEXT_ALIGN["RIGHT"] = 12] = "RIGHT";
+})(TEXT_ALIGN || (TEXT_ALIGN = {}));
+export var LINE_SPACING_TYPE;
+(function (LINE_SPACING_TYPE) {
+    LINE_SPACING_TYPE[LINE_SPACING_TYPE["AT_LEAST"] = 10] = "AT_LEAST";
+    LINE_SPACING_TYPE[LINE_SPACING_TYPE["EXACTLY"] = 11] = "EXACTLY";
+    LINE_SPACING_TYPE[LINE_SPACING_TYPE["MULTIPLE"] = 12] = "MULTIPLE";
+})(LINE_SPACING_TYPE || (LINE_SPACING_TYPE = {}));
+export var STROKE_PLACEMENT;
+(function (STROKE_PLACEMENT) {
+    STROKE_PLACEMENT[STROKE_PLACEMENT["INSIDE"] = 10] = "INSIDE";
+    STROKE_PLACEMENT[STROKE_PLACEMENT["CENTER"] = 11] = "CENTER";
+    STROKE_PLACEMENT[STROKE_PLACEMENT["OUTSIDE"] = 12] = "OUTSIDE";
+})(STROKE_PLACEMENT || (STROKE_PLACEMENT = {}));
+export var STROKE_PREFERENCE;
+(function (STROKE_PREFERENCE) {
+    STROKE_PREFERENCE[STROKE_PREFERENCE["SOLID"] = 10] = "SOLID";
+    STROKE_PREFERENCE[STROKE_PREFERENCE["DASHED"] = 11] = "DASHED";
+    STROKE_PREFERENCE[STROKE_PREFERENCE["DOTTED"] = 12] = "DOTTED";
+    STROKE_PREFERENCE[STROKE_PREFERENCE["CUSTOM"] = 13] = "CUSTOM";
+})(STROKE_PREFERENCE || (STROKE_PREFERENCE = {}));
+export var STROKE_SIDE_PREFERENCE;
+(function (STROKE_SIDE_PREFERENCE) {
+    STROKE_SIDE_PREFERENCE[STROKE_SIDE_PREFERENCE["TOP"] = 10] = "TOP";
+    STROKE_SIDE_PREFERENCE[STROKE_SIDE_PREFERENCE["BOTTOM"] = 11] = "BOTTOM";
+    STROKE_SIDE_PREFERENCE[STROKE_SIDE_PREFERENCE["LEFT"] = 12] = "LEFT";
+    STROKE_SIDE_PREFERENCE[STROKE_SIDE_PREFERENCE["RIGHT"] = 13] = "RIGHT";
+    STROKE_SIDE_PREFERENCE[STROKE_SIDE_PREFERENCE["CUSTOM"] = 14] = "CUSTOM";
+    STROKE_SIDE_PREFERENCE[STROKE_SIDE_PREFERENCE["ALL"] = 15] = "ALL";
+})(STROKE_SIDE_PREFERENCE || (STROKE_SIDE_PREFERENCE = {}));
+export var STROKE_CAP;
+(function (STROKE_CAP) {
+    STROKE_CAP[STROKE_CAP["BUTT"] = 10] = "BUTT";
+    STROKE_CAP[STROKE_CAP["ROUND"] = 11] = "ROUND";
+    STROKE_CAP[STROKE_CAP["SQUARE"] = 12] = "SQUARE";
+})(STROKE_CAP || (STROKE_CAP = {}));
+export var STROKE_JOIN;
+(function (STROKE_JOIN) {
+    STROKE_JOIN[STROKE_JOIN["MITER"] = 10] = "MITER";
+    STROKE_JOIN[STROKE_JOIN["ROUND"] = 11] = "ROUND";
+    STROKE_JOIN[STROKE_JOIN["BEVEL"] = 12] = "BEVEL";
+})(STROKE_JOIN || (STROKE_JOIN = {}));
+export var LINE_HEAD;
+(function (LINE_HEAD) {
+    LINE_HEAD[LINE_HEAD["ARROW"] = 10] = "ARROW";
+    LINE_HEAD[LINE_HEAD["BAR"] = 11] = "BAR";
+    LINE_HEAD[LINE_HEAD["CIRCLE"] = 12] = "CIRCLE";
+    LINE_HEAD[LINE_HEAD["CIRCLE_OUTLINED"] = 13] = "CIRCLE_OUTLINED";
+    LINE_HEAD[LINE_HEAD["TRIANGLE"] = 14] = "TRIANGLE";
+    LINE_HEAD[LINE_HEAD["TRIANGLE_OUTLINED"] = 15] = "TRIANGLE_OUTLINED";
+    LINE_HEAD[LINE_HEAD["DIAMOND"] = 16] = "DIAMOND";
+    LINE_HEAD[LINE_HEAD["DIAMOND_OUTLINED"] = 17] = "DIAMOND_OUTLINED";
+    LINE_HEAD[LINE_HEAD["CROSS"] = 18] = "CROSS";
+    LINE_HEAD[LINE_HEAD["OPEN_ARROW"] = 19] = "OPEN_ARROW";
+    LINE_HEAD[LINE_HEAD["REVERSED_ARROW"] = 20] = "REVERSED_ARROW";
+    LINE_HEAD[LINE_HEAD["REVERSED_TRIANGLE"] = 21] = "REVERSED_TRIANGLE";
+    LINE_HEAD[LINE_HEAD["REVERSED_TRIANGLE_OUTLINED"] = 22] = "REVERSED_TRIANGLE_OUTLINED";
+    LINE_HEAD[LINE_HEAD["CONE"] = 23] = "CONE";
+    LINE_HEAD[LINE_HEAD["HALF_CONE"] = 24] = "HALF_CONE";
+})(LINE_HEAD || (LINE_HEAD = {}));
+export var BEZIER_MIRRORING;
+(function (BEZIER_MIRRORING) {
+    BEZIER_MIRRORING[BEZIER_MIRRORING["NONE"] = 10] = "NONE";
+    BEZIER_MIRRORING[BEZIER_MIRRORING["ANGLE"] = 11] = "ANGLE";
+    BEZIER_MIRRORING[BEZIER_MIRRORING["ANGLE_LENGTH"] = 12] = "ANGLE_LENGTH";
+})(BEZIER_MIRRORING || (BEZIER_MIRRORING = {}));
+export var BLENDING;
+(function (BLENDING) {
+    BLENDING[BLENDING["MULTIPLY"] = 11] = "MULTIPLY";
+    BLENDING[BLENDING["SCREEN"] = 12] = "SCREEN";
+    BLENDING[BLENDING["OVERLAY"] = 13] = "OVERLAY";
+    BLENDING[BLENDING["DARKEN"] = 14] = "DARKEN";
+    BLENDING[BLENDING["LIGHTEN"] = 15] = "LIGHTEN";
+    BLENDING[BLENDING["DIFFERENCE"] = 16] = "DIFFERENCE";
+    BLENDING[BLENDING["EXCLUSION"] = 17] = "EXCLUSION";
+})(BLENDING || (BLENDING = {}));
+export var ELEMENT_CONTENT_PREFERENCE;
+(function (ELEMENT_CONTENT_PREFERENCE) {
+    ELEMENT_CONTENT_PREFERENCE[ELEMENT_CONTENT_PREFERENCE["SOLID"] = 12] = "SOLID";
+    ELEMENT_CONTENT_PREFERENCE[ELEMENT_CONTENT_PREFERENCE["FILL"] = 14] = "FILL";
+    ELEMENT_CONTENT_PREFERENCE[ELEMENT_CONTENT_PREFERENCE["FIT"] = 15] = "FIT";
+    ELEMENT_CONTENT_PREFERENCE[ELEMENT_CONTENT_PREFERENCE["TILE"] = 16] = "TILE";
+    ELEMENT_CONTENT_PREFERENCE[ELEMENT_CONTENT_PREFERENCE["STRETCH"] = 17] = "STRETCH";
+    ELEMENT_CONTENT_PREFERENCE[ELEMENT_CONTENT_PREFERENCE["HATCH"] = 18] = "HATCH";
+})(ELEMENT_CONTENT_PREFERENCE || (ELEMENT_CONTENT_PREFERENCE = {}));
+export var HATCH_STYLE;
+(function (HATCH_STYLE) {
+    HATCH_STYLE[HATCH_STYLE["NORMAL"] = 10] = "NORMAL";
+    HATCH_STYLE[HATCH_STYLE["OUTER"] = 11] = "OUTER";
+    HATCH_STYLE[HATCH_STYLE["IGNORE"] = 12] = "IGNORE";
+})(HATCH_STYLE || (HATCH_STYLE = {}));
+export var IMAGE_STATUS;
+(function (IMAGE_STATUS) {
+    IMAGE_STATUS[IMAGE_STATUS["PENDING"] = 10] = "PENDING";
+    IMAGE_STATUS[IMAGE_STATUS["SAVED"] = 11] = "SAVED";
+    IMAGE_STATUS[IMAGE_STATUS["ERROR"] = 12] = "ERROR";
+})(IMAGE_STATUS || (IMAGE_STATUS = {}));
+export var PRUNING_LEVEL;
+(function (PRUNING_LEVEL) {
+    PRUNING_LEVEL[PRUNING_LEVEL["CONSERVATIVE"] = 10] = "CONSERVATIVE";
+    PRUNING_LEVEL[PRUNING_LEVEL["BALANCED"] = 20] = "BALANCED";
+    PRUNING_LEVEL[PRUNING_LEVEL["AGGRESSIVE"] = 30] = "AGGRESSIVE";
+})(PRUNING_LEVEL || (PRUNING_LEVEL = {}));
+export var BOOLEAN_OPERATION;
+(function (BOOLEAN_OPERATION) {
+    BOOLEAN_OPERATION[BOOLEAN_OPERATION["UNION"] = 10] = "UNION";
+    BOOLEAN_OPERATION[BOOLEAN_OPERATION["SUBTRACT"] = 11] = "SUBTRACT";
+    BOOLEAN_OPERATION[BOOLEAN_OPERATION["INTERSECT"] = 12] = "INTERSECT";
+    BOOLEAN_OPERATION[BOOLEAN_OPERATION["EXCLUDE"] = 13] = "EXCLUDE";
+})(BOOLEAN_OPERATION || (BOOLEAN_OPERATION = {}));
+export var YOUTUBE_STATES;
+(function (YOUTUBE_STATES) {
+    /** The YouTube player is unstarted. */
+    YOUTUBE_STATES[YOUTUBE_STATES["UNSTARTED"] = -1] = "UNSTARTED";
+    /** The YouTube player has ended. */
+    YOUTUBE_STATES[YOUTUBE_STATES["ENDED"] = 0] = "ENDED";
+    /** The YouTube player is currently playing. */
+    YOUTUBE_STATES[YOUTUBE_STATES["PLAYING"] = 1] = "PLAYING";
+    /** The YouTube player is paused. */
+    YOUTUBE_STATES[YOUTUBE_STATES["PAUSED"] = 2] = "PAUSED";
+    /** The YouTube player is buffering. */
+    YOUTUBE_STATES[YOUTUBE_STATES["BUFFERING"] = 3] = "BUFFERING";
+    /** The YouTube player is cued. */
+    YOUTUBE_STATES[YOUTUBE_STATES["CUED"] = 5] = "CUED";
+})(YOUTUBE_STATES || (YOUTUBE_STATES = {}));
+export var HANDLE_TYPE;
+(function (HANDLE_TYPE) {
+    HANDLE_TYPE[HANDLE_TYPE["HANDLE_IN"] = 10] = "HANDLE_IN";
+    HANDLE_TYPE[HANDLE_TYPE["HANDLE_OUT"] = 11] = "HANDLE_OUT";
+})(HANDLE_TYPE || (HANDLE_TYPE = {}));
+export var UNIT_SYSTEM;
+(function (UNIT_SYSTEM) {
+    UNIT_SYSTEM[UNIT_SYSTEM["METRIC"] = 10] = "METRIC";
+    UNIT_SYSTEM[UNIT_SYSTEM["IMPERIAL"] = 11] = "IMPERIAL";
+})(UNIT_SYSTEM || (UNIT_SYSTEM = {}));
+export var AXIS;
+(function (AXIS) {
+    AXIS[AXIS["X"] = 10] = "X";
+    AXIS[AXIS["Y"] = 20] = "Y";
+    AXIS[AXIS["Z"] = 30] = "Z";
+})(AXIS || (AXIS = {}));

package/dist/index.d.ts

@@ -1,7 +1,11 @@
-export * as DucBin from "./flatbuffers/duc";
-export * from "./types";
-export * from "./utils";
-export * from "./serialize";
+export * from "./enums";
+export * from "./lazy-files";
 export * from "./parse";
 export * from "./restore";
+export * from "./serialize";
 export * from "./technical";
+export * from "./transform";
+export * from "./types";
+export * from "./utils";
+export * as vc from "./version-control";
+export { ensureWasm, getWasmBinary } from "./wasm";

package/dist/index.js

@@ -1,7 +1,11 @@
-export * as DucBin from "./flatbuffers/duc";
-export * from "./types";
-export * from "./utils";
-export * from "./serialize";
+export * from "./enums";
+export * from "./lazy-files";
 export * from "./parse";
 export * from "./restore";
+export * from "./serialize";
 export * from "./technical";
+export * from "./transform";
+export * from "./types";
+export * from "./utils";
+export * as vc from "./version-control";
+export { ensureWasm, getWasmBinary } from "./wasm";

package/dist/lazy-files.d.ts

@@ -0,0 +1,44 @@
+import type { DucExternalFileData, DucExternalFiles } from "./types";
+export type LazyFileMetadata = {
+    id: string;
+    mimeType: string;
+    created: number;
+    lastRetrieved?: number;
+    version?: number;
+};
+/**
+ * Provides lazy access to external files embedded inside a `.duc` buffer.
+ *
+ * Instead of loading all file blobs into memory at parse time, this store
+ * keeps a reference to the raw `.duc` buffer and fetches individual files
+ * on demand via WASM calls.
+ */
+export declare class LazyExternalFileStore {
+    private buffer;
+    private metadataCache;
+    private runtimeFiles;
+    constructor(buffer: Uint8Array);
+    get isReleased(): boolean;
+    get size(): number;
+    /** Check if a file with this ID exists. */
+    has(fileId: string): boolean;
+    /** Get metadata (without data blob) for a specific file. */
+    getMetadata(fileId: string): LazyFileMetadata | undefined;
+    /** Get metadata for all files. */
+    getAllMetadata(): LazyFileMetadata[];
+    /** Fetch the full file data (including blob) for a specific file. */
+    getFileData(fileId: string): DucExternalFileData | null;
+    /** Fetch file data and return a copy of the data buffer (safe for transfer). */
+    getFileDataCopy(fileId: string): DucExternalFileData | null;
+    /** Add a file at runtime (not persisted in .duc until next serialize). */
+    addRuntimeFile(fileId: string, data: DucExternalFileData): void;
+    /** Remove a runtime file. */
+    removeRuntimeFile(fileId: string): boolean;
+    /** Export all files eagerly as a DucExternalFiles record. */
+    toExternalFiles(): DucExternalFiles;
+    /** Merge files from another source (only adds missing). */
+    mergeFiles(files: DucExternalFiles): void;
+    /** Release the underlying buffer to free memory. */
+    release(): void;
+    private getMetadataMap;
+}

package/dist/lazy-files.js

@@ -0,0 +1,129 @@
+import { wasmGetExternalFile, wasmListExternalFiles } from "./wasm";
+/**
+ * Provides lazy access to external files embedded inside a `.duc` buffer.
+ *
+ * Instead of loading all file blobs into memory at parse time, this store
+ * keeps a reference to the raw `.duc` buffer and fetches individual files
+ * on demand via WASM calls.
+ */
+export class LazyExternalFileStore {
+    constructor(buffer) {
+        this.metadataCache = null;
+        this.runtimeFiles = new Map();
+        this.buffer = buffer;
+    }
+    get isReleased() {
+        return this.buffer === null;
+    }
+    get size() {
+        return this.getMetadataMap().size + this.runtimeFiles.size;
+    }
+    /** Check if a file with this ID exists. */
+    has(fileId) {
+        return this.runtimeFiles.has(fileId) || this.getMetadataMap().has(fileId);
+    }
+    /** Get metadata (without data blob) for a specific file. */
+    getMetadata(fileId) {
+        const rt = this.runtimeFiles.get(fileId);
+        if (rt) {
+            return {
+                id: rt.id,
+                mimeType: rt.mimeType,
+                created: rt.created,
+                lastRetrieved: rt.lastRetrieved,
+                version: rt.version,
+            };
+        }
+        return this.getMetadataMap().get(fileId);
+    }
+    /** Get metadata for all files. */
+    getAllMetadata() {
+        const result = [];
+        for (const meta of this.getMetadataMap().values()) {
+            result.push(meta);
+        }
+        for (const [id, data] of this.runtimeFiles) {
+            if (!this.getMetadataMap().has(id)) {
+                result.push({
+                    id: data.id,
+                    mimeType: data.mimeType,
+                    created: data.created,
+                    lastRetrieved: data.lastRetrieved,
+                    version: data.version,
+                });
+            }
+        }
+        return result;
+    }
+    /** Fetch the full file data (including blob) for a specific file. */
+    getFileData(fileId) {
+        const rt = this.runtimeFiles.get(fileId);
+        if (rt)
+            return rt;
+        if (!this.buffer)
+            return null;
+        const result = wasmGetExternalFile(this.buffer, fileId);
+        if (!result)
+            return null;
+        return result;
+    }
+    /** Fetch file data and return a copy of the data buffer (safe for transfer). */
+    getFileDataCopy(fileId) {
+        const data = this.getFileData(fileId);
+        if (!data)
+            return null;
+        return Object.assign(Object.assign({}, data), { data: new Uint8Array(data.data) });
+    }
+    /** Add a file at runtime (not persisted in .duc until next serialize). */
+    addRuntimeFile(fileId, data) {
+        this.runtimeFiles.set(fileId, data);
+    }
+    /** Remove a runtime file. */
+    removeRuntimeFile(fileId) {
+        return this.runtimeFiles.delete(fileId);
+    }
+    /** Export all files eagerly as a DucExternalFiles record. */
+    toExternalFiles() {
+        const result = {};
+        if (this.buffer) {
+            const metas = this.getMetadataMap();
+            for (const [id] of metas) {
+                const data = this.getFileData(id);
+                if (data) {
+                    result[id] = data;
+                }
+            }
+        }
+        for (const [id, data] of this.runtimeFiles) {
+            result[id] = data;
+        }
+        return result;
+    }
+    /** Merge files from another source (only adds missing). */
+    mergeFiles(files) {
+        for (const [id, data] of Object.entries(files)) {
+            if (!this.has(id)) {
+                this.runtimeFiles.set(id, data);
+            }
+        }
+    }
+    /** Release the underlying buffer to free memory. */
+    release() {
+        this.buffer = null;
+        this.metadataCache = null;
+    }
+    getMetadataMap() {
+        if (!this.metadataCache) {
+            this.metadataCache = new Map();
+            if (this.buffer) {
+                const metas = wasmListExternalFiles(this.buffer);
+                if (metas) {
+                    for (const meta of metas) {
+                        this.metadataCache.set(meta.id, meta);
+                    }
+                }
+            }
+        }
+        return this.metadataCache;
+    }
+}

package/dist/parse.d.ts

@@ -1,55 +1,21 @@
-import { FileSystemHandle } from 'browser-fs-access';
-import { CustomHatchPattern as CustomHatchPatternFb, DimensionToleranceStyle as DimensionToleranceStyleFb, DucBlock as DucBlockFb, DucDimensionStyle as DucDimensionStyleFb, DucDocStyle as DucDocStyleFb, DucExternalFileEntry, DucFeatureControlFrameStyle as DucFeatureControlFrameStyleFb, DucGlobalState as DucGlobalStateFb, DucGroup as DucGroupFb, DucHatchStyle as DucHatchStyleFb, DucHead as DucHeadFb, DucImageFilter as DucImageFilterFb, DucLayer as DucLayerFb, DucLeaderStyle as DucLeaderStyleFb, DucLine as DucLineFb, DucLineReference as DucLineReferenceFb, DucLocalState as DucLocalStateFb, DucPath as DucPathFb, DucPlotStyle as DucPlotStyleFb, DucPointBinding as DucPointBindingFb, DucPoint as DucPointFb, DucRegion as DucRegionFb, DucStackLikeStyles as DucStackLikeStylesFb, DucTableCellStyle as DucTableCellStyleFb, DucTableStyle as DucTableStyleFb, DucTextStyle as DucTextStyleFb, DucViewportStyle as DucViewportStyleFb, DucXRayStyle as DucXRayStyleFb, DocumentGridConfig as DocumentGridConfigFb, ElementBackground as ElementBackgroundFb, ElementContentBase as ElementContentBaseFb, ElementStroke as ElementStrokeFb, ElementWrapper, ExportedDataState as ExportedDataStateFb, GeometricPoint as GeometricPointFb, HatchPatternLine as HatchPatternLineFb, Margins as MarginsFb, PrimaryUnits as PrimaryUnitsFb, Standard as StandardFb, StrokeSides as StrokeSidesFb, StrokeStyle as StrokeStyleFb, TilingProperties as TilingPropertiesFb, VersionGraph as VersionGraphFb, _DucElementBase as _DucElementBaseFb, _DucElementStylesBase as _DucElementStylesBaseFb, _DucLinearElementBase as _DucLinearElementBaseFb, _DucStackBase as _DucStackBaseFb, _DucStackElementBase as _DucStackElementBaseFb } from "./flatbuffers/duc";
-import { RestoreConfig, RestoredDataState } from "./restore";
-import { Standard, StandardUnits } from "./technical";
-import { CustomHatchPattern, Dictionary, DocumentGridConfig, DucBlock, DucDimensionStyle, DucDocStyle, DucElement, DucExternalFiles, DucFeatureControlFrameStyle, DucGlobalState, DucGroup, DucHatchStyle, DucHead, DucImageFilter, DucLayer, DucLeaderStyle, DucLine, DucLineReference, DucLocalState, DucPath, DucPlotStyle, DucPoint, DucPointBinding, DucRegion, DucStackLikeStyles, DucTableCellStyle, DucTableStyle, DucTextStyle, DucViewportStyle, DucXRayStyle, ElementBackground, ElementContentBase, ElementStroke, GeometricPoint, HatchPatternLine, PlotLayout, StrokeSides, StrokeStyle, TilingProperties, VersionGraph, _DucElementBase, _DucElementStylesBase, _DucLinearElementBase, _DucStackBase, _DucStackElementBase } from "./types";
-export declare function parseGeometricPoint(point: GeometricPointFb): GeometricPoint;
-export declare function parsePoint(point: DucPointFb): DucPoint;
-export declare function parseMargins(margins: MarginsFb): PlotLayout["margins"];
-export declare function parseDocumentGridConfig(gridConfig: DocumentGridConfigFb): DocumentGridConfig;
-export declare function parseHead(head: DucHeadFb): DucHead;
-export declare function parseHatchPatternLine(line: HatchPatternLineFb): HatchPatternLine;
-export declare function parseCustomHatchPattern(pattern: CustomHatchPatternFb): CustomHatchPattern;
-export declare function parseHatchStyle(hatch: DucHatchStyleFb): DucHatchStyle;
-export declare function parseTilingProperties(tiling: TilingPropertiesFb): TilingProperties;
-export declare function parseImageFilter(filter: DucImageFilterFb): DucImageFilter;
-export declare function parseElementContentBase(content: ElementContentBaseFb): ElementContentBase;
-export declare function parseStrokeStyle(style: StrokeStyleFb): StrokeStyle;
-export declare function parseStrokeSides(sides: StrokeSidesFb): StrokeSides;
-export declare function parseElementStroke(stroke: ElementStrokeFb): ElementStroke;
-export declare function parseElementBackground(background: ElementBackgroundFb): ElementBackground;
-export declare function parseElementStylesBase(styles: _DucElementStylesBaseFb): _DucElementStylesBase;
-export declare function parseElementBase(base: _DucElementBaseFb): _DucElementBase;
-export declare function parseLineReference(ref: DucLineReferenceFb): DucLineReference;
-export declare function parseLine(line: DucLineFb): DucLine;
-export declare function parsePath(path: DucPathFb): DucPath;
-export declare function parsePointBinding(binding: DucPointBindingFb): DucPointBinding;
-export declare function parseLinearElementBase(base: _DucLinearElementBaseFb): _DucLinearElementBase;
-export declare function parseStackLikeStyles(styles: DucStackLikeStylesFb): DucStackLikeStyles;
-export declare function parseStackBase(base: _DucStackBaseFb): _DucStackBase;
-export declare function parseStackElementBase(base: _DucStackElementBaseFb): _DucStackElementBase;
-export declare function parseTextStyle(style: DucTextStyleFb): DucTextStyle;
-export declare function parseTableCellStyle(style: DucTableCellStyleFb): DucTableCellStyle;
-export declare function parseTableStyle(style: DucTableStyleFb): DucTableStyle;
-export declare function parsePlotStyle(style: DucPlotStyleFb): DucPlotStyle;
-export declare function parseViewportStyle(style: DucViewportStyleFb): DucViewportStyle;
-export declare function parseXRayStyle(style: DucXRayStyleFb): DucXRayStyle;
-export declare function parseLeaderStyle(style: DucLeaderStyleFb): DucLeaderStyle;
-export declare function parseDimensionToleranceStyle(style: DimensionToleranceStyleFb): DucDimensionStyle["tolerance"];
-export declare function parseDimensionStyle(style: DucDimensionStyleFb): DucDimensionStyle;
-export declare function parseFeatureControlFrameStyle(style: DucFeatureControlFrameStyleFb): DucFeatureControlFrameStyle;
-export declare function parseDocStyle(style: DucDocStyleFb): DucDocStyle;
-export declare function parseElementFromBinary(wrapper: ElementWrapper): DucElement | null;
-export declare function parseBlockFromBinary(block: DucBlockFb): DucBlock;
-export declare function parseDictionaryFromBinary(data: ExportedDataStateFb): Dictionary;
-export declare function parseExternalFilesFromBinary(entry: DucExternalFileEntry): DucExternalFiles;
-export declare function parseGlobalStateFromBinary(state: DucGlobalStateFb): DucGlobalState;
-export declare function parseGroupFromBinary(group: DucGroupFb): DucGroup;
-export declare function parseLayerFromBinary(layer: DucLayerFb): DucLayer;
-export declare function parseLocalStateFromBinary(state: DucLocalStateFb): DucLocalState;
-export declare function parseRegionFromBinary(region: DucRegionFb): DucRegion;
-export declare function parsePrimaryUnits(units: PrimaryUnitsFb): StandardUnits["primaryUnits"];
-export declare function parseStandardFromBinary(standard: StandardFb): Standard;
-export declare function parseThumbnailFromBinary(data: ExportedDataStateFb): Uint8Array | undefined;
-export declare function parseVersionGraphFromBinary(graph: VersionGraphFb | null): VersionGraph | null;
-export declare const parseDuc: (blob: Blob | File, fileHandle?: FileSystemHandle | null, restoreConfig?: RestoreConfig) => Promise<RestoredDataState>;
+import { type ElementsConfig, type RestoreConfig, type RestoredDataState } from "./restore";
+export type { RestoredDataState };
+export type LazyRestoredDataState = RestoredDataState & {
+    lazyFileStore: LazyExternalFileStore;
+};
+import { LazyExternalFileStore } from "./lazy-files";
+export { LazyExternalFileStore };
+/**
+ * Parse a `.duc` file (Blob/File) into a RestoredDataState.
+ *
+ * 1. Read file bytes
+ * 2. WASM parse (SQLite → Rust → JS via serde-wasm-bindgen)
+ * 3. Element fixups (stack element flattening)
+ * 4. restore() for defaults & migrations
+ */
+export declare function parseDuc(blob: Blob | File, _fileHandle?: FileSystemFileHandle | null, elementsConfig?: ElementsConfig, restoreConfig?: RestoreConfig): Promise<RestoredDataState>;
+/**
+ * Parse a `.duc` file lazily — returns everything EXCEPT external file data blobs.
+ * Use `LazyExternalFileStore` for on-demand file access.
+ */
+export declare function parseDucLazy(buffer: Uint8Array, elementsConfig?: ElementsConfig, restoreConfig?: RestoreConfig): Promise<LazyRestoredDataState>;