ducjs 3.2.0 → 3.2.2

package/dist/ducjs_wasm.d.ts

@@ -1,30 +1,47 @@
 /* tslint:disable */
 /* eslint-disable */
 /**
- * Fetch a single external file from a `.duc` buffer by file ID.
+ * Read the full VersionGraph from a `.duc` file buffer.
  *
- * Returns the file entry as a JS object, or `undefined` if not found.
+ * Returns a JS object matching the `VersionGraph` TypeScript interface,
+ * or `undefined` if no version graph exists.
  */
-export function getExternalFile(buf: Uint8Array, file_id: string): any;
+export function readVersionGraph(duc_buf: Uint8Array): any;
 /**
- * Restore a specific checkpoint by its ID from a `.duc` file buffer.
+ * Compute a checkpoint-relative binary diff changeset using bsdiff.
  *
- * Returns a JS object `{ versionNumber, schemaVersion, data, fromCheckpoint }`.
+ * `base_state` is the checkpoint's full data blob.
+ * `current_state` is the full document state at the new version.
+ *
+ * Returns an encoded changeset (`Uint8Array`) ready for storage in a
+ * `Delta.payload`. bsdiff finds matching blocks even when they shift
+ * offsets, which is critical for SQLite databases.
  */
-export function restoreCheckpoint(duc_buf: Uint8Array, checkpoint_id: string): any;
+export function createDeltaChangeset(base_state: Uint8Array, current_state: Uint8Array): Uint8Array;
 /**
- * List all versions (checkpoints + deltas) from a `.duc` file buffer.
+ * Apply a changeset to reconstruct document state.
  *
- * Returns a JS array of `VersionEntry` objects (no heavy data blobs).
+ * `base_state` must be the exact checkpoint data used when the changeset
+ * was created. Returns the full document state as `Uint8Array`.
+ *
+ * Handles all changeset formats transparently:
+ *   - v3 (bsdiff), v2 (XOR diff), v1 (zlib full snapshot)
  */
-export function listVersions(duc_buf: Uint8Array): any;
+export function applyDeltaChangeset(base_state: Uint8Array, changeset: Uint8Array): Uint8Array;
 /**
- * Read the full VersionGraph from a `.duc` file buffer.
+ * Parse a `.duc` file (Uint8Array) into a JS object (ExportedDataState).
+ */
+export function parseDuc(buf: Uint8Array): any;
+/**
+ * Serialize a JS object (ExportedDataState) into `.duc` bytes (Uint8Array).
+ */
+export function serializeDuc(data: any): Uint8Array;
+/**
+ * Fetch a single external file from a `.duc` buffer by file ID.
  *
- * Returns a JS object matching the `VersionGraph` TypeScript interface,
- * or `undefined` if no version graph exists.
+ * Returns the file entry as a JS object, or `undefined` if not found.
  */
-export function readVersionGraph(duc_buf: Uint8Array): any;
+export function getExternalFile(buf: Uint8Array, file_id: string): any;
 /**
  * Returns the current version-control schema version defined in Rust.
  *
@@ -34,15 +51,6 @@ export function readVersionGraph(duc_buf: Uint8Array): any;
  * recording migrations) the next time a checkpoint or delta is created.
  */
 export function getCurrentSchemaVersion(): number;
-/**
- * Restore the document state at `version_number` from a `.duc` file buffer.
- *
- * The `.duc` file is a SQLite database — this function opens it and queries
- * the `checkpoints` / `deltas` tables directly for version restoration.
- *
- * Returns a JS object `{ versionNumber, schemaVersion, data, fromCheckpoint }`.
- */
-export function restoreVersion(duc_buf: Uint8Array, version_number: number): any;
 /**
  * Revert the document to a specific version, removing all newer versions.
  *
@@ -50,44 +58,36 @@ export function restoreVersion(duc_buf: Uint8Array, version_number: number): any
  */
 export function revertToVersion(duc_buf: Uint8Array, target_version: number): any;
 /**
- * Apply a changeset to reconstruct document state.
- *
- * `base_state` must be the exact checkpoint data used when the changeset
- * was created. Returns the full document state as `Uint8Array`.
+ * Restore a specific checkpoint by its ID from a `.duc` file buffer.
  *
- * Handles all changeset formats transparently:
- *   - v3 (bsdiff), v2 (XOR diff), v1 (zlib full snapshot)
+ * Returns a JS object `{ versionNumber, schemaVersion, data, fromCheckpoint }`.
  */
