ducjs 2.1.0 → 2.2.3

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

@@ -1,10 +1,10 @@
 export * from "./typeChecks";
+import { DucView, PrecisionValue, Scope } from "..";
 import { BEZIER_MIRRORING, BLENDING, BLOCK_ATTACHMENT, BOOLEAN_OPERATION, COLUMN_TYPE, DATUM_BRACKET_STYLE, DATUM_TARGET_TYPE, DIMENSION_FIT_RULE, DIMENSION_TEXT_PLACEMENT, DIMENSION_TYPE, ELEMENT_CONTENT_PREFERENCE, FEATURE_MODIFIER, GDT_SYMBOL, HATCH_STYLE, IMAGE_STATUS, LINE_HEAD, LINE_SPACING_TYPE, MARK_ELLIPSE_CENTER, MATERIAL_CONDITION, PARAMETRIC_SOURCE_TYPE, STACKED_TEXT_ALIGN, STROKE_CAP, STROKE_JOIN, STROKE_PLACEMENT, STROKE_PREFERENCE, STROKE_SIDE_PREFERENCE, TABLE_CELL_ALIGNMENT, TABLE_FLOW_DIRECTION, TEXT_ALIGN, TEXT_FIELD_SOURCE_PROPERTY, TEXT_FIELD_SOURCE_TYPE, TEXT_FLOW_DIRECTION, TOLERANCE_DISPLAY, TOLERANCE_TYPE, TOLERANCE_ZONE_TYPE, VERTICAL_ALIGN, VIEWPORT_SHADE_PLOT } from "../../flatbuffers/duc";
 import { Standard, StandardUnits } from "../../technical/standards";
-import { DucView, PrecisionValue, Scope } from "..";
+import { FONT_FAMILY, FREEDRAW_EASINGS } from "../../utils/constants";
 import { Axis, GeometricPoint, Percentage, Radian, ScaleFactor } from "../geometryTypes";
 import { MakeBrand, MarkNonNullable, MarkOptional, Merge, ValueOf } from "../utility-types";
-import { FONT_FAMILY, FREEDRAW_EASINGS } from "../../utils/constants";
 /**
  * Base styles that all elements share
  */
