ducjs 2.2.3 → 2.3.0

package/dist/flatbuffers/duc/document-grid-align-items.d.ts

@@ -0,0 +1,5 @@
+export declare enum DOCUMENT_GRID_ALIGN_ITEMS {
+    START = 10,
+    CENTER = 11,
+    END = 12
+}

package/dist/flatbuffers/duc/document-grid-align-items.js

@@ -0,0 +1,8 @@
+// automatically generated by the FlatBuffers compiler, do not modify
+/* eslint-disable @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any, @typescript-eslint/no-non-null-assertion */
+export var DOCUMENT_GRID_ALIGN_ITEMS;
+(function (DOCUMENT_GRID_ALIGN_ITEMS) {
+    DOCUMENT_GRID_ALIGN_ITEMS[DOCUMENT_GRID_ALIGN_ITEMS["START"] = 10] = "START";
+    DOCUMENT_GRID_ALIGN_ITEMS[DOCUMENT_GRID_ALIGN_ITEMS["CENTER"] = 11] = "CENTER";
+    DOCUMENT_GRID_ALIGN_ITEMS[DOCUMENT_GRID_ALIGN_ITEMS["END"] = 12] = "END";
+})(DOCUMENT_GRID_ALIGN_ITEMS || (DOCUMENT_GRID_ALIGN_ITEMS = {}));

package/dist/flatbuffers/duc/document-grid-config.d.ts

@@ -0,0 +1,22 @@
+import * as flatbuffers from 'flatbuffers';
+import { DOCUMENT_GRID_ALIGN_ITEMS } from '../duc/document-grid-align-items';
+export declare class DocumentGridConfig {
+    bb: flatbuffers.ByteBuffer | null;
+    bb_pos: number;
+    __init(i: number, bb: flatbuffers.ByteBuffer): DocumentGridConfig;
+    static getRootAsDocumentGridConfig(bb: flatbuffers.ByteBuffer, obj?: DocumentGridConfig): DocumentGridConfig;
+    static getSizePrefixedRootAsDocumentGridConfig(bb: flatbuffers.ByteBuffer, obj?: DocumentGridConfig): DocumentGridConfig;
+    columns(): number;
+    gapX(): number;
+    gapY(): number;
+    alignItems(): DOCUMENT_GRID_ALIGN_ITEMS | null;
+    firstPageAlone(): boolean;
+    static startDocumentGridConfig(builder: flatbuffers.Builder): void;
+    static addColumns(builder: flatbuffers.Builder, columns: number): void;
+    static addGapX(builder: flatbuffers.Builder, gapX: number): void;
+    static addGapY(builder: flatbuffers.Builder, gapY: number): void;
+    static addAlignItems(builder: flatbuffers.Builder, alignItems: DOCUMENT_GRID_ALIGN_ITEMS): void;
+    static addFirstPageAlone(builder: flatbuffers.Builder, firstPageAlone: boolean): void;
+    static endDocumentGridConfig(builder: flatbuffers.Builder): flatbuffers.Offset;
+    static createDocumentGridConfig(builder: flatbuffers.Builder, columns: number, gapX: number, gapY: number, alignItems: DOCUMENT_GRID_ALIGN_ITEMS | null, firstPageAlone: boolean): flatbuffers.Offset;
+}

package/dist/flatbuffers/duc/document-grid-config.js

