ducjs 2.2.2 → 2.3.0

package/dist/serialize.js

@@ -18,6 +18,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 */
 import * as flatbuffers from "flatbuffers";
 import * as Duc from "./flatbuffers/duc";
+import { zlibSync, strToU8 } from "fflate";
 import { restore } from "./restore";
 import { encodeFunctionString, EXPORT_DATA_TYPES } from "./utils";
 /**
@@ -377,7 +378,7 @@ function writeElementBase(b, e, usv) {
     const frameId = str(b, (_j = e.frameId) !== null && _j !== void 0 ? _j : undefined);
     const bound = ((_k = e.boundElements) === null || _k === void 0 ? void 0 : _k.length) ? Duc._DucElementBase.createBoundElementsVector(b, e.boundElements.map((x) => writeBoundElement(b, x, usv))) : undefined;
     const link = str(b, (_l = e.link) !== null && _l !== void 0 ? _l : undefined);
-    const custom = e.customData != null ? str(b, JSON.stringify(e.customData)) : undefined;
+    const custom = e.customData != null ? Duc._DucElementBase.createCustomDataVector(b, zlibSync(strToU8(JSON.stringify(e.customData)))) : undefined;
     Duc._DucElementBase.start_DucElementBase(b);
     if (id)
         Duc._DucElementBase.addId(b, id);
@@ -739,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);
@@ -776,7 +795,7 @@ function writeBlockAttrDef(b, d, usv) {
 }
 function writeBlockMetadata(b, metadata) {
     const source = b.createString(metadata.source);
-    const localization = metadata.localization ? b.createString(JSON.stringify(metadata.localization)) : undefined;
+    const localization = metadata.localization ? Duc.DucBlockMetadata.createLocalizationVector(b, zlibSync(strToU8(JSON.stringify(metadata.localization)))) : undefined;
     Duc.DucBlockMetadata.startDucBlockMetadata(b);
     Duc.DucBlockMetadata.addSource(b, source);
     Duc.DucBlockMetadata.addUsageCount(b, metadata.usageCount);
@@ -835,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;
@@ -870,9 +895,9 @@ function writeBlockCollection(b, c) {
         const metadata = c.metadata;
         let localizationOffset;
         if (metadata.localization) {
-            // localization is stored as a JSON string
-            const localizationStr = JSON.stringify(metadata.localization);
-            localizationOffset = b.createString(localizationStr);
+            // localization is stored as compressed binary JSON data
+            const localizationBin = zlibSync(strToU8(JSON.stringify(metadata.localization)));
+            localizationOffset = Duc.DucBlockMetadata.createLocalizationVector(b, localizationBin);
         }
         const source = b.createString(metadata.source);
         Duc.DucBlockMetadata.startDucBlockMetadata(b);
@@ -1377,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);
@@ -1385,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) {
@@ -1431,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);
@@ -1632,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;
@@ -2228,28 +2257,18 @@ function serializeCheckpoint(b, c) {
     return Duc.Checkpoint.endCheckpoint(b);
 }
 function writeJsonPatch(b, p) {
-    const ops = p.map((op) => {
-        const opStr = b.createString(op.op);
-        const pathStr = b.createString(op.path);
-        const fromStr = op.from !== undefined ? b.createString(op.from) : undefined;
-        const valueStr = op.value !== undefined ? b.createString(JSON.stringify(op.value)) : undefined;
-        Duc.JSONPatchOperation.startJSONPatchOperation(b);
-        Duc.JSONPatchOperation.addOp(b, opStr);
-        Duc.JSONPatchOperation.addPath(b, pathStr);
-        if (fromStr)
-            Duc.JSONPatchOperation.addFrom(b, fromStr);
-        if (valueStr)
-            Duc.JSONPatchOperation.addValue(b, valueStr);
-        return Duc.JSONPatchOperation.endJSONPatchOperation(b);
-    });
-    return Duc.Delta.createPatchVector(b, ops);
+    // Compress the JSON patch data
+    const patchData = zlibSync(strToU8(JSON.stringify(p)));
+    const offset = Duc.Delta.createPatchVector(b, patchData);
+    return { offset, sizeBytes: patchData.length };
 }
 function serializeDelta(b, d) {
     const base = serializeVersionBase(b, d);
-    const patch = writeJsonPatch(b, d.patch);
+    const { offset: patch, sizeBytes } = writeJsonPatch(b, d.patch);
     Duc.Delta.startDelta(b);
     Duc.Delta.addBase(b, base);
     Duc.Delta.addPatch(b, patch);
+    Duc.Delta.addSizeBytes(b, BigInt(sizeBytes));
     return Duc.Delta.endDelta(b);
 }
 function serializeDucVersionGraph(b, vg) {

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";
@@ -746,8 +758,10 @@ export type DucBlockAttributeDefinition = {
     /** If true, the attribute's value is fixed and cannot be changed after insertion. */
     isConstant: boolean;
 };