@@ -56,17 +56,27 @@ export type _DucElementBase = Readonly<_DucElementStylesBase & {
     isAnnotative: boolean;
     /** Whether the element is deleted */
     isDeleted: boolean;
+    /**
+     * List of regions the element belongs.
+     * Used to define boolean operations between elements.
+     * Ordered from deepest to shallowest.
+    */
+    regionIds: readonly RegionId[];
     /**
      * List of groups the element belongs to.
      * Ordered from deepest to shallowest.
      */
     groupIds: readonly GroupId[];
     /**
-     * List of regions the element belongs.
-     * Used to define boolean operations between elements.
-     * Ordered from deepest to shallowest.
+     * List of blocks this element helps *define*.
+     * If this is populated, `instanceId` should be null.
      */
-    regionIds: readonly RegionId[];
+    blockIds: readonly BlockId[];
+    /**
+     * The ID of the `DucBlockInstance` this element belongs to.
+     * If not null, `blockIds` is empty (the relationship to the Block is via the Instance).
+     */
+    instanceId: InstanceId | null;
     /** The layer the element belongs to */
     layerId: string | null;
     /** The frame the element belongs to */
@@ -96,6 +106,8 @@ export type FillStyle = ValueOf<typeof ELEMENT_CONTENT_PREFERENCE>;
 export type StrokePlacement = ValueOf<typeof STROKE_PLACEMENT>;
 export type Blending = ValueOf<typeof BLENDING>;
 export type GroupId = string;
+export type BlockId = string;
+export type InstanceId = string;
 export type LayerId = string;
 export type RegionId = string;
 export type PointerType = "mouse" | "pen" | "touch";
@@ -122,7 +134,7 @@ export type DucGenericElement = DucSelectionElement | DucRectangleElement;
  * no computed data. The list of all DucElements should be shareable
  * between peers and contain no state local to the peer.
  */
-export type DucElement = DucGenericElement | DucTextElement | DucLinearElement | DucFreeDrawElement | DucArrowElement | DucImageElement | DucFrameElement | DucEmbeddableElement | DucTableElement | DucDocElement | DucEllipseElement | DucBlockInstanceElement | DucPolygonElement | DucParametricElement | DucFeatureControlFrameElement | DucLeaderElement | DucDimensionElement | DucViewportElement | DucPlotElement | DucXRayElement | DucPdfElement | DucMermaidElement;
+export type DucElement = DucGenericElement | DucTextElement | DucLinearElement | DucFreeDrawElement | DucArrowElement | DucImageElement | DucFrameElement | DucEmbeddableElement | DucTableElement | DucDocElement | DucEllipseElement | DucPolygonElement | DucParametricElement | DucFeatureControlFrameElement | DucLeaderElement | DucDimensionElement | DucViewportElement | DucPlotElement | DucXRayElement | DucPdfElement | DucMermaidElement;
 export type DucElementTypes = DucElement["type"];
 export type NonDeleted<TElement extends DucElement> = TElement & {
     isDeleted: boolean;
@@ -134,12 +146,12 @@ export type DucBinderElement = DucLinearElement | DucDimensionElement | DucFeatu
 export type DucBindableElement = DucRectangleElement | DucPolygonElement | DucEllipseElement | DucTextElement | DucImageElement | DucEmbeddableElement | DucFrameElement | DucTableElement | DucDocElement | DucFeatureControlFrameElement | DucLinearElement | DucPdfElement | DucMermaidElement;
 export type DucTextContainer = DucRectangleElement | DucPolygonElement | DucEllipseElement | DucArrowElement;
 export type DucFlowchartNodeElement = DucRectangleElement | DucPolygonElement | DucEllipseElement;
-export type RectangularElement = DucRectangleElement | DucPolygonElement | DucFrameLikeElement | DucEmbeddableElement | DucImageElement | DucTextElement | DucSelectionElement | DucDocElement | DucTableElement | DucFeatureControlFrameElement | DucViewportElement | DucPlotElement | DucPdfElement | DucBlockInstanceElement;
+export type RectangularElement = DucRectangleElement | DucPolygonElement | DucFrameLikeElement | DucEmbeddableElement | DucImageElement | DucTextElement | DucSelectionElement | DucDocElement | DucTableElement | DucFeatureControlFrameElement | DucViewportElement | DucPlotElement | DucPdfElement;
 export type DucStackLikeElement = DucPlotElement | DucViewportElement | DucFrameElement;
 export type DucLinearLikeElement = DucLinearElement | DucViewportElement | DucArrowElement;
 export type DucFrameLikeElement = DucPlotElement | DucFrameElement;
 export type DucIframeLikeElement = DucEmbeddableElement | DucTableElement | DucDocElement;
-export type ElementConstructorOpts = MarkOptional<Omit<DucGenericElement, "id" | "type" | "isDeleted" | "updated">, "width" | "height" | "angle" | "groupIds" | "frameId" | "index" | "boundElements" | "seed" | "version" | "versionNonce" | "link" | "background" | "stroke" | "roundness" | "locked" | "opacity" | "customData" | "isVisible" | "description" | "scope" | "blending" | "isPlot" | "isAnnotative" | "regionIds" | "layerId">;
+export type ElementConstructorOpts = MarkOptional<Omit<DucGenericElement, "id" | "type" | "isDeleted" | "updated">, "width" | "height" | "angle" | "groupIds" | "blockIds" | "instanceId" | "frameId" | "index" | "boundElements" | "seed" | "version" | "versionNonce" | "link" | "background" | "stroke" | "roundness" | "locked" | "opacity" | "customData" | "isVisible" | "description" | "scope" | "blending" | "isPlot" | "isAnnotative" | "regionIds" | "layerId">;
 export type ElementUpdate<TElement extends DucElement> = Omit<Partial<TElement>, "id" | "version" | "versionNonce" | "updated">;
 export type DucElementType = DucElement["type"];
 export type DucCommonStyle = {
@@ -246,7 +258,7 @@ export type StrokeStyle = {
     /**
      * Override the dash line into a custom shape
      */
-    dashLineOverride?: DucBlockInstanceElement["id"];
+    dashLineOverride?: InstanceId;
     /**
      * The cap of the dash
      * @default butt
@@ -734,25 +746,71 @@ export type DucBlockAttributeDefinition = {
     /** If true, the attribute's value is fixed and cannot be changed after insertion. */
     isConstant: boolean;
 };
+/**
+ * Indicates the source drawing of a block.
+ */
+export type BlockSource = string;
+export interface BlockLocalizationEntry {
+    title: string;
+    description?: string;
+}
+/**
+ * A mapping of locale codes to their corresponding localized block metadata.
+ * The keys represent locales in a BCP-47 standard language tag format (e.g., "en-US", "fr-FR").
+ */
+export type BlockLocalizationMap = Record<string, BlockLocalizationEntry>;
+export interface DucBlockMetadata {
+    /** Drawing id this block originates from */
+    source?: BlockSource;
+    /** Total number of times the block was instantiated */
+    usageCount: number;
+    /** Creation timestamp */
+    createdAt: number;
+    /** Last update timestamp */
+    updatedAt: number;
+    /** Localization metadata */
+    localization?: BlockLocalizationMap;
+}
+/**
+ * Defines the "Blueprint" for a reusable component.
+ *
+ * **Element Relationship Logic:**
+ * The connection between this Block Definition and `_DucElementBase` depends on the state:
+ *
+ * 1. **Definition State (Source):**
+ *    - Elements that define the geometry of this block have this `id` inside their `element.blockIds`.
+ *    - Their `element.instanceId` is `null`.
+ *
+ * 2. **Instance State (Usage):**
+ *    - When instantiated via `DucBlockInstance`, the rendered elements have `element.instanceId` set (not null).
+ *    - Crucially, these instance elements have **empty** `element.blockIds`.
+ *    - The relationship is resolved indirectly: `Element.instanceId` -> `DucBlockInstance.blockId` -> `DucBlock.id`.
+ */
 export type DucBlock = {
-    id: string;
+    id: BlockId;
     label: string;
     description?: string;
     version: number;
-    /** An array of all elements that constitute the block's geometry and annotations. */
-    elements: readonly DucElement[];
     /**
      * A record of attribute definitions for this block, keyed by their tag.
      * This defines the "slots" for data that each instance can fill.
      */
     attributeDefinitions: Readonly<Record<string, DucBlockAttributeDefinition>>;
-};
-export type DucBlockInstanceElement = _DucElementBase & {
-    type: "blockinstance";
+    /** Block metadata including source, usage count, timestamps, and localization */
+    metadata?: DucBlockMetadata;
+    /** Cached thumbnail image for the block (webp format) */
+    thumbnail?: Uint8Array;
+};
+export type DucBlockInstance = {
+    id: InstanceId;
+    /** The reference to the DucBlock definition this instance is based on */
     blockId: string;
+    /** The version that should match the blockId's version, incremented on each change */
+    version: number;
     /**
      * Keys are the element ids of the block instance
      * Values are the element overrides
+     * <string, string> <=> <elementId, path to field on the element (via JSON RFC6902 style path)>
      */
     elementOverrides?: Record<string, string>;
     /**
@@ -762,6 +820,19 @@ export type DucBlockInstanceElement = _DucElementBase & {
     attributeValues?: Readonly<Record<string, string>>;
     duplicationArray: DucBlockDuplicationArray | null;
 };
+export type DucBlockCollection = {
+    id: string;
+    label: string;
+    /**
+     * True if pointing to another collection, False if pointing to a block.
+     */
+    children: Array<{
+        isCollection: boolean;
+        id: string;
+    }>;
+    metadata?: DucBlockMetadata;
+    thumbnail?: Uint8Array;
+};
 export type _DucStackBase = DucStackLikeStyles & {
     label: string;
     description: string | null;
@@ -935,14 +1006,14 @@ export type LeaderContent = {
 } | {
     type: "block";
     /** The ID of the DucBlock definition to use as content. */
-    blockId: DucBlockInstanceElement["blockId"];
+    blockId: InstanceId;
     /**
      * The attribute values and element overrides for this specific block instance.
-     * This is a subset of the properties from DucBlockInstanceElement.
+     * This is a subset of the properties from DucBlockInstance.
      */
     instanceData: {
-        attributeValues?: DucBlockInstanceElement["attributeValues"];
-        elementOverrides?: DucBlockInstanceElement["elementOverrides"];
+        attributeValues?: DucBlockInstance["attributeValues"];
+        elementOverrides?: DucBlockInstance["elementOverrides"];
     };
 };
 /**

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, DucPlotElement, 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, 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;
@@ -25,7 +25,6 @@ export declare const isBindingElement: (element?: DucElement | null, includeLock
 export declare const isBindingElementType: (elementType: ElementOrToolType) => boolean;
 export declare const isBindableElement: (element: DucElement | null | undefined, includeLocked?: boolean) => element is DucBindableElement;
 export declare const isRectanguloidElement: (element?: DucElement | null) => element is DucBindableElement;
-export declare const isBlockInstanceElement: (element?: DucElement | null) => element is DucBlockInstanceElement;
 export declare const isRectangularElement: (element?: DucElement | null) => element is DucBindableElement;
 export declare const isTextBindableContainer: (element: DucElement | null, includeLocked?: boolean) => element is DucTextContainer;
 export declare const isDucElement: (element: any) => element is DucElement;

package/dist/types/elements/typeChecks.js

@@ -93,9 +93,6 @@ export const isRectanguloidElement = (element) => {
             element.type === "table" ||
             (element.type === "text" && !element.containerId)));
 };
-export const isBlockInstanceElement = (element) => {
-    return element != null && element.type === "blockinstance";
-};
 // TODO: Remove this when proper distance calculation is introduced
 // @see binding.ts:distanceToBindableElement()
 export const isRectangularElement = (element) => {
@@ -135,7 +132,6 @@ export const isDucElement = (element) => {
         case "dimension":
         case "leader":
         case "doc":
-        case "blockinstance":
         case "selection":
         case "parametric":
         case "featurecontrolframe":

package/dist/types/index.d.ts

@@ -5,9 +5,9 @@ export * from "./typeChecks";
 import { OBJECT_SNAP_MODE, PRUNING_LEVEL } from "../flatbuffers/duc";
 import { SupportedMeasures } from "../technical/scopes";
 import { Standard } from "../technical/standards";
-import { DucBindableElement, DucBlock, DucElement, DucElementType, DucGroup, DucIframeLikeElement, DucLayer, DucLinearElement, DucPoint, DucRegion, DucTextElement, ElementBackground, ElementStroke, ExternalFileId, FontFamilyValues, LineHead, NonDeleted, TextAlign } from "./elements";
+import { DucBindableElement, DucBlock, DucBlockCollection, DucBlockInstance, DucElement, DucElementType, DucGroup, DucIframeLikeElement, DucLayer, DucLinearElement, DucPoint, DucRegion, DucTextElement, ElementBackground, ElementStroke, ExternalFileId, FontFamilyValues, LineHead, NonDeleted, TextAlign } from "./elements";
 import { GeometricPoint, Percentage, Radian, ScaleFactor } from "./geometryTypes";
-import { MakeBrand, MaybePromise, ValueOf } from "./utility-types";
+import { MakeBrand, MarkOptional, MaybePromise, ValueOf } from "./utility-types";
 import type { GRID_DISPLAY_TYPE, GRID_TYPE, SNAP_MARKER_SHAPE, SNAP_MODE, SNAP_OVERRIDE_BEHAVIOR } from "../utils/constants";
 /**
  * Root data structure for the stored data state
@@ -24,6 +24,8 @@ export interface ExportedDataState {
     /** Project-wide settings that are saved with the document and shared by all users */
     globalState: DucGlobalState;
     blocks: readonly DucBlock[];
+    blockInstances: readonly DucBlockInstance[];
+    blockCollections: readonly DucBlockCollection[];
     groups: readonly DucGroup[];
     regions: readonly DucRegion[];
     layers: readonly DucLayer[];
@@ -35,6 +37,7 @@ export interface ExportedDataState {
     id: string | undefined;
 }
 export type ExportedDataStateContent = Omit<ExportedDataState, "type" | "version" | "source">;
+export type BaseExportedDataState = MarkOptional<ExportedDataStateContent, "elements" | "localState" | "versionGraph">;
 /**
  * A version of the data state where all fields are optional.
  * This is useful for importing data where some fields might be missing.

package/dist/utils/bounds.js

@@ -294,7 +294,7 @@ export const calculatePointsBoundsWithCenter = (points) => {
 };
 export const getElementPointsCoords = (element, points) => {
     var _a, _b, _c;
-    if (points.length === 0) {
+    if (!points || !Array.isArray(points) || points.length === 0) {
         return [
             element.x.scoped,
             element.y.scoped,

package/dist/utils/constants.d.ts

@@ -49,6 +49,15 @@ export declare const MIME_TYPES: {
     readonly binary: "application/octet-stream";
     readonly pdf: "application/pdf";
     readonly zip: "application/zip";
+    readonly xls: "application/vnd.ms-excel";
+    readonly xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+    readonly doc: "application/msword";
+    readonly docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+    readonly csv: "text/csv";
+    readonly markdown: "text/markdown";
+    readonly step: "model/step";
+    readonly stp: "application/step";
+    readonly stl: "model/stl";
 };
 export declare const EXPORT_IMAGE_TYPES: {
     readonly png: "png";
@@ -58,10 +67,11 @@ export declare const EXPORT_IMAGE_TYPES: {
 export declare const EXPORT_DATA_TYPES: {
     readonly duc: "duc";
     readonly json: "json";
-    readonly excalidrawClipboard: "excalidraw/clipboard";
+    readonly ducClipboard: "duc/clipboard";
     readonly excalidrawLibrary: "excalidrawlib";
-    readonly excalidrawClipboardWithAPI: "excalidraw-api/clipboard";
+    readonly ducClipboardWithAPI: "duc-api/clipboard";
 };
+export declare const SUPPORTED_DATA_TYPES: ("image/svg+xml" | "image/png" | "image/jpeg" | "image/gif" | "image/webp" | "image/bmp" | "image/x-icon" | "image/avif" | "image/jfif" | "application/json" | "application/vnd.duc-cad" | "application/vnd.duc-config" | "application/pdf" | "application/vnd.ms-excel" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/msword" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "text/csv" | "text/markdown" | "model/step" | "application/step" | "model/stl")[];
 export declare const VERSIONS: {
     readonly excalidraw: 2;
     readonly excalidrawLibrary: 2;

package/dist/utils/constants.js

@@ -37,7 +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: "application/octet-stream", pdf: "application/pdf", zip: "application/zip" }, IMAGE_MIME_TYPES);
+    "excalidraw.svg": "image/svg+xml", "excalidraw.png": "image/png", binary: "application/octet-stream", pdf: "application/pdf", zip: "application/zip", xls: "application/vnd.ms-excel", xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", doc: "application/msword", docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document", csv: "text/csv", markdown: "text/markdown", step: "model/step", stp: "application/step", stl: "model/stl" }, IMAGE_MIME_TYPES);
 export const EXPORT_IMAGE_TYPES = {
     png: "png",
     svg: "svg",
@@ -46,10 +46,26 @@ export const EXPORT_IMAGE_TYPES = {
 export const EXPORT_DATA_TYPES = {
     duc: "duc",
     json: "json",
-    excalidrawClipboard: "excalidraw/clipboard",
+    ducClipboard: "duc/clipboard",
     excalidrawLibrary: "excalidrawlib",
-    excalidrawClipboardWithAPI: "excalidraw-api/clipboard",
+    ducClipboardWithAPI: "duc-api/clipboard",
 };
+export const SUPPORTED_DATA_TYPES = [
+    MIME_TYPES.duc,
+    MIME_TYPES.ducfig,
+    MIME_TYPES.pdf,
+    MIME_TYPES.xls,
+    MIME_TYPES.xlsx,
+    MIME_TYPES.doc,
+    MIME_TYPES.docx,
+    MIME_TYPES.json,
+    MIME_TYPES.csv,
+    MIME_TYPES.markdown,
+    MIME_TYPES.step,
+    MIME_TYPES.stp,
+    MIME_TYPES.stl,
+    ...Object.values(IMAGE_MIME_TYPES),
+];
 export const VERSIONS = {
     excalidraw: 2,
     excalidrawLibrary: 2,

package/dist/utils/elements/index.js

@@ -162,6 +162,7 @@ export const getBaseElementProps = (element) => {
         isAnnotative: element.isAnnotative,
         layerId: element.layerId,
         regionIds: element.regionIds,
+        blockIds: element.blockIds,
         roundness: element.roundness,
         blending: element.blending,
         background: element.background,

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

@@ -1,5 +1,5 @@
 import { Scope } from "../../types";
-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 { DucArrowElement, DucDimensionElement, DucDocElement, DucElement, DucEllipseElement, DucEmbeddableElement, DucFeatureControlFrameElement, DucFrameElement, DucFreeDrawElement, DucGenericElement, DucImageElement, DucLeaderElement, DucLinearElement, DucMermaidElement, DucParametricElement, DucPdfElement, DucPlotElement, DucPolygonElement, DucTableElement, DucTextElement, DucViewportElement, DucXRayElement, ElementConstructorOpts, ElementUpdate, NonDeleted } from "../../types/elements";
 import { Mutable } from "../../types/utility-types";
 export declare const newElementWith: <TElement extends DucElement>(element: TElement, updates: ElementUpdate<TElement>, 
 /** pass `true` to always regenerate */
@@ -46,12 +46,6 @@ export declare const newXRayElement: (currentScope: Scope, opts: ElementConstruc
 export declare const newLeaderElement: (currentScope: Scope, opts: Partial<DucLeaderElement> & ElementConstructorOpts) => NonDeleted<DucLeaderElement>;
 export declare const newDimensionElement: (currentScope: Scope, opts: ElementConstructorOpts) => NonDeleted<DucDimensionElement>;
 export declare const newFeatureControlFrameElement: (currentScope: Scope, opts: ElementConstructorOpts) => NonDeleted<DucFeatureControlFrameElement>;
-export declare const newBlockInstanceElement: (currentScope: Scope, opts: {
-    blockId: DucBlockInstanceElement["blockId"];
-    elementOverrides?: DucBlockInstanceElement["elementOverrides"];
-    attributeValues?: DucBlockInstanceElement["attributeValues"];
-    duplicationArray?: DucBlockInstanceElement["duplicationArray"];
-} & ElementConstructorOpts) => NonDeleted<DucBlockInstanceElement>;
 export declare const newParametricElement: (currentScope: Scope, opts: ElementConstructorOpts) => NonDeleted<DucParametricElement>;
 /**
  * Clones DucElement data structure. Does not regenerate id, nonce, or

package/dist/utils/elements/newElement.js

@@ -39,7 +39,7 @@ force = false) => {
 };
 const _newElementBase = (type, currentScope, _a) => {
     var _b, _c;
-    var { x, y, scope = currentScope, zIndex, index = DEFAULT_ELEMENT_PROPS.index, label, isVisible = DEFAULT_ELEMENT_PROPS.isVisible, isPlot = DEFAULT_ELEMENT_PROPS.isPlot, isAnnotative = DEFAULT_ELEMENT_PROPS.isAnnotative, stroke = [DEFAULT_ELEMENT_PROPS.stroke], background = [DEFAULT_ELEMENT_PROPS.background], opacity = DEFAULT_ELEMENT_PROPS.opacity, width = DEFAULT_ELEMENT_PROPS.width, height = DEFAULT_ELEMENT_PROPS.height, angle = DEFAULT_ELEMENT_PROPS.angle, groupIds = DEFAULT_ELEMENT_PROPS.groupIds, regionIds = [], frameId = DEFAULT_ELEMENT_PROPS.frameId, layerId = null, roundness = DEFAULT_ELEMENT_PROPS.roundness, boundElements = DEFAULT_ELEMENT_PROPS.boundElements, link = DEFAULT_ELEMENT_PROPS.link, locked = DEFAULT_ELEMENT_PROPS.locked, description = null } = _a, rest = __rest(_a, ["x", "y", "scope", "zIndex", "index", "label", "isVisible", "isPlot", "isAnnotative", "stroke", "background", "opacity", "width", "height", "angle", "groupIds", "regionIds", "frameId", "layerId", "roundness", "boundElements", "link", "locked", "description"]);
+    var { x, y, scope = currentScope, zIndex, index = DEFAULT_ELEMENT_PROPS.index, label, isVisible = DEFAULT_ELEMENT_PROPS.isVisible, isPlot = DEFAULT_ELEMENT_PROPS.isPlot, isAnnotative = DEFAULT_ELEMENT_PROPS.isAnnotative, stroke = [DEFAULT_ELEMENT_PROPS.stroke], background = [DEFAULT_ELEMENT_PROPS.background], opacity = DEFAULT_ELEMENT_PROPS.opacity, width = DEFAULT_ELEMENT_PROPS.width, height = DEFAULT_ELEMENT_PROPS.height, angle = DEFAULT_ELEMENT_PROPS.angle, groupIds = DEFAULT_ELEMENT_PROPS.groupIds, blockIds = [], instanceId = null, regionIds = [], frameId = DEFAULT_ELEMENT_PROPS.frameId, layerId = null, roundness = DEFAULT_ELEMENT_PROPS.roundness, boundElements = DEFAULT_ELEMENT_PROPS.boundElements, link = DEFAULT_ELEMENT_PROPS.link, locked = DEFAULT_ELEMENT_PROPS.locked, description = null } = _a, rest = __rest(_a, ["x", "y", "scope", "zIndex", "index", "label", "isVisible", "isPlot", "isAnnotative", "stroke", "background", "opacity", "width", "height", "angle", "groupIds", "blockIds", "instanceId", "regionIds", "frameId", "layerId", "roundness", "boundElements", "link", "locked", "description"]);
     // assign type to guard against excess properties
     const element = {
         id: rest.id || randomId(),
@@ -55,6 +55,8 @@ const _newElementBase = (type, currentScope, _a) => {
         background,
         opacity,
         groupIds,
+        blockIds,
+        instanceId,
         frameId,
         roundness,
         label,
@@ -177,10 +179,6 @@ export const newFeatureControlFrameElement = (currentScope, opts) => {
             bracketStyle: DATUM_BRACKET_STYLE.SQUARE
         } }, _newElementBase("featurecontrolframe", currentScope, opts)), { type: "featurecontrolframe" });
 };
-export const newBlockInstanceElement = (currentScope, opts) => {
-    var _a, _b, _c;
-    return (Object.assign(Object.assign({}, _newElementBase("blockinstance", currentScope, opts)), { type: "blockinstance", blockId: opts.blockId, elementOverrides: (_a = opts.elementOverrides) !== null && _a !== void 0 ? _a : {}, attributeValues: (_b = opts.attributeValues) !== null && _b !== void 0 ? _b : {}, duplicationArray: (_c = opts.duplicationArray) !== null && _c !== void 0 ? _c : null }));
-};
 export const newParametricElement = (currentScope, opts) => (Object.assign(Object.assign({ source: { type: PARAMETRIC_SOURCE_TYPE.CODE, code: "" } }, _newElementBase("parametric", currentScope, opts)), { type: 'parametric' }));
 // Simplified deep clone for the purpose of cloning DucElement.
 //

package/dist/utils/index.d.ts

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

package/dist/utils/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ducjs",
-  "version": "2.1.0",
+  "version": "2.2.3",
   "description": "The duc 2D CAD file format is a cornerstone of our advanced design system, conceived to cater to professionals seeking precision and efficiency in their design work.",
   "type": "module",
   "main": "dist/index.js",
@@ -43,12 +43,13 @@
     "undici-types": "^6.21.0"
   },
   "dependencies": {
-    "flatbuffers": "^24.12.23",
-    "nanoid": "5.1.5",
-    "tinycolor2": "1.6.0",
     "@braintree/sanitize-url": "6.0.2",
     "browser-fs-access": "0.35.0",
-    "perfect-freehand": "1.2.2"
+    "fflate": "^0.8.2",
+    "flatbuffers": "^24.12.23",
+    "nanoid": "5.1.5",
+    "perfect-freehand": "1.2.2",
+    "tinycolor2": "1.6.0"
   },
   "files": [
     "dist",