@itwin/core-backend 5.1.0-dev.3 → 5.1.0-dev.32

package/lib/cjs/Element.js

@@ -38,7 +38,7 @@ const Symbols_1 = require("./internal/Symbols");
  * * [Element Fundamentals]($docs/bis/guide/fundamentals/element-fundamentals.md)
  * * [Working with schemas and elements in TypeScript]($docs/learning/backend/SchemasAndElementsInTypeScript.md)
  * * [Creating elements]($docs/learning/backend/CreateElements.md)
- * @public
+ * @public @preview
  */
 class Element extends Entity_1.Entity {
     static get className() { return "Element"; }
@@ -65,6 +65,51 @@ class Element extends Entity_1.Entity {
         this.userLabel = props.userLabel;
         this.jsonProperties = { ...props.jsonProperties }; // make sure we have our own copy
     }
+    /**
+     * Element custom HandledProps include 'codeValue', 'codeSpec', 'codeScope', 'model', 'parent', 'federationGuid', and 'lastMod'.
+     * @inheritdoc
+     * @beta
+     */
+    static _customHandledProps = [
+        { propertyName: "codeValue", source: "Class" },
+        { propertyName: "codeSpec", source: "Class" },
+        { propertyName: "codeScope", source: "Class" },
+        { propertyName: "model", source: "Class" },
+        { propertyName: "parent", source: "Class" },
+        { propertyName: "federationGuid", source: "Class" },
+        { propertyName: "lastMod", source: "Class" },
+    ];
+    /**
+     * Element deserializes 'codeValue', 'codeSpec', 'codeScope', 'model', 'parent', and 'federationGuid'.
+     * @inheritdoc
+     * @beta
+     */
+    static deserialize(props) {
+        const elProps = super.deserialize(props);
+        const instance = props.row;
+        elProps.code = { value: instance.codeValue ?? "", spec: instance.codeSpec.id, scope: instance.codeScope.id };
+        elProps.model = instance.model.id;
+        if (instance.parent)
+            elProps.parent = instance.parent;
+        if (instance.federationGuid)
+            elProps.federationGuid = instance.federationGuid;
+        return elProps;
+    }
+    /**
+     * Element serialize 'codeValue', 'codeSpec', 'codeScope', 'model', 'parent', and 'federationGuid'.
+     * @inheritdoc
+     * @beta
+     */
+    static serialize(props, iModel) {
+        const inst = super.serialize(props, iModel);
+        inst.codeValue = props.code.value;
+        inst.codeSpec = { id: props.code.spec };
+        inst.codeScope = { id: props.code.scope };
+        inst.model = { id: props.model };
+        inst.parent = props.parent;
+        inst.federationGuid = props.federationGuid ?? iModel[Symbols_1._nativeDb].newBeGuid();
+        return inst;
+    }
     /** Called before a new Element is inserted.
      * @note throw an exception to disallow the insert
      * @note If you override this method, you must call super.
@@ -89,6 +134,7 @@ class Element extends Entity_1.Entity {
         const locks = arg.iModel.locks;
         if (locks && !locks.holdsExclusiveLock(arg.model))
             locks[Symbols_1._elementWasCreated](arg.id);
+        arg.iModel.models[Symbols_1._cache].delete(arg.model);
     }
     /** Called before an Element is updated.
      * @note throw an exception to disallow the update
@@ -107,7 +153,10 @@ class Element extends Entity_1.Entity {
      * @note `this` is the class of the Element that was updated
      * @beta
      */
-    static onUpdated(_arg) { }
+    static onUpdated(arg) {
+        arg.iModel.elements[Symbols_1._cache].delete({ id: arg.id });
+        arg.iModel.models[Symbols_1._cache].delete(arg.model);
+    }
     /** Called before an Element is deleted.
      * @note throw an exception to disallow the delete
      * @note If you override this method, you must call super.
@@ -123,7 +172,10 @@ class Element extends Entity_1.Entity {
      * @note `this` is the class of the Element that was deleted
      * @beta
      */
-    static onDeleted(_arg) { }
+    static onDeleted(arg) {
+        arg.iModel.elements[Symbols_1._cache].delete(arg);
+        arg.iModel.models[Symbols_1._cache].delete(arg.model);
+    }
     /** Called when an element with an instance of this class as its parent is about to be deleted.
      * @note throw an exception if the element should not be deleted
      * @note implementers should not presume that the element was deleted if this method does not throw,
@@ -136,7 +188,10 @@ class Element extends Entity_1.Entity {
      * @note `this` is the class of the parent Element whose child was deleted
      * @beta
      */
-    static onChildDeleted(_arg) { }
+    static onChildDeleted(arg) {
+        arg.iModel.elements[Symbols_1._cache].delete({ id: arg.parentId });
+        arg.iModel.elements[Symbols_1._cache].delete({ id: arg.childId });
+    }
     /** Called when a *new element* with an instance of this class as its parent is about to be inserted.
      * @note throw an exception if the element should not be inserted
      * @note `this` is the class of the prospective parent Element.
@@ -147,7 +202,9 @@ class Element extends Entity_1.Entity {
      * @note `this` is the class of the parent Element.
      * @beta
      */
-    static onChildInserted(_arg) { }
+    static onChildInserted(arg) {
+        arg.iModel.elements[Symbols_1._cache].delete({ id: arg.parentId });
+    }
     /** Called when an element with an instance of this class as its parent is about to be updated.
      * @note throw an exception if the element should not be updated
      * @note `this` is the class of the parent Element.
@@ -158,7 +215,9 @@ class Element extends Entity_1.Entity {
      * @note `this` is the class of the parent Element.
      * @beta
      */
-    static onChildUpdated(_arg) { }
+    static onChildUpdated(arg) {
+        arg.iModel.elements[Symbols_1._cache].delete({ id: arg.parentId });
+    }
     /** Called when an *existing element* is about to be updated so that an instance of this class will become its new parent.
      * @note throw an exception if the element should not be added
      * @note `this` is the class of the prospective parent Element.
@@ -169,7 +228,9 @@ class Element extends Entity_1.Entity {
      * @note `this` is the class of the new parent Element.
      * @beta
      */
-    static onChildAdded(_arg) { }
+    static onChildAdded(arg) {
+        arg.iModel.elements[Symbols_1._cache].delete({ id: arg.parentId });
+    }
     /** Called when an element with an instance of this class as its parent is about to be updated change to a different parent.
      * @note throw an exception if the element should not be dropped
      * @note `this` is the class of the parent Element.
@@ -180,7 +241,9 @@ class Element extends Entity_1.Entity {
      * @note `this` is the class of the previous parent Element.
      * @beta
      */
-    static onChildDropped(_arg) { }
+    static onChildDropped(arg) {
+        arg.iModel.elements[Symbols_1._cache].delete({ id: arg.parentId });
+    }
     /** Called when an instance of this class is being *sub-modeled* by a new Model.
      * @note throw an exception if model should not be inserted
      * @note `this` is the class of Element to be sub-modeled.
@@ -191,7 +254,11 @@ class Element extends Entity_1.Entity {
      * @note `this` is the class of Element that is now sub-modeled.
      * @beta
      */
-    static onSubModelInserted(_arg) { }
+    static onSubModelInserted(arg) {
+        const id = arg.subModelId;
+        arg.iModel.elements[Symbols_1._cache].delete({ id });
+        arg.iModel.models[Symbols_1._cache].delete(id);
+    }
     /** Called when a sub-model of an instance of this class is being deleted.
      * @note throw an exception if model should not be deleted
      * @note `this` is the class of Element that is sub-modeled.
@@ -202,7 +269,11 @@ class Element extends Entity_1.Entity {
      * @note `this` is the class of Element that was sub-modeled.
      * @beta
      */
-    static onSubModelDeleted(_arg) { }
+    static onSubModelDeleted(arg) {
+        const id = arg.subModelId;
+        arg.iModel.elements[Symbols_1._cache].delete({ id });
+        arg.iModel.models[Symbols_1._cache].delete(id);
+    }
     /** Called during the iModel transformation process after an Element from the source iModel was *cloned* for the target iModel.
      * The transformation process automatically handles remapping BisCore properties and those that are properly described in ECSchema.
      * This callback is only meant to be overridden if there are other Ids in non-standard locations that need to be remapped or other data that needs to be fixed up after the clone.
@@ -332,7 +403,7 @@ class Element extends Entity_1.Entity {
 }
 exports.Element = Element;
 /** An abstract base class to model real world entities that intrinsically have geometry.
- * @public
+ * @public @preview
  */
 class GeometricElement extends Element {
     static get className() { return "GeometricElement"; }
@@ -371,11 +442,35 @@ class GeometricElement extends Element {
         ...super.requiredReferenceKeyTypeMap,
         category: core_common_1.ConcreteEntityTypes.Element,
     };
+    /**
+     * GeometricElement custom HandledProps includes 'inSpatialIndex'.
+     * @inheritdoc
+     * @beta
+     */
+    static _customHandledProps = [
+        { propertyName: "inSpatialIndex", source: "Class" },
+    ];
+    /**
+     * GeometricElement deserializes 'inSpatialIndex'.
+     * @inheritdoc
+     * @beta
+     */
+    static deserialize(props) {
+        return super.deserialize(props);
+    }
+    /**
+     * GeometricElement serialize 'inSpatialIndex'.
+     * @inheritdoc
+     * @beta
+     */
+    static serialize(props, iModel) {
+        return super.serialize(props, iModel);
+    }
 }
 exports.GeometricElement = GeometricElement;
 /** An abstract base class to model real world entities that intrinsically have 3d geometry.
  * See [how to create a GeometricElement3d]($docs/learning/backend/CreateElements.md#GeometricElement3d).
- * @public
+ * @public @preview
  */
 class GeometricElement3d extends GeometricElement {
     static get className() { return "GeometricElement3d"; }
@@ -399,10 +494,127 @@ class GeometricElement3d extends GeometricElement {
         if (undefined !== this.typeDefinition)
             referenceIds.addElement(this.typeDefinition.id);
     }
+    /**
+     * GeometricElement3d custom HandledProps includes 'category', 'geometryStream', 'origin', 'yaw', 'pitch', 'roll',
+     * 'bBoxLow', 'bBoxHigh', and 'typeDefinition'.
+     * @inheritdoc
+     * @beta
+     */
+    static _customHandledProps = [
+        { propertyName: "category", source: "Class" },
+        { propertyName: "geometryStream", source: "Class" },
+        { propertyName: "origin", source: "Class" },
+        { propertyName: "yaw", source: "Class" },
+        { propertyName: "pitch", source: "Class" },
+        { propertyName: "roll", source: "Class" },
+        { propertyName: "bBoxLow", source: "Class" },
+        { propertyName: "bBoxHigh", source: "Class" },
+        { propertyName: "typeDefinition", source: "Class" }
+    ];
+    /**
+     * GeometricElement3d deserializes 'category', 'geometryStream', 'origin', 'yaw', 'pitch', 'roll',
+     * 'bBoxLow', 'bBoxHigh', and 'typeDefinition'.
+     * @inheritdoc
+     * @beta
+     */
+    static deserialize(props) {
+        const elProps = super.deserialize(props);
+        const instance = props.row;
+        elProps.category = instance.category.id;
+        const origin = instance.origin ? [instance.origin.x, instance.origin.y, instance.origin.z] : [0, 0, 0];
+        let bbox;
+        if ("bBoxHigh" in instance && instance.bBoxHigh !== undefined && "bBoxLow" in instance && instance.bBoxLow !== undefined) {
+            bbox = {
+                low: [instance.bBoxLow.x, instance.bBoxLow.y, instance.bBoxLow.z],
+                high: [instance.bBoxHigh.x, instance.bBoxHigh.y, instance.bBoxHigh.z],
+            };
+        }
+        elProps.placement = {
+            origin,
+            angles: core_geometry_1.YawPitchRollAngles.createDegrees(instance.yaw ?? 0, instance.pitch ?? 0, instance.roll ?? 0).toJSON(),
+            bbox
+        };
+        if (instance.geometryStream) {
+            elProps.geom = props.iModel[Symbols_1._nativeDb].convertOrUpdateGeometrySource({
+                is2d: false,
+                geom: instance.geometryStream,
+                placement: elProps.placement,
+                categoryId: elProps.category
+            }, "GeometryStreamProps", props.options?.element ?? {}).geom;
+        }
+        if (instance.typeDefinition) {
+            elProps.typeDefinition = instance.typeDefinition;
+        }
+        return elProps;
+    }
+    /**
+     * GeometricElement3d serializes 'category', 'geometryStream', 'origin', 'yaw', 'pitch', 'roll',
+     * 'bBoxLow', 'bBoxHigh', and 'typeDefinition'.
+     * @inheritdoc
+     * @beta
+     */
+    static serialize(props, iModel) {
+        const inst = super.serialize(props, iModel);
+        inst.category = { id: props.category };
+        const assignPlacement = (placement) => {
+            if (Array.isArray(placement.origin)) {
+                inst.origin = { x: placement.origin[0], y: placement.origin[1], z: placement.origin[2] };
+            }
+            else {
+                inst.origin = placement.origin;
+            }
+            inst.yaw = placement.angles.yaw;
+            inst.pitch = placement.angles.pitch;
+            inst.roll = placement.angles.roll;
+            if (placement.bbox) {
+                if (Array.isArray(placement.bbox.low)) {
+                    inst.bBoxLow = { x: placement.bbox.low[0], y: placement.bbox.low[1], z: placement.bbox.low[2] };
+                }
+                else {
+                    inst.bBoxLow = placement.bbox.low;
+                }
+                if (Array.isArray(placement.bbox.high)) {
+                    inst.bBoxHigh = { x: placement.bbox.high[0], y: placement.bbox.high[1], z: placement.bbox.high[2] };
+                }
+                else {
+                    inst.bBoxHigh = placement.bbox.high;
+                }
+            }
+        };
+        if (props.placement) {
+            assignPlacement(props.placement);
+        }
+        if (props.elementGeometryBuilderParams) {
+            const source = iModel[Symbols_1._nativeDb].convertOrUpdateGeometrySource({
+                builder: props.elementGeometryBuilderParams,
+                is2d: true,
+                placement: props.placement,
+                categoryId: props.category,
+            }, "BinaryStream", {});
+            inst.geometryStream = source.geom;
+            if (source.placement) {
+                assignPlacement(source.placement);
+            }
+        }
+        if (props.geom) {
+            const source = iModel[Symbols_1._nativeDb].convertOrUpdateGeometrySource({
+                geom: props.geom,
+                is2d: false,
+                placement: props.placement,
+                categoryId: props.category,
+            }, "BinaryStream", {});
+            inst.geometryStream = source.geom;
+            if (source.placement) {
+                assignPlacement(source.placement);
+            }
+        }
+        inst.typeDefinition = props.typeDefinition;
+        return inst;
+    }
 }
 exports.GeometricElement3d = GeometricElement3d;
 /** A 3d Graphical Element
- * @public
+ * @public @preview
  */
 class GraphicalElement3d extends GeometricElement3d {
     static get className() { return "GraphicalElement3d"; }
@@ -410,7 +622,7 @@ class GraphicalElement3d extends GeometricElement3d {
 }
 exports.GraphicalElement3d = GraphicalElement3d;
 /** An abstract base class to model information entities that intrinsically have 2d geometry.
- * @public
+ * @public @preview
  */
 class GeometricElement2d extends GeometricElement {
     static get className() { return "GeometricElement2d"; }
@@ -429,6 +641,123 @@ class GeometricElement2d extends GeometricElement {
             val.typeDefinition = this.typeDefinition;
         return val;
     }
+    /**
+     * GeometricElement2d custom HandledProps includes 'category', 'geometryStream', 'origin', 'rotation',
+     * 'bBoxLow', 'bBoxHigh', and 'typeDefinition'.
+     * @inheritdoc
+     * @beta
+     */
+    static _customHandledProps = [
+        { propertyName: "category", source: "Class" },
+        { propertyName: "geometryStream", source: "Class" },
+        { propertyName: "origin", source: "Class" },
+        { propertyName: "rotation", source: "Class" },
+        { propertyName: "bBoxLow", source: "Class" },
+        { propertyName: "bBoxHigh", source: "Class" },
+        { propertyName: "typeDefinition", source: "Class" }
+    ];
+    /**
+     * GeometricElement2d deserialize 'category', 'geometryStream', 'origin', 'rotation',
+     * 'bBoxLow', 'bBoxHigh', and 'typeDefinition'.
+     * @inheritdoc
+     * @beta
+     */
+    static deserialize(props) {
+        const elProps = super.deserialize(props);
+        const instance = props.row;
+        elProps.category = instance.category.id;
+        const origin = instance.origin ? [instance.origin.x, instance.origin.y] : [0, 0];
+        let bbox;
+        if ("bBoxHigh" in instance && instance.bBoxHigh !== undefined && "bBoxLow" in instance && instance.bBoxLow !== undefined) {
+            bbox = {
+                low: [instance.bBoxLow.x, instance.bBoxLow.y],
+                high: [instance.bBoxHigh.x, instance.bBoxHigh.y],
+            };
+        }
+        elProps.placement = {
+            origin,
+            angle: instance.rotation,
+            bbox,
+        };
+        if (instance.geometryStream) {
+            const source = props.iModel[Symbols_1._nativeDb].convertOrUpdateGeometrySource({
+                is2d: true,
+                geom: instance.geometryStream,
+                placement: elProps.placement,
+                categoryId: elProps.category
+            }, "GeometryStreamProps", props.options?.element ?? {});
+            elProps.geom = source.geom;
+            if (source.placement) {
+                elProps.placement = source.placement;
+            }
+        }
+        if (instance.typeDefinition) {
+            elProps.typeDefinition = instance.typeDefinition;
+        }
+        return elProps;
+    }
+    /**
+     * GeometricElement2d serializes 'category', 'geometryStream', 'origin', 'rotation',
+     * 'bBoxLow', 'bBoxHigh', and 'typeDefinition'.
+     * @inheritdoc
+     * @beta
+     */
+    static serialize(props, iModel) {
+        const inst = super.serialize(props, iModel);
+        inst.category = { id: props.category };
+        const assignPlacement = (placement) => {
+            if (Array.isArray(placement.origin)) {
+                inst.origin = { x: placement.origin[0], y: placement.origin[1] };
+            }
+            else {
+                inst.origin = placement.origin;
+            }
+            inst.rotation = placement.angle;
+            if (placement.bbox) {
+                if (Array.isArray(placement.bbox.low)) {
+                    inst.bBoxLow = { x: placement.bbox.low[0], y: placement.bbox.low[1] };
+                }
+                else {
+                    inst.bBoxLow = placement.bbox.low;
+                }
+                if (Array.isArray(placement.bbox.high)) {
+                    inst.bBoxHigh = { x: placement.bbox.high[0], y: placement.bbox.high[1] };
+                }
+                else {
+                    inst.bBoxHigh = placement.bbox.high;
+                }
+            }
+        };
+        if (props.placement) {
+            assignPlacement(props.placement);
+        }
+        if (props.elementGeometryBuilderParams) {
+            const source = iModel[Symbols_1._nativeDb].convertOrUpdateGeometrySource({
+                builder: props.elementGeometryBuilderParams,
+                is2d: true,
+                placement: props.placement,
+                categoryId: props.category,
+            }, "BinaryStream", {});
+            inst.geometryStream = source.geom;
+            if (source.placement) {
+                assignPlacement(source.placement);
+            }
+        }
+        if (props.geom) {
+            const source = iModel[Symbols_1._nativeDb].convertOrUpdateGeometrySource({
+                geom: props.geom,
+                is2d: true,
+                placement: props.placement,
+                categoryId: props.category,
+            }, "BinaryStream", {});
+            inst.geometryStream = source.geom;
+            if (source.placement) {
+                assignPlacement(source.placement);
+            }
+        }
+        inst.typeDefinition = props.typeDefinition;
+        return inst;
+    }
     collectReferenceIds(referenceIds) {
         super.collectReferenceIds(referenceIds);
         if (undefined !== this.typeDefinition)
@@ -437,7 +766,7 @@ class GeometricElement2d extends GeometricElement {
 }
 exports.GeometricElement2d = GeometricElement2d;
 /** An abstract base class for 2d Geometric Elements that are used to convey information within graphical presentations (like drawings).
- * @public
+ * @public @preview
  */
 class GraphicalElement2d extends GeometricElement2d {
     static get className() { return "GraphicalElement2d"; }
@@ -445,7 +774,7 @@ class GraphicalElement2d extends GeometricElement2d {
 }
 exports.GraphicalElement2d = GraphicalElement2d;
 /** 2d element used to annotate drawings and sheets.
- * @public
+ * @public @preview
  */
 class AnnotationElement2d extends GraphicalElement2d {
     static get className() { return "AnnotationElement2d"; }
@@ -453,7 +782,7 @@ class AnnotationElement2d extends GraphicalElement2d {
 }
 exports.AnnotationElement2d = AnnotationElement2d;
 /** 2d element used to persist graphics for use in drawings.
- * @public
+ * @public @preview
  */
 class DrawingGraphic extends GraphicalElement2d {
     static get className() { return "DrawingGraphic"; }
@@ -461,7 +790,7 @@ class DrawingGraphic extends GraphicalElement2d {
 }
 exports.DrawingGraphic = DrawingGraphic;
 /** An Element that occupies real world space. Its coordinates are in the project space of its iModel.
- * @public
+ * @public @preview
  */
 class SpatialElement extends GeometricElement3d {
     static get className() { return "SpatialElement"; }
@@ -469,7 +798,7 @@ class SpatialElement extends GeometricElement3d {
 }
 exports.SpatialElement = SpatialElement;
 /** An Element that is spatially located, has mass, and can be *touched*.
- * @public
+ * @public @preview
  */
 class PhysicalElement extends SpatialElement {
     static get className() { return "PhysicalElement"; }
@@ -487,7 +816,7 @@ class PhysicalElement extends SpatialElement {
 }
 exports.PhysicalElement = PhysicalElement;
 /** Identifies a *tracked* real world location but has no mass and cannot be *touched*.
- * @public
+ * @public @preview
  */
 class SpatialLocationElement extends SpatialElement {
     static get className() { return "SpatialLocationElement"; }
@@ -495,7 +824,7 @@ class SpatialLocationElement extends SpatialElement {
 }
 exports.SpatialLocationElement = SpatialLocationElement;
 /** A Volume Element is a Spatial Location Element that is restricted to defining a volume.
- * @public
+ * @public @preview
  */
 class VolumeElement extends SpatialLocationElement {
     static get className() { return "VolumeElement"; }
@@ -505,7 +834,7 @@ exports.VolumeElement = VolumeElement;
 /** A SectionDrawingLocation element identifies the location of a [[SectionDrawing]] in the context of a [[SpatialModel]],
  * enabling [HyperModeling]($hypermodeling).
  * @note The associated ECClass was added to the BisCore schema in version 1.0.11.
- * @public
+ * @public @preview
  */
 class SectionDrawingLocation extends SpatialLocationElement {
     /** The Id of the [[ViewDefinition]] to which this location refers. */
@@ -526,7 +855,7 @@ exports.SectionDrawingLocation = SectionDrawingLocation;
 /** Information Content Element is an abstract base class for modeling pure information entities. Only the
  * core framework should directly subclass from Information Content Element. Domain and application developers
  * should start with the most appropriate subclass of Information Content Element.
- * @public
+ * @public @preview
  */
 class InformationContentElement extends Element {
     static get className() { return "InformationContentElement"; }
@@ -543,7 +872,7 @@ class DriverBundleElement extends InformationContentElement {
 }
 exports.DriverBundleElement = DriverBundleElement;
 /** Information Reference is an abstract base class for modeling entities whose main purpose is to reference something else.
- * @public
+ * @public @preview
  */
 class InformationReferenceElement extends InformationContentElement {
     static get className() { return "InformationReferenceElement"; }
@@ -551,7 +880,7 @@ class InformationReferenceElement extends InformationContentElement {
 }
 exports.InformationReferenceElement = InformationReferenceElement;
 /** A Subject is an information element that describes what this repository (or part thereof) is about.
- * @public
+ * @public @preview
  */
 class Subject extends InformationReferenceElement {
     static get className() { return "Subject"; }
@@ -609,7 +938,7 @@ exports.Subject = Subject;
  * For example, a will is a legal document. The will published into a PDF file is an ElectronicDocumentCopy.
  * The will printed onto paper is a PrintedDocumentCopy.
  * In this example, the Document only identifies, names, and tracks the content of the will.
- * @public
+ * @public @preview
  */
 class Document extends InformationContentElement {
     static get className() { return "Document"; }
@@ -617,7 +946,7 @@ class Document extends InformationContentElement {
 }
 exports.Document = Document;
 /** A document that represents a drawing, that is, a two-dimensional graphical representation of engineering data. A Drawing element is usually modelled by a [[DrawingModel]].
- * @public
+ * @public @preview
  */
 class Drawing extends Document {
     _scaleFactor;
@@ -625,7 +954,7 @@ class Drawing extends Document {
      * size of the [ViewAttachment]($backend) created when attaching the [Drawing]($backend) to a [Sheet]($backend).
      * Default: 1.
      * @note Attempting to set this property to a value less than or equal to zero will produce an exception.
-     * @public
+     * @public @preview
      */
     get scaleFactor() { return this._scaleFactor; }
     set scaleFactor(factor) {
@@ -696,7 +1025,7 @@ exports.Drawing = Drawing;
 /** A document that represents a section drawing, that is, a graphical documentation derived from a planar
  * section of a spatial view. A SectionDrawing element is modelled by a [[SectionDrawingModel]] or a [[GraphicalModel3d]].
  * A [[SectionDrawingLocation]] can associate the drawing with a spatial location, enabling [HyperModeling]($hypermodeling).
- * @public
+ * @public @preview
  */
 class SectionDrawing extends Drawing {
     /** The type of section used to generate the drawing. */
@@ -748,7 +1077,7 @@ class SectionDrawing extends Drawing {
 }
 exports.SectionDrawing = SectionDrawing;
 /** The template for a SheetBorder
- * @public
+ * @public @preview
  */
 class SheetBorderTemplate extends Document {
     static get className() { return "SheetBorderTemplate"; }
@@ -762,7 +1091,7 @@ class SheetBorderTemplate extends Document {
 }
 exports.SheetBorderTemplate = SheetBorderTemplate;
 /** The template for a [[Sheet]]
- * @public
+ * @public @preview
  */
 class SheetTemplate extends Document {
     static get className() { return "SheetTemplate"; }
@@ -783,7 +1112,7 @@ class SheetTemplate extends Document {
 }
 exports.SheetTemplate = SheetTemplate;
 /** A digital representation of a *sheet of paper*. Modeled by a [[SheetModel]].
- * @public
+ * @public @preview
  */
 class Sheet extends Document {
     static get className() { return "Sheet"; }
@@ -816,7 +1145,7 @@ class Sheet extends Document {
 exports.Sheet = Sheet;
 /** Information Record Element is an abstract base class for modeling information records. Information Record
  * Element is the default choice if no other subclass of Information Content Element makes sense.
- * @public
+ * @public @preview
  */
 class InformationRecordElement extends InformationContentElement {
     static get className() { return "InformationRecordElement"; }
@@ -824,7 +1153,7 @@ class InformationRecordElement extends InformationContentElement {
 }
 exports.InformationRecordElement = InformationRecordElement;
 /** A Definition Element holds configuration-related information that is meant to be referenced / shared.
- * @public
+ * @public @preview
  */
 class DefinitionElement extends InformationContentElement {
     static get className() { return "DefinitionElement"; }
@@ -834,6 +1163,37 @@ class DefinitionElement extends InformationContentElement {
         super(props, iModel);
         this.isPrivate = true === props.isPrivate;
     }
+    /**
+     * DefinitionElement custom HandledProps includes 'isPrivate'.
+     * @inheritdoc
+     * @beta
+     */
+    static _customHandledProps = [
+        { propertyName: "isPrivate", source: "Class" },
+    ];
+    /**
+     * DefinitionElement deserializes 'isPrivate'.
+     * @inheritdoc
+     * @beta
+     */
+    static deserialize(props) {
+        const elProps = super.deserialize(props);
+        if (props.row.isPrivate !== undefined)
+            elProps.isPrivate = props.row.isPrivate;
+        return elProps;
+    }
+    /**
+     * DefinitionElement serialize 'isPrivate'.
+     * @inheritdoc
+     * @beta
+     */
+    static serialize(props, iModel) {
+        const inst = super.serialize(props, iModel);
+        if (undefined !== props.isPrivate) {
+            inst.isPrivate = props.isPrivate;
+        }
+        return inst;
+    }
     toJSON() {
         const val = super.toJSON();
         val.isPrivate = this.isPrivate;
@@ -843,7 +1203,7 @@ class DefinitionElement extends InformationContentElement {
 exports.DefinitionElement = DefinitionElement;
 /** This abstract class unifies DefinitionGroup and DefinitionContainer for relationship endpoint purposes.
  * @note The associated ECClass was added to the BisCore schema in version 1.0.10
- * @public
+ * @public @preview
  */
 class DefinitionSet extends DefinitionElement {
     static get className() { return "DefinitionSet"; }
@@ -851,7 +1211,7 @@ class DefinitionSet extends DefinitionElement {
 exports.DefinitionSet = DefinitionSet;
 /** A DefinitionContainer exclusively owns a set of DefinitionElements contained within its sub-model (of type DefinitionModel).
  * @note The associated ECClass was added to the BisCore schema in version 1.0.10
- * @public
+ * @public @preview
  */
 class DefinitionContainer extends DefinitionSet {
     static get className() { return "DefinitionContainer"; }
@@ -897,7 +1257,7 @@ class DefinitionContainer extends DefinitionSet {
 exports.DefinitionContainer = DefinitionContainer;
 /** A non-exclusive set of DefinitionElements grouped using the DefinitionGroupGroupsDefinitions relationship.
  * @note The associated ECClass was added to the BisCore schema in version 1.0.10
- * @public
+ * @public @preview
  */
 class DefinitionGroup extends DefinitionSet {
     static get className() { return "DefinitionGroup"; }
@@ -922,7 +1282,7 @@ class DefinitionGroup extends DefinitionSet {
 }
 exports.DefinitionGroup = DefinitionGroup;
 /** Defines a set of properties (the *type*) that may be associated with an element.
- * @public
+ * @public @preview
  */
 class TypeDefinitionElement extends DefinitionElement {
     static get className() { return "TypeDefinitionElement"; }
@@ -949,7 +1309,7 @@ exports.RecipeDefinitionElement = RecipeDefinitionElement;
 /** Defines a set of properties (the *type*) that can be associated with a Physical Element. A Physical
  * Type has a strong correlation with something that can be ordered from a catalog since all instances
  * share a common set of properties.
- * @public
+ * @public @preview
  */
 class PhysicalType extends TypeDefinitionElement {
     static get className() { return "PhysicalType"; }
@@ -976,7 +1336,7 @@ class PhysicalType extends TypeDefinitionElement {
 }
 exports.PhysicalType = PhysicalType;
 /** Defines a set of properties (the *type*) that can be associated with a spatial location.
- * @public
+ * @public @preview
  */
 class SpatialLocationType extends TypeDefinitionElement {
     static get className() { return "SpatialLocationType"; }
@@ -1043,7 +1403,7 @@ class TemplateRecipe3d extends RecipeDefinitionElement {
 }
 exports.TemplateRecipe3d = TemplateRecipe3d;
 /** Defines a set of properties (the *type*) that can be associated with a 2D Graphical Element.
- * @public
+ * @public @preview
  */
 class GraphicalType2d extends TypeDefinitionElement {
     static get className() { return "GraphicalType2d"; }
@@ -1112,7 +1472,7 @@ exports.TemplateRecipe2d = TemplateRecipe2d;
 /** An abstract base class for elements that establishes a particular modeling perspective for its parent Subject.
  * Instances are always sub-modeled by a specialization of Model of the appropriate modeling perspective.
  * @see [iModel Information Hierarchy]($docs/bis/guide/data-organization/top-of-the-world), [[Subject]], [[Model]]
- * @public
+ * @public @preview
  */
 class InformationPartitionElement extends InformationContentElement {
     static get className() { return "InformationPartitionElement"; }
@@ -1139,7 +1499,7 @@ exports.InformationPartitionElement = InformationPartitionElement;
 /** A DefinitionPartition element establishes a *Definition* modeling perspective for its parent Subject.
  * A DefinitionPartition is always sub-modeled by a DefinitionModel.
  * @see [[DefinitionModel]]
- * @public
+ * @public @preview
  */
 class DefinitionPartition extends InformationPartitionElement {
     static get className() { return "DefinitionPartition"; }
@@ -1148,7 +1508,7 @@ exports.DefinitionPartition = DefinitionPartition;
 /** A DocumentPartition element establishes a *Document* modeling perspective for its parent Subject.
  * A DocumentPartition is always sub-modeled by a DocumentListModel.
  * @see [[DocumentListModel]]
- * @public
+ * @public @preview
  */
 class DocumentPartition extends InformationPartitionElement {
     static get className() { return "DocumentPartition"; }
@@ -1157,7 +1517,7 @@ exports.DocumentPartition = DocumentPartition;
 /** A GroupInformationPartition element establishes a *Group Information* modeling perspective for its parent Subject.
  * A GroupInformationPartition is always sub-modeled by a GroupInformationModel.
  * @see [[GroupInformationModel]]
- * @public
+ * @public @preview
  */
 class GroupInformationPartition extends InformationPartitionElement {
     static get className() { return "GroupInformationPartition"; }
@@ -1167,7 +1527,7 @@ exports.GroupInformationPartition = GroupInformationPartition;
  * A GraphicalPartition3d is always sub-modeled by a GraphicalModel3d.
  * @note The associated ECClass was added to the BisCore schema in version 1.0.8
  * @see [[GraphicalModel3d]]
- * @public
+ * @public @preview
  */
 class GraphicalPartition3d extends InformationPartitionElement {
     static get className() { return "GraphicalPartition3d"; }
@@ -1176,7 +1536,7 @@ exports.GraphicalPartition3d = GraphicalPartition3d;
 /** An InformationRecordPartition element establishes a *Information Record* modeling perspective for its parent Subject.
  * A InformationRecordPartition is always sub-modeled by an InformationRecordModel.
  * @see [[InformationRecordModel]]
- * @public
+ * @public @preview
  */
 class InformationRecordPartition extends InformationPartitionElement {
     static get className() { return "InformationRecordPartition"; }
@@ -1184,7 +1544,7 @@ class InformationRecordPartition extends InformationPartitionElement {
 exports.InformationRecordPartition = InformationRecordPartition;
 /** A LinkPartition element establishes a *Link* modeling perspective for its parent Subject. A LinkPartition is always sub-modeled by a LinkModel.
  * @see [[LinkModel]]
- * @public
+ * @public @preview
  */
 class LinkPartition extends InformationPartitionElement {
     static get className() { return "LinkPartition"; }
@@ -1192,7 +1552,7 @@ class LinkPartition extends InformationPartitionElement {
 exports.LinkPartition = LinkPartition;
 /** A PhysicalPartition element establishes a *Physical* modeling perspective for its parent Subject. A PhysicalPartition is always sub-modeled by a PhysicalModel.
  * @see [[PhysicalModel]]
- * @public
+ * @public @preview
  */
 class PhysicalPartition extends InformationPartitionElement {
     static get className() { return "PhysicalPartition"; }
@@ -1201,7 +1561,7 @@ exports.PhysicalPartition = PhysicalPartition;
 /** A SpatialLocationPartition element establishes a *SpatialLocation* modeling perspective for its parent Subject.
  * A SpatialLocationPartition is always sub-modeled by a SpatialLocationModel.
  * @see [[SpatialLocationModel]]
- * @public
+ * @public @preview
  */
 class SpatialLocationPartition extends InformationPartitionElement {
     static get className() { return "SpatialLocationPartition"; }
@@ -1216,14 +1576,14 @@ class SheetIndexPartition extends InformationPartitionElement {
 }
 exports.SheetIndexPartition = SheetIndexPartition;
 /** Group Information is an abstract base class for modeling entities whose main purpose is to reference a group of related elements.
- * @public
+ * @public @preview
  */
 class GroupInformationElement extends InformationReferenceElement {
     static get className() { return "GroupInformationElement"; }
 }
 exports.GroupInformationElement = GroupInformationElement;
 /** An information element that specifies a link.
- * @public
+ * @public @preview
  */
 class LinkElement extends InformationReferenceElement {
     static get className() { return "LinkElement"; }
@@ -1239,7 +1599,7 @@ class LinkElement extends InformationReferenceElement {
 }
 exports.LinkElement = LinkElement;
 /** An information element that specifies a URL link.
- * @public
+ * @public @preview
  */
 class UrlLink extends LinkElement {
     static get className() { return "UrlLink"; }
@@ -1250,6 +1610,36 @@ class UrlLink extends LinkElement {
         this.description = props.description;
         this.url = props.url;
     }
+    /**
+     * UrlLink custom HandledProps includes 'description', and 'url'.
+     * @inheritdoc
+     * @beta
+     */
+    static _customHandledProps = [
+        { propertyName: "description", source: "Class" },
+        { propertyName: "url", source: "Class" },
+    ];
+    /**
+     * UrlLink deserializes 'description', and 'url'.
+     * @inheritdoc
+     * @beta
+     */
+    static deserialize(props) {
+        const elProps = super.deserialize(props);
+        elProps.description = props.row.description ?? "";
+        elProps.url = props.row.url;
+        return elProps;
+    }
+    /**
+     * UrlLink serializes 'description', and 'url'.
+     * @inheritdoc
+     * @beta
+     */
+    static serialize(props, iModel) {
+        const inst = super.serialize(props, iModel);
+        inst.description = props.description;
+        return inst;
+    }
     toJSON() {
         const val = super.toJSON();
         val.description = this.description;
@@ -1267,7 +1657,7 @@ class FolderLink extends UrlLink {
 }
 exports.FolderLink = FolderLink;
 /** An information element that links to a repository.
- * @public
+ * @public @preview
  */
 class RepositoryLink extends UrlLink {
     static get className() { return "RepositoryLink"; }
@@ -1288,7 +1678,7 @@ class RepositoryLink extends UrlLink {
 }
 exports.RepositoryLink = RepositoryLink;
 /** An information element that links to an embedded file.
- * @public
+ * @public @preview
  */
 class EmbeddedFileLink extends LinkElement {
     static get className() { return "EmbeddedFileLink"; }
@@ -1297,7 +1687,7 @@ exports.EmbeddedFileLink = EmbeddedFileLink;
 /** A real world entity is modeled as a Role Element when a set of external circumstances define an important
  * role (one that is worth tracking) that is not intrinsic to the entity playing the role. For example,
  * a person can play the role of a teacher or a rock can play the role of a boundary marker.
- * @public
+ * @public @preview
  */
 class RoleElement extends Element {
     static get className() { return "RoleElement"; }
@@ -1305,7 +1695,7 @@ class RoleElement extends Element {
 exports.RoleElement = RoleElement;
 /** A Definition Element that specifies a collection of geometry that is meant to be reused across Geometric
  * Element instances. Leveraging Geometry Parts can help reduce file size and improve display performance.
- * @public
+ * @public @preview
  */
 class GeometryPart extends DefinitionElement {
     static get className() { return "GeometryPart"; }
@@ -1316,6 +1706,73 @@ class GeometryPart extends DefinitionElement {
         this.geom = props.geom;
         this.bbox = core_geometry_1.Range3d.fromJSON(props.bbox);
     }
+    /**
+     * GeometryPart custom HandledProps includes 'geometryStream', 'bBoxHigh', and 'bBoxLow'.
+     * @inheritdoc
+     * @beta
+     */
+    static _customHandledProps = [
+        { propertyName: "geometryStream", source: "Class" },
+        { propertyName: "bBoxLow", source: "Class" },
+        { propertyName: "bBoxHigh", source: "Class" },
+    ];
+    /**
+     * GeometryPart deserializes 'geometryStream', 'bBoxHigh', and 'bBoxLow'.
+     * @inheritdoc
+     * @beta
+     */
+    static deserialize(props) {
+        const elProps = super.deserialize(props);
+        const instance = props.row;
+        if ("bBoxHigh" in instance && instance.bBoxHigh !== undefined && "bBoxLow" in instance && instance.bBoxLow !== undefined) {
+            elProps.bbox = {
+                low: [instance.bBoxLow.x, instance.bBoxLow.y, instance.bBoxLow.z],
+                high: [instance.bBoxHigh.x, instance.bBoxHigh.y, instance.bBoxHigh.z],
+            };
+        }
+        if (instance.geometryStream) {
+            elProps.geom = props.iModel[Symbols_1._nativeDb].convertOrUpdateGeometryPart({
+                geom: instance.geometryStream,
+                is2d: false,
+                bbox: elProps.bbox,
+            }, "GeometryStreamProps", props.options?.element ?? {}).geom;
+        }
+        return elProps;
+    }
+    /**
+     * GeometryPart serialize 'geometryStream', 'bBoxHigh', and 'bBoxLow'.
+     * @inheritdoc
+     * @beta
+     */
+    static serialize(props, iModel) {
+        const inst = super.serialize(props, iModel);
+        if (undefined !== props.geom) {
+            const source = inst.geometryStream = iModel[Symbols_1._nativeDb].convertOrUpdateGeometryPart({
+                geom: props.geom,
+                is2d: false,
+                bbox: props.bbox,
+            }, "BinaryStream", {});
+            inst.geometryStream = source.geom;
+            if (source.bbox) {
+                props.bbox = source.bbox;
+            }
+        }
+        if (undefined !== props.bbox) {
+            if (Array.isArray(props.bbox.low)) {
+                inst.bBoxLow = { x: props.bbox.low[0], y: props.bbox.low[1], z: props.bbox.low[2] };
+            }
+            else {
+                inst.bBoxLow = props.bbox.low;
+            }
+            if (Array.isArray(props.bbox.high)) {
+                inst.bBoxHigh = { x: props.bbox.high[0], y: props.bbox.high[1], z: props.bbox.high[2] };
+            }
+            else {
+                inst.bBoxHigh = props.bbox.high;
+            }
+        }
+        return inst;
+    }
     toJSON() {
         const val = super.toJSON();
         val.geom = this.geom;
@@ -1335,7 +1792,7 @@ class GeometryPart extends DefinitionElement {
 }
 exports.GeometryPart = GeometryPart;
 /** The definition element for a line style
- * @public
+ * @public @preview
  */
 class LineStyle extends DefinitionElement {
     static get className() { return "LineStyle"; }
@@ -1346,6 +1803,35 @@ class LineStyle extends DefinitionElement {
         this.description = props.description;
         this.data = props.data;
     }
+    /**
+     * LineStyle custom HandledProps includes 'data'.
+     * @inheritdoc
+     * @beta
+     */
+    static _customHandledProps = [
+        { propertyName: "data", source: "Class" },
+    ];
+    /**
+     * LineStyle deserializes 'data'.
+     * @inheritdoc
+     * @beta
+     */
+    static deserialize(props) {
+        const elProps = super.deserialize(props);
+        const instance = props.row;
+        elProps.data = instance.data ?? "";
+        return elProps;
+    }
+    /**
+     * LineStyle serializes 'data'.
+     * @inheritdoc
+     * @beta
+     */
+    static serialize(props, iModel) {
+        const inst = super.serialize(props, iModel);
+        inst.data = props.data;
+        return inst;
+    }
     /** Create a Code for a LineStyle definition given a name that is meant to be unique within the scope of the specified model.
      * @param iModel The IModel
      * @param scopeModelId The Id of the DefinitionModel that contains the LineStyle and provides the scope for its name.
@@ -1359,7 +1845,7 @@ class LineStyle extends DefinitionElement {
 exports.LineStyle = LineStyle;
 /** Describes how to animate a view of a [[GeometricModel]] to show change over time using a [RenderSchedule.Script]($common).
  * @note This class was introduced in version 01.00.13 of the BisCore ECSchema. It should only be used with [[IModelDb]]s containing that version or newer.
- * @public
+ * @public @preview
  */
 class RenderTimeline extends InformationRecordElement {
     static get className() { return "RenderTimeline"; }
@@ -1384,6 +1870,21 @@ class RenderTimeline extends InformationRecordElement {
         props.script = JSON.stringify(this.scriptProps);
         return props;
     }
+    /**
+     * RenderTimeline deserialize checks if Schedule Script Element Ids need to be omitted, and if so, removes them.
+     * @inheritdoc
+     * @beta
+     */
+    static deserialize(props) {
+        const elProps = super.deserialize(props);
+        const options = props.options?.element?.renderTimeline;
+        // Omit Schedule Script Element Ids if the option is set
+        if (options?.omitScriptElementIds && elProps.script) {
+            const scriptProps = RenderTimeline.parseScriptProps(elProps.script);
+            elProps.script = JSON.stringify(core_common_1.RenderSchedule.Script.removeScheduleScriptElementIds(scriptProps));
+        }
+        return elProps;
+    }
     static parseScriptProps(json) {
         try {
             return JSON.parse(json);