ducjs 2.0.1 → 2.1.0

package/dist/restore/restoreDataState.d.ts

@@ -20,6 +20,7 @@ export type RestoredDataState = {
     layers: DucLayer[];
     standards: Standard[];
     versionGraph: VersionGraph | undefined;
+    id: string;
 };
 export interface ExportedLibraryData {
     type: string;
@@ -41,7 +42,10 @@ export type ElementsConfig = {
      */
     passThroughElementIds?: string[];
 };
-export declare const restore: (data: ImportedDataState | null, elementsConfig: ElementsConfig) => RestoredDataState;
+export type RestoreConfig = {
+    forceScope?: Scope;
+};
+export declare const restore: (data: ImportedDataState | null, elementsConfig: ElementsConfig, restoreConfig?: RestoreConfig) => RestoredDataState;
 export declare const restoreFiles: (importedFiles: unknown) => DucExternalFiles;
 export declare const restoreDictionary: (importedDictionary: unknown) => Dictionary;
 /**
@@ -100,7 +104,7 @@ export declare const restoreGlobalState: (importedState?: Partial<DucGlobalState
  * @param restoredGlobalState - The complete and valid global state for the document.
  * @returns A complete and valid DucLocalState object.
  */
-export declare const restoreLocalState: (importedState: Partial<DucLocalState> | undefined, restoredGlobalState: RestoredDataState["globalState"], restoredStandards: RestoredDataState["standards"]) => DucLocalState;
+export declare const restoreLocalState: (importedState: Partial<DucLocalState> | undefined, restoredGlobalState: RestoredDataState["globalState"], restoredStandards: RestoredDataState["standards"], forceScope?: Scope) => DucLocalState;
 export declare const restoreVersionGraph: (importedGraph: any) => RestoredDataState["versionGraph"];
 /**
  * Restores common properties for elements leveraging _DucStackBase.

package/dist/restore/restoreDataState.js

@@ -1,4 +1,5 @@
 import { BEZIER_MIRRORING, BLENDING, BOOLEAN_OPERATION, ELEMENT_CONTENT_PREFERENCE, IMAGE_STATUS, LINE_HEAD, PRUNING_LEVEL, STROKE_CAP, STROKE_JOIN, STROKE_PLACEMENT, STROKE_PREFERENCE, STROKE_SIDE_PREFERENCE, TEXT_ALIGN, VERTICAL_ALIGN, } from "../flatbuffers/duc";
+import { nanoid } from "nanoid";
 import { restoreElements } from "./restoreElements";
 import { isStandardIdPresent, restoreStandards, } from "./restoreStandards";
 import { getPrecisionScope } from "../technical/measurements";
@@ -8,11 +9,11 @@ import { base64ToUint8Array, getDefaultGlobalState, getDefaultLocalState, getZoo
 import { DEFAULT_ELEMENT_PROPS, DEFAULT_POLYGON_SIDES, DEFAULT_TEXT_ALIGN, DEFAULT_VERTICAL_ALIGN, DEFAULT_ZOOM_STEP, MAX_ZOOM_STEP, MIN_ZOOM_STEP, } from "../utils/constants";
 import { getDefaultStackProperties } from "../utils/elements";
 import tinycolor from "tinycolor2";
-export const restore = (data, elementsConfig) => {
+export const restore = (data, elementsConfig, restoreConfig = {}) => {
     const restoredStandards = restoreStandards(data === null || data === void 0 ? void 0 : data.standards);
     const restoredDictionary = restoreDictionary(data === null || data === void 0 ? void 0 : data.dictionary);
     const restoredGlobalState = restoreGlobalState(data === null || data === void 0 ? void 0 : data.globalState);
-    const restoredLocalState = restoreLocalState(data === null || data === void 0 ? void 0 : data.localState, restoredGlobalState, restoredStandards);
+    const restoredLocalState = restoreLocalState(data === null || data === void 0 ? void 0 : data.localState, restoredGlobalState, restoredStandards, restoreConfig.forceScope);
     const restoredElementsConfig = Object.assign(Object.assign({}, elementsConfig), { localState: restoredLocalState });
     const restoredBlocks = restoreBlocks(data === null || data === void 0 ? void 0 : data.blocks, restoredLocalState.scope, restoredElementsConfig);
     const restoredRegions = restoreRegions(data === null || data === void 0 ? void 0 : data.regions);
@@ -20,6 +21,9 @@ export const restore = (data, elementsConfig) => {
     const restoredLayers = restoreLayers(data === null || data === void 0 ? void 0 : data.layers, 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
+    const parsedId = data === null || data === void 0 ? void 0 : data.id;
+    const restoredId = (parsedId && parsedId.trim().length > 0) ? parsedId : nanoid();
     return {
         dictionary: restoredDictionary,
         thumbnail: isValidUint8Array(data === null || data === void 0 ? void 0 : data.thumbnail),
@@ -33,6 +37,7 @@ export const restore = (data, elementsConfig) => {
         localState: restoredLocalState,
         globalState: restoredGlobalState,
         files: restoreFiles(data === null || data === void 0 ? void 0 : data.files),
+        id: restoredId,
     };
 };
 export const restoreFiles = (importedFiles) => {
@@ -211,13 +216,13 @@ export const restoreBlocks = (blocks, currentScope, elementsConfig) => {
  * @returns A complete and valid DucGlobalState object.
  */
 export const restoreGlobalState = (importedState = {}) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
     const defaults = getDefaultGlobalState();
-    const linearPrecision = isValidFinitePositiveByteValue(importedState.coordDecimalPlaces, defaults.displayPrecision.linear);
-    return Object.assign(Object.assign({}, defaults), { name: (_a = importedState.name) !== null && _a !== void 0 ? _a : defaults.name, viewBackgroundColor: (_b = importedState.viewBackgroundColor) !== null && _b !== void 0 ? _b : defaults.viewBackgroundColor, mainScope: (_c = isValidAppStateScopeValue(importedState.mainScope)) !== null && _c !== void 0 ? _c : defaults.mainScope, scopeExponentThreshold: isValidAppStateScopeExponentThresholdValue(importedState.scopeExponentThreshold, defaults.scopeExponentThreshold), dashSpacingScale: (_d = importedState.dashSpacingScale) !== null && _d !== void 0 ? _d : defaults.dashSpacingScale, isDashSpacingAffectedByViewportScale: (_e = importedState.isDashSpacingAffectedByViewportScale) !== null && _e !== void 0 ? _e : defaults.isDashSpacingAffectedByViewportScale, dimensionsAssociativeByDefault: (_f = importedState.dimensionsAssociativeByDefault) !== null && _f !== void 0 ? _f : defaults.dimensionsAssociativeByDefault, useAnnotativeScaling: (_g = importedState.useAnnotativeScaling) !== null && _g !== void 0 ? _g : defaults.useAnnotativeScaling, displayPrecision: {
+    const linearPrecision = isValidFinitePositiveByteValue((_a = importedState === null || importedState === void 0 ? void 0 : importedState.displayPrecision) === null || _a === void 0 ? void 0 : _a.linear, defaults.displayPrecision.linear);
+    return Object.assign(Object.assign({}, defaults), { name: (_b = importedState === null || importedState === void 0 ? void 0 : importedState.name) !== null && _b !== void 0 ? _b : defaults.name, viewBackgroundColor: (_c = importedState === null || importedState === void 0 ? void 0 : importedState.viewBackgroundColor) !== null && _c !== void 0 ? _c : defaults.viewBackgroundColor, mainScope: (_d = isValidAppStateScopeValue(importedState === null || importedState === void 0 ? void 0 : importedState.mainScope)) !== null && _d !== void 0 ? _d : defaults.mainScope, scopeExponentThreshold: isValidAppStateScopeExponentThresholdValue(importedState === null || importedState === void 0 ? void 0 : importedState.scopeExponentThreshold, defaults.scopeExponentThreshold), dashSpacingScale: (_e = importedState === null || importedState === void 0 ? void 0 : importedState.dashSpacingScale) !== null && _e !== void 0 ? _e : defaults.dashSpacingScale, isDashSpacingAffectedByViewportScale: (_f = importedState === null || importedState === void 0 ? void 0 : importedState.isDashSpacingAffectedByViewportScale) !== null && _f !== void 0 ? _f : defaults.isDashSpacingAffectedByViewportScale, dimensionsAssociativeByDefault: (_g = importedState === null || importedState === void 0 ? void 0 : importedState.dimensionsAssociativeByDefault) !== null && _g !== void 0 ? _g : defaults.dimensionsAssociativeByDefault, useAnnotativeScaling: (_h = importedState === null || importedState === void 0 ? void 0 : importedState.useAnnotativeScaling) !== null && _h !== void 0 ? _h : defaults.useAnnotativeScaling, displayPrecision: {
             linear: linearPrecision,
-            angular: (_j = (_h = importedState.displayPrecision) === null || _h === void 0 ? void 0 : _h.angular) !== null && _j !== void 0 ? _j : defaults.displayPrecision.angular,
-        }, pruningLevel: importedState.pruningLevel &&
+            angular: (_k = (_j = importedState === null || importedState === void 0 ? void 0 : importedState.displayPrecision) === null || _j === void 0 ? void 0 : _j.angular) !== null && _k !== void 0 ? _k : defaults.displayPrecision.angular,
+        }, pruningLevel: (importedState === null || importedState === void 0 ? void 0 : importedState.pruningLevel) &&
             Object.values(PRUNING_LEVEL).includes(importedState.pruningLevel)
             ? importedState.pruningLevel
             : PRUNING_LEVEL.BALANCED });
@@ -231,16 +236,18 @@ export const restoreGlobalState = (importedState = {}) => {
  * @param restoredGlobalState - The complete and valid global state for the document.
  * @returns A complete and valid DucLocalState object.
  */
-export const restoreLocalState = (importedState = {}, restoredGlobalState, restoredStandards) => {
+export const restoreLocalState = (importedState = {}, restoredGlobalState, restoredStandards, forceScope) => {
     var _a, _b, _c, _d, _e, _f, _g, _h;
     const defaults = getDefaultLocalState();
-    const zoom = getZoom((_b = (_a = importedState.zoom) === null || _a === void 0 ? void 0 : _a.value) !== null && _b !== void 0 ? _b : defaults.zoom.value, restoredGlobalState.mainScope, restoredGlobalState.scopeExponentThreshold);
-    const scope = isValidPrecisionScopeValue(zoom.value, restoredGlobalState.mainScope, restoredGlobalState.scopeExponentThreshold);
-    return Object.assign(Object.assign(Object.assign({}, defaults), importedState), { scope, activeStandardId: isValidStandardId(importedState.activeStandardId, restoredStandards, defaults.activeStandardId), isBindingEnabled: isValidBoolean(importedState.isBindingEnabled, defaults.isBindingEnabled), penMode: isValidBoolean(importedState.penMode, defaults.penMode), scrollX: importedState.scrollX
+    const zoom = getZoom((_b = (_a = importedState === null || importedState === void 0 ? void 0 : importedState.zoom) === null || _a === void 0 ? void 0 : _a.value) !== null && _b !== void 0 ? _b : defaults.zoom.value, restoredGlobalState.mainScope, restoredGlobalState.scopeExponentThreshold);
+    const scope = forceScope
+        ? isValidScopeValue(forceScope)
+        : isValidPrecisionScopeValue(zoom.value, restoredGlobalState.mainScope, restoredGlobalState.scopeExponentThreshold);
+    return Object.assign(Object.assign(Object.assign({}, defaults), importedState), { scope, activeStandardId: isValidStandardId(importedState === null || importedState === void 0 ? void 0 : importedState.activeStandardId, restoredStandards, defaults.activeStandardId), isBindingEnabled: isValidBoolean(importedState === null || importedState === void 0 ? void 0 : importedState.isBindingEnabled, defaults.isBindingEnabled), penMode: isValidBoolean(importedState === null || importedState === void 0 ? void 0 : importedState.penMode, defaults.penMode), scrollX: (importedState === null || importedState === void 0 ? void 0 : importedState.scrollX)
             ? restorePrecisionValue(importedState.scrollX, NEUTRAL_SCOPE, scope)
-            : getPrecisionValueFromRaw(defaults.scrollX.value, NEUTRAL_SCOPE, scope), scrollY: importedState.scrollY
+            : getPrecisionValueFromRaw(defaults.scrollX.value, NEUTRAL_SCOPE, scope), scrollY: (importedState === null || importedState === void 0 ? void 0 : importedState.scrollY)
             ? restorePrecisionValue(importedState.scrollY, NEUTRAL_SCOPE, scope)
-            : getPrecisionValueFromRaw(defaults.scrollY.value, NEUTRAL_SCOPE, scope), zoom, activeGridSettings: (_c = importedState.activeGridSettings) !== null && _c !== void 0 ? _c : defaults.activeGridSettings, activeSnapSettings: (_d = importedState.activeSnapSettings) !== null && _d !== void 0 ? _d : defaults.activeSnapSettings, currentItemStroke: (_e = validateStroke(importedState.currentItemStroke, scope, scope)) !== null && _e !== void 0 ? _e : defaults.currentItemStroke, currentItemBackground: (_f = validateBackground(importedState.currentItemBackground)) !== null && _f !== void 0 ? _f : defaults.currentItemBackground, currentItemOpacity: isValidPercentageValue(importedState.currentItemOpacity, defaults.currentItemOpacity), currentItemStartLineHead: (_g = isValidLineHeadValue(importedState.currentItemStartLineHead)) !== null && _g !== void 0 ? _g : defaults.currentItemStartLineHead, currentItemEndLineHead: (_h = isValidLineHeadValue(importedState.currentItemEndLineHead)) !== null && _h !== void 0 ? _h : defaults.currentItemEndLineHead });
+            : getPrecisionValueFromRaw(defaults.scrollY.value, NEUTRAL_SCOPE, scope), zoom, activeGridSettings: (_c = importedState === null || importedState === void 0 ? void 0 : importedState.activeGridSettings) !== null && _c !== void 0 ? _c : defaults.activeGridSettings, activeSnapSettings: (_d = importedState === null || importedState === void 0 ? void 0 : importedState.activeSnapSettings) !== null && _d !== void 0 ? _d : defaults.activeSnapSettings, currentItemStroke: (_e = validateStroke(importedState === null || importedState === void 0 ? void 0 : importedState.currentItemStroke, scope, scope)) !== null && _e !== void 0 ? _e : defaults.currentItemStroke, currentItemBackground: (_f = validateBackground(importedState === null || importedState === void 0 ? void 0 : importedState.currentItemBackground)) !== null && _f !== void 0 ? _f : defaults.currentItemBackground, currentItemOpacity: isValidPercentageValue(importedState === null || importedState === void 0 ? void 0 : importedState.currentItemOpacity, defaults.currentItemOpacity), currentItemStartLineHead: (_g = isValidLineHeadValue(importedState === null || importedState === void 0 ? void 0 : importedState.currentItemStartLineHead)) !== null && _g !== void 0 ? _g : defaults.currentItemStartLineHead, currentItemEndLineHead: (_h = isValidLineHeadValue(importedState === null || importedState === void 0 ? void 0 : importedState.currentItemEndLineHead)) !== null && _h !== void 0 ? _h : defaults.currentItemEndLineHead });
 };
 export const restoreVersionGraph = (importedGraph) => {
     if (!importedGraph || typeof importedGraph !== "object") {

package/dist/restore/restoreElements.js

@@ -1258,17 +1258,24 @@ const restoreFcfDatumDefinition = (def, elementScope, currentScope, restoredBloc
 const restoreTextStyle = (style, currentScope) => {
     var _a, _b, _c;
     const defaultLineHeight = 1.15;
-    return Object.assign(Object.assign(Object.assign({}, ((style === null || style === void 0 ? void 0 : style.background)
-        ? { background: style.background.map(validateBackground) }
-        : { background: [DEFAULT_ELEMENT_PROPS.background] })), ((style === null || style === void 0 ? void 0 : style.stroke)
-        ? {
-            stroke: style.stroke.map((s) => validateStroke(s, NEUTRAL_SCOPE, currentScope)),
-        }
-        : { stroke: [DEFAULT_ELEMENT_PROPS.stroke] })), { roundness: restorePrecisionValue(style === null || style === void 0 ? void 0 : style.roundness, NEUTRAL_SCOPE, currentScope, DEFAULT_ELEMENT_PROPS.roundness.value), opacity: isValidPercentageValue(style === null || style === void 0 ? void 0 : style.opacity, DEFAULT_ELEMENT_PROPS.opacity), blending: isValidBlendingValue(style === null || style === void 0 ? void 0 : style.blending), 
+    return {
         // Text-specific styles
-        isLtr: isValidBoolean(style === null || style === void 0 ? void 0 : style.isLtr, true), fontFamily: getFontFamilyByName(style === null || style === void 0 ? void 0 : style.fontFamily), bigFontFamily: isValidString(style === null || style === void 0 ? void 0 : style.bigFontFamily, "sans-serif"), textAlign: isValidTextAlignValue(style === null || style === void 0 ? void 0 : style.textAlign), verticalAlign: isValidVerticalAlignValue(style === null || style === void 0 ? void 0 : style.verticalAlign), lineHeight: (_a = style === null || style === void 0 ? void 0 : style.lineHeight) !== null && _a !== void 0 ? _a : defaultLineHeight, lineSpacing: restoreLineSpacing(style === null || style === void 0 ? void 0 : style.lineSpacing, (_b = style === null || style === void 0 ? void 0 : style.lineHeight) !== null && _b !== void 0 ? _b : defaultLineHeight.valueOf(), currentScope), obliqueAngle: isValidRadianValue(style === null || style === void 0 ? void 0 : style.obliqueAngle, 0), fontSize: restorePrecisionValue(style === null || style === void 0 ? void 0 : style.fontSize, NEUTRAL_SCOPE, currentScope, DEFAULT_FONT_SIZE), paperTextHeight: (style === null || style === void 0 ? void 0 : style.paperTextHeight)
+        isLtr: isValidBoolean(style === null || style === void 0 ? void 0 : style.isLtr, true),
+        fontFamily: getFontFamilyByName(style === null || style === void 0 ? void 0 : style.fontFamily),
+        bigFontFamily: isValidString(style === null || style === void 0 ? void 0 : style.bigFontFamily, "sans-serif"),
+        textAlign: isValidTextAlignValue(style === null || style === void 0 ? void 0 : style.textAlign),
+        verticalAlign: isValidVerticalAlignValue(style === null || style === void 0 ? void 0 : style.verticalAlign),
+        lineHeight: (_a = style === null || style === void 0 ? void 0 : style.lineHeight) !== null && _a !== void 0 ? _a : defaultLineHeight,
+        lineSpacing: restoreLineSpacing(style === null || style === void 0 ? void 0 : style.lineSpacing, (_b = style === null || style === void 0 ? void 0 : style.lineHeight) !== null && _b !== void 0 ? _b : defaultLineHeight.valueOf(), currentScope),
+        obliqueAngle: isValidRadianValue(style === null || style === void 0 ? void 0 : style.obliqueAngle, 0),
+        fontSize: restorePrecisionValue(style === null || style === void 0 ? void 0 : style.fontSize, NEUTRAL_SCOPE, currentScope, DEFAULT_FONT_SIZE),
+        paperTextHeight: (style === null || style === void 0 ? void 0 : style.paperTextHeight)
             ? restorePrecisionValue(style.paperTextHeight, NEUTRAL_SCOPE, currentScope)
-            : undefined, widthFactor: (_c = style === null || style === void 0 ? void 0 : style.widthFactor) !== null && _c !== void 0 ? _c : 1, isUpsideDown: isValidBoolean(style === null || style === void 0 ? void 0 : style.isUpsideDown, false), isBackwards: isValidBoolean(style === null || style === void 0 ? void 0 : style.isBackwards, false) });
+            : undefined,
+        widthFactor: (_c = style === null || style === void 0 ? void 0 : style.widthFactor) !== null && _c !== void 0 ? _c : 1,
+        isUpsideDown: isValidBoolean(style === null || style === void 0 ? void 0 : style.isUpsideDown, false),
+        isBackwards: isValidBoolean(style === null || style === void 0 ? void 0 : style.isBackwards, false),
+    };
 };
 const restoreHeadsOverride = (heads, restoredBlocks, elementScope, currentScope) => {
     if (!Array.isArray(heads) || heads.length !== 2)

package/dist/serialize.d.ts

@@ -1,3 +1,4 @@
 import { ImportedDataState } from "./types";
+import { RestoreConfig } from "./restore";
 export declare const DUC_SCHEMA_VERSION: any;
-export declare const serializeDuc: (data: ImportedDataState, useScopedValues?: boolean, passThroughElementIds?: string[]) => Promise<Uint8Array>;
+export declare const serializeDuc: (data: ImportedDataState, useScopedValues?: boolean, passThroughElementIds?: string[], restoreConfig?: RestoreConfig) => Promise<Uint8Array>;

package/dist/serialize.js

@@ -16,8 +16,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
      cast to number at the final write site (e.g. pv.value).
    - Keep args strongly typed. Never use any for function args.
 */
-import * as Duc from "./flatbuffers/duc";
 import * as flatbuffers from "flatbuffers";
+import * as Duc from "./flatbuffers/duc";
 import { restore } from "./restore";
 import { encodeFunctionString, EXPORT_DATA_TYPES } from "./utils";
 /**
@@ -584,13 +584,10 @@ function writeLineSpacing(b, ls, usv) {
     return Duc.LineSpacing.endLineSpacing(b);
 }
 function writeTextStyle(b, s, usv) {
-    const base = writeStylesBase(b, s, usv);
     const lineSpacing = writeLineSpacing(b, s.lineSpacing, usv);
     const fontFamily = str(b, s.fontFamily.toString());
     const bigFont = str(b, s.bigFontFamily);
     Duc.DucTextStyle.startDucTextStyle(b);
-    if (base)
-        Duc.DucTextStyle.addBaseStyle(b, base);
     Duc.DucTextStyle.addIsLtr(b, s.isLtr);
     if (fontFamily)
         Duc.DucTextStyle.addFontFamily(b, fontFamily);
@@ -879,11 +876,8 @@ function writePlotLayout(b, l, usv) {
 }
 function writePlot(b, e, usv) {
     const stackBase = writeStackElementBase(b, e, usv);
-    const baseStyle = writeStylesBase(b, e, usv);
     const plotStyle = (() => {
         Duc.DucPlotStyle.startDucPlotStyle(b);
-        if (baseStyle)
-            Duc.DucPlotStyle.addBaseStyle(b, baseStyle);
         return Duc.DucPlotStyle.endDucPlotStyle(b);
     })();
     const layout = writePlotLayout(b, e.layout, usv);
@@ -910,10 +904,7 @@ function writeView(b, v, usv) {
     return Duc.DucView.endDucView(b);
 }
 function writeViewportStyle(b, s, usv) {
-    const base = writeStylesBase(b, s, usv);
     Duc.DucViewportStyle.startDucViewportStyle(b);
-    if (base)
-        Duc.DucViewportStyle.addBaseStyle(b, base);
     Duc.DucViewportStyle.addScaleIndicatorVisible(b, s.scaleIndicatorVisible);
     return Duc.DucViewportStyle.endDucViewportStyle(b);
 }
@@ -940,11 +931,8 @@ function writeViewport(b, e, usv) {
     return Duc.DucViewportElement.endDucViewportElement(b);
 }
 function writeXRayStyle(b, s, usv) {
-    const base = writeStylesBase(b, s, usv);
     const color = b.createString(s.color);
     Duc.DucXRayStyle.startDucXRayStyle(b);
-    if (base)
-        Duc.DucXRayStyle.addBaseStyle(b, base);
     Duc.DucXRayStyle.addColor(b, color);
     return Duc.DucXRayStyle.endDucXRayStyle(b);
 }
@@ -999,12 +987,9 @@ function writeLeaderContent(b, c, usv) {
     return Duc.LeaderContent.endLeaderContent(b);
 }
 function writeLeaderStyle(b, s, usv) {
-    const base = writeStylesBase(b, s, usv);
     const text = writeTextStyle(b, s.textStyle, usv);
     const heads = s.headsOverride ? Duc.DucLeaderStyle.createHeadsOverrideVector(b, s.headsOverride.map((h) => writeHead(b, h, usv))) : undefined;
     Duc.DucLeaderStyle.startDucLeaderStyle(b);
-    if (base)
-        Duc.DucLeaderStyle.addBaseStyle(b, base);
     if (heads)
         Duc.DucLeaderStyle.addHeadsOverride(b, heads);
     if (s.dogleg !== undefined)
@@ -1249,7 +1234,6 @@ function writeFcfDatumDefinition(b, d, usv) {
     return Duc.FCFDatumDefinition.endFCFDatumDefinition(b);
 }
 function writeFcfStyle(b, s, usv) {
-    const base = writeStylesBase(b, s, usv);
     const text = writeTextStyle(b, s.textStyle, usv);
     const layout = (() => {
         Duc.FCFLayoutStyle.startFCFLayoutStyle(b);
@@ -1269,8 +1253,6 @@ function writeFcfStyle(b, s, usv) {
         return Duc.FCFDatumStyle.endFCFDatumStyle(b);
     })();
     Duc.DucFeatureControlFrameStyle.startDucFeatureControlFrameStyle(b);
-    if (base)
-        Duc.DucFeatureControlFrameStyle.addBaseStyle(b, base);
     Duc.DucFeatureControlFrameStyle.addTextStyle(b, text);
     Duc.DucFeatureControlFrameStyle.addLayout(b, layout);
     Duc.DucFeatureControlFrameStyle.addSymbols(b, sym);
@@ -1386,21 +1368,19 @@ function writeTableCellStyle(b, s, usv) {
     Duc.Margins.addLeft(b, getPrecisionValue(s.margins.left, usv));
     const margins = Duc.Margins.endMargins(b);
     Duc.DucTableCellStyle.startDucTableCellStyle(b);
-    if (base)
+    if (base) {
         Duc.DucTableCellStyle.addBaseStyle(b, base);
+    }
     Duc.DucTableCellStyle.addTextStyle(b, text);
     Duc.DucTableCellStyle.addMargins(b, margins);
     Duc.DucTableCellStyle.addAlignment(b, s.alignment);
     return Duc.DucTableCellStyle.endDucTableCellStyle(b);
 }
 function writeTableStyle(b, s, usv) {
-    const base = writeStylesBase(b, s, usv);
     const header = writeTableCellStyle(b, s.headerRowStyle, usv);
     const dataRow = writeTableCellStyle(b, s.dataRowStyle, usv);
     const dataCol = writeTableCellStyle(b, s.dataColumnStyle, usv);
     Duc.DucTableStyle.startDucTableStyle(b);
-    if (base)
-        Duc.DucTableStyle.addBaseStyle(b, base);
     Duc.DucTableStyle.addFlowDirection(b, s.flowDirection);
     Duc.DucTableStyle.addHeaderRowStyle(b, header);
     Duc.DucTableStyle.addDataRowStyle(b, dataRow);
@@ -2369,13 +2349,13 @@ function serializeExternalFiles(builder, files, usv) {
 export const DUC_SCHEMA_VERSION = (typeof process !== "undefined" && process.env && process.env.DUC_SCHEMA_VERSION) ||
     (typeof import.meta !== "undefined" && import.meta.env && import.meta.env.DUC_SCHEMA_VERSION) ||
     "0.0.0";
-export const serializeDuc = (data_1, ...args_1) => __awaiter(void 0, [data_1, ...args_1], void 0, function* (data, useScopedValues = false, passThroughElementIds = []) {
+export const serializeDuc = (data_1, ...args_1) => __awaiter(void 0, [data_1, ...args_1], void 0, function* (data, useScopedValues = false, passThroughElementIds = [], restoreConfig = {}) {
     const builder = new flatbuffers.Builder(1024);
     const sanitized = restore(data, {
         refreshDimensions: false,
         syncInvalidIndices: (elements) => elements,
         passThroughElementIds
-    });
+    }, restoreConfig);
     const typeOffset = builder.createString(EXPORT_DATA_TYPES.duc);
     const sourceOffset = builder.createString(typeof window !== "undefined" ? window.location.origin : "unknown");
     const versionOffset = builder.createString(DUC_SCHEMA_VERSION);
@@ -2422,6 +2402,10 @@ export const serializeDuc = (data_1, ...args_1) => __awaiter(void 0, [data_1, ..
     const thumbnailOffset = sanitized.thumbnail
         ? builder.createByteVector(sanitized.thumbnail)
         : null;
+    // Serialize id (as string if present)
+    const idOffset = sanitized.id
+        ? builder.createString(sanitized.id)
+        : null;
     Duc.ExportedDataState.startExportedDataState(builder);
     Duc.ExportedDataState.addType(builder, typeOffset);
     Duc.ExportedDataState.addVersion(builder, versionOffset);
@@ -2458,6 +2442,9 @@ export const serializeDuc = (data_1, ...args_1) => __awaiter(void 0, [data_1, ..
     if (thumbnailOffset) {
         Duc.ExportedDataState.addThumbnail(builder, thumbnailOffset);
     }
+    if (idOffset) {
+        Duc.ExportedDataState.addId(builder, idOffset);
+    }
     const exportedDataStateOffset = Duc.ExportedDataState.endExportedDataState(builder);
     builder.finish(exportedDataStateOffset, "DUC_");
     return builder.asUint8Array();

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

@@ -341,7 +341,7 @@ export type DucTableCellStyle = _DucElementStylesBase & {
  * It sets the defaults for rows, columns, and cells, which can be
  * individually overridden.
  */
-export type DucTableStyle = _DucElementStylesBase & {
+export type DucTableStyle = {
     /** The direction in which new rows are added */
     flowDirection: TableFlowDirection;
     /** Default style for the header row(s) */
@@ -453,7 +453,7 @@ export type TextAlign = ValueOf<typeof TEXT_ALIGN>;
 export type VerticalAlign = ValueOf<typeof VERTICAL_ALIGN>;
 export type LineSpacingType = ValueOf<typeof LINE_SPACING_TYPE>;
 export type TextFieldSourceProperty = ValueOf<typeof TEXT_FIELD_SOURCE_PROPERTY>;
-export type DucTextStyle = _DucElementStylesBase & {
+export type DucTextStyle = {
     /**
      * Whether the text is left-to-right or right-to-left
      * @default true
@@ -845,7 +845,7 @@ export type ViewportShadePlot = ValueOf<typeof VIEWPORT_SHADE_PLOT>;
  * This is the style for the viewport element
  * Grid settings, UCS, Snapping and more can be overridden through the overrideStandard property from the _DucStackElementBase
  */
-export type DucViewportStyle = _DucElementStylesBase & {
+export type DucViewportStyle = {
     scaleIndicatorVisible: boolean;
 };
 export type DucViewportElement = _DucLinearElementBase & _DucStackBase & DucViewportStyle & {
@@ -873,7 +873,7 @@ export type PlotLayout = {
         left: PrecisionValue;
     };
 };
-export type DucPlotStyle = _DucElementStylesBase & {};
+export type DucPlotStyle = {};
 /**
  * A DucPlotElement represents a finite layout or "paper space" within the infinite canvas.
  * It serves as a container for viewports and other annotations, defining the final
@@ -885,7 +885,7 @@ export type DucPlotElement = _DucStackElementBase & DucPlotStyle & {
     /** The layout definition for this plot, including paper size and margins. */
     layout: PlotLayout;
 };
-export type DucXRayStyle = _DucElementStylesBase & {
+export type DucXRayStyle = {
     /**
      * The color of the x-ray
      */
@@ -906,7 +906,7 @@ export type BlockAttachment = ValueOf<typeof BLOCK_ATTACHMENT>;
 /**
  * Defines the visual appearance and behavior of a leader.
  */
-export type DucLeaderStyle = _DucElementStylesBase & {
+export type DucLeaderStyle = {
     /**
      * Override the heads of the leader
      * The tuple represents [startHead, endHead]
@@ -1161,7 +1161,7 @@ export type FeatureControlFrameSegment = {
  * Defines the visual appearance of a Feature Control Frame.
  * This can be stored in a style library and reused.
  */
-export type DucFeatureControlFrameStyle = _DucElementStylesBase & {
+export type DucFeatureControlFrameStyle = {
     /** The base text style for numbers and letters within the frame */
     textStyle: DucTextStyle;
     /** Layout and spacing properties */

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

@@ -1,7 +1,7 @@
 import type { ElementOrToolType } from "..";
 import type { MarkNonNullable } from "../utility-types";
 import { Bounds, LineSegment, TuplePoint } from "../geometryTypes";
-import type { DucArrowElement, DucBindableElement, DucElbowArrowElement, DucElement, DucElementType, DucEmbeddableElement, DucFlowchartNodeElement, DucFrameElement, DucFrameLikeElement, DucFreeDrawElement, DucImageElement, DucLinearElement, DucTableElement, DucPointBinding, DucTextContainer, DucTextElement, DucTextElementWithContainer, FixedPointBinding, InitializedDucImageElement, DucNonSelectionElement, DucEllipseElement, DucPolygonElement, DucBlockInstanceElement, NonDeleted, DucIframeLikeElement } from "./";
+import type { DucArrowElement, DucBindableElement, DucElbowArrowElement, DucElement, DucElementType, DucEmbeddableElement, DucFlowchartNodeElement, DucFrameElement, DucFrameLikeElement, DucFreeDrawElement, DucImageElement, DucLinearElement, DucPlotElement, DucTableElement, DucPointBinding, DucTextContainer, DucTextElement, DucTextElementWithContainer, FixedPointBinding, InitializedDucImageElement, DucNonSelectionElement, DucEllipseElement, DucPolygonElement, DucBlockInstanceElement, NonDeleted, DucIframeLikeElement } from "./";
 export declare const isInitializedImageElement: (element: DucElement | null) => element is InitializedDucImageElement;
 export declare const isImageElement: (element: DucElement | null) => element is DucImageElement;
 export declare const isEmbeddableElement: (element: DucElement | null | undefined) => element is DucEmbeddableElement;
@@ -9,6 +9,7 @@ export declare const isTableElement: (element: DucElement | null) => element is
 export declare const isIframeLikeElement: (element: DucElement | null) => element is DucIframeLikeElement;
 export declare const isTextElement: (element: DucElement | null) => element is DucTextElement;
 export declare const isFrameElement: (element: DucElement | null) => element is DucFrameElement;
+export declare const isPlotElement: (element: DucElement | null) => element is DucPlotElement;
 export declare const isFrameLikeElement: (element: DucElement | null) => element is DucFrameLikeElement;
 export declare const isFreeDrawElement: (element?: DucElement | null) => element is DucFreeDrawElement;
 export declare const isEllipseElement: (element?: DucElement | null) => element is DucEllipseElement;

package/dist/types/elements/typeChecks.js

@@ -22,9 +22,12 @@ export const isTextElement = (element) => {
 export const isFrameElement = (element) => {
     return element != null && element.type === "frame";
 };
+export const isPlotElement = (element) => {
+    return element != null && element.type === "plot";
+};
 export const isFrameLikeElement = (element) => {
     return (element != null &&
-        (element.type === "frame"));
+        (element.type === "frame" || element.type === "plot"));
 };
 export const isFreeDrawElement = (element) => {
     return element != null && isFreeDrawElementType(element.type);

package/dist/types/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./elements";
 export * from "./geometryTypes";
 export * from "./utility-types";
+export * from "./typeChecks";
 import { OBJECT_SNAP_MODE, PRUNING_LEVEL } from "../flatbuffers/duc";
 import { SupportedMeasures } from "../technical/scopes";
 import { Standard } from "../technical/standards";
@@ -30,6 +31,8 @@ export interface ExportedDataState {
     files: DucExternalFiles | undefined;
     /** In case it is needed to embed the version control into the file format */
     versionGraph: VersionGraph | undefined;
+    /** Actual file id */
+    id: string | undefined;
 }
 export type ExportedDataStateContent = Omit<ExportedDataState, "type" | "version" | "source">;
 /**
@@ -106,7 +109,7 @@ export type SuggestedPointBinding = [
     "start" | "end" | "both",
     NonDeleted<DucBindableElement>
 ];
-export type ToolType = "selection" | "rectangle" | "polygon" | "ellipse" | "line" | "freedraw" | "text" | "image" | "eraser" | "hand" | "frame" | "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";
 export type ElementOrToolType = DucElementType | ToolType | "custom";
 /**
  * Defines the global, persistent settings for the drawing. These are fundamental

package/dist/types/index.js

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

package/dist/types/typeChecks.d.ts

@@ -0,0 +1,5 @@
+import { PrecisionValue } from ".";
+/**
+ * Type guard to check if an object is a PrecisionValue
+ */
+export declare const isPrecisionValue: (obj: any) => obj is PrecisionValue;

package/dist/types/typeChecks.js

@@ -0,0 +1,10 @@
+/**
+ * Type guard to check if an object is a PrecisionValue
+ */
+export const isPrecisionValue = (obj) => {
+    return obj !== null &&
+        typeof obj === 'object' &&
+        typeof obj.value === 'number' &&
+        typeof obj.scoped === 'number' &&
+        Object.keys(obj).length === 2;
+};

package/dist/utils/constants.d.ts

@@ -47,6 +47,8 @@ export declare const MIME_TYPES: {
     readonly "excalidraw.svg": "image/svg+xml";
     readonly "excalidraw.png": "image/png";
     readonly binary: "application/octet-stream";
+    readonly pdf: "application/pdf";
+    readonly zip: "application/zip";
 };
 export declare const EXPORT_IMAGE_TYPES: {
     readonly png: "png";

package/dist/utils/constants.js

@@ -37,9 +37,7 @@ export const MIME_TYPES = Object.assign({ json: "application/json",
     // excalidraw data
     duc: "application/vnd.duc-cad", ducfig: "application/vnd.duc-config", excalidrawlib: "application/vnd.excalidrawlib+json", 
     // image-encoded excalidraw data
-    "excalidraw.svg": "image/svg+xml", "excalidraw.png": "image/png", 
-    // binary
-    binary: "application/octet-stream" }, IMAGE_MIME_TYPES);
+    "excalidraw.svg": "image/svg+xml", "excalidraw.png": "image/png", binary: "application/octet-stream", pdf: "application/pdf", zip: "application/zip" }, IMAGE_MIME_TYPES);
 export const EXPORT_IMAGE_TYPES = {
     png: "png",
     svg: "svg",

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

@@ -1,4 +1,5 @@
 import { DucElement, DucElementsIncludingDeleted, DucFrameLikeElement, ElementsMap } from "../../types/elements";
 export declare const getContainingFrame: (element: DucElement, elementsMap: ElementsMap) => DucFrameLikeElement | null;
 export declare const getFrameLikeElements: (allElements: DucElementsIncludingDeleted) => DucFrameLikeElement[];
+export declare const canFrameLikeContainElement: (frame: DucFrameLikeElement, element: DucElement) => boolean;
 export declare const getFrameLikeTitle: (element: DucFrameLikeElement) => string;

package/dist/utils/elements/frameElement.js

@@ -1,4 +1,4 @@
-import { isFrameLikeElement } from "../../types/elements/typeChecks";
+import { isFrameElement, isFrameLikeElement, isPlotElement } from "../../types/elements/typeChecks";
 export const getContainingFrame = (element, elementsMap) => {
     if (!element.frameId) {
         return null;
@@ -9,6 +9,18 @@ export const getContainingFrame = (element, elementsMap) => {
 export const getFrameLikeElements = (allElements) => {
     return allElements.filter((element) => isFrameLikeElement(element));
 };
+export const canFrameLikeContainElement = (frame, element) => {
+    if (frame.id === element.id) {
+        return false;
+    }
+    if (isPlotElement(element)) {
+        return false;
+    }
+    if (isFrameElement(element)) {
+        return frame.type === "plot";
+    }
+    return true;
+};
 export const getFrameLikeTitle = (element) => {
     return element.label === null
         ? "Frame"

package/dist/utils/elements/index.js

@@ -15,13 +15,6 @@ import { getPrecisionValueFromRaw } from "../../technical/scopes";
  */
 export function getDefaultTextStyle(currentScope) {
     return {
-        roundness: DEFAULT_ELEMENT_PROPS.roundness,
-        blending: undefined,
-        strokeColor: undefined,
-        backgroundColor: undefined,
-        background: [DEFAULT_ELEMENT_PROPS.background],
-        stroke: [DEFAULT_ELEMENT_PROPS.stroke],
-        opacity: DEFAULT_ELEMENT_PROPS.opacity,
         isLtr: true,
         fontFamily: DEFAULT_FONT_FAMILY,
         bigFontFamily: "sans-serif",
@@ -83,7 +76,12 @@ export const getDefaultTableData = (currentScope) => {
     // A practical starting column width
     const defaultColumnWidth = getPrecisionValueFromRaw(140, currentScope, currentScope);
     // Base/default styling for cells
-    const baseCellStyle = Object.assign(Object.assign({}, DEFAULT_ELEMENT_PROPS), { background: [DEFAULT_ELEMENT_PROPS.background], stroke: [DEFAULT_ELEMENT_PROPS.stroke], textStyle: {
+    const baseCellStyle = {
+        stroke: [DEFAULT_ELEMENT_PROPS.stroke],
+        background: [DEFAULT_ELEMENT_PROPS.background],
+        roundness: DEFAULT_ELEMENT_PROPS.roundness,
+        opacity: DEFAULT_ELEMENT_PROPS.opacity,
+        textStyle: {
             isLtr: true,
             fontFamily: FONT_FAMILY.Virgil,
             bigFontFamily: "sans-serif",
@@ -97,18 +95,16 @@ export const getDefaultTableData = (currentScope) => {
             widthFactor: 1,
             isUpsideDown: false,
             isBackwards: false,
-            roundness: DEFAULT_ELEMENT_PROPS.roundness,
-            background: [DEFAULT_ELEMENT_PROPS.background],
-            stroke: [DEFAULT_ELEMENT_PROPS.stroke],
-            opacity: DEFAULT_ELEMENT_PROPS.opacity,
-        }, margins: {
+        },
+        margins: {
             top: vMargin,
             right: hMargin,
             bottom: vMargin,
             left: hMargin,
-        }, 
+        },
         // Left + middle is a great general-purpose default for tables
-        alignment: TABLE_CELL_ALIGNMENT.MIDDLE_LEFT });
+        alignment: TABLE_CELL_ALIGNMENT.MIDDLE_LEFT,
+    };
     // Create default columns
     const columns = Object.fromEntries(columnIds.map((id) => [id, { id, width: defaultColumnWidth }]));
     // Create default rows (taller header row)

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, DucBlockInstanceElement, ElementConstructorOpts, ElementUpdate, NonDeleted } from "../../types/elements";
+import { DucArrowElement, DucBlockInstanceElement, 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 { Mutable } from "../../types/utility-types";
 export declare const newElementWith: <TElement extends DucElement>(element: TElement, updates: ElementUpdate<TElement>, 
 /** pass `true` to always regenerate */