-export function applyDeltaChangeset(base_state: Uint8Array, changeset: Uint8Array): Uint8Array;
+export function restoreCheckpoint(duc_buf: Uint8Array, checkpoint_id: string): any;
 /**
  * List metadata for all external files (without loading the heavy data blobs).
  */
 export function listExternalFiles(buf: Uint8Array): any;
 /**
- * Serialize a JS object (ExportedDataState) into `.duc` bytes (Uint8Array).
- */
-export function serializeDuc(data: any): Uint8Array;
-/**
- * Compute a checkpoint-relative binary diff changeset using bsdiff.
- *
- * `base_state` is the checkpoint's full data blob.
- * `current_state` is the full document state at the new version.
+ * List all versions (checkpoints + deltas) from a `.duc` file buffer.
  *
- * Returns an encoded changeset (`Uint8Array`) ready for storage in a
- * `Delta.payload`. bsdiff finds matching blocks even when they shift
- * offsets, which is critical for SQLite databases.
- */
-export function createDeltaChangeset(base_state: Uint8Array, current_state: Uint8Array): Uint8Array;
-/**
- * Parse a `.duc` file (Uint8Array) into a JS object (ExportedDataState).
+ * Returns a JS array of `VersionEntry` objects (no heavy data blobs).
  */
-export function parseDuc(buf: Uint8Array): any;
+export function listVersions(duc_buf: Uint8Array): any;
 /**
  * Parse a `.duc` file lazily — returns everything EXCEPT external file data blobs.
  *
  * Use `getExternalFile()` or `listExternalFiles()` for on-demand access.
  */
 export function parseDucLazy(buf: Uint8Array): any;
+/**
+ * Restore the document state at `version_number` from a `.duc` file buffer.
+ *
+ * The `.duc` file is a SQLite database — this function opens it and queries
+ * the `checkpoints` / `deltas` tables directly for version restoration.
+ *
+ * Returns a JS object `{ versionNumber, schemaVersion, data, fromCheckpoint }`.
+ */
+export function restoreVersion(duc_buf: Uint8Array, version_number: number): any;
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 

package/dist/ducjs_wasm.js

@@ -195,19 +195,17 @@ function takeFromExternrefTable0(idx) {
     return value;
 }
 /**
- * Fetch a single external file from a `.duc` buffer by file ID.
+ * Read the full VersionGraph from a `.duc` file buffer.
  *
- * Returns the file entry as a JS object, or `undefined` if not found.
- * @param {Uint8Array} buf
- * @param {string} file_id
+ * Returns a JS object matching the `VersionGraph` TypeScript interface,
+ * or `undefined` if no version graph exists.
+ * @param {Uint8Array} duc_buf
  * @returns {any}
  */