@@ -0,0 +1,73 @@
+// automatically generated by the FlatBuffers compiler, do not modify
+/* eslint-disable @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any, @typescript-eslint/no-non-null-assertion */
+import * as flatbuffers from 'flatbuffers';
+export class DocumentGridConfig {
+    constructor() {
+        this.bb = null;
+        this.bb_pos = 0;
+    }
+    __init(i, bb) {
+        this.bb_pos = i;
+        this.bb = bb;
+        return this;
+    }
+    static getRootAsDocumentGridConfig(bb, obj) {
+        return (obj || new DocumentGridConfig()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+    }
+    static getSizePrefixedRootAsDocumentGridConfig(bb, obj) {
+        bb.setPosition(bb.position() + flatbuffers.SIZE_PREFIX_LENGTH);
+        return (obj || new DocumentGridConfig()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+    }
+    columns() {
+        const offset = this.bb.__offset(this.bb_pos, 4);
+        return offset ? this.bb.readInt32(this.bb_pos + offset) : 0;
+    }
+    gapX() {
+        const offset = this.bb.__offset(this.bb_pos, 6);
+        return offset ? this.bb.readFloat64(this.bb_pos + offset) : 0.0;
+    }
+    gapY() {
+        const offset = this.bb.__offset(this.bb_pos, 8);
+        return offset ? this.bb.readFloat64(this.bb_pos + offset) : 0.0;
+    }
+    alignItems() {
+        const offset = this.bb.__offset(this.bb_pos, 10);
+        return offset ? this.bb.readUint8(this.bb_pos + offset) : null;
+    }
+    firstPageAlone() {
+        const offset = this.bb.__offset(this.bb_pos, 12);
+        return offset ? !!this.bb.readInt8(this.bb_pos + offset) : false;
+    }
+    static startDocumentGridConfig(builder) {
+        builder.startObject(5);
+    }
+    static addColumns(builder, columns) {
+        builder.addFieldInt32(0, columns, 0);
+    }
+    static addGapX(builder, gapX) {
+        builder.addFieldFloat64(1, gapX, 0.0);
+    }
+    static addGapY(builder, gapY) {
+        builder.addFieldFloat64(2, gapY, 0.0);
+    }
+    static addAlignItems(builder, alignItems) {
+        builder.addFieldInt8(3, alignItems, null);
+    }
+    static addFirstPageAlone(builder, firstPageAlone) {
+        builder.addFieldInt8(4, +firstPageAlone, +false);
+    }
+    static endDocumentGridConfig(builder) {
+        const offset = builder.endObject();
+        return offset;
+    }
+    static createDocumentGridConfig(builder, columns, gapX, gapY, alignItems, firstPageAlone) {
+        DocumentGridConfig.startDocumentGridConfig(builder);
+        DocumentGridConfig.addColumns(builder, columns);
+        DocumentGridConfig.addGapX(builder, gapX);
+        DocumentGridConfig.addGapY(builder, gapY);
+        if (alignItems !== null)
+            DocumentGridConfig.addAlignItems(builder, alignItems);
+        DocumentGridConfig.addFirstPageAlone(builder, firstPageAlone);
+        return DocumentGridConfig.endDocumentGridConfig(builder);
+    }
+}

package/dist/flatbuffers/duc/duc-doc-element.d.ts

@@ -1,5 +1,6 @@
 import * as flatbuffers from 'flatbuffers';
 import { ColumnLayout } from '../duc/column-layout';
+import { DocumentGridConfig } from '../duc/document-grid-config';
 import { DucDocStyle } from '../duc/duc-doc-style';
 import { DucTextDynamicPart } from '../duc/duc-text-dynamic-part';
 import { TEXT_FLOW_DIRECTION } from '../duc/text-flow-direction';
@@ -19,6 +20,9 @@ export declare class DucDocElement {
     flowDirection(): TEXT_FLOW_DIRECTION | null;
     columns(obj?: ColumnLayout): ColumnLayout | null;
     autoResize(): boolean;
+    gridConfig(obj?: DocumentGridConfig): DocumentGridConfig | null;
+    fileId(): string | null;
+    fileId(optionalEncoding: flatbuffers.Encoding): string | Uint8Array | null;
     static startDucDocElement(builder: flatbuffers.Builder): void;
     static addBase(builder: flatbuffers.Builder, baseOffset: flatbuffers.Offset): void;
     static addStyle(builder: flatbuffers.Builder, styleOffset: flatbuffers.Offset): void;
@@ -29,5 +33,7 @@ export declare class DucDocElement {
     static addFlowDirection(builder: flatbuffers.Builder, flowDirection: TEXT_FLOW_DIRECTION): void;
     static addColumns(builder: flatbuffers.Builder, columnsOffset: flatbuffers.Offset): void;
     static addAutoResize(builder: flatbuffers.Builder, autoResize: boolean): void;
+    static addGridConfig(builder: flatbuffers.Builder, gridConfigOffset: flatbuffers.Offset): void;
+    static addFileId(builder: flatbuffers.Builder, fileIdOffset: flatbuffers.Offset): void;
     static endDucDocElement(builder: flatbuffers.Builder): flatbuffers.Offset;
 }

package/dist/flatbuffers/duc/duc-doc-element.js

@@ -2,6 +2,7 @@
 /* eslint-disable @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any, @typescript-eslint/no-non-null-assertion */
 import * as flatbuffers from 'flatbuffers';
 import { ColumnLayout } from '../duc/column-layout';
+import { DocumentGridConfig } from '../duc/document-grid-config';
 import { DucDocStyle } from '../duc/duc-doc-style';
 import { DucTextDynamicPart } from '../duc/duc-text-dynamic-part';
 import { _DucElementBase } from '../duc/duc-element-base';
@@ -54,8 +55,16 @@ export class DucDocElement {
         const offset = this.bb.__offset(this.bb_pos, 16);
         return offset ? !!this.bb.readInt8(this.bb_pos + offset) : false;
     }
+    gridConfig(obj) {
+        const offset = this.bb.__offset(this.bb_pos, 18);
+        return offset ? (obj || new DocumentGridConfig()).__init(this.bb.__indirect(this.bb_pos + offset), this.bb) : null;
+    }
+    fileId(optionalEncoding) {
+        const offset = this.bb.__offset(this.bb_pos, 20);
+        return offset ? this.bb.__string(this.bb_pos + offset, optionalEncoding) : null;
+    }
     static startDucDocElement(builder) {
-        builder.startObject(7);
+        builder.startObject(9);
     }
     static addBase(builder, baseOffset) {
         builder.addFieldOffset(0, baseOffset, 0);
@@ -88,6 +97,12 @@ export class DucDocElement {
     static addAutoResize(builder, autoResize) {
         builder.addFieldInt8(6, +autoResize, +false);
     }
+    static addGridConfig(builder, gridConfigOffset) {
+        builder.addFieldOffset(7, gridConfigOffset, 0);
+    }
+    static addFileId(builder, fileIdOffset) {
+        builder.addFieldOffset(8, fileIdOffset, 0);
+    }
     static endDucDocElement(builder) {
         const offset = builder.endObject();
         return offset;

package/dist/flatbuffers/duc/duc-model-element.d.ts

@@ -0,0 +1,26 @@
+import * as flatbuffers from 'flatbuffers';
+import { _DucElementBase } from '../duc/duc-element-base';
+export declare class DucModelElement {
+    bb: flatbuffers.ByteBuffer | null;
+    bb_pos: number;
+    __init(i: number, bb: flatbuffers.ByteBuffer): DucModelElement;
+    static getRootAsDucModelElement(bb: flatbuffers.ByteBuffer, obj?: DucModelElement): DucModelElement;
+    static getSizePrefixedRootAsDucModelElement(bb: flatbuffers.ByteBuffer, obj?: DucModelElement): DucModelElement;
+    base(obj?: _DucElementBase): _DucElementBase | null;
+    source(): string | null;
+    source(optionalEncoding: flatbuffers.Encoding): string | Uint8Array | null;
+    svgPath(): string | null;
+    svgPath(optionalEncoding: flatbuffers.Encoding): string | Uint8Array | null;
+    fileIds(index: number): string;
+    fileIds(index: number, optionalEncoding: flatbuffers.Encoding): string | Uint8Array;
+    fileIdsLength(): number;
+    static startDucModelElement(builder: flatbuffers.Builder): void;
+    static addBase(builder: flatbuffers.Builder, baseOffset: flatbuffers.Offset): void;
+    static addSource(builder: flatbuffers.Builder, sourceOffset: flatbuffers.Offset): void;
+    static addSvgPath(builder: flatbuffers.Builder, svgPathOffset: flatbuffers.Offset): void;
+    static addFileIds(builder: flatbuffers.Builder, fileIdsOffset: flatbuffers.Offset): void;
+    static createFileIdsVector(builder: flatbuffers.Builder, data: flatbuffers.Offset[]): flatbuffers.Offset;
+    static startFileIdsVector(builder: flatbuffers.Builder, numElems: number): void;
+    static endDucModelElement(builder: flatbuffers.Builder): flatbuffers.Offset;
+    static createDucModelElement(builder: flatbuffers.Builder, baseOffset: flatbuffers.Offset, sourceOffset: flatbuffers.Offset, svgPathOffset: flatbuffers.Offset, fileIdsOffset: flatbuffers.Offset): flatbuffers.Offset;
+}

package/dist/flatbuffers/duc/duc-model-element.js

@@ -0,0 +1,79 @@
+// automatically generated by the FlatBuffers compiler, do not modify
+/* eslint-disable @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any, @typescript-eslint/no-non-null-assertion */
+import * as flatbuffers from 'flatbuffers';
+import { _DucElementBase } from '../duc/duc-element-base';
+export class DucModelElement {
+    constructor() {
+        this.bb = null;
+        this.bb_pos = 0;
+    }
+    __init(i, bb) {
+        this.bb_pos = i;
+        this.bb = bb;
+        return this;
+    }
+    static getRootAsDucModelElement(bb, obj) {
+        return (obj || new DucModelElement()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+    }
+    static getSizePrefixedRootAsDucModelElement(bb, obj) {
+        bb.setPosition(bb.position() + flatbuffers.SIZE_PREFIX_LENGTH);
+        return (obj || new DucModelElement()).__init(bb.readInt32(bb.position()) + bb.position(), bb);
+    }
+    base(obj) {
+        const offset = this.bb.__offset(this.bb_pos, 4);
+        return offset ? (obj || new _DucElementBase()).__init(this.bb.__indirect(this.bb_pos + offset), this.bb) : null;
+    }
+    source(optionalEncoding) {
+        const offset = this.bb.__offset(this.bb_pos, 6);
+        return offset ? this.bb.__string(this.bb_pos + offset, optionalEncoding) : null;
+    }
+    svgPath(optionalEncoding) {
+        const offset = this.bb.__offset(this.bb_pos, 8);
+        return offset ? this.bb.__string(this.bb_pos + offset, optionalEncoding) : null;
+    }
+    fileIds(index, optionalEncoding) {
+        const offset = this.bb.__offset(this.bb_pos, 10);
+        return offset ? this.bb.__string(this.bb.__vector(this.bb_pos + offset) + index * 4, optionalEncoding) : null;
+    }
+    fileIdsLength() {
+        const offset = this.bb.__offset(this.bb_pos, 10);
+        return offset ? this.bb.__vector_len(this.bb_pos + offset) : 0;
+    }
+    static startDucModelElement(builder) {
+        builder.startObject(4);
+    }
+    static addBase(builder, baseOffset) {
+        builder.addFieldOffset(0, baseOffset, 0);
+    }
+    static addSource(builder, sourceOffset) {
+        builder.addFieldOffset(1, sourceOffset, 0);
+    }
+    static addSvgPath(builder, svgPathOffset) {
+        builder.addFieldOffset(2, svgPathOffset, 0);
+    }
+    static addFileIds(builder, fileIdsOffset) {
+        builder.addFieldOffset(3, fileIdsOffset, 0);
+    }
+    static createFileIdsVector(builder, data) {
+        builder.startVector(4, data.length, 4);
+        for (let i = data.length - 1; i >= 0; i--) {
+            builder.addOffset(data[i]);
+        }
+        return builder.endVector();
+    }
+    static startFileIdsVector(builder, numElems) {
+        builder.startVector(4, numElems, 4);
+    }
+    static endDucModelElement(builder) {
+        const offset = builder.endObject();
+        return offset;
+    }
+    static createDucModelElement(builder, baseOffset, sourceOffset, svgPathOffset, fileIdsOffset) {
+        DucModelElement.startDucModelElement(builder);
+        DucModelElement.addBase(builder, baseOffset);
+        DucModelElement.addSource(builder, sourceOffset);
+        DucModelElement.addSvgPath(builder, svgPathOffset);
+        DucModelElement.addFileIds(builder, fileIdsOffset);
+        return DucModelElement.endDucModelElement(builder);
+    }
+}

package/dist/flatbuffers/duc/duc-pdf-element.d.ts

@@ -1,4 +1,5 @@
 import * as flatbuffers from 'flatbuffers';
+import { DocumentGridConfig } from '../duc/document-grid-config';
 import { _DucElementBase } from '../duc/duc-element-base';
 export declare class DucPdfElement {
     bb: flatbuffers.ByteBuffer | null;
@@ -9,9 +10,10 @@ export declare class DucPdfElement {
     base(obj?: _DucElementBase): _DucElementBase | null;
     fileId(): string | null;
     fileId(optionalEncoding: flatbuffers.Encoding): string | Uint8Array | null;
+    gridConfig(obj?: DocumentGridConfig): DocumentGridConfig | null;
     static startDucPdfElement(builder: flatbuffers.Builder): void;
     static addBase(builder: flatbuffers.Builder, baseOffset: flatbuffers.Offset): void;
     static addFileId(builder: flatbuffers.Builder, fileIdOffset: flatbuffers.Offset): void;
+    static addGridConfig(builder: flatbuffers.Builder, gridConfigOffset: flatbuffers.Offset): void;
     static endDucPdfElement(builder: flatbuffers.Builder): flatbuffers.Offset;
-    static createDucPdfElement(builder: flatbuffers.Builder, baseOffset: flatbuffers.Offset, fileIdOffset: flatbuffers.Offset): flatbuffers.Offset;
 }

package/dist/flatbuffers/duc/duc-pdf-element.js

@@ -1,6 +1,7 @@
 // automatically generated by the FlatBuffers compiler, do not modify
 /* eslint-disable @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any, @typescript-eslint/no-non-null-assertion */
 import * as flatbuffers from 'flatbuffers';
+import { DocumentGridConfig } from '../duc/document-grid-config';
 import { _DucElementBase } from '../duc/duc-element-base';
 export class DucPdfElement {
     constructor() {
@@ -27,8 +28,12 @@ export class DucPdfElement {
         const offset = this.bb.__offset(this.bb_pos, 6);
         return offset ? this.bb.__string(this.bb_pos + offset, optionalEncoding) : null;
     }
+    gridConfig(obj) {
+        const offset = this.bb.__offset(this.bb_pos, 8);
+        return offset ? (obj || new DocumentGridConfig()).__init(this.bb.__indirect(this.bb_pos + offset), this.bb) : null;
+    }
     static startDucPdfElement(builder) {
-        builder.startObject(2);
+        builder.startObject(3);
     }
     static addBase(builder, baseOffset) {
         builder.addFieldOffset(0, baseOffset, 0);
@@ -36,14 +41,11 @@ export class DucPdfElement {
     static addFileId(builder, fileIdOffset) {
         builder.addFieldOffset(1, fileIdOffset, 0);
     }
+    static addGridConfig(builder, gridConfigOffset) {
+        builder.addFieldOffset(2, gridConfigOffset, 0);
+    }
     static endDucPdfElement(builder) {
         const offset = builder.endObject();
         return offset;
     }
-    static createDucPdfElement(builder, baseOffset, fileIdOffset) {
-        DucPdfElement.startDucPdfElement(builder);
-        DucPdfElement.addBase(builder, baseOffset);
-        DucPdfElement.addFileId(builder, fileIdOffset);
-        return DucPdfElement.endDucPdfElement(builder);
-    }
 }

package/dist/flatbuffers/duc/element.d.ts

@@ -11,6 +11,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';
@@ -43,7 +44,8 @@ export declare enum Element {
     DucDimensionElement = 19,
     DucFeatureControlFrameElement = 20,
     DucDocElement = 21,
-    DucParametricElement = 22
+    DucParametricElement = 22,
+    DucModelElement = 23
 }
-export declare function unionToElement(type: Element, accessor: (obj: DucArrowElement | DucBlockInstanceElement | DucDimensionElement | DucDocElement | DucEllipseElement | DucEmbeddableElement | DucFeatureControlFrameElement | DucFrameElement | DucFreeDrawElement | DucImageElement | DucLeaderElement | DucLinearElement | DucMermaidElement | DucParametricElement | DucPdfElement | DucPlotElement | DucPolygonElement | DucRectangleElement | DucTableElement | DucTextElement | DucViewportElement | DucXRayElement) => DucArrowElement | DucBlockInstanceElement | DucDimensionElement | DucDocElement | DucEllipseElement | DucEmbeddableElement | DucFeatureControlFrameElement | DucFrameElement | DucFreeDrawElement | DucImageElement | DucLeaderElement | DucLinearElement | DucMermaidElement | DucParametricElement | DucPdfElement | DucPlotElement | DucPolygonElement | DucRectangleElement | DucTableElement | DucTextElement | DucViewportElement | DucXRayElement | null): DucArrowElement | DucBlockInstanceElement | DucDimensionElement | DucDocElement | DucEllipseElement | DucEmbeddableElement | DucFeatureControlFrameElement | DucFrameElement | DucFreeDrawElement | DucImageElement | DucLeaderElement | DucLinearElement | DucMermaidElement | DucParametricElement | DucPdfElement | DucPlotElement | DucPolygonElement | DucRectangleElement | DucTableElement | DucTextElement | DucViewportElement | DucXRayElement | null;
-export declare function unionListToElement(type: Element, accessor: (index: number, obj: DucArrowElement | DucBlockInstanceElement | DucDimensionElement | DucDocElement | DucEllipseElement | DucEmbeddableElement | DucFeatureControlFrameElement | DucFrameElement | DucFreeDrawElement | DucImageElement | DucLeaderElement | DucLinearElement | DucMermaidElement | DucParametricElement | DucPdfElement | DucPlotElement | DucPolygonElement | DucRectangleElement | DucTableElement | DucTextElement | DucViewportElement | DucXRayElement) => DucArrowElement | DucBlockInstanceElement | DucDimensionElement | DucDocElement | DucEllipseElement | DucEmbeddableElement | DucFeatureControlFrameElement | DucFrameElement | DucFreeDrawElement | DucImageElement | DucLeaderElement | DucLinearElement | DucMermaidElement | DucParametricElement | DucPdfElement | DucPlotElement | DucPolygonElement | DucRectangleElement | DucTableElement | DucTextElement | DucViewportElement | DucXRayElement | null, index: number): DucArrowElement | DucBlockInstanceElement | DucDimensionElement | DucDocElement | DucEllipseElement | DucEmbeddableElement | DucFeatureControlFrameElement | DucFrameElement | DucFreeDrawElement | DucImageElement | DucLeaderElement | DucLinearElement | DucMermaidElement | DucParametricElement | DucPdfElement | DucPlotElement | DucPolygonElement | DucRectangleElement | DucTableElement | DucTextElement | DucViewportElement | DucXRayElement | null;
+export declare function unionToElement(type: Element, accessor: (obj: DucArrowElement | DucBlockInstanceElement | DucDimensionElement | DucDocElement | DucEllipseElement | DucEmbeddableElement | DucFeatureControlFrameElement | DucFrameElement | DucFreeDrawElement | DucImageElement | DucLeaderElement | DucLinearElement | DucMermaidElement | DucModelElement | DucParametricElement | DucPdfElement | DucPlotElement | DucPolygonElement | DucRectangleElement | DucTableElement | DucTextElement | DucViewportElement | DucXRayElement) => DucArrowElement | DucBlockInstanceElement | DucDimensionElement | DucDocElement | DucEllipseElement | DucEmbeddableElement | DucFeatureControlFrameElement | DucFrameElement | DucFreeDrawElement | DucImageElement | DucLeaderElement | DucLinearElement | DucMermaidElement | DucModelElement | DucParametricElement | DucPdfElement | DucPlotElement | DucPolygonElement | DucRectangleElement | DucTableElement | DucTextElement | DucViewportElement | DucXRayElement | null): DucArrowElement | DucBlockInstanceElement | DucDimensionElement | DucDocElement | DucEllipseElement | DucEmbeddableElement | DucFeatureControlFrameElement | DucFrameElement | DucFreeDrawElement | DucImageElement | DucLeaderElement | DucLinearElement | DucMermaidElement | DucModelElement | DucParametricElement | DucPdfElement | DucPlotElement | DucPolygonElement | DucRectangleElement | DucTableElement | DucTextElement | DucViewportElement | DucXRayElement | null;
+export declare function unionListToElement(type: Element, accessor: (index: number, obj: DucArrowElement | DucBlockInstanceElement | DucDimensionElement | DucDocElement | DucEllipseElement | DucEmbeddableElement | DucFeatureControlFrameElement | DucFrameElement | DucFreeDrawElement | DucImageElement | DucLeaderElement | DucLinearElement | DucMermaidElement | DucModelElement | DucParametricElement | DucPdfElement | DucPlotElement | DucPolygonElement | DucRectangleElement | DucTableElement | DucTextElement | DucViewportElement | DucXRayElement) => DucArrowElement | DucBlockInstanceElement | DucDimensionElement | DucDocElement | DucEllipseElement | DucEmbeddableElement | DucFeatureControlFrameElement | DucFrameElement | DucFreeDrawElement | DucImageElement | DucLeaderElement | DucLinearElement | DucMermaidElement | DucModelElement | DucParametricElement | DucPdfElement | DucPlotElement | DucPolygonElement | DucRectangleElement | DucTableElement | DucTextElement | DucViewportElement | DucXRayElement | null, index: number): DucArrowElement | DucBlockInstanceElement | DucDimensionElement | DucDocElement | DucEllipseElement | DucEmbeddableElement | DucFeatureControlFrameElement | DucFrameElement | DucFreeDrawElement | DucImageElement | DucLeaderElement | DucLinearElement | DucMermaidElement | DucModelElement | DucParametricElement | DucPdfElement | DucPlotElement | DucPolygonElement | DucRectangleElement | DucTableElement | DucTextElement | DucViewportElement | DucXRayElement | null;

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

@@ -10,7 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { decompressSync, strFromU8 } from 'fflate';
 import * as flatbuffers from "flatbuffers";
 import { nanoid } from 'nanoid';
-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 { 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
@@ -70,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(),
@@ -257,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() });
@@ -545,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) => {
@@ -555,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) {
@@ -772,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;
@@ -823,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;
     }

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,
         };
@@ -337,13 +337,6 @@ const restoreBlockMetadata = (metadata) => {
         : 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 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);
-};
 /**
  * Restores the global state of the document from imported data.
  * It validates and provides defaults for missing or invalid properties.

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];

package/dist/serialize.js

@@ -740,6 +740,24 @@ function writeColumnLayout(b, c, usv) {
     Duc.ColumnLayout.addAutoHeight(b, c.autoHeight);
     return Duc.ColumnLayout.endColumnLayout(b);
 }
+function writeDocumentGridConfig(b, config, usv) {
+    Duc.DocumentGridConfig.startDocumentGridConfig(b);
+    Duc.DocumentGridConfig.addColumns(b, config.columns);
+    Duc.DocumentGridConfig.addGapX(b, config.gapX);
+    Duc.DocumentGridConfig.addGapY(b, config.gapY);
+    const alignItems = (() => {
+        if (config.alignItems === 'start')
+            return Duc.DOCUMENT_GRID_ALIGN_ITEMS.START;
+        if (config.alignItems === 'center')
+            return Duc.DOCUMENT_GRID_ALIGN_ITEMS.CENTER;
+        if (config.alignItems === 'end')
+            return Duc.DOCUMENT_GRID_ALIGN_ITEMS.END;
+        return Duc.DOCUMENT_GRID_ALIGN_ITEMS.START;
+    })();
+    Duc.DocumentGridConfig.addAlignItems(b, alignItems);
+    Duc.DocumentGridConfig.addFirstPageAlone(b, config.firstPageAlone);
+    return Duc.DocumentGridConfig.endDocumentGridConfig(b);
+}
 function writeText(b, e, usv) {
     var _a;
     const base = writeElementBase(b, e, usv);
@@ -836,8 +854,14 @@ function writeBlockInstance(b, i, usv) {
             Duc.DucBlockDuplicationArray.startDucBlockDuplicationArray(b);
             Duc.DucBlockDuplicationArray.addRows(b, i.duplicationArray.rows);
             Duc.DucBlockDuplicationArray.addCols(b, i.duplicationArray.cols);
-            Duc.DucBlockDuplicationArray.addRowSpacing(b, getPrecisionValue(i.duplicationArray.rowSpacing, usv));
-            Duc.DucBlockDuplicationArray.addColSpacing(b, getPrecisionValue(i.duplicationArray.colSpacing, usv));
+            const rSpacing = typeof i.duplicationArray.rowSpacing === 'number'
+                ? i.duplicationArray.rowSpacing
+                : getPrecisionValue(i.duplicationArray.rowSpacing, usv);
+            const cSpacing = typeof i.duplicationArray.colSpacing === 'number'
+                ? i.duplicationArray.colSpacing
+                : getPrecisionValue(i.duplicationArray.colSpacing, usv);
+            Duc.DucBlockDuplicationArray.addRowSpacing(b, rSpacing);
+            Duc.DucBlockDuplicationArray.addColSpacing(b, cSpacing);
             return Duc.DucBlockDuplicationArray.endDucBlockDuplicationArray(b);
         })()
         : undefined;
@@ -1378,6 +1402,8 @@ function writeDoc(b, e, usv) {
         Duc.ColumnLayout.addAutoHeight(b, col.autoHeight);
         return Duc.ColumnLayout.endColumnLayout(b);
     })();
+    const fileId = e.fileId ? b.createString(e.fileId) : undefined;
+    const gridConfig = writeDocumentGridConfig(b, e.gridConfig, usv);
     Duc.DucDocElement.startDucDocElement(b);
     Duc.DucDocElement.addBase(b, base);
     Duc.DucDocElement.addStyle(b, style);
@@ -1386,36 +1412,23 @@ function writeDoc(b, e, usv) {
     Duc.DucDocElement.addFlowDirection(b, e.flowDirection);
     Duc.DucDocElement.addColumns(b, columns);
     Duc.DucDocElement.addAutoResize(b, e.autoResize);
+    if (fileId)
+        Duc.DucDocElement.addFileId(b, fileId);
+    Duc.DucDocElement.addGridConfig(b, gridConfig);
     return Duc.DucDocElement.endDucDocElement(b);
 }
 /**
- * Parametric, PDF, Mermaid, Embeddable
+ * PDF, Mermaid, Embeddable
  */
-function writeParametricSource(b, s, usv) {
-    Duc.ParametricSource.startParametricSource(b);
-    Duc.ParametricSource.addType(b, s.type);
-    if (s.type === Duc.PARAMETRIC_SOURCE_TYPE.CODE) {
-        Duc.ParametricSource.addCode(b, b.createString(s.code));
-    }
-    else {
-        Duc.ParametricSource.addFileId(b, b.createString(s.fileId));
-    }
-    return Duc.ParametricSource.endParametricSource(b);
-}
-function writeParametric(b, e, usv) {
-    const base = writeElementBase(b, e, usv);
-    const src = writeParametricSource(b, e.source, usv);
-    Duc.DucParametricElement.startDucParametricElement(b);
-    Duc.DucParametricElement.addBase(b, base);
-    Duc.DucParametricElement.addSource(b, src);
-    return Duc.DucParametricElement.endDucParametricElement(b);
-}
 function writePdf(b, e, usv) {
     const base = writeElementBase(b, e, usv);
-    const fileId = b.createString(e.fileId);
+    const fileId = e.fileId ? b.createString(e.fileId) : undefined;
+    const gridConfig = writeDocumentGridConfig(b, e.gridConfig, usv);
     Duc.DucPdfElement.startDucPdfElement(b);
     Duc.DucPdfElement.addBase(b, base);
-    Duc.DucPdfElement.addFileId(b, fileId);
+    if (fileId)
+        Duc.DucPdfElement.addFileId(b, fileId);
+    Duc.DucPdfElement.addGridConfig(b, gridConfig);
     return Duc.DucPdfElement.endDucPdfElement(b);
 }
 function writeMermaid(b, e, usv) {
@@ -1432,6 +1445,21 @@ function writeMermaid(b, e, usv) {
         Duc.DucMermaidElement.addSvgPath(b, svg);
     return Duc.DucMermaidElement.endDucMermaidElement(b);
 }
+function writeModel(b, e, usv) {
+    var _a;
+    const base = writeElementBase(b, e, usv);
+    const src = b.createString(e.source);
+    const svg = e.svgPath ? b.createString(e.svgPath) : undefined;
+    const fileIds = ((_a = e.fileIds) === null || _a === void 0 ? void 0 : _a.length) ? Duc.DucModelElement.createFileIdsVector(b, e.fileIds.map((id) => b.createString(id))) : undefined;
+    Duc.DucModelElement.startDucModelElement(b);
+    Duc.DucModelElement.addBase(b, base);
+    Duc.DucModelElement.addSource(b, src);
+    if (svg)
+        Duc.DucModelElement.addSvgPath(b, svg);
+    if (fileIds)
+        Duc.DucModelElement.addFileIds(b, fileIds);
+    return Duc.DucModelElement.endDucModelElement(b);
+}
 function writeEmbeddable(b, e, usv) {
     const base = writeElementBase(b, e, usv);
     Duc.DucEmbeddableElement.startDucEmbeddableElement(b);
@@ -1633,9 +1661,9 @@ function writeElementWrapper(b, e, usv) {
             type = Duc.Element.DucDocElement;
             elem = writeDoc(b, e, usv);
             break;
-        case "parametric":
-            type = Duc.Element.DucParametricElement;
-            elem = writeParametric(b, e, usv);
+        case "model":
+            type = Duc.Element.DucModelElement;
+            elem = writeModel(b, e, usv);
             break;
         case "embeddable":
             type = Duc.Element.DucEmbeddableElement;

package/dist/types/elements/index.d.ts

@@ -1,6 +1,6 @@
 export * from "./typeChecks";
 import { DucView, PrecisionValue, Scope } from "..";
-import { BEZIER_MIRRORING, BLENDING, BLOCK_ATTACHMENT, BOOLEAN_OPERATION, COLUMN_TYPE, DATUM_BRACKET_STYLE, DATUM_TARGET_TYPE, DIMENSION_FIT_RULE, DIMENSION_TEXT_PLACEMENT, DIMENSION_TYPE, ELEMENT_CONTENT_PREFERENCE, FEATURE_MODIFIER, GDT_SYMBOL, HATCH_STYLE, IMAGE_STATUS, LINE_HEAD, LINE_SPACING_TYPE, MARK_ELLIPSE_CENTER, MATERIAL_CONDITION, PARAMETRIC_SOURCE_TYPE, STACKED_TEXT_ALIGN, STROKE_CAP, STROKE_JOIN, STROKE_PLACEMENT, STROKE_PREFERENCE, STROKE_SIDE_PREFERENCE, TABLE_CELL_ALIGNMENT, TABLE_FLOW_DIRECTION, TEXT_ALIGN, TEXT_FIELD_SOURCE_PROPERTY, TEXT_FIELD_SOURCE_TYPE, TEXT_FLOW_DIRECTION, TOLERANCE_DISPLAY, TOLERANCE_TYPE, TOLERANCE_ZONE_TYPE, VERTICAL_ALIGN, VIEWPORT_SHADE_PLOT } from "../../flatbuffers/duc";
+import { BEZIER_MIRRORING, BLENDING, BLOCK_ATTACHMENT, BOOLEAN_OPERATION, COLUMN_TYPE, DATUM_BRACKET_STYLE, DATUM_TARGET_TYPE, DIMENSION_FIT_RULE, DIMENSION_TEXT_PLACEMENT, DIMENSION_TYPE, ELEMENT_CONTENT_PREFERENCE, FEATURE_MODIFIER, GDT_SYMBOL, HATCH_STYLE, IMAGE_STATUS, LINE_HEAD, LINE_SPACING_TYPE, MARK_ELLIPSE_CENTER, MATERIAL_CONDITION, STACKED_TEXT_ALIGN, STROKE_CAP, STROKE_JOIN, STROKE_PLACEMENT, STROKE_PREFERENCE, STROKE_SIDE_PREFERENCE, TABLE_CELL_ALIGNMENT, TABLE_FLOW_DIRECTION, TEXT_ALIGN, TEXT_FIELD_SOURCE_PROPERTY, TEXT_FIELD_SOURCE_TYPE, TEXT_FLOW_DIRECTION, TOLERANCE_DISPLAY, TOLERANCE_TYPE, TOLERANCE_ZONE_TYPE, VERTICAL_ALIGN, VIEWPORT_SHADE_PLOT } from "../../flatbuffers/duc";
 import { Standard, StandardUnits } from "../../technical/standards";
 import { FONT_FAMILY, FREEDRAW_EASINGS } from "../../utils/constants";
 import { Axis, GeometricPoint, Percentage, Radian, ScaleFactor } from "../geometryTypes";
@@ -134,7 +134,7 @@ export type DucGenericElement = DucSelectionElement | DucRectangleElement;
  * no computed data. The list of all DucElements should be shareable
  * between peers and contain no state local to the peer.
  */
-export type DucElement = DucGenericElement | DucTextElement | DucLinearElement | DucFreeDrawElement | DucArrowElement | DucImageElement | DucFrameElement | DucEmbeddableElement | DucTableElement | DucDocElement | DucEllipseElement | DucPolygonElement | DucParametricElement | DucFeatureControlFrameElement | DucLeaderElement | DucDimensionElement | DucViewportElement | DucPlotElement | DucXRayElement | DucPdfElement | DucMermaidElement;
+export type DucElement = DucGenericElement | DucTextElement | DucLinearElement | DucFreeDrawElement | DucArrowElement | DucImageElement | DucFrameElement | DucEmbeddableElement | DucTableElement | DucDocElement | DucEllipseElement | DucPolygonElement | DucModelElement | DucFeatureControlFrameElement | DucLeaderElement | DucDimensionElement | DucViewportElement | DucPlotElement | DucXRayElement | DucPdfElement | DucMermaidElement;
 export type DucElementTypes = DucElement["type"];
 export type NonDeleted<TElement extends DucElement> = TElement & {
     isDeleted: boolean;
@@ -316,9 +316,21 @@ export type DucEllipseElement = _DucElementBase & {
 export type DucEmbeddableElement = _DucElementBase & {
     type: "embeddable";
 };
+/**
+ * Configuration for PDF grid layout
+ */
+export type DocumentGridConfig = {
+    columns: number;
+    gapX: number;
+    gapY: number;
+    alignItems: 'start' | 'center' | 'end';
+    firstPageAlone: boolean;
+};
 export type DucPdfElement = _DucElementBase & {
     type: "pdf";
     fileId: ExternalFileId | null;
+    /** Configuration for rendering the document in a grid layout */
+    gridConfig: DocumentGridConfig;
 };
 export type DucMermaidElement = _DucElementBase & {
     type: "mermaid";
@@ -1357,10 +1369,8 @@ export type TextColumn = {
 export type DucDocElement = _DucElementBase & DucDocStyle & {
     type: "doc";
     /**
-     * The content of the document, stored as a Markdown string.
-     * This approach allows a rich text editor (like Tiptap) to manage the complex
-     * inline formatting (bold, italic, colors, hyperlinks, etc.) while keeping the
-     * core data structure simple and clean.
+     * The content of the document, stored as a code string.
+     * This approach allows to use a rich text editor that can compile to PDF using Typst code
      *
      * It can also contain wildcards like `{@fieldname}` for dynamic data insertion.
      * Example: "This is **bold text** and this is a {color:red}red word{/color}."
@@ -1369,6 +1379,9 @@ export type DucDocElement = _DucElementBase & DucDocStyle & {
      * Example: "This document was last saved on {{SaveDate}} by {{Author}}."
      */
     text: string;
+    fileId: ExternalFileId | null;
+    /** Configuration for rendering the document in a grid layout */
+    gridConfig: DocumentGridConfig;
     /**
      * An array of metadata objects that define the behavior of the placeholders
      * found in the `text` property. If this is empty, the text is treated
@@ -1401,27 +1414,15 @@ export type DucDocElement = _DucElementBase & DucDocStyle & {
     autoResize: boolean;
 };
 /**
- * Defines the source of the 3D geometry for a Parametric Element.
- * The geometry is either generated from live code or loaded from an external file.
- */
-export type ParametricElementSource = {
-    /** The geometry is defined by executable Replicad code. */
-    type: PARAMETRIC_SOURCE_TYPE.CODE;
-    /** The JavaScript code that generates the Replicad model. */
-    code: string;
-} | {
-    /** The geometry is loaded from a static 3D file. */
-    type: PARAMETRIC_SOURCE_TYPE.FILE;
-    /** A reference to the imported file in the DucExternalFiles collection. */
-    fileId: ExternalFileId;
-};
-/**
- * An element that embeds a 3D model on the 2D canvas, defined either by
- * parametric Replicad code or by an imported 3D file (e.g., STEP, STL).
+ * An element that embeds a 3D model on the 2D canvas, defined by build123d python code.
  * It includes its own 3D view and display controls.
  */
-export type DucParametricElement = _DucElementBase & {
-    type: "parametric";
-    /** Defines the source of the 3D geometry (either from code or a file). */
-    source: ParametricElementSource;
+export type DucModelElement = _DucElementBase & {
+    type: "model";
+    /** Defines the source of the model using build123d python code */
+    source: string;
+    /** The last known SVG path representation of the 3D model for quick rendering on the canvas */
+    svgPath: string | null;
+    /** Possibly connected external files, such as STEP, STL or other reference models */
+    fileIds: ExternalFileId[];
 };

package/dist/types/elements/typeChecks.js

@@ -133,7 +133,7 @@ export const isDucElement = (element) => {
         case "leader":
         case "doc":
         case "selection":
-        case "parametric":
+        case "model":
         case "featurecontrolframe":
         case "viewport":
         case "plot":

package/dist/types/index.d.ts

@@ -1,14 +1,14 @@
 export * from "./elements";
 export * from "./geometryTypes";
-export * from "./utility-types";
 export * from "./typeChecks";
+export * from "./utility-types";
 import { OBJECT_SNAP_MODE, PRUNING_LEVEL } from "../flatbuffers/duc";
 import { SupportedMeasures } from "../technical/scopes";
 import { Standard } from "../technical/standards";
+import type { GRID_DISPLAY_TYPE, GRID_TYPE, SNAP_MARKER_SHAPE, SNAP_MODE, SNAP_OVERRIDE_BEHAVIOR } from "../utils/constants";
 import { DucBindableElement, DucBlock, DucBlockCollection, DucBlockInstance, DucElement, DucElementType, DucGroup, DucIframeLikeElement, DucLayer, DucLinearElement, DucPoint, DucRegion, DucTextElement, ElementBackground, ElementStroke, ExternalFileId, FontFamilyValues, LineHead, NonDeleted, TextAlign } from "./elements";
 import { GeometricPoint, Percentage, Radian, ScaleFactor } from "./geometryTypes";
 import { MakeBrand, MarkOptional, MaybePromise, ValueOf } from "./utility-types";
-import type { GRID_DISPLAY_TYPE, GRID_TYPE, SNAP_MARKER_SHAPE, SNAP_MODE, SNAP_OVERRIDE_BEHAVIOR } from "../utils/constants";
 /**
  * Root data structure for the stored data state
  */
@@ -112,7 +112,7 @@ export type SuggestedPointBinding = [
     "start" | "end" | "both",
     NonDeleted<DucBindableElement>
 ];
-export type ToolType = "selection" | "rectangle" | "polygon" | "ellipse" | "line" | "freedraw" | "text" | "image" | "eraser" | "hand" | "frame" | "plot" | "embeddable" | "ruler" | "lasso" | "laser" | "table";
+export type ToolType = "selection" | "rectangle" | "polygon" | "ellipse" | "line" | "freedraw" | "text" | "image" | "eraser" | "hand" | "frame" | "plot" | "embeddable" | "ruler" | "lasso" | "laser" | "table" | "doc" | "pdf";
 export type ElementOrToolType = DucElementType | ToolType | "custom";
 /**
  * Defines the global, persistent settings for the drawing. These are fundamental

package/dist/types/index.js

@@ -1,4 +1,4 @@
 export * from "./elements";
 export * from "./geometryTypes";
-export * from "./utility-types";
 export * from "./typeChecks";
+export * from "./utility-types";

package/dist/utils/elements/newElement.d.ts

@@ -1,5 +1,5 @@
 import { Scope } from "../../types";
-import { DucArrowElement, DucDimensionElement, DucDocElement, DucElement, DucEllipseElement, DucEmbeddableElement, DucFeatureControlFrameElement, DucFrameElement, DucFreeDrawElement, DucGenericElement, DucImageElement, DucLeaderElement, DucLinearElement, DucMermaidElement, DucParametricElement, DucPdfElement, DucPlotElement, DucPolygonElement, DucTableElement, DucTextElement, DucViewportElement, DucXRayElement, ElementConstructorOpts, ElementUpdate, NonDeleted } from "../../types/elements";
+import { DucArrowElement, DucDimensionElement, DucDocElement, DucElement, DucEllipseElement, DucEmbeddableElement, DucFeatureControlFrameElement, DucFrameElement, DucFreeDrawElement, DucGenericElement, DucImageElement, DucLeaderElement, DucLinearElement, DucMermaidElement, DucModelElement, DucPdfElement, DucPlotElement, DucPolygonElement, DucTableElement, DucTextElement, DucViewportElement, DucXRayElement, ElementConstructorOpts, ElementUpdate, NonDeleted } from "../../types/elements";
 import { Mutable } from "../../types/utility-types";
 export declare const newElementWith: <TElement extends DucElement>(element: TElement, updates: ElementUpdate<TElement>, 
 /** pass `true` to always regenerate */
@@ -46,7 +46,7 @@ export declare const newXRayElement: (currentScope: Scope, opts: ElementConstruc
 export declare const newLeaderElement: (currentScope: Scope, opts: Partial<DucLeaderElement> & ElementConstructorOpts) => NonDeleted<DucLeaderElement>;
 export declare const newDimensionElement: (currentScope: Scope, opts: ElementConstructorOpts) => NonDeleted<DucDimensionElement>;
 export declare const newFeatureControlFrameElement: (currentScope: Scope, opts: ElementConstructorOpts) => NonDeleted<DucFeatureControlFrameElement>;
-export declare const newParametricElement: (currentScope: Scope, opts: ElementConstructorOpts) => NonDeleted<DucParametricElement>;
+export declare const newParametricElement: (currentScope: Scope, opts: ElementConstructorOpts) => NonDeleted<DucModelElement>;
 /**
  * Clones DucElement data structure. Does not regenerate id, nonce, or
  * any value. The purpose is to to break object references for immutability

package/dist/utils/elements/newElement.js

@@ -10,7 +10,7 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 import { getUpdatedTimestamp, getZoom } from "..";
-import { BLOCK_ATTACHMENT, COLUMN_TYPE, DATUM_BRACKET_STYLE, IMAGE_STATUS, LINE_SPACING_TYPE, PARAMETRIC_SOURCE_TYPE, STACKED_TEXT_ALIGN, TEXT_FLOW_DIRECTION, VERTICAL_ALIGN, VIEWPORT_SHADE_PLOT } from "../../flatbuffers/duc";
+import { BLOCK_ATTACHMENT, COLUMN_TYPE, DATUM_BRACKET_STYLE, IMAGE_STATUS, LINE_SPACING_TYPE, STACKED_TEXT_ALIGN, TEXT_FLOW_DIRECTION, VERTICAL_ALIGN, VIEWPORT_SHADE_PLOT } from "../../flatbuffers/duc";
 import { getPrecisionValueFromRaw } from "../../technical/scopes";
 import { DEFAULT_ELEMENT_PROPS, DEFAULT_ELLIPSE_ELEMENT, DEFAULT_FONT_FAMILY, DEFAULT_FONT_SIZE, DEFAULT_FREEDRAW_ELEMENT, DEFAULT_POLYGON_SIDES, DEFAULT_TEXT_ALIGN, DEFAULT_VERTICAL_ALIGN } from "../constants";
 import { randomId, randomInteger } from "../math/random";
@@ -153,11 +153,11 @@ export const newImageElement = (currentScope, opts) => {
 export const newTableElement = (currentScope, opts) => (Object.assign(Object.assign(Object.assign({}, _newElementBase("table", currentScope, opts)), getDefaultTableData(currentScope)), { type: "table" }));
 export const newDocElement = (currentScope, opts) => {
     var _a, _b, _c, _d;
-    return (Object.assign(Object.assign({}, _newElementBase("doc", currentScope, opts)), { type: "doc", text: opts.text || "", dynamic: opts.dynamic || [], flowDirection: opts.flowDirection || TEXT_FLOW_DIRECTION.TOP_TO_BOTTOM, columns: opts.columns || { type: COLUMN_TYPE.NO_COLUMNS, definitions: [], autoHeight: true }, autoResize: (_a = opts.autoResize) !== null && _a !== void 0 ? _a : true, 
+    return (Object.assign(Object.assign({}, _newElementBase("doc", currentScope, opts)), { type: "doc", text: opts.text || "", dynamic: opts.dynamic || [], flowDirection: opts.flowDirection || TEXT_FLOW_DIRECTION.TOP_TO_BOTTOM, columns: opts.columns || { type: COLUMN_TYPE.NO_COLUMNS, definitions: [], autoHeight: true }, autoResize: (_a = opts.autoResize) !== null && _a !== void 0 ? _a : true, fileId: null, gridConfig: { columns: 1, gapX: 0, gapY: 0, alignItems: 'start', firstPageAlone: false }, 
         // DucDocStyle properties
         isLtr: (_b = opts.isLtr) !== null && _b !== void 0 ? _b : true, fontFamily: opts.fontFamily || DEFAULT_FONT_FAMILY, bigFontFamily: opts.bigFontFamily || "sans-serif", textAlign: opts.textAlign || DEFAULT_TEXT_ALIGN, verticalAlign: opts.verticalAlign || DEFAULT_VERTICAL_ALIGN, lineHeight: opts.lineHeight || 1.2, lineSpacing: opts.lineSpacing || { type: LINE_SPACING_TYPE.MULTIPLE, value: 1.2 }, obliqueAngle: opts.obliqueAngle || 0, fontSize: opts.fontSize || getPrecisionValueFromRaw(DEFAULT_FONT_SIZE, currentScope, currentScope), paperTextHeight: opts.paperTextHeight, widthFactor: opts.widthFactor || 1, isUpsideDown: (_c = opts.isUpsideDown) !== null && _c !== void 0 ? _c : false, isBackwards: (_d = opts.isBackwards) !== null && _d !== void 0 ? _d : false, paragraph: opts.paragraph || { firstLineIndent: getPrecisionValueFromRaw(0, currentScope, currentScope), hangingIndent: getPrecisionValueFromRaw(0, currentScope, currentScope), leftIndent: getPrecisionValueFromRaw(0, currentScope, currentScope), rightIndent: getPrecisionValueFromRaw(0, currentScope, currentScope), spaceBefore: getPrecisionValueFromRaw(0, currentScope, currentScope), spaceAfter: getPrecisionValueFromRaw(0, currentScope, currentScope), tabStops: [] }, stackFormat: opts.stackFormat || { autoStack: false, stackChars: [], properties: { upperScale: 0.7, lowerScale: 0.7, alignment: STACKED_TEXT_ALIGN.CENTER } } }));
 };
-export const newPdfElement = (currentScope, opts) => (Object.assign(Object.assign({ fileId: null }, _newElementBase("pdf", currentScope, opts)), { type: "pdf" }));
+export const newPdfElement = (currentScope, opts) => (Object.assign(Object.assign({ fileId: null, gridConfig: { columns: 1, gapX: 0, gapY: 0, alignItems: 'start', firstPageAlone: false } }, _newElementBase("pdf", currentScope, opts)), { type: "pdf" }));
 export const newMermaidElement = (currentScope, opts) => (Object.assign(Object.assign({ source: "", theme: undefined, svgPath: null }, _newElementBase("mermaid", currentScope, opts)), { type: "mermaid" }));
 export const newXRayElement = (currentScope, opts) => (Object.assign(Object.assign({ origin: { x: getPrecisionValueFromRaw(0, currentScope, currentScope), y: getPrecisionValueFromRaw(0, currentScope, currentScope) }, direction: { x: getPrecisionValueFromRaw(1, currentScope, currentScope), y: getPrecisionValueFromRaw(0, currentScope, currentScope) }, startFromOrigin: false, color: '#FF00FF' }, _newElementBase("xray", currentScope, opts)), { type: "xray" }));
 export const newLeaderElement = (currentScope, opts) => {
@@ -179,7 +179,7 @@ export const newFeatureControlFrameElement = (currentScope, opts) => {
             bracketStyle: DATUM_BRACKET_STYLE.SQUARE
         } }, _newElementBase("featurecontrolframe", currentScope, opts)), { type: "featurecontrolframe" });
 };
-export const newParametricElement = (currentScope, opts) => (Object.assign(Object.assign({ source: { type: PARAMETRIC_SOURCE_TYPE.CODE, code: "" } }, _newElementBase("parametric", currentScope, opts)), { type: 'parametric' }));
+export const newParametricElement = (currentScope, opts) => (Object.assign(Object.assign({ source: "", svgPath: null, fileIds: [] }, _newElementBase("model", currentScope, opts)), { type: 'model' }));
 // Simplified deep clone for the purpose of cloning DucElement.
 //
 // Only clones plain objects and arrays. Doesn't clone Date, RegExp, Map, Set,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ducjs",
-  "version": "2.2.3",
+  "version": "2.3.0",
   "description": "The duc 2D CAD file format is a cornerstone of our advanced design system, conceived to cater to professionals seeking precision and efficiency in their design work.",
   "type": "module",
   "main": "dist/index.js",