-/** Indicates whether the block belongs to the project, organization or community */
-export type BlockSourceType = string | "organization" | "community";
+/**
+ * Indicates the source drawing of a block.
+ */
+export type BlockSource = string;
 export interface BlockLocalizationEntry {
     title: string;
     description?: string;
@@ -758,8 +772,8 @@ export interface BlockLocalizationEntry {
  */
 export type BlockLocalizationMap = Record<string, BlockLocalizationEntry>;
 export interface DucBlockMetadata {
-    /** Indicates whether the block belongs to the project, organization or community */
-    source: BlockSourceType;
+    /** Drawing id this block originates from */
+    source?: BlockSource;
     /** Total number of times the block was instantiated */
     usageCount: number;
     /** Creation timestamp */
@@ -1355,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}."
@@ -1367,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
@@ -1399,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, MaybePromise, ValueOf } from "./utility-types";
-import type { GRID_DISPLAY_TYPE, GRID_TYPE, SNAP_MARKER_SHAPE, SNAP_MODE, SNAP_OVERRIDE_BEHAVIOR } from "../utils/constants";
+import { MakeBrand, MarkOptional, MaybePromise, ValueOf } from "./utility-types";
 /**
  * Root data structure for the stored data state
  */
@@ -37,6 +37,7 @@ export interface ExportedDataState {
     id: string | undefined;
 }
 export type ExportedDataStateContent = Omit<ExportedDataState, "type" | "version" | "source">;
+export type BaseExportedDataState = MarkOptional<ExportedDataStateContent, "elements" | "localState" | "versionGraph">;
 /**
  * A version of the data state where all fields are optional.
  * This is useful for importing data where some fields might be missing.
@@ -111,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/dist/utils/index.d.ts

@@ -24,6 +24,7 @@ export declare const isFiniteNumber: (value: any) => value is number;
 export declare const arrayToMap: <T extends {
     id: string;
 } | string>(items: readonly T[] | Map<string, T>) => Map<any, any>;
+export declare function omitKeys<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
 /**
  * Checks whether first directional character is RTL. Meaning whether it starts
  *  with RTL characters, or indeterminate (numbers etc.) characters followed by

package/dist/utils/index.js

@@ -41,6 +41,11 @@ export const arrayToMap = (items) => {
         return acc;
     }, new Map());
 };
+export function omitKeys(obj, keys) {
+    const result = Object.assign({}, obj);
+    keys.forEach(key => delete result[key]);
+    return result;
+}
 const RS_LTR_CHARS = "A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02B8\u0300-\u0590\u0800-\u1FFF" +
     "\u2C00-\uFB1C\uFDFE-\uFE6F\uFEFD-\uFFFF";
 const RS_RTL_CHARS = "\u0591-\u07FF\uFB1D-\uFDFD\uFE70-\uFEFC";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ducjs",
-  "version": "2.2.2",
+  "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",
@@ -43,12 +43,13 @@
     "undici-types": "^6.21.0"
   },
   "dependencies": {
-    "flatbuffers": "^24.12.23",
-    "nanoid": "5.1.5",
-    "tinycolor2": "1.6.0",
     "@braintree/sanitize-url": "6.0.2",
     "browser-fs-access": "0.35.0",
-    "perfect-freehand": "1.2.2"
+    "fflate": "^0.8.2",
+    "flatbuffers": "^24.12.23",
+    "nanoid": "5.1.5",
+    "perfect-freehand": "1.2.2",
+    "tinycolor2": "1.6.0"
   },
   "files": [
     "dist",