ducjs 2.2.2 → 2.3.0

package/dist/flatbuffers/duc/element.js

@@ -13,6 +13,7 @@ import { DucImageElement } from '../duc/duc-image-element';
 import { DucLeaderElement } from '../duc/duc-leader-element';
 import { DucLinearElement } from '../duc/duc-linear-element';
 import { DucMermaidElement } from '../duc/duc-mermaid-element';
+import { DucModelElement } from '../duc/duc-model-element';
 import { DucParametricElement } from '../duc/duc-parametric-element';
 import { DucPdfElement } from '../duc/duc-pdf-element';
 import { DucPlotElement } from '../duc/duc-plot-element';
@@ -47,6 +48,7 @@ export var Element;
     Element[Element["DucFeatureControlFrameElement"] = 20] = "DucFeatureControlFrameElement";
     Element[Element["DucDocElement"] = 21] = "DucDocElement";
     Element[Element["DucParametricElement"] = 22] = "DucParametricElement";
+    Element[Element["DucModelElement"] = 23] = "DucModelElement";
 })(Element || (Element = {}));
 export function unionToElement(type, accessor) {
     switch (Element[type]) {
@@ -73,6 +75,7 @@ export function unionToElement(type, accessor) {
         case 'DucFeatureControlFrameElement': return accessor(new DucFeatureControlFrameElement());
         case 'DucDocElement': return accessor(new DucDocElement());
         case 'DucParametricElement': return accessor(new DucParametricElement());
+        case 'DucModelElement': return accessor(new DucModelElement());
         default: return null;
     }
 }
@@ -101,6 +104,7 @@ export function unionListToElement(type, accessor, index) {
         case 'DucFeatureControlFrameElement': return accessor(index, new DucFeatureControlFrameElement());
         case 'DucDocElement': return accessor(index, new DucDocElement());
         case 'DucParametricElement': return accessor(index, new DucParametricElement());
+        case 'DucModelElement': return accessor(index, new DucModelElement());
         default: return null;
     }
 }

package/dist/flatbuffers/duc.d.ts

@@ -18,6 +18,7 @@ export { DIMENSION_FIT_RULE } from './duc/dimension-fit-rule';
 export { DIMENSION_TEXT_PLACEMENT } from './duc/dimension-text-placement';
 export { DIMENSION_TYPE } from './duc/dimension-type';
 export { DIMENSION_UNITS_FORMAT } from './duc/dimension-units-format';
+export { DOCUMENT_GRID_ALIGN_ITEMS } from './duc/document-grid-align-items';
 export { DatumReference } from './duc/datum-reference';
 export { Delta } from './duc/delta';
 export { DictionaryEntry } from './duc/dictionary-entry';
@@ -31,6 +32,7 @@ export { DimensionLineStyle } from './duc/dimension-line-style';
 export { DimensionSymbolStyle } from './duc/dimension-symbol-style';
 export { DimensionToleranceStyle } from './duc/dimension-tolerance-style';
 export { DimensionValidationRules } from './duc/dimension-validation-rules';
+export { DocumentGridConfig } from './duc/document-grid-config';
 export { DucArrowElement } from './duc/duc-arrow-element';
 export { DucBlock } from './duc/duc-block';
 export { DucBlockAttributeDefinition } from './duc/duc-block-attribute-definition';
@@ -70,6 +72,7 @@ export { DucLineReference } from './duc/duc-line-reference';
 export { DucLinearElement } from './duc/duc-linear-element';
 export { DucLocalState } from './duc/duc-local-state';
 export { DucMermaidElement } from './duc/duc-mermaid-element';
+export { DucModelElement } from './duc/duc-model-element';
 export { DucParametricElement } from './duc/duc-parametric-element';
 export { DucPath } from './duc/duc-path';
 export { DucPdfElement } from './duc/duc-pdf-element';

package/dist/flatbuffers/duc.js

@@ -20,6 +20,7 @@ export { DIMENSION_FIT_RULE } from './duc/dimension-fit-rule';
 export { DIMENSION_TEXT_PLACEMENT } from './duc/dimension-text-placement';
 export { DIMENSION_TYPE } from './duc/dimension-type';
 export { DIMENSION_UNITS_FORMAT } from './duc/dimension-units-format';
