ducjs 2.3.0 → 3.0.0

package/dist/restore/index.d.ts

@@ -1,3 +1,2 @@
 export * from "./restoreDataState";
 export * from "./restoreElements";
-export * from "./restoreStandards";

package/dist/restore/index.js

@@ -1,3 +1,2 @@
 export * from "./restoreDataState";
 export * from "./restoreElements";
-export * from "./restoreStandards";

package/dist/restore/restoreDataState.d.ts

@@ -1,6 +1,5 @@
-import { BLENDING } from "../flatbuffers/duc";
-import { Standard } from "../technical/standards";
-import type { Dictionary, DucExternalFiles, DucGlobalState, ImportedDataState, LibraryItems, PrecisionValue, Scope, VersionGraph } from "../types";
+import { BLENDING } from "../enums";
+import type { Checkpoint, Delta, Dictionary, DucExternalFiles, DucGlobalState, ImportedDataState, LibraryItems, PrecisionValue, Scope, VersionGraph } from "../types";
 import { DucLocalState } from "../types";
 import type { _DucStackBase, BezierMirroring, DucBlock, DucBlockCollection, DucBlockInstance, DucElement, DucGroup, DucHead, DucLayer, DucRegion, ElementBackground, ElementContentBase, ElementStroke, ExternalFileId, FillStyle, ImageStatus, LineHead, OrderedDucElement, StrokeCap, StrokeJoin, StrokePreference, StrokeSidePreference, StrokeStyle, TextAlign, VerticalAlign } from "../types/elements";
 import { Percentage, Radian } from "../types/geometryTypes";
@@ -20,7 +19,6 @@ export type RestoredDataState = {
     groups: DucGroup[];
     regions: DucRegion[];
     layers: DucLayer[];
-    standards: Standard[];
     versionGraph: VersionGraph | undefined;
     id: string;
 };
@@ -115,8 +113,10 @@ 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"], forceScope?: Scope) => DucLocalState;
+export declare const restoreLocalState: (importedState: Partial<DucLocalState> | undefined, restoredGlobalState: RestoredDataState["globalState"], forceScope?: Scope) => DucLocalState;
 export declare const restoreVersionGraph: (importedGraph: any) => RestoredDataState["versionGraph"];
+export declare const restoreCheckpoint: (importedCheckpoint: unknown) => Checkpoint | undefined;
+export declare const restoreDelta: (importedDelta: unknown) => Delta | undefined;
 /**
  * Restores common properties for elements leveraging _DucStackBase.
  */
@@ -135,6 +135,7 @@ export declare const isValidFillStyleValue: (value: FillStyle | undefined) => Fi
 export declare const isValidStrokePreferenceValue: (value: StrokePreference | undefined) => StrokePreference;
 export declare const isValidVerticalAlignValue: (value: VerticalAlign | undefined) => VerticalAlign;
 export declare const isValidTextAlignValue: (value: TextAlign | undefined) => TextAlign;
+export declare const isValidDecimalPlacesValue: (value: number | undefined, fallback: number) => number;
 export declare const isValidScopeValue: (value: string | undefined, localState?: Readonly<Partial<DucLocalState>> | null, mainScope?: Scope) => Scope;
 export declare const isValidImageStatusValue: (value: ImageStatus | undefined) => ImageStatus;
 export declare const isValidDucHead: (value: DucHead | null | undefined, blocks: RestoredDataState["blocks"], elementScope: Scope, currentScope: Scope) => DucHead | null;