-export function getExternalFile(buf, file_id) {
-    const ptr0 = passArray8ToWasm0(buf, wasm.__wbindgen_malloc);
+export function readVersionGraph(duc_buf) {
+    const ptr0 = passArray8ToWasm0(duc_buf, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ptr1 = passStringToWasm0(file_id, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
-    const len1 = WASM_VECTOR_LEN;
-    const ret = wasm.getExternalFile(ptr0, len0, ptr1, len1);
+    const ret = wasm.readVersionGraph(ptr0, len0);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
@@ -215,36 +213,67 @@ export function getExternalFile(buf, file_id) {
 }
 
 /**
- * Restore a specific checkpoint by its ID from a `.duc` file buffer.
+ * Compute a checkpoint-relative binary diff changeset using bsdiff.
  *
- * Returns a JS object `{ versionNumber, schemaVersion, data, fromCheckpoint }`.
- * @param {Uint8Array} duc_buf
- * @param {string} checkpoint_id
- * @returns {any}
+ * `base_state` is the checkpoint's full data blob.
+ * `current_state` is the full document state at the new version.
+ *
+ * Returns an encoded changeset (`Uint8Array`) ready for storage in a
+ * `Delta.payload`. bsdiff finds matching blocks even when they shift
+ * offsets, which is critical for SQLite databases.
+ * @param {Uint8Array} base_state
+ * @param {Uint8Array} current_state
+ * @returns {Uint8Array}
  */
-export function restoreCheckpoint(duc_buf, checkpoint_id) {
-    const ptr0 = passArray8ToWasm0(duc_buf, wasm.__wbindgen_malloc);
+export function createDeltaChangeset(base_state, current_state) {
+    const ptr0 = passArray8ToWasm0(base_state, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ptr1 = passStringToWasm0(checkpoint_id, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const ptr1 = passArray8ToWasm0(current_state, wasm.__wbindgen_malloc);
     const len1 = WASM_VECTOR_LEN;
-    const ret = wasm.restoreCheckpoint(ptr0, len0, ptr1, len1);
-    if (ret[2]) {
-        throw takeFromExternrefTable0(ret[1]);
+    const ret = wasm.createDeltaChangeset(ptr0, len0, ptr1, len1);
+    if (ret[3]) {
+        throw takeFromExternrefTable0(ret[2]);
     }
-    return takeFromExternrefTable0(ret[0]);
+    var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+    return v3;
 }
 
 /**
- * List all versions (checkpoints + deltas) from a `.duc` file buffer.
+ * Apply a changeset to reconstruct document state.
  *
- * Returns a JS array of `VersionEntry` objects (no heavy data blobs).
- * @param {Uint8Array} duc_buf
+ * `base_state` must be the exact checkpoint data used when the changeset
+ * was created. Returns the full document state as `Uint8Array`.
+ *
+ * Handles all changeset formats transparently:
+ *   - v3 (bsdiff), v2 (XOR diff), v1 (zlib full snapshot)
+ * @param {Uint8Array} base_state
+ * @param {Uint8Array} changeset
+ * @returns {Uint8Array}
+ */
+export function applyDeltaChangeset(base_state, changeset) {
+    const ptr0 = passArray8ToWasm0(base_state, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passArray8ToWasm0(changeset, wasm.__wbindgen_malloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.applyDeltaChangeset(ptr0, len0, ptr1, len1);
+    if (ret[3]) {
+        throw takeFromExternrefTable0(ret[2]);
+    }
+    var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+    return v3;
+}
+
+/**
+ * Parse a `.duc` file (Uint8Array) into a JS object (ExportedDataState).
+ * @param {Uint8Array} buf
  * @returns {any}
  */
-export function listVersions(duc_buf) {
-    const ptr0 = passArray8ToWasm0(duc_buf, wasm.__wbindgen_malloc);
+export function parseDuc(buf) {
+    const ptr0 = passArray8ToWasm0(buf, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.listVersions(ptr0, len0);
+    const ret = wasm.parseDuc(ptr0, len0);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
@@ -252,17 +281,34 @@ export function listVersions(duc_buf) {
 }
 
 /**
- * Read the full VersionGraph from a `.duc` file buffer.
+ * Serialize a JS object (ExportedDataState) into `.duc` bytes (Uint8Array).
+ * @param {any} data
+ * @returns {Uint8Array}
+ */
+export function serializeDuc(data) {
+    const ret = wasm.serializeDuc(data);
+    if (ret[3]) {
+        throw takeFromExternrefTable0(ret[2]);
+    }
+    var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+    return v1;
+}
+
+/**
+ * Fetch a single external file from a `.duc` buffer by file ID.
  *
- * Returns a JS object matching the `VersionGraph` TypeScript interface,
- * or `undefined` if no version graph exists.
- * @param {Uint8Array} duc_buf
+ * Returns the file entry as a JS object, or `undefined` if not found.
+ * @param {Uint8Array} buf
+ * @param {string} file_id
  * @returns {any}
  */
-export function readVersionGraph(duc_buf) {
-    const ptr0 = passArray8ToWasm0(duc_buf, wasm.__wbindgen_malloc);
+export function getExternalFile(buf, file_id) {
+    const ptr0 = passArray8ToWasm0(buf, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.readVersionGraph(ptr0, len0);
+    const ptr1 = passStringToWasm0(file_id, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.getExternalFile(ptr0, len0, ptr1, len1);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
@@ -279,24 +325,21 @@ export function readVersionGraph(duc_buf) {
  * @returns {number}
  */
 export function getCurrentSchemaVersion() {
-    return 3000002;
+    return 3000003;
 }
 
 /**
- * Restore the document state at `version_number` from a `.duc` file buffer.
- *
- * The `.duc` file is a SQLite database — this function opens it and queries
- * the `checkpoints` / `deltas` tables directly for version restoration.
+ * Revert the document to a specific version, removing all newer versions.
  *
  * Returns a JS object `{ versionNumber, schemaVersion, data, fromCheckpoint }`.
  * @param {Uint8Array} duc_buf
- * @param {number} version_number
+ * @param {number} target_version
  * @returns {any}
  */
-export function restoreVersion(duc_buf, version_number) {
+export function revertToVersion(duc_buf, target_version) {
     const ptr0 = passArray8ToWasm0(duc_buf, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.restoreVersion(ptr0, len0, version_number);
+    const ret = wasm.revertToVersion(ptr0, len0, target_version);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
@@ -304,49 +347,25 @@ export function restoreVersion(duc_buf, version_number) {
 }
 
 /**
- * Revert the document to a specific version, removing all newer versions.
+ * Restore a specific checkpoint by its ID from a `.duc` file buffer.
  *
  * Returns a JS object `{ versionNumber, schemaVersion, data, fromCheckpoint }`.
  * @param {Uint8Array} duc_buf
- * @param {number} target_version
+ * @param {string} checkpoint_id
  * @returns {any}
  */
-export function revertToVersion(duc_buf, target_version) {
+export function restoreCheckpoint(duc_buf, checkpoint_id) {
     const ptr0 = passArray8ToWasm0(duc_buf, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.revertToVersion(ptr0, len0, target_version);
+    const ptr1 = passStringToWasm0(checkpoint_id, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.restoreCheckpoint(ptr0, len0, ptr1, len1);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
     return takeFromExternrefTable0(ret[0]);
 }
 
-/**
- * Apply a changeset to reconstruct document state.
- *
- * `base_state` must be the exact checkpoint data used when the changeset
- * was created. Returns the full document state as `Uint8Array`.
- *
- * Handles all changeset formats transparently:
- *   - v3 (bsdiff), v2 (XOR diff), v1 (zlib full snapshot)
- * @param {Uint8Array} base_state
- * @param {Uint8Array} changeset
- * @returns {Uint8Array}
- */
-export function applyDeltaChangeset(base_state, changeset) {
-    const ptr0 = passArray8ToWasm0(base_state, wasm.__wbindgen_malloc);
-    const len0 = WASM_VECTOR_LEN;
-    const ptr1 = passArray8ToWasm0(changeset, wasm.__wbindgen_malloc);
-    const len1 = WASM_VECTOR_LEN;
-    const ret = wasm.applyDeltaChangeset(ptr0, len0, ptr1, len1);
-    if (ret[3]) {
-        throw takeFromExternrefTable0(ret[2]);
-    }
-    var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
-    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-    return v3;
-}
-
 /**
  * List metadata for all external files (without loading the heavy data blobs).
  * @param {Uint8Array} buf
@@ -363,56 +382,33 @@ export function listExternalFiles(buf) {
 }
 
 /**
- * Serialize a JS object (ExportedDataState) into `.duc` bytes (Uint8Array).
- * @param {any} data
- * @returns {Uint8Array}
- */
-export function serializeDuc(data) {
-    const ret = wasm.serializeDuc(data);
-    if (ret[3]) {
-        throw takeFromExternrefTable0(ret[2]);
-    }
-    var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
-    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-    return v1;
-}
-
-/**
- * Compute a checkpoint-relative binary diff changeset using bsdiff.
- *
- * `base_state` is the checkpoint's full data blob.
- * `current_state` is the full document state at the new version.
+ * List all versions (checkpoints + deltas) from a `.duc` file buffer.
  *
- * Returns an encoded changeset (`Uint8Array`) ready for storage in a
- * `Delta.payload`. bsdiff finds matching blocks even when they shift
- * offsets, which is critical for SQLite databases.
- * @param {Uint8Array} base_state
- * @param {Uint8Array} current_state
- * @returns {Uint8Array}
+ * Returns a JS array of `VersionEntry` objects (no heavy data blobs).
+ * @param {Uint8Array} duc_buf
+ * @returns {any}
  */
-export function createDeltaChangeset(base_state, current_state) {
-    const ptr0 = passArray8ToWasm0(base_state, wasm.__wbindgen_malloc);
+export function listVersions(duc_buf) {
+    const ptr0 = passArray8ToWasm0(duc_buf, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ptr1 = passArray8ToWasm0(current_state, wasm.__wbindgen_malloc);
-    const len1 = WASM_VECTOR_LEN;
-    const ret = wasm.createDeltaChangeset(ptr0, len0, ptr1, len1);
-    if (ret[3]) {
-        throw takeFromExternrefTable0(ret[2]);
+    const ret = wasm.listVersions(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
     }
-    var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
-    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-    return v3;
+    return takeFromExternrefTable0(ret[0]);
 }
 
 /**
- * Parse a `.duc` file (Uint8Array) into a JS object (ExportedDataState).
+ * Parse a `.duc` file lazily — returns everything EXCEPT external file data blobs.
+ *
+ * Use `getExternalFile()` or `listExternalFiles()` for on-demand access.
  * @param {Uint8Array} buf
  * @returns {any}
  */
-export function parseDuc(buf) {
+export function parseDucLazy(buf) {
     const ptr0 = passArray8ToWasm0(buf, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.parseDuc(ptr0, len0);
+    const ret = wasm.parseDucLazy(ptr0, len0);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }
@@ -420,16 +416,20 @@ export function parseDuc(buf) {
 }
 
 /**
- * Parse a `.duc` file lazily — returns everything EXCEPT external file data blobs.
+ * Restore the document state at `version_number` from a `.duc` file buffer.
  *
- * Use `getExternalFile()` or `listExternalFiles()` for on-demand access.
- * @param {Uint8Array} buf
+ * The `.duc` file is a SQLite database — this function opens it and queries
+ * the `checkpoints` / `deltas` tables directly for version restoration.
+ *
+ * Returns a JS object `{ versionNumber, schemaVersion, data, fromCheckpoint }`.
+ * @param {Uint8Array} duc_buf
+ * @param {number} version_number
  * @returns {any}
  */
-export function parseDucLazy(buf) {
-    const ptr0 = passArray8ToWasm0(buf, wasm.__wbindgen_malloc);
+export function restoreVersion(duc_buf, version_number) {
+    const ptr0 = passArray8ToWasm0(duc_buf, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.parseDucLazy(ptr0, len0);
+    const ret = wasm.restoreVersion(ptr0, len0, version_number);
     if (ret[2]) {
         throw takeFromExternrefTable0(ret[1]);
     }

package/dist/restore/restoreDataState.d.ts

@@ -47,7 +47,7 @@ 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 restoreFiles: (importedFiles: unknown, restoredFilesData?: ExternalFilesData) => DucExternalFiles;
 /**
  * Restore external file data blobs from the split `filesData` field.
  * Also extracts data from legacy inline `revisions[].data` when present.

package/dist/restore/restoreDataState.js

@@ -20,6 +20,8 @@ export const restore = (data, elementsConfig, restoreConfig = {}) => {
     const restoredBlockInstances = restoreBlockInstances(data === null || data === void 0 ? void 0 : data.blockInstances, restoredLocalState.scope);
     const restoredElements = restoreElements(data === null || data === void 0 ? void 0 : data.elements, restoredLocalState.scope, restoredBlocks, restoredElementsConfig);
     const restoredVersionGraph = restoreVersionGraph(data === null || data === void 0 ? void 0 : data.versionGraph);
+    const restoredFilesData = restoreFilesData(data === null || data === void 0 ? void 0 : data.filesData, data === null || data === void 0 ? void 0 : data.files);
+    const restoredFiles = restoreFiles(data === null || data === void 0 ? void 0 : data.files, restoredFilesData);
     // 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();
@@ -36,12 +38,28 @@ export const restore = (data, elementsConfig, restoreConfig = {}) => {
         versionGraph: restoredVersionGraph,
         localState: restoredLocalState,
         globalState: restoredGlobalState,
-        files: restoreFiles(data === null || data === void 0 ? void 0 : data.files),
-        filesData: restoreFilesData(data === null || data === void 0 ? void 0 : data.filesData, data === null || data === void 0 ? void 0 : data.files),
+        files: restoredFiles,
+        filesData: restoredFilesData,
         id: restoredId,
     };
 };
-export const restoreFiles = (importedFiles) => {
+const getRestoredRevisionSizeBytes = (rawSizeBytes, revisionId, restoredFilesData) => {
+    var _a, _b, _c;
+    const explicitSizeBytes = isFiniteNumber(rawSizeBytes)
+        ? rawSizeBytes
+        : undefined;
+    if (typeof explicitSizeBytes === "number" && explicitSizeBytes > 0) {
+        return explicitSizeBytes;
+    }
+    return (_c = (_b = (_a = restoredFilesData[revisionId]) === null || _a === void 0 ? void 0 : _a.byteLength) !== null && _b !== void 0 ? _b : explicitSizeBytes) !== null && _c !== void 0 ? _c : 0;
+};
+const getRestoredSourceName = (fileData) => {
+    return isValidString(fileData.sourceName)
+        || isValidString(fileData.fileName)
+        || isValidString(fileData.name)
+        || undefined;
+};
+export const restoreFiles = (importedFiles, restoredFilesData = {}) => {
     if (!importedFiles || typeof importedFiles !== "object") {
         return {};
     }
@@ -74,9 +92,9 @@ export const restoreFiles = (importedFiles) => {
                     continue;
                 restoredRevisions[revKey] = {
                     id: revId,
-                    sizeBytes: isFiniteNumber(r.sizeBytes) ? r.sizeBytes : 0,
+                    sizeBytes: getRestoredRevisionSizeBytes(r.sizeBytes, revId, restoredFilesData),
                     checksum: isValidString(r.checksum) || undefined,
-                    sourceName: isValidString(r.sourceName) || undefined,
+                    sourceName: getRestoredSourceName(r),
                     mimeType,
                     message: isValidString(r.message) || undefined,
                     created: isFiniteNumber(r.created) ? r.created : Date.now(),
@@ -113,7 +131,8 @@ export const restoreFiles = (importedFiles) => {
             revisions: {
                 [revId]: {
                     id: revId,
-                    sizeBytes: 0,
+                    sizeBytes: getRestoredRevisionSizeBytes(legacyData.sizeBytes, revId, restoredFilesData),
+                    sourceName: getRestoredSourceName(legacyData),
                     mimeType,
                     created,
                     lastRetrieved: isFiniteNumber(legacyData.lastRetrieved)

package/dist/restore/restoreElements.js

@@ -240,7 +240,11 @@ const restoreElement = (element, currentScope, restoredBlocks, localState, globa
                     ? repairBinding(element, endBinding, currentScope, restoredBlocks)
                     : null;
             // Create the base restored element
+            // Skip sizeFromPoints override for block instance elements: their stored
+            // width/height represents the total duplication grid, not single-cell dims.
+            const isBlockInstanceElement = !!element.instanceId;
             const sizeFromPoints = !hasBindings &&
+                !isBlockInstanceElement &&
                 getSizeFromPoints(finalPoints.map(getScopedBezierPointFromDucPoint));
             let restoredElement = restoreElementWithProperties(element, Object.assign({ points: finalPoints, lines, lastCommittedPoint: element.lastCommittedPoint
                     ? restorePoint(element.lastCommittedPoint, element.scope, currentScope)
@@ -329,7 +333,7 @@ const restoreElement = (element, currentScope, restoredBlocks, localState, globa
                 modelType: isValidString(modelElement.modelType) || null,
                 code: isValidString(modelElement.code) || null,
                 fileIds: modelElement.fileIds || [],
-                svgPath: modelElement.svgPath || null,
+                thumbnail: modelElement.thumbnail instanceof Uint8Array ? modelElement.thumbnail : null,
                 viewerState: (modelElement.viewerState || null),
             }, localState, globalState);
         }

package/dist/transform.js

@@ -284,14 +284,95 @@ function fixElementFromRust(el) {
         return el;
     return Object.assign(Object.assign({}, rest), { isCollapsed: (_c = stackBase.isCollapsed) !== null && _c !== void 0 ? _c : false });
 }
+function normalizeViewer3DStateForRust(vs) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    if (!vs || typeof vs !== "object")
+        return vs;
+    const n = (v, fallback) => typeof v === "number" && Number.isFinite(v) ? v : fallback;
+    const b = (v, fallback) => typeof v === "boolean" ? v : fallback;
+    const s = (v, fallback) => typeof v === "string" ? v : fallback;
+    const arr3 = (v, fallback) => Array.isArray(v) && v.length === 3 && v.every((x) => typeof x === "number")
+        ? v
+        : fallback;
+    const arr4 = (v, fallback) => Array.isArray(v) && v.length === 4 && v.every((x) => typeof x === "number")
+        ? v
+        : fallback;
+    const cam = (_a = vs.camera) !== null && _a !== void 0 ? _a : {};
+    const dsp = (_b = vs.display) !== null && _b !== void 0 ? _b : {};
+    const mat = (_c = vs.material) !== null && _c !== void 0 ? _c : {};
+    const clip = (_d = vs.clipping) !== null && _d !== void 0 ? _d : {};
+    const expl = (_e = vs.explode) !== null && _e !== void 0 ? _e : {};
+    const zeb = (_f = vs.zebra) !== null && _f !== void 0 ? _f : {};
+    const normalizeClipPlane = (cp) => ({
+        enabled: b(cp === null || cp === void 0 ? void 0 : cp.enabled, false),
+        value: n(cp === null || cp === void 0 ? void 0 : cp.value, 0),
+        normal: (cp === null || cp === void 0 ? void 0 : cp.normal) != null ? arr3(cp.normal, [0, 0, 0]) : null,
+    });
+    return {
+        camera: {
+            control: s(cam.control, "orbit"),
+            ortho: b(cam.ortho, true),
+            up: s(cam.up, "Z"),
+            position: arr3(cam.position, [0, 0, 0]),
+            quaternion: arr4(cam.quaternion, [0, 0, 0, 1]),
+            target: arr3(cam.target, [0, 0, 0]),
+            zoom: n(cam.zoom, 1),
+            panSpeed: n(cam.panSpeed, 1),
+            rotateSpeed: n(cam.rotateSpeed, 1),
+            zoomSpeed: n(cam.zoomSpeed, 1),
+            holroyd: b(cam.holroyd, false),
+        },
+        display: {
+            wireframe: b(dsp.wireframe, false),
+            transparent: b(dsp.transparent, false),
+            blackEdges: b(dsp.blackEdges, true),
+            grid: (_g = dsp.grid) !== null && _g !== void 0 ? _g : { type: "uniform", value: false },
+            axesVisible: b(dsp.axesVisible, false),
+            axesAtOrigin: b(dsp.axesAtOrigin, false),
+        },
+        material: {
+            metalness: n(mat.metalness, 0.3),
+            roughness: n(mat.roughness, 0.65),
+            defaultOpacity: n(mat.defaultOpacity, 0.5),
+            edgeColor: n(mat.edgeColor, 0x707070),
+            ambientIntensity: n(mat.ambientIntensity, 1.0),
+            directIntensity: n(mat.directIntensity, 1.1),
+        },
+        clipping: {
+            x: normalizeClipPlane(clip.x),
+            y: normalizeClipPlane(clip.y),
+            z: normalizeClipPlane(clip.z),
+            intersection: b(clip.intersection, false),
+            showPlanes: b(clip.showPlanes, false),
+            objectColorCaps: b(clip.objectColorCaps, false),
+        },
+        explode: {
+            active: b(expl.active, false),
+            value: n(expl.value, 0),
+        },
+        zebra: {
+            active: b(zeb.active, false),
+            stripeCount: toInteger(zeb.stripeCount, 6),
+            stripeDirection: n(zeb.stripeDirection, 0),
+            colorScheme: s(zeb.colorScheme, "blackwhite"),
+            opacity: n(zeb.opacity, 1),
+            mappingMode: s(zeb.mappingMode, "reflection"),
+        },
+    };
+}
 function fixElementToRust(el) {
     var _a, _b, _c, _d, _e, _f, _g, _h;
     if (!el)
         return el;
     fixStylesHatch(el, false);
     fixCustomDataToRust(el);
-    if (el.type === "model" && ((_b = (_a = el.viewerState) === null || _a === void 0 ? void 0 : _a.display) === null || _b === void 0 ? void 0 : _b.grid)) {
-        el.viewerState = Object.assign(Object.assign({}, el.viewerState), { display: Object.assign(Object.assign({}, el.viewerState.display), { grid: fixViewer3DGridToRust(el.viewerState.display.grid) }) });
+    if (el.type === "model") {
+        if (el.viewerState) {
+            el.viewerState = normalizeViewer3DStateForRust(el.viewerState);
+        }
+        if ((_b = (_a = el.viewerState) === null || _a === void 0 ? void 0 : _a.display) === null || _b === void 0 ? void 0 : _b.grid) {
+            el.viewerState = Object.assign(Object.assign({}, el.viewerState), { display: Object.assign(Object.assign({}, el.viewerState.display), { grid: fixViewer3DGridToRust(el.viewerState.display.grid) }) });
+        }
     }
     // Convert TypeScript DucLine tuples [start, end] → Rust structs { start, end }
     if (LINEAR_ELEMENT_TYPES.has(el.type) && Array.isArray(el.lines)) {
@@ -349,6 +430,9 @@ function flattenPrecisionValues(obj) {
         return obj.value;
     if (Array.isArray(obj))
         return obj.map(flattenPrecisionValues);
+    if (ArrayBuffer.isView(obj) || obj instanceof ArrayBuffer) {
+        return obj;
+    }
     if (typeof obj === "object") {
         const out = {};
         for (const key in obj) {

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

@@ -846,8 +846,8 @@ export type DucModelElement = _DucElementBase & {
     modelType: string | null;
     /** Defines the source code of the model using build123d python code */
     code: string | null;
-    /** The last known SVG path representation of the 3D model for quick rendering on the canvas */
-    svgPath: string | null;
+    /** The last known image thumbnail of the 3D model for quick rendering on the canvas */
+    thumbnail: Uint8Array | null;
     /** Possibly connected external files, such as STEP, STL, DXF, etc. */
     fileIds: ExternalFileId[];
     /** The last known 3D viewer state for the model */

package/dist/types/index.d.ts

@@ -101,7 +101,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" | "doc" | "pdf";
+export type ToolType = "selection" | "rectangle" | "polygon" | "ellipse" | "line" | "freedraw" | "text" | "image" | "eraser" | "hand" | "frame" | "plot" | "embeddable" | "ruler" | "lasso" | "laser" | "table" | "doc" | "pdf" | "model";
 export type ElementOrToolType = DucElementType | ToolType | "custom";
 /**
  * Defines the global, persistent settings for the drawing. These are fundamental

package/dist/utils/elements/newElement.js

@@ -159,7 +159,7 @@ export const newDocElement = (currentScope, opts) => {
         } }));
 };
 export const newPdfElement = (currentScope, opts) => (Object.assign(Object.assign({ fileId: null, gridConfig: { columns: 1, gapX: 0, gapY: 0, firstPageAlone: false, scale: 1 } }, _newElementBase("pdf", currentScope, opts)), { type: "pdf" }));
-export const newModelElement = (currentScope, opts) => (Object.assign(Object.assign({ modelType: null, code: null, svgPath: null, fileIds: [], viewerState: null }, _newElementBase("model", currentScope, opts)), { type: 'model' }));
+export const newModelElement = (currentScope, opts) => (Object.assign(Object.assign({ modelType: null, code: null, thumbnail: null, fileIds: [], viewerState: null }, _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,
@@ -174,6 +174,9 @@ const _deepCopyElement = (val, depth = 0) => {
     if (val == null || typeof val !== "object") {
         return val;
     }
+    if (ArrayBuffer.isView(val)) {
+        return val.slice(0);
+    }
     const objectType = Object.prototype.toString.call(val);
     if (objectType === "[object Object]") {
         const tmp = typeof val.constructor === "function"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ducjs",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "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",