+export { DOCUMENT_GRID_ALIGN_ITEMS } from './duc/document-grid-align-items';
 export { DatumReference } from './duc/datum-reference';
 export { Delta } from './duc/delta';
 export { DictionaryEntry } from './duc/dictionary-entry';
@@ -33,6 +34,7 @@ export { DimensionLineStyle } from './duc/dimension-line-style';
 export { DimensionSymbolStyle } from './duc/dimension-symbol-style';
 export { DimensionToleranceStyle } from './duc/dimension-tolerance-style';
 export { DimensionValidationRules } from './duc/dimension-validation-rules';
+export { DocumentGridConfig } from './duc/document-grid-config';
 export { DucArrowElement } from './duc/duc-arrow-element';
 export { DucBlock } from './duc/duc-block';
 export { DucBlockAttributeDefinition } from './duc/duc-block-attribute-definition';
@@ -72,6 +74,7 @@ export { DucLineReference } from './duc/duc-line-reference';
 export { DucLinearElement } from './duc/duc-linear-element';
 export { DucLocalState } from './duc/duc-local-state';
 export { DucMermaidElement } from './duc/duc-mermaid-element';
+export { DucModelElement } from './duc/duc-model-element';
 export { DucParametricElement } from './duc/duc-parametric-element';
 export { DucPath } from './duc/duc-path';
 export { DucPdfElement } from './duc/duc-pdf-element';

package/dist/parse.d.ts

@@ -1,11 +1,12 @@
 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, 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 { 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, 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";
+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;

package/dist/parse.js

@@ -7,10 +7,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { DucArrowElement as DucArrowElementFb, DucDimensionElement as DucDimensionElementFb, DucDocElement as DucDocElementFb, DucEllipseElement as DucEllipseElementFb, DucEmbeddableElement as DucEmbeddableElementFb, DucFeatureControlFrameElement as DucFeatureControlFrameElementFb, DucFrameElement as DucFrameElementFb, DucFreeDrawElement as DucFreeDrawElementFb, DucImageElement as DucImageElementFb, DucLeaderElement as DucLeaderElementFb, DucLinearElement as DucLinearElementFb, DucMermaidElement as DucMermaidElementFb, DucParametricElement as DucParametricElementFb, DucPdfElement as DucPdfElementFb, DucPlotElement as DucPlotElementFb, DucPolygonElement as DucPolygonElementFb, DucRectangleElement as DucRectangleElementFb, DucTableElement as DucTableElementFb, DucTextDynamicDictionarySource as DucTextDynamicDictionarySourceFb, DucTextDynamicElementSource as DucTextDynamicElementSourceFb, DucTextElement as DucTextElementFb, DucViewportElement as DucViewportElementFb, DucXRayElement as DucXRayElementFb, Element as ElementUnion, ExportedDataState, LEADER_CONTENT_TYPE as LEADER_CONTENT_TYPE_ENUM, LeaderBlockContent as LeaderBlockContentFb, LeaderTextBlockContent as LeaderTextBlockContentFb, TEXT_FIELD_SOURCE_TYPE } from "./flatbuffers/duc";
-import { restore } from "./restore";
+import { decompressSync, strFromU8 } from 'fflate';
 import * as flatbuffers from "flatbuffers";
 import { nanoid } from 'nanoid';
+import { DOCUMENT_GRID_ALIGN_ITEMS, DucArrowElement as DucArrowElementFb, DucDimensionElement as DucDimensionElementFb, DucDocElement as DucDocElementFb, DucEllipseElement as DucEllipseElementFb, DucEmbeddableElement as DucEmbeddableElementFb, DucFeatureControlFrameElement as DucFeatureControlFrameElementFb, DucFrameElement as DucFrameElementFb, DucFreeDrawElement as DucFreeDrawElementFb, DucImageElement as DucImageElementFb, DucLeaderElement as DucLeaderElementFb, DucLinearElement as DucLinearElementFb, DucMermaidElement as DucMermaidElementFb, DucModelElement as DucModelElementFb, DucPdfElement as DucPdfElementFb, DucPlotElement as DucPlotElementFb, DucPolygonElement as DucPolygonElementFb, DucRectangleElement as DucRectangleElementFb, DucTableElement as DucTableElementFb, DucTextDynamicDictionarySource as DucTextDynamicDictionarySourceFb, DucTextDynamicElementSource as DucTextDynamicElementSourceFb, DucTextElement as DucTextElementFb, DucViewportElement as DucViewportElementFb, DucXRayElement as DucXRayElementFb, Element as ElementUnion, ExportedDataState, LEADER_CONTENT_TYPE as LEADER_CONTENT_TYPE_ENUM, LeaderBlockContent as LeaderBlockContentFb, LeaderTextBlockContent as LeaderTextBlockContentFb, TEXT_FIELD_SOURCE_TYPE } from "./flatbuffers/duc";
+import { restore } from "./restore";
 // #region HELPERS & LOW-LEVEL CASTS
 // Helper functions for type casting
 const toPrecisionValue = (value) => ({
@@ -24,6 +25,29 @@ const toZoom = (value) => ({
     value: value
 });
 // #endregion
+// Helper function to parse binary JSON data (Uint8Array) to object
+// The data is zlib-compressed JSON (new format) or plain JSON string (legacy format)
+function parseBinaryToJson(binaryData) {
+    if (!binaryData || binaryData.length === 0)
+        return undefined;
+    // Try new format: zlib-compressed binary JSON
+    try {
+        const decompressed = decompressSync(binaryData);
+        const text = strFromU8(decompressed);
+        return JSON.parse(text);
+    }
+    catch (e) {
+        // Fall back to legacy format: plain JSON string (for old file compatibility)
+        try {
+            const text = new TextDecoder().decode(binaryData);
+            return JSON.parse(text);
+        }
+        catch (e2) {
+            console.warn('Failed to parse binary JSON (tried both compressed and legacy formats):', e2);
+            return undefined;
+        }
+    }
+}
 // #region GEOMETRY & UTILITY PARSERS
 export function parseGeometricPoint(point) {
     return {
@@ -46,6 +70,24 @@ export function parseMargins(margins) {
         left: toPrecisionValue(margins.left()),
     };
 }
+export function parseDocumentGridConfig(gridConfig) {
+    return {
+        columns: gridConfig.columns(),
+        gapX: gridConfig.gapX(),
+        gapY: gridConfig.gapY(),
+        alignItems: (() => {
+            const align = gridConfig.alignItems();
+            if (align === DOCUMENT_GRID_ALIGN_ITEMS.START)
+                return 'start';
+            if (align === DOCUMENT_GRID_ALIGN_ITEMS.CENTER)
+                return 'center';
+            if (align === DOCUMENT_GRID_ALIGN_ITEMS.END)
+                return 'end';
+            return 'start';
+        })(),
+        firstPageAlone: gridConfig.firstPageAlone(),
+    };
+}
 export function parseHead(head) {
     return {
         type: head.type(),
@@ -168,7 +210,7 @@ export function parseElementBase(base) {
     return Object.assign({ id: base.id(), x: toPrecisionValue(base.x()), y: toPrecisionValue(base.y()), width: toPrecisionValue(base.width()), height: toPrecisionValue(base.height()), angle: toRadian(base.angle()), scope: base.scope(), label: base.label(), description: base.description(), isVisible: base.isVisible(), seed: base.seed(), version: base.version(), versionNonce: base.versionNonce(), updated: Number(base.updated()), index: base.index(), isPlot: base.isPlot(), isAnnotative: base.isAnnotative(), isDeleted: base.isDeleted(), groupIds: Array.from({ length: base.groupIdsLength() }, (_, i) => base.groupIds(i)), regionIds: Array.from({ length: base.regionIdsLength() }, (_, i) => base.regionIds(i)), blockIds: Array.from({ length: base.blockIdsLength() }, (_, i) => base.blockIds(i)), instanceId: base.instanceId(), layerId: base.layerId(), frameId: base.frameId(), boundElements: base.boundElementsLength() > 0 ? Array.from({ length: base.boundElementsLength() }, (_, i) => ({
             id: base.boundElements(i).id(),
             type: base.boundElements(i).type(),
-        })) : null, zIndex: base.zIndex(), link: base.link(), locked: base.locked(), customData: base.customData() ? JSON.parse(base.customData()) : undefined }, parsedStyles);
+        })) : null, zIndex: base.zIndex(), link: base.link(), locked: base.locked(), customData: parseBinaryToJson(base.customDataArray()) }, parsedStyles);
 }
 export function parseLineReference(ref) {
     return {
@@ -233,7 +275,14 @@ function parseEmbeddableElement(element) {
     return Object.assign({ type: "embeddable" }, parseElementBase(element.base()));
 }
 function parsePdfElement(element) {
-    return Object.assign(Object.assign({ type: "pdf" }, parseElementBase(element.base())), { fileId: element.fileId() });
+    const gridConfig = element.gridConfig();
+    return Object.assign(Object.assign({ type: "pdf" }, parseElementBase(element.base())), { fileId: element.fileId(), gridConfig: gridConfig ? parseDocumentGridConfig(gridConfig) : {
+            columns: 1,
+            gapX: 0,
+            gapY: 0,
+            alignItems: 'start',
+            firstPageAlone: false,
+        } });
 }
 function parseMermaidElement(element) {
     return Object.assign(Object.assign({ type: "mermaid" }, parseElementBase(element.base())), { source: element.source(), theme: element.theme() || undefined, svgPath: element.svgPath() });
@@ -364,25 +413,13 @@ function parseBlockInstance(instance) {
 function parseBlockMetadata(metadataFb) {
     if (!metadataFb)
         return undefined;
-    // localization is a JSON string containing the localization data
-    let localization;
-    const localizationStr = metadataFb.localization();
-    if (localizationStr) {
-        try {
-            localization = JSON.parse(localizationStr);
-        }
-        catch (e) {
-            // If parsing fails, leave localization undefined
-            console.warn('Failed to parse localization JSON:', e);
-        }
-    }
-    return {
-        source: metadataFb.source(),
-        usageCount: metadataFb.usageCount(),
-        createdAt: Number(metadataFb.createdAt()),
-        updatedAt: Number(metadataFb.updatedAt()),
-        localization,
-    };
+    // localization is now binary JSON data (Uint8Array)
+    const localization = parseBinaryToJson(metadataFb.localizationArray());
+    const rawSource = metadataFb.source();
+    const source = typeof rawSource === "string" && rawSource.trim().length
+        ? rawSource.trim()
+        : undefined;
+    return Object.assign(Object.assign({}, (source ? { source } : {})), { usageCount: metadataFb.usageCount(), createdAt: Number(metadataFb.createdAt()), updatedAt: Number(metadataFb.updatedAt()), localization });
 }
 function parseBlockCollection(collection) {
     const children = Array.from({ length: collection.childrenLength() }, (_, i) => {
@@ -533,6 +570,7 @@ function parseDocElement(element) {
         });
     }
     const columns = element.columns();
+    const gridConfig = element.gridConfig();
     return Object.assign(Object.assign(Object.assign({ type: "doc" }, parseElementBase(element.base())), parseDocStyle(element.style())), { text: element.text(), dynamic: dynamicParts, flowDirection: element.flowDirection(), columns: {
             type: columns.type(),
             definitions: Array.from({ length: columns.definitionsLength() }, (_, i) => {
@@ -543,16 +581,17 @@ function parseDocElement(element) {
                 };
             }),
             autoHeight: columns.autoHeight(),
-        }, autoResize: element.autoResize() });
-}
-function parseParametricElement(element) {
-    const source = element.source();
-    return Object.assign(Object.assign({ type: "parametric" }, parseElementBase(element.base())), { source: {
-            type: source.type(),
-            code: source.code(),
-            fileId: source.fileId(),
+        }, autoResize: element.autoResize(), fileId: element.fileId(), gridConfig: gridConfig ? parseDocumentGridConfig(gridConfig) : {
+            columns: 1,
+            gapX: 0,
+            gapY: 0,
+            alignItems: 'start',
+            firstPageAlone: false,
         } });
 }
+function parseModelElement(element) {
+    return Object.assign(Object.assign({ type: "model" }, parseElementBase(element.base())), { source: element.source(), svgPath: element.svgPath(), fileIds: Array.from({ length: element.fileIdsLength() }, (_, i) => element.fileIds(i)) });
+}
 // #endregion
 // #region STYLE PARSERS (ELEMENT-LEVEL)
 export function parseTextStyle(style) {
@@ -760,8 +799,8 @@ export function parseElementFromBinary(wrapper) {
         case ElementUnion.DucDocElement:
             element = wrapper.element(new DucDocElementFb());
             break;
-        case ElementUnion.DucParametricElement:
-            element = wrapper.element(new DucParametricElementFb());
+        case ElementUnion.DucModelElement:
+            element = wrapper.element(new DucModelElementFb());
             break;
         default:
             return null;
@@ -811,8 +850,8 @@ export function parseElementFromBinary(wrapper) {
             return parseFeatureControlFrameElement(element);
         case ElementUnion.DucDocElement:
             return parseDocElement(element);
-        case ElementUnion.DucParametricElement:
-            return parseParametricElement(element);
+        case ElementUnion.DucModelElement:
+            return parseModelElement(element);
         default:
             return null;
     }
@@ -1239,15 +1278,7 @@ export function parseVersionGraphFromBinary(graph) {
                 description: base.description() || undefined,
                 isManualSave: base.isManualSave(),
                 userId: base.userId() || undefined,
-                patch: Array.from({ length: d.patchLength() }, (_, j) => {
-                    const p = d.patch(j);
-                    return {
-                        op: p.op(),
-                        path: p.path(),
-                        from: p.from() || undefined,
-                        value: p.value() ? JSON.parse(p.value()) : undefined,
-                    };
-                }),
+                patch: parseBinaryToJson(d.patchArray()),
             };
         }),
         metadata: {

package/dist/restore/restoreDataState.d.ts

@@ -97,12 +97,7 @@ export declare const restoreBlockCollections: (collections: unknown) => Restored
  * Restores the blockInstances array from imported data, ensuring each item
  * conforms to the DucBlockInstance type.
  */
-export declare const restoreBlockInstances: (blockInstances: unknown) => RestoredDataState["blockInstances"];
-/**
- * Restores instances from block instances data (alias for restoreBlockInstances)
- * This method provides a consistent naming convention for instance restoration.
- */
-export declare const restoreInstances: (instances: unknown) => RestoredDataState["blockInstances"];
+export declare const restoreBlockInstances: (blockInstances: unknown, currentScope: Scope) => RestoredDataState["blockInstances"];
 /**
  * Restores the global state of the document from imported data.
  * It validates and provides defaults for missing or invalid properties.

package/dist/restore/restoreDataState.js

@@ -20,7 +20,7 @@ export const restore = (data, elementsConfig, restoreConfig = {}) => {
     const restoredRegions = restoreRegions(data === null || data === void 0 ? void 0 : data.regions);
     const restoredGroups = restoreGroups(data === null || data === void 0 ? void 0 : data.groups);
     const restoredLayers = restoreLayers(data === null || data === void 0 ? void 0 : data.layers, restoredLocalState.scope);
-    const restoredBlockInstances = restoreBlockInstances(data === null || data === void 0 ? void 0 : data.blockInstances);
+    const restoredBlockInstances = restoreBlockInstances(data === null || data === void 0 ? void 0 : data.blockInstances, restoredLocalState.scope);
     const restoredElements = restoreElements(data === null || data === void 0 ? void 0 : data.elements, restoredLocalState.scope, restoredBlocks, restoredElementsConfig);
     const restoredVersionGraph = restoreVersionGraph(data === null || data === void 0 ? void 0 : data.versionGraph);
     // Generate a new ID if none exists or if it's empty
@@ -247,7 +247,7 @@ export const restoreBlockCollections = (collections) => {
  * Restores the blockInstances array from imported data, ensuring each item
  * conforms to the DucBlockInstance type.
  */
-export const restoreBlockInstances = (blockInstances) => {
+export const restoreBlockInstances = (blockInstances, currentScope) => {
     if (!Array.isArray(blockInstances)) {
         return [];
     }
@@ -301,8 +301,8 @@ export const restoreBlockInstances = (blockInstances) => {
                 ? {
                     rows: typeof dupArray.rows === "number" ? dupArray.rows : 1,
                     cols: typeof dupArray.cols === "number" ? dupArray.cols : 1,
-                    rowSpacing: typeof dupArray.rowSpacing === "number" ? dupArray.rowSpacing : 0,
-                    colSpacing: typeof dupArray.colSpacing === "number" ? dupArray.colSpacing : 0,
+                    rowSpacing: restorePrecisionValue(dupArray.rowSpacing, NEUTRAL_SCOPE, currentScope),
+                    colSpacing: restorePrecisionValue(dupArray.colSpacing, NEUTRAL_SCOPE, currentScope),
                 }
                 : null,
         };
@@ -331,20 +331,11 @@ const restoreBlockMetadata = (metadata) => {
             localization = undefined;
         }
     }
-    return {
-        source: typeof metadataObj.source === "string" ? metadataObj.source : "",
-        usageCount: typeof metadataObj.usageCount === "number" ? metadataObj.usageCount : 0,
-        createdAt: typeof metadataObj.createdAt === "number" ? metadataObj.createdAt : Date.now(),
-        updatedAt: typeof metadataObj.updatedAt === "number" ? metadataObj.updatedAt : Date.now(),
-        localization,
-    };
-};
-/**
- * Restores instances from block instances data (alias for restoreBlockInstances)
- * This method provides a consistent naming convention for instance restoration.
- */
-export const restoreInstances = (instances) => {
-    return restoreBlockInstances(instances);
+    const rawSource = metadataObj.source;
+    const source = typeof rawSource === "string" && rawSource.trim().length
+        ? rawSource.trim()
+        : undefined;
+    return Object.assign(Object.assign({}, (source ? { source } : {})), { usageCount: typeof metadataObj.usageCount === "number" ? metadataObj.usageCount : 0, createdAt: typeof metadataObj.createdAt === "number" ? metadataObj.createdAt : Date.now(), updatedAt: typeof metadataObj.updatedAt === "number" ? metadataObj.updatedAt : Date.now(), localization });
 };
 /**
  * Restores the global state of the document from imported data.

package/dist/restore/restoreElements.js

@@ -3,7 +3,7 @@ isValidColor, isValidDucHead, isValidEnumValue, isValidFunction, isValidImageSca
 import { getPrecisionValueFromRaw, getPrecisionValueFromScoped, getScaledZoomValueForScope, getScopedBezierPointFromDucPoint, getScopedZoomValue, NEUTRAL_SCOPE, ScaleFactors, } from "../technical/scopes";
 import { isElbowArrow, isLinearElement, isTextElement, } from "../types";
 import { arrayToMap, bumpVersion, DEFAULT_ELEMENT_PROPS, DEFAULT_ELLIPSE_ELEMENT, DEFAULT_FONT_FAMILY, DEFAULT_FONT_SIZE, DEFAULT_FREEDRAW_ELEMENT, detectLineHeight, FONT_FAMILY, getContainerElement, getDefaultLocalState, getDefaultTableData, getNormalizedDimensions, getNormalizedPoints, getNormalizedZoom, getSizeFromPoints, getUpdatedTimestamp, isFiniteNumber, isInvisiblySmallElement, LINE_CONFIRM_THRESHOLD, mergeOverlappingPoints, migratePoints, normalizeFixedPoint, normalizeLink, randomId, refreshTextDimensions, validateClosedPath, } from "../utils";
-import { AXIS, BLOCK_ATTACHMENT, COLUMN_TYPE, DATUM_BRACKET_STYLE, DIMENSION_FIT_RULE, DIMENSION_TEXT_PLACEMENT, DIMENSION_TYPE, GDT_SYMBOL, LEADER_CONTENT_TYPE, LINE_SPACING_TYPE, MARK_ELLIPSE_CENTER, MATERIAL_CONDITION, PARAMETRIC_SOURCE_TYPE, STACKED_TEXT_ALIGN, TABLE_CELL_ALIGNMENT, TABLE_FLOW_DIRECTION, TEXT_FLOW_DIRECTION, TOLERANCE_DISPLAY, TOLERANCE_ZONE_TYPE, VERTICAL_ALIGN, VIEWPORT_SHADE_PLOT, } from "../flatbuffers/duc";
+import { AXIS, BLOCK_ATTACHMENT, COLUMN_TYPE, DATUM_BRACKET_STYLE, DIMENSION_FIT_RULE, DIMENSION_TEXT_PLACEMENT, DIMENSION_TYPE, GDT_SYMBOL, LEADER_CONTENT_TYPE, LINE_SPACING_TYPE, MARK_ELLIPSE_CENTER, MATERIAL_CONDITION, STACKED_TEXT_ALIGN, TABLE_CELL_ALIGNMENT, TABLE_FLOW_DIRECTION, TEXT_FLOW_DIRECTION, TOLERANCE_DISPLAY, TOLERANCE_ZONE_TYPE, VERTICAL_ALIGN, VIEWPORT_SHADE_PLOT, } from "../flatbuffers/duc";
 import tinycolor from "tinycolor2";
 const restoreElementWithProperties = (element, extra, localState, globalState) => {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
@@ -80,7 +80,7 @@ const restoreElementWithProperties = (element, extra, localState, globalState) =
     return Object.assign(Object.assign(Object.assign(Object.assign({}, _element), base), normalized), { type: _element.type });
 };
 const restoreElement = (element, currentScope, restoredBlocks, localState, globalState) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
     // Migration: convert deprecated 'diamond' to 'polygon' with 4 sides
     if (element.type === "diamond") {
         const migrated = Object.assign(Object.assign({}, element), { type: "polygon", sides: 4 });
@@ -343,7 +343,10 @@ const restoreElement = (element, currentScope, restoredBlocks, localState, globa
         }
         // Other elements
         case "pdf":
-            return restoreElementWithProperties(element, { fileId: isValidString(element.fileId) || null }, localState);
+            return restoreElementWithProperties(element, {
+                fileId: isValidString(element.fileId) || null,
+                gridConfig: restoreDocumentGridConfig(element.gridConfig),
+            }, localState);
         case "mermaid":
             return restoreElementWithProperties(element, {
                 source: isValidString(element.source),
@@ -381,7 +384,7 @@ const restoreElement = (element, currentScope, restoredBlocks, localState, globa
             const docElement = element;
             return restoreElementWithProperties(element, Object.assign(Object.assign({}, restoreDocStyleProperties(docElement, currentScope)), { text: isValidString(docElement.text), dynamic: restoreTextDynamicParts(docElement.dynamic), flowDirection: (Object.values(TEXT_FLOW_DIRECTION)).includes(docElement.flowDirection)
                     ? docElement.flowDirection
-                    : TEXT_FLOW_DIRECTION.TOP_TO_BOTTOM, columns: restoreTextColumns(docElement.columns, currentScope), autoResize: isValidBooleanValue(docElement.autoResize, true) }), localState);
+                    : TEXT_FLOW_DIRECTION.TOP_TO_BOTTOM, columns: restoreTextColumns(docElement.columns, currentScope), autoResize: isValidBooleanValue(docElement.autoResize, true), fileId: isValidString(docElement.fileId) || null, gridConfig: restoreDocumentGridConfig(docElement.gridConfig) }), localState);
         }
         case "xray": {
             const xrayElement = element;
@@ -393,22 +396,13 @@ const restoreElement = (element, currentScope, restoredBlocks, localState, globa
                 color: isValidColor(xrayElement.color, "#FF00FF"),
             }, localState, globalState);
         }
-        case "parametric": {
-            const parametricElement = element;
-            let source;
-            if (((_s = parametricElement.source) === null || _s === void 0 ? void 0 : _s.type) === PARAMETRIC_SOURCE_TYPE.FILE) {
-                source = {
-                    type: PARAMETRIC_SOURCE_TYPE.FILE,
-                    fileId: isValidString((_t = parametricElement.source) === null || _t === void 0 ? void 0 : _t.fileId),
-                };
-            }
-            else {
-                source = {
-                    type: PARAMETRIC_SOURCE_TYPE.CODE,
-                    code: isValidString((_u = parametricElement.source) === null || _u === void 0 ? void 0 : _u.code),
-                };
-            }
-            return restoreElementWithProperties(parametricElement, { source }, localState, globalState);
+        case "model": {
+            const modelElement = element;
+            return restoreElementWithProperties(modelElement, {
+                source: isValidString(modelElement.source),
+                fileIds: modelElement.fileIds || [],
+                svgPath: modelElement.svgPath || null,
+            }, localState, globalState);
         }
         case "featurecontrolframe": {
             const fcfElement = element;
@@ -417,15 +411,15 @@ const restoreElement = (element, currentScope, restoredBlocks, localState, globa
                 // Restore style properties
                 textStyle: restoreTextStyle(fcfElement.textStyle, currentScope),
                 layout: {
-                    padding: restorePrecisionValue((_v = fcfElement.layout) === null || _v === void 0 ? void 0 : _v.padding, elementScope, currentScope, 2),
-                    segmentSpacing: restorePrecisionValue((_w = fcfElement.layout) === null || _w === void 0 ? void 0 : _w.segmentSpacing, elementScope, currentScope, 2),
-                    rowSpacing: restorePrecisionValue((_x = fcfElement.layout) === null || _x === void 0 ? void 0 : _x.rowSpacing, elementScope, currentScope, 2),
+                    padding: restorePrecisionValue((_s = fcfElement.layout) === null || _s === void 0 ? void 0 : _s.padding, elementScope, currentScope, 2),
+                    segmentSpacing: restorePrecisionValue((_t = fcfElement.layout) === null || _t === void 0 ? void 0 : _t.segmentSpacing, elementScope, currentScope, 2),
+                    rowSpacing: restorePrecisionValue((_u = fcfElement.layout) === null || _u === void 0 ? void 0 : _u.rowSpacing, elementScope, currentScope, 2),
                 },
                 symbols: {
-                    scale: (_z = (_y = fcfElement.symbols) === null || _y === void 0 ? void 0 : _y.scale) !== null && _z !== void 0 ? _z : 1,
+                    scale: (_w = (_v = fcfElement.symbols) === null || _v === void 0 ? void 0 : _v.scale) !== null && _w !== void 0 ? _w : 1,
                 },
                 datumStyle: {
-                    bracketStyle: isValidEnumValue((_0 = fcfElement.datumStyle) === null || _0 === void 0 ? void 0 : _0.bracketStyle, DATUM_BRACKET_STYLE, DATUM_BRACKET_STYLE.SQUARE),
+                    bracketStyle: isValidEnumValue((_x = fcfElement.datumStyle) === null || _x === void 0 ? void 0 : _x.bracketStyle, DATUM_BRACKET_STYLE, DATUM_BRACKET_STYLE.SQUARE),
                 },
                 // Restore data properties
                 rows: restoreFcfRows(fcfElement.rows),
@@ -973,6 +967,26 @@ const restoreTextColumns = (columns, currentScope) => {
         autoHeight: isValidBooleanValue(columns.autoHeight, true),
     };
 };
+const restoreDocumentGridConfig = (gridConfig) => {
+    if (!gridConfig || typeof gridConfig !== "object") {
+        return {
+            columns: 1,
+            gapX: 0,
+            gapY: 0,
+            alignItems: "start",
+            firstPageAlone: false,
+        };
+    }
+    return {
+        columns: typeof gridConfig.columns === "number" ? gridConfig.columns : 1,
+        gapX: typeof gridConfig.gapX === "number" ? gridConfig.gapX : 0,
+        gapY: typeof gridConfig.gapY === "number" ? gridConfig.gapY : 0,
+        alignItems: (typeof gridConfig.alignItems === "string" && ["start", "center", "end"].includes(gridConfig.alignItems))
+            ? gridConfig.alignItems
+            : "start",
+        firstPageAlone: typeof gridConfig.firstPageAlone === "boolean" ? gridConfig.firstPageAlone : false,
+    };
+};
 const getFontFamilyByName = (fontFamilyName) => {
     if (Object.keys(FONT_FAMILY).includes(fontFamilyName)) {
         return FONT_FAMILY[fontFamilyName];