@@ -193,11 +194,6 @@ export declare const isValidExternalFileId: (value: any, defaultValue?: External
  * @returns A valid, non-empty `Uint8Array` if the conversion is successful, otherwise `undefined`.
  */
 export declare const isValidUint8Array: (value: unknown) => Uint8Array | undefined;
-/**
- * Validates a Standard id.
- * Returns the id if valid and present in standards, otherwise returns the default DUC standard id.
- */
-export declare const isValidStandardId: (id: any, standards: Standard[], defaultId?: string) => string;
 /**
  * Validates a block id.
  * Returns the id if present in restored blocks, otherwise returns null.

package/dist/restore/restoreDataState.js

@@ -1,19 +1,16 @@
 import { nanoid } from "nanoid";
 import tinycolor from "tinycolor2";
-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 { 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 "../enums";
 import { getPrecisionScope } from "../technical/measurements";
 import { getPrecisionValueFromRaw, getPrecisionValueFromScoped, NEUTRAL_SCOPE, ScaleFactors } from "../technical/scopes";
-import { PREDEFINED_STANDARDS } from "../technical/standards";
 import { base64ToUint8Array, getDefaultGlobalState, getDefaultLocalState, getZoom, isEncodedFunctionString, isFiniteNumber, reviveEncodedFunction, } from "../utils";
 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 { restoreElements } from "./restoreElements";
-import { isStandardIdPresent, restoreStandards, } from "./restoreStandards";
 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, restoreConfig.forceScope);
+    const restoredLocalState = restoreLocalState(data === null || data === void 0 ? void 0 : data.localState, restoredGlobalState, 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 restoredBlockCollections = restoreBlockCollections(data === null || data === void 0 ? void 0 : data.blockCollections);
@@ -36,7 +33,6 @@ export const restore = (data, elementsConfig, restoreConfig = {}) => {
         groups: restoredGroups,
         regions: restoredRegions,
         layers: restoredLayers,
-        standards: restoredStandards,
         versionGraph: restoredVersionGraph,
         localState: restoredLocalState,
         globalState: restoredGlobalState,
@@ -144,10 +140,11 @@ export const restoreLayers = (layers, currentScope) => {
         return typeof g.id === "string";
     })
         .map((l) => {
-        return Object.assign(Object.assign({ id: l.id }, restoreDucStackProperties(l)), { readonly: isValidBoolean(l.readonly, false), overrides: {
-                stroke: validateStroke(l.overrides.stroke, currentScope, currentScope),
-                background: validateBackground(l.overrides.background),
-            } });
+        const overridesSource = l.overrides && typeof l.overrides === "object" ? l.overrides : null;
+        return Object.assign(Object.assign({ id: l.id }, restoreDucStackProperties(l)), { readonly: isValidBoolean(l.readonly, false), overrides: overridesSource ? {
+                stroke: validateStroke(overridesSource.stroke, currentScope, currentScope),
+                background: validateBackground(overridesSource.background),
+            } : null });
     });
 };
 /**
@@ -198,10 +195,6 @@ export const restoreBlocks = (blocks, currentScope, elementsConfig) => {
             label: typeof obj.label === "string" ? obj.label : "",
             description: typeof obj.description === "string" ? obj.description : undefined,
             version: typeof obj.version === "number" ? obj.version : 1,
-            attributes: obj.attributes || undefined,
-            attributeDefinitions: obj.attributeDefinitions && typeof obj.attributeDefinitions === "object"
-                ? obj.attributeDefinitions
-                : {},
             metadata,
             thumbnail: isValidUint8Array(obj.thumbnail),
         };
@@ -276,27 +269,11 @@ export const restoreBlockInstances = (blockInstances, currentScope) => {
                 elementOverrides = obj.elementOverrides;
             }
         }
-        // Handle attributeValues - same logic
-        let attributeValues;
-        if (obj.attributeValues && typeof obj.attributeValues === "object") {
-            if (Array.isArray(obj.attributeValues)) {
-                // Legacy format: array of {key, value} entries
-                attributeValues = Object.fromEntries(obj.attributeValues.map((entry) => [
-                    typeof entry.key === "string" ? entry.key : "",
-                    typeof entry.value === "string" ? entry.value : "",
-                ]));
-            }
-            else {
-                // Current format: already a Record<string, string>
-                attributeValues = obj.attributeValues;
-            }
-        }
         return {
             id: isValidString(obj.id),
             blockId: isValidString(obj.blockId),
             version: isValidNumber(obj.version, 1),
             elementOverrides,
-            attributeValues,
             duplicationArray: dupArray && typeof dupArray === "object"
                 ? {
                     rows: typeof dupArray.rows === "number" ? dupArray.rows : 1,
@@ -345,13 +322,9 @@ const restoreBlockMetadata = (metadata) => {
  * @returns A complete and valid DucGlobalState object.
  */
 export const restoreGlobalState = (importedState = {}) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    var _a, _b, _c;
     const defaults = getDefaultGlobalState();
-    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: (_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) &&
+    return Object.assign(Object.assign({}, defaults), { name: (_a = importedState === null || importedState === void 0 ? void 0 : importedState.name) !== null && _a !== void 0 ? _a : defaults.name, viewBackgroundColor: (_b = importedState === null || importedState === void 0 ? void 0 : importedState.viewBackgroundColor) !== null && _b !== void 0 ? _b : defaults.viewBackgroundColor, mainScope: (_c = isValidAppStateScopeValue(importedState === null || importedState === void 0 ? void 0 : importedState.mainScope)) !== null && _c !== void 0 ? _c : defaults.mainScope, scopeExponentThreshold: isValidAppStateScopeExponentThresholdValue(importedState === null || importedState === void 0 ? void 0 : importedState.scopeExponentThreshold, defaults.scopeExponentThreshold), pruningLevel: (importedState === null || importedState === void 0 ? void 0 : importedState.pruningLevel) &&
             Object.values(PRUNING_LEVEL).includes(importedState.pruningLevel)
             ? importedState.pruningLevel
             : PRUNING_LEVEL.BALANCED });
@@ -365,18 +338,25 @@ 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, forceScope) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+export const restoreLocalState = (importedState = {}, restoredGlobalState, forceScope) => {
+    var _a, _b, _c, _d, _e;
     const defaults = getDefaultLocalState();
-    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);
+    // Rust sends zoom as a plain f64, TS stores it as { value, scoped, scaled }.
+    // Handle both formats.
+    const rawZoom = typeof (importedState === null || importedState === void 0 ? void 0 : importedState.zoom) === "number"
+        ? importedState.zoom
+        : (_a = importedState === null || importedState === void 0 ? void 0 : importedState.zoom) === null || _a === void 0 ? void 0 : _a.value;
+    const zoom = getZoom(rawZoom !== null && rawZoom !== void 0 ? rawZoom : 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)
+    return Object.assign(Object.assign(Object.assign({}, defaults), importedState), { scope, 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) != null
             ? restorePrecisionValue(importedState.scrollX, NEUTRAL_SCOPE, scope)
-            : getPrecisionValueFromRaw(defaults.scrollX.value, NEUTRAL_SCOPE, scope), scrollY: (importedState === null || importedState === void 0 ? void 0 : importedState.scrollY)
+            : getPrecisionValueFromRaw(defaults.scrollX.value, NEUTRAL_SCOPE, scope), scrollY: (importedState === null || importedState === void 0 ? void 0 : importedState.scrollY) != null
             ? restorePrecisionValue(importedState.scrollY, NEUTRAL_SCOPE, scope)
-            : 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 });
+            : getPrecisionValueFromRaw(defaults.scrollY.value, NEUTRAL_SCOPE, scope), zoom, currentItemStroke: (_b = validateStroke(importedState === null || importedState === void 0 ? void 0 : importedState.currentItemStroke, scope, scope)) !== null && _b !== void 0 ? _b : defaults.currentItemStroke, currentItemBackground: (_c = validateBackground(importedState === null || importedState === void 0 ? void 0 : importedState.currentItemBackground)) !== null && _c !== void 0 ? _c : defaults.currentItemBackground, currentItemFontFamily: typeof (importedState === null || importedState === void 0 ? void 0 : importedState.currentItemFontFamily) === "string"
+            ? importedState.currentItemFontFamily
+            : defaults.currentItemFontFamily, currentItemFontSize: restorePrecisionValue(importedState === null || importedState === void 0 ? void 0 : importedState.currentItemFontSize, scope, scope, defaults.currentItemFontSize.value), currentItemTextAlign: isValidTextAlignValue(importedState === null || importedState === void 0 ? void 0 : importedState.currentItemTextAlign), currentItemOpacity: isValidPercentageValue(importedState === null || importedState === void 0 ? void 0 : importedState.currentItemOpacity, defaults.currentItemOpacity), currentItemRoundness: restorePrecisionValue(importedState === null || importedState === void 0 ? void 0 : importedState.currentItemRoundness, scope, scope, defaults.currentItemRoundness.value), currentItemStartLineHead: (_d = isValidLineHeadValue(importedState === null || importedState === void 0 ? void 0 : importedState.currentItemStartLineHead)) !== null && _d !== void 0 ? _d : defaults.currentItemStartLineHead, currentItemEndLineHead: (_e = isValidLineHeadValue(importedState === null || importedState === void 0 ? void 0 : importedState.currentItemEndLineHead)) !== null && _e !== void 0 ? _e : defaults.currentItemEndLineHead, viewModeEnabled: isValidBoolean(importedState === null || importedState === void 0 ? void 0 : importedState.viewModeEnabled, defaults.viewModeEnabled), objectsSnapModeEnabled: isValidBoolean(importedState === null || importedState === void 0 ? void 0 : importedState.objectsSnapModeEnabled, defaults.objectsSnapModeEnabled), gridModeEnabled: isValidBoolean(importedState === null || importedState === void 0 ? void 0 : importedState.gridModeEnabled, defaults.gridModeEnabled), outlineModeEnabled: isValidBoolean(importedState === null || importedState === void 0 ? void 0 : importedState.outlineModeEnabled, defaults.outlineModeEnabled), manualSaveMode: isValidBoolean(importedState === null || importedState === void 0 ? void 0 : importedState.manualSaveMode, defaults.manualSaveMode), decimalPlaces: isValidDecimalPlacesValue(importedState === null || importedState === void 0 ? void 0 : importedState.decimalPlaces, defaults.decimalPlaces) });
 };
 export const restoreVersionGraph = (importedGraph) => {
     if (!importedGraph || typeof importedGraph !== "object") {
@@ -387,82 +367,27 @@ export const restoreVersionGraph = (importedGraph) => {
     if (!userCheckpointVersionId || !latestVersionId) {
         return undefined;
     }
-    const checkpoints = [];
-    if (Array.isArray(importedGraph.checkpoints)) {
-        for (const c of importedGraph.checkpoints) {
-            if (!c || typeof c !== "object" || c.type !== "checkpoint") {
-                continue;
-            }
-            const id = isValidString(c.id);
-            if (!id) {
-                continue;
-            }
-            const parentId = typeof c.parentId === "string" ? c.parentId : null;
-            const timestamp = isFiniteNumber(c.timestamp) ? c.timestamp : 0;
-            const isManualSave = isValidBoolean(c.isManualSave, false);
-            const sizeBytes = isFiniteNumber(c.sizeBytes) && c.sizeBytes >= 0 ? c.sizeBytes : 0;
-            const data = isValidUint8Array(c.data);
-            if (!data) {
-                continue;
-            }
-            checkpoints.push({
-                type: "checkpoint",
-                id,
-                parentId,
-                timestamp,
-                isManualSave,
-                sizeBytes,
-                data,
-                description: isValidString(c.description) || undefined,
-                userId: isValidString(c.userId) || undefined,
-            });
-        }
-    }
-    const deltas = [];
-    if (Array.isArray(importedGraph.deltas)) {
-        for (const d of importedGraph.deltas) {
-            if (!d || typeof d !== "object" || d.type !== "delta") {
-                continue;
-            }
-            const id = isValidString(d.id);
-            if (!id) {
-                continue;
-            }
-            const parentId = typeof d.parentId === "string" ? d.parentId : null;
-            const timestamp = isFiniteNumber(d.timestamp) ? d.timestamp : 0;
-            const isManualSave = isValidBoolean(d.isManualSave, false);
-            if (!Array.isArray(d.patch)) {
-                continue;
-            }
-            const patch = [];
-            let isPatchValid = true;
-            for (const op of d.patch) {
-                if (!op ||
-                    typeof op !== "object" ||
-                    !isValidString(op.op) ||
-                    !isValidString(op.path)) {
-                    isPatchValid = false;
-                    break;
-                }
-                patch.push({ op: op.op, path: op.path, value: op.value });
-            }
-            if (!isPatchValid) {
-                continue;
-            }
-            deltas.push({
-                type: "delta",
-                id,
-                parentId,
-                timestamp,
-                isManualSave,
-                patch,
-                description: isValidString(d.description) || undefined,
-                userId: isValidString(d.userId) || undefined,
-            });
-        }
-    }
+    const checkpoints = Array.isArray(importedGraph.checkpoints)
+        ? importedGraph.checkpoints
+            .map((checkpoint) => restoreCheckpoint(checkpoint))
+            .filter((checkpoint) => Boolean(checkpoint))
+        : [];
+    const deltas = Array.isArray(importedGraph.deltas)
+        ? importedGraph.deltas
+            .map((delta) => restoreDelta(delta))
+            .filter((delta) => Boolean(delta))
+        : [];
     const importedMetadata = importedGraph.metadata;
     const metadata = {
+        currentVersion: isFiniteNumber(importedMetadata === null || importedMetadata === void 0 ? void 0 : importedMetadata.currentVersion) && importedMetadata.currentVersion >= 0
+            ? importedMetadata.currentVersion
+            : 0,
+        currentSchemaVersion: isFiniteNumber(importedMetadata === null || importedMetadata === void 0 ? void 0 : importedMetadata.currentSchemaVersion) && importedMetadata.currentSchemaVersion >= 1
+            ? importedMetadata.currentSchemaVersion
+            : 1,
+        chainCount: isFiniteNumber(importedMetadata === null || importedMetadata === void 0 ? void 0 : importedMetadata.chainCount) && importedMetadata.chainCount >= 1
+            ? importedMetadata.chainCount
+            : 1,
         lastPruned: isFiniteNumber(importedMetadata === null || importedMetadata === void 0 ? void 0 : importedMetadata.lastPruned)
             ? importedMetadata.lastPruned
             : 0,
@@ -474,11 +399,77 @@ export const restoreVersionGraph = (importedGraph) => {
     return {
         userCheckpointVersionId,
         latestVersionId,
+        chains: Array.isArray(importedGraph.chains) ? importedGraph.chains : [],
         checkpoints,
         deltas,
         metadata,
     };
 };
+export const restoreCheckpoint = (importedCheckpoint) => {
+    if (!importedCheckpoint || typeof importedCheckpoint !== "object") {
+        return undefined;
+    }
+    const checkpoint = importedCheckpoint;
+    if (checkpoint.type !== "checkpoint") {
+        return undefined;
+    }
+    const id = isValidString(checkpoint.id);
+    const data = isValidUint8Array(checkpoint.data);
+    if (!id || !data) {
+        return undefined;
+    }
+    return {
+        type: "checkpoint",
+        id,
+        parentId: typeof checkpoint.parentId === "string" ? checkpoint.parentId : null,
+        timestamp: isFiniteNumber(checkpoint.timestamp) ? checkpoint.timestamp : 0,
+        isManualSave: isValidBoolean(checkpoint.isManualSave, false),
+        versionNumber: isFiniteNumber(checkpoint.versionNumber) ? checkpoint.versionNumber : 0,
+        schemaVersion: isFiniteNumber(checkpoint.schemaVersion) && checkpoint.schemaVersion >= 1
+            ? checkpoint.schemaVersion
+            : 1,
+        isSchemaBoundary: isValidBoolean(checkpoint.isSchemaBoundary, false),
+        data,
+        sizeBytes: isFiniteNumber(checkpoint.sizeBytes) && checkpoint.sizeBytes >= 0
+            ? checkpoint.sizeBytes
+            : data.byteLength,
+        description: isValidString(checkpoint.description) || undefined,
+        userId: isValidString(checkpoint.userId) || undefined,
+    };
+};
+export const restoreDelta = (importedDelta) => {
+    if (!importedDelta || typeof importedDelta !== "object") {
+        return undefined;
+    }
+    const delta = importedDelta;
+    if (delta.type !== "delta") {
+        return undefined;
+    }
+    const id = isValidString(delta.id);
+    const payload = isValidUint8Array(delta.payload);
+    const baseCheckpointId = isValidString(delta.baseCheckpointId);
+    if (!id || !payload || !baseCheckpointId) {
+        return undefined;
+    }
+    return {
+        type: "delta",
+        id,
+        parentId: typeof delta.parentId === "string" ? delta.parentId : null,
+        timestamp: isFiniteNumber(delta.timestamp) ? delta.timestamp : 0,
+        isManualSave: isValidBoolean(delta.isManualSave, false),
+        versionNumber: isFiniteNumber(delta.versionNumber) ? delta.versionNumber : 0,
+        schemaVersion: isFiniteNumber(delta.schemaVersion) && delta.schemaVersion >= 1
+            ? delta.schemaVersion
+            : 1,
+        baseCheckpointId,
+        payload,
+        sizeBytes: isFiniteNumber(delta.sizeBytes) && delta.sizeBytes >= 0
+            ? delta.sizeBytes
+            : payload.byteLength,
+        description: isValidString(delta.description) || undefined,
+        userId: isValidString(delta.userId) || undefined,
+    };
+};
 /**
  * Restores common properties for elements leveraging _DucStackBase.
  */
@@ -492,7 +483,6 @@ export const restoreDucStackProperties = (stack) => {
         isVisible: isValidBoolean(stack.isVisible, defaultStackProperties.isVisible),
         isPlot: isValidBoolean(stack.isPlot, defaultStackProperties.isPlot),
         opacity: isValidPercentageValue(stack.opacity, defaultStackProperties.opacity),
-        labelingColor: isValidColor(stack.labelingColor, defaultStackProperties.labelingColor),
     };
 };
 export const isValidAppStateScopeValue = (value) => {
@@ -553,6 +543,16 @@ export const isValidTextAlignValue = (value) => {
         return DEFAULT_TEXT_ALIGN;
     return value;
 };
+export const isValidDecimalPlacesValue = (value, fallback) => {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        return fallback;
+    }
+    const truncated = Math.trunc(value);
+    if (truncated < 0 || truncated > 20) {
+        return fallback;
+    }
+    return truncated;
+};
 export const isValidScopeValue = (value, localState, mainScope) => {
     if (value !== undefined && Object.keys(ScaleFactors).includes(value)) {
         return value;
@@ -836,16 +836,6 @@ export const isValidUint8Array = (value) => {
     }
     return undefined;
 };
-/**
- * Validates a Standard id.
- * Returns the id if valid and present in standards, otherwise returns the default DUC standard id.
- */
-export const isValidStandardId = (id, standards, defaultId = PREDEFINED_STANDARDS.DUC) => {
-    const validId = isValidString(id);
-    if (isStandardIdPresent(validId, standards))
-        return validId;
-    return defaultId;
-};
 /**
  * Validates a block id.
  * Returns the id if present in restored blocks, otherwise returns null.

package/dist/restore/restoreElements.d.ts

@@ -1,5 +1,5 @@
-import { ElementsConfig, RestoredDataState } from "./restoreDataState";
 import { BezierMirroring, DucElement, DucFreeDrawEasing, DucLocalState, DucPoint, ImportedDataState, OrderedDucElement, PrecisionValue, Scope } from "../types";
+import { ElementsConfig, RestoredDataState } from "./restoreDataState";
 /**
  * Restores a point that might have legacy format (x,y as numbers)
  * @param point - The